textureattributes.html

JAVA多媒体开发类库说明

<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineRgbMode(int)"><CODE>setCombineRgbMode(int)</CODE></A>, 
<A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineAlphaMode(int)"><CODE>setCombineAlphaMode(int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.TextureAttributes.COMBINE_INTERPOLATE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="COMBINE_DOT3"><!-- --></A><H3>
COMBINE_DOT3</H3>
<PRE>
public static final int <B>COMBINE_DOT3</B></PRE>
<DL>
<DD>Dot product of two colors.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineRgbMode(int)"><CODE>setCombineRgbMode(int)</CODE></A>, 
<A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineAlphaMode(int)"><CODE>setCombineAlphaMode(int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.TextureAttributes.COMBINE_DOT3">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="COMBINE_OBJECT_COLOR"><!-- --></A><H3>
COMBINE_OBJECT_COLOR</H3>
<PRE>
public static final int <B>COMBINE_OBJECT_COLOR</B></PRE>
<DL>
<DD>Object color coming into the texturing state.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineRgbSource(int, int)"><CODE>setCombineRgbSource(int, int)</CODE></A>, 
<A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineAlphaSource(int, int)"><CODE>setCombineAlphaSource(int, int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.TextureAttributes.COMBINE_OBJECT_COLOR">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="COMBINE_TEXTURE_COLOR"><!-- --></A><H3>
COMBINE_TEXTURE_COLOR</H3>
<PRE>
public static final int <B>COMBINE_TEXTURE_COLOR</B></PRE>
<DL>
<DD>Texture color of the corresponding texture unit state.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineRgbSource(int, int)"><CODE>setCombineRgbSource(int, int)</CODE></A>, 
<A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineAlphaSource(int, int)"><CODE>setCombineAlphaSource(int, int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.TextureAttributes.COMBINE_TEXTURE_COLOR">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="COMBINE_CONSTANT_COLOR"><!-- --></A><H3>
COMBINE_CONSTANT_COLOR</H3>
<PRE>
public static final int <B>COMBINE_CONSTANT_COLOR</B></PRE>
<DL>
<DD>Texture blend color.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineRgbSource(int, int)"><CODE>setCombineRgbSource(int, int)</CODE></A>, 
<A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineAlphaSource(int, int)"><CODE>setCombineAlphaSource(int, int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.TextureAttributes.COMBINE_CONSTANT_COLOR">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="COMBINE_PREVIOUS_TEXTURE_UNIT_STATE"><!-- --></A><H3>
COMBINE_PREVIOUS_TEXTURE_UNIT_STATE</H3>
<PRE>
public static final int <B>COMBINE_PREVIOUS_TEXTURE_UNIT_STATE</B></PRE>
<DL>
<DD>Color from the previous texture unit state.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineRgbSource(int, int)"><CODE>setCombineRgbSource(int, int)</CODE></A>, 
<A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineAlphaSource(int, int)"><CODE>setCombineAlphaSource(int, int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.TextureAttributes.COMBINE_PREVIOUS_TEXTURE_UNIT_STATE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="COMBINE_SRC_COLOR"><!-- --></A><H3>
COMBINE_SRC_COLOR</H3>
<PRE>
public static final int <B>COMBINE_SRC_COLOR</B></PRE>
<DL>
<DD>Color function is f = C<sub>rgb</sub>
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineRgbFunction(int, int)"><CODE>setCombineRgbFunction(int, int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.TextureAttributes.COMBINE_SRC_COLOR">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="COMBINE_ONE_MINUS_SRC_COLOR"><!-- --></A><H3>
COMBINE_ONE_MINUS_SRC_COLOR</H3>
<PRE>
public static final int <B>COMBINE_ONE_MINUS_SRC_COLOR</B></PRE>
<DL>
<DD>Color function is f = (1 - C<sub>rgb</sub>)
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineRgbFunction(int, int)"><CODE>setCombineRgbFunction(int, int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.TextureAttributes.COMBINE_ONE_MINUS_SRC_COLOR">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="COMBINE_SRC_ALPHA"><!-- --></A><H3>
COMBINE_SRC_ALPHA</H3>
<PRE>
public static final int <B>COMBINE_SRC_ALPHA</B></PRE>
<DL>
<DD>Color function is f = C<sub>a</sub>
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineRgbFunction(int, int)"><CODE>setCombineRgbFunction(int, int)</CODE></A>, 
<A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineAlphaFunction(int, int)"><CODE>setCombineAlphaFunction(int, int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.TextureAttributes.COMBINE_SRC_ALPHA">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="COMBINE_ONE_MINUS_SRC_ALPHA"><!-- --></A><H3>
COMBINE_ONE_MINUS_SRC_ALPHA</H3>
<PRE>
public static final int <B>COMBINE_ONE_MINUS_SRC_ALPHA</B></PRE>
<DL>
<DD>Color function is f = (1 - C<sub>a</sub>)
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineRgbFunction(int, int)"><CODE>setCombineRgbFunction(int, int)</CODE></A>, 
<A HREF="../../../javax/media/j3d/TextureAttributes.html#setCombineAlphaFunction(int, int)"><CODE>setCombineAlphaFunction(int, int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.TextureAttributes.COMBINE_ONE_MINUS_SRC_ALPHA">Constant Field Values</A></DL>
</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="TextureAttributes()"><!-- --></A><H3>
TextureAttributes</H3>
<PRE>
public <B>TextureAttributes</B>()</PRE>
<DL>
<DD>Constructs a TextureAttributes object with default parameters.
 The default values are as follows:
 <ul>
 texture mode : REPLACE<br>
 blend color : black (0,0,0,0)<br>
 transform : identity<br>
 perspective correction mode : NICEST<br>
 texture color table : null<br>
 combine rgb mode : COMBINE_MODULATE<br>
 combine alpha mode : COMBINE_MODULATE<br>
 combine rgb source : 
 <ul>
                C<sub>0</sub>=COMBINE_TEXTURE_COLOR<br>
          C<sub>1</sub>=COMBINE_PREVIOUS_TEXTURE_UNIT_STATE<br>
          C<sub>2</sub>=COMBINE_CONSTANT_COLOR<br>
 </ul>
 combine alpha source : 
 <ul>
                C<sub>0</sub>=COMBINE_TEXTURE_COLOR<br>
          C<sub>1</sub>=COMBINE_PREVIOUS_TEXTURE_UNIT_STATE<br>
          C<sub>2</sub>=COMBINE_CONSTANT_COLOR<br>
 </ul>
 combine rgb function : COMBINE_SRC_COLOR<br>
 combine alpha function : COMBINE_SRC_ALPHA<br> 
 combine rgb scale : 1<br>
 combine alpha scale : 1<br>
 </ul>
<P>
</DL>
<HR>

<A NAME="TextureAttributes(int, javax.media.j3d.Transform3D, javax.vecmath.Color4f, int)"><!-- --></A><H3>
TextureAttributes</H3>
<PRE>
public <B>TextureAttributes</B>(int&nbsp;textureMode,
                         <A HREF="../../../javax/media/j3d/Transform3D.html" title="class in javax.media.j3d">Transform3D</A>&nbsp;transform,
                         <A HREF="../../../javax/vecmath/Color4f.html" title="class in javax.vecmath">Color4f</A>&nbsp;textureBlendColor,
                         int&nbsp;perspCorrectionMode)</PRE>
<DL>
<DD>Constructs a TextureAttributes object with the specified values.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>textureMode</CODE> - the texture mode; one of <code>MODULATE</code>, 
 <code>DECAL</code>, <code>BLEND</code>, <code>REPLACE</code>, or
 <code>COMBINE</code><DD><CODE>transform</CODE> - the transform object, used to transform texture
 coordinates<DD><CODE>textureBlendColor</CODE> - the texture constant color<DD><CODE>perspCorrectionMode</CODE> - the perspective correction mode to 
 be used for color and/or texture coordinate interpolation;
 one of <code>NICEST</code> or <code>FASTEST</code>
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>textureMode</code>
 is a value other than <code>MODULATE</code>,
 <code>DECAL</code>, <code>BLEND</code>, <code>REPLACE</code>, or
 <code>COMBINE</code>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if mode value is other
 than <code>FASTEST</code> or <code>NICEST</code>.</DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="setTextureMode(int)"><!-- --></A><H3>
setTextureMode</H3>
<PRE>
public void <B>setTextureMode</B>(int&nbsp;textureMode)</PRE>
<DL>
<DD>Sets the texture  mode parameter for this
 appearance component object.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>textureMode</CODE> - the texture  mode, one of: <code>MODULATE</code>,
 <code>DECAL</code>, <code>BLEND</code>, <code>REPLACE</code>, or
 <code>COMBINE</code>
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>textureMode</code>
 is a value other than <code>MODULATE</code>,
 <code>DECAL</code>, <code>BLEND</code>, <code>REPLACE</code>, or
 <code>COMBINE</code><DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Canvas3D.html#queryProperties()"><CODE>Canvas3D.queryProperties()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getTextureMode()"><!-- --></A><H3>
getTextureMode</H3>
<PRE>
public int <B>getTextureMode</B>()</PRE>
<DL>
<DD>Gets the texture  mode parameter for this
 texture attributes object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>textureMode the texture  mode
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="setTextureBlendColor(javax.vecmath.Color4f)"><!-- --></A><H3>
setTextureBlendColor</H3>
<PRE>
public void <B>setTextureBlendColor</B>(<A HREF="../../../javax/vecmath/Color4f.html" title="class in javax.vecmath">Color4f</A>&nbsp;textureBlendColor)</PRE>
<DL>
<DD>Sets the texture constant color for this
 texture attributes object.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>textureBlendColor</CODE> - the texture constant color
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="setTextureBlendColor(float, float, float, float)"><!-- --></A><H3>
setTextureBlendColor</H3>
<PRE>
public void <B>setTextureBlendColor</B>(float&nbsp;r,
                                 float&nbsp;g,
                                 float&nbsp;b,
                                 float&nbsp;a)</PRE>
<DL>
<DD>Sets the texture blend color for this
 appearance component object.
<P>
<DD><DL>