GIS Developer

DuraMap-Xr을 통해 SHP을 읽어 추가된 레이어의 타입은 ShapeMapLayer입니다. 이 ShapeMapLayer를 통해 수치지도에 대한 도형 데이터에 접근할 수 있는 테이블을 얻을 수 있고 이 테이블을 통해 각 도형에 대한 로우(Row)를 얻을 수 있습니다. 그리고 이 Row를 통해 도형의 종류뿐만 아니라 MBR과 도형을 구성하는 좌표의 목록을 얻을 수 있습니다. 이 글은 Xr에서 도형에 대한 정보를 얻기위한 방법에 대해 설명합니다. 먼저 아래와 같은 폼을 만듭니다.

Xr 맵 엔진과 Open SHP라는 버튼 그리고 ListBox 컨트롤이 배치되었으며 보이지는 않지만 SHP 파일을 읽기 위한 OpenFileDialog 컨트롤이 추가되어져 있습니다. 기본적인 실행 흐름은 OpenSHP을 클릭하면 Xr 맵 엔진에 추가할 SHP 파일을 선택하기 위한 파일 열기 대화상자가 표시되며 원하는 SHP 파일을 선택하게 되면 Xr 맵 엔진에 표시되며 동시에 ListBox 컨트롤에 SHP 파일을 구성하는 도형에 대한 MBR 좌표를 표시합니다. 가장 먼저 Open SHP 버튼의 코드를 살펴보도록 하겠습니다.

DialogResult DR = openFileDialog1.ShowDialog();
if(DR == DialogResult.OK)
{
    bool bExisted = axXr1.Layers.IsLayerExist("map");
    if (bExisted) axXr1.Layers.RemoveLayer("map");

    axXr1.Layers.AddShapeMapLayer("map", openFileDialog1.FileName);
    axXr1.WaitForAllConnections();
    axXr1.ZoomFullExtent();

    OutputVertexToListBox();
}

4~5번 코드를 통해 버튼을 두번 이상 눌렀을 경우 map이라는 이름의 레이어가 다시 추가되는 일이 없도록 기존의 map 이라는 이름의 레이어를 제거해주고 있습니다. 7~9번 코드는 선택한 SHP 파일을 map이라는 이름의 레이어로 추가하고 추가가 될때까지 기다렸다가 레이어를 화면상에 표시하도록 하는 코드입니다. 그리고 아직 정의되지 않았지만 가장 중요한 OutputVertexToListBox 함수를 통해 레이어를 구성하는 도형의 MBR을 표시하도록 합니다. 그럼 OutputVertexToListBox 함수에 대해 살펴보도록 하겠습니다.

private void OutputVertexToListBox()
{
    bool bExisted = axXr1.Layers.IsLayerExist("map");
    if (!bExisted) return;

    XrMapLib.IShapeMapLayer lyr = axXr1.Layers.GetLayerAsShapeMap("map");
    XrMapLib.IShapeTable Tbl = lyr.ShapeTable;

    int FID = 0;
    XrMapLib.IShapeRow row = null;
    while ((row = Tbl.GetRow(FID)) != null)
    {
        XrMapLib.IExtent MBR = row.Extent;

        listBox1.Items.Add("FID: " + FID);
        listBox1.Items.Add("  MinX: " + MBR.MinX);
        listBox1.Items.Add("  MinY: " + MBR.MinY);
        listBox1.Items.Add("  MaxX: " + MBR.MaxX);
        listBox1.Items.Add("  MaxY: " + MBR.MaxY);
        listBox1.Items.Add("\n");

        FID++;
    }
}

비교적 짧게 구성된 함수이지만 코드 단위로 설명하면… 먼저 3~4번 코드는 map이라는 이름의 레이어가 존재하는지 검사하여 존재하지 않으면 바로 함수를 종료시키도록 합니다. 6~7번 코드는 map이라는 이름의 레이어를 얻어와 얻은 레이어의 도형 데이터를 가지고 있는 테이블을 가져와 IShapeTable이라는 인터페이스 타입에 저장하고 있습니다. 그리고 9~10번 코드는 테이블에 저장된 Row을 얻기 위한 준비작업으로써 Row을 얻기 위해서는 정수형 값인 FID와 Row를 저장할 인터페이스 타입인 IShapeRow의 변수를 준비하고 있습니다. 기본적으로 SHP 파일의 FID는 0에서부터 (Row의 개수 – 1)까지 존재합니다. IShapeTable의 GetRow에 옳바르지 않은 FID가 지정되면 null을 반환합니다. 11~23번 코드가 Row을 하나 하나 가져와 MBR을 얻어 listBox1 컨트롤에 문자열 형태로 구성하여 추가하는 코드입니다. IShapwRow를 통해 MBR과 좌표의 개수, 좌표를 얻을 수 이 수 있는 매서드를 제공합니다. 도형은 여러개의 부분으로 구성될 수 있는데.. 몇개의 부분으로 구성되었는지 역시 얻어올 수 있습니다. 이와 관련된 매서드는 GetVertex, GetVertexCountFromPart, GetVertexFromPart, PartCount, VertexCount, Vertex입니다. Vertex 프로퍼티는 도형을 구성하는 가장 첫번째 정점을 반환하는 편리성을 위해 제공됩니다. 다음은 필자의 PC에 저장된 SHP 파일에 대해 실행된 결과 화면입니다.

GIS에서 공간 데이터는 도형에 대한 좌표값과 이 도형에 대한 속성 값으로 이루어져 있습니다. 여기서 속성 데이터는 데이터베이스의 테이블 구조와 동일하게 필드 정보와 필드에 해당하는 값에 해당하는 레코드 정보로 구성되어 있습니다. DuraMap-Xr에서 이러한 속성 데이터를 확인하는 API에 대해 살펴보기 위해 마우스로 화면상의 도형을 클릭하면 해당 도형의 속성값을 간단히 메시지 창에서 표현해 주는 예제를 작성해 보도록 하겠습니다. 먼저 다음과 같은 UI를 작성합니다.

총 6개의 버튼과 Xr 맵 컨트롤로 구성되어 있습니다. 첫번째 버튼은 shp 파일을 통해 레이어를 추가하기 위한 버튼(Add Layer)이며 이미지를 캡션으로 추가한 4개이 버튼은 마우스를 통해 지도를 조작하기 위한 전체 보기, 확대, 축소, 이동에 대한 버튼입니다. 끝으로 마지막 버튼(Identify)는 마우스로 화면상의 도형을 선택하면 해당 도형의 속성을 표시하도록 하는 버튼입니다. 먼저 Add Layer에 대한 코드는 로컬에 존재하는 shp 파일을 추가하는 코드로써 다음과 같습니다.

axXr1.MapBackgoundColor = Color.FromArgb(0, 0, 0);

axXr1.Layers.AddShapeMapLayer("map", "d:/data/dong.shp");
axXr1.WaitForAllConnections();

XrMapLib.IShapeMapLayer ML = axXr1.Layers.GetLayerAsShapeMap("map");
if(ML != null) 
{
    ML.FillSymbol.Color = 
        (uint)ColorTranslator.ToOle(Color.FromArgb(150, 150, 150));
    ML.LineSymbol.Color = 
        (uint)ColorTranslator.ToOle(Color.FromArgb(255, 255, 255));
    axXr1.ZoomFullExtent();
    axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrZoomInMode;
}

여기서는 행정동에 해당하는 shp 파일에 대한 레이어를 추가(다른 shp 파일을 사용해도 상관없음)하고 있으며 추가한 후에 바로 레이어의 그리기 심벌을 변경해주고 있습니다. 그리고 ZoomFullExtent를 호출하여 레이어 전체 보기를 수행하고 마우스의 조작 모드를 확대 모드로 설정하기 위해 MouseMode를 XrZoomInMode로 지정합니다.

다음으로 마우스를 통해 화면상의 지도를 조작하기 위한 4개의 버튼은 다음과 같습니다. 이미 DuraMap-Xr의 튜토리얼에서 소개했던 코드이지만 복습을 위해 다시 한번 살펴보면 다음과 같습니다.

먼저 첫번째 화면 조작 버튼인 전체 보기에 대한 코드입니다.

axXr1.ZoomFullExtent();

그리고 다음은 마우스로 사각영역을 지정해 지정한 영역을 확대해 주는 버튼에 대한 코드입니다.

axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrZoomInMode;

그리고 다음은 역시 마우스로 사각영역을 지정하여 축소하는 버튼에 대한 코드입니다.

axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrZoomOutMode;

끝으로 지도를 마우스를 드래그 하여 이동하는 코드입니다.

axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrPanMode;

이제 마지막으로 이 튜토리얼의 하일라이트인 Identify 버튼의 클릭 이벤트의 코드는 다음과 같습니다.

axXr1.MouseMode = XrMapLib.XrMapViewModeEnum.XrNormalMode;

단지 마우스 조작을 XrNormalMode로 지정하고 있을 뿐이며 이렇게 지정된 마우스 조작 모드는 Xr 맵 엔진의 다음과 같은 LButtonUp 이벤트에서 처리해 주게 됩니다.

private void axXr1_OnLButtonUp(object sender,
    AxXrMapLib._IXrMapControlEvents_OnLButtonUpEvent e)
{
    if(axXr1.MouseMode == XrMapLib.XrMapViewModeEnum.XrNormalMode) 
    {
        XrMapLib.IValueList FIDs = 
            axXr1.GetFIDFromMousePoint("map", e.x, e.y, true);
        if (FIDs.Count > 0)
        {
            XrMapLib.IShapeMapLayer Lyr = axXr1.Layers.GetLayerAsShapeMap("map");
            XrMapLib.IAttributeTable tbl = Lyr.AttributeTable;
            XrMapLib.IFieldSet fs = tbl.FieldSet;
            int FID = FIDs.GetByInteger(0);
            XrMapLib.IAttributeRow row = tbl.GetRow(FID);

            if(row.Load()) {
                String value = "Result: \n\n";
                for (int iField = 0; iField < fs.FieldCount; ++iField)
                {
                    value += fs.GetFieldName(iField) + 
                        ": " + row.GetValueAsString(iField) + "\n";
                }

                MessageBox.Show(value);
                
                row.Unload();
            }
        }
       else
       {
           MessageBox.Show("No Item");
       }
    }
}

4번째 줄을 통해 Identify 버튼을 통해 지정된 마우스 모드(MouseMode)의 값(XrNormalMode)일 경우 마우스로 클릭된 지점의 도형에 대한 속성을 조회하는 코드가 실행됩니다. 6번째 줄의 코드인 GetFIDFromMousePoint는 지정된 이름에 해당하는 레이어에 대해 지정된 화면 좌표 상의 도형에 대한 FID 리스트를 반환하게 됩니다. GetFIDFromMousePoint의 마지막 4번째 인자를 통해 지정된 좌표에 존재하는 FID에 대해 첫번째 하나가 발견되면 바로 반환하도록 지시합니다. 8번째 코드를 통해 클릭된 마우스 지점에 대한 도형이 존재하는지를 파악하고 10번~23번 코드를 통해 해당되는 도형에 대한 속성값과 쿼리하여 메세지 창으로 표시합니다. 10번 코드를 통해 해당 레이어를 얻어오는 코드이며 11번 코드는 해당 레이어의 속성 테이블 객체를 얻어 오는 코드이고 12번 코드는 속성 테이블에 대한 필드 정보 객체를 얻어오는 코드이며 13번은 앞서 GetFIDFromMousePoint로부터 얻은 도형에 대한 FID를 값을 가져오는 코드입니다. 그리고 14번 코드는 FID에 해당하는 속성 레코드 객체를 가져오는 코드입니다. 그리고 16번 코드에서 21번 코드는 필드 이름과 필드에 대한 값을 얻어와 문자열로 구성하는 코드입니다. 아래의 결과는 실제 마우스를 통해 클릭한 지점의 도형에 대한 속성을 표시하는 결과 화면입니다.

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’ 버튼에서 추가한 라벨과 중복되어지는 것을 막기 위함입니다. 실행하여 버튼을 순서대로 눌러보면 아래 결과와 같습니다.