Inheritance diagram for TSLPolyline:

[legend]

Detailed Description

Polyline specific access methods.

This class represents the access methods that are specific to a polyline. They also allow setting of the various 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 TSLPolyline:

TSLRenderingAttributeEdgeColour
TSLRenderingAttributeEdgeStyle
TSLRenderingAttributeEdgeThickness
TSLRenderingAttributeEdgeThicknessUnits

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

Public Member Functions
bool	closed () const

void	closed (bool newValue)

double	length () const

const TSLCoordSet &	points () const

bool	points (TSLCoordSet *newPoints, bool keepCoordSet=false)

bool	points (const TSLCoordSet &newPoints)

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 TSLPolyline *	create (TSLFeatureID featureID, TSLCoordSet *coords, bool keepCoordSet=false)

static TSLPolyline *	create (TSLFeatureID featureID, const TSLCoordSet &coords)

static const TSLPolyline *	isPolyline (const TSLEntity *entity)

static TSLPolyline *	isPolyline (TSLEntity *entity)

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
	TSLPolyline ()

	~TSLPolyline ()

	TSLPolyline (const TSLPolyline &)

TSLPolyline &	operator= (const TSLPolyline &line)

Protected Member Functions inherited from TSLEntity
	~TSLEntity ()

Protected Member Functions inherited from TSLEntityBase
	~TSLEntityBase ()

Constructor & Destructor Documentation

◆ TSLPolyline() [1/2]

TSLPolyline::TSLPolyline ( )

protected

Private constructor to inhibit user creation

◆ ~TSLPolyline()

TSLPolyline::~TSLPolyline ( )

protected

◆ TSLPolyline() [2/2]

TSLPolyline::TSLPolyline ( const TSLPolyline & )

protected

Member Function Documentation

◆ closed() [1/2]

bool TSLPolyline::closed ( ) const

Queries whether the polyline is closed.

A closed polyline will automatically have its first and last points joined when rendered.

◆ closed() [2/2]

void TSLPolyline::closed ( bool newValue )

Sets whether the polyline is closed.

A closed polyline will automatically have its first and last points joined when rendered.

Parameters

newValue New value for closed flag.

◆ create() [1/2]

static TSLPolyline * TSLPolyline::create	(	TSLFeatureID	featureID,
		const TSLCoordSet &	coords )

static

Creates a polyline 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.
coords	Coordinate set describing the polyline.

Returns: NULL on error.

◆ create() [2/2]

static TSLPolyline * TSLPolyline::create	(	TSLFeatureID	featureID,
		TSLCoordSet *	coords,
		bool	keepCoordSet = false )

static

Creates a polyline 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.
coords	Coordinate set describing the polyline.
keepCoordSet	Flag to indicate whether the polyline should keep the specified coordinate set, or clone it. Note that if this flag is set, the polyline assumes control of the coordinate set and invalidates it. The user should not attempt to make further use of the coordinate set.

Returns: NULL on error.

◆ isPolyline() [1/2]

static const TSLPolyline * TSLPolyline::isPolyline ( const TSLEntity * entity )

static

Query whether the entity is a polyline.

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

When querying Optimised maps this query may return NULL.

Parameters

entity the entity to query

◆ isPolyline() [2/2]

static TSLPolyline * TSLPolyline::isPolyline ( TSLEntity * entity )

static

Query whether the entity is a polyline.

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

When querying Optimised maps this query may return NULL.

Parameters

entity the entity to query

◆ length()

double TSLPolyline::length ( ) const

Queries the length of the polyline, in TMC units.

◆ operator=()

TSLPolyline & TSLPolyline::operator= ( const TSLPolyline & line )

protected

Assignment operator.

Sets the polyline to be equal to that specified.

Parameters

line	Source for new polyline.

Returns: reference to updated value.

◆ points() [1/3]

const TSLCoordSet & TSLPolyline::points ( ) const

Query the coordinates defining the polyline.

Return the points associated with this polyline.

◆ points() [2/3]

bool TSLPolyline::points ( const TSLCoordSet & newPoints )

Sets the points associated with this polyline.

Parameters

newPoints New set of coordinates defining this polyline.

Returns: true on success, false otherwise.

◆ points() [3/3]

bool TSLPolyline::points	(	TSLCoordSet *	newPoints,
		bool	keepCoordSet = false )

Sets the points associated with this polyline.

Parameters

newPoints	New set of coordinates defining this polyline.
keepCoordSet	Flag to indicate whether the polyline should keep the specified coordinate set, or clone it. Note that if this flag is set, the polyline assumes control of the coordinate set and invalidates it. The user should not attempt to make further use of the coordinate set.

Returns: true on success, false otherwise.

Detailed Description

Public Member Functions

Static Public Member Functions

Protected Member Functions

Constructor & Destructor Documentation

◆ TSLPolyline() [1/2]

◆ ~TSLPolyline()

◆ TSLPolyline() [2/2]

Member Function Documentation

◆ closed() [1/2]

◆ closed() [2/2]

◆ create() [1/2]

◆ create() [2/2]

◆ isPolyline() [1/2]

◆ isPolyline() [2/2]

◆ length()

◆ operator=()

◆ points() [1/3]

◆ points() [2/3]

◆ points() [3/3]