tsc_JobMapLayer

Note: This documentation may not correctly reflect the API with the new 3D map. Use with care. In general, all layers are now drawn at one layer level in the map, between the backdrops and the other objects on the map. They are drawn sequentially, numerically.

The map is drawn in a series of layers, and the tsc_JobMapLayer enumeration is used to identify them.

The layers in the enum are ordered from bottom to top, the bottom layer being drawn first, followed by the rest of the layers in sequence.  When a custom layer is added, it is drawn after (above) the layer specified, and before (underneath) the following layer.

It is important to choose the correct layer in which to draw additional graphics, so that important information is not obscured but the added graphics are still sufficiently visible.

All layers are drawn in full 32-bit ARGB. Unpainted parts of the image must be transparent, otherwise layers behind will be obscured.

enum tsc_JobMapLayer

{

    tsc_JobMapLayerBackdropImage    = 0,

    tsc_JobMapLayerSelectionUnder   = 1,

    tsc_JobMapLayerBackdropEntities = 2,

    tsc_JobMapLayerDatabaseEntities = 3,

    tsc_JobMapLayerSelectionInvert  = 4,

    tsc_JobMapLayerTop              = 5

};

The information displayed by each layer is described below:

tsc_JobMapLayerBackdropImage
This layer contains any geo-referenced image that is being displayed, and is completely opaque.  If no image is displayed, the white background will be visible.  Images drawn over this layer will be rendered in 24-bit color.

tsc_JobMapLayerSelectionUnder
This layer contains the selection underlay.  If there are no entities selected then this layer is empty (transparent).  For any selected item, this layer contains black pixels that surround the item, such as the small rectangle around a selected point, or a fatter line around a selected line or arc.  Selected points are drawn in inverse color on the tsc_JobMapLayerSelectionInvert layer such that, for instance, a point will appear as a white icon on a black rectangle.

tsc_JobMapLayerBackdropEntities
This layer contains selectable and non-selectable entities drawn from LandXML, DXF and Shape files.

tsc_JobMapLayerDatabaseEntities
This layer contains selectable database entities, but not currently selected ones.

tsc_JobMapLayerSelectionInvert
Icons for database entities which are currently selected are drawn on this layer.  This layer inverts the color which would normally be present from the tsc_JobMapLayerSelectionUnder layer.

tsc_JobMapLayerTop
This is the topmost layer, and contains a number of miscellaneous items, such as the current position cross-hair, stakeout cut/fill text, the Total Station ray, etc.  Areas drawn over this layer will obscure the other layers.  Colors are 24-bit.