Rogue Wave Views
Maps Package API Reference Guide
Product Documentation:

Rogue Wave Views
Documentation Home
List of all members | Public Member Functions | Protected Member Functions
IlvMapSegmentString Class Referenceabstract

This abstract class is the base class for segments that can be divided into other smaller segments. More...

#include <ilviews/maps/geometry/geosegstr.h>

Inheritance diagram for IlvMapSegmentString:
IlvMapSegment IlvMapCurve IlvMapGeometry IlvMapArcString IlvMapCurveString IlvMapLineString

Public Member Functions

virtual IlvMapGeometrycopy () const =0
 Returns a copy of the object. More...
 
virtual IlvClassInfogetClassInfo () const =0
 Returns the IlvClassInfo of the instance. More...
 
virtual const IlvCoordinategetEndPoint () const =0
 Returns the end point of the last segment. More...
 
virtual const IlvMapSegmentgetSegment (IlUInt index) const =0
 Returns the segment at a given index. More...
 
virtual IlUInt getSegmentCount () const =0
 Returns the number of segments contained in the string. More...
 
virtual const IlvCoordinategetStartPoint () const =0
 Returns the start point of the first segment, if it exists, otherwise, it returns an IlvCoordinate set to (0,0). More...
 
virtual const IlvMapGeometrygetSubElement (IlUInt) const
 Returns a sub element of a collection geometry. More...
 
virtual IlUInt getSubElementCount () const
 Returns the number of elements contained in the geometry if the geometry is a collection. More...
 
virtual IlBoolean isCollection () const
 Checks if this geometry is a collection of other geometries. More...
 
virtual void removeAll ()=0
 Removes all the segments in the string and sets the start point to (0,0).
 
virtual void setEndPoint (const IlvCoordinate &end)=0
 Sets the end point of the last segment if it exists. More...
 
virtual void setStartPoint (const IlvCoordinate &start)=0
 Sets the start point of the first segment. More...
 
- Public Member Functions inherited from IlvMapSegment
virtual IlUInt getHorizontalIntersectionCount (const IlvCoordinate &point) const =0
 Returns the number of intersections between this segment and an horizontal half line. More...
 

Protected Member Functions

 IlvMapSegmentString ()
 Initializes a new IlvMapSegmentString instance.
 
- Protected Member Functions inherited from IlvMapSegment
 IlvMapSegment ()
 Initializes a new IlvMapSegment instance.
 
- Protected Member Functions inherited from IlvMapCurve
 IlvMapCurve ()
 Initializes a new, empty, curve.
 
- Protected Member Functions inherited from IlvMapGeometry
 IlvMapGeometry ()
 Constructor. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from IlvMapGeometry
static IlvClassInfoClassInfo ()
 Returns the class info. More...
 

Detailed Description

This abstract class is the base class for segments that can be divided into other smaller segments.

Library: ilvmaps
The IlvMapCurveString is a generic implementation that can handle any type of IlvMapSegment, while other subclasses are optimized to handle uniform lists of segments.

The instances of the predefined subclasses of IlvMapSegmentString can be rendered by an IlvDefaultFeatureRenderer or by an IlvDefaultCurveRenderer.

Member Function Documentation

§ copy()

virtual IlvMapGeometry* IlvMapSegmentString::copy ( ) const
pure virtual

Returns a copy of the object.

Returns
An IlvMapGeometry that must be deleted by the user.

Implements IlvMapSegment.

Implemented in IlvMapLineString, IlvMapArcString, and IlvMapCurveString.

§ getClassInfo()

virtual IlvClassInfo* IlvMapSegmentString::getClassInfo ( ) const
pure virtual

Returns the IlvClassInfo of the instance.

Returns
An IlvClassInfo that should not be modified nor deleted.

Implements IlvMapCurve.

Implemented in IlvMapLineString, IlvMapArcString, and IlvMapCurveString.

§ getEndPoint()

virtual const IlvCoordinate& IlvMapSegmentString::getEndPoint ( ) const
pure virtual

Returns the end point of the last segment.

Returns
The end point. If there is no end point, the point (0, 0) is returned.

Implements IlvMapSegment.

Implemented in IlvMapLineString, IlvMapArcString, and IlvMapCurveString.

§ getSegment()

virtual const IlvMapSegment* IlvMapSegmentString::getSegment ( IlUInt  index) const
pure virtual

Returns the segment at a given index.

Parameters
indexThe index of the segment to be retrieved. index must have a value between 0 and getSegmentCount()-1.
Returns
An IlvMapSegment object that should not be modified nor deleted by the user. The returned IlvMapSegment is volatile: it may be modified or deleted by the IlvMapSegmentString itself after an other call to this function, or after any modification.

Implemented in IlvMapLineString, IlvMapArcString, and IlvMapCurveString.

§ getSegmentCount()

virtual IlUInt IlvMapSegmentString::getSegmentCount ( ) const
pure virtual

Returns the number of segments contained in the string.

Returns
The number of segments.

Implemented in IlvMapLineString, IlvMapArcString, and IlvMapCurveString.

§ getStartPoint()

virtual const IlvCoordinate& IlvMapSegmentString::getStartPoint ( ) const
pure virtual

Returns the start point of the first segment, if it exists, otherwise, it returns an IlvCoordinate set to (0,0).

Returns
The start point.

Implements IlvMapSegment.

Implemented in IlvMapLineString, IlvMapArcString, and IlvMapCurveString.

§ getSubElement()

virtual const IlvMapGeometry* IlvMapSegmentString::getSubElement ( IlUInt  index) const
virtual

Returns a sub element of a collection geometry.

Parameters
indexThe index of the sub-geometry to be retrieved.
Returns
The sub element of index index if the geometry is a collection or 0 if it is not.

Implements IlvMapGeometry.

§ getSubElementCount()

virtual IlUInt IlvMapSegmentString::getSubElementCount ( ) const
virtual

Returns the number of elements contained in the geometry if the geometry is a collection.

Returns
The number of elements contained in the geometry if the geometry is a collection. If it is not, this method returns 0.

Implements IlvMapGeometry.

§ isCollection()

virtual IlBoolean IlvMapSegmentString::isCollection ( ) const
virtual

Checks if this geometry is a collection of other geometries.

The composite geometries predefined in Rogue Wave Views Maps are: IlvMapGeometryCollection, IlvMapMultiPoint, IlvMapSegmentString and its subclasses, IlvMapMultiCurve and IlvMapMultiArea.

Returns
IlTrue if the geometry is a collection of other geometries.

Implements IlvMapGeometry.

§ setEndPoint()

virtual void IlvMapSegmentString::setEndPoint ( const IlvCoordinate end)
pure virtual

Sets the end point of the last segment if it exists.

If the end point of the last segment does not exists, this method does nothing.

Parameters
endThe end point.

Implements IlvMapSegment.

Implemented in IlvMapLineString, IlvMapArcString, and IlvMapCurveString.

§ setStartPoint()

virtual void IlvMapSegmentString::setStartPoint ( const IlvCoordinate start)
pure virtual

Sets the start point of the first segment.

Parameters
startThe start point.

Implements IlvMapSegment.

Implemented in IlvMapLineString, IlvMapArcString, and IlvMapCurveString.


© Copyright 2018, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.