WorldWind源码剖析系列：四叉树瓦片集合类QuadTileSet

四叉树瓦片集合类QuadTileSet是影像瓦片渲染的主要类。使用地形管理器来为3D地形渲染查询高程值。依赖于用来刷新基于经度、纬度、视角范围瓦片的更新线程。该类继承自可渲染对象类RenderableObject。该类的类图如下。

四叉树瓦片集合类QuadTileSet提供的主要字段、属性和方法简要描述如下：

bool m_RenderStruts = true;//渲染标记层

protected string m_ServerLogoFilePath; //服务器Logo文件路径

protected Image m_ServerLogoImage; //服务器Logo影像

protected Hashtable m_topmostTiles = new Hashtable();//最上层瓦片哈希表，其中，key= ((long)curRow << 32) + curCol，value= QuadTile对象。

protected double m_north; //瓦片集合北边界，单位：角度

protected double m_south; //瓦片集合南边界

protected double m_west; //瓦片集合西边界

protected double m_east; //瓦片集合东边界

bool renderFileNames = false; //渲染的文件名称

protected Texture m_iconTexture; //icon格式的纹理

protected Sprite sprite; //渲染精灵，详情请参阅Direct3D相关内容

protected Rectangle m_spriteSize; //渲染精灵的尺寸

protected ProgressBar progressBar; //进度条

protected Blend m_sourceBlend = Blend.BlendFactor; //源影像混合方式

protected Blend m_destinationBlend=Blend.InvBlendFactor;//目的影像混合方式。多层文理混合时需要指定这两个参数，详情请参阅Direct3D相关内容。

protected static long lastRenderTime;//最后的渲染时间。如果该值等于CurrentFrameStartTicks，则需要清除Z-buffer缓冲区。

//public static int MaxConcurrentDownloads = 3;

protected double m_layerRadius;//图层半径，等于星球半径+瓦片高于地表的距离

protected bool m_alwaysRenderBaseTiles;//一直需要渲染的基本瓦片

protected float m_tileDrawSpread; //瓦片绘制范围

protected float m_tileDrawDistance; //瓦片绘制距离

protected bool m_isDownloadingElevation; //是否是正在下载的高程数据

protected int m_numberRetries; //重试次数

protected Hashtable m_downloadRequests = new Hashtable();//下载请求，其中，key= QuadTile对象，value= GeoSpatialDownloadRequest对象。

protected int m_maxQueueSize = 400; //下载队列最大数目

protected bool m_terrainMapped; //是否启用地形映射

protected ImageStore[] m_imageStores; / /存储影像数组

protected Camera.CameraBase m_camera;//与四叉树瓦片集合关联的相机

protected GeoSpatialDownloadRequest[] m_activeDownloads = new GeoSpatialDownloadRequest[20]; //活动的下载请求数组

protected DateTime[] m_downloadStarted = new DateTime[20];//下载开始时间

protected TimeSpan m_connectionWaitTime = TimeSpan.FromMinutes(2);//连接等待时间间隔

protected DateTime m_connectionWaitStart; //连接等待的开始时刻

protected bool m_isConnectionWaiting; //是否正处于连接等待中

protected bool m_enableColorKeying; //是否启用颜色？？不太懂

protected Effect m_effect = null; //Direct3D的效果

protected string m_effectPath = null;//效果路径

protected string m_effectTechnique = null;//效果技术参数

static protected EffectPool m_effectPool = new EffectPool();//D3D的效果缓存池

protected TimeSpan m_cacheExpirationTime = TimeSpan.MaxValue;//瓦片集合下载缓冲区过期时间间隔

public static Texture DownloadInProgressTexture;//正在下载中的影像纹理

public static Texture DownloadQueuedTexture; //排在下载队列中的纹理

public static Texture DownloadTerrainTexture; //正在下载的地形纹理

public int ColorKey; // default: 100% transparent black = transparent

public int ColorKeyMax;//使用ColorKey设置的最暗的透明颜色值

bool m_renderGrayscale = false;//渲染时的灰度尺度

float m_grayscaleBrightness = 0.0f;// 灰度尺度的亮度

构造函数public QuadTileSet(string name,World parentWorld,double distanceAboveSurface,double north,double south,double west,double east,bool terrainMapped,ImageStore[] imageStores)根据指定的瓦片名称、从属的星球、瓦片高于地表的距离、瓦片集合北边界、南边界、西边界、东边界、是否进行地形映射、影像存储数组等参数实例化一个四叉树瓦片集合对象。

public override void Update(DrawArgs drawArgs)方法根据具体的绘制参数更新渲染场景的地形和影像瓦片数据，内部调用QuadTile.Update(drawArgs)函数。

public override void Render(DrawArgs drawArgs) 方法根据具体的绘制参数完成场景的渲染和绘制功能，内部调用QuadTile. Render (drawArgs)函数。其中，设计到纹理渲染阶段问题，详情请参阅Direct3D相关内容。

protected void RemoveInvisibleTiles(CameraBase camera)根据相机参数camera移除不可见的瓦片

public void ClearDownloadRequests()方法清空下载请求

public void RenderDownloadProgress(DrawArgs drawArgs, GeoSpatialDownloadRequest request, int offset)渲染下载进度

public virtual void ResetCacheForCurrentView(WorldWind.Camera.CameraBase camera)为当前视图重置缓冲区，内部调用QuadTile.ResetCache()函数。

public virtual void AddToDownloadQueue(CameraBase camera, GeoSpatialDownloadRequest newRequest)把下载请求newRequest添加到下载队列中。

public virtual void RemoveFromDownloadQueue(GeoSpatialDownloadRequest removeRequest)从下载对列中移除下载请求。

public virtual void ServiceDownloadQueue()当下载线程可用时开始启动下载任务。内部调用了非抽象类WorldWind.Renderable. GeoSpatialDownloadRequest.StartDownload()函数，以及非抽象类WorldWind.Net.WebDownload。注意区分WorldWind.Net. GeoSpatialDownloadRequest抽象类。

public virtual GeoSpatialDownloadRequest GetClosestDownloadRequest()从下载请求队列中寻找最好的下载请求并返回。

static protected Texture CreateDownloadRectangle(Device device, Color color, int padding)创建一个瓦片下载指示纹理。