Sophie

Sophie

distrib > Mandriva > 2007.0 > i586 > media > contrib-release > by-pkgid > 8079d983ecf371717db799dd75bd56c2 > files > 36

libopenrm1-1.5.2-2mdv2007.0.i586.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
<html><head><title>OpenRM - RM Library (rmrstate.c)</title></head>
<body bgcolor=white fgcolor=black>
<table width="100%" border=2 cellspacing=0 cellpadding=0 bgcolor="khaki" valign="center">
<th><img src="./images/ormsg.gif">
</th>
</table>
<spacer type=vertical size=15>
<h2>Index of OpenRM - RM Library</h2>
<spacer type=vertical size=15>
<a name="rmStateNew"> 
<pre><b>
 RMstate *rmStateNew (void)
</b></pre>
<pre>
 No arguments.
</pre>
<menu><P>
 Create and initialize an RMstate object, meaning that all RMstate
 matrices are set to the identity.  Upon success, a handle to the new
 RMstate is returned to the caller.  Otherwise, a NULL pointer is
 returned to the caller.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateDelete"> 
<pre><b>
 void rmStateDelete (RMstate *s)
</b></pre>
<pre>
 RMstate *s - a handle to the RMstate object to delete (modified).
</pre>
<menu><P>
 Frees the resources for an RMstate object.  No error checking is
 performed, so the result of deleting a non-object will be
 system-dependent (generllay this is something to avoid).
</P>
<P>
 No status is returned.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateCopy"> 
<pre><b>
 void rmStateCopy (const RMstate *s,
                   RMstate *d)
</b></pre>
<pre>
 const RMstate *s - a handle to the source RMstate (input).

 RMstate *d - a handle to the destination RMstate (modified).
</pre>
<menu><P>
 Copies the RMstate object s to the RMstate object d.  No error
 checking is performed, so the copy is only valid if s and d are valid
 RMstate objects.
</P>
<P>
 No status is returned.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateGetModelViewMatrix"> 
<pre><b>
 const RMmatrix *rmStateGetModelViewMatrix (const RMstate *toQuery)
</b></pre>
<pre>
 const RMstate *toQuery - a handle to an RMstate object (input).
</pre>
<menu><P>
 During a render-time traversal, the RMstate object reflects the
 current state of many rendering parameters as affected by nodes in
 the scene graph. The RMstate object is provided to node callback
 functions as a parameter. The rmStateGet*() family of routines can be
 used by developers to obtain current render state parameters.
</P>
<P>
 This routine is used to obtain a handle to the OpenGL "model-view"
 matrix.  The modelView matrix is the concatenation of model
 transformations with the view transformation defined by the current
 camera.
</P>
<P>
 The RMmatrix handle that is returned is "read only." NULL is returned
 if the input RMstate object is NULL.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateGetProjectionMatrix"> 
<pre><b>
 const RMmatrix *rmStateGetProjectionMatrix (const RMstate *toQuery)
</b></pre>
<pre>
 const RMstate *toQuery - a handle to an RMstate object (input).
</pre>
<menu><P>
 During a render-time traversal, the RMstate object reflects the
 current state of many rendering parameters as affected by nodes in
 the scene graph. The RMstate object is provided to node callback
 functions as a parameter. The rmStateGet*() family of routines can be
 used by developers to obtain current render state parameters.
</P>
<P>
 This routine is used to obtain a handle to the OpenGL "projection"
 matrix.  The projection matrix represents the transformation from eye
 coordinates to clip coordinates, typically defined only by 3D
 cameras.
</P>
<P>
 The RMmatrix handle that is returned is "read only." NULL is returned
 if the input RMstate object is NULL.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateGetShader"> 
<pre><b>
 RMenum rmStateGetShader(const RMstate *toQuery)
</b></pre>
<pre>
 const RMstate *toQuery - a handle to an RMstate object (input).
</pre>
<menu><P>
 Use this routine to obtain the shader attribute of an RMstate object.
 Upon success, one of the RM shade model enumerators is returned to the
 caller (RM_SHADER_SMOOTH, RM_SHADER_FLAT or RM_SHADER_NOLIGHT). Otherwise,
 RM_WHACKED is returned.
</P>
<P>
 This routine is intended to be used from inside application callback
 code, either node callbacks or application-defined RMprimitive draw
 routines.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateGetPolygonDrawMode"> 
<pre><b>
 RMenum rmStateGetPolygonDrawMode(const RMstate *toQuery,
		                  RMenum *whichFaceReturn,
				  RMenum *drawModeReturn)
</b></pre>
<pre>
 const RMstate *toQuery - a handle to an RMnode (input).
 RMenum *whichFaceReturn, *drawModeReturn - handles to caller-supplied
    RMenum's (result). A value of NULL is acceptable.
</pre>
<menu><P>
 Use this routine to query the render-time values for the polygon draw
 mode. See rmNodeSetPolygonDrawMode() for more details about these parameters.
 This routine is intended to be used from inside an application callback
 that would be attached to an RMnode, to be invoked during a render-time
 traversal of the scene graph.
</P>
<P>
 If the caller specifies NULL for one of the return parameters, that
 value will not be queried.
</P>
<P>
 RM_CHILL is returned upon success. Upon failure, RM_WHACKED is returned,
 and caller supplied memory remains unmodified.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateGetPolygonCullMode"> 
<pre><b>
 RMenum rmStateGetPolygonCullMode(const RMstate *toQuery,
				  RMenum *cullModeReturn)
</b></pre>
<pre>
 const RMstate *toQuery - a handle to an RMnode (input).
 RMenum *cullModeReturn - handles to caller-supplied
    RMenum's (result). A value of NULL is acceptable.
</pre>
<menu><P>
 Use this routine to query the render-time values for the polygon cull
 mode. See rmNodeSetPolygonCullMode() for more details about this parameter.
 This routine is intended to be used from inside an application callback
 that would be attached to an RMnode, to be invoked during a render-time
 traversal of the scene graph.
</P>
<P>
 If the caller specifies NULL for the return parameter, the polygon
 cull mode from the RMstate object will not be copied into caller-supplied
 memory.
</P>
<P>
 RM_CHILL is returned upon success. Upon failure, RM_WHACKED is returned,
 and caller supplied memory remains unmodified.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateGetFrontFace"> 
<pre><b>
 RMenum rmStateGetFrontFace(const RMstate *toQuery,
		            RMenum *frontFaceReturn)
</b></pre>
<pre>
 const RMstate *toQuery - a handle to an RMnode (input).
 RMenum *frontFaceReturn - a handle to a caller-supplied RMenum (result).
</pre>
<menu><P>
 Use this routine to query the render-time values for the polygon front
 face attribute. See rmNodeSetFrontFace() for more details about this
 parameter.  This routine is intended to be used from inside an
 application callback that would be attached to an RMnode, to be
 invoked during a render-time traversal of the scene graph.
</P>
<P>
 If the caller specifies NULL for the return parameter, the polygon
 front face mode from the RMstate object will not be copied into
 caller-supplied memory.
</P>
<P>
 RM_CHILL is returned upon success. Upon failure, RM_WHACKED is returned,
 and caller supplied memory remains unmodified.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateGetLineWidth"> 
<pre><b>
 RMenum rmStateGetLineWidth(const RMstate *toQuery,
		            RMenum *lineWidthReturn)
</b></pre>
<pre>
 const RMstate *toQuery - a handle to an RMnode (input).
 RMenum *lineStyleReturn - a handle to a caller-supplied RMenum (result).
</pre>
<menu><P>
 Use this routine to query the render-time values for the current
 line style attribute. See rmNodeSetLineWidth() for more details about this
 parameter.  This routine is intended to be used from inside an
 application callback that would be attached to an RMnode, to be
 invoked during a render-time traversal of the scene graph.
</P>
<P>
 Note that an RM line width enumerator is returned, not the actual pixel
 width of the lines.
</P>
<P>
 If the caller specifies NULL for the return parameter, the line style
 attribute from the RMstate object will not be copied into
 caller-supplied memory.
</P>
<P>
 RM_CHILL is returned upon success. Upon failure, RM_WHACKED is returned,
 and caller supplied memory remains unmodified.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateGetLineStyle"> 
<pre><b>
 RMenum rmStateGetLineStyle(const RMstate *toQuery,
		            RMenum *lineStyleReturn)
</b></pre>
<pre>
 const RMstate *toQuery - a handle to an RMnode (input).
 RMenum *lineStyleReturn - a handle to a caller-supplied RMenum (result).
</pre>
<menu><P>
 Use this routine to query the render-time values for the current
 line style attribute. See rmNodeSetLineStyle() for more details about this
 parameter.  This routine is intended to be used from inside an
 application callback that would be attached to an RMnode, to be
 invoked during a render-time traversal of the scene graph.
</P>
<P>
 If the caller specifies NULL for the return parameter, the line style
 attribute from the RMstate object will not be copied into
 caller-supplied memory.
</P>
<P>
 RM_CHILL is returned upon success. Upon failure, RM_WHACKED is returned,
 and caller supplied memory remains unmodified.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateGetPointSize"> 
<pre><b>
 RMenum rmStateGetPointSize(const RMstate *toQuery,
		            float *sizeReturn)
</b></pre>
<pre>
 const RMstate *toQuery - a handle to an RMnode (input).
 float *sizeReturn - a handle to a caller-supplied float (result).
</pre>
<menu><P>
 Use this routine to query the render-time values for the current
 point size attribute. See rmNodeSetPointSize() for more details about this
 parameter.  This routine is intended to be used from inside an
 application callback that would be attached to an RMnode, to be
 invoked during a render-time traversal of the scene graph.
</P>
<P>
 If the caller specifies NULL for the return parameter, the point size
 attribute from the RMstate object will not be copied into
 caller-supplied memory.
</P>
<P>
 RM_CHILL is returned upon success. Upon failure, RM_WHACKED is returned,
 and caller supplied memory remains unmodified.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
<a name="rmStateGetFrameNumber"> 
<pre><b>
 int rmStateGetFrameNumber(const RMstate *toQuery)
</b></pre>
<pre>
 const RMstate *toQuery - a handle to an RMstate object.
</pre>
<menu><P>
 Use this routine to query the render-time frame number from the RMstate
 object "toQuery." This routine is intended to be used by application-
 supplied render- or view-traversal callback routines in order to
 implement operations that are a function of the current frame number.
</P></menu>
<i>librm library source file: rmrstate.c </i><hr width="75%">
</body></html>