texture2d.html

JAVA多媒体开发类库说明

<HR>

<A NAME="DETAIL_ADD"><!-- --></A><H3>
DETAIL_ADD</H3>
<PRE>
public static final int <B>DETAIL_ADD</B></PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>As of Java 3D 1.5 the optional detail texture feature is no
 longer supported.
 Adds the detail texture image to the level 0 image of this texture
 object</I><DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</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><B>Deprecated.</B>&nbsp;<I>As of Java 3D 1.5 the optional detail texture feature is no
 longer supported.
 Modulates the detail texture image with the level 0 image of this
 texture object</I><DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</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" 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="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.
 Note that a texture with a non-power-of-two width or height will
 only be rendered on a graphics device that supports non-power-of-two
 textures.
<P>
<DL>
<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.<DD><CODE>height</CODE> - height of image at level 0.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if width or height are NOT
 greater than 0 OR invalid format/mipmapMode is specified.</DL>
</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.
 Note that a texture with a non-power-of-two width or height will
 only be rendered on a graphics device that supports non-power-of-two
 textures.
<P>
<DL>
<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. This
 does not include the width of the boundary.<DD><CODE>height</CODE> - height of image at level 0. This
 does not include the width of the boundary.<DD><CODE>boundaryWidth</CODE> - width of the boundary, which must be 0 or 1.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if width or height are not greater
 than 0, if an invalid format or mipMapMode is specified, or
 if the boundaryWidth is &lt; 0 or &gt; 1<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
</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="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" title="class in javax.media.j3d">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" title="class in javax.media.j3d">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></DT>
  <DD>Java 3D 1.3</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" title="class in javax.media.j3d">ImageComponent2D</A>&nbsp;detailTexture)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>As of Java 3D 1.5 the optional detail texture feature is no
 longer supported.</I>
<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" title="class in javax.media.j3d">RestrictedAccessException</A></CODE> - if the method is called
 when this object is part of live or compiled scene graph.<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</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" title="class in javax.media.j3d">ImageComponent2D</A> <B>getDetailImage</B>()</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>As of Java 3D 1.5 the optional detail texture feature is no
 longer supported.</I>
<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" 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<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</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><B>Deprecated.</B>&nbsp;<I>As of Java 3D 1.5 the optional detail texture feature is no
 longer supported.</I>
<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" title="class in javax.media.j3d">RestrictedAccessException</A></CODE> - if the method is called
 when this object is part of live or compiled scene graph.<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</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><B>Deprecated.</B>&nbsp;<I>As of Java 3D 1.5 the optional detail texture feature is no
 longer supported.</I>
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the detail 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<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>