[태그:] Xr

Xr 맵엔진에 수치지도를 레이어로 추가하고 수치지도에 대한 속성값을 텍스트로 지도위에 표시하는 기능을 라벨 표시 또는 어노테이션 표시라고 합니다. DuraMap-Xr의 라벨 표시에 대한 API를 간단한 예를 통해 살펴 보도록 하겠습니다. 먼저 아래와 같이 버튼 3개와 Xr 컨트롤을 폼에 배치합니다.

총 3개의 버튼으로 구성되며 Add Layer는 ESRI의 shp 파일을 읽어 레이어를 추가합니다. 그리고 이 추가된 레이어에 대해 2개의 라벨을 추가하는 코드가 각각 ‘Add Label 1’과 ‘Add Label 2’ 버튼에 해당합니다. Xr에서는 하나의 레이어에 대해 다수의 라벨을 표시할 수 있는 멀티 라벨링 기능을 제공합니다. ‘Add Layer’의 코드는 아래와 같습니다.

axXr1.Layers.AddShapeMapLayer("서울", "d:/__data__/seoul.SHP");

실행을 하고 해당 버튼을 누르면 화면에 아무것도 표시되지 않습니다. DuraMap-Xr은 파일이나 지도서버로부터 데이터를 요청하면 데이터를 모두 받을때 OnLayerConnectionCompleted 이벤트가 발생하게 됩니다. 이 이벤트에 아래의 코드를 추가합니다.

private void axXr1_OnLayerConnectionCompleted(object sender, 
    AxXrMapLib._IXrMapControlEvents_OnLayerConnectionCompletedEvent e)
{
    axXr1.ZoomFullExtent();
    axXr1.ZoomInFix();
}

즉, 지도 레이어가 완전하게 읽어진 후 지도를 화면에 꽉 채워 그리도록 합니다. ZoonFullExtent 호출 뒤에 바로 ZoomInFix를 호출하여 지도를 확대해 좀 더 화면에 꽉 차게 합니다. 이제 실행하고 해당 버튼을 클릭하면 아래처럼 지도가 표시됩니다.

이제 라벨을 추가하는 ‘Add Label 1’ 버튼의 코드를 살펴보기 전에 이 shp 파일에 대한 속성 정보를 살펴보면 아래와 같습니다.

총 2개의 필드가 존재하며 ‘Add Label 1’ 버튼에서는 SGG_NM 필드를 이용해 라벨을 표시하도록 하겠습니다. ‘Add Label 1’ 버튼에 대한 코드는 아래와 같습니다.

axXr1.Labels.AddLabel("서울", "{SGG_NM}");
XrMapLib.ILabel lbl = axXr1.Labels.GetLabel("서울", "{SGG_NM}");
lbl.SmartLabel = false;
lbl.Font.Name = "맑은 고딕";
lbl.Font.Size = 10;
axXr1.Update();

Xr 엔진의 Labels 프로퍼티 객체의 매서드인 AddLabel 매서드를 통해 라벨을 추가합니다. 인자는 2개로써 첫째는 대상 레이어의 이름이며 둘째는 라벨 문자값으로 표시할 필드명입니다. 지정할 필드명 양쪽으로 {와 }로 감싸야 합니다. 이는 DuraMap-Xr이 표현식을 통한 라벨 기능을 제공하기 때문입니다. 이렇게 추가된 라벨은 GetLabel을 통해 라벨 객체로써 얻을 수 있으며 이 객체를 통해 여러가지 속성을 제어할 수 있습니다. 실행해 보면 아래 그림과 같습니다.

이제 또 다른 라벨을 추가하는 ‘Add Label 2’ 버튼에 대한 코드를 살펴보겠습니다. 이 코드는 앞서 설명한 ‘Add Label 1’ 버튼의 코드와 유사합니다.

axXr1.Labels.AddLabel("서울", "({SGG_ENG_NM})");
XrMapLib.ILabel lbl = axXr1.Labels.GetLabel("서울", "({SGG_ENG_NM})");
lbl.SmartLabel = false;
lbl.Font.Name = "Arial";
lbl.Font.Size = 9;
lbl.Font.Color = (uint)ColorTranslator.ToOle(Color.FromArgb(0, 0, 255));
lbl.Offset.HeightUnit = 1;
axXr1.Update();

주의 깊이 살펴볼 만한 코드는 7번째 코드로 이는 라벨의 높이 만큼 위치를 이동시키라는 코드로 +1의 값은 아래 방향으로 높이 x 1 픽셀만큼 이동하라는 의미입니다. 이는 ‘Add Label 1’ 버튼에서 추가한 라벨과 중복되어지는 것을 막기 위함입니다. 실행하여 버튼을 순서대로 눌러보면 아래 결과와 같습니다.

Xr의 속성 중 레이어를 관리하는 객체인 Layers의 AddShapeMapLayer 매서를 통해 추가된 수치 지도 레이어의 색상 심벌 등을 지정하는 API에 대한 설명입니다.

먼저 개발환경에서 C#의 폼 어플리케이션 프로젝트를 생성하고 폼에 버튼들과 Xr 맵엔진을 올려 아래와 같이 화면을 디자인합니다.

상단에 4개의 버튼이 있는데, 왼쪽에서 오른쪽으로 순서대로 클릭하여 Xr 맵 컴포넌트에 그 반응을 살펴 보도록 하겠습니다. 첫번째 버튼인 Add Layers는 shp 파일로부터 레이어를 추가하는데 건물과 실폭도로에 대한 컨텐츠를 가지고 있습니다. 이 버튼의 클릭 이벤트는 아래와 같습니다.

axXr1.MapBackgoundColor = Color.FromArgb(10, 80, 10);

axXr1.Layers.AddShapeMapLayer("건물", "d:/building.shp");
axXr1.Layers.AddShapeMapLayer("도로", "d:/road.shp");
axXr1.WaitForAllConnections();

axXr1.ZoomFullExtent();
axXr1.MapScale = 4000;

레이어의 식별자로써 사용된 레이어의 이름인 ‘건물’, ‘도로’를 통해 각 레이어 객체를 얻어와 그리기 정의 심벌을 변경함으로써 원하는 스타일의 지도를 그릴 수 있습니다. 먼저 건물 레이어의 심벌을 변경하는 버튼인 Symbol Building 버튼의 클릭 이벤트에 대한 코드는 아래와 같습니다.

XrMapLib.IShapeMapLayer lyr;
lyr = axXr1.Layers.GetLayerAsShapeMap("건물");
if(lyr != null) 
{
    lyr.LineSymbol.Color = 
        (uint)ColorTranslator.ToOle(Color.FromArgb(0, 0, 0));
    lyr.FillSymbol.Color = 
        (uint)ColorTranslator.ToOle(Color.FromArgb(107, 107, 107));
    axXr1.Update();
}

ShapeMapLayer는 LineSymbol과 FillSymbol 그리고 PointSymbol 프로퍼티를 제공하며 이 프로퍼티를 통해 도형을 그리기 위한 심벌을 변경할 수 있습니다. 위의 코드는 도형의 선과 면에 대한 색상 심벌을 변경하고 있습니다.

다음은 ‘도로’ 레이어에 대한 심벌을 변경하는 버튼인 Symbol Road에 대한 코드로써 건물 레이어의 심벌을 변경하는 것과 다르지 않습니다.

XrMapLib.IShapeMapLayer lyr;
lyr = axXr1.Layers.GetLayerAsShapeMap("도로");
if (lyr != null)
{
    lyr.LineSymbol.Color = 
        (uint)ColorTranslator.ToOle(Color.FromArgb(200, 200, 200));
    lyr.LineSymbol.Width = 1;
    lyr.FillSymbol.Color = 
        (uint)ColorTranslator.ToOle(Color.FromArgb(200, 200, 200));

    axXr1.Update();
}

이제 끝으로 건물 레이어의 층수에 대한 값에 대한 속성을 이용하여 입체적으로 표현하기 위한 2.5D Building에 대한 버튼의 코드는 아래와 같습니다.

XrMapLib.IShapeMapLayer lyr;
lyr = axXr1.Layers.GetLayerAsShapeMap("건물");
if (lyr != null)
{
    XrMapLib.MapTheme3D theme3D = lyr.Set3DTheme();
    theme3D.HeightFieldName = "ABV_FL_CNT";
    theme3D.HeightWeight = 3.3;

    axXr1.Update();
}

건물 레이어의 층수에 대한 값은 ABV_FL_CNT라는 이름의 필드에 해당하며 이 값은 층수이므로 미터 단위의 높이값으로 환산하기 위해 3.3이라는 가중치를 주는 코드입니다.

이렇게 총 4개의 버튼에 대한 코드를 통해 순서대로 버튼을 클릭하면 아래와 같은 결과가 Xr 지도에 표시됩니다.

DuraMap-Xr은 쉽게 ESRI의 SHP 파일을 생성할 수 있습니다. SHP 파일은 도형 정보와 속성 데이터가 별도의 파일로 분리된 파일 시스템으로 도형정보는 .shp 파일에 저장되고 속성정보는 .dbf 파일에 저장됩니다. 간단히 DuraMap-Xr에서 SHP 파일을 생성하는 예를 보이기 위해 아래와 같은 폴리곤 데이터를 만들어 보는 DuraMap-Xr의 API에 대해 살펴보겠습니다.

총 3개의 폴리곤으로 구성되어 있으며 속성에 대한 테이블의 필드 구조는 Name, Age, Height를 가집니다.

1. Name은 문자열 타입
2. Age는 정수 타입
3. Height는 실수 타입

그림을 살펴보면 Name이 대길이는 도형은 가운데 구멍이 뚤린 Ring 형태입니다. 즉, 하나의 도형이 2개의 폴리곤으로 구성되는데 하나는 외각 폴리곤이고 두번째는 내부 폴리곤(Hole)입니다. 홍길동과 코난에 대한 도형은 하나의 폴리곤으로 구성되어 있구요.

DuraMap-Xr은 포인트, 폴리라인, 폴리곤 타입에 대한 SHP 파일을 생성할 수 있습니다. 여기서는 위의 그림에 해당하는 폴리곤 SHP 파일을 만들어 보겠습니다.

먼저 Visual Studio를 실행하고 윈도우즈 폼 응용프로그램에 해당하는 프로젝트를 시작합니다. 그리고 참조 추가를 통해 XrMapLib를 추가합니다. 제대로 되었다면 솔루션 탐색기의 참조에 다음 항목이 표시됩니다.

폼위에 버튼을 하나만을 올려 놓습니다. 이 버튼을 클릭하면 SHP 파일이 만들어 지게 됩니다. 지금부터는 클릭 이벤트에 대한 코드를 한줄 한줄 순서대로 소개하겠습니다. 만들고자하는 도형에 대한 그림과 비교하면서 잘 살펴보시기 바랍니다.

XrMapLib.FieldSetDefine FSD = new XrMapLib.FieldSetDefine();
FSD.AddStringField("Name", 20);
FSD.AddIntegerField("Age", 4);
FSD.AddFloatField("Height", 6, 2);

속성에 대한 필드를 정의하는 부분입니다. Name 필드를 위해 AddStringField 매서드를 호출했고 두번째 인자는 값의 최대 길이입니다. 그리고 Age 필드를 위해 AddIntegerField를 호출했고 두번째 필드는 정수값의 길이입니다. 즉 최대 9999까지의 값을 입력할 수 있습니다. 그리고 Height 필드를 위해 AddFloatField를 호출하는데 두번째 인자는 실수값의 길이이며 세번째 값은 소수부분에 대한 길이입니다. 지정한 값이 6과 2이므로 최대 999.99까지의 값을 지정할 수 있습니다.

XrMapLib.Tool tool = new XrMapLib.Tool();

XrMapLib.EsriShpFileHandler SFH = tool.CreateEsriShpFileHandler("d:/polygon.shp",
    XrMapLib.XrShapeTypeEnum.XrPolygon, FSD);

if (SFH == null)
{
    MessageBox.Show("Error: Creating shp file");
} 
else
{
    ....

위의 코드는 실제로 SHP 파일을 생성하는 코드로 Xr의 Tool 객체의 CreateEsriShpHandler를 이용하여 d:/ 폴더 위치에 polygon.shp 파일과 polygon.dbf 파일을 생성합니다. 두번째 인자는 생성하고자 하는 도형의 종류로써 여기서는 폴리곤(XrPolygon)을 지정했고 세번째 인자로 앞서 정의한 속성의 필드정의에 대한 객체를 넘깁니다. 성공적으로 파일이 생성되면 EsriShpFileHandler의 인스턴스가 반환되고 실패하면 null을 반환합니다. 실패한 이유로는 기존에 동일한 이름의 파일이 존재하거나 필드 정의가 잘못된 경우 등입니다. 다음의 코드는 성공적으로 파일을 생성했을때의 코드 부분입니다.

XrMapLib.CoordinateListCollection CLC = new XrMapLib.CoordinateListCollection();
XrMapLib.CoordinateList CL = new XrMapLib.CoordinateList();
XrMapLib.ValueList VL = new XrMapLib.ValueList();

실제 좌표값과 속성값을 저장할 객체드를 생성합니다. CoordinateList는 다수의 포인트 좌표들로 구성되는 리스트이고 CoordListCollection은 다수의 CoordinateList를 포함하는 객체입니다. 여러개의 폴리곤으로 구성된 도형을 추가할때 CoordinateListCollection을 사용해야 하며 위의 예에서 “대길이”에 해당하는 도형을 위한 객체입니다.

CL.Clear();
CL.Add(10, 10);
CL.Add(20, 10);
CL.Add(20, 20);
CL.Add(10, 20);

VL.Clear();
VL.AddByString("홍길동");
VL.AddByInteger(19);
VL.AddByFloat(173.4, 1);
SFH.AddSinglePart(CL, VL);

홍길동에 해당하는 도형을 추가하는 코드입니다. 주의할점은 속성값의 지정순서는 필드의 정의 순서와 일치해야 합니다.

CL.Clear();
CL.Add(30, 10);
CL.Add(40, 10);
CL.Add(40, 20);
CL.Add(30, 20);

VL.Clear();
VL.AddByString("코난");
VL.AddByInteger(16);
VL.AddByFloat(161.4, 1);
SFH.AddSinglePart(CL, VL);

코난에 대한 도형을 추가하는 코드입니다. 앞의 홍길동에 대한 도형 추가 코드와 매우 유사합니다.

CLC.Clear();
CL.Clear();
CL.Add(20, 30);
CL.Add(30, 30);
CL.Add(30, 40);
CL.Add(20, 40);
CLC.Add(CL);
CL.Clear();
CL.Add(22, 32);
CL.Add(28, 32);
CL.Add(28, 38);
CL.Add(22, 38);
CLC.Add(CL);

VL.Clear();
VL.AddByString("대길이");
VL.AddByInteger(24);
VL.AddByFloat(171.4, 1);
SFH.AddMultiPart(CLC, VL);

끝으로 대길이에 대한 폴리곤입니다. 이 도형은 2개의 폴리곤으로 구성되었다는 것을 앞서 그림을 통해 살펴보았습니다.

도형과 속성을 통해 원하는 도형들의 추가가 완료되었으면 가장 마지막으로 다음 코드를 호출하여 마무리합니다.

SFH.Close();

실제로 생성된 파일을 탐색기를 통해 살펴본 그림은 아래와 같습니다.

이 생성된 shp 파일을 DuraMap-Xr로 만든 BeautifyMap으로 살펴보면 아래와 같습니다.

DuraMap-Xr은 지도 데이터를 2가지의 큰 카테고리로 나눠 레이어 개념으로 관리합니다. 여기서 레이어(Layer)란 흔히 GIS에서 사용하는 용어와 동일한 의미를 가집니다.

• ShapeMapLayer : DXF, SHP 등과 같은 수치지도 지도 레이어
• GridMapLayer : 이미지, 라스터 등과 같은 그리드 지도 레이어

여기서는 ESRI에서 제시한 범용 수치지도 포맷인 SHP 파일을 추가하여 Xr 맵엔진에서 표시하는 API를 C#을 통해 설명합니다.

먼저 Visual Studio를 실행하여 C#의 Windows Forms 응용 프로그램 프로젝트를 생성 한 후에 폼에 XrMap 컨트롤과 지도뷰를 조작하기 위한 버튼을 다음 화면처럼 추가합니다.

이제 이 폼에 대한 Load 이벤트에서 Shp 파일을 통해 도형 지도 레이어를 추가하는 코드를 아래와 같이 작성합니다.

axXr1.Layers.AddShapeMapLayer("행정동", "d:/__data__/dong.shp");
axXr1.WaitForAllConnections();
axXr1.ZoomFullExtent();

axXr1은 앞서 폼에 추가한 DuraMap-Xr 컨트롤의 이름입니다. AddShapeMapLayer는 2개의 인자를 받는데 첫번째는 레이어의 식별자로써 레이어의 이름이고 두번째는 공간데이터에 대한 연결 문자열로 파일경로로 적합한 연결문자열입니다. 이렇게 레이어를 추가한 뒤에 WaitForAllConnections을 호출하여 레이어를 추가하는데 필요한 공간데이터를 모두 읽을 때까지 대기합니다. 참고로 공간데이터를 읽는 코드는 스레드로 작동됩니다. WaitForAllConnections 매서드가 반환되면 모든 지도 레이어가 완벽하게 추가되었음을 보장하므로 지도를 화면에 꽉 차게 표시되도록 ZoomFullExtent를 호출합니다. 실행 결과는 아래와 같습니다.

이제 지도 뷰를 조작하기 위해 추가했던 전체 보기, 확대, 축소, 이동, 이전 보기, 보기 되돌리기 버튼에 대한 클릭 이벤트를 구성하는 코드를 살펴보겠습니다.

먼저 전체보기는 이미 앞서 설명드렸던 axXr1.ZoomFullExtent()가 해당되어 아래와 같습니다.

axXr1.ZoomFullExtent();

그리고 현재 보이는 지도를 확대하기 위한 확대 버튼의 코드는 다음과 같습니다.

axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrZoomInMode;

그리고 축소 버튼의 코드는 다음과 같습니다.

axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrZoomOutMode;

그리고 지도를 이동하는 코드는 다음과 같습니다.

axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrPanMode;

그리고 지도에 대한 뷰의 변화에 대한 Undo 기능에 대한 버튼인 이전 보기의 코드는 다음과 같습니다.

axXr1.UndoView();

이전보기에 대한 반개 기능은 보기 되돌리기 버튼의 코드는 다음과 같습니다.

axXr1.RedoView();

이상으로 SHP 파일을 표시하고 사용자가 마우스를 통해 표시된 지도를 조회해 보는 기능에 대해 간단히 살펴보았습니다.