User Tools

Site Tools


api:dk11:delphi:giscsfactory.tgis_csfactory.bywkt_string



TGIS_CSFactory.ByWKT method

DK for Delphi | GisCsFactory.TGIS_CSFactory.ByWKT | Methods

Creates or finds a coordinate system from WKT text or a single entity name.

Available also on: .NET | Java | ActiveX | Python.

Syntax

// Delphi
public
  class function ByWKT(
    const _wkt : String
  ) : TGIS_CSCoordinateSystem;
// C++ Builder
public:
  __classmethod TGIS_CSCoordinateSystem* ByWKT(
    const UnicodeString _wkt
  );

Parameters

Name Type Description
_wkt String Full WKT text or a single coordinate system entity name to resolve.

Result

Type Description
TGIS_CSCoordinateSystem A matching TGIS_CSCoordinateSystem object, or nil if the text cannot be resolved.

Remarks

PURPOSE: Resolve coordinate systems from Well-Known Text or from a known named entity using one factory entry point.

BEHAVIOR: The method accepts complete WKT definitions and also single entity names. It searches existing registry entries or cached objects before creating a new coordinate system instance.

USAGE: Use this method when coordinate system information is stored as WKT text or as a known entity name.

cs = TGIS_CSFactory.ByWKT(wktText)
cs = TGIS_CSFactory.ByWKT('WGS84')

CONSTRAINTS: Returns nil if the input is invalid or cannot be matched. Returned objects must be released by the caller.

References

2026/07/11 00:21

Page Tools