四叉树瓦片集合类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)创建一个瓦片下载指示纹理。