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

八两

已于 2023-12-19 07:53:26 修改

阅读量1k

点赞数 20

分类专栏： # GIS开发文章标签：个人开发

于 2023-12-18 22:19:16 首次发布

本文链接：https://blog.csdn.net/yuechi01/article/details/135053972

版权

GIS开发专栏收录该内容

13 篇文章 0 订阅

订阅专栏

5.第三方

5.1 第三方许可

必要的介绍

5.1.1 PDF支持

Global Mapper SDK通过http://www.quickpdflibrary.com/的QuickPDF库提供了对导入和导出地理空间PDF的支持。我们无法直接为此库进行转让许可，因此如果您需要PDF支持，您需要购买Quick PDF v11的许可证，然后通过GM_SetQuickPDFUnlockCode函数向Global Mapper SDK提供您的解锁密钥，然后再尝试导入或导出任何PDF文件。您还需要将'bin'或'bin64'文件夹中的QuickPDFDLL.dll和QuickPDFRenderer.dll文件与您的应用程序一起使用。

5.1.2 ECW/JPEG2000无限制压缩支持

该SDK包含免费无限制导入ECW和JPEG2000文件的支持，但第三方库（来自Intergraph）每个导出文件的大小限制为500MB（未压缩）。如果您已经获得了导出无限大小的适当许可证，请通过geohelp@bluemarblegeo.com与我们联系，我们将提供有关如何在基于SDK的应用程序中启用此支持的说明。

5.1.3 其他第三方库

所使用的以下组件已经获得许可：

Debenu Quick PDF Library v11

MrSID技术版权归LizardTech公司所有，1995-2005年。保留所有权利。MrSID技术受美国专利号5,710,835和待定专利保护。本代码版权归LizardTech公司所有，地址为1008 Western Avenue, Suite 200, Seattle, WA 98104，未经授权禁止使用或分发。只有在LizardTech Inc.的许可下才允许访问和使用本代码。部分代码受美国和外国专利和其他申请保护。保留所有权利。

此代码依赖于许多开源软件包，包括cppunit，crypto++，dlmalloc，expat，GDAL，zlib，perl，gcc，cvs，OpenSSL，gSOAP，doxygen和Linux等等。

Xerces版权归Apache软件基金会所有，版权年份为1999-2004。根据Apache许可证版本2.0（"许可证"）进行许可。许可证详情请参阅http://www.apache.org/licenses/LICENSE-2.0。

Xml-Security版权归Apache软件基金会所有，版权年份为2002-2005。根据Apache许可证版本2.0（"许可证"）进行许可。许可证详情请参阅http://www.apache.org/licenses/LICENSE-2.0。

对于Z+F Lidar文件格式的支持，可以使用来自德国Zoller+Froehlich GmbH的Z+F ZFS SDK。版权年份为2008，由Zoller+Froehlich GmbH Germany所有。Zoller + Froehlich GmbH Germany的网址为www.zf-laser.com。

MITAB库的大部分版权归Daniel Morissette（morissette@dmsolutions.ca）所有，版权年份为1998-2004。它还包含部分和使用了支持库，这些支持库的版权归Frank Warmerdam（warmerdam@pobox.com）所有（版权年份为1998-2004）和Stephane Villeneuve（stephane.v@videotron.ca）所有（版权年份为1999、2000）。

MITAB库及其支持库（OGR和CPL）根据其开源许可条款免费提供。

6.C++函数参考手册

6.1 函数分类

6.1.1 图层加载功能

GM_CloseLayer - 关闭之前打开的图层
GM_ClosePackage - 关闭之前打开的程序包
GM_FlushLayerCache - 清除内存中缓存的图层数据
GM_GetAvailableOnlineSourceList - 获取可用的在线数据源列表
GM_GetLayerInfo - 检索图层元数据
GM_GetLoadedLayerList - 返回加载的图层列表
GM_GetOnlineSourceInfo - 获取关于在线资源的详细信息并检查可用性
GM_GetPackageLayerList - 获取程序包中的图层列表
GM_LoadGenericAsciiTextLayer - 加载ASCII编码的文本文件数据
GM_LoadLayer (不推荐) - 加载数据文件
GM_LoadLayerList - 加载数据文件
GM_LoadLayerListEx - 加载带有额外加载标志的数据文件
GM_LoadMapLayoutFile - 加载设置地图布局项目的文件
GM_LoadOnlineLayer - 从在线源（例如WMS或TerraServer-USA）加载数据
GM_LoadPackage - 加载Global Mapper Package文件
GM_LoadRectifiedLayer - 使用指定的地面控制点和投影，加载并校正图像
GM_LoadTerraServerLayer (不推荐) - 从TerraServer-USA加载数据，包括DRG、DOQ和城市区域的图像
GM_RepositionLayer - 使用新的地面控制点和/或投影，重新定位之前加载的图像
GM_RunScript - 运行一个Global Mapper脚本（.gms）文件
GM_SaveWorkspace - 将当前加载的图层列表保存为工作空间（GMW）文件
GM_SaveWorkspaceEx - 将加载的图层列表保存为工作空间（GMW）文件
GM_SetChildLayerOpCallback - 设置子图层加载时的回调函数

6.1.2 显示选项/绘图功能

GM_AddCustomShader - 添加新的自定义高程或坡度着色器
GM_CropLayerCollar(不推荐) - 裁剪DRG或DOQQ图层的边缘部分
GM_DrawGridLines - 将网格线绘制到设备上下文中
GM_DrawGridLinesEx - 绘制网格线到限制为给定矩形范围内的设备上下文中
GM_DrawLayer - 将一个或全部图层绘制到设备上下文中
GM_DrawLayerList - 将一个或多个图层绘制到设备上下文中
GM_DrawLayerListToMemory - 将一个或多个图层绘制到内存缓冲区中
GM_DrawPackageList - 将一个或多个程序包绘制到设备上下文中
GM_GetElevationOverrides - 获取图层的高程调整选项
GM_GetLastDrawnScale - 返回上次绘制时的比例尺数据。
GM_GetLastDrawnMapBounds - 获取最近绘制的地图边界数据（仅适用于Global Mapper Extension SDK）。
GM_GetLastDrawnMapBoundsEx - 获取最近绘制的地图边界数据，包括旋转量（仅适用于Global Mapper Extension SDK）
GM_GetOnlineLayerZoomScale - 获取以绘制/导出方式访问瓦片在线图层的缩放比例。
GM_GetRasterDisplayOptions - 检索给定栅格或高程图层的显示选项。
GM_GetShaderDisplayOptions - 检索用于高程着色器的选项
GM_GetVerticalDisplayOptions - 检索当前的垂直显示选项
GM_RemoveCustomShader - 移除自定义着色器
GM_SetBackgroundColor - 设置绘制时使用的背景颜色
GM_SetElevationOverrides - 设置图层的高程调整选项
GM_SetLayerEnabled - 设置图层是否可显示
GM_SetLayerPalette - 设置基于调色板的图像图层的调色板
GM_SetOrientation - 设置地图显示的旋转角度
GM_SetRasterDisplayOptions - 设置指定栅格或高程图层的显示选项
GM_SetShaderDisplayOptions - 设置用于高程渲染的选项
GM_SetVectorDrawScale - 设置线宽和点符号的额外缩放因子
GM_SetVerticalDisplayOptions - 设置垂直显示选项
GM_ShowLayerOptionsDialog - 显示图层的显示选项对话框

6.1.3 坐标转换/测量功能

GM_CalcBearing - 计算两点之间的方位角
GM_CalcDistance - 计算两点之间的距离
GM_CalcEnclosedArea - 计算一个区域的封闭面积
GM_CalcProjectedLocation - 计算一个点沿给定方位投影后的新点位
GM_CalcScaleRectangle - 计算在给定比例尺下绘制所需的地面矩形。
GM_CalcWorldRectSize - 计算包围框的宽度和高度（单位为米）
GM_ConvertCoordGroundToPixel - 将地面坐标转换为像素坐标
GM_ConvertCoordGroundToPixelWithOrientation - 将地面坐标按照方向转换为像素坐标
GM_ConvertCoordLayerGroundToPixel - 将地面坐标系转换为图层像素坐标系
GM_ConvertCoordLayerPixelToGround - 将图层像素空间坐标转换为地面坐标
GM_ConvertCoordPixelToGround - 将像素坐标转换为地面坐标。
GM_ConvertCoordPixelToGroundWithOrientation - 将像素坐标按照方向转换为地面坐标

6.1.4 投影/基准功能

GM_AddCustomDatum - 添加一个新的自定义基准转换
GM_AddCustomEllipsoid - 添加一个新的自定义椭球体
GM_AreProjectionsEquivalent - 检查两个投影是否等价
GM_DecodeMGRSCoordinates - 将MGRS坐标字符串解码为XY位置
GM_GetAvailableProjectionList - 获取可用的投影列表
GM_GetDatumInfo - 获取一个基准的转换参数
GM_GetMGRSCoordinates - 获取一个位置的MGRS坐标
GM_GetProjection - 获取当前视图/导出的投影
GM_LoadProjectionFile - 从文件加载投影
GM_LoadProjectionFromEPSGCode - 根据EPSG代码初始化一个GM_Projection_t结构体
GM_LoadProjectionFromWKTString - 根据WKT字符串初始化一个GM_Projection_t结构体
GM_ProjectionGetBase - 获取形成给定投影基础的基底投影。
GM_ProjectPoint - 将点从一个投影/基准转换到另一个投影/基准
GM_ProjectPointAtElev - Projects a Point from one Projection/Datum to Another at an Elevation Above the Ellipsoid - 指定椭球高时，将点从一个投影/基准转换到另一个投影/基准
GM_ProjectPointFromECEF - 将点从ECEF（地心地固）坐标进行投影
GM_ProjectPointList - 将一组点从一个投影/基准转换为另一个投影/基准
GM_ProjectPointToECEF - 将点投影到ECEF（地心地固）坐标中
GM_ProjectRectangle - 将矩形从一个投影/基准面投影到另一个投影/基准面
GM_SaveProjectionToFile - 将 GM_Projection_t 结构保存为一个投影（PRJ）文件
GM_SaveProjectionToString - 将 GM_Projection_t 结构保存为 WKT 字符串
GM_SelectProjection - 提示用户选择投影方式
GM_SelectProjectionEx - 提示用户选择投影方式，并提供额外选项
GM_SetQueryProjectionCallback - 设置选择投影时要回调的函数
GM_SetProjection - 设置视图/导出的投影/基准面。
GM_SetProjectionEx - 设置视图/导出的投影/基准面（带自动区域选择）

6.1.5 输出功能

GM_ExportElevation - 导出一个或多个网格高程图层到一个新的高程网格文件
GM_ExportElevationEx - 导出一个或多个网格高程图层到一个新的高程网格文件
GM_ExportMapLayoutComponent - 将地图布局组件（例如比例尺、图例等）导出为BMP文件
GM_ExportPackage - 将加载的图层导出为新的Global Mapper Package (GMP)文件
GM_ExportPDF - 将加载的图层导出为新的GeoPDF文件
GM_ExportRaster - 将一个或多个图层导出为新的栅格文件（例如GeoTIFF、JPG等）
GM_ExportRasterEx - 将一个或多个图层导出为新的栅格文件（例如GeoTIFF、JPG等）
GM_ExportRasterFromBitmap - 从一个位图句柄导出新的栅格文件（例如GeoTIFF、JPG等）
GM_ExportVector - 将一个或多个图层导出到新的矢量文件（例如DXF、Shapefile等）
GM_ExportVectorEx - 将一个或多个图层导出为新的矢量文件（如DXF、Shapefile等）
GM_ExportVectorList - 将一个或多个图层导出为新的矢量文件（如DXF、Shapefile等）
GM_ExportWebFormat - 将一个或多个图层导出为Web浏览器格式（如Google地图，Virtual Earth等）
GM_SetExportCropAreas - 设置在导出过程中要裁剪的面要素列表

6.1.6 光栅/高程图层检索功能

GM_GetLocationColor - 获取给定位置的像素颜色
GM_GetLocationElevation - 获取给定位置的高程
GM_GetPixelBandValue - 获取图层中给定像素位置的原始波段值
GM_GetPixelColor - 获取图层中给定像素位置的像素颜色
GM_GetPixelColorRow - 获取图层中一个整行的颜色值
GM_GetPixelElevation - 获取图层中给定像素位置的高程
GM_GetPixelElevationRow - 获取图层中一个整行的高程值

6.1.7 矢量图层检索功能

GM_FindFeaturesInArea - 查找指定面中的要素
GM_FindNearestAddress - 查找最接近位置的地址
GM_FindNearestFeatures - 查找靠近某个位置的绘制可见的矢量要素
GM_FreeAreaFeature - 释放由GM_GetAreaFeature返回的面要素占用的内存
GM_FreeFeatureResultList - 释放之前返回的要素结果列表占用的内存。
GM_FreeLineFeature - 释放由GM_GetLineFeature返回的线要素占用的内存
GM_FreePointFeature - 释放由GM_GetPointFeature返回的点要素占用的内存
GM_GetAreaFeature - 返回图层中指定的面要素
GM_GetAreaFeatureEx - 返回图层中指定的面要素
GM_GetFeatureElevation - 获取要素的高程
GM_GetLineFeature - 返回图层中指定的线要素
GM_GetLineFeatureEx - 返回图层中指定的线要素
GM_GetPointFeature - 返回图层中指定的点要素
GM_GetPointFeatureEx - 返回图层中指定的点要素
GM_GetSelectedFeatures - 检索当前在Global Mapper显示中已选择的要素列表。此功能仅在Global Mapper Extension DLL中受支持

6.1.8 激光雷达功能

GM_AddLidarQueryToQuery - Adds a Lidar Query to Another Query
GM_AddRemovePointToLidarQuery - Adds or Removes a Single Point To/From a Lidar Query
GM_CreateEmptyLidarQuery - Creates an Empty Lidar Query
GM_CreateLidarQuery - Create a Lidar Query Result for Fast Data Access and Editing
GM_FreeLidarQuery - Frees a Lidar Query Result
GM_GetLayerLidarStats - 获取一个图层的激光雷达统计信息
GM_GetLidarPoint - Retrieves the Requested Lidar Point from the Layer
GM_GetLidarQueryInfo - Retrieves Information about a Lidar Query
GM_GetNextLidarQueryPoints - Retrieve the Next Chunk of Points from a Lidar Query
GM_InitLidarQueryFilter - Initialize a Lidar Query Filter to Defaults
GM_LidarClassFilter_IsClassEnabled - Check if Lidar Class is in Class Filter
GM_LidarClassFilter_SetClassEnabled - Enable/Disable Lidar Class in Filter
GM_SetLidarPoint - 更新激光雷达点云中的一个点
GM_UpdateLidarQueryPoints - Edit the Points in a Lidar Query with New Values

6.1.9 矢量图层编辑功能

GM_DeleteFeature - 更改加载图层中矢量要素的删除状态
GM_IsFeatureDeleted - 查询加载图层中矢量要素的删除状态
GM_SetAreaFeaturePointList - 设置给定面要素的位置点列表
GM_SetAreaFeaturePointListEx - 设置给定面要素的位置点列表
GM_SetFeatureAttrList - 设置要素使用的属性/值对列表
GM_SetFeatureClass - 设置要素的分类
GM_SetFeatureDescription - 设置要素的描述
GM_SetFeatureLabel - 设置要素的显示标签
GM_SetLayerDescription - 设置图层的描述
GM_SetLayerElevationAttribute - 设置图层的高程属性名称
GM_SetLayerElevationUnits - 设置在没有高程单位的情况下使用的3D矢量要素的高程单位
GM_SetLayerHeightAttribute - 设置图层的高度属性名称
GM_SetLayerHeightUnits - 设置用于没有高度单位的3D矢量要素的高度单位
GM_SetLayerLabelAttribute - 设置显示标签属性
GM_SetLayerUserData - 设置图层的用户数据
GM_SetLayerUserText - 设置图层的用户文本
GM_SetLineFeaturePointList - 设置给定线要素的位置点列表
GM_SetLineFeaturePointListEx - 设置给定面要素的位置点列表
GM_SetPointFeaturePosition - 设置给定点要素的位置点

6.1.10 矢量绘图样式功能

GM_AddCustomAreaClass - 添加新的自定义面分类
GM_AddCustomBrushStyle - 添加可用于绘制面要素时的新自定义画笔样式
GM_AddCustomLineClass - 添加新的自定义线分类
GM_AddCustomPointClass - 添加新的自定义点分类
GM_AddCustomSymbol - 添加一个可以用于渲染点要素的自定义符号
GM_GetAreaFeatureClassDrawStyle - 获取给定类型面要素的默认绘图样式
GM_GetAvailableSymbolNames - 获取可用的点符号名称列表
GM_GetLidarClassInfo - 获取给定激光雷达类的信息
GM_GetLineFeatureClassDrawStyle - 获取给定类型的线条的默认绘制样式
GM_GetPointFeatureClassDrawStyle - 获取给定类型的点的默认绘制样式
GM_RemoveCustomBrushStyle - 移除自定义刷子样式
GM_RemoveCustomSymbol - 移除自定义符号
GM_SelectAreaStyle - 显示一个对话框，允许用户图形化地选择一个面样式
GM_SelectFont - 显示一个对话框，允许用户图形化地选择字体
GM_SelectLineStyle - 显示一个对话框，允许用户图形化地选择线样式
GM_SetAreaFeatureClassDrawStyle - 设置给定类型面要素的默认绘图样式
GM_SetAreaFeatureDrawStyle - 设置图层中面要素的绘图样式
GM_SetLidarClassInfo - 更新给定激光雷达分类的信息
GM_SetLineFeatureClassDrawStyle - 设置给定类型线要素的默认绘图样式
GM_SetLineFeatureDrawStyle - 设置图层中线要素的绘图样式
GM_SetPointFeatureClassDrawStyle - 设置给定类型点要素的默认绘图样式
GM_SetPointFeatureDrawStyle - 设置图层中点要素的绘图样式

6.1.11 矢量要素筛选功能

GM_GetFeatureClassInfo - 获取给定要素类的信息
GM_SetFeatureClassEnabled - 设置给定要素类的绘制启用状态

6.1.12 空间数据库功能

GM_DBGetTableList - 获取空间数据库的表列表。
GM_DBIsDatabaseFile - 检查文件名是否为一个空间数据库文件
GM_DBMakeConnectionString - 创建数据库的连接字符串
GM_DBSelectTable - 显示对话框，让用户选择要加载的表
GM_DBSelectExportTable - 显示对话框，让用户选择要导出到的表
GM_DBTableList_Free - Free List of DB Tables
GM_DBTableList_GetCount - Get Count of DB Tables in List
GM_DBTableList_GetTableName - Get DB Table Name from List
GM_DBTestConnection - 测试数据库连接字符串的有效性

6.1.13 GPS跟踪功能

GM_GPSGetAltitude - 获取当前GPS高度
GM_GPSGetBearing - 获取当前GPS方位角
GM_GPSGetFixInfo - 获取当前GPS修正准确性统计信息
GM_GPSGetFixType - 获取当前GPS修正类型（无修正、2D修正、3D修正等）
GM_GPSGetLocation - 获取当前GPS位置
GM_GPSGetTime - 获取当前GPS时间
GM_GPSGetTimeEx - 获取当前带有小数秒的GPS时间
GM_GPSGetVelocity - 获取当前GPS速度
GM_GPSRenderVessel - Renders a Triangular Vessel at the Current GPS Location
GM_GPSStartTrackingNMEAFile - 回放从NMEA日志文件中记录的GPS轨迹
GM_GPSStartTrackingSerial - 开始跟踪通过串口连接的GPS设备
GM_GPSStartTrackingUSB - 开始跟踪连接的Garmin USB GPS设备
GM_GPSStopTracking - 停止跟踪任何连接的GPS设备

6.1.14 3D视图功能

GM_3DCloseViewWindow - 关闭3D视图窗口
GM_3DGetCameraPosition - 获取当前3D视图中相机的位置
GM_3DIsWindowOpen - 确定3D视图窗口是否已打开
GM_3DPositionCamera - 设置当前3D视图中相机的位置
GM_3DSaveViewToFile - 保存当前3D视图到文件中
GM_3DSetChangeViewCallback - 设置3D视图请求新视图的回调函数
GM_3DSetView - 打开3D视图和/或设置要显示的数据

6.1.15 表面分析功能

GM_CalcAreaElevStats - 计算一个区域内的高程统计数据
GM_CalcViewShed - 在加载的高程图层上执行视域分析
GM_CalcVolumeAlongLine - 计算沿一条线路的切割与填方体积
GM_CalcVolumeOfArea - 计算区域内的切割与填方体积
GM_CombineTerrainLayers - 通过一些操作将两个加载的地形层组合生成一个新的地形层
GM_GenerateContours - 利用加载的高程网格层生成等高线
GM_GenerateContoursEx - 利用一个或多个加载的高程网格层生成等高线
GM_GenerateDensityGrid - 根据指定层的点生成密度（热力）网格
GM_GenerateElevationGrid - 使用已加载的3D矢量图层生成高程网格
GM_GenerateRoughnessGrid - 根据地表覆盖图层生成粗糙度网格
GM_GenerateWatershed - 根据加载的高程图层进行分水岭/排水/水流/山脊线计算
GM_GetPathProfile - 获取一条直线上的高程列表
GM_GetPathProfileLOS - 获取三维路径剖面并进行视线分析
GM_GetPathProfileLOSEx - 获取三维路径剖面并执行视线分析

6.1.16 地图目录功能

GM_MapCatalogAddFile - 添加一个文件到地图目录
GM_MapCatalogAddLayer - 将加载的图层添加到地图目录中
GM_MapCatalogChangeMapOrder - 调整地图目录中地图的顺序
GM_MapCatalogCreate - 创建一个新的地图目录
GM_MapCatalogDisableMap - 禁用（或重新启用）地图目录中的单个地图
GM_MapCatalogGetInfo - 获取已加载地图目录的信息和统计数据
GM_MapCatalogGetMapInfo - 获取已加载地图目录中某个地图的信息
GM_MapCatalogRemoveMap - 移除已加载地图目录中的一张地图
GM_MapCatalogSave - 将地图目录保存到磁盘
GM_MapCatalogSetDisplayInfo - Sets when the Layers in a Map Catalog Should be Displayed
GM_MapCatalogSetMapOption - Sets Options for a Single Map in the Map Catalog (i.e. Native Projection)