AGI Components with Insight3D Alpha 2008 r8
IAgGxCamera Interface
Library ReferenceAGI.Graphics.Scene3DIAgGxCamera
Implemented by the scene camera. Contains operations to manipulate the camera position, view direction and orientation in the scene.
Declaration Syntax
C# Visual Basic Visual C++
public 
interface 
IAgGxCamera
Public 
Interface 
IAgGxCamera
public 
interface class 
IAgGxCamera
Members
All Members Methods Properties



Icon Member Description
AllowRotationOverConstrainedUpAxis
When true, the viewer can rotate over the constrained up axis. For example, the viewer is able to flip over the North Pole and view the globe upside down.

Axes
The camera's axes of rotation.

ConstrainedUpAxis
Constrain the up vector to the plane the vector is in.

FarNearPlaneRatio
The ratio of the far plane distance to the near plane distance for a frustum. Multiple frustums will be used for rendering based on the near and far plane distances, as well as this ratio. A lower far to near ratio will result in better z buffer precision bu???

FarPlane
The distance, in meters, from the viewer to the far plane.

FieldOfView
The field of view, in radians, in the screen's y axis. The default is 35 degrees. Wide fields of view create bigger view frustums, with more potentially visible objects but can look distorted.

GetDirection(IAgGxAxes)
Returns a normalized vector representing the direction the camera is looking, defined in the requested axes.

GetPosition(IAgGxReferenceFrame)
Returns the position of the viewer, in the requested reference frame.

GetUp(IAgGxAxes)
Returns the normalized up vector representing the orientation of the camera, defined in the requested axes.

LockViewDirection
When true, the viewer can only zoom in and out. That is, only the viewer's position can change, not direction or up vectors. If ConstrainedUpAxis is ConstrainedUpAxisNone, the viewer can also twist, which changes the up vector.

Move(IAgGxConstantCartesian)
Translates the viewer's position by the specified offset.

NearPlane
The distance, in meters, from the viewer to the near plane.

SetDirection(IAgGxConstantCartesian)
Modifies the direction the viewer is looking by setting it to the specified direction.

SetNearFarPlanes(Double, Double)
Sets the distance, in meters, from the viewer to the near and far planes.

SetPosition(IAgGxConstantCartesian)
Modifies the viewer?s position and explicitly sets it to the specified postion.

SetPositionAzimuthElevation(Double, Double)
Modifies the viewer's position using azimuth and elevation angles. Azimuth is an angle from the positive x axis, to rotate around z. Elevation is an angle to rotate from the xy plane toward z. This is commonly called after ViewExtent.

SetPositionRadius(Double)
Modifies the viewer's position so a sphere of the specified radius at the current reference point is completely within the view frustum. This is commonly called after View or ViewDirection to move the viewer back so an entire object is visible.

SetUp(IAgGxConstantCartesian)
Modifies the up vector of the viewer to the sprecified direction. This won't do anything unless ConstrainedUpAxis is set to None.

Snapshot
Provides functionality for taking snapshots from the camera.

Speed
The zooming speed in meters per second, if the camera is in untethered mode. Otherwise, the speed is zero.

Update () () ()
Clears any cached values for axes, points or vectors that are used in the current camera view. This should be called if the underlying objects are changed.

VideoRecording
Provides functionality for recording and taking snapshots from the camera.

View(IAgGxPoint, IAgGxPoint, IAgGxConstantCartesian, IAgGxAxes)
Views from a point to a point. Sets the viewer's position and the reference point the viewer is looking at.

ViewCentralBody(IAgGxCentralBody, IAgGxAxes)
Zooms to a central body and use the specified axes for rotation. The reference point is set to the center of the central body and the viewer's position is set so the entire central body is visible.

ViewDirection(IAgGxPoint, IAgGxVector, IAgGxConstantCartesian, IAgGxAxes)
Views from a point to a direction. Sets the viewer's position and the direction vector indicating where the viewer is looking.

ViewExtent(IAgGxCentralBody, Double, Double, Double, Double)
Zooms to a rectangular extent on the globe. The camera will be looking straight down at the extent, with the up vector pointing toward local north. The axes of rotation is an east-north-up axes.

ViewExtentUsingExtent(IAgGxCentralBody, IAgGxConstantExtent)
Zooms to a rectangular extent on the globe. The camera will be looking straight down at the extent, with the up vector pointing toward local north. The axes of rotation is an east-north-up axes.

ViewMode
Returns the view mode. ViewModeNormal is returned unless the camera was put into untethered mode by calling ViewUntethered.

ViewOffset(IAgGxPoint, IAgGxConstantCartesian, IAgGxConstantCartesian, IAgGxAxes)
Sets the camera's reference point ? the point the viewer is looking at. The viewer's position is the reference point translated by the offset.

ViewOffsetDirection(IAgGxPoint, IAgGxVector, IAgGxConstantCartesian, IAgGxAxes)
Sets the camera's reference point ? the point the viewer is looking at. The viewer's position is the reference point translated by the direction vector.

ViewUntethered(IAgGxPoint, IAgGxVector, IAgGxConstantCartesian, IAgGxAxes, Double)
Sets the view to untethered, which allows the viewer to move freely in space. Sets the viewer's position and initial direction they are looking. Zooming speed is in meters per second.

Assembly: AGI.Graphics.Scene3D.Interop(Module: AGI.Graphics.Scene3D.Interop) Version: 9.0.0.0 (9.0.0.0)