r3rensys
real/raytr/r3rensys.h
r3raytr
General Rendering System Class
r3Model
R3CLID_MODEL
r3Rensys
R3CLID_RENSYS - 439
INSERT, WORLDTRANSFORMED, LIBRARYCHANGED, OBJECTSREADY, CAMERAREADY, TOTALOUTPUT, ENUMNEEDEDCHANNELS, CLEAROUTPUT, UNREGISTERFIRST, CLEANUP,
ModelView, CameraSpace, RecursionTreshold, XExtend, YExtend, XExtendRel, YExtendRel, IsActive, VolumeSampling, IsChanged, InterpolateUnderSample, VolumeShadows, ChannelMapper, FocusingDistance, FStop, DepthOfField, HorizontalScaling, VerticalScaling, RenderInput, OutputList, RamUsePolicy, ErrorMsg,
int R3RegisterRenSysClass(R3APP *app);
R3REM_INSERT
INSERT
R3REM_INSERT
obj.INSERT();
R3REM_WORLDTRANSFORMED
WORLDTRANSFORMED
R3REM_WORLDTRANSFORMED
obj.WORLDTRANSFORMED();
R3REM_LIBRARYCHANGED
LIBRARYCHANGED
R3REM_LIBRARYCHANGED
obj.LIBRARYCHANGED();
R3REM_OBJECTSREADY
OBJECTSREADY
R3REM_OBJECTSREADY
obj.OBJECTSREADY();
R3REM_CAMERAREADY
CAMERAREADY
R3REM_CAMERAREADY
obj.CAMERAREADY();
R3REM_TOTALOUTPUT
TOTALOUTPUT
R3REM_TOTALOUTPUT
obj.TOTALOUTPUT();
R3REM_ENUMNEEDEDCHANNELS
ENUMNEEDEDCHANNELS
R3REM_ENUMNEEDEDCHANNELS
R3OBJ*, retobj
R3INT, retmth
obj.ENUMNEEDEDCHANNELS(p1, p3);
enumerate all raysample channels that are needed * by sending R3SendMsgA(retobj, retmth, channelname) *
R3REM_CLEAROUTPUT
CLEAROUTPUT
R3REM_CLEAROUTPUT
obj.CLEAROUTPUT();
unregisters all outputs
R3REM_UNREGISTERFIRST
UNREGISTERFIRST
R3REM_UNREGISTERFIRST
obj.UNREGISTERFIRST();
unregisters first item of output list and return its address
R3REM_CLEANUP
CLEANUP
R3REM_CLEANUP
obj.CLEANUP();
rendering pipeline is done, free buffers etc.
ModelView
ModelView
R3REA_ModelView
projection matrix
jsobj.SetModelView(value);
R3MATRIX value = ...;
R3SetAttrs(r3obj, R3REA_ModelView, &value, R3TAG_END);
CameraSpace
CameraSpace
R3REA_CameraSpace
camera space matrix
jsobj.SetCameraSpace(value);
R3MATRIX value = ...;
R3SetAttrs(r3obj, R3REA_CameraSpace, &value, R3TAG_END);
RecursionTreshold
RecursionTreshold
R3REA_RecursionTreshold
Number
R3FLOAT
0..1, defines min signal that triggers recursions
jsobj.SetRecursionTreshold(value);
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3REA_RecursionTreshold, value, R3TAG_END);
XExtend
XExtend
R3REA_XExtend
Integer
R3INT
number of pixels. Max area defined by XExtend and XExtendRel is rendered
value = jsobj.GetXExtend();
R3INT value;
R3GetAttrs(r3obj, R3REA_XExtend, &value, R3TAG_END);
YExtend
YExtend
R3REA_YExtend
Integer
R3INT
'R3REA_YExtend' not documented
value = jsobj.GetYExtend();
R3INT value;
R3GetAttrs(r3obj, R3REA_YExtend, &value, R3TAG_END);
XExtendRel
XExtendRel
R3REA_XExtendRel
Number
R3FLOAT
proportion extension width/image width
value = jsobj.GetXExtendRel();
R3FLOAT value;
R3GetAttrs(r3obj, R3REA_XExtendRel, &value, R3TAG_END);
YExtendRel
YExtendRel
R3REA_YExtendRel
Number
R3FLOAT
'R3REA_YExtendRel' not documented
value = jsobj.GetYExtendRel();
R3FLOAT value;
R3GetAttrs(r3obj, R3REA_YExtendRel, &value, R3TAG_END);
IsActive
IsActive
R3REA_IsActive
Integer
R3INT
TRUE if rendering system will render
jsobj.SetIsActive(value);
value = jsobj.GetIsActive();
R3INT value = ...;
R3SetAttrs(r3obj, R3REA_IsActive, value, R3TAG_END);
R3INT value;
R3GetAttrs(r3obj, R3REA_IsActive, &value, R3TAG_END);
VolumeSampling
VolumeSampling
R3REA_VolumeSampling
Boolean
R3BOOL
if TRUE then volume effects computed
jsobj.SetVolumeSampling(value);
R3BOOL value = ...;
R3SetAttrs(r3obj, R3REA_VolumeSampling, value, R3TAG_END);
IsChanged
IsChanged
R3REA_IsChanged
Boolean
R3BOOL
TRUE if any data that causes re-rendering is changed since last rendering (read only)
value = jsobj.GetIsChanged();
R3BOOL value;
R3GetAttrs(r3obj, R3REA_IsChanged, &value, R3TAG_END);
InterpolateUnderSample
InterpolateUnderSample
R3REA_InterpolateUnderSample
Boolean
R3BOOL
if true the under sample block interior interpolated
jsobj.SetInterpolateUnderSample(value);
R3BOOL value = ...;
R3SetAttrs(r3obj, R3REA_InterpolateUnderSamples, value, R3TAG_END);
VolumeShadows
VolumeShadows
R3REA_VolumeShadows
Boolean
R3BOOL
if true then compute shadows casted by fog
jsobj.SetVolumeShadows(value);
R3BOOL value = ...;
R3SetAttrs(r3obj, R3REA_VolumeShadows, value, R3TAG_END);
ChannelMapper
ChannelMapper
R3REA_ChannelMapper
Object
R3OBJ*
1 wide raysample prototype object. Render systems can get current channel configuration by studying/copying this object. The channel configuration changes are reported by R3REM_LIBRARYCHANGED message where p1 parameter is R3CLID_CHANNEL
jsobj.SetChannelMapper(value);
R3OBJ* value = ...;
R3SetAttrs(r3obj, R3REA_ChannelMapper, value, R3TAG_END);
FocusingDistance
FocusingDistance
R3REA_FocusingDistance
Number
R3FLOAT
camera property
jsobj.SetFocusingDistance(value);
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3REA_FocusingDistance, value, R3TAG_END);
FStop
FStop
R3REA_FStop
Number
R3FLOAT
camera property
jsobj.SetFStop(value);
R3FLOAT value = ...;
R3SetAttrs(r3obj, R3REA_FStop, value, R3TAG_END);
DepthOfField
DepthOfField
R3REA_DepthOfField
Boolean
R3BOOL
switches dof effect on
jsobj.SetDepthOfField(value);
R3BOOL value = ...;
R3SetAttrs(r3obj, R3REA_DepthOfField, value, R3TAG_END);
HorizontalScaling
HorizontalScaling
R3REA_HorizontalScaling
Number
R3FLOAT
read only - horiz. image resolution change ratio outw/inw
value = jsobj.GetHorizontalScaling();
R3FLOAT value;
R3GetAttrs(r3obj, R3REA_HorizontalScaling, &value, R3TAG_END);
VerticalScaling
VerticalScaling
R3REA_VerticalScaling
Number
R3FLOAT
read only - vert. image resolution change ratio outh/inh
value = jsobj.GetVerticalScaling();
R3FLOAT value;
R3GetAttrs(r3obj, R3REA_VerticalScaling, &value, R3TAG_END);
RenderInput
RenderInput
R3REA_RenderInput
Object
R3OBJ*
an output object that inputs data into the render system
value = jsobj.GetRenderInput();
R3OBJ* value;
R3GetAttrs(r3obj, R3REA_RenderInput, &value, R3TAG_END);
OutputList
OutputList
R3REA_OutputList
r3List
R3LIST*
R3LIST * (read only), the list of currently registered outputs
value = jsobj.GetOutputList();
R3LIST* value;
R3GetAttrs(r3obj, R3REA_OutputList, &value, R3TAG_END);
RamUsePolicy
RamUsePolicy
R3REA_RamUsePolicy
Integer
R3INT
memory use policy (0 = select best mode, 1=use carelessly, 2=spare some, 3=spare even more etc)
jsobj.SetRamUsePolicy(value);
value = jsobj.GetRamUsePolicy();
R3INT value = ...;
R3SetAttrs(r3obj, R3REA_RamUsePolicy, value, R3TAG_END);
R3INT value;
R3GetAttrs(r3obj, R3REA_RamUsePolicy, &value, R3TAG_END);
ErrorMsg
ErrorMsg
R3REA_ErrorMsg
String
char*
read only message, explains why rendering failed
value = jsobj.GetErrorMsg();
char* value;
R3GetAttrs(r3obj, R3REA_ErrorMsg, &value, R3TAG_END);
Codes for Projection tag
Antialias modes
Return codes for REM_RENDER