Aero.Camera Class

Namespace: Aero

Construct camera object for use with animation object

Description

The Aero.Camera object follows the trajectory of an Aero.Body object. The camera object uses the registered coordinate transform, which by default is an aerospace body coordinate system. Axes of custom coordinate systems must be orthogonal.

By default, an Aero.Body object natively uses aircraft x-y-z coordinates for the body geometry and the time series data. Convert time series data from other coordinate systems on the fly by registering a different CoordTransformFcn function.

The Aero.Camera class is a handle class.

Class Attributes

Abstract	false
ConstructOnLoad	false
HandleCompatible	true
Hidden	false
Sealed	false
RestrictsSubclassing	false

For information on class attributes, see Class Attributes.

Creation

Description

h = Aero.Camera constructs a camera object, h, for use with an animation object.

Output Arguments

h — Camera object

Aero.Camera object

Camera object, returned as an Aero.Camera object.

Properties

CoordTransformFcn — Function that controls coordinate transformation

@nullCoordTransform (default) | function handle name

Function that controls coordinate transformation, specified as a function handle name.

Example: h.Camera.CoordTransformFcn=@newCoordTransform

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

Data Types: string | char

PositionFcn — Function that controls position of camera relative to animation body

@doFirstOrderChaseCameraDynamics (default) | function handle name

Function that controls coordinate transformation, specified as a function handle name.

Example: h.Camera.PositionFcn=@newCameraPosition

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

Data Types: string | char

Position — Camera position relative to animation body

[-150,-50,0] (default) | MATLAB^® array

Camera position relative to animation body, specified as a MATLAB array.

Example: h.Camera.Position=[-150,-50,0]

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

Offset — Camera offset

[-150,-50,0] (default) | MATLAB array

Camera offset, specified as a MATLAB array.

Example: h.Camera.Offset=[-150,-50,0]

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

AimPoint — Camera aim point

[0 0 0] (default) | MATLAB array

Camera aim point, specified as a MATLAB array.

Example: h.Camera.AimPoint=[0 0 0]

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

UpVector — Camera up vector

[0,0,-1] (default) | MATLAB array

Camera up vector, specified as a MATLAB array.

Example: h.Camera.UpVector=[0 0 0]

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

ViewAngle — Camera view angle

3 (default) | real scalar integer | MATLAB array

Camera view angle, specified as a real scalar integer or MATLAB array.

Example: h.Camera.ViewAngle=5

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

ViewExtent — Camera view extent

[-50,50] (default) | MATLAB array

Camera view extent, specified as a MATLAB array.

Example: h.Camera.ViewExtent=[-50,50]

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

xlim — Camera x-axis limit

[-50,50] (default) | MATLAB array

Camera x-axis limit, specified as a MATLAB array.

Example: h.Camera.xlim=[-50,50]

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

ylim — Camera y-axis limit

[-50,50] (default) | MATLAB array

Camera y-axis limit, specified as a MATLAB array.

Example: h.Camera.ylim=[-50,50]

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

zlim — Camera z-axis limit

[-50,50] (default) | MATLAB array

Camera z-axis limit, specified as a MATLAB array.

Example: h.Camera.zlim=[-50,50]

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

PrevTime — Camera previous time

0 (default) | real scalar integer | MATLAB array

Camera previous time, specified as a real scalar integer or MATLAB array.

Example: h.Camera.PrevTime=0

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

UserData — Custom data

[] (default) | real scalar integer | MATLAB array

Custom data, specified as a real scalar integer or MATLAB array.

Example: h.Camera.UserData=[1]

Attributes:

GetAccess	public
SetAccess	public
Transient	true
SetObservable	true
HasDefault	true

Methods

Public Methods

update

Update camera position based on time and position of other Aero.Body objects

Version History

Introduced in R2007a