MapLink Pro .
Envitia MapLink Pro: The Ultimate Mapping Application Toolkit
Loading...
Searching...
No Matches
TSLSymbol Class Reference
Inheritance diagram for TSLSymbol:

Detailed Description

Symbol specific access methods.

This class represents the access methods that are specific to a symbol. They also allow setting of rendering attributes.

Rendering attributes can be set directly to this geometry using the inherited TSLEntityBase::setRendering method. This is called 'Entity Rendering'.

Rendering can be applied to a large range of geometry using 'Feature Rendering' which is set by the datalayer using TSLDataLayer::addFeatureRendering which creates a featureID. The featureID can then have attributes applied to it using TSLDataLayer::setFeatureRendering.

A featureID can be applied to geometry on creation, or it can be added later using TSLEntityBase::featureID.

Valid Rendering Attributes for TSLSymbol:

  • TSLRenderingAttributeSymbolColour
  • TSLRenderingAttributeSymbolStyle
  • TSLRenderingAttributeSymbolSizeFactor
  • TSLRenderingAttributeSymbolSizeFactorUnits

The above is not a complete list, see TSLRenderingAttributeInt, TSLRenderingAttributeDouble and TSLRenderingAttributeBool for more details.

Public Member Functions

TSLTMC height () const
void height (TSLTMC newValue)
const TSLCoordposition () const
void position (const TSLCoord &newPosition)
Public Member Functions inherited from TSLEntity
TSLCoord centroid () const
TSLEntityclone () const
bool contains (const TSLEntity *other) const
bool crosses (const TSLEntity *other) const
void alwaysMergeDifferences (bool _alwaysMergeDifferences)
TSLEntitydifference (const TSLEntity *other) const
double distance (const TSLCoord &point, bool useRenderedExtent=true, int drawingSurfaceID=-1) const
TSLEnvelope envelope (int surfaceID=-1) const
bool equals (const TSLEntity *other) const
TSLEntityintersection (const TSLEntity *other) const
bool intersects (const TSLEntity *other) const
bool intersects (const TSLEnvelope *envelope) const
bool move (const TSLCoord &location, const TSLCoord &reference)
bool overlaps (const TSLEntity *other) const
TSLEntitySetparent ()
const TSLEntitySetparent () const
void renderLevel (int level)
int renderLevel () const
bool rotate (double angle, const TSLCoord *origin=NULL)
double rotation () const
bool rotation (double newValue)
bool scale (double scaleParam, TSLCoord *origin=0)
bool scaleXY (double scaleX, double scaleY, TSLCoord *origin=0)
double squareDistance (const TSLCoord &point, bool useRenderedExtent=true, int drawingSurfaceID=-1) const
double squareDistance (const TSLEntity *otherEntity) const
bool touches (const TSLEntity *other) const
bool translate (TSLTMC xoffset, TSLTMC yoffset)
TSLEntityunionWith (const TSLEntity *other) const
bool within (const TSLEntity *other) const
TSLCoord adjustedWeightedCentroid ()
 reserved for future use
TSLCoord centreOfGravity ()
 reserved for future use
Public Member Functions inherited from TSLEntityBase
bool addDataSet ()
bool addDataSet (TSLDataHandler *toUseDataHandler)
bool clearRenderingAttributes ()
TSLDataSetdataSet ()
const TSLDataSetdataSet () 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
TSL3DEntityis3DEntity ()
const TSL3DEntityis3DEntity () const
TSLEntityisEntity ()
const TSLEntityisEntity () 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 TSLSymbolcreate (TSLFeatureID featureID, TSLTMC x, TSLTMC y, TSLTMC height=100, double rotation=0)
static const TSLSymbolisSymbol (const TSLEntity *entity)
static TSLSymbolisSymbol (TSLEntity *entity)
Static Public Member Functions inherited from TSLEntity
static TSLEntitycreateFromWKB (const unsigned char *wkb, unsigned int wkbLength, double TMCPerMU, double mapOffsetX=0.0, double mapOffsetY=0.0, bool multiAsEntitySet=false, double maxCurveAngle=0.0)
static TSLEntitycreateFromWKT (const char *wkt, double TMCPerMU, double mapOffsetX=0.0, double mapOffsetY=0.0, bool multiAsEntitySet=false, double maxCurveAngle=0.0)

Protected Member Functions

 TSLSymbol ()
 ~TSLSymbol ()
 TSLSymbol (const TSLSymbol &)
TSLSymboloperator= (const TSLSymbol &)
Protected Member Functions inherited from TSLEntity
 ~TSLEntity ()
Protected Member Functions inherited from TSLEntityBase
 ~TSLEntityBase ()

Constructor & Destructor Documentation

◆ TSLSymbol() [1/2]

TSLSymbol::TSLSymbol ( )
protected

Private constructor to prevent user creation.

◆ ~TSLSymbol()

TSLSymbol::~TSLSymbol ( )
protected

◆ TSLSymbol() [2/2]

TSLSymbol::TSLSymbol ( const TSLSymbol & )
protected

Member Function Documentation

◆ create()

TSLSymbol * TSLSymbol::create ( TSLFeatureID featureID,
TSLTMC x,
TSLTMC y,
TSLTMC height = 100,
double rotation = 0 )
static

Creates a 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
featureIDID 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.
xX coordinate of symbol position.
yY coordinate of symbol position.
heightSize of symbol in TMC units.
rotationAngle of rotation of symbol. Expressed in radians, +ve anti-clockwise from the +ve X axis.
Returns
NULL on error.

◆ height() [1/2]

TSLTMC TSLSymbol::height ( ) const

Query the size of the symbol.

◆ height() [2/2]

void TSLSymbol::height ( TSLTMC newValue)

Set the size of the symbol.

Parameters
newValueNew size of the symbol. If the symbol is a scalable symbol, this height should be in TMC units. If the symbol is a non-scalable symbol, this height should be in pixels.

◆ isSymbol() [1/2]

const TSLSymbol * TSLSymbol::isSymbol ( const TSLEntity * entity)
static

Query whether the entity is a symbol.

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

When querying Optimised maps this query may return NULL.

Parameters
entitythe entity to query

◆ isSymbol() [2/2]

TSLSymbol * TSLSymbol::isSymbol ( TSLEntity * entity)
static

Query whether the entity is a symbol.

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

When querying Optimised maps this query may return NULL.

Parameters
entitythe entity to query

◆ operator=()

TSLSymbol & TSLSymbol::operator= ( const TSLSymbol & )
protected

◆ position() [1/2]

const TSLCoord & TSLSymbol::position ( ) const

Query the position of the symbol.

◆ position() [2/2]

void TSLSymbol::position ( const TSLCoord & newPosition)

Set the position of the symbol.

Parameters
newPositionNew position for the symbol.