WorldWind源码剖析系列：影像图层类ImageLayer

影像图层类ImageLayer

影像图层类ImageLayer将单张影像作为纹理映射到星球表面上去。源影像必须是平面笛卡尔坐标系。该类的类图如下。

影像图层类ImageLayer提供的主要字段、属性和方法简要描述如下：

protected double layerRadius;//图层半径，实际是添加影像纹理的星球半径

protected double minLat; //图层的最小纬度

protected double maxLat; //图层的最大纬度

protected double minLon; //图层的最小经度

protected double maxLon;//图层的最大经度

World m_ParentWorld;//图层所从属的星球对象

Stream m_TextureStream = null;//图层所包含的纹理数据流

protected bool _disableZbuffer;//是否对影像纹理图层启用Zbuffer缓冲

protected CustomVertex.PositionNormalTextured[] vertices;//将影像映射成纹理时所对应的含法线、纹理的位置坐标

protected static CustomVertex.TransformedColored[] progressBarOutline = new CustomVertex.TransformedColored[5];

protected static CustomVertex.TransformedColored[] progressBar = new CustomVertex.TransformedColored[4];

protected short[] indices;//使用索引缓存，减少内存使用并加速渲染

protected Texture texture;//从影像创建的纹理对象

protected Device device;//渲染纹理的设备

protected string _imageUrl; //纹理影像的URL字符串

protected string _imagePath; //纹理影像的路径

protected int meshPointCount = 64;//将纹理影像剖分的三角形格网点密度

protected TerrainAccessor _terrainAccessor;//影像纹理的地形访问器

protected int progressBarBackColor = System.Drawing.Color.FromArgb(100, 255, 255, 255).ToArgb();//进度条的背景颜色

protected int progressBarOutlineColor = System.Drawing.Color.SlateGray.ToArgb();//进度条的外轮廓颜色

protected int textColor = System.Drawing.Color.Black.ToArgb();

protected float downloadPercent;//下载文理影像完成的百分比

protected Thread downloadThread;//下载文理影像的线程

protected float verticalExaggeration;//纹理的竖直放大率

protected string m_legendImagePath;//图例影像路径

protected Colorbar legendControl; //颜色条图例控件窗体

int m_TransparentColor = 0;//透明区域的颜色

bool m_renderGrayscale = false;//是否灰度渲染

TimeSpan cacheExpiration = TimeSpan.MaxValue;缓冲区过期时间段

System.Timers.Timer refreshTimer = null;//刷新定时器

float m_grayscaleBrightness = 0.0f;//灰度尺度的透明度

static Effect grayscaleEffect = null;//启用效果对象

public override void Initialize(DrawArgs drawArgs)：重载父类方法，根据URL创建下载线程、创建格网等。

public override void Update(DrawArgs drawArgs) ：重载父类方法，根据绘制参数更新状态。

public override void Render(DrawArgs drawArgs) ：重载父类方法，根据绘制参数完成影像图层的渲染。

protected virtual void CreateMesh()：创建了Device最终渲染三角面格网所需要的点集合，即 protected CustomVertex.PositionNormalTextured[] vertices，并为构成三角形格网的每一个顶点指定顶点索引即protected short[] indices。同时使用顶点缓存和索引缓存，可以减少内存使用并加速渲染。

protected void DownloadImage()：下载线程所绑定的处理函数，内部构造网络下载WebDownload对象来发起网络下载，并为该对象的“正在下载中事件”指定处理函数，以便在进度条中显示下载百分比。其中，当_imagePath为空时，将下载的文件放到内存中，然后ImageHelper类从流对象加载转变为纹理对象；当_imagePath不为空时，将加载的文件保存到——imagePath中，然后加载更新纹理；最后再调用CreateMesh()创建Mesh。

private static string getFilePathFromUrl(string url)：从URL字符串中获取文件路径。

private void calculate_normals(ref CustomVertex.PositionNormalTextured[] vertices, short[] indices)：计算格网顶点的法线，在光照状态下要用到法线。