MapObjects地图填充符号库扩展

在地图制图学中，将所有的地图符号划分为三大类：点状符号、线状符号和面状符号。

各种GIS平台都有自己的符号库用于地物的表示。ESRI的ArcMap中就提供了非常丰富的地图符号库，在安装目录下的Bin/Styles目录中你会发现许多以.Style的文件，这些文件中存储的就是一些符号信息。另外安装目录下的Styles目录中有许多以.ServerStyle为扩展名的文件，这些也是ESRI提供符号库文件，不过这些是专门提供给ArcGis Engine使用的。关于.Style和.ServerStyle的信息访问www.esri.com可以获得更多的信息。通过这些符号库用户可以在ArcMap中制作出各式各样的专题地图。ArcMap中提供的符号信息非常丰富，基本满足了用户的需求，当然在不够用的情况下还可以自己增加符号库中的符号，甚至制作一套自己的符号库。

MapObjects是ESRI提供的一组供应用开发人员使用的制图与GIS功能组件。它由一个OLE控件和一系列可编程OLE对象组成。利用MapObjects, 开发人员可以在应用程序中添加制图和GIS功能。由于利用MapObjects组件开发出系统开销小，开发周期也相对短些，因此许多应用系统都采用它。ArcGIS Engine是ESRI ArcGIS 9系列中推出的高级地图应用组件，功能非常强大开发也非常容易，对于MapObjects和ArcGIS Engine ESRI的观点好象是更推荐使用ArcGIS Engine进行开发，不过ArcGIS Engine占系统资源多，普通配置的机器运行ArcGIS Engine开发出来的系统比较慢。

还是回到符号上来，MapObjects对点、线、面地理要素分别提供了相应的符号。

1、点符号：MapObjects提供了4个基本的点符号，不过可以通过TrueType字体对点符号进行扩充，如：Wingdings索引为81的符号就是一架小飞机了。可以用造字程序创建自己的TrueType字体符号库，Font Creator Program 是一个TrueType字体造字程序非常好用。另外还可以实现ICustomMarker进行扩充。不过使用TrueType字体比实现ICustomMarker的操作更为有效方便。

layer.Symbol.Color = (uint)MapObjects2.ColorConstants.moRed;
                            layer.Symbol.Size = 30;
                            //layer.Symbol.Style = 1;

                            stdole.StdFont font = new stdole.StdFont();
                            font.Name = "test1";
                            layer.Symbol.Font = font;
                            layer.Symbol.Style = (short)MapObjects2.MarkerStyleConstants.moTrueTypeMarker;
                            layer.Symbol.Color = (uint)MapObjects2.ColorConstants.moRed;
                            layer.Symbol.CharacterIndex = 34;

2、线符号：MapObjects只提供5个基本的线符号，需要更多的线型只能自己通过实现ICustomLine接口来扩充。

3、面符号：MapObjects中包含11中填充的符号。与点、线符号类似可以通过实现ICustomFill进行扩充。

下面主要讨论Dotnet C# 实现MapObjects面符号的扩充。我们知道WIN API提供了位图画刷，且画刷可以支持彩色相关位图及设备不相关位图。因此我们可以通过位图BITMAP构建画刷进行面区域的填充，如果完全通过底层的WIN API从图片创建BITMAP位图填充的画刷，对于API不太了解的人来说感觉很麻烦。不过还好通过Dotnet框架只需要几个API就可以搞定了，而且还可以很好的对这些符号进行组织，如：增加、删除、编辑、存档等。

下面是需要用到的WINAPI函数：

 #region 调用Windows API 的GDI函数
[DllImport("gdi32.dll", EntryPoint="PolyPolygon")]
public static extern int PolyPolygon (
 int hdc,
 ref int lpPoint,
 ref int lpPolyCounts,
 int nCount
 );//绘制多边形
[DllImport("gdi32.dll", EntryPoint="CreatePen")]
public static extern int CreatePen (
 int nPenStyle,
 int nWidth,
 int crColor
 );//创建画笔
[DllImport("gdi32.dll", EntryPoint="SelectObject")]
public static extern int SelectObject (
 int hdc,
 int hObject
 ); //将对象[画笔、画刷、位图等]选入指定的设备描述表
[DllImport("gdi32.dll", EntryPoint="DeleteObject")]
public static extern int DeleteObject (
 int hObject
 );//删除对象 释放资源
[DllImport("gdi32.dll", EntryPoint="CreatePatternBrush")]
public static extern int CreatePatternBrush (
 int hBitmap
 );//通过位图创建画刷
#endregion

为了更好的组织符号信息以及利于复用，可以编写两个可以序列化[Serializable]的类：填充符号：PatternStyle和符号集：StyleContainer

PatternStyle：描述符号的基本信息：符号内容即图象[Image]、符号名称[PatternName]、符号描述[PatternDescription]。

StyleContainer：是一系列PatternStyle的集合，并包含一些增、删、修改PatternStyle的方法以及保存和打开二进字填充样式文件[*.pattern]的静态方法。标明[Serializable]的类在Dotnet中可以方便的进行序列化存储为本地的文件。标明[Serializable]的类的存取：

/// <summary>
/// 读去填充样式文件
/// </summary>
/// <param name="filename">样式文件路径</param>
public static StyleContainer LoadStyles(string filename)
{
 try
 {
  Stream StreamRead = File.OpenRead(filename);
  BinaryFormatter BinaryRead = new BinaryFormatter();
  StyleContainer StyleContainerObj =  BinaryRead.Deserialize(StreamRead) as StyleContainer;
  StreamRead.Close();
  return StyleContainerObj;
 }
 catch
 {
  return null;
 }
}
/// <summary>
/// 保存填充样式文件
/// </summary>
/// <param name="styles">StyleContainer对象</param>
/// <param name="filename">存储文件名</param>
public static void SaveStyles(StyleContainer styles,string filename)
{   
 Stream StreamWrite = File.Create(filename);
 BinaryFormatter BinaryWrite = new BinaryFormatter();
 BinaryWrite.Serialize(StreamWrite,styles);
 StreamWrite.Close();
} 

实现ICustomFill接口，主要实现SetupDC、ResetDC和Draw三个函数。

private int g_hOldPen;
private int g_hPen;
private int g_hOldBrush;
private int g_hBrush;
private PatternStyle m_PatternStyle; 
#region ICustomFill 成员
public void ResetDC(int hDC)
{
 // TODO:  添加 Polygons.ResetDC 实现
 //释放资源
 if(this.g_hPen != 0)
 {
  SelectObject(hDC,g_hOldPen);
  DeleteObject(g_hPen);    
 }
 if(this.g_hOldBrush != 0)
 {
  SelectObject(hDC,g_hOldBrush);
  DeleteObject(g_hBrush);
 }
}
public void SetupDC(int hDC, double dpi, object pBaseSym)
{
 // TODO:  添加 Polygons.SetupDC 实现
 //边界样式
 ESRI.MapObjects2.Core.Symbol sym = pBaseSym as ESRI.MapObjects2.Core.Symbol;
 g_hPen = CreatePen(sym.Style,sym.Size,(int)sym.Color);   
 //通过GDI+和API从Bitmap创建画刷
 System.Drawing.Bitmap bmp =( System.Drawing.Bitmap)this.m_PatternStyle.Image;    
 int ibmp = bmp.GetHbitmap().ToInt32();
 g_hBrush = CreatePatternBrush(ibmp);
 DeleteObject(ibmp);
}
public void Draw(int hDC, ref int points, ref int partCounts, int numParts)
{
 // TODO:  添加 Polygons.Draw 实现   
 //将画笔、画刷选入当前的设备描述表
 this.g_hOldPen  = SelectObject(hDC, g_hPen);
 this.g_hOldBrush = SelectObject(hDC,g_hBrush);
 //绘制多边形
 PolyPolygon(hDC,ref points,ref partCounts,numParts);
}
#endregion

应用示例：

图一、单一符号填充效果

图二、独立值填充效果