Set or query the camera up vector
Syntax
camup
camup([up_vector])
camup('mode')
camup('auto')
camup('manual')
camup(axes_handle,...)
Description
The camera up vector specifies the direction that is oriented up in the scene.
camup
with no arguments returns the camera up vector setting in the current axes.
camup([up_vector])
sets the up vector in the current axes to the specified value. Specify the up vector as x-, y-, and z-components. See Remarks.
camup('mode')
returns the current value of the camera up vector mode, which can be either auto
(the default) or manual
.
camup('auto')
sets the camera up vector mode to auto
. In auto
mode, MATLAB uses a value for the up vector of [0 1 0]
for 2-D views. This means the z-axis points up.
camup('manual')
sets the camera up vector mode to manual
. In manual
mode, MATLAB does not change the value of the camera up vector.
camup(axes_handle,...)
performs the set or query on the axes identified by the first argument, axes_handle
. When you do not specify an axes handle, camup
operates on the current axes.
Remarks
camup
sets or queries values of the Axes object CameraUpVector
and CameraUpVectorMode
properties.
Specify the camera up vector as the x-, y-, and z-coordinates of a point in the axes coordinate system that forms the directed line segment PQ, where P is the point (0,0,0) and Q is the specified x-, y-, and z-coordinates. This line always points up. The length of the line PQ has no effect on the orientation of the scene. This means a value of [0 0 1]
produces the same results as [0 0 25]
.
See Also
axis
, camproj
, campos
, camtarget
, camva
The Axes properties CameraPosition
, CameraTarget
, CameraUpVector
, CameraViewAngle
, Projection
The "Camera Properties" section in the Using MATLAB Graphics manual.
[ Previous | Help Desk | Next ]