com.esri.arcgis.geometry
Interface IZ

All Superinterfaces:

IZCollection, java.io.Serializable

All Known Implementing Classes:

IZProxy, Polygon, Polyline

public interface IZ

extends IZCollection, java.io.Serializable

Provides access to members that identify geometric objects that can have 3D coordinates and defines operations on such objects.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Description

IZ contains methods for setting Zs through interpolation based on existing Z values, Z values set at the From and To Points, and Z values from a FunctionalSurface. Z values may also be set to a single constant value. IZ also contains a method for determining if consecutive vertices exhibit a vertical relation.

See Also:

IZ

Method Summary

void	calculateNonSimpleZs() Calculates the non-simple Z values by extrapolation/interpolation.
void	interpolateFromSurface(IFunctionalSurface interpolationSurface) Use the specified functional surface to generate Z values for the vertices of this object.
void	interpolateZsBetween(int startPart, int startPoint, int endPart, int endPoint) Generate Z values by linear interpolation for all vertices in the range [start+1, end-1].
boolean	isZVertical() Indicates if at least two consecutive vertices of this polyline or polygon have the same x and y values, but distinct z values.
void	setConstantZ(double zLevel) Sets Z coordinates at all vertices to zLevel.

Methods inherited from interface com.esri.arcgis.geometry.IZCollection

getZMax, getZMin, multiplyZs, offsetZs

Method Detail

isZVertical

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

Indicates if at least two consecutive vertices of this polyline or polygon have the same x and y values, but distinct z values.

Supported Platforms

Windows, Solaris, Linux

Description

Returns TRUE when at least two consecutive vertices have the same X and Y coordinates, but different Z attributes. Returns FALSE if all consecutive vertices have different X and Y coordinates, or if they have the same Z attribute.

Returns:

The zVertical

Throws:

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

AutomationException - If the ArcObject component throws an exception.

interpolateFromSurface

public void interpolateFromSurface(IFunctionalSurface interpolationSurface)
                            throws java.io.IOException,
                                   AutomationException

Use the specified functional surface to generate Z values for the vertices of this object.

Supported Platforms

Windows, Solaris, Linux

Description

Sets Z attributes for all Points on the interfaced Geometry within the Domain of the FunctionalSurface equal to the Z value on the FunctionalSurface at each (X, Y) Point.

Parameters:

interpolationSurface - A reference to a com.esri.arcgis.geometry.IFunctionalSurface (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

interpolateZsBetween

public void interpolateZsBetween(int startPart,
                                 int startPoint,
                                 int endPart,
                                 int endPoint)
                          throws java.io.IOException,
                                 AutomationException

Generate Z values by linear interpolation for all vertices in the range [start+1, end-1].

Supported Platforms

Windows, Solaris, Linux

Description

Sets the Z attributes from the vertices between the StartPoint of the startPart and the EndPoint of the endPart. The values of the StartPoint and EndPoint remain unchanged, but all vertices inbetween are assigned Z values proportional to the distance along the curve between the StartPoint and EndPoint and the difference between the Z values of the StartPoint and EndPoint.

Parameters:

startPart - The startPart (in)

startPoint - The startPoint (in)

endPart - The endPart (in)

endPoint - The endPoint (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.

calculateNonSimpleZs

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

Calculates the non-simple Z values by extrapolation/interpolation.

Supported Platforms

Windows, Solaris, Linux

Description

Calculates Z attribute values for each non-simple (NaN) Z value from existing simple (non-NaN) Z attributes on the interfaced Geometry.

Throws:

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

AutomationException - If the ArcObject component throws an exception.

setConstantZ

public void setConstantZ(double zLevel)
                  throws java.io.IOException,
                         AutomationException

Sets Z coordinates at all vertices to zLevel.

Parameters:

zLevel - The zLevel (in)

Throws:

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

AutomationException - If the ArcObject component throws an exception.