r3camera
real/objects/r3camera.h
r3obj
Camera object.
r3Level
R3CLID_LEVEL
r3Camera
R3CLID_CAMERA - 332
RENDERLENSFLARE, FINDCURRENT, TRANSLATESELECTEDPOIN, SETPOINTLOCAL, GETPOINTLOCAL,
Position, Direction, Up, AspectRatio, CoordSys, FilmWidth, FilmHeight, Angle, Projection, FilmSensitivity, AutoExposure, DepthOfField, FocalLength, Fstop, FocusingDistance, LensFlare, Flash, IsCurrent, Scale, SafeWidth, SafeHeight, NoVertPersp, Side, From, To,
int R3RegisterCameraClass(R3APP *app);
super
R3CAMM_RENDERLENSFLARE
RENDERLENSFLARE
R3CAMM_RENDERLENSFLARE
obj.RENDERLENSFLARE();
R3CAMM_FINDCURRENT
FINDCURRENT
R3CAMM_FINDCURRENT
obj.FINDCURRENT();
R3CAMM_TRANSLATESELECTEDPOIN
TRANSLATESELECTEDPOIN
R3CAMM_TRANSLATESELECTEDPOIN
R3VECTOR, translate delta is absolute space
obj.TRANSLATESELECTEDPOIN(p3);
changes the object space
R3CAMM_SETPOINTLOCAL
SETPOINTLOCAL
R3CAMM_SETPOINTLOCAL
R3BOOL, true if succeeded
R3INT, index of the point to be set (see CAMP_ codes below)
R3VECTOR, point in object space
rc = obj.SETPOINTLOCAL(p1, p3);
Low level set point.
R3CAMM_GETPOINTLOCAL
GETPOINTLOCAL
R3CAMM_GETPOINTLOCAL
R3BOOL, true if succeeded
R3INT, index of the point to be set (see CAMP_ codes below)
R3VECTOR, point in object space
rc = obj.GETPOINTLOCAL(p1, p3);
Low level get point.
Position
Position
R3CAMA_Position
position of the camera
jsobj.SetPosition(value);
value = jsobj.GetPosition();
R3VECTOR value = ...;
R3SetAttrs(r3obj, R3CAMA_Position, value, R3TAG_END);
R3VECTOR value;
R3GetAttrs(r3obj, R3CAMA_Position, &value, R3TAG_END);
Direction
Direction
R3CAMA_Direction
point in abs. space, camera points to this point
jsobj.SetDirection(value);
value = jsobj.GetDirection();
R3VECTOR value = ...;
R3SetAttrs(r3obj, R3CAMA_Direction, value, R3TAG_END);
R3VECTOR value;
R3GetAttrs(r3obj, R3CAMA_Direction, &value, R3TAG_END);
Up
Up
R3CAMA_Up
3d point pointing up and defining aspect ratio
jsobj.SetUp(value);
value = jsobj.GetUp();
R3VECTOR value = ...;
R3SetAttrs(r3obj, R3CAMA_Up, value, R3TAG_END);
R3VECTOR value;
R3GetAttrs(r3obj, R3CAMA_Up, &value, R3TAG_END);
AspectRatio
AspectRatio
R3CAMA_AspectRatio
Number
R3FLOAT
image height/width
jsobj.SetAspectRatio(value);
value = jsobj.GetAspectRatio();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_AspectRatio, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_AspectRatio, &value, R3TAG_END);
CoordSys
CoordSys
R3CAMA_CoordSys
axes are unit vectors, defines complete camera orientation
jsobj.SetCoordSys(value);
value = jsobj.GetCoordSys();
R3COORDSYS* value = ...;
R3SetAttrs(r3obj, R3CAMA_CoordSys, value, R3TAG_END);
R3COORDSYS* value;
R3GetAttrs(r3obj, R3CAMA_CoordSys, &value, R3TAG_END);
FilmWidth
FilmWidth
R3CAMA_FilmWidth
Number
R3FLOAT
film dimensions define image aspect & camera opening angle
jsobj.SetFilmWidth(value);
value = jsobj.GetFilmWidth();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_FilmWidth, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_FilmWidth, &value, R3TAG_END);
FilmHeight
FilmHeight
R3CAMA_FilmHeight
Number
R3FLOAT
jsobj.SetFilmHeight(value);
value = jsobj.GetFilmHeight();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_FilmHeight, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_FilmHeight, &value, R3TAG_END);
Angle
Angle
R3CAMA_Angle
Number
R3FLOAT
view opening angle
jsobj.SetAngle(value);
value = jsobj.GetAngle();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_Angle, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_Angle, &value, R3TAG_END);
Projection
Projection
R3CAMA_Projection
Integer
R3INT
see R3CAMP_ codes below
jsobj.SetProjection(value);
value = jsobj.GetProjection();
R3INT value = ...;
R3SetAttrs(r3obj, R3CAMA_Projection, value, R3TAG_END);
R3INT value;
R3GetAttrs(r3obj, R3CAMA_Projection, &value, R3TAG_END);
FilmSensitivity
FilmSensitivity
R3CAMA_FilmSensitivity
Number
R3FLOAT
acts like brightness
jsobj.SetFilmSensitivity(value);
value = jsobj.GetFilmSensitivity();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_FilmSensitivity, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_FilmSensitivity, &value, R3TAG_END);
AutoExposure
AutoExposure
R3CAMA_AutoExposure
Boolean
R3BOOL
not used
jsobj.SetAutoExposure(value);
value = jsobj.GetAutoExposure();
R3BOOL value = ...;
R3SetAttrs(r3obj, R3CAMA_AutoExposure, value, R3TAG_END);
R3BOOL value;
R3GetAttrs(r3obj, R3CAMA_AutoExposure, &value, R3TAG_END);
DepthOfField
DepthOfField
R3CAMA_DepthOfField
Boolean
R3BOOL
jsobj.SetDepthOfField(value);
value = jsobj.GetDepthOfField();
R3BOOL value = ...;
R3SetAttrs(r3obj, R3CAMA_DepthOfField, value, R3TAG_END);
R3BOOL value;
R3GetAttrs(r3obj, R3CAMA_DepthOfField, &value, R3TAG_END);
FocalLength
FocalLength
R3CAMA_FocalLength
Number
R3FLOAT
jsobj.SetFocalLength(value);
value = jsobj.GetFocalLength();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_FocalLength, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_FocalLength, &value, R3TAG_END);
Fstop
Fstop
R3CAMA_Fstop
Number
R3FLOAT
jsobj.SetFstop(value);
value = jsobj.GetFstop();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_Fstop, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_Fstop, &value, R3TAG_END);
FocusingDistance
FocusingDistance
R3CAMA_FocusingDistance
Number
R3FLOAT
jsobj.SetFocusingDistance(value);
value = jsobj.GetFocusingDistance();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_FocusingDistance, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_FocusingDistance, &value, R3TAG_END);
LensFlare
LensFlare
R3CAMA_LensFlare
String
char*
if not NULL flares are rendered using effect defined by this name
jsobj.SetLensFlare(value);
value = jsobj.GetLensFlare();
char* value = ...;
R3SetAttrs(r3obj, R3CAMA_LensFlare, value, R3TAG_END);
char* value;
R3GetAttrs(r3obj, R3CAMA_LensFlare, &value, R3TAG_END);
Flash
Flash
R3CAMA_Flash
color of automatic flash associated with camera
jsobj.SetFlash(value);
value = jsobj.GetFlash();
R3FLOATCOLOR3 value = ...;
R3SetAttrs(r3obj, R3CAMA_Flash, value, R3TAG_END);
R3FLOATCOLOR3 value;
R3GetAttrs(r3obj, R3CAMA_Flash, &value, R3TAG_END);
IsCurrent
IsCurrent
R3CAMA_IsCurrent
Boolean
R3BOOL
current camera
jsobj.SetIsCurrent(value);
value = jsobj.GetIsCurrent();
R3BOOL value = ...;
R3SetAttrs(r3obj, R3CAMA_IsCurrent, value, R3TAG_END);
R3BOOL value;
R3GetAttrs(r3obj, R3CAMA_IsCurrent, &value, R3TAG_END);
Scale
Scale
R3CAMA_Scale
Number
R3FLOAT
1.0/width of visible area at 1.0 distance
jsobj.SetScale(value);
value = jsobj.GetScale();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_Scale, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_Scale, &value, R3TAG_END);
SafeWidth
SafeWidth
R3CAMA_SafeWidth
Number
R3FLOAT
0..1, part of cam view width that is safely visible (default 1.0)
jsobj.SetSafeWidth(value);
value = jsobj.GetSafeWidth();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_SafeWidth, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_SafeWidth, &value, R3TAG_END);
SafeHeight
SafeHeight
R3CAMA_SafeHeight
Number
R3FLOAT
0..1, part of cam view height that is safely visible (default 1.0)
jsobj.SetSafeHeight(value);
value = jsobj.GetSafeHeight();
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3CAMA_SafeHeight, value, R3TAG_END);
R3FLOAT value;
R3GetAttrs(r3obj, R3CAMA_SafeHeight, &value, R3TAG_END);
NoVertPersp
NoVertPersp
R3CAMA_NoVertPersp
Boolean
R3BOOL
eliminate vertical perspective
jsobj.SetNoVertPersp(value);
value = jsobj.GetNoVertPersp();
R3BOOL value = ...;
R3SetAttrs(r3obj, R3CAMA_NoVertPersp, value, R3TAG_END);
R3BOOL value;
R3GetAttrs(r3obj, R3CAMA_NoVertPersp, &value, R3TAG_END);
Side
Side
R3CAMA_Side
3d point pointing sideways and defining viewing angle
jsobj.SetSide(value);
value = jsobj.GetSide();
R3VECTOR value = ...;
R3SetAttrs(r3obj, R3CAMA_Side, value, R3TAG_END);
R3VECTOR value;
R3GetAttrs(r3obj, R3CAMA_Side, &value, R3TAG_END);
From
From
R3CAMA_From
from point, setting this rotates geometry about 'to' point
jsobj.SetFrom(value);
value = jsobj.GetFrom();
R3VECTOR value = ...;
R3SetAttrs(r3obj, R3CAMA_From, value, R3TAG_END);
R3VECTOR value;
R3GetAttrs(r3obj, R3CAMA_From, &value, R3TAG_END);
To
To
R3CAMA_To
to point, setting this rotates everything about 'from' point
jsobj.SetTo(value);
value = jsobj.GetTo();
R3VECTOR value = ...;
R3SetAttrs(r3obj, R3CAMA_To, value, R3TAG_END);
R3VECTOR value;
R3GetAttrs(r3obj, R3CAMA_To, &value, R3TAG_END);
Point index idewntifires for PRIMM_SETPOINT
Projections
r3appobj *