texture2d.html

java 3d帮助文档

<HR>

<A NAME="LINEAR_DETAIL_ALPHA"><!-- --></A><H3>
LINEAR_DETAIL_ALPHA</H3>
<PRE>
public static final int <B>LINEAR_DETAIL_ALPHA</B></PRE>
<DL>
<DD>Performs linear detail for the alpha
 component only. The rgb components are computed using 
 BASE_LEVEL_LINEAR filter.
<P>
<DL>
<DT><B>Since:</B><DD>Java 3D 1.3</DD>
</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Texture2D.html#setMagFilter(int)"><CODE>setMagFilter(int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.Texture2D.LINEAR_DETAIL_ALPHA">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="DETAIL_ADD"><!-- --></A><H3>
DETAIL_ADD</H3>
<PRE>
public static final int <B>DETAIL_ADD</B></PRE>
<DL>
<DD>Adds the detail texture image to the level 0 image of this texture
 object
<P>
<DL>
<DT><B>Since:</B><DD>Java 3D 1.3</DD>
</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Texture2D.html#setDetailTextureMode(int)"><CODE>setDetailTextureMode(int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.Texture2D.DETAIL_ADD">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="DETAIL_MODULATE"><!-- --></A><H3>
DETAIL_MODULATE</H3>
<PRE>
public static final int <B>DETAIL_MODULATE</B></PRE>
<DL>
<DD>Modulates the detail texture image with the level 0 image of this
 texture object
<P>
<DL>
<DT><B>Since:</B><DD>Java 3D 1.3</DD>
</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Texture2D.html#setDetailTextureMode(int)"><CODE>setDetailTextureMode(int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.Texture2D.DETAIL_MODULATE">Constant Field Values</A></DL>
</DL>

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

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

<A NAME="Texture2D()"><!-- --></A><H3>
Texture2D</H3>
<PRE>
public <B>Texture2D</B>()</PRE>
<DL>
<DD>Constructs a texture object using default values.

 The default values are as follows:
 <ul>
 detail texture image: null<br>
 detail texture mode: DETAIL_MODULATE<br>
 detail texture func: null<br>
 detail texture level: 2<br>
 </ul>
 <p>
 Note that the default constructor creates a texture object with
 a width and height of 0 and is, therefore, not useful.
<P>
</DL>
<HR>

<A NAME="Texture2D(int, int, int, int)"><!-- --></A><H3>
Texture2D</H3>
<PRE>
public <B>Texture2D</B>(int&nbsp;mipMapMode,
                 int&nbsp;format,
                 int&nbsp;width,
                 int&nbsp;height)</PRE>
<DL>
<DD>Constructs an empty Texture2D object with specified mipmapMode
 format, width and height. Image at base level must be set by 
 the application using 'setImage' method. If mipmapMode is
 set to MULTI_LEVEL_MIPMAP, images for base level through maximum level
 must be set.
<P>
<DT><B>Parameters:</B><DD><CODE>mipMapMode</CODE> - type of mipmap for this Texture: One of
 BASE_LEVEL, MULTI_LEVEL_MIPMAP.<DD><CODE>format</CODE> - data format of Textures saved in this object.
 One of INTENSITY, LUMINANCE, ALPHA, LUMINANCE_ALPHA, RGB, RGBA.<DD><CODE>width</CODE> - width of image at level 0. Must be power of 2.<DD><CODE>height</CODE> - height of image at level 0. Must be power of 2.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if width or height are NOT
 power of 2 OR invalid format/mipmapMode is specified.</DL>
<HR>

<A NAME="Texture2D(int, int, int, int, int)"><!-- --></A><H3>
Texture2D</H3>
<PRE>
public <B>Texture2D</B>(int&nbsp;mipMapMode,
                 int&nbsp;format,
                 int&nbsp;width,
                 int&nbsp;height,
                 int&nbsp;boundaryWidth)</PRE>
<DL>
<DD>Constructs an empty Texture2D object with specified mipMapMode,
 format, width, height, and boundaryWidth.
 Defaults are used for all other
 parameters.  If <code>mipMapMode</code> is set to
 <code>BASE_LEVEL</code>, then the image at level 0 must be set
 by the application (using either the <code>setImage</code> or
 <code>setImages</code> method). If <code>mipMapMode</code> is
 set to <code>MULTI_LEVEL_MIPMAP</code>, then images for levels
 Base Level through Maximum Level must be set.
<P>
<DT><B>Parameters:</B><DD><CODE>mipMapMode</CODE> - type of mipmap for this Texture: one of
 BASE_LEVEL, MULTI_LEVEL_MIPMAP<DD><CODE>format</CODE> - data format of Textures saved in this object.
 One of INTENSITY, LUMINANCE, ALPHA, LUMINANCE_ALPHA, RGB, RGBA<DD><CODE>width</CODE> - width of image at level 0. Must be power of 2. This
 does not include the width of the boundary.<DD><CODE>height</CODE> - height of image at level 0. Must be power of 2. This
 does not include the width of the boundary.<DD><CODE>boundaryWidth</CODE> - width of the boundary.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if width or height are not a
 power of 2, if an invalid format or mipMapMode is specified, or
 if the boundaryWidth < 0<DT><B>Since:</B><DD>Java 3D 1.3</DD>
</DD>
</DL>

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

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

<A NAME="setMagFilter(int)"><!-- --></A><H3>
setMagFilter</H3>
<PRE>
public void <B>setMagFilter</B>(int&nbsp;magFilter)</PRE>
<DL>
<DD>Sets the magnification filter function.  This
 function is used when the pixel being rendered maps to an area
 less than or equal to one texel.
<P>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE><A HREF="../../../javax/media/j3d/Texture.html#setMagFilter(int)">setMagFilter</A></CODE> in class <CODE><A HREF="../../../javax/media/j3d/Texture.html">Texture</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>magFilter</CODE> - the magnification filter, one of:
 FASTEST, NICEST, BASE_LEVEL_POINT, BASE_LEVEL_LINEAR, 
 LINEAR_DETAIL, LINEAR_DETAIL_RGB, LINEAR_DETAIL_ALPHA,
 LINEAR_SHARPEN, LINEAR_SHARPEN_RGB, LINEAR_SHARPEN_ALPHA, or FILTER4.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/RestrictedAccessException.html">RestrictedAccessException</A></CODE> - if the method is called
 when this object is part of live or compiled scene graph.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>minFilter</code>
 is a value other than <code>FASTEST</code>, <code>NICEST</code>,
 <code>BASE_LEVEL_POINT</code>, <code>BASE_LEVEL_LINEAR</code>,
 <code>LINEAR_DETAIL</code>, <code>LINEAR_DETAIL_RGB</code>, 
 <code>LINEAR_DETAIL_ALPHA</code>, 
 <code>LINEAR_SHARPEN</code>, <code>LINEAR_SHARPEN_RGB</code>, 
 <code>LINEAR_SHARPEN_ALPHA</code>,  or
 <code>FILTER4</code>.<DT><B>Since:</B><DD>Java 3D 1.3</DD>
</DD>
<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="setDetailImage(javax.media.j3d.ImageComponent2D)"><!-- --></A><H3>
setDetailImage</H3>
<PRE>
public void <B>setDetailImage</B>(<A HREF="../../../javax/media/j3d/ImageComponent2D.html">ImageComponent2D</A>&nbsp;detailTexture)</PRE>
<DL>
<DD>Sets the detail texture image for this texture object.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>detailTexture</CODE> - ImageComponent2D object containing the
 detail texture image.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/RestrictedAccessException.html">RestrictedAccessException</A></CODE> - if the method is called
 when this object is part of live or compiled scene graph.<DT><B>Since:</B><DD>Java 3D 1.3</DD>
</DD>
<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="getDetailImage()"><!-- --></A><H3>
getDetailImage</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/ImageComponent2D.html">ImageComponent2D</A> <B>getDetailImage</B>()</PRE>
<DL>
<DD>Retrieves the detail texture image for this texture object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>ImageComponent2D object containing the detail texture image.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is
 not set and this object is part of live or compiled scene graph<DT><B>Since:</B><DD>Java 3D 1.3</DD>
</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setDetailTextureMode(int)"><!-- --></A><H3>
setDetailTextureMode</H3>
<PRE>
public void <B>setDetailTextureMode</B>(int&nbsp;mode)</PRE>
<DL>
<DD>Sets the detail texture mode for this texture object.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>mode</CODE> - detail texture mode. One of: DETAIL_ADD or DETAIL_MODULATE
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if
 <code>mode</code> is a value other than
 <code>DETAIL_ADD</code>, or <code>DETAIL_MODULATE</code>
<DD><CODE><A HREF="../../../javax/media/j3d/RestrictedAccessException.html">RestrictedAccessException</A></CODE> - if the method is called
 when this object is part of live or compiled scene graph.<DT><B>Since:</B><DD>Java 3D 1.3</DD>
</DD>
<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="getDetailTextureMode()"><!-- --></A><H3>
getDetailTextureMode</H3>
<PRE>
public int <B>getDetailTextureMode</B>()</PRE>
<DL>
<DD>Retrieves the detail texture mode for this texture object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the detail texture mode.