航拍影像地图读取控件的二次开发教程

@芋头

1.说明
9月1日，水经注官网发布了离线影像缓存包读取控件，顾名思义，利用水经注地图下载器下载的.dat缓存文件，可以直接被该控件读取。这对于广大航测应用开发的工作者来说，无疑是个很方便的控件。笔者决定亲自尝试下该控件加载超大离线地图的快感。
源码下载地址：http://www.rivermap.cn/download/DatFileReader.rar
该DEMO下载之后包含三个文件夹，水经注离线影像地图缓存包读取控件，水经注离线影像地图缓存包读取控件_调用示例，水经注离线影像地图缓存包读取控件_调用示例源码。开发者需要的只是第一个：水经注离线影像地图缓存包读取控件。

2．离线地图读取实现
既然要读取离线地图，我们得先下载。再在开发平台中搭建好框架，利用离线地图读取控件，来调用我们的离线地图。


    2.1下载离线地图包
    启动水经注万能地图下载器X2，这里我们下载成都1-15级的影像地图。

设置下载的级数为1-15级，勾选卫星地图和标签。请记录下新建任务时的最小坐标和最大坐标，有什么用后面再详细说明。

然后等待下载完成。在等待的时候我们是不是该做点什么？对了，刚刚不是记录了两个点吗，我们在进行地图开发的时候常常用到web墨卡托的坐标，这里我们演示一下，怎么得到这两个点的墨卡托坐标，来作为加载离线地图的开始范围。
用excel保存刚刚得到的最小坐标和最大坐标，如下：

启动arcmap，按照顺序分别点击【文件】-【添加数据】-【添加xy数据】，在弹出的对话框中选择我们保存的excel，x字段选择x，y字段选择y，编辑投影左边为web墨卡托投影，如下：

确定之后，我们就把两个点添加到了地图中，把他们转成shp文件之后，添加两个字段xM,yM,然后利用几何计算分别算出这两个点的墨卡托坐标，如下：

    2.2 离线地图读取
    在看了水经注官网的DEMO实例源码之后，可以知道，该控件的原理很简单，利用读取控件将离线影像中的图片向外推出，再用地图显示控件显示出来。在这里，笔者使用的是ARCGIS_RUNTIME_SDK_forWPF开发包，并使用其map控件来显示离线影像。
启动vs2010，【文件】-【新建】-【WPF应用程序】，根据自己需要改变window的风格。在开始编写代码之前，我们将下载的离线地图缓存包读取控件和离线的.dat、.idx一并拷贝到解决方案的bin/Debug目录下：

向window控件中加入map控件，删除map的默认显示地图源，设置map的显示风格为stretch最大，这里我们将控件取名为Bmap：

在MainWindow.xaml.cs中写入我们的map加载事件，并在这里将我们刚刚下载的地图的墨卡托坐标范围作为map的显示范围。

为解决方案添加三个类，取名为TileLoader.cs、LabelLayer.cs、MapLayer.cs.

TileLoader.cs里面我们定义.dat的读取方法，在Debug根目录里面调用下载的.dat读取控件DatFileReader.dll，并通过LabelLayer.cs、MapLayer.cs这两个类中方法将图片显示到map控件中，其详细代码如下：

1. public class TileLoader
   
2.     {
   
3.         enum LayerType
   
4.         {
   
5.            TILE_LAYER = 0,
   
6.            ROAD_LAYER,
   
7.            DEM_LAYER
   
8.         }
   
9. 
   
10.         [DllImport("DatFileReader.dll",EntryPoint = "GetTile",CallingConvention = CallingConvention.Cdecl)]
    
11.         private static extern ErrorCodeGetTile(int id, byte[]data, ref intlength, int level, introw, int col);
    
12. 
    
13.         [DllImport("DatFileReader.dll",EntryPoint = "GetRoad",CallingConvention = CallingConvention.Cdecl)]
    
14.         private static extern ErrorCodeGetRoad(int id, byte[]data, ref intlength, int level, introw, int col);
    
15. 
    
16.         [DllImport("DatFileReader.dll",EntryPoint = "SetDataSource",CallingConvention = CallingConvention.Cdecl)]
    
17.         private static extern ErrorCodeSetDataSource(int layerType, string path, ref int id);
    
18. 
    
19.         enum ErrorCode
    
20.         {
    
21.            NO_ERROR = 0,//无错误
    
22.            NOT_MATCH_RANGE = 1,//没在数据中找到相交的范围
    
23.            DIR_NOT_EXIST = 2,//目录不存在
    
24.            NO_DATA_AND_INDEX = 3,//没有dat根idx文件
    
25.            L_OR_B_ERROR = 4,//经纬度错误
    
26.            OUT_OF_MEMORY,//内存溢出
    
27.            ANGE_ERROR//范围错误
    
28.         }
    
29. 
    
30.         static TileLoader()
    
31.         {
    
32.             int id1 = 0;
    
33. 
    
34.             try
    
35.             {
    
36.                ErrorCode ec = SetDataSource(0, "dat/tile", refid1);
    
37.                ec = SetDataSource(1, "dat/label",ref id1);
    
38.             }
    
39.             catch (System.Exceptionex)
    
40.             {
    
41.                MessageBox.Show((ex.ToString()));
    
42.             }
    
43.         }
    
44. 
    
45.         public static byte[] getTile(int id,int level, introw, int col)
    
46.         {
    
47.             byte[] tmp = new byte[1024 * 1024];
    
48. 
    
49.             int length = 1024 * 1024;
    
50. 
    
51.             ErrorCode ec = GetTile(id, tmp, ref length, level, row, col);
    
52. 
    
53.             if (ec == ErrorCode.NO_ERROR&& length > 0)
    
54.             {
    
55.                byte[] data = newbyte[length];
    
56.                Buffer.BlockCopy(tmp, 0, data, 0,length);
    
57.                tmp = null;
    
58.                return data;
    
59.             }
    
60. 
    
61.             return null;
    
62.         }
    
63. 
    
64.         public static byte[] getLabel(intid, int level, introw, int col)
    
65.         {
    
66.             byte[] tmp = new byte[1024 * 1024];
    
67. 
    
68.             int length = 1024 * 1024;
    
69. 
    
70.             ErrorCode ec = GetRoad(id, tmp, ref length, level, row, col);
    
71. 
    
72.             if (ec == ErrorCode.NO_ERROR&& length > 0)
    
73.             {
    
74.                byte[] data = newbyte[length];
    
75.                Buffer.BlockCopy(tmp, 0, data, 0,length);
    
76.                tmp = null;
    
77.                return data;
    
78.             }
    
79. 
    
80.             return null;
    
81.         }
    
82. 
    
83. 
    
84.     }

复制代码

LabelLayer.cs、MapLayer.cs这两个类，分别用来读取离线影像的标签和实际影像文件。标签的具体读取方法是：

1. class LabelLayer : TiledMapServiceLayer
   
2.     {
   
3.         private const double halfCircle = 20037508.342787;
   
4. 
   
5.         public override void Initialize()
   
6.         {
   
7.            TileInfo = new TileInfo();
   
8.            TileInfo.Width = 256;
   
9.            TileInfo.Height = 256;
   
10.            TileInfo.Origin = new MapPoint(-halfCircle, halfCircle);
    
11.            TileInfo.SpatialReference = new SpatialReference(102113);//102100
    
12. 
    
13.            TileInfo.Lods = new Lod[19];
    
14. 
    
15.             double resolution = halfCircle * 2 / 256;
    
16. 
    
17.             base.MaximumResolution = resolution;
    
18. 
    
19.             for (int i = 0; i< TileInfo.Lods.Count(); i++)
    
20.             {
    
21.                TileInfo.Lods = new Lod();
    
22.                TileInfo.Lods.Resolution = resolution;
    
23.                resolution /= 2.0;
    
24.             }
    
25.             base.MinimumResolution = resolution * 2.0;
    
26.             base.SpatialReference = newSpatialReference(102113);
    
27.             base.FullExtent = newEnvelope(-halfCircle, -halfCircle,halfCircle, halfCircle);
    
28.             base.Initialize();
    
29.         }
    
30.         public override string GetTileUrl(intlevel, int row, intcol)
    
31.         {
    
32.             return string.Empty;
    
33.         }
    
34.         protected override void GetTileSource(intlevel, int row, intcol, Action<System.Windows.Media.ImageSource> onComplete)
    
35.         {
    
36.             byte[] data = TileLoader.getLabel(0,level + 1, row + 1, col + 1);
    
37.             if (data != null)
    
38.             {
    
39.                MemoryStream mstream = new MemoryStream(data);//File.ReadAllBytes(path)
    
40.                System.Windows.Media.ImageSourceConvertercconv = new System.Windows.Media.ImageSourceConverter();
    
41.                ImageSource source =cconv.ConvertFrom(mstream) as ImageSource;
    
42.                onComplete(source);
    
43.             }
    
44.         }
    
45. }

复制代码

实际影像的读取方法是：

1. class MapLayer : TiledMapServiceLayer
   
2.     {
   
3.         private const double halfCircle = 20037508.342787;
   
4.         public override void Initialize()
   
5.         {
   
6.            TileInfo = new TileInfo();
   
7.            TileInfo.Width = 256;
   
8.            TileInfo.Height = 256;
   
9.            TileInfo.Origin = new MapPoint(-halfCircle, halfCircle);
   
10.            TileInfo.SpatialReference = new SpatialReference(102113);//102100
    
11.            TileInfo.Lods = new Lod[19];
    
12.             double resolution = halfCircle * 2 / 256;
    
13.             base.MaximumResolution = resolution;
    
14.             for (int i = 0; i< TileInfo.Lods.Count(); i++)
    
15.             {
    
16.                TileInfo.Lods = new Lod();
    
17.                TileInfo.Lods.Resolution = resolution;
    
18.                resolution /= 2.0;
    
19.             }
    
20. 
    
21.             base.MinimumResolution = resolution * 2.0;
    
22.             base.SpatialReference = newSpatialReference(102113);
    
23.             base.FullExtent = newEnvelope(-halfCircle, -halfCircle,halfCircle, halfCircle);
    
24.             base.Initialize();
    
25.         }
    
26. 
    
27.         public override string GetTileUrl(intlevel, int row, intcol)
    
28.         {
    
29.             return string.Empty;
    
30.         }
    
31. 
    
32.         protected override void GetTileSource(intlevel, int row, intcol, Action<System.Windows.Media.ImageSource> onComplete)
    
33.         {
    
34.             byte[] data = TileLoader.getTile(0,level + 1, row + 1, col + 1);
    
35. 
    
36.             if (data != null)
    
37.             {
    
38.                MemoryStream mstream = new MemoryStream(data);//File.ReadAllBytes(path)
    
39.                System.Windows.Media.ImageSourceConvertercconv = new System.Windows.Media.ImageSourceConverter();
    
40.                ImageSource source =cconv.ConvertFrom(mstream) as ImageSource;
    
41.                onComplete(source);
    
42.             }
    
43.         }
    
44.     }
    
45. 
    

复制代码

到这里，代码编写工作基本完成，我们来编译运行一下：

    2.3 总结
    成都1-15级的离线影像通过离线缓存包读取控件可以轻松的显示在前端，并且能流畅地放缩自如，相比在线地图，完全不用担心网速原因带来的卡顿。相信水经注离线地图缓存包读取控件会给地图开发者在今后的工作带来很大方便！

tjcdq

直接跳过。