com.esri.arcgis.globecore
Interface IGlobeViewUtil

All Superinterfaces:

Serializable

All Known Implementing Classes:

GlobeCamera

public interface IGlobeViewUtil
extends Serializable

Provides access to utility methods related to globe coordinates and view.

Product Availability

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

Method Summary

void	geocentricToGeographic(double x, double y, double z, double[] pLong_dd, double[] pLat_dd, double[] pElev_meters) Transform normalized geocentric coordinates to geographic coordinates.
void	geocentricToWindow(double x, double y, double z, int[] pWinX, int[] pWinY) Get the window coordinates corresponding to a geocentric location, or -1 if not visible.
void	geographicToGeocentric(double long_dd, double lat_dd, double elev_meters, double[] pX, double[] pY, double[] pZ) Transform geographical coordinates to normalized geocentric coordinates.
void	geographicToWindow(double long_dd, double lat_dd, double elev_meters, int[] pWinX, int[] pWinY) Get the window coordinates corresponding to a geographical location, or -1 if not visible.
void	getIsPointVisible(double x, double y, double z, boolean[] pOutsideView, boolean[] pTooClose, boolean[] pTooFar) Detect if point with geocentric coordinates is outside the pyramidal view, too close to the viewpoint, or too far from it.
double	getScalingDistance() The current distance used for scale range comparisons.
void	getViewingFrustrum(_WKSPointZ[] pNearBottomLeft, _WKSPointZ[] pNearBottomRight, _WKSPointZ[] pNearTopLeft, _WKSPointZ[] pNearTopRight, _WKSPointZ[] pFarBottomLeft, _WKSPointZ[] pFarBottomRight, _WKSPointZ[] pFarTopLeft, _WKSPointZ[] pFarTopRight) Get the viewing frustum as a truncated pyramid, a set of eight points in geocentric coordinates.
void	queryVisibleGeographicExtent(IEnvelope extent) Visible geographic extent of Globe sphere.
void	setLocalOrigin(double x, double y, double rhs3) The local origin for high precision OpenGL custom drawing.
void	setTargetAtCenter() Sets the camera target at the center of the globe.
void	windowToGeocentric(IGlobeDisplay pDisplay, ISceneViewer pViewer, int winX, int winY, boolean bUseZBufferValue, double[] pX, double[] pY, double[] pZ) Get the geocentric coordinates in the line of sight defined by the window coordinates.
void	windowToGeographic(IGlobeDisplay pDisplay, ISceneViewer pViewer, int winX, int winY, boolean bUseZBufferValue, double[] pLon, double[] pLat, double[] pAlt) Get the geographic coordinates in the line of sight defined by the window coordinates.

Method Detail

getScalingDistance

double getScalingDistance()
                          throws IOException,
                                 AutomationException

The current distance used for scale range comparisons.

Product Availability

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

Returns:

The pDistanceInMeters

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setTargetAtCenter

void setTargetAtCenter()
                       throws IOException,
                              AutomationException

Sets the camera target at the center of the globe.

Product Availability

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

geographicToGeocentric

void geographicToGeocentric(double long_dd,
                            double lat_dd,
                            double elev_meters,
                            double[] pX,
                            double[] pY,
                            double[] pZ)
                            throws IOException,
                                   AutomationException

Transform geographical coordinates to normalized geocentric coordinates.

Product Availability

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

Parameters:

long_dd - The long_dd (in)

lat_dd - The lat_dd (in)

elev_meters - The elev_meters (in)

pX - The pX (out: use single element array)

pY - The pY (out: use single element array)

pZ - The pZ (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

geocentricToGeographic

void geocentricToGeographic(double x,
                            double y,
                            double z,
                            double[] pLong_dd,
                            double[] pLat_dd,
                            double[] pElev_meters)
                            throws IOException,
                                   AutomationException

Transform normalized geocentric coordinates to geographic coordinates.

Product Availability

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

Parameters:

x - The x (in)

y - The y (in)

z - The z (in)

pLong_dd - The pLong_dd (out: use single element array)

pLat_dd - The pLat_dd (out: use single element array)

pElev_meters - The pElev_meters (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

geographicToWindow

void geographicToWindow(double long_dd,
                        double lat_dd,
                        double elev_meters,
                        int[] pWinX,
                        int[] pWinY)
                        throws IOException,
                               AutomationException

Get the window coordinates corresponding to a geographical location, or -1 if not visible.

Product Availability

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

Parameters:

long_dd - The long_dd (in)

lat_dd - The lat_dd (in)

elev_meters - The elev_meters (in)

pWinX - The pWinX (out: use single element array)

pWinY - The pWinY (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

geocentricToWindow

void geocentricToWindow(double x,
                        double y,
                        double z,
                        int[] pWinX,
                        int[] pWinY)
                        throws IOException,
                               AutomationException

Get the window coordinates corresponding to a geocentric location, or -1 if not visible.

Product Availability

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

Parameters:

x - The x (in)

y - The y (in)

z - The z (in)

pWinX - The pWinX (out: use single element array)

pWinY - The pWinY (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

windowToGeographic

void windowToGeographic(IGlobeDisplay pDisplay,
                        ISceneViewer pViewer,
                        int winX,
                        int winY,
                        boolean bUseZBufferValue,
                        double[] pLon,
                        double[] pLat,
                        double[] pAlt)
                        throws IOException,
                               AutomationException

Get the geographic coordinates in the line of sight defined by the window coordinates.

Product Availability

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

Parameters:

pDisplay - A reference to a com.esri.arcgis.globecore.IGlobeDisplay (in)

pViewer - A reference to a com.esri.arcgis.analyst3d.ISceneViewer (in)

winX - The winX (in)

winY - The winY (in)

bUseZBufferValue - The bUseZBufferValue (in)

pLon - The pLon (out: use single element array)

pLat - The pLat (out: use single element array)

pAlt - The pAlt (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

windowToGeocentric

void windowToGeocentric(IGlobeDisplay pDisplay,
                        ISceneViewer pViewer,
                        int winX,
                        int winY,
                        boolean bUseZBufferValue,
                        double[] pX,
                        double[] pY,
                        double[] pZ)
                        throws IOException,
                               AutomationException

Get the geocentric coordinates in the line of sight defined by the window coordinates.

Product Availability

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

Parameters:

pDisplay - A reference to a com.esri.arcgis.globecore.IGlobeDisplay (in)

pViewer - A reference to a com.esri.arcgis.analyst3d.ISceneViewer (in)

winX - The winX (in)

winY - The winY (in)

bUseZBufferValue - The bUseZBufferValue (in)

pX - The pX (out: use single element array)

pY - The pY (out: use single element array)

pZ - The pZ (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getViewingFrustrum

void getViewingFrustrum(_WKSPointZ[] pNearBottomLeft,
                        _WKSPointZ[] pNearBottomRight,
                        _WKSPointZ[] pNearTopLeft,
                        _WKSPointZ[] pNearTopRight,
                        _WKSPointZ[] pFarBottomLeft,
                        _WKSPointZ[] pFarBottomRight,
                        _WKSPointZ[] pFarTopLeft,
                        _WKSPointZ[] pFarTopRight)
                        throws IOException,
                               AutomationException

Get the viewing frustum as a truncated pyramid, a set of eight points in geocentric coordinates.

Product Availability

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

Parameters:

pNearBottomLeft - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (out: use single element array)

pNearBottomRight - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (out: use single element array)

pNearTopLeft - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (out: use single element array)

pNearTopRight - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (out: use single element array)

pFarBottomLeft - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (out: use single element array)

pFarBottomRight - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (out: use single element array)

pFarTopLeft - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (out: use single element array)

pFarTopRight - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getIsPointVisible

void getIsPointVisible(double x,
                       double y,
                       double z,
                       boolean[] pOutsideView,
                       boolean[] pTooClose,
                       boolean[] pTooFar)
                       throws IOException,
                              AutomationException

Detect if point with geocentric coordinates is outside the pyramidal view, too close to the viewpoint, or too far from it.

Product Availability

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

Parameters:

x - The x (in)

y - The y (in)

z - The z (in)

pOutsideView - The pOutsideView (out: use single element array)

pTooClose - The pTooClose (out: use single element array)

pTooFar - The pTooFar (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setLocalOrigin

void setLocalOrigin(double x,
                    double y,
                    double rhs3)
                    throws IOException,
                           AutomationException

The local origin for high precision OpenGL custom drawing.

Product Availability

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

Parameters:

x - The x (in)

y - The y (in)

rhs3 - The rhs3 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryVisibleGeographicExtent

void queryVisibleGeographicExtent(IEnvelope extent)
                                  throws IOException,
                                         AutomationException

Visible geographic extent of Globe sphere.

Product Availability

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

Parameters:

extent - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.