Inheritance diagram for TSLUserGeometryEntity:

[legend]

Detailed Description

Specialist entity for the handling of user-defined geometry objects.

The User Geometry Entity allows the developer to create an object that can be stored inside a TMF file and drawn as part of the drawing of a Standard Data-Layer.

The developer should at minimum derive from TSLClientUserGeometryEntity in the application and implement the pure virtual draw method. Additional methods on TSLClientUserGeometryEntity may be overridden as necessary.

Only the methods defined on TSLClientUserGeometryEntity are supported for a user defined Entity at present. This means that setting of attributes, etc. is not supported.

This extension is purely for rendering of objects defined by the user.

It is the developer's responsibility to ensure thread safety.

Note: If you are not using the version of Visual Studio that MapLink was built with then you need to manage the deletion of the TSLClientUserGeometryEntity derived object yourself.

Public Member Functions
TSLClientUserGeometryEntity *	getClientUserGeometryEntity ()

const TSLClientUserGeometryEntity *	getClientUserGeometryEntity () const

void	setClientUserGeometryEntity (TSLClientUserGeometryEntity *client, bool ownsClient=false)

bool	valid () const

Public Member Functions inherited from TSLEntity
TSLCoord	centroid () const

TSLEntity *	clone () const

bool	contains (const TSLEntity *other) const

bool	crosses (const TSLEntity *other) const

void	alwaysMergeDifferences (bool _alwaysMergeDifferences)

TSLEntity *	difference (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

TSLEntity *	intersection (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

TSLEntitySet *	parent ()

const TSLEntitySet *	parent () 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)

TSLEntity *	unionWith (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 ()

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 TSLUserGeometryEntity *	create (TSLClientUserGeometryEntity *client, bool takeOwnership=true)

static const TSLUserGeometryEntity *	isUserGeometry (const TSLEntity *entity)

static TSLUserGeometryEntity *	isUserGeometry (TSLEntity *entity)

static bool	registerUserGeometryClientLoadCallback (TSLUserGeometryLoadCallback callback)

Static Public Member Functions inherited from TSLEntity
static TSLEntity *	createFromWKB (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 TSLEntity *	createFromWKT (const char *wkt, double TMCPerMU, double mapOffsetX=0.0, double mapOffsetY=0.0, bool multiAsEntitySet=false, double maxCurveAngle=0.0)

Protected Member Functions
	TSLUserGeometryEntity ()

	~TSLUserGeometryEntity ()

	TSLUserGeometryEntity (const TSLUserGeometryEntity &)

TSLUserGeometryEntity &	operator= (const TSLUserGeometryEntity &userGeom)

Protected Member Functions inherited from TSLEntity
	~TSLEntity ()

Protected Member Functions inherited from TSLEntityBase
	~TSLEntityBase ()

Constructor & Destructor Documentation

◆ TSLUserGeometryEntity() [1/2]

TSLUserGeometryEntity::TSLUserGeometryEntity ( )

protected

Protected destructor to inhibit user construction

◆ ~TSLUserGeometryEntity()

TSLUserGeometryEntity::~TSLUserGeometryEntity ( )

protected

◆ TSLUserGeometryEntity() [2/2]

TSLUserGeometryEntity::TSLUserGeometryEntity ( const TSLUserGeometryEntity & )

protected

Member Function Documentation

◆ create()

static TSLUserGeometryEntity * TSLUserGeometryEntity::create	(	TSLClientUserGeometryEntity *	client,
		bool	takeOwnership = true )

static

Creates a user geometry object 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

client	An instance of TSLClientUserGeometryEntity
takeOwnership	if true this instance takes ownership of the client.

Returns: an instance of TSLUserGeometryEntity. NULL is returned if an error occurred and the client will not be owned.

◆ getClientUserGeometryEntity() [1/2]

TSLClientUserGeometryEntity * TSLUserGeometryEntity::getClientUserGeometryEntity ( )

Returns the client user geometry entity instance attached to this TSLUserGeometryEntity.

◆ getClientUserGeometryEntity() [2/2]

const TSLClientUserGeometryEntity * TSLUserGeometryEntity::getClientUserGeometryEntity ( ) const

Returns the client user geometry entity instance attached to this TSLUserGeometryEntity.

◆ isUserGeometry() [1/2]

static const TSLUserGeometryEntity * TSLUserGeometryEntity::isUserGeometry ( const TSLEntity * entity )

static

Query whether the entity is an TSLUserGeometryEntity

If this entity is an TSLUserGeometryEntity returns an accessor, otherwise returns NULL.

When querying Optimised maps this query may return NULL.

Parameters

entity the entity to query

◆ isUserGeometry() [2/2]

static TSLUserGeometryEntity * TSLUserGeometryEntity::isUserGeometry ( TSLEntity * entity )

static

Query whether the entity is an TSLUserGeometryEntity.

If this entity is an TSLUserGeometryEntity, returns an accessor, otherwise returns NULL.

When querying Optimised maps this query may return NULL.

Parameters

entity the entity to query

◆ operator=()

TSLUserGeometryEntity & TSLUserGeometryEntity::operator= ( const TSLUserGeometryEntity & userGeom )

protected

Assignment operator.

Sets the user geometry to be equal to that specified.

Parameters

userGeom Source for new user geometry.

Returns: reference to updated value.

◆ registerUserGeometryClientLoadCallback()

static bool TSLUserGeometryEntity::registerUserGeometryClientLoadCallback ( TSLUserGeometryLoadCallback callback )

static

This function stores a pointer to the callback function to the User defined Load function that reads, creates and returns the User Geometry object.

You can register more than one callback. Once registered you can not remove a callback.

Parameters

callback function to call to load user geometry object.

◆ setClientUserGeometryEntity()

void TSLUserGeometryEntity::setClientUserGeometryEntity	(	TSLClientUserGeometryEntity *	client,
		bool	ownsClient = false )

Attaches an instance of TSLClientUserGeometryEntity to the TSLUserGeometryEntity.

This should be used to attach a handle to the developer's TSLClientUserGeometryEntity derived class.

If this instance already has a client attached the client is deleted if it is owned otherwise the client is replaced.

Parameters

client	A pointer to a TSLClientUserGeometryEntity derived class.
ownsClient	Indicates if the TSLUserGeometryEntity owns the client. If true the attached TSLClientUserGeometryEntity will be deleted when the TSLUserGeometryEntity is destroyed. The default value is false.

◆ valid()

bool TSLUserGeometryEntity::valid ( ) const

Queries the validity of the User Geometry (calls through to the Client valid method).

Returns true if it has, false otherwise.

Detailed Description

Public Member Functions

Static Public Member Functions

Protected Member Functions

Constructor & Destructor Documentation

◆ TSLUserGeometryEntity() [1/2]

◆ ~TSLUserGeometryEntity()

◆ TSLUserGeometryEntity() [2/2]

Member Function Documentation

◆ create()

◆ getClientUserGeometryEntity() [1/2]

◆ getClientUserGeometryEntity() [2/2]

◆ isUserGeometry() [1/2]

◆ isUserGeometry() [2/2]

◆ operator=()

◆ registerUserGeometryClientLoadCallback()

◆ setClientUserGeometryEntity()

◆ valid()