![]() |
MapLink Pro 11.1.1.0.
Envitia MapLink Pro: The Ultimate Mapping Application Toolkit
|
This class category contains the API classes for the underlying OpenGIS based Geometry Model of MapLink products.
Simple Feature Geometry Package:
Geodetic Geometry Package:
Multi Geometry Group Package:
User Geometry Package:
Typedefs | |
typedef TSLClientUserGeometryEntity *(* | TSLUserGeometryLoadCallback) (TSLifstream &stream, int userGeometryID, bool &assumeOwnership) |
typedef TSLClientUserGeometryEntity *(* TSLUserGeometryLoadCallback) (TSLifstream &stream, int userGeometryID, bool &assumeOwnership) |
This function typedef defines the signature for a callback routine that is required to be called to load a user defined Geometry Entity.
Implementation: TSLClientUserGeometryEntity* loadUserGeometryCallback( TSLifstream& stream, int userGeometryID, bool& assumeOwnership );
All registered callbacks will be called, in order, until the one that returns a client for the userGeometryID is found. Implementations must therefore expect a mismatch between the userGeometryID.
stream | The input file stream that has had the data copied into. |
userGeometryID | A value that uniquely identifies the User Geometry object. |
assumeOwnership | The user should set this value based upon whether the returned callback should become owned by the MapLink created TSLUserGeometryEntity. True indicates ownership is transferred, whilst false implies that the returned object remains owned by the user. This is important if the code calling MapLink was not built using the same compiler version, for instance when using differing versions of Microsoft Visual Studio. |
Return | Value |
The callback should return the TSLClientUserGeometryEntity object or NULL.
enum TSLAreaRelations |
Enumerated type describing the way in which a TSLCoordSet allocates new memory when its capacity is exceeded.
enum TSLDimensionUnits |
Enumerated type used to indicate how various sizing and offset parameters should be interpreted. It presently applies to edge thickness, text offsets and text and symbol sizes.
When undefined, the default varies according to application. For example the default for edge thickness is Pixels, whilst the default for text and symbol size is ScaleFactor. This is for compatibility with previous releases of MapLink.
Note:
enum TSLDrawModeEnum |
enum TSLEdgeEndCapStyle |
Reserved for Future Enhancements.
Enumerated type describing the End Cap style for lines.
enum TSLEdgeJoinStyle |
enum TSLEntityChange |
This enumeration defines modifications that have been made to an entity. This is currently used by the TSLSeamlessLayerManager.
enum TSLFontTypeEnum |
Specifies interpolation options for geodetic primitives. These flags are mutually exclusive.
Note that interpolation can be turned on and off independently of these flags, and if interpolation is off, these flags will be ignored.
Deprecated values:
enum TSLProfileWriteMode |
Enumerated type describing the scalability mode for raster symbols only.
Rendering attributes for Entities and features. The methods which use this enum use C++ function overloading to provide some measure of type safety. All rendering attributes in this enum are of integer type. Some attributes are available on all entities, others are specific to an entity type. Note that some of the attributes listed below are not available for feature-based rendering.
Note that TSLRenderingAttributeReadOnly only applies to rendering attributes such as colours/styles and does not prevent the geometry from being modified.
Available on all entities, but not features:
Available on all TSLText entities and features:
Available on all TSLSymbol entities and features:
Rendering attributes for Entities and features. The methods which use this enum use C++ function overloading to provide some measure of type safety. All rendering attributes in this enum are of double type.
Available on TSLText entities and features:
Available on TSLArc and TSLPolyline entities and features:
Available on TSLPolygon and TSLBorderedPolygon entities and features:
Available on all TSLSymbol entities and features:
Available on TSL3DModel entities and features:
Available on TSL3DEntity entities and features:
TSLRenderingAttributeMaxDrawDistance
Defines the range, in meters, between which the entity is drawn.
Range is defined as: [MinDrawDistance..MaxDrawDistance[
Negative values mean that the distance is ignored.
The distance calculated is the distance from the near clip plane in meters to the centre of the Bounding Box for the entity.
These settings help you structure your drawing objects in such a way to improve the drawing performance by creating 'Levels of Detail', either by using a group structure or via setting particular display ranges on individual entities.
For example; this works by having a top level group and then at least two groups below this. One group specifies the near drawing range and the other the drawing range for further away, for example:
Group0 - [-1, -1[ (contains Group1 and Group 2) Group1 - Range [-1, 10000[ (Nearer Drawing) Group2 - Range [10000, -1[ (Further away Drawing) Group1 should contain the complex drawing. Group2 should contain a simpler drawing.
This approach lends itself to further levels of detail. How many that are required is very dependent upon how complex your display is.
If a display range is set on a group then the group culling will occur before the contents are checked.
Rendering attributes for Entities and features. The methods which use this enum use C++ function overloading to provide some measure of type safety. All rendering attributes in this enum are of integer type. Some attributes are available on all entities, others are specific to an entity type. Note that some of the attributes listed below are not available for feature-based rendering.
Some rendering attributes are only used by certain drawing surfaces. Specifically:
Available on all entities, but not features:
Available on TSLArc and TSLPolyline entities and features:
Available on TSLEllipse, TSLPolygon and TSLBorderedPolygon entities and features:
Available on TSLBorderedPolygon entities:
Available on TSLText entities and features:
Available on TSLSymbol entities and features:
Available on TSL3DSymbol, TSL3DAPP6ASymbol, TSLSatellite, entities and features:
Available on TSL3DText entities and features:
Available on TSL3DPolygon, TSL3DSensor, TSL3DEllipse, TSLExtruded2DPolyline:
Available on TSL3DModel entities and features:
Currently not used (fill attribute takes precedence):
Enumerator | |
---|---|
TSLRenderingAttributeEntityID | No longer supported. Use entity->getEntityID(). If used will return lower 32bits of the 64bit ID. |
TSLRenderingAttributeFeatureID | |
TSLRenderingAttributeRenderLevel | |
TSLRenderingAttributeUserWord | |
TSLRenderingAttributeEdgeColour | |
TSLRenderingAttributeEdgeStyle | |
TSLRenderingAttributeEdgeThicknessUnits | |
TSLRenderingAttributeFillColour | |
TSLRenderingAttributeFillStyle | |
TSLRenderingAttributeExteriorEdgeColour | |
TSLRenderingAttributeExteriorEdgeStyle | |
TSLRenderingAttributeExteriorEdgeThicknessUnits | |
TSLRenderingAttributeBorderWidth | |
TSLRenderingAttributeBorderColour | |
TSLRenderingAttributeTextColour | |
TSLRenderingAttributeTextFont | |
TSLRenderingAttributeTextVerticalAlignment | |
TSLRenderingAttributeTextHorizontalAlignment | |
TSLRenderingAttributeTextMinPixelHeight | |
TSLRenderingAttributeTextMaxPixelHeight | |
TSLRenderingAttributeTextOffsetUnits | |
TSLRenderingAttributeTextSizeFactorUnits | |
TSLRenderingAttributeTextBackgroundMode | |
TSLRenderingAttributeTextBackgroundColour | |
TSLRenderingAttributeTextBackgroundStyle | |
TSLRenderingAttributeTextBackgroundEdgeColour | |
TSLRenderingAttributeSymbolColour | |
TSLRenderingAttributeSymbolStyle | |
TSLRenderingAttributeSymbolMinPixelSize | |
TSLRenderingAttributeSymbolMaxPixelSize | |
TSLRenderingAttributeSymbolRotatable | |
TSLRenderingAttributeSymbolSizeFactorUnits | |
TSLRenderingAttributeRasterSymbolScalable | |
TSLRenderingAttributeSymbolFontCharacter | |
TSLRenderingAttributeTextDepthTest | |
TSLRenderingAttributeSymbolDepthTest | |
TSLRenderingAttributeFillDepthTest | |
TSLRenderingAttributeEdgeDepthTest | |
TSLRenderingAttributeModelStyle | |
TSLRenderingAttributeModelStyleLOD_1 | |
TSLRenderingAttributeModelStyleLOD_2 | |
TSLRenderingAttributeModelStyleLOD_3 | |
TSLRenderingAttributeModelStyleLOD_4 | |
TSLRenderingAttributeEdgeOpacity | |
TSLRenderingAttributeExteriorEdgeOpacity | |
TSLRenderingAttributeFillOpacity | |
TSLRenderingAttributeTextOpacity | |
TSLRenderingAttributeSymbolOpacity | |
TSLRenderingAttributeEdgeJoinStyle | Reserved for future enhancement. Value is one of TSLEdgeJoinStyle enum. |
TSLRenderingAttributeEdgeEndCapStyle | Reserved for future enhancement. Value is one of TSLEdgeEndCapStyle enum. |
TSLRenderingAttributeExteriorEdgeJoinStyle | Reserved for future enhancement. Value is one of TSLEdgeJoinStyle enum. |
TSLRenderingAttributeFillBackgroundColour | Reserved for future enhancement. This is the colour that will be drawn first then a pattern drawn on top will be the FillColour. |
TSLRenderingAttributeTextFillStyle | Reserved for future enhancement. A fill style ID. The text will be drawn using this fill pattern. |
TSLRenderingAttributeTextFillBackgroundColour | Reserved for future enhancement. See TSLRenderingAttributeFillBackgroundColour. |
TSLRenderingAttributeTextComplexHaloUnits | Reserved for future enhancement. See TSLRenderingAttributeTextComplexHaloRadius, TSLTextBackgroundModeComplexHalo. |
enum TSLRenderLevel |
Enumerated type describing the render level for entities. This is an enum rather than a simple integer due to the special values for undefined and multiple.
enum TSLSymbolRotation |
Enumerated type describing the rotation mode for symbols.
Enumerated type describing the style of background for text objects.
enum TSLTextEncoding |
Enumeration for defining the character encoding of a text string.
Values map directly to windows codepage values, so that other encodings can be provided if necessary.
If TSLTextEncodingUndefined is supplied, the text string is assumed to either be in UTF-8, or the current System codepage.
enum TSLTextRotation |
enum TSLVerticalAlignment |
Enumerated type describing vertical text alignment.