com.esri.arcgis.geometry
Interface IZAware

All Superinterfaces:

java.io.Serializable

All Known Implementing Classes:

Envelope, IZAwareProxy, MultiPatch, Multipoint, Point, Polygon, Polyline, TriangleFan, Triangles, TriangleStrip

public interface IZAware

extends java.io.Serializable

Indicator interface that identifies geometries that can have persistent Z values attached to their vertices.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

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.

See Also:

IZ

Method Summary

void	dropZs() Sets all the Z values to a non-valid number (NaN).
boolean	isZAware() Indicates whether or not the geometry is aware of and capable of handling Zs.
boolean	isZSimple() Indicates if all the Zs are valid numbers.
void	setZAware(boolean zAware) Indicates whether or not the geometry is aware of and capable of handling Zs.

Method Detail

isZAware

public boolean isZAware()
                 throws java.io.IOException,
                        AutomationException

Indicates whether or not the geometry is aware of and capable of handling Zs.

Supported Platforms

Windows, Solaris, Linux

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.

Returns:

The zAware

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setZAware

public void setZAware(boolean zAware)
               throws java.io.IOException,
                      AutomationException

Indicates whether or not the geometry is aware of and capable of handling Zs.

Supported Platforms

Windows, Solaris, Linux

Parameters:

zAware - The zAware (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isZSimple

public boolean isZSimple()
                  throws java.io.IOException,
                         AutomationException

Indicates if all the Zs are valid numbers.

Supported Platforms

Windows, Solaris, Linux

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.

Returns:

The zSimple

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

dropZs

public void dropZs()
            throws java.io.IOException,
                   AutomationException

Sets all the Z values to a non-valid number (NaN).

Supported Platforms

Windows, Solaris, Linux

Description

Resets all of the current Z values held by the geometry object back to NaN. ZAware does not change.

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.