Global Mapper SDK 19 中文开发文档（十）

7.2.23 GM_LidarQuery_t 

（1）声明

public class GM_LidarQuery_t : IDisposable

（2）方法

方法	描述
AddLidarQuery	将一个Lidar查询添加到另一个Lidar查询中。
AddLidarQueryToQuery	将一个Lidar查询添加到另一个Lidar查询中。
AddRemovePoint	从图层中的给定索引位置添加或删除一个Lidar点要素。
AddRemovePointToLidarQuery	从图层中的给定索引位置添加或删除一个Lidar点要素。
CreateEmptyLidarQuery	创建一个空的Lidar查询，之后可以在其中添加点。
CreateLidarQuery	从某些图层中获取特定边界框内的所有Lidar点的查询。
Dispose	和Close函数执行相同的操作。
FreeLidarQuery	释放指定Lidar查询使用的资源。
GetLidarQueryInfo(GM_LidarQueryInfo_t)	获取Lidar查询的信息。
GetLidarQueryInfo(IntPtr, GM_LidarQueryInfo_t)	获取Lidar查询的信息。
GetNextLidarQueryPoints	从Lidar查询中检索下一批点（返回的列表长度可能小于指定的列表大小）。
InitLidarQueryFilter	将Lidar查询筛选器初始化为返回所有点。在设置特定查询成员之前调用此函数。
UpdateLidarQueryPoints	更改查询中点的指定字段的数据。
UpdatePoints	更改查询中点的指定字段的数据。

AddLidarQuery

public GM_Error_t32 AddLidarQuery(
	GM_LidarQuery_t aAddFromLidarQuery,    //Lidar query to add points from
	Object aReserved                       //Reserved for future use, must be NULL
)

AddLidarQueryToQuery

public static GM_Error_t32 AddLidarQueryToQuery(
	GM_LidarQuery_t aAddToLidarQuery,    //Lidar query to update
	GM_LidarQuery_t aAddFromLidarQuery,  //Lidar query to add points from
	Object aReserved                     //Reserved for future use, must be NULL
)

AddRemovePoint

public GM_Error_t32 AddRemovePoint(
	GM_Layer_t aLayer,    //Layer of point to add/remove
	ulong aPointIndex,    //Index of Lidar point feature to update
	bool aAddPoint        //Add or remove point
)

AddRemovePointToLidarQuery

public static GM_Error_t32 AddRemovePointToLidarQuery(
	GM_LidarQuery_t aLidarQuery,    //Lidar query to update
	GM_Layer_t aLayer,              //Layer of point to add/remove
	ulong aPointIndex,              //Index of Lidar point feature to update
	bool aAddPoint                  //Add or remove point
)

CreateEmptyLidarQuery

public static GM_Error_t32 CreateEmptyLidarQuery(
	out GM_LidarQuery_t aLidarQuery    //Created Lidar query to be used in future calls
)

CreateLidarQuery

public static GM_Error_t32 CreateLidarQuery(
	GM_LayerList_t aLayerList,        //List of layers to search or NULL for all vector layers
	GM_Rectangle_t aWorldBounds,      //World bounds for search space or NULL for last drawn
	GM_LidarQueryFilter_t aFilter,    //Optional filter to apply to query (NULL if no extra filter)
	out GM_LidarQuery_t aLidarQuery,  //Created Lidar query to be used in future calls
	out ulong aQueryPoints            //Number of points matching query
)

Dispose

public void Dispose()

FreeLidarQuery

public GM_Error_t32 FreeLidarQuery()

GetLidarQueryInfo

public GM_Error_t32 GetLidarQueryInfo(
	out GM_LidarQueryInfo_t aQueryInfo    //Information about query
)

public static GM_Error_t32 GetLidarQueryInfo(
	IntPtr aLidarQuery,                    //Lidar query to query
	out GM_LidarQueryInfo_t aQueryInfo     //Information about query
)

GetNextLidarQueryPoints

public GM_LidarPoint_t[] GetNextLidarQueryPoints(
	uint aListSize,                //Max number of points to fetch
	GM_GetFeatureFlags_t32 aFlags, //Flags for fetching Lidar point
	Object aReserved = null        //Reserved for future use, must be NULL
)

InitLidarQueryFilter

public static GM_Error_t32 InitLidarQueryFilter(
	out GM_LidarQueryFilter_t aFilter,    //The Filter to initialize
	bool aEmptyClassFilter                //should the class filter have all types disabled to start
)

UpdateLidarQueryPoints

public static GM_Error_t32 UpdateLidarQueryPoints(
	GM_LidarQuery_t aLidarQuery,        //Lidar query to update points in
	GM_LidarFieldMask_t32 aValidFields, //Which fields of data are valid to be updated
	GM_LidarPoint_t aNewPointData,      //Lidar point to update
	Object aReserved                    //Reserved for future use, must be NULL
)

UpdatePoints

public GM_Error_t32 UpdatePoints(
	GM_LidarFieldMask_t32 aValidFields,    //Which fields of data are valid to be updated
	GM_LidarPoint_t aNewPointData,         //Lidar point to update
	Object aReserved                       //Reserved for future use, must be NULL
)

7.2.24 GM_LidarQueryFilter_t

（1）声明

public class GM_LidarQueryFilter_t

（2）构造函数

public GM_LidarQueryFilter_t()

（3）方法

方法	描述
IsClassEnabled	如果在Lidar类别过滤器中启用了给定的类别，则返回true。
SetClassEnabled	在Lidar类别过滤器中设置一个类别的启用或禁用状态。

IsClassEnabled

public bool IsClassEnabled(
	GM_LidarClass_t8 aClass    //Class to check
)

SetClassEnabled 

public GM_Error_t32 SetClassEnabled(
	GM_LidarClass_t8 aClass,    //Class to enable/disable
	bool aEnable                //Enable the class
)

7.2.25 GM_LidarQueryInfo_t

（1）声明

public class GM_LidarQueryInfo_t

（2）字段

字段	描述
mLayerList	查询中有点的图层列表。
mNumPoints	查询中的点的总数。

7.2.26 GM_LidarStats_t 

（1）声明

public class GM_LidarStats_t

（2）属性

属性	描述
mAttrStats	按属性统计。
mClassStats	按类别统计。
mReturnStats	按返回类型统计。

（3）字段 

字段	描述
mAllPointsStats	所有数据的统计信息。
mAvgElev	高程值的平均值。
mAvgIntensity	强度值的平均值。
mStdDevElev	高程值的标准差。
mStdDevIntensity	强度值的标准差。

7.2.27 GM_LineFeature_t 

（1）声明

public class GM_LineFeature_t : IDisposable

（2）构造函数

public GM_LineFeature_t()

（3）方法

方法	描述
Dispose	释放与该类关联的未管理的内存。
Finalize	终结器，重写 Object.Finalize()。
GetFeatureClassInfo	检索有关给定要素类的信息。
SetLineClassEnabled	启用或禁用给定要素类的显示。返回先前的启用/禁用状态。

Dispose

public void Dispose()

Finalize

protected override void Finalize()

GetFeatureClassInfo

public static GM_Error_t32 GetFeatureClassInfo(
	LineFeatureClass_t16 aFeatureClass,            //Feature class to get info for
	out GM_FeatureClassInfo_t aFeatureClassInfo    //Info about the feature class
)

SetLineClassEnabled

public static bool SetLineClassEnabled(
	LineFeatureClass_t16 aFeatureClass,    //Feature class to get info for
	bool aEnable                           //Enable or disable the feature class
)

（4）字段 

字段	描述
mFeatureInfo	与要素关联的属性列表（指向GM_AttrValueCharPtr_t/GM_AttrValueIntPtr_t数组的指针）（只读，请使用SetAttrList()成员函数设置新列表）。
mLineStyle	线条渲染样式（符号和字体）。
mPointList	构成线条的点列表（在获取时为全局坐标，在添加要素时为本地坐标）。
mVertexElevList	可选的每个点的高程列表。如果存在，必须有*mNumPoints*个值。

7.2.28 GM_LineStyle_t

（1）声明

public class GM_LineStyle_t

（2）构造函数

public GM_LineStyle_t()

（3）方法

方法	描述
AddCustomLineClass	添加新的自定义线分类。
GetLineFeatureClassDrawStyle	设置给定线要素分类的默认绘图样式。
SelectLineStyle	显示一个对话框，允许用户以图形方式选择线样式（在WinCE上不可用）。
SetLineFeatureClassDrawStyle	设置给定线要素分类的默认绘图样式。

 AddCustomLineClass

public static GM_Error_t32 AddCustomLineClass(
	string aName,                            //Custom type name
	GM_LineStyle_t aStyle,                   //Default draw style for features of this type
	out LineFeatureClass_t16 aFeatureCode    //Classification code for new type
)

GetLineFeatureClassDrawStyle

public static GM_Error_t32 GetLineFeatureClassDrawStyle(
	LineFeatureClass_t16 aFeatureClass,    //Feature class to get draw style for
	out GM_LineStyle_t aLineStyle          //Current draw style for Line classification
)

SelectLineStyle

public static GM_Error_t32 SelectLineStyle(
	out GM_LineStyle_t aLineStyle    //Line style buffer
)

SetLineFeatureClassDrawStyle

public static GM_Error_t32 SetLineFeatureClassDrawStyle(
	LineFeatureClass_t16 aFeatureClass,    //Feature class to set draw style for
	GM_LineStyle_t aLineStyle              //New style to use for line class (NULL to reset to default)
)

 （4）字段

字段	描述
mBgPenColor	双线画笔的背景线的颜色。
mBgPenWidth	双线画笔的背景线宽度；如果背景线宽度大于0，则为双线样式。
mDrawLabel	如果存在标签，则渲染该线的标签。
mDrawLabelAlways	即使与另一个显示标签发生碰撞，也要渲染该线的标签。
mDrawLabelOnLine	在线上直接渲染该线的标签（如果有），而不是偏离线。
mFixedWidthMeters	用于画笔的固定宽度（仅在mPenWidth为零时使用）。
mFont	用于渲染标签的字体。
mLabelSegment	要渲染标签的段号（从1开始）（使用0使用默认标签放置）。
mPenColor	用于画笔的颜色。
mPenStyle	画笔样式（即实线、虚线等）。
mPenWidth	以像素为单位的画笔绘制宽度（如果要绘制固定宽度线，请设置为0）。
mReserved	必须为0。

 7.2.29 GM_LineVolumeParams_t

（1）声明

public class GM_LineVolumeParams_t

（2）构造函数

public GM_LineVolumeParams_t()

（3）方法

方法	描述
SizeOf	返回非托管结构的大小。

 SizeOf

public static uint SizeOf()

（4）字段

字段	描述
mCorridorWidth	计算围绕线的走廊的宽度（即直径）以米为单位，以计算体积。
mCutHeights	每个点的切割高度，以米为单位。
mCutHeightsAbsolute	切割高度相对于海平面（TRUE）还是地面（FALSE）。
mPoints	全局坐标系中的点列表。
mSize	结构的大小。
mXSpacing	在x方向上的样本间距，以全局单位表示。
mYSpacing	在y方向上的样本间距，以全局单位表示。

7.2.30 GM_OnlineSourceInfo_t

（1）声明

public class GM_OnlineSourceInfo_t

（2）构造函数

public class GM_OnlineSourceInfo_t

public GM_OnlineSourceInfo_t(
	string aName,                    //Name of the online source. This can be passed to GM_LoadOnlineLayer
	GM_OnlineSourceType_t32 aType,   //Source type
	GM_AttrValue_t[] aAttrList       //List of additional attributes and values for the source
)

（3）字段

字段	描述
mAttrList	源的附加属性和值列表。
mName	在线源的名称。可以将其传递给GM_LoadOnlineLayer。
mType	源类型。

7.2.31 GM_Package_t 

（1）声明

public class GM_Package_t : IDisposable

（2）属性

属性	描述
Layers	包中的图层列表（只读）。

（3）方法

方法	描述
Close	关闭包并释放与之关联的内存。
Dispose	关闭包并释放与之关联的内存。
Draw	将包的指定部分绘制到设备上下文中。如果没有显式指定包，则会绘制所有加载的包。
DrawPackageList	将指定的包的指定部分绘制到设备上下文中。如果没有显式指定包，则会绘制所有加载的包。
LoadPackage	加载新的全局映射器包（.gmp）文件。如果不需要整个包操作，还可以使用该命令加载包文件。

Close

public GM_Error_t32 Close()

Dispose

public void Dispose()

Draw

public GM_Error_t32 Draw(
	IntPtr aDC,                    //Handle for the Device Context to draw to
	GM_DrawFlags_t32 aDrawFlags,   //Flags controlling how the draw is performed
	GM_Rectangle_t aWorldBounds,   //World bounds to draw or NULL for all
	int aLeftPixel,                //Left pixel coordinate to draw to
	int aTopPixel,                 //Top pixel coordinate to draw to
	int aPixelWidth,               //Width in pixels to draw
	int aPixelHeight               //Height in pixels to draw
)

DrawPackageList

public static GM_Error_t32 DrawPackageList(
	IntPtr aDC,                    //Handle for the Device Context to draw to
	GM_Package_t[] aPackageList,   //List of packages to draw or NULL for all
	GM_DrawFlags_t32 aDrawFlags,   //Flags controlling how the draw is performed
	GM_Rectangle_t aWorldBounds,   //World bounds to draw or NULL for all
	int aLeftPixel,                //Left pixel coordinate to draw to
	int aTopPixel,                 //Top pixel coordinate to draw to
	int aPixelWidth,               //Width in pixels to draw
	int aPixelHeight               //Height in pixels to draw
)

LoadPackage 

public static GM_Error_t32 LoadPackage(
	string aFilename,            //File to load package from
	out GM_Package_t aPackage,   //The package retrieved
	GM_LoadFlags_t32 aLoadFlags  //Load Option Flags
)

7.2.32 GM_PathProfileLOSParams_t

（1）声明

public class GM_PathProfileLOSParams_t

（2）构造函数

public GM_PathProfileLOSParams_t()

（3）属性

属性	描述
mDetailsStr	输出：包含路径详细信息的字符串（如果不关心，则设置为NULL）。
mElevList	输出：海拔列表（如果不关心，则设置为NULL）。
mLOSFirstBlockedPos	输出：沿路径的第一个被阻挡位置的位置（仅在mLOSMinClearance为负数时有效）。
mLOSLastBlockedPos	输出：沿路径的最后一个被阻挡位置的位置（仅在mLOSMinClearance为负数时有效）。
mLOSMinClearance	输出：线视距的最小间隔（如果线视距不清晰，则为负数）。
mLOSMinClearancePos	输出：线视距最小间隔的位置。

（4）方法

方法	描述
SizeOf	返回非托管结构的大小。

 SizeOf

public static uint SizeOf()

（5）字段

字段	描述
mAtmosphericCorr	输入：用于LOS的大气校正（1.3333是无线电波的标准值，1.0表示无校正）。
mDetailsStrMaxLen	输入：详细信息字符串的最大长度。
mDfltElev	输入：在找不到高程时使用的高程。
mEndX	输入：当前投影中的终点X坐标。
mEndY	输入：当前投影中的终点Y坐标。
mFlags	输入：控制行为的标志。
mFresnelFreq	输入：用于测试第一个费涅尔区间清除情况的频率（使用0.0表示不进行费涅尔测试）。
mFresnelPctClear	输入：第一个费涅尔区间必须清除障碍物的百分比（使用0.6表示60%）。如果指定为0，则使用默认值60%。
mListSize	输入：要检索的高程数量。
mLOSFromHeight	输入：以米为单位的视线起始高度。
mLOSToHeight	输入：以米为单位的视线终点高度。
mStartX	输入：当前投影中的起点X坐标。
mStartY	输入：当前投影中的起点Y坐标。

7.2.33 GM_PixelRect_t 

（1）声明

public class GM_PixelRect_t

（2）构造函数

public GM_PixelRect_t()

public GM_PixelRect_t(
	int aLeft,    //Left coordinate of rectangle
	int aRight,   //Right coordinate of rectangle
	int aTop,     //Top coordinate of rectangle
	int aBottom   //Bottom coordinate of rectangle
)

（3）字段

字段	描述
mBottom	矩形的底部坐标。
mLeft	矩形的左侧坐标。
mRight	矩形的右侧坐标。
mTop	矩形的顶部坐标。