SetSetGeoCalcSettings – Global Mapper

globalmapper.SetSetGeoCalcSettings(GM_GeoCalcSettings_t aSettings) → bool

Configures global settings for the GeoCalc library used for many geodetic calculations. The current settings can be retrieved with GetGeoCalcSettings to make changes to individual settings.

Parameters:: aSettings (GM_GeoCalcSettings_t) – The settings object to apply; configuration options are represented as bools
Returns:: True if any settings were changed, otherwise False
Return type:: bool

The GM_GeoCalcSettings_t class can be used to control the following settings:

mShowDeprecated: - Show deprecated geodetic definitions when browsing the GeoCalc datasource.
mPreferCRSFromExternalFile: - Prefer coordinate system definitions from external files.
mFilterTransformsByAOU: - Filter coordinate transforms in the GeoCalc datasource to only show ones which have a valid Area of Use at the relevant location. This means that transforms which have a limited geographic range will be excluded if the point is outside their range.
mAutoDownloadMissingGrids: - Automatically download missing grid files when using a datasource object that has a grid-file-based definition.
mUseNullForUnknownVertical: - Use a “null” transform for coordinate systems with an unknown vertical.
mAutoPickTransforms: - Use auto-pick for coordinate transformations. If this is disabled, you will need to manually specify a coordinate transformation or use a picker dialog that will open.
mUseLegacyAutoPickLogic: - Use legacy (non-GeoCalc) auto-pick logic for coordinate transformations, if auto-pick is enabled. This is how Global Mapper performed coordinate system transformations prior to v27.0.
mEnableViaIntermediate: - Enable “via intermediate” category in the GeoCalc datasource to convert from one coordinate system to another by an intermediate coordinate system, if there is no direct transform between the primary two.
mAllowNullCoordTransforms: - Allow operations to use “null” coordinate transformations as a fallback option if no other transform is available.
mEnableTimeDependentTransforms: - Enable time-dependent transformations in the GeoCalc datasource.

Example

The following is an example of SetGeoCalcSettings:

settings = gm.GetGeoCalcSettings()
settings.mAutoPickTransforms = True
result = gm.SetGeoCalcSettings(settings)

This example turns on the control to automatically select coordinate transformations and applies the setting.