水经注离线影像地图读取控件的二次开发教程

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控件中，其详细代码如下：

public class TileLoader

{

enum LayerType

{

TILE_LAYER = 0,

ROAD_LAYER,

DEM_LAYER

}

[DllImport("DatFileReader.dll",EntryPoint = "GetTile",CallingConvention = CallingConvention.Cdecl)]

private static extern ErrorCodeGetTile(int id, byte[]data, ref intlength, int level, introw, int col);

[DllImport("DatFileReader.dll",EntryPoint = "GetRoad",CallingConvention = CallingConvention.Cdecl)]

private static extern ErrorCodeGetRoad(int id, byte[]data, ref intlength, int level, introw, int col);

[DllImport("DatFileReader.dll",EntryPoint = "SetDataSource",CallingConvention = CallingConvention.Cdecl)]

private static extern ErrorCodeSetDataSource(int layerType, string path, ref int id);

enum ErrorCode

{

NO_ERROR = 0,//无错误

NOT_MATCH_RANGE = 1,//没在数据中找到相交的范围

DIR_NOT_EXIST = 2,//目录不存在

NO_DATA_AND_INDEX = 3,//没有dat根idx文件

L_OR_B_ERROR = 4,//经纬度错误

OUT_OF_MEMORY,//内存溢出

ANGE_ERROR//范围错误

}

static TileLoader()

{

int id1 = 0;

try

{

ErrorCode ec = SetDataSource(0, "dat/tile", refid1);

ec = SetDataSource(1, "dat/label",ref id1);

}

catch (System.Exceptionex)

{

MessageBox.Show((ex.ToString()));

}

public static byte[] getTile(int id,int level, introw, int col)

{

byte[] tmp = new byte[1024 * 1024];

int length = 1024 * 1024;

ErrorCode ec = GetTile(id, tmp, ref length, level, row, col);

if (ec == ErrorCode.NO_ERROR&& length > 0)

{

byte[] data = newbyte[length];

Buffer.BlockCopy(tmp, 0, data, 0,length);

tmp = null;

return data;

}

return null;

}

public static byte[] getLabel(intid, int level, introw, int col)

{

byte[] tmp = new byte[1024 * 1024];

int length = 1024 * 1024;

ErrorCode ec = GetRoad(id, tmp, ref length, level, row, col);

if (ec == ErrorCode.NO_ERROR&& length > 0)

{

byte[] data = newbyte[length];

Buffer.BlockCopy(tmp, 0, data, 0,length);

tmp = null;

return data;

}

return null;

}

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

class LabelLayer : TiledMapServiceLayer

{

private const double halfCircle = 20037508.342787;

public override void Initialize()

{

TileInfo = new TileInfo();

TileInfo.Width = 256;

TileInfo.Height = 256;

TileInfo.Origin = new MapPoint(-halfCircle, halfCircle);

TileInfo.SpatialReference = new SpatialReference(102113);//102100

TileInfo.Lods = new Lod[19];

double resolution = halfCircle * 2 / 256;

base.MaximumResolution = resolution;

for (int i = 0; i< TileInfo.Lods.Count(); i++)

{

TileInfo.Lods = new Lod();

TileInfo.Lods.Resolution = resolution;

resolution /= 2.0;

}

base.MinimumResolution = resolution * 2.0;

base.SpatialReference = newSpatialReference(102113);

base.FullExtent = newEnvelope(-halfCircle, -halfCircle,halfCircle, halfCircle);

base.Initialize();

}

public override string GetTileUrl(intlevel, int row, intcol)

{

return string.Empty;

}

protected override void GetTileSource(intlevel, int row, intcol, Action<System.Windows.Media.ImageSource> onComplete)

{

byte[] data = TileLoader.getLabel(0,level + 1, row + 1, col + 1);

if (data != null)

{

MemoryStream mstream = new MemoryStream(data);//File.ReadAllBytes(path)

System.Windows.Media.ImageSourceConvertercconv = new System.Windows.Media.ImageSourceConverter();

ImageSource source =cconv.ConvertFrom(mstream) as ImageSource;

onComplete(source);

}

实际影像的读取方法是：

class MapLayer : TiledMapServiceLayer

{