This is a specialized interface for a 2D poly-polygon containing
straight line and bezier segments.
This poly-polygon can contain polygons consisting of a mixture of
cubic bezier curves and straight lines. As the straight line is a
special case of a cubic bezier curve (control points collinear
with the line through start and end point), this can be expressed
uniformly with a sequence of ::RealBezierSegment2Ds.
By convention, a ::RealBezierSegment2D is a straight
line segment, if all three contained points are strictly equal.
Set the specified sequence of bezier segments to the poly-polygon.
This method can either set the whole poly-polygon to the new
data, or insert the segments at the given index
Query subset of this poly-polygon, starting at the given
polygon and the given point within that polygon, and
containing the specified number of polygons and points in the
last polygon.
Parameter nPolygonIndex
The index of the polygon to start point retrieval with. This
index must be in the range [0,numPolygons-1].
Parameter nNumberOfPolygons
The number of polygons to extract. This value must not exceed
numPolygons-nPolygonIndex.
Parameter nPointIndex
The index of the first point in the first polygon to
extract. This value must not exceed the number of points in
this polygon minus one.
Parameter nNumberOfPoints
The number of points to extract from the last polygon. This
value must not exceed the number of points in this last
polygon minus one.
Returns
the sequence of extracted points.
Throws
com::sun::star::lang::IndexOutOfBoundsException
if one of the given values exceed the permissible range.
Set the specified sequence of bezier segments to the poly-polygon.
This method can either set the whole poly-polygon to the new
data, or insert the segments at the given index
Parameter nPolygonIndex
The index of the polygon to start segment insertion with. This
index must be in the range [0,numPolygons], and the insertion
will take place before this position (i.e. when
specifying 0 here, the given bezier sequence will precede all
existing polygons already within the poly-polygon). To append
to a poly-polygon, call setPoints() with
XBezierPolyPolygon2D::getNumberOfPolygons()
as the polygon index. If nPolygonIndex is -1, the given
bezier sequence replaces the poly-polygon content,
such that after this method completes, it contains exactly the
specified bezier segment data.
Throws
com::sun::star::lang::IndexOutOfBoundsException
if one of the given values exceed the permissible range.
The index of the polygon where the point to be extract is
contained within. This index must be in the range
[0,numPolygons-1].
Parameter nPointIndex
The index of the point in the polygon specified by
nPolygonIndex, which is to be retrieved. This value must not
exceed the number of points in this polygon minus one.
Returns
the requested point.
Throws
com::sun::star::lang::IndexOutOfBoundsException
if one of the given values exceed the permissible range.
