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


ICamera Interface (ArcObjects .NET 10.4 SDK)
ArcObjects namespaces > 3DAnalyst > ESRI.ArcGIS.Analyst3D > Interfaces > IC > ICamera Interface (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (3DAnalyst)  

ICamera Interface

Provides access to members that manipulate the camera. Note: the ICamera interface has been superseded byICamera3. 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

Description
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 GetIdentifyRay Returns the ray that corresponds to given screen coordinates.
Method GetIdentifyVector Returns the vector that corresponds to the given screen location.
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 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.
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.

CoClasses that implement ICamera

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

.NET Snippets

Create Animation from Keyframes | Toggle Between Surface and Global Navigation Mode | Zoom to Globe Layer | Zoom to Selected Globe Features | Zoom to 3D Bookmark | Add Bookmark3D to SceneBookmarks

.NET Samples

Visualizing the camera path while animating (Code Files: VisualizeCameraPath) | Globe Fly tool (Code Files: Fly) | Navigating around the GlobeControl (Code Files: Navigation) | Effects in the GlobeControl (Code Files: Effects) | Creating a toolbar of globe tools (Code Files: GeographicCoordinates) | Custom scene navigation commands (Code Files: ExpandFOV Fly FullExtent NarrowFOV Navigate Pan SetObserver TargetCenter TargetZoom ZoomIn ZoomInOut ZoomOut)

.NET Related Topics

3DAnalyst | How to create and zoom to a bookmark in globe | How to zoom to a layer in globe | How to zoom to selected features in globe