OpenSceneGraph/doc/doc++/osg/Stencil.html

331 lines
15 KiB
HTML
Raw Normal View History

2001-09-20 05:19:47 +08:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>class SG_EXPORT osg::Stencil</TITLE>
<META NAME="GENERATOR" CONTENT="DOC++ 3.4.8">
</HEAD>
<BODY BGCOLOR="#ffffff">
<H2>class SG_EXPORT <A HREF="#DOC.DOCU">osg::Stencil</A></H2></H2><BLOCKQUOTE>Encapsulte OpenGL glStencilFunc/Op/Mask functions</BLOCKQUOTE>
<HR>
<H2>Inheritance:</H2>
<APPLET CODE="ClassGraph.class" WIDTH=600 HEIGHT=125>
<param name=classes value="CReferenced,MReferenced.html,CObject,MObject.html,CStateAttribute,MStateAttribute.html,CStencil,MStencil.html">
<param name=before value="M,M,M,M">
<param name=after value="Md_SPSP,Md_SP,Md_,M">
<param name=indent value="0,1,2,3">
<param name=arrowdir value="down">
</APPLET>
<HR>
<DL>
<P><DL>
<DT><H3>Public Methods</H3><DD><DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif> <B><A HREF="#DOC.2.75.1">Stencil</A></B>()
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual bool <B><A HREF="#DOC.2.75.2">isSameKindAs</A></B>(const <!1><A HREF="Object.html">Object</A>* obj) const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual <!1><A HREF="Object.html">Object</A>* <B><A HREF="#DOC.2.75.3">clone</A></B>() const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual const char* <B><A HREF="#DOC.2.75.4">className</A></B>() const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual const <!1><A HREF="StateAttribute.html#DOC.2.73.5">Type</A> <B><A HREF="#DOC.2.75.5">getType</A></B>() const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual void <B><A HREF="#DOC.2.75.6">setStateSetModes</A></B>(<!1><A HREF="StateSet.html">StateSet</A>&amp; ds, const <!1><A HREF="StateAttribute.html#DOC.2.73.2">GLModeValue</A> value) const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>inline void <B><A HREF="#DOC.2.75.8">setFunction</A></B>(const <!1><A HREF="Stencil.html#DOC.2.75.7">Function</A> func, int <!1><A HREF="Referenced.html#DOC.2.69.4">ref</A>, uint mask)
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>inline const <!1><A HREF="Stencil.html#DOC.2.75.7">Function</A> <B><A HREF="#DOC.2.75.9">getFunction</A></B>() const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>inline const int <B><A HREF="#DOC.2.75.10">getFunctionRef</A></B>() const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>inline const uint <B><A HREF="#DOC.2.75.11">getFunctionMask</A></B>() const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>inline void <B><A HREF="#DOC.2.75.13">setOperation</A></B>(const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> sfail, const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> zfail, const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> zpass)
<DD><I>set the operations to apply when the various stencil and depth tests fail or pass.</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>inline const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> <B><A HREF="#DOC.2.75.14">getStencilFailOperation</A></B>() const
<DD><I>get the operation when the stencil test fails</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>inline const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> <B><A HREF="#DOC.2.75.15">getStencilPassAndDepthFailOperation</A></B>() const
<DD><I>get the operation when the stencil test passes but the depth test fails</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>inline const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> <B><A HREF="#DOC.2.75.16">getStencilPassAndDepthPassOperation</A></B>() const
<DD><I>get the operation when both the stencil test and the depth test pass</I>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>inline void <B><A HREF="#DOC.2.75.17">setWriteMask</A></B>(uint mask)
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>inline const uint <B><A HREF="#DOC.2.75.18">getWriteMask</A></B>() const
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual void <B><A HREF="#DOC.2.75.19">apply</A></B>(<!1><A HREF="State.html">State</A>&amp; state) const
</DL></P>
<P><DL>
<DT><H3>Public Members</H3><DD><DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>enum <B><A HREF="#DOC.2.75.7">Function</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>enum <B><A HREF="#DOC.2.75.12">Operation</A></B>
</DL></P>
<P><DL>
<DT><H3>Protected Fields</H3><DD><DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif><!1><A HREF="Stencil.html#DOC.2.75.7">Function</A> <B><A HREF="#DOC.2.75.21">_func</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>int <B><A HREF="#DOC.2.75.22">_funcRef</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>uint <B><A HREF="#DOC.2.75.23">_funcMask</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif><!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> <B><A HREF="#DOC.2.75.24">_sfail</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif><!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> <B><A HREF="#DOC.2.75.25">_zfail</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif><!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> <B><A HREF="#DOC.2.75.26">_zpass</A></B>
<DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>uint <B><A HREF="#DOC.2.75.27">_writeMask</A></B>
</DL></P>
<P><DL>
<DT><H3>Protected Methods</H3><DD><DT>
<IMG ALT="[more]" BORDER=0 SRC=icon1.gif>virtual <B><A HREF="#DOC.2.75.20">~Stencil</A></B>()
</DL></P>
</DL>
<HR><H3>Inherited from <A HREF="StateAttribute.html">StateAttribute</A>:</H3>
<DL>
<P><DL>
<DT><H3>Public Methods</H3><DD><DT>
<IMG ALT="o" SRC=icon2.gif>virtual void <B>compile</B>(<!1><A HREF="State.html">State</A>&amp;) const
</DL></P>
<P><DL>
<DT><H3>Public Members</H3><DD><DT>
<IMG ALT="o" SRC=icon2.gif>typedef GLenum <B>GLMode</B>
<DT>
<IMG ALT="o" SRC=icon2.gif>typedef unsigned int <B>GLModeValue</B>
<DT>
<IMG ALT="o" SRC=icon2.gif>typedef unsigned int <B>OverrideValue</B>
<DT>
<IMG ALT="o" SRC=icon2.gif>enum <B>Values</B>
<DT>
<IMG ALT="o" SRC=icon2.gif>enum <B>Type</B>
</DL></P>
</DL>
<HR><H3>Inherited from <A HREF="Object.html">Object</A>:</H3>
<DL>
</DL>
<HR><H3>Inherited from <A HREF="Referenced.html">Referenced</A>:</H3>
<DL>
<P><DL>
<DT><H3>Public Methods</H3><DD><DT>
<IMG ALT="o" SRC=icon2.gif>inline <!1><A HREF="Referenced.html">Referenced</A>&amp; <B>operator = </B>(<!1><A HREF="Referenced.html">Referenced</A>&amp;)
<DT>
<IMG ALT="o" SRC=icon2.gif>inline void <B>ref</B>() const
<DT>
<IMG ALT="o" SRC=icon2.gif>inline void <B>unref</B>() const
<DT>
<IMG ALT="o" SRC=icon2.gif>inline const int <B>referenceCount</B>() const
</DL></P>
<P><DL>
<DT><H3>Protected Fields</H3><DD><DT>
<IMG ALT="o" SRC=icon2.gif>mutable int <B>_refCount</B>
</DL></P>
</DL>
<A NAME="DOC.DOCU"></A>
<HR>
<H2>Documentation</H2>
<BLOCKQUOTE>Encapsulte OpenGL glStencilFunc/Op/Mask functions</BLOCKQUOTE>
<DL>
<A NAME="Stencil"></A>
<A NAME="DOC.2.75.1"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> Stencil()</B></TT>
<DL><DT><DD></DL><P>
<A NAME="isSameKindAs"></A>
<A NAME="DOC.2.75.2"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual bool isSameKindAs(const <!1><A HREF="Object.html">Object</A>* obj) const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="clone"></A>
<A NAME="DOC.2.75.3"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual <!1><A HREF="Object.html">Object</A>* clone() const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="className"></A>
<A NAME="DOC.2.75.4"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual const char* className() const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="getType"></A>
<A NAME="DOC.2.75.5"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual const <!1><A HREF="StateAttribute.html#DOC.2.73.5">Type</A> getType() const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="setStateSetModes"></A>
<A NAME="DOC.2.75.6"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual void setStateSetModes(<!1><A HREF="StateSet.html">StateSet</A>&amp; ds, const <!1><A HREF="StateAttribute.html#DOC.2.73.2">GLModeValue</A> value) const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="Function"></A>
<A NAME="DOC.2.75.7"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>enum Function</B></TT>
<DL><DT><DD></DL><P><DL>
<A NAME="NEVER"></A>
<A NAME="DOC.2.75.7.1"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> NEVER</B></TT>
<DL><DT><DD></DL><P>
<A NAME="LESS"></A>
<A NAME="DOC.2.75.7.2"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> LESS</B></TT>
<DL><DT><DD></DL><P>
<A NAME="EQUAL"></A>
<A NAME="DOC.2.75.7.3"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> EQUAL</B></TT>
<DL><DT><DD></DL><P>
<A NAME="LEQUAL"></A>
<A NAME="DOC.2.75.7.4"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> LEQUAL</B></TT>
<DL><DT><DD></DL><P>
<A NAME="GREATER"></A>
<A NAME="DOC.2.75.7.5"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> GREATER</B></TT>
<DL><DT><DD></DL><P>
<A NAME="NOTEQUAL"></A>
<A NAME="DOC.2.75.7.6"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> NOTEQUAL</B></TT>
<DL><DT><DD></DL><P>
<A NAME="GEQUAL"></A>
<A NAME="DOC.2.75.7.7"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> GEQUAL</B></TT>
<DL><DT><DD></DL><P>
<A NAME="ALWAYS"></A>
<A NAME="DOC.2.75.7.8"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> ALWAYS</B></TT>
<DL><DT><DD></DL><P></DL>
<A NAME="setFunction"></A>
<A NAME="DOC.2.75.8"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>inline void setFunction(const <!1><A HREF="Stencil.html#DOC.2.75.7">Function</A> func, int <!1><A HREF="Referenced.html#DOC.2.69.4">ref</A>, uint mask)</B></TT>
<DL><DT><DD></DL><P>
<A NAME="getFunction"></A>
<A NAME="DOC.2.75.9"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>inline const <!1><A HREF="Stencil.html#DOC.2.75.7">Function</A> getFunction() const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="getFunctionRef"></A>
<A NAME="DOC.2.75.10"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>inline const int getFunctionRef() const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="getFunctionMask"></A>
<A NAME="DOC.2.75.11"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>inline const uint getFunctionMask() const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="Operation"></A>
<A NAME="DOC.2.75.12"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>enum Operation</B></TT>
<DL><DT><DD></DL><P><DL>
<A NAME="KEEP"></A>
<A NAME="DOC.2.75.12.1"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> KEEP</B></TT>
<DL><DT><DD></DL><P>
<A NAME="ZERO"></A>
<A NAME="DOC.2.75.12.2"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> ZERO</B></TT>
<DL><DT><DD></DL><P>
<A NAME="REPLACE"></A>
<A NAME="DOC.2.75.12.3"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> REPLACE</B></TT>
<DL><DT><DD></DL><P>
<A NAME="INCR"></A>
<A NAME="DOC.2.75.12.4"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> INCR</B></TT>
<DL><DT><DD></DL><P>
<A NAME="DECR"></A>
<A NAME="DOC.2.75.12.5"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> DECR</B></TT>
<DL><DT><DD></DL><P>
<A NAME="INVERT"></A>
<A NAME="DOC.2.75.12.6"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B> INVERT</B></TT>
<DL><DT><DD></DL><P></DL>
<A NAME="setOperation"></A>
<A NAME="DOC.2.75.13"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>inline void setOperation(const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> sfail, const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> zfail, const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> zpass)</B></TT>
<DD>set the operations to apply when the various stencil and depth
tests fail or pass. First paramater is to control the operation
when the stencil test fails. The second paramter is to control the
operatiorn when the stencil test passes, but depth test fails. The
third parameter controls the operation when both the stencil test
and depth pass. Ordering of parameter is the same as if using
glStencilOp(,,).
<DL><DT><DD></DL><P>
<A NAME="getStencilFailOperation"></A>
<A NAME="DOC.2.75.14"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>inline const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> getStencilFailOperation() const </B></TT>
<DD>get the operation when the stencil test fails
<DL><DT><DD></DL><P>
<A NAME="getStencilPassAndDepthFailOperation"></A>
<A NAME="DOC.2.75.15"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>inline const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> getStencilPassAndDepthFailOperation() const </B></TT>
<DD>get the operation when the stencil test passes but the depth test fails
<DL><DT><DD></DL><P>
<A NAME="getStencilPassAndDepthPassOperation"></A>
<A NAME="DOC.2.75.16"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>inline const <!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> getStencilPassAndDepthPassOperation() const </B></TT>
<DD>get the operation when both the stencil test and the depth test pass
<DL><DT><DD></DL><P>
<A NAME="setWriteMask"></A>
<A NAME="DOC.2.75.17"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>inline void setWriteMask(uint mask)</B></TT>
<DL><DT><DD></DL><P>
<A NAME="getWriteMask"></A>
<A NAME="DOC.2.75.18"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>inline const uint getWriteMask() const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="apply"></A>
<A NAME="DOC.2.75.19"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual void apply(<!1><A HREF="State.html">State</A>&amp; state) const </B></TT>
<DL><DT><DD></DL><P>
<A NAME="~Stencil"></A>
<A NAME="DOC.2.75.20"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>virtual ~Stencil()</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_func"></A>
<A NAME="DOC.2.75.21"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B><!1><A HREF="Stencil.html#DOC.2.75.7">Function</A> _func</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_funcRef"></A>
<A NAME="DOC.2.75.22"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>int _funcRef</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_funcMask"></A>
<A NAME="DOC.2.75.23"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>uint _funcMask</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_sfail"></A>
<A NAME="DOC.2.75.24"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B><!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> _sfail</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_zfail"></A>
<A NAME="DOC.2.75.25"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B><!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> _zfail</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_zpass"></A>
<A NAME="DOC.2.75.26"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B><!1><A HREF="Stencil.html#DOC.2.75.12">Operation</A> _zpass</B></TT>
<DL><DT><DD></DL><P>
<A NAME="_writeMask"></A>
<A NAME="DOC.2.75.27"></A>
<DT><IMG ALT="o" BORDER=0 SRC=icon2.gif><TT><B>uint _writeMask</B></TT>
<DL><DT><DD></DL><P></DL>
<HR><DL><DT><B>This class has no child classes.</B></DL>
<DL><DT><DD></DL><P><P><I><A HREF="index.html">Alphabetic index</A></I> <I><A HREF="HIER.html">HTML hierarchy of classes</A> or <A HREF="HIERjava.html">Java</A></I></P><HR>
<BR>
This page was generated with the help of <A HREF="http://docpp.sourceforge.net">DOC++</A>.
</BODY>
</HTML>