TSLGeodeticPolyline Class Reference

Inheritance diagram for TSLGeodeticPolyline:

Detailed Description

Geodetic Polyline specific access methods.

This class provides the access methods specific to geodetic polylines. 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 TSLGeodeticPolyline:

• TSLRenderingAttributeEdgeColour
• TSLRenderingAttributeEdgeStyle
• TSLRenderingAttributeEdgeThickness
• TSLRenderingAttributeEdgeThicknessUnits

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

Known Limitations:

• If points or lines pass through or near the poles, the entity may be drawn incorrectly or even disappear.
• We have only tested interpolated entities whose consecutive points are within 60 degrees of latitude/longitude of each other. 180 degrees is the absolute maximum separation for consecutive points.
• If the coordinate system changes (e.g. a new map is loaded), geodetic entities will move themselves on the next draw to preserve lat/lon positions. However, if any TMC data of a geodetic entity are altered before a redraw but after a coord system change, the lat/lon data will be lost. The TMC data can be altered by move(), scale(), rotate() and translate(), and by any control point manipulation or insertion/removal of inners.
• Several parts of the system will treat interpolated entities as though they were not interpolated (e.g. checking whether a point is inside the entity or not).
• Interpolated entities do not fully "exist" until they are drawn, which means that their extents are not known until they are drawn. This can cause issues e.g. if a drawing surface has an undrawn geodetic entity, then its reset() method will zoom out a long way. This can also cause visual artefacts when manipulating interpolated entities; the entire drawing surface should always be redrawn when using them.
• Geodetic entities can modify themselves when they are drawn (e.g. moving themselves, updating their envelopes, etc).
• Layers containing Geodetic entities should not be shared between Drawing Surfaces.
• The default interpolation post distance is 50km, but this can be changed with interpolationDistance().

Public Member Functions
bool	closed () const
void	closed (bool newValue)
bool	interpolation () const
void	interpolation (bool newValue)
void	interpolationDistance (double newValue)
double	interpolationDistance () const
TSLGeodeticInterpolationOptionsEnum	interpolationOptions () const
void	interpolationOptions (TSLGeodeticInterpolationOptionsEnum newValue)
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 TSLGeodeticPolyline *	create (TSLFeatureID featureID, TSLCoordSet *coords, bool keepCoordSet=false)
static TSLGeodeticPolyline *	create (TSLFeatureID featureID, const TSLCoordSet &coords)
static const TSLGeodeticPolyline *	isGeodeticPolyline (const TSLEntity *entity)
static TSLGeodeticPolyline *	isGeodeticPolyline (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)

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

Member Function Documentation

closed() [1/2]

bool TSLGeodeticPolyline::closed

(

)

const

Queries whether the geodetic polyline is closed.

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

closed() [2/2]

void TSLGeodeticPolyline::closed

(

bool

newValue

)

Sets whether the geodetic polyline is closed.

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

Parameters

newValue

New value for closed flag.

create() [1/2]

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

static

Creates a geodetic 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 geodetic polyline.

Returns

NULL on error.

create() [2/2]

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

static

Creates a geodetic 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 geodetic polyline should keep the specified coordinate set, or clone it. Note that if this flag is set, the geodetic 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.

interpolation() [1/2]

bool TSLGeodeticPolyline::interpolation

(

)

const

Returns whether the geodetic entity interpolates between control points at all.

interpolation() [2/2]

void TSLGeodeticPolyline::interpolation

(

bool

newValue

)

Sets whether the geodetic entity interpolates between control points at all.

If true, the lines drawn between each pair of control points will be curved to follow the shortest geodesic path between them. If false, the lines will be drawn straight.

Parameters

newValue

New value for interpolation flag.

interpolationDistance() [1/2]

double TSLGeodeticPolyline::interpolationDistance

(

)

const

Returns the post distance used for interpolation, in km.

interpolationDistance() [2/2]

void TSLGeodeticPolyline::interpolationDistance

(

double

newValue

)

Sets the post distance for interpolation, in km. Will be used only if interpolation is on.

Parameters

newValue

New value for the post distance, in km.

interpolationOptions() [1/2]

TSLGeodeticInterpolationOptionsEnum TSLGeodeticPolyline::interpolationOptions

(

)

const

Returns the flags which control interpolation between control points of this geodetic entity.

interpolationOptions() [2/2]

void TSLGeodeticPolyline::interpolationOptions

(

TSLGeodeticInterpolationOptionsEnum

newValue

)

Sets the flags which control interpolation between control points of this geodetic entity.

Parameters

newValue

New value for the flags.

isGeodeticPolyline() [1/2]

static const TSLGeodeticPolyline * TSLGeodeticPolyline::isGeodeticPolyline ( const TSLEntity * entity )

static

Query whether the entity is a geodetic polyline.

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

When querying Optimised maps this query may return NULL.

Parameters

entity

the entity to query

isGeodeticPolyline() [2/2]

static TSLGeodeticPolyline * TSLGeodeticPolyline::isGeodeticPolyline ( TSLEntity * entity )

static

Query whether the entity is a geodetic polyline.

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

When querying Optimised maps this query may return NULL.

Parameters

entity

the entity to query

points() [1/3]

const TSLCoordSet & TSLGeodeticPolyline::points

(

)

const

Query the coordinates defining the geodetic polyline.

Return the points associated with this geodetic polyline.

points() [2/3]

bool TSLGeodeticPolyline::points

(

const TSLCoordSet &

newPoints

)

Sets the points associated with this geodetic polyline.

Parameters

newPoints

New set of coordinates defining this geodetic polyline.

Returns

true on success, false otherwise.

points() [3/3]

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

Sets the points associated with this geodetic polyline.

Parameters

newPoints	New set of coordinates defining this geodetic polyline.
keepCoordSet	Flag to indicate whether the geodetic polyline should keep the specified coordinate set, or clone it. Note that if this flag is set, the geodetic 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.