ISectionPointSet Interface
- GetPoints
- GetPointSize
- PointSize
- GetColorPerVertex
- ColorPerVertex
- GetColors
ISectionPointSet interface gives access to
Point Set objects. It can be queried via path: Control >
GetModel
> IModel
> GetEntity > ISection
> ISectionPointSet
See also: LowDim Sample, Interface List
HRESULT GetPoints( IMatrixData**
points )
Parameters
points - [out] the
returned IMatrixData interface
implemented by the array of points
Return Values
-
- S_OK in case of
success.
-
- Remarks:
The point array is stored as a table of numbers with 3 columns. Coordinates
of i-th point are stored as the i-th column of the matrix. Number of rows
coincides with size of the point array, which can be obtained via
IArray2 queried from
ISectionPointSet.
HRESULT GetPointSize(int* size)
Parameters
size - [out,retval] The retuned current point size in
pixels
Return Values
-
- S_OK in case of
success.
-
- Remarks:
The method returns the current value of the Point Size property, which
determines size in pixels of each point in the set.
HRESULT PointSize(int size)
Parameters
size - [in] The new point size in pixels
Return Values
-
- S_OK in case of
success.
-
- Remarks:
The method sets new value of the Point Size property, which determines size
in pixels of each point in the set. For high-level environments the method is
described as write-only property.
HRESULT GetColorPerVertex(VARIANT_BOOL *val)
Parameters
val - [out] The current value of the Color Per Vertex
Boolean property.
Return Values
-
- S_OK in case of
success.
-
- Remarks:
Returns the Color Per Vertex property. If it is true each point is rendered
with its own color from the color array.
HRESULT ColorPerVertex(VARIANT_BOOL val)
Parameters
val - [in] New value of the Color Per Vertex Boolean
property.
Return Values
-
- S_OK in case of
success.
-
- Remarks:
If
If val is true each point will be rendered with its own color
from the color array. If false the first color from the color array is used for
all points. For high-level environments the method is described as write-only
property
HRESULT GetColors( IMatrixData**
colors )
Parameters
colors - [out]
IMatrixData interface
implemented by the Color Array. See remarks
Return Values
-
- S_OK in case of
success.
-
- Remarks:
The method gives access to array of colors. The matrix represented by the
returned
IMatrixData has colors arranged
as rows of the matrix. Four columns of the matrix correspond to RGBA components
of the color. All components should be in range [0.0, 1.0]. 1.0 value of the
Alpha component corresponds to fully opaque point.
|