This document is archived and information here might be outdated.  Recommended version.


ICamera Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > 3DAnalyst > ESRI.ArcGIS.Analyst3D > Interfaces > IC > ICamera Interface
ArcGIS Developer Help

ICamera Interface

Provides access to members that manipulate the camera. Note: the ICamera interface has been superseded by ICamera3. Please consider using the more recent version.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires 3D Analyst Extension.

When To Use

ICamera is used primarily to manipulate the perspective of a 3D display. It's implemented by the Camera associated with a SceneViewer.

Members

Name Description
Method Apply Applies camera parameters on rendering context.
Read/write property Azimuth The polar azimuth of the observer relative to the target. When changed, the observer moves.
Method CanSeeMBB Indicates if the camera can see any portion of the given extent.
Method CanSeeSphere Indicates if the camera can see any portion of the given sphere.
Method GetBackgroundColor Returns transient background color.
Method GetIdentifyRay Returns the ray that corresponds to given screen coordinates.
Method GetIdentifyVector Returns the vector that corresponds to the given screen location.
Method GetViewport Returns the viewport screen coordinates.
Method HTurnAround Turns the camera horizontally around observer by the given azimuth angle.
Read/write property Inclination The polar inclination of the observer relative to the target. When changed, the observer moves.
Read-only property IsUsable Indicates if the camera has valid parameters.
Method LevelObsToTarget Levels the observer to the target.
Method LevelTargetToObs Levels the target to the observer.
Method Move Moves the camera in the specified direction. The distance is calculated by applying the given factor to the current viewing distance.
Read/write property MultiPhaseRendering The state of multi-phase rendering. When true, the scene depth can be divided into multiple passes to improve rendering quality.
Read/write property Observer The observer's position.
Read-only property OrthoViewingExtent The extent visible by the camera in orthographic view.
Method Pan Moves both the observer and the target so that the object picked as the starting point on screen assumes the ending-point position.
Method PolarUpdate Updates the observer's location by given polar increments.
Read/write property ProjectionType The type of projection.
Method PropertiesChanged Sets camera's dirty flag.
Method QueryDistanceToMBB Returns the distance to the given extent.
Method QueryDistanceToSphere Returns the distance to the given sphere.
Method QueryDistanceToSphereCenter Returns the distance to the given sphere's center.
Method QueryIdentifyVector Returns the vector that corresponds to given screen coordinates.
Method QueryOrthoViewingPlatform Returns orthographic projection viewing parameters corresponding to the given extent.
Method QueryViewingPlatformMBB Returns the viewing parameters corresponding to the given extent.
Method QueryViewingPlatformSphere Returns the viewing parameters corresponding to the given spherical extent.
Method RecalcUp Updates the up-vector.
Method ReplayFrame Renders a frame.
Read/write property RollAngle The roll angle in degrees.
Method Rotate Rotates the observer horizontally around the target by a given angle in degrees.
Read-only property Scale The orthographic projection scale.
Method SetBackgroundColor Sets transient background color.
Method SetCoordOrigin Adapts the camera to the internal coordinate system of scene graph.
Method SetDefaultsMBB Positions camera so that the entire given extent can be seen.
Method SetDefaultsSphere Positions camera so that the entire given spherical extent can be seen.
Method SetViewport Sets the viewport screen coordinates.
Read/write property Target The target's position.
Read/write property UpDirection The camera's up-vector.
Write-only property VerticalExaggeration Adapts the camera to the scene's vertical exaggeration.
Read/write property ViewFieldAngle The view-field angle in degrees.
Read/write property ViewingDistance The viewing distance between the observer and the target. When changing, the observer moves.
Method Zoom Zooms in or out by moving the observer according to the required ratio between the new and previous viewing distances.
Method ZoomToRect Zooms to the given screen extent.

Classes that implement ICamera

Classes Description
Camera The Esri camera component.
GlobeCamera (esriGlobeCore) The globe camera component.

.NET Samples

Custom scene navigation commands Custom scene navigation commands Custom scene navigation commands Custom scene navigation commands Custom scene navigation commands Custom scene navigation commands Custom scene navigation commands Custom scene navigation commands Custom scene navigation commands Custom scene navigation commands Custom scene navigation commands Custom scene navigation commands Effects in the GlobeControl Navigating around the GlobeControl Globe Fly tool Creating a toolbar of globe tools Visualizing the camera path while animating