tsc_Polyline

The class tsc_Polyline represents a polyline, with its constituent parts, as an entity in the Trimble Access job database. A polyline is a collection of parts being lines and arcs, each being defined by a start and an end point, plus a mid point for arcs. A polyline start point is defined from which the first part starts, and then each part continues on from the previous part, until the end of the polyline.

In TA version 2025.20, a change was introduced that treats the newer live polylines as compatible with tsc_PolyLine. This means that obtaining a list (Snapshot) of non-live polylines from the database will now also include live polylines and present them as tsc_PolyLine objects.

The points that define the parts of a (legacy) tsc_Polyline are all simple corrected grid coordinates, and thus a polyline of this type is completely self-contained. The other type of polyline, tsc_LivePolyline, which includes feature-coded polylines, is slightly different in the way it is stored:

• • tsc_Polyline objects are stored with absolute grid coordinates of the endpoints, where tsc_LivePolyline objects store the point names instead.

  • A tsc_Polyline instance can hold a live polyline, it simply returns the coordinates of the points rather than the names. You cannot add segments to a live polyline using tsc_Polyline because points, not grid positions, are required for this. Use tsc_LivePolyline to create or modify live polylines.

  • Non-live polylines never move nor change, whereas live polylines will change if the position of any point defining a part of the polyline, is moved. This includes movement due to replacement of the point, or movement introduced by coordinate system changes or cogo settings.

See also:

tsc_JobPolylines

tsc_PolylineList

tsc_PolylineObservation

tsc_PolylineDefinition

tsc_PolylineParts

tsc_IPolylineVisitor

Public Methods:

bool IsDeleted() const;
Returns true if the polyline has been deleted.

tsc_PolylineDefinition Polyline() const;
Retrieves the polyline parameters from the database. See tsc_PolylineDefinition.

tsc_Polyline();
Constructs an empty polyline object.

tsc_Polyline(const class tsc_Entity& jobObject);
Construction from the generic object, which must be a polyline.

static bool IsPolylineEntity (const class tsc_Entity& jobObject);
Returns true if the supplied entity is a polyline.