| AttributeName |
Get |
Set |
Fcrvs |
AttributeType |
Description |
| AspectRatio |
Y |
Y |
N |
float |
(Also referred to as Picture Format.) Constants for common camera aspect ratios are
defined in SAA_consts.h: SAA_FMT_35MM_137
SAA_FMT_35MM_166
SAA_FMT_35MM_185
SAA_FMT_70MM_PANAVISION
SAA_FMT_70MM_IMAX
SAA_FMT_70MM_OMNIMAX
SAA_FMT_NTSC
SAA_FMT_PAL
SAA_FMT_HDTV
SAA_FMT_SLIDE_35MM
SAA_FMT_6CM_X_6CM
SAA_FMT_6CM_X_9CM
SAA_FMT_4IN_X_5IN
SAA_FMT_DEFAULT
SAA_FMT_SQUARE |
| AutoFieldOfView |
Y |
Y |
N |
SAA_Boolean |
Automatic camera lens setting. To set a custom camera angle, set AutoFieldOfView to
FALSE and set FieldOfView to the custom angle. |
| Coc |
Y |
Y |
cmfcoc |
float |
Maximum circle of confusion (COC) value. Controls the out-of-focus effect in terms of
pixels. The higher the value, the more out of focus the object. See also the OutOfFocus
attribute. |
| DepthOfFieldType |
Y |
Y |
N |
SAA_CamDofType |
Type of depth of field simulation: SAA_CAMDOF_OFF
SAA_CAMDOF_AUTO
SAA_CAMDOF_CUSTOM |
| FStop |
Y |
Y |
cmfstp |
float |
Size of the aperture opening. |
| Far |
Y |
Y |
cmfar |
float |
(Far Plane) Distance from camera where objects stop being visible. |
| FarFocus |
Y |
Y |
cmfffc |
float |
Farthest distance (in system units) from the camera where objects are in focus. |
| FieldOfView |
Y |
Y |
cmfov |
float |
Camera angle in degrees (corresponds to the Custom Angle text box in the Camera
Settings dialog). |
| FocalLength |
Y |
Y |
cmffcl |
float |
Length (mm) of the camera lens. |
| Interest |
Y |
Y |
cmietx cmiety
cmietz |
float float
float |
Position of the camera interest in x, y, and z coordinates. SW returns this as a
list: (X Y Z) |
| Near |
Y |
Y |
cmnear |
float |
(Near Plane) Distance from camera where objects start to become visible. |
| NearFocus |
Y |
Y |
cmfnfc |
float |
Nearest distance (in system units) from the camera where objects are in focus. |
| OutOfFocus |
Y |
Y |
cmfout |
float |
Distance (in system units) from camera where the maximum COC occurs. |
| Position |
Y |
Y |
cmetnx cmetny
cmetnz |
float float
float |
Position of the camera in x, y, and z coordinates. SW returns this as a list: (X Y
Z) |
| ProjPlaneActive |
Y |
Y |
cmpact |
SAA_Boolean |
Enables (TRUE) and disables (FALSE) an off-axis/asymmetrical camera projection. The
other ProjPlan attributes apply only when ProjPlaneActive is TRUE. |
| ProjPlaneDistance |
Y |
Y |
cmpdst |
float |
Perpendicular distance from the camera to the projection plane. |
| ProjPlaneOffset |
Y |
Y |
cmpofx cmpofy |
float float |
X and Y offsets of the projection plane. SW returns this as a list: (X Y) |
| ProjPlaneSize |
Y |
Y |
cmpszx cmpszy |
float float |
Size of the projection plane. SW returns this as a list: (X Y) |
| Roll |
Y |
Y |
cmroll |
float |
Angle of lateral inclination of camera. |
| Visible |
Y |
Y |
camvis |
SAA_Boolean |
Determines whether the camera is visible (TRUE) or hidden (FALSE). |
Camera Attributes