Types for Display and Drawing

The following types are used as parameters and return values in functions related to display features and drawing within GlobalMapper. These types use fixed, numeric constants, which are defined here.

globalmapper.GM_BlendMode_t8

This type represents the different blend modes available

Values:

GM_BlendMode_None = 0

GM_BlendMode_Multiple = 1

GM_BlendMode_Screen = 2

GM_BlendMode_Overlay = 3

GM_BlendMode_HardLight = 4

GM_BlendMode_ColorBurn = 5

GM_BlendMode_ColorDodge = 6

GM_BlendMode_ApplyColor = 7

GM_BlendMode_ApplyColorReverse = 8

GM_BlendMode_Darken = 9

GM_BlendMode_Lighten = 10

GM_BlendMode_Difference = 11

GM_BlendMode_Exclusion = 12

GM_BlendMode_KeepRedChannel = 13

GM_BlendMode_KeepGreenChannel = 14

GM_BlendMode_KeepBlueChannel = 15

GM_BlendMode_SpotNaturalColor = 16

view SPOT images as natural color

GM_BlendMode_PsuedoNaturalColor = 17

simple weighted average

GM_BlendMode_ColorToGrayscale = 18

convert RGB color image to grayscale in GlobalMapperInterface.h, which should match this.

GM_BlendMode_NumModes = 19

globalmapper.GM_ColorFormat_t32

List of supported color formats for GM_DrawLayerListToMemory

Values:

GM_ColorFormat_32Bit_ABGR = 0

32-bit color (alpha, blue, green, red)

GM_ColorFormat_32Bit_ARGB = 1

32-bit color (alpha, red, green, blue)

GM_ColorFormat_16Bit_565 = 2

16-bit color (5 bits red, 6 bits green, 5 bits blue)

GM_ColorFormat_24Bit_BGR = 3

24-bit color (blue, green, red)

GM_ColorFormat_24Bit_RGB = 4

24-bit color (red, green, blue)

GM_ColorFormat_NumFormats = 5

globalmapper.GM_ContrastMode_t8

This type represents the different contrast adjustment modes that are available

Values:

GM_Contrast_None = 0

No contrast adjustments

GM_Contrast_PercentageStretch = 1

Stretch within some std-dev of mean to 0-255 range

GM_Contrast_RangeStretch = 2

Stretch entire valid range to 0-255 range

GM_Contrast_NumModes = 3

Count of contrast modes available

GM_Contrast_RangeStretchCustom = 4

Stretch custom range to 0-255 range

GM_Contrast_HistogramEqualization = 5

Equalize histogram of image

GM_Contrast_DefaultAuto = GM_Contrast_PercentageStretch

globalmapper.GM_CustomShaderFlags_t32

This type represents flags available for custom shaders

Values:

GM_CustomShader_DontBlend = 0x00000001

Don’t blend colors between elevation values

GM_CustomShader_StretchToRange = 0x00000002

Stretch custom shader to cover valid elevation range

GM_CustomShader_ShadeSlopes = 0x00000004

Shade slopes of terrain rather than elevation values

globalmapper.GM_DrawFlags_t32

Flags to control the GM_DrawLayerList and GM_DrawPackageList operations

Values:

GM_DrawFlags_BestRasterLayers = 0x00000001

Only draw the best raster layers for this zoom scale

GM_DrawFlags_BestRasterLayersHiRes = 0x00000003

Same as GM_DrawFlags_BestRasterLayers, only it shows higher resolution layers a bit sooner

GM_DrawFlags_LowResRasterLayers = 0x00000002

Only draw the lowest resolution raster layers

GM_DrawFlags_HiResRasterLayers = 0x00000004

Only draw the highest resolution raster layers

GM_DrawFlags_BestRasterChart = 0x00000005

Only draw the best raster chart (this is tuned for marine chart display)

GM_DrawFlags_EraseBackground = 0x00000100

Erase the background with the current background color (GM_SetBackgroundColor)

GM_DrawFlags_HideAreas = 0x00000200

Do not draw any area or mesh (3D model) features from vector layers

GM_DrawFlags_HideLines = 0x00000400

Do not draw any line features from vector layers

GM_DrawFlags_HidePoints = 0x00000800

Do not draw any point features from vector layers

GM_DrawFlags_SeparateVectorLayers = 0x00001000

Draw each vector separately rather than drawing all at once.

GM_DrawFlags_HideLabels = 0x00002000

Do not label any rendered features

GM_DrawFlags_DontMaintainAspectRatio= = 0x00004000

Do NOT maintain the aspect ratio when drawing (this allows stretched views)

GM_DrawFlags_HidePartialLabels = 0x00008000

Hide labels that are not entirely in the draw window

GM_DrawFlags_ShowRenderProgress = 0x00010000

Show render progress dialog or call progress callback if provided

GM_DrawFlags_HideExtraIconText = 0x00020000

Hide any extra text shown below road icons

GM_DrawFlags_HideNonIconRoadLabels = 0x00040000

Hide any road line labels that are not iconized

GM_DrawFlags_RenderVertices = 0x00080000

Render vertices for area and line features

GM_DrawFlags_IncrementalRender = 0x00100000

Do an incremental render so that draw progress can be seen as layers complete rendering

GM_DrawFlags_NoAutoInterpolation = 0x00200000

Disable automatic interpolation of rasters at intermediate zoom ranges (results in faster renders w/ less quality)

GM_DrawFlags_DrawMapLayoutLayers = 0x00400000

Render any map layout layers that are enabled, like elevation legend, distance scale, feature legend, margins, and north arrow

GM_DrawFlags_Hide3DFeatures = 0x00800000

Don’t draw any 3D features on the 2D map

GM_DrawFlags_NoValidBgColorPixels = 0x01000000

If set ensures that no valid pixels in the output will have the background color. This means rendered pixels that would have that color are adjusted by 1 so they don’t exactly match.

GM_DrawFlags_OnlyLoadedLayers = 0x02000000

Don’t load new maps in map catalog for this draw if set

GM_DrawFlags_HideSelFeatures = 0x04000000

Don’t draw any selected features on the 2D map

GM_DrawFlags_IgnoreTypeFilter = 0x08000000

Ignore any current draw filters and just draw all vector features (subject to ‘deleted’ flag)

GM_DrawFlags_NoResampling = 0x10000000

Don’t resample layers regardless of their settings

GM_DrawFlags_RasterMask = 0x00000007

Mask for raster draw options

globalmapper.GM_FontBackground_t8

This type represents the different font background options

Values:

GM_Font_BgAuto = 0

Automatically choose transparent or opaque background (all transparent except when centered on line)

GM_Font_BgOpaque = 1

Fill label background with current background color

GM_Font_BgTransparent = 2

Make label background transparent

globalmapper.GM_MapCatalogDisplayType_t8

Display type for map catalog

Values:

GM_MapCatalog_DisplayTypePercent = 0

GM_MapCatalog_DisplayTypePixelSize = 1

GM_MapCatalog_DisplayTypeScale = 2

GM_MapCatalog_DisplayTypeScaleRange = 3

GM_MapCatalog_NumDisplayTypes = 4

globalmapper.GM_MapCatalogMapOpt_t8

Options for map catalog

Values:

GM_MapCatalog_SetMapProjection = 0

Set the native projection of the map at the given index. Data is GM_Projection_t*

GM_MapCatalog_NumMapOpts = 1

globalmapper.GM_MapLayoutPiece_t8

Type defining map layout pieces that can be saved out to a bitmap file with GM_ExportMapLayoutComponent

Values:

GM_MapLayout_Scale = 0

Distance scale bar

GM_MapLayout_ElevLegend = 1

Elevation legend

GM_MapLayout_MapLegend = 2

Map legend with vector types and/or palette

GM_MapLayout_NumPieceTypes = 3

globalmapper.GM_PixelTransFlags_t8

Flags for the type of pixel translucency

Values:

GM_PixelTrans_None = 0x00

No per-pixel translucency

GM_PixelTrans_Alpha = 0x01

An alpha channel (last band in file) is present

GM_PixelTrans_AssociatedAlpha = 0x02

Alpha channel is associated (any non-zero value is opaque, used by TIFF)

GM_PixelTrans_InvalidPixels = 0x04

Has invalid pixels or areas (but not a full alpha)

GM_PixelTrans_SpecialVal = 0x08

Format has a special value or palette index that is transparent (i.e. PNG sometimes uses this)

globalmapper.GM_PosDisplayFormat_t8

Misc. advanced options flags used with GM_Utility.SetMiscOptionEx

Values:

GM_POS_LatLonDecimal = 0

Display/save lat/lon as dd.ddddddd <hemi> [always positive, include hemisphere indicator]

GM_POS_LatLonDMS = 1

Display/save lat/lon as dd mm ss.ss

GM_POS_LatLonDM = 2

Display/save lat/lon as dd mm.mmm

GM_POS_MGRS = 3

Display/save lat/lon as MGRS

GM_POS_LatLonDecimalPlain = 4

Display/save lat/lon as +/-dd.ddddddd [no hemisphere indicator, West/South are negative]

GM_POS_NUM_TYPES = 5

Number of advanced option flags

GM_POS_Default = GM_POS_LatLonDMS

globalmapper.GM_SelectProjFlags_t32

List of flags for selecting a projection

Values:

GM_SelectProj_NoInterplanetaryDatums = 0x00000001

Do not display interplanetary datums in projection selection dialog

globalmapper.GM_ShaderBlendingAlg_t8

Ways to blend the intensity when using multiple light sources.

Values:

GM_BLENDING_ALG_AVERAGE = 0

GM_BLENDING_ALG_MAXIMUM = 1

GM_BLENDING_ALG_MINIMUM = 2

GM_BLENDING_ALG_WEIGHTED_AVERAGE = 3

GM_BLENDING_NUM_TYPES = 4

globalmapper.GM_RotationSense_t16

This type is OR’d with the mRotation member of the GM_PointStyle_t structure to specify symbol rotation sense.

Values:

GM_RotateSense_TopOfMap = 0x0000

Rotation is to top of map (default)

GM_RotateSense_TrueNorth = 0x1000

Rotation is relative to true north

GM_RotateSense_MagNorth = 0x2000

Rotation is relative to magnetic north

GM_RotateSense_Mask = 0xF000

GM_RotateAngle_Mask = 0x0FFF