김형준 GIS 연구소 (for Developers) -

ArcObjects는 공간분석등을 포함한 지오프로세싱과 공간 데이터 편집에도 탁월한 기능을 제공하지만 공간 데이터의 표현에도 매우 뛰어난 기능을 제공합니다. 여기서는 공간 데이터에 대한 각 속성값에 따라 다른 그리기 심벌을 지정할 수 있는 UniqueValueRenderer에 대해 정리해 보도록 하겠습니다. UniqueValueRenderer는 특정 값에 대한 그리기 심벌을 정의할 수 있는 렌더러입니다. 이 포스트는 기본적으로 SHP 파일을 통한 레이어를 ArcObjects에서 제공하는 지도 컨트롤에 추가하고 있다고 가장합니다.

ESRI.ArcGIS.Carto.IFeatureLayer pFL; pFL = axMapControl1.get_Layer(0) as ESRI.ArcGIS.Carto.IFeatureLayer; ESRI.ArcGIS.Geodatabase.IFeatureClass pFClass; pFClass = pFL.FeatureClass; ESRI.ArcGIS.Geodatabase.IQueryFilter pQF; pQF = new ESRI.ArcGIS.Geodatabase.QueryFilter(); ESRI.ArcGIS.Geodatabase.IFeatureCursor pFCur; pFCur = pFClass.Search(pQF, false); 앞의 코드는 먼저 지도 컨트롤에 추가된 SHP 데이터에 대한 레어이의 IFeatureLayer 인터페이스를 구하고 있습니다. IFeatureLayer를 통해 속성값에 접근할 수 있는 IFeatureClass 인터페이스를 구할 수 있으며 이 IFeatureClass의 검색 메서드인 Search에 인자로 IQueryFilter 타입의 값을 넘겨주면 레이어의 전체 속성 레코드를 얻어오게 되고 그 결과는 IFeautreCursor 인터페이스를 통해 접근할 수 있습니다.

ESRI.ArcGIS.Display.IRandomColorRamp pRCR; pRCR = new ESRI.ArcGIS.Display.RandomColorRamp(); pRCR.MinSaturation = 0; pRCR.MaxSaturation = 100; pRCR.MinValue = 0; pRCR.MaxValue = 100; pRCR.StartHue = 0; pRCR.EndHue = 360; pRCR.UseSeed = true; pRCR.Seed = 87; 앞의 코드는 색상 심벌을 손쉽게 만들어 낼 수 있는 유틸리티 인터페이스인 IRandomColorRamp를 인스턴스화 하고 있습니다. 이 인터페이스는 사용자가 지정한 색조와 채도등의 값을 지정하고 지정된 값의 범위 내에서 임의의 난수 발생을 통해 색상 심벌을 뽑아 낼 수 있습니다. 참고로 지정할 수 있는 Hue의 최소와 최대값은 각각 0, 360이며 Saturation의 최소와 최대값은 각각 0, 100 그리고 Value의 최소, 최대값은 0, 100입니다. 또한 난수 발생에 대한 Seed값을 지정할 수 있는 속성을 제공합니다.

ESRI.ArcGIS.Carto.IUniqueValueRenderer pRender; pRender = new ESRI.ArcGIS.Carto.UniqueValueRenderer(); pRender.FieldCount = 1; pRender.set_Field(0, "SGG_NM"); ESRI.ArcGIS.Display.ISimpleFillSymbol pSFS; pSFS = new ESRI.ArcGIS.Display.SimpleFillSymbol(); pSFS.Style = ESRI.ArcGIS.Display.esriSimpleFillStyle.esriSFSSolid; pSFS.Outline.Width = 0.4; pRender.DefaultSymbol = pSFS as ESRI.ArcGIS.Display.ISymbol; pRender.UseDefaultSymbol = true; 앞의 코드는 이 포스트의 주인공인 UniqueValueRenderer를 생성하고 속성값을 설정하는 코드의 일부입니다. 앞서 언급했듯이 UniqueValueRenderer는 속성값에 기반하여 서로 다른 속성값에 따라 각기 다른 색상 심벌을 지정한다고 했습니다. 4번과 5번 코드는 속성값을 얻어올 필드의 개수의 필드명(여기서는 SGG_NM)을 지정합니다. 또한 지정하지 못한 속성값을 가지는 도형에 대해 기본적으로 사용할 그리기 심벌을 지정하는 코드가 7~12번의 코드입니다.

ESRI.ArcGIS.Geodatabase.IFeature pFeat; long n = pFClass.FeatureCount(pQF); ESRI.ArcGIS.Geodatabase.IFields pFields; pFields = pFClass.Fields; int iField = pFields.FindField("SGG_NM"); for(long i = 0; i<n; i++) { ESRI.ArcGIS.Display.ISimpleFillSymbol pUniqueSFS; pUniqueSFS = new ESRI.ArcGIS.Display.SimpleFillSymbol(); pUniqueSFS.Style = ESRI.ArcGIS.Display.esriSimpleFillStyle.esriSFSSolid; pUniqueSFS.Outline.Width = 0.4; pFeat = pFCur.NextFeature(); string value = pFeat.get_Value(iField) as String; bool valFound = false; for(int uh=0; uh<pRender.ValueCount; uh++) { if(pRender.get_Value(uh) == value) { valFound = true; break; } } if(!valFound) { pRender.AddValue(value, "Name", pUniqueSFS as ESRI.ArcGIS.Display.ISymbol); pRender.set_Label(value, value); pRender.set_Symbol(value, pUniqueSFS as ESRI.ArcGIS.Display.ISymbol); } } 앞의 코드부분은 각 속성값에 대한 그리기 심벌(정확히 말하면 SimpleFillSymbol)을 지정합니다. 동일한 값의 중복되는 속성값에 대해 이중으로 그리기 심벌을 지정하지 않도록 valFound 변수를 통해 걸러내고 있습니다. 코드 라인 별로 살펴보면, 2번 코드는 레이어가 가지고 있는 전체 속성 레코드의 개수를 얻어와 n 변수에 저장하고 있습니다. 그리고 3번, 5번 코드는 속성값을 가져올 필드명에 대한 인덱스를 얻어와 iField에 저장합니다. 6번 코드의 for문은 모든 레코드에 대해서 앞서 지정한 필드의 값을 가져오고 그 필드 값에 대해 그리기 심벌을 생성하여 지정하고 있습니다. 15번 라인의 for문은 앞서 저장해둔 속성값들 중에 중복된 속성값에 대해서는 이중으로 심벌을 지정하지 않도록 하는 코드입니다. 여기서 눈여겨 봐야 할 점은 생성해 지정한 그리기 심벌에 대한 색상값을 지정하고 있지 않다는 점입니다. 일단 그리기 심벌을 생성해 두기만 하고 다음에 색상값을 지정합니다.

pRCR.Size = pRender.ValueCount; bool bOK = true; pRCR.CreateRamp(out bOK); ESRI.ArcGIS.Display.IEnumColors pEnumClrs; pEnumClrs = pRCR.Colors; pEnumClrs.Reset(); for(int ny=0; ny<pRender.ValueCount; ++ny) { string xv; xv = pRender.get_Value(ny); ESRI.ArcGIS.Display.ISimpleFillSymbol pMySFS; pMySFS = pRender.get_Symbol(xv) as ESRI.ArcGIS.Display.ISimpleFillSymbol; pMySFS.Color = pEnumClrs.Next(); } 앞의 코드는 이전 부분에서 생성해둔 그리기 심벌을 IRandomColorRamp 인터페이스 타입으로 생성해둔 객체를 통해 색상을 얻어와 실제 지정하는 코드입니다. 앞서서 pRCR이라는 변수 명으로 IRandomColorRamp 인터페이스의 CoClass를 생성해 놓았습니다. 이 pRCR로부터 생성할 색상의 개수를 지정하고 CreateRamp 매서드를 호출하여 원하는 개수만큼 원하는 색상 계열로 색상을 생성해 두는 코드가 1번~3번 코드입니다. 이제 생성해 놓은 색상을 얻기 위해 Iterator 디자인 패턴의 방법을 통해 얻어 오는 부분이 4,5,6번 코드와 12번 코드입니다. 7번 코드의 for문은 고유한 필드값으로 저장된 그리기 심벌들을 가져와서 이 심벌의 색상을 pRCR에서 얻어온 색상으로 지정하기 위한 반복문입니다. 이 부분까지가 UniqueValueRenderer에 대한 필요한 속성값들을 설정하기 위한 모든 과정입니다. 이렇게 구성한 UniqueValueRenderer를 레이어에 지정하는 코드는 아래와 같습니다.

pRender.ColorScheme = "Custom"; pRender.set_FieldType(0, true); ESRI.ArcGIS.Carto.IGeoFeatureLayer pGFL = pFL as ESRI.ArcGIS.Carto.IGeoFeatureLayer; pGFL.Renderer = pRender as ESRI.ArcGIS.Carto.IFeatureRenderer; axMapControl1.ActiveView.Refresh(); 레이어의 렌더러는 IGeoFeatureLayer 인터페이스를 통해 접근할 수 있으므로 4번~6번 코드와 같은 형태로 렌더러를 지정할 수 있습니다. 최종적인 실행 결과는 아래와 같습니다.

[ArcObjects] 지도 화면 조작(확대/축소/이동)

ArcObjects는 ArcGIS의 기반되는 수많은 COM Object입니다. 처음에는 ArcGIS 툴을 설치함으로써 ArcObjects를 사용할 수 있다는 부담이 이었으나 현재는 ArcGIS가 아닌 ArcEngine이라는 개발자 SDK 형태로 ArcObjects만을 설치할 수 있도록 편의를 제공합니다. (이부분은 필자의 추측이므로 틀렸을때는 과감한 하이킥 부탁드립니다) 이번 글에서는 ArcObjects를 이용해 화면상에 표시한 지도를 마우스를 이용하여 확대 또는 축소하거나 이동 시키는 방법에 대해 설명합니다.

이 글은 일단 ArcObjects의 지도 컨트롤에 레이어가 하나 추가되었다고 가정하고 설명합니다. 또한 아래 화면처럼 Zoom In, Zoom Out, Pan, Zoom Full 이라는 텍스트를 가진 버튼이 존재합니다.

각 버튼에 대한 기능을 하나 하나 살펴 보도록 하겠습니다. 먼저 Zoom In 버튼을 클릭했을 때의 코드는 아래와 같습니다.

private void button2_Click(object sender, EventArgs e)
{
    // 0: None
    // 1: Zoom In Mode
    // 2: Zoom Out Mode
    // 3: Pan
    MapViewMode = 1;
}

MapViewMode는 아래와 같이 정의된 parivate 접근자 클래스 맴버 변수입니다.

// 0: None
// 1: Zoom In Mode
// 2: Zoom Out Mode
// 3: Pan
private int MapViewMode = 0;

private bool bMouseDown = false;
private ESRI.ArcGIS.Geometry.IPoint DownPt = new ESRI.ArcGIS.Geometry.Point();

지도의 확대, 축소, 이동 기능은 마우스 이벤트와 밀접하게 연관되어 있기 때문에 마우스 이벤트 안에서 현재 사용자가 어떤 지도 조작 기능을 원하는지를 저정해 놓을 필요가 있습니다. 바로 MoveViewMode가 현재 지도 조작 모드 값을 담고 있으며 1은 확대 모드, 2는 축소 모드, 3은 이동 모드를 의미합니다. 이외에도 현재 마우스 버튼이 눌려진 상태인지를 나타내는 bMouseDown과 마우스가 눌려진 커서의 위치를 지도 좌표로 저장할 DownPt 변수가 있습니다.

Zoom In 버튼을 눌러 MapViewMode를 1로 설정함으로써 마우스 이벤트에 대해 지도 확대 모드 상태임을 파악할 수 있게 되었습니다. 이제 마우스 이벤트에 대해 살펴보도록 하겠습니다.

private void axMapControl1_OnMouseDown(object sender, 
                    AxESRI.ArcGIS.Controls.IMapControlEvents2_OnMouseDownEvent e)
{
    if (MapViewMode == 1) 
    {
        ESRI.ArcGIS.Geometry.IEnvelope pEnv = axMapControl1.TrackRectangle();
        axMapControl1.ActiveView.Extent = pEnv;
        axMapControl1.ActiveView.Refresh();
    }

마우스 다운 이벤트입니다. 지도 확대 모드인MapViewMode가 1에 대해 6, 7, 8번 라인의 코드가 실행됩니다. 여기까지가 지도를 마우스를 통해 사각형 영역을 지정하여 지정된 사각형 영역에 대한 지도 확대 기능입니다.

다음으로 Zoom Out 버튼인 지도 축소 기능에 대해 살펴보겠습니다. 먼저 버튼의 클릭 이벤트의 코드는 아래와 같습니다.

private void button3_Click(object sender, EventArgs e)
{
    // 0: None
    // 1: Zoom In Mode
    // 2: Zoom Out Mode
    // 3: Pan
    MapViewMode = 2;
}

축소 기능도 확대 기능과 마찬가지로 마우스 다운 이벤트에서 지도 축소 기능을 수행합니다. 아래의 코드는 마우스 다운 이벤트에서 지도 축소 기능에 대한 코드 부분입니다.

private void axMapControl1_OnMouseDown(object sender, 
                       AxESRI.ArcGIS.Controls.IMapControlEvents2_OnMouseDownEvent e)
{
    if (MapViewMode == 1) 
    {
        ...
    }
    else if(MapViewMode == 2) 
    {
        ESRI.ArcGIS.Geometry.IEnvelope pEnv = axMapControl1.TrackRectangle();
    
        double OldWidth = axMapControl1.ActiveView.Extent.XMax - 
                                          axMapControl1.ActiveView.Extent.XMin;
        double TrackWidth = pEnv.XMax - pEnv.XMin;
        double RatioWidth = OldWidth / TrackWidth;
        double OldHeight = axMapControl1.ActiveView.Extent.YMax - 
                                           axMapControl1.ActiveView.Extent.YMin;
        double TrackHeight = pEnv.YMax - pEnv.YMin;
        double RatioHeight = OldHeight / TrackHeight;

        ESRI.ArcGIS.Geometry.IEnvelope pNewEnv = new 
                           ESRI.ArcGIS.Geometry.EnvelopeClass();
    
        pNewEnv.XMin = axMapControl1.ActiveView.Extent.XMin 
                                                 - (RatioWidth - 1.0) * OldWidth;
        pNewEnv.XMax = axMapControl1.ActiveView.Extent.XMax 
                                                 + (RatioWidth - 1.0) * OldWidth;
        pNewEnv.YMin = axMapControl1.ActiveView.Extent.YMin 
                                                 - (RatioHeight - 1.0) * OldHeight;
        pNewEnv.YMax = axMapControl1.ActiveView.Extent.YMax 
                                                 + (RatioHeight - 1.0) * OldHeight;
     
        axMapControl1.ActiveView.Extent = pNewEnv;
        axMapControl1.ActiveView.Refresh();
    }

MapViewMode가 2인지를 비교하는 if 문이 새로운 코드입니다. 원리는 먼저 현재의 지도 화면 영역의 크기와 사용자가 마우스를 이용해 지정한 사각 영역의 크기의 비율을 이용하여 현재 지도 화면 영역에 이 크기의 비율을 반영해줍니다.

다음으로 지도 이동에 대한 기능에 대해 살펴 보겠습니다. 먼저 Pan 버튼의 클릭 이벤트의 코드는 아래와 같습니다.

private void button4_Click(object sender, EventArgs e)
{
    // 0: None
    // 1: Zoom In Mode
    // 2: Zoom Out Mode
    // 3: Pan
    MapViewMode = 3;
}

지도 화면의 이동 기능은 확대와 축소 기능처럼 단순히 마우스 다운 이벤트만 사용하는 것이 아닌 마우스 다운 이벤트와 마우스 이동 이벤트 그리고 마우스 업 이벤트를 모두 사용합니다. 먼저 마우스 다운 이벤트를 살펴보겠습니다.

private void axMapControl1_OnMouseDown(object sender, 
              AxESRI.ArcGIS.Controls.IMapControlEvents2_OnMouseDownEvent e)
{
    bMouseDown = true;
    DownPt.X = e.mapX;
    DownPt.Y = e.mapY;

    if (MapViewMode == 1) 
    {
        ...
    }
    else if(MapViewMode == 2) 
    {
        ...
    } 
    else if(MapViewMode == 3) 
    {
        ESRI.ArcGIS.Geometry.IPoint pPt = new ESRI.ArcGIS.Geometry.Point();
        pPt.X = e.mapX;
        pPt.Y = e.mapY;
        axMapControl1.ActiveView.ScreenDisplay.PanStart(pPt);
    }
}

먼저 앞서 정의한 클래스 맴버 변수 bMouseDown를 true로 설정하여 마우스 이동 이벤트에서 현재 마우스 버튼이 눌려진 상태임을 알 수 있게 하며 DownPt에 현재 마우스 버튼이 눌려진 위치를 지도 좌표로 저장합니다. 그리고 이동 기능에 대한 코드를 실행합니다. 다음으로 마우스 이동 이벤트는 아래와 같습니다.

private void axMapControl1_OnMouseMove(object sender, 
                  AxESRI.ArcGIS.Controls.IMapControlEvents2_OnMouseMoveEvent e)
{
    if(MapViewMode==3 && bMouseDown) 
    {
        ESRI.ArcGIS.Geometry.IPoint pPt = new ESRI.ArcGIS.Geometry.Point();
        pPt.X = e.mapX;
        pPt.Y = e.mapY;

        axMapControl1.ActiveView.ScreenDisplay.PanMoveTo(pPt);
    }
}

마우스 이동 이벤트는 마우스가 이동될때마다 항상 발생하는 이벤트이므로 지도 이동 상태를 잡아 내는 것이 중요합니다. 이 상태를 잡것이 바로 MapViewMode가 3인지와 현재 마우스 버튼이 눌려진 상태인지를 검사하는 것입니다. 이 조건에서만 해당되는 지도 이동 기능을 수행합니다. 다음으로 마우스 업 이벤트는 아래와 같습니다.

private void axMapControl1_OnMouseUp(object sender, 
                  AxESRI.ArcGIS.Controls.IMapControlEvents2_OnMouseUpEvent e)
{
    if (MapViewMode == 3 && bMouseDown)
    {
        ESRI.ArcGIS.Geometry.IEnvelope pEnv = 
                               axMapControl1.ActiveView.ScreenDisplay.PanStop();
        if(pEnv != null) 
        {
            axMapControl1.ActiveView.Extent = pEnv;
            axMapControl1.ActiveView.Refresh();
        }
    }

    bMouseDown = false;
}

Up 이벤트에서도 지도 이동 모드 인지를 검사하고 조건에 맞을때만 지도 이동 기능을 최종적으로 완료합니다. 이 상으로 지도 화면 조작에 대한 내용을 간단하게 정리해 보았습니다. 이 글에서 설명한 코드는 아래의 링크를 통해 다운로드 하시기 바랍니다.

ArcObjects_ZoomControl.zip