Inheritance diagram for TSL3DAPP6ASymbol:

[legend]

Detailed Description

3D APP6A Symbol specific access methods.

This class is represents a billboard (always faces the camera) style APP6A symbol.

Only the following attributes specified via TSLAPP6ASymbol are used for rendering of the symbol:

id hostility mobility unitSize type isFeintDummy key isHQStaff isTaskforce height heightType isFramed

Notes:

The APP6A symbols file needs to be loaded:

TSLDrawingSurface::setupSymbols("tslsymbolsAPP6A.dat");
The APP6A configuration file will be loaded by default from the config directory of your installation. If you wish to specify a different path to the app6aConfig.csv file then use TSLAPP6AHelper::setDefaultConfigPath()
On Windows 'smooth edges of screen fonts' needs to be turned off or the text will be anti-aliased.
Only the following Rendering Attributes make sense:

TSLRenderingAttributeSymbolRotatable TSLRenderingAttributeSymbolMaxPixelSize TSLRenderingAttributeSymbolMinPixelSize TSLRenderingAttributeDepthTest
Depth Testing defaults to TSL3DDepthTestDelayed.
The Symbol may become blurred under the following conditions:

a. The symbol can be rotated and a rotation is detected.

b. The Depth Test is TGM3DDepthTestStandard.

There is a maximum texture/bitmap size of 1024x1024. Any symbols larger then this will be scaled up to the required pixel size.

Deprecated
Deprecated as of MapLink 11.1. Advised to use MapLink Earth SDK instead.

Public Member Functions
const TSL3DCoord &	centre () const

void	centre (const TSL3DCoord &coord)

int	height () const

void	height (int newValue)

TSLAPP6ASymbol	symbolProperties ()

void	symbolProperties (const TSLAPP6ASymbol &properties)

double	rotation () const

void	rotation (double newRotation)

Public Member Functions inherited from TSL3DEntity
TSL3DBoundingBox	boundingBox (int surfaceID=-1) const

void	boundingBox (TSL3DCoord &bottomLeft, TSL3DCoord &topRight, int surfaceID=-1) const

TSL3DCoord	centroid () const

TSL3DEntity *	clone () const

double	distance (const TSL3DCoord &point, bool useRenderedExtent=true, int drawingSurfaceID=-1) const

bool	equals (const TSL3DEntity *other) const

void	move (const TSL3DCoord &location, const TSL3DCoord &reference)

TSL3DEntitySet *	parent ()

const TSL3DEntitySet *	parent () const

void	scale (double scaleParam, const TSL3DCoord *origin=0)

void	scale (double scaleX, double scaleY, double scaleZ, const TSL3DCoord *origin=0)

double	squareDistance (const TSL3DCoord &point, bool useRenderedExtent=true, int drawingSurfaceID=-1) const

void	translate (double latitudeOffset, double longitudeOffset, double altitudeOffset)

Public Member Functions inherited from TSLEntityBase
bool	addDataSet ()

bool	addDataSet (TSLDataHandler *toUseDataHandler)

bool	clearRenderingAttributes ()

TSLDataSet *	dataSet ()

const TSLDataSet *	dataSet () const

short	dataSourceID () const

void	dataSourceID (short dataSourceID)

bool	deleteDataSet ()

void	destroy ()

TSLEntityID	entityID () const

void	entityID (TSLEntityID value)

TSLFeatureID	featureID () const

void	featureID (TSLFeatureID newValue)

bool	getRendering (TSLRenderingAttributeInt attribute, int *result) const

bool	getRendering (TSLRenderingAttributeDouble attribute, double *result) const

bool	getRendering (TSLRenderingAttributeBool attribute, bool *result) const

bool	getRendering (TSLRenderingAttributes &result) const

TSL3DEntity *	is3DEntity ()

const TSL3DEntity *	is3DEntity () const

TSLEntity *	isEntity ()

const TSLEntity *	isEntity () const

bool	isOptimisedEntity () const

void	name (const char *newValue)

const char *	name () const

void	releaseResources (int surfaceID)

bool	setRendering (TSLRenderingAttributeInt attribute, int value)

bool	setRendering (TSLRenderingAttributeDouble attribute, double value)

bool	setRendering (TSLRenderingAttributeBool attribute, bool value)

bool	setRendering (const TSLRenderingAttributes &attributes)

void	sourceID (int value)

int	sourceID () const

TSLGeometryType	type () const

void	version (TSLVersion value)

TSLVersion	version () const

Static Public Member Functions
static TSL3DAPP6ASymbol *	create (TSLFeatureID featureID, TSLAPP6ASymbol *symbol, TSL3DCoord &centre, double height=0.0, double rotation=0.0)

static TSL3DAPP6ASymbol *	is3DAPP6ASymbol (TSL3DEntity *entity)

static const TSL3DAPP6ASymbol *	is3DAPP6ASymbol (const TSL3DEntity *entity)

Additional Inherited Members
Protected Member Functions inherited from TSLEntityBase
	~TSLEntityBase ()

Member Function Documentation

◆ centre() [1/2]

const TSL3DCoord & TSL3DAPP6ASymbol::centre ( ) const

Returns the center position of the symbol.

◆ centre() [2/2]

void TSL3DAPP6ASymbol::centre ( const TSL3DCoord & coord )

Sets the center position of the symbol

Parameters

coord coord value to set

◆ create()

static TSL3DAPP6ASymbol * TSL3DAPP6ASymbol::create	(	TSLFeatureID	featureID,
		TSLAPP6ASymbol *	symbol,
		TSL3DCoord &	centre,
		double	height = 0.0,
		double	rotation = 0.0 )

static

Creates an instance of a 3D APP6A symbol with the specified parameters.

This call should only be used for temporary entities. For example, this call may be used to create entities that are used in the spatial tests.

Parameters

featureID	ID of the feature code to assign to the entity. This is used when rendering map features if no specific attribute set has been created for the entity.
centre	Coordinate at which to place the 3D APP6A symbol
height	Size of text in metres (currently ignored)
rotation	As a symbol will always face the camera, the angle of rotation is about the axis made between the symbol and the camera. It should be specified in radians, +ve anti-clockwise.

Returns: NULL on error.

◆ height() [1/2]

int TSL3DAPP6ASymbol::height ( ) const

Query the size of the symbol

◆ height() [2/2]

void TSL3DAPP6ASymbol::height ( int newValue )

Set the size of the symbol

Parameters

newValue New size of symbol in metres.

Note: The height is currently ignored as TSLDimensionUnitsScaleFactor is not supported.

◆ is3DAPP6ASymbol() [1/2]

static const TSL3DAPP6ASymbol * TSL3DAPP6ASymbol::is3DAPP6ASymbol ( const TSL3DEntity * entity )

static

Query whether the entity is a 3D APP6A symbol.

If this entity is a 3D APP6A symbol, returns an accessor, otherwise returns NULL.

Parameters

entity the entity to query.

◆ is3DAPP6ASymbol() [2/2]

static TSL3DAPP6ASymbol * TSL3DAPP6ASymbol::is3DAPP6ASymbol ( TSL3DEntity * entity )

static

Query whether the entity is a 3D APP6A symbol.

If this entity is a 3D APP6A symbol, returns an accessor, otherwise returns NULL.

Parameters

entity the entity to query.

◆ rotation() [1/2]

double TSL3DAPP6ASymbol::rotation ( ) const

Returns the 3D symbol's rotation in degrees.

As a symbol will always face the camera, the angle of rotation is about the axis made between the symbol and the camera.

◆ rotation() [2/2]

void TSL3DAPP6ASymbol::rotation ( double newRotation )

Sets the 3D symbol's rotation.

As a symbol will always face the camera, the angle of rotation is about the axis made between the symbol and the camera.

Parameters

newValue New angle of rotation of the symbol, in radians, +ve anti-clockwise from +ve X axis.

◆ symbolProperties() [1/2]

TSLAPP6ASymbol TSL3DAPP6ASymbol::symbolProperties ( )

Returns the associated Symbol properties.

◆ symbolProperties() [2/2]

void TSL3DAPP6ASymbol::symbolProperties ( const TSLAPP6ASymbol & properties )

Sets the APP6A Symbol properties.

Detailed Description

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Member Function Documentation

◆ centre() [1/2]

◆ centre() [2/2]

◆ create()

◆ height() [1/2]

◆ height() [2/2]

◆ is3DAPP6ASymbol() [1/2]

◆ is3DAPP6ASymbol() [2/2]

◆ rotation() [1/2]

◆ rotation() [2/2]

◆ symbolProperties() [1/2]

◆ symbolProperties() [2/2]