[카테고리:] DuraMap-Xr

수치 데이터로 구성된 데이터를 차트와 같은 그래프로 표현하여 사용자의 이해를 높일 수가 있습니다. 여기에 더해 통계 데이터로 구성되는 차트를 지도 위에 표현한다면 더욱 이해도를 높일 수 있을 것입니다. 이 글은 DuraMap-Xr에서 차트를 표현하는 API에 대해 설명합니다. 먼저 아래와 같이 버튼 4개와 Xr 맵 컨트롤을 폼에 추가합니다.

버튼의 구성 순서는 실행 순서와 같습니다. 먼저 Add Map Layer 버튼을 통해 서울시 지도를 레이어로 추가하고 다음으로 Add Chart Layer 버튼을 통해 차트 레이어를 추가합니다. 그리고 이렇게 추가된 차트 레이어에 수치 데이터를 통해 차트 요소를 추가하기 위하여 Add Chart Values 버튼을 클릭합니다. 그리고 차트의 범례를 추가하기 위해 Add Chart Legend 버튼을 클릭합니다. 먼저 Add Map Layer 버튼에 대한 코드는 아래와 같습니다.

axXr1.Layers.AddShapeMapLayer("map", "d:/__data__/seoul.SHP");
axXr1.Layers.AddShapeMapLayer("ref", "ref://map");
axXr1.WaitForAllConnections();

IShapeMapLayer map = axXr1.Layers.GetLayerAsShapeMap("map");
map.FillSymbol.Hollow = true;
map.LineSymbol.Color = RGB(240, 240, 240);
map.LineSymbol.Width = 10;
map.LineSymbol.RoundingEnd = true;

IShapeMapLayer refmap = axXr1.Layers.GetLayerAsShapeMap("ref");
refmap.FillSymbol.Color = RGB(220, 220, 220);
refmap.LineSymbol.Color = RGB(180, 180, 180);
refmap.LineSymbol.Width = 1;

axXr1.ZoomFullExtent();

동일한 SHP 파일로부터 2개의 레이어를 추가합니다. DuraMap-Xr은 동일한 지도 데이터를 통해 서로 다른 스타일로 그릴 수 있또록 지도 데이터를 공유할 수 있는 기능을 제공합니다. 1번 코드에서 원본 레이어를 추가하고 이 원본 레이어를 참조하기 위해 2번 코드에서 AddShapeMapLayer의 두번째 인자인 연결 문자열(Connection String)을 ref://로 시작하여 참조할 레이어의 이름을 덧붙인 형태로 지정합니다. 5번 코드부터는 이렇게 추가된 2개의 레이어의 스타일을 지정하는 코드입니다. 실행 결과는 아래와 같습니다.

다음으로 차트 레이어를 추가하는 코드를 살펴보겠습니다. 이 코드는 Add Chart Layer 버튼에 대한 코드입니다.

axXr1.Layers.AddChartLayer("chart", "");
axXr1.WaitForAllConnections();
IChartLayer chart = axXr1.Layers.GetLayerAsChart("chart");

PieChartDefine define = new PieChartDefine();
define.DrawType = XrPieChartDrawTypeEnum.Xr3DPieChart;
define.StartAngle = 30;
define.Height3D = 10;

LineSymbol LS1 = new LineSymbol();
LineSymbol LS2 = new LineSymbol();
LineSymbol LS3 = new LineSymbol();
FillSymbol FS1 = new FillSymbol();
FillSymbol FS2 = new FillSymbol();
FillSymbol FS3 = new FillSymbol();

LS1.Color = RGB(50, 50, 50);
LS1.Width = 1;
LS2.Color = RGB(130, 130, 130);
LS2.Width = 1;
LS3.Color = RGB(210, 210, 210);
LS3.Width = 1;

FS1.Color = RGB(50, 50, 50);
FS2.Color = RGB(130, 130, 130);
FS3.Color = RGB(210, 210, 210);

ChartSeries cs = new ChartSeries();
cs.Title = "연령대";
cs.Add("0~20세", FS1, LS1);
cs.Add("20~40세", FS2, LS2);
cs.Add("40~100세", FS3, LS3);

IChartDefine cd = define as IChartDefine;
cd.SetChartSize(10, 5, 60, 30);
cd.AddSeries(cs);

chart.SetChartDefine(cd);

제법 긴 코드로 구성되어 있습니다. 차트 레이어에 지정할 수치 데이터의 구조와 차트를 그리기 위한 심벌을 정의하기 위한 코드입니다. 먼저 1~3번 코드가 차트 레이어를 추가하는 코드입니다. 그리고 4~7번 코드는 DuraMap-Xr에서 지원하는 차트 중에 파이 차트를 구성하도록 하는 코드입니다. 9~25번 코드는 파이차트를 그릴때 사용하는 색상 심벌을 정의하는 코드입니다. 여기서 사용할 파이 차트는 총 3개의 항목으로 구성되어 있으므로 채움 심벌과 라인 심벌을 각각 3개씩 정의합니다. 그리고 27~31번 코드가 바로 이 3개의 항목에 대한 정의입니다. 항목의 정의에서 앞서 생성한 색상 심벌을 각 항목에 지정하고 있는 것을 알 수 있습니다. 그리고 끝으로 29~33번 코드를 통해 차트의 구성 정보를 실제로 차트 레이어에 지정하는 합니다. 이 코드들은 내부적인 차트레이어를 구성하고 추가하는 코드이므로 화면상에 아무런 변화가 없습니다. 위의 코드에서 다음과 같은 RGB라는 사용자 정의 함수가 사용되고 있습니다.

private uint RGB(Byte R, Byte G, Byte B)
{
    return (uint)ColorTranslator.ToOle(Color.FromArgb(R, G, B));
}

이 함수는 손쉽게 RGB 값으로 C#의 색상을 지정하기 위한 유틸리티 함수입니다.

이제 실제로 차트에 대한 수치 데이터 값을 구성하는 코드가 필요합니다. 바로 Add Chart Values 버튼이 이러한 일을 수행하는 코드입니다. 차트 값은 파일로부터 읽어오는 것으로 하겠습니다. 사용할 데이터에 대한 파일은 chartdata.txt이며 내용은 아래와 같습니다.

총 25개의 줄로 구성되었으며 이는 서울시의 구가 총 25개이고 이들에 대한 수치값으로 구성되었기 때분입니다. 첫번째 컬럼인 서울시의 각 구에 대한 FID 값이며 나머지 3개의 컬럼은 앞서 설명한 3개의 항목에 대한 값입니다. 이제 버튼에 대한 코드는 다음과 같습니다.

FileInfo fi = new FileInfo("d:/__data__/chartdata.txt");
StreamReader sr = fi.OpenText();
IChartLayer chart = axXr1.Layers.GetLayerAsChart("chart");
IShapeMapLayer map = axXr1.Layers.GetLayerAsShapeMap("map");

while (!sr.EndOfStream)
{
    string line = sr.ReadLine();
    string[] token = line.Split('\t');
    int FID = int.Parse(token[0]);
    int value1 = int.Parse(token[1]);
    int value2 = int.Parse(token[2]);
    int value3 = int.Parse(token[3]);

    ShapeRow row = map.ShapeTable.GetRow(FID);
    if (row != null)
    {
        if (row.Load())
        {
            ICoordinate centroid = row.Centroid;
            ValueListCollection vlc = new ValueListCollection();
            ValueList vl = new ValueList();

            vl.AddByInteger(value1);
            vl.AddByInteger(value2);
            vl.AddByInteger(value3);

            vlc.AddValueList(vl);
            chart.AddChartRow(FID, centroid.X, centroid.Y, vlc);

            row.Unload();
        }
    }
}

chart.Rebuild();
sr.Close();            
axXr1.ZoomFullExtent();

파일을 열고 파일에 대한 텍스트 값을 읽어서 필요한 값을 파싱하는 C# 코드에 대한 설명은 생략하겠습니다. 중요한 부분은 20번 코드에서 차트가 표시될 위치를 얻어오고 텍스트 파일에서 읽어들인 수치 데이터를 21~28코드를 통해 지정합니다. 29번 코드가 실제로 이렇게 구한 차트의 표시 위치와 값을 지정하여 차트 항목을 추가하는 코드입니다. 아래의 그림은 실행 결과에 대한 이미지입니다.

이제 끝으로 차트의 범례를 추가하기 위한 Add Chart Legend 버튼에 대한 코드를 살펴보겠습니다.

bool bOK = axXr1.Legends.AddLegend("chartLegend", 
        XrPositionTypeEnum.XrBottomRight);
if(bOK) 
{
    Legend lgd = axXr1.Legends.GetLegend("chartLegend");

    VerticalLayoutLegendElement vbox = new VerticalLayoutLegendElement();
    vbox.Name = "vbox";
    lgd.SetLegendElement(vbox as ILegendElement);

    TextLegendElement title = new TextLegendElement();
    title.Name = "title";
    title.TextColor = RGB(80, 80, 80);
    title.FontName = "HY견고딕";
    title.FontSize = 15;
    title.Text = "연령대비";
    title.HorizontalCenter = true;
    title.SetMargin(5, 0, 0, 0);
    vbox.AddLegendElement(title as ILegendElement);

    HorizontalBarLegendElement hbar = new HorizontalBarLegendElement();
    hbar.Name = "hbar";
    vbox.AddLegendElement(hbar as ILegendElement);   

    IPieChartLegendElement pcle = new PieChartLegendElement();
    pcle.Name = "pie";
    pcle.Width = 150;
    pcle.Height = 80;
    pcle.SetMargin(35, 35, 35, 35);
    pcle.SetChartLayer(axXr1.Layers.GetLayerAsChart("chart"));
    vbox.AddLegendElement(pcle as ILegendElement);

    axXr1.Legends.Update();
}

중요한 부분만을 언급하면 25~31번 코드가 파이 차트에 대한 범례의 항목을 생성하여 범례에 추가하는 코드입니다. DuraMap-Xr은 범례에 대해 사용자가 원하는 다양한 요구 사항을 만족시키기 위하여 레이아웃 기반으로 범례의 구성 항목을 조립하는 형태로 범례를 구성하도록 되어 있습니다. 결과는 아래와 같습니다.

공간 상의 인구 데이터와 같은 공간 통계 데이터를 이용하여 주제도를 작성하는 기능은 GIS의 중요한 기능 중에 하나입니다. 예를들어서 각 지역에 대해 집계된 인구수를 지역 별로 비교하기 위해 단계별로 색상을 달리하여 주제도를 만들 필요가 있는데 DuraMap-Xr에서 이러한 방법에 대해 살펴보도록 하겠습니다.

필요로 하는 GIS의 기능이 정해지기 전에 먼저 파악되는 것이 아마도 데이터가 아닐까 싶습니다. 사용할 데이터는 집계구에 대한 인구수가 저장된 shp 파일로써 인구수 값에 대한 필드명은 I05_01입니다. 즉, 인구수 값에 대한 필드인 I05_01의… 값을 총 5개의 단계로 나누고 단계별로 색상을 달리하여 표현하는 주제도를 작성해 보도록 하겠습니다. 먼저 아래와 같은 폼을 디자인 합니다.

폼 위에 ‘Add Layer’ 버튼과 ‘Set Theme’ 버튼, 그리고 ‘Add Legend’ 버튼이 존재하며 Xr 맵엔진이 배치되었습니다. Add Layer를 통해 앞서 설명했던 shp 파일을 레이어로 추가하고 Set Theme을 통해 통계 데이터에 대 주제도를 설정하며 끝으로 Add Legend를 통해 주제도에 대한 범계를 표시합니다. 먼저 Add Layer 버튼에 대한 코드는 다음과 같습니다.

axXr1.Layers.AddShapeMapLayer("pop", "d:/__data__/pop.shp");
axXr1.WaitForAllConnections();
axXr1.ZoomFullExtent();

저장된 pop.shp 파일을 통해 pop라는 이름의 레이어를 추가하는 코드입니다. 이미 다른 글들을 통해서 레이어를 추가하는 코드는 많이 살펴봤으므로 설명은 생략합니다.

다음은 Set Theme버튼에 대한 코드입니다.

axXr1.WaitForAllDrawing();
            
IShapeMapLayer lyr = axXr1.Layers.GetLayerAsShapeMap("pop");
IMapThemeRange rangeTheme = lyr.SetRangeTheme();
rangeTheme.ValueFieldName = "I05_01";

int cntSteps = 5;
int step = 255 / cntSteps;
int v = -step;
FillSymbol[] fs = new FillSymbol[cntSteps];
for (int i = 0; i < cntSteps; i++)
{
    v += step;
    fs[i] = new FillSymbol();
    fs[i].Color = (uint)ColorTranslator.ToOle(Color.FromArgb(v, v, v));
}

LineSymbol ls = new LineSymbol();
ls.Color = (uint)ColorTranslator.ToOle(Color.FromArgb(0, 0, 0));

rangeTheme.AddRange(0, 427, fs[4], ls, null);
rangeTheme.AddRange(427, 558, fs[3], ls, null);
rangeTheme.AddRange(558, 705, fs[2], ls, null);
rangeTheme.AddRange(705, 847, fs[1], ls, null);
rangeTheme.AddRange(847, 1064, fs[0], ls, null);

axXr1.Update();

1번 코드는 혹시 Xr 맵엔진의 렌더링 스레드를 통해 지도가 그려지는 중이라면 지도가 모두 그려질때까지 대기하라는 코드입니다. 이 코드가 필요한 이유는 지도를 그리고 있는데 갑작이 데이터를 변경시킬 경우 발생하는 문제를 피하기 위함입니다. 3~5번 코드는 앞서 추가한 레이어(pop)를 속성값의 범위에 따라 다른 심벌을 지정할 수 있는 주제도로 설정하고 값의 범위로 사용할 필드명(I05_01)로 지정하는 코드입니다. 그리고 7~19번 코드는 값의 범위를 총 5개의 그룹으로 만들 것이며 이 5개의 색상 심벌을 단계별 만들기 위한 코드입니다. 채움 심벌(FillSymbol)를 배열로 하여 총 5개를 만들고 외곽선 심벌(LineSymbol)에 대해서는 공용이므로 하나만 만듭니다. 그리고 이제 21~25번 코드를 통해 값의 범위와 범위를 만족하는 도형에 대한 그리기 심벌을 지정하는 코드입니다. AddRange의 첫번째와 두번째 값이 값의 범위이며 세번째와 네번째는 채움 심벌과 라인 심벌입니다. 그리고 다섯번째는 포인트 심벌로써 사용하는 데이터가 폴리곤이므로 포인트 심벌을 사용되지 않으므로 null 값으로 지정했습니다. 마지막 코드에서 Update 매서드를 호출하면 아래와 같은 결과가 나타납니다.

각 집계구의 인구에 따라 색상을 달리 표시된 것을 확인할 수 있습니다. 인구가 많은 지역은 어둠게.. 적은 지역은 밝게 표시되었습니다. 하지만 각 색상에 대해 어떤 값인지를 알수없는데, 이런 정보를 제공해주는 것이 바로 주제도에서의 범례입니다. 이제 Add Legend 버튼의 코드에 대해 살펴보도록 하겠습니다.

DuraMap-Xr의 범례는 자동화된 방식이 아니라 사용자가 직접 범례를 구성하도록 하는 방식을 제공합니다. LLS(Legend Layout System) 방식을 통해 사용가 직접 원하는 항목을 구성하여 범례를 구성하는 방식으로써 여기서는 다음과 같은 레이아웃으로 범례를 구성할 것입니다.

위의 레이아웃 설계를 보면 VerticalLayoutLegendElement를 최상위 레이아웃으로 시작해서 이 레이아웃 안에 다수의 LegendElement로 구성된 것을 살펴볼 수 있습니다. 앞서 속성값의 구룹을 총 5개로 나눴다고 했으므로 색상을 표시하기 위한 SolidColorFillBoxLegendElement 5개와 이 색상에 대한 설명을 위한 각각의 TextLegendElement 5개로 구성되어 있습니다. Add Legend 버튼의 코드를 살펴보는 것이 순서이겠지만.. 먼저 이러한 레이아웃 설계를 기반하여 작성된 코드의 결과를 살펴보는 것이 이해를 도울 것으로 생각되므로 Add Legend 버튼을 클릭했을때의 결과를 살펴보면 아래와 같습니다.

지도 화면의 우측한단에 범례가 추가된 것을 살펴볼 수 있으며 위의 범례에 대한 레이아웃 설계와 실제 표시된 범례를 비교해보면 이해가 더 쉬울 것입니다. 그럼 이제 이러한 범례를 표시하기 위한 Add Legend 버튼의 코드를 살펴보도록 하겠습니다.

axXr1.WaitForAllDrawing();
            
bool bOK = axXr1.Legends.AddLegend("label", XrPositionTypeEnum.XrBottomRight);
if(bOK) 
{
    Legend legend = axXr1.Legends.GetLegend("label");

    VerticalLayoutLegendElement vbox = new VerticalLayoutLegendElement();
    vbox.Name = "vbox";
    legend.SetLegendElement(vbox as ILegendElement);

    TextLegendElement title = new TextLegendElement();
    title.Name = "title";
    title.FontName = "HY견고딕";
    title.FontSize = 15;
    title.Text = "집계구 인구";
    title.HorizontalCenter = true;
    title.SetMargin(5, 0, 0, 0);
    vbox.AddLegendElement(title as ILegendElement);

    HorizontalBarLegendElement hbar = new HorizontalBarLegendElement();
    hbar.Name = "hbar";
    vbox.AddLegendElement(hbar as ILegendElement);

    int cntSteps = 5;
    int step = 255 / cntSteps;
    int v = -step;
    string [] itemTitle = new String[5];
    itemTitle[4] = "0 ㅡ 427";
    itemTitle[3] = "427 ㅡ 558";
    itemTitle[2] = "558 ㅡ 705";
    itemTitle[1] = "705 ㅡ 847";
    itemTitle[0] = "847 ㅡ 1063";

    for (int i = 0; i < cntSteps; i++)
    {
        v += step;
        vbox.AddLegendElement(
            CreateColorItem("item" + i, Color.FromArgb(v, v, v), itemTitle[i])
                as ILegendElement);
    }

    axXr1.Legends.Update();
}

3번 코드가 바로 범례를 추가하는 코드입니다. DuraMap-Xr에서는 범례를 레이어와 같은 독립된 개념으로 다루고 있다는 것을 알 수 있습니다. 8번 코드가 범례의 최외각 레이아웃인 VerticalLayoutLegendElement로써 vbox라는 이름을 지정하고 범례에 지정됩니다. 모든 범례의 구성 요소는 이름을 할당해야 하며 이 이름을 통해 각 범례의 구성 요소를 얻어와 삭제하거나 속성을 변경할 수 있습니다. 12~19번 코드는 범례의 제목을 표시하기 위한 TextLegendElement 객체를 만들고 있으며 21~23번 코드는 제목과 5개의 항목을 가시적으로 분리하기 위한 HorizontalBarLegendElement 객체를 생성하여 추가하고 있습니다. 그리고 25~40번 코드는 5개의 색상 및 설명을 위한 텍스트 항목을 추가하기 위한 코드입니다. 39번 코드는 색상에 대한 범례 요소와 텍스트 요소의 생성을 자동화하기 위한 별도의 매서드로써 다음과 같습니다.

private HorizontalLayoutLegendElement 
    CreateColorItem(string name, Color clr, string text)
{
    HorizontalLayoutLegendElement hbox = new HorizontalLayoutLegendElement();
    hbox.Name = name;

    SolidColorFillBoxLegendElement color = new SolidColorFillBoxLegendElement();
    color.Name = name + "_clr";
    color.FillSymbol.Color = (uint)ColorTranslator.ToOle(clr);
    color.LineSymbol.Color = (uint)ColorTranslator.ToOle(Color.FromArgb(0, 0, 0));
    color.Width = 16;
    color.Height = 16;
    color.SetMargin(3, 1, 3, 20);
    hbox.AddLegendElement(color as ILegendElement);

    TextLegendElement txt = new TextLegendElement();
    txt.Name = name + "_txt";
    txt.FontName = "Arial";
    txt.FontSize = 11;
    txt.Text = text;
    txt.SetMargin(0, 20, 0, 20);

    hbox.AddLegendElement(txt as ILegendElement);
    return hbox;
}

이 매서드 역시 앞서 설명한 범례의 레이아웃 설계 그림을 기반으로 작성된 코드이므로 코드를 하나 하나 살펴보면 이해할 수 있으므로 자세한 설명은 생략하도록 하겠습니다.

DuraMap-Xr은 속성값에 대해 도형의 그리기 심벌을 다르게 지정하여 주제도를 작성할 수 있는 기능을 제공합니다. DuraMap-Xr에서 속성에 대한 주제도를 작성하기 위해 제공되는 주요 COM 클래스는 다음과 같습니다.

• MapThemeEqual
• MapThemeSimilarity
• MapThemeRange
• MapTheme3D

MapThemeEqual은 값이 정확히 일치하는 도형에 대한 심벌을 지정합니다. 그리고 MapThemeSimilarity는 값이 부분적으로 비슷하게 일치하는 도형에 대한 심벌을 지정합니다. 또한 MapThemeRange는 주어진 범위에 값이 포함되는 도형에 대한 심벌을 지정합니다. 끝으로 MapTheme3D는 도형의 속성값을 높이값으로 하여 도형을 입체적으로 표현합니다.

이 포스트는 이 네가지 주제도 작성 기능 중에서 유사한 값을 가지는 도형에 대한 심벌을 지정하는 MapThemeSimilarity에 대해 살펴 보도록 하겠습니다. 먼저 다음과 같은 폼을 디자인합니다.

단순하게 Xr 맵엔진과 Similarity Values ThemeMap이라는 제목의 버튼만이 존재합니다. 가장 먼저 코딩할 부분은 폼이 Load될때입니다. 다음은 폼의 Load 이벤트의 코드입니다.

private void Form1_Load(object sender, EventArgs e)
{
    axXr1.Layers.AddShapeMapLayer("lyr1", "d:/__data__/map.shp");
    axXr1.WaitForAllConnections();
    axXr1.ZoomFullExtent();
}

lyr1이라는 이름의 레이어를 추가하며 추가되면 지도를 전체 크기로 확대합니다. 결과는 다음과 같습니다.

주제도가 속성과 밀접하게 관계되어 있으므로 이 레이어의 속성을 살펴보면 다음과 같습니다.

여기서 JIBUN이라는 필드값을 사용할 것이며 필드값중 ‘도’자와 ‘천’자가 들어간 도형에 대해 각기 다른 그리기 심벌을 지정하도록 하겠습니다. 참고로 ‘도’는 도로이며 ‘천’은 하천에 대한 지번의 부분 코드입니다. 아래는 이외에 다른 코드에 대한 내용에 대한 표입니다.

이제 Similarity Values ThemeMap 버튼의 클릭 이벤트에 대한 코드를 살펴 보겠습니다. 코드가 길지 않으니 전체 코드를 보이고 각 코드를 살펴보겠습니다.

XrMapLib.IShapeMapLayer lyr = axXr1.Layers.GetLayerAsShapeMap("lyr1");
lyr.FillSymbol.Hollow = true;
lyr.LineSymbol.Alpha = 0;
XrMapLib.IMapThemeSimilarity SimilarityTheme = lyr.SetSimilarityTheme();
SimilarityTheme.ValueFieldName = "JIBUN";

XrMapLib.FillSymbol fs1 = new XrMapLib.FillSymbol();
fs1.Color = (uint)ColorTranslator.ToOle(Color.FromArgb(200, 120, 10));
XrMapLib.LineSymbol ls1 = new XrMapLib.LineSymbol();
ls1.Color = fs1.Color;
SimilarityTheme.AddStandard("%도%", fs1, ls1, null);

XrMapLib.FillSymbol fs2 = new XrMapLib.FillSymbol();
fs2.Color = (uint)ColorTranslator.ToOle(Color.FromArgb(0, 0, 255));
XrMapLib.LineSymbol ls2 = new XrMapLib.LineSymbol();
ls2.Color = fs2.Color;
SimilarityTheme.AddStandard("%천%", fs2, ls2, null);

axXr1.Update();

먼저 1~3번 코드는 Load 이벤트에서 추가했던 레이어를 가져와 채움 심벌과 라인 심벌을 변경하고 있는 코드로써 채움 심벌(FillSymbol)의 Hollow를 true로 지정하면 도형의 채움을 무시하게 되고 라인 심벌(LineSymbol)의 Alpha를 0으로 주게 되면 라인 심벌을 그리지 않게 됩니다. 이렇게 지정한 이유는 주제도 기능에서 속성값에 대한 조건을 주게 되는데 조건에 만족하지 않는 도형에 대한 기본 심벌이 바로 이처럼 처음에 레이어에 지정된 심벌로 그대로 사용되기 때문입니다.

3~5번 코드가 레이어의 주제도 기능을 SimilarityTheme으로 설정하고 사용할 속성의 필드를 JIBUN이라는 필드명으로 지정합니다. 이 필드명은 앞서 레이어의 속성에 대해 언급했던 필드명입니다.

7~11번 코드는 속성값중 ‘도’자가 들어간 도형에 대한 심벌을 지정하기 위한 코드로써 먼저 채움심벌과 라인 심벌을 만들고 MapThemeSimilarity 객체의 AddStandard 매서드를 사용하여 조건값(%도%)과 사용할 심벌을 채움심벌, 라인심벌, 포인트심벌 순서대로 지정합니다. 여기서는 포인트 심벌을 사용할 필요가 없기 대문에 null을 주었습니다.

13~17번 코드는 7~11번 코드와 동일한 목적의 코드로 ‘천’자가 들어간 도형에 대한 심벌을 지정합니다.

마지막으로 Xr 맵엔진의 Update 매서드를 호출하면 다음처럼 결과가 나타나게 됩니다.

‘도’자가 포함된 속성값을 가지는 도형은 지정한 심벌인 황색으로 표시되고 ‘천’자가 포함된 속성값을 가지는 도형은 파랑색으로 표시되며 조건에 만족하지 않는 도형들은 모두 레이어에 지정된 기본 심벌대로 그려지게 됩니다.

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 파일에 대해 실행된 결과 화면입니다.