Sophie

Sophie

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

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

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
<html><head><title>OpenRM - RM Library (rmclip.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="rmClipPlaneNew"> 
<pre><b>
 RMclipPlane * rmClipPlaneNew (void)
</b></pre>
<pre>
 no arguments.
</pre>
<menu><P>
 Creates a new RMclipPlane object, returning a handle to the new
 RMclipPlane object upon success, or NULL upon failure.
</P>
<P>
 The new RMclipPlane object is initialized with the following default
 values:
</P>
<P>
 1. The RMclipPlane object is disabled.
</P>
<P>
 2. Default point: (RM_DEFAULT_CLIP_PLANE_POINT) {0.,0.,0.}
</P>
<P>
 3. Default normal: (RM_DEFAULT_CLIP_PLANE_NORMAL) {0., 0., -1.}
</P>
<P>
 Applications should use rmClipPlaneDelete to release resources
 associated with the RMclipPlane object when no longer needed.
</P>
<P>
 To have the clip plane used during rendering, it needs to be
 activated (rmClipPlaneEnable), assigned whatever values you want for
 the point and normal attributes (normalized normals, please) and then
 assigned as a scene parameter to an RMnode with
 rmNodeSetSceneClipPlane.
</P></menu>
<i>librm library source file: rmclip.c </i><hr width="75%">
<a name="rmClipPlaneDelete"> 
<pre><b>
 RMenum rmClipPlaneDelete (RMclipPlane *toDelete)
</b></pre>
<pre>
 RMclipPlane *toDelete - a handle to the RMclipPlane object to be
    deleted. 
</pre>
<menu><P>
 This routine releases RMclipPlane resources, the opposite of
 rmClipPlaneNew.
</P>
<P>
 Upon success, RM_CHILL is returned and the rmclipPlance has been
 deleted.  Otherwise, RM_WHACKED is returned.
</P></menu>
<i>librm library source file: rmclip.c </i><hr width="75%">
<a name="rmClipPlaneSetPointNormal"> 
<pre><b>
 RMenum rmClipPlaneSetPointNormal (RMclipPlane *toModify,
			           const RMvertex3D *point,
				   const RMvertex3D *normal)
</b></pre>
<pre>
 RMclipPlane *toModify - a handle to an RMclipPlane object that will
    be modified (input and result).

 RMvertex3D *point - a handle to a caller supplied RMvertex3D object.
    The contents of the caller's "point" value will be copied into the
    RMclipPlane's "point" attribute.

 RMvertex3D *normal - a handle to a caller supplied RMvertex3D object.
    The contents of the caller's "normal" value will be copied into
    the RMclipPlane's "normal" attribute.
</pre>
<menu><P>
 A clipping plane in OpenRM is defined with two parameters, a 3D point
 and a normal.
</P>
<P>
 Use this routine to set these parameters in an RMclipPlane object.
</P></menu>
<i>librm library source file: rmclip.c </i><hr width="75%">
<a name="rmClipPlaneGetPointNormal"> 
<pre><b>
 RMenum rmClipPlaneGetPointNormal (const RMclipPlane *toQuery,
			           RMvertex3D *point,
				   RMvertex3D *normal)
</b></pre>
<pre>
 const RMclipPlane *toQuery - a handle to an RMclipPlane object that
    will be queried (input).

 RMvertex3D *point - a handle to a caller supplied RMvertex3D object.
    The RMclipPlane's "point" attribute will be copied into this
    object (result).

 RMvertex3D *normal - a handle to a caller supplied RMvertex3D object.
    The RMclipPlane's "normal" attribute will be copied into this
    object (result). 
</pre>
<menu><P>
 A clipping plane in OpenRM is defined with two parameters, a 3D point
 and a normal.
</P>
<P>
 Use this routine to obtain these parameters from an RMclipPlane
 object.
</P></menu>
<i>librm library source file: rmclip.c </i><hr width="75%">
<a name="rmClipPlaneEnable"> 
<pre><b>
 RMenum rmClipPlaneEnable (RMclipPlane *toModify)
</b></pre>
<pre>
 RMclipPlane *toModify - a handle to an RMclipPlane object. This
    object will be modified by this routine.
</pre>
<menu><P>
 Use this routine to "turn on" a clipping plane.
</P>
<P>
 Clipping planes are scene parameters assigned to RMnodes. Upon
 assignment, OpenRM makes a copy of the caller-supplied RMclipPlane
 object. Any application changes to the RMclipPlane object do not
 affect the copy of the RMclipPlane at the RMnode: after making
 changes, the RMclipPlane object must be reassigned to the RMnode as a
 scene parameter (see rmNodeSetSceneClipPlane()). Therefore, if the
 application maintains it's own internal array of clipping planes, any
 changes to the application RMclipPlane objects should be propogated
 to OpenRM with rmNodeSetSceneClipPlane, including deactivation.
</P>
<P>
 See also rmClipPlaneNew(). 
</P></menu>
<i>librm library source file: rmclip.c </i><hr width="75%">
<a name="rmClipPlaneDisable"> 
<pre><b>
 RMenum rmClipPlaneDisable (RMclipPlane *toModify)
</b></pre>
<pre>
 RMclipPlane *toModify - a handle to an RMclipPlane object. This
    object will be modified by this routine. 
</pre>
<menu><P>
 Use this routine to "turn off" a clipping plane.
</P>
<P>
 Clipping planes are scene parameters assigned to RMnodes. Upon
 assignment, OpenRM makes a copy of the caller-supplied RMclipPlane
 object. Any application changes to the RMclipPlane object do not
 affect the copy of the RMclipPlane at the RMnode: after making
 changes, the RMclipPlane object must be reassigned to the RMnode as a
 scene parameter (see rmNodeSetSceneClipPlane()). Therefore, if the
 application maintains it's own internal array of clipping planes, any
 changes to the application RMclipPlane objects should be propogated
 to OpenRM with rmNodeSetSceneClipPlane, including deactivation.
</P>
<P>
 Applications may deactivate a clip plane by either 1. calling this
 routine to set an RMclipPlane's active attribute to "off" and then
 propogating the modified RMclipPlane to a scene graph node with
 rmNodeSetSceneClipPlane, or 2. by removing the clip plane from a
 scene graph node by calling rmNodeSetSceneClipPlane with NULL as the
 value for the RMclipPlane parameter.
</P></menu>
<i>librm library source file: rmclip.c </i><hr width="75%">
<a name="rmClipPlaneIsEnabled"> 
<pre><b>
 RMenum rmClipPlaneIsEnabled (const RMclipPlane *toQuery)
</b></pre>
<pre>
 const RMclipPlane *toQuery
</pre>
<menu><P>
 This routine is will return to the caller RM_TRUE if the RMclipPlane
 object is "enabled", or RM_FALSE if the RMclipPlane object is
 disabled. RM_WHACKED is returned if the RMclipPlane object is NULL.
</P></menu>
<i>librm library source file: rmclip.c </i><hr width="75%">
</body></html>

Perl :: Catalyst :: PostgreSQL :: RPM Valid HTML 4.01 Transitional