XSpatialReference Class

XSpatialReference는 공간 좌표 시스템에서 정의되는 파라미터를 설정하여 좌표변환에 사용된다. 즉, 특정 투영법으로 투영된 영상의 공간 좌표계를 XSpatialReference객체를 통해 정의할 수 있다. XSpatialReference는 OpenGIS Spatial Reference를 준수하며 Well Known Text 포맷 등을 지원한다.

Inheritance Hierarchy

SystemObject
Pixoneer.NXDL.NCCXSpatialReference

Namespace: Pixoneer.NXDL.NCC
Assembly: NXDLcc (in NXDLcc.dll) Version: 3.0.0.1

Syntax

Copy

public class XSpatialReference : IDisposable

The XSpatialReference type exposes the following members.

Constructors

	Name	Description
	XSpatialReference	XSpatialReference객체에 기본 생성자로서, 멤버 변수들을 초기화한다.
	XSpatialReference(IntPtr)	XSpatialReference객체에 대하여 외부 비관리객체의 포인터를 입력받아 복사하여 초기화한다.
	XSpatialReference(XSpatialReference)	XSpatialReference객체에 대하여 외부 관리객체를 입력받아 복사하여 초기화한다.

Top

Properties

	Name	Description
	CoordType	좌표 시스템의 eCoordType 형식.
	DatumName	좌표 시스템의 Datum 이름.
	NativePtr	원본 비관리 객체 포인터. c# 사용 불가.
	ProjectionName	좌표 시스템의 Projection의 이름.
	UnitName	좌표 시스템의 Unit 이름.

Top

Methods

	Name	Description
	Clone	이 객체와 동일한 XSpatialReference객체를 생성하여 반환한다.
	exportToPrettyWkt	XSpartialReference객체를 구성하는 파라미터를 가독성이 높게 Well Known Text(WKT)형태로 변환한다.
	exportToProj4	XSpartialReference객체를 구성하는 파라미터를 Proj.4형태로 변환한다.
	exportToWkt	XSpartialReference객체를 구성하는 파라미터를 Well Known Text(WKT)형태로 변환한다.
	FindBestEPSGMatch	EPSG 코드에서 최적의 좌표체계를 찾아 EPSG 문자열을 반환한다.
	GetAreaOfUse	좌표체계의 유효 사용영역을 확인한다.
	GetUTMZone	객체의 UTM Zone에 대한 정보를 획득한다.
	importFromEPSG	입력 EPSG 코드값으로 좌표계를 초기화한다.
	importFromESRI	ESRI 상용 제품의 고유 포맷인 .prj파일을 이용하여 좌표계를 초기화한다.
	importFromProj4	proj4 형식의 문자열값을 이용하여 좌표계를 초기화한다.
	importFromWkt	WKT 형식의 문자열을 이용하여 좌표계를 초기화한다.
	IsGeocentric	Geocentric 좌표 시스템(ECEF)인지 여부를 확인한다.
	IsGeographic	Geographic 좌표 시스템인지 여부를 확인한다.
	IsLocal	Local좌표 시스템인지 여부를 확인한다. 좌표계는 통상 이용되는 범위에 따라 전지구적 차원에서사용되는 Global좌표계와 일부 지역(Local)에서만 사용하는 지역적 좌표계로 분류한다.
	IsProjected	투영 좌표 시스템인지 여부를 확인한다.
	IsSame	좌표계 시스템이 동일한지 확인한다.
	IsUTM	UTM 좌표 시스템인지를 확인한다.
	SetUTM	입력 Zone 및 북반구 정보를 이용하여 UTM 좌표계를 설정한다.
	SetWellKnownGeogCS	자주 사용하는 좌표계를 문자열로 정의하여 좌표계를 초기화한다. "WGS84" : "EPSG:4326" 와 동일 "WGS72" : "EPSG:4322" 와 동일 "NAD27" : "EPSG:4267" 와 동일 "NAD83" : "EPSG:4269" 와 동일 "EPSG:n" : ImportFromEPSG(n) 와 동일한 기능을 하는 Well Known Text.

Top

Example

"WGS 84 / UTM zone 52N(northern hemisphere" 좌표계를 설정하고 이를 WKT 문자열로 가져오는 예제이다.

Copy

// Set to utm northern hemisphere 52 zone.
XSpatialReference sr = new XSpatialReference();
sr.SetWellKnownGeogCS("WGS84");
// sr.SetWellKnownGeoCS("EPGS:4326");
sr.SetUTM(52, true);

String strWkt= "";
sr.exportToWkt(ref strWkt);

Reference

Pixoneer.NXDL.NCC Namespace