Indicator interface that identifies geometries that can have persistent Z values attached to their vertices.
Description
Controls whether or not the geometry object recognizes that it should use the Z attributes when performing operations. Some methods using Zs require that an object is Aware of Zs before they can be called, others function regardless of ZAwareness. IZAware also allows those Zs to be Dropped (reset to NaN). Z attributes are used by some operations as a third dimensional coordinate, but unlike X and Y which are true spatial coordinates, Z is merely an attribute.
Members
| Name | Description | |
|---|---|---|
 |
DropZs | Sets all the Z values to a non-valid number (NaN). |
 |
ZAware | Indicates whether or not the geometry is aware of and capable of handling Zs. |
 |
ZSimple | Indicates if all the Zs are valid numbers. |
IZAware.DropZs Method
Sets all the Z values to a non-valid number (NaN).
Public Sub DropZs ( _
)
public void DropZs (
);
Description
Resets all of the current Z values held by the geometry object back to NaN. ZAware does not change.
IZAware.ZAware Property
Indicates whether or not the geometry is aware of and capable of handling Zs.
Public Property ZAware As Boolean
public bool ZAware {get; set;}
Description
Returns or sets the Z Awareness state of the geometry object. If ZAware is TRUE, then the object will recognize that it has Z attributes and perform operations on them as necessary. If ZAware is FALSE, the object will ignore Zs while performing operations. ZAware should only be set to TRUE when all of the Zs are not NaN.
Remarks
Use ZAware = True when you want geometries to retain Z values during geometry operations.
private Double getZFromPoint(IPoint point)
{
return point.Z;
}
IZAware.ZSimple Property
Indicates if all the Zs are valid numbers.
Public ReadOnly Property ZSimple As Boolean
public bool ZSimple {get;}
Description
ZSimple is TRUE if none of the Z values held by the geometry object are NaN. If any of the Zs within the object are NaN, ZSimple is FALSE.
Classes that implement IZAware
| Classes | Description |
|---|---|
| Envelope | A rectangle with sides parallel to a coordinate system defining the extent of another geometry; optionally has min and max measure, height and ID attributes. |
| MultiPatch | A collection of surface patches. |
| Multipoint | An ordered collection of points; optionally has measure, height and ID attributes. |
| Point | A two dimensional point, optionally with measure, height, and ID attributes. |
| Polygon | A collection of rings ordered by their containment relationship; optionally has measure, height and ID attributes. |
| Polyline | An ordered collection of paths; optionally has measure, height and ID attributes. |
| TriangleFan | A continuous 3D fan of triangles, where each triangle after the first shares an edge with the preceding triangle, and all triangles share a common pivot point. |
| Triangles | A collection of 3D triangles, where each consecutive triplet of vertices defines a new triangle |
| TriangleStrip | A continuous 3D strip of triangles, where each triangle after the first shares an edge with the preceding triangle. |