Description

Implemented by the scene camera. Contains operations to manipulate the camera position, view direction and orientation in the scene.

Public Methods

CartographicToWindow	Converts a Cartographic position to a pixel coordinate relative to the globe control. This method can throw an exception. Returns an array containing the pixel coordinate (in the order x, y) of the Cartographic position relative to the globe control. The coordinate can be fractional.
TryCartographicToWindow	Converts a Cartographic position to a pixel coordinate relative to the globe control. This method does not throw an exception.
TryWindowToCartographic	Converts a pixel coordinate relative to the globe control to a Cartographic position. For speed, terrain is not considered. This method does not throw an exception.
View	Views from a point to a point. Sets the camera's position and the reference point the camera is looking at.
ViewCentralBody	Zoom 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 camera's position is set so the entire central body is visible.
ViewDirection	Views from a point to a direction. Sets the camera's position and the direction vector indicating where the camera is looking.
ViewDirectionWithUpAxis	Views from a point to a direction. Sets the camera's position and the direction vector indicating where the camera is looking.
ViewExtent	Zooms to a Cartographic Extent on the centralBody. The camera will be looking straight down at the extent, with the up vector pointing toward local north. The Axes is set to an east-north-up axes at the center of extent.
ViewOffset	Sets the camera's reference point - the point the camera is looking at. The camera's position is the reference point translated by the offset.
ViewOffsetDirection	Sets the camera's reference point - the point the camera is looking at. The camera's position is the reference point translated by the direction vector.
ViewOffsetDirectionWithUpAxis	Sets the camera's reference point - the point the camera is looking at. The camera's position is the reference point translated by the direction vector.
ViewOffsetWithUpAxis	Sets the camera's reference point - the point the camera is looking at. The camera's position is the reference point translated by the offset.
ViewRectangularExtent	Zooms to a rectangular extent composed of west, south, east, north on the centralBody. The camera will be looking straight down at the extent, with the up vector pointing toward local north. The Axes is set to an east-north-up axes at the center of the extent.
ViewWithUpAxis	Views from a point to a point. Sets the camera's position and the reference point the camera is looking at.
VisibilityTest	Gets the visibility of a sphere against the view frustum and any occluding central bodies.
WindowToCartographic	Converts a pixel coordinate relative to the globe control to a Cartographic position. For speed, terrain is not considered; if the pixel coordinate does not intersect the ellipsoid, an exception is thrown. Returns the Cartographic position. The array contains the elements of the position in the order latitude, longitude, altitude.

Public Properties

AllowRotationOverConstrainedUpAxis	Gets or sets whether the camera can rotate over the constrained up axis. For example, if true the camera would be able to flip over the North Pole and view the globe upside down.
Axes	Gets or sets camera's axes of rotation.
ConstrainedUpAxis	Gets or sets the axis to constrain the up vector to.
Direction	Gets or sets the direction of the camera in Axes. The array contains the components of the direction arranged in the order x, y, z.
Distance	Gets or sets the distance the camera position is from the reference point.
DistancePerRadius	Returns the distance that the Camera's Position should be from the ReferencePoint in order to ensure that a sphere with a 1 meter radius centered at the ReferencePoint fits entirely in the view frustum.
FarNearPlaneRatio	Gets or sets the value that is used to compute subdivisions of the viewing frustum. A large value will be faster but lose z-value precision. A small value will have better precision but perform slower. The default value of 1000 achieves a good balance between speed and accuracy.
FarPlane	Gets or sets the distance from the camera to the far plane.
FieldOfView	Gets or sets field of view. The field of view is applied to the larger of the window dimensions. For example, if the window width was 640 and the height was 480, the field of view applies to the horizontal. Use Horizontal Field Of View and Vertical Field Of View to get the horizontal and vertical field of views. Wide fields of views generally show more objects but can look distorted as compared to narrower ones.
HorizontalFieldOfView	Gets the horizontal field of view.
LockViewDirection	Gets or sets whether the camera's direction is locked.
NearPlane	Gets or sets the distance from the camera to the near plane.
PixelSizePerDistance	Gets the approximate number of meters covered by a pixel that is `1` meter away from the camera. This is commonly multiplied by the distance from the camera to an object to compute the approximate number of meters covered by a pixel of the object.
Position	Gets or sets the position of the camera. The array contains the components of the position arranged in the order x, y, z.
PositionReferenceFrame	Gets the Reference Frame that the Position is returned in. This Reference Frame is composed of the camera's from Point and the Axes.
ReferencePoint	Gets or sets the reference point of the camera. The array contains the components of the reference point arranged in the order x, y, z.
ReferencePointReferenceFrame	Gets the Reference Frame that the Reference Point is returned in. This Reference Frame is composed of the camera's to Point and the Axes.
Snapshot	Gets the camera snapshot settings.
UpVector	Gets or sets the up direction of the camera in Axes. The array contains the components of the direction arranged in the order x, y, z.
VerticalFieldOfView	Gets the vertical field of view.
VideoRecording	Gets the camera video recorder.

Example

Change camera view to Imagery Extents

[Python - STK API]

# IAgScenario scenario: Scenario object
# IAgStkGraphicsAGIProcessedImageGlobeOverlay imageryTile: Image Overlay object
manager = scenario.SceneManager
extent = imageryTile.Extent
# Change extent in the default 3D window
manager.Scenes.Item(0).Camera.ViewExtent('Earth', extent)
manager.Render()

Change camera reference frame

[Python - STK API]

# IAgScenario scenario: Scenario object
# IAgStkObjectRoot root: STK Object Model Root
manager = scenario.SceneManager
manager.Scenes.Item(0).Camera.ViewCentralBody('Earth', root.CentralBodies.Earth.Vgt.Axes.Item('Fixed'))
manager.Render()

Change camera view to Imagery Extents

[MATLAB]

% IAgScenario scenario: Scenario object
% IAgStkGraphicsAGIProcessedImageGlobeOverlay imageryTile: Image Overlay object
manager = scenario.SceneManager;
extent = imageryTile.Extent;
% Change extent in the default 3D window
manager.scenes.Item(0).Camera.ViewExtent('Earth', extent);
manager.Render();

Camera view object with offset

[MATLAB]

% IAgSatellite satellite: Satellite object
% IAgScenario scenario: Scenario object
axes = satellite.Vgt.Axes.Item('TopoCentric');
point = satellite.Vgt.Points.Item('Center');
offset = {0.0975; 0.0279; 0.0273};
upDirection = {-0.0906; -0.6908; 0.7173};

manager = scenario.SceneManager;
camera = manager.scenes.Item(0).Camera;
camera.ViewOffsetWithUpAxis(axes , point, offset, upDirection);
camera.ConstrainedUpAxis	= 'eStkGraphicsConstrainedUpAxisZ';
camera.FieldOfView = deg2rad(45);
camera.LockViewDirection = false;
manager.Render();

Change camera reference frame

[MATLAB]

% IAgScenario scenario: Scenario object
% IAgStkObjectRoot root: STK Object Model Root
manager = scenario.SceneManager;
manager.scenes.Item(0).Camera.ViewCentralBody('Earth', root.CentralBodies.Earth.Vgt.Axes.Item('Fixed'));
manager.Render();

STK Graphics Primitives	Send comments on this topic.
IAgStkGraphicsCamera Interface