texturecubemap.html

JAVA多媒体开发类库说明

<PRE>
public static final int <B>NEGATIVE_Y</B></PRE>
<DL>
<DD>Specifies the face of the cube that is pierced by the negative y axis
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.TextureCubeMap.NEGATIVE_Y">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="POSITIVE_Z"><!-- --></A><H3>
POSITIVE_Z</H3>
<PRE>
public static final int <B>POSITIVE_Z</B></PRE>
<DL>
<DD>Specifies the face of the cube that is pierced by the positive z axis
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.TextureCubeMap.POSITIVE_Z">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="NEGATIVE_Z"><!-- --></A><H3>
NEGATIVE_Z</H3>
<PRE>
public static final int <B>NEGATIVE_Z</B></PRE>
<DL>
<DD>Specifies the face of the cube that is pierced by the negative z axis
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.TextureCubeMap.NEGATIVE_Z">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="TextureCubeMap()"><!-- --></A><H3>
TextureCubeMap</H3>
<PRE>
public <B>TextureCubeMap</B>()</PRE>
<DL>
<DD>Constructs a texture object using default values.
 Note that the default constructor creates a texture object with 
 a width of 0 and is, therefore, not useful.
<P>
</DL>
<HR>

<A NAME="TextureCubeMap(int, int, int)"><!-- --></A><H3>
TextureCubeMap</H3>
<PRE>
public <B>TextureCubeMap</B>(int&nbsp;mipmapMode,
                      int&nbsp;format,
                      int&nbsp;width)</PRE>
<DL>
<DD>Constructs an empty TextureCubeMap object with specified mipmapMode
 format, and width. 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 cube map is square in dimensions, hence specifying width 
 is sufficient.
 Note also that a texture with a non-power-of-two width 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 (and height) of image at level 0.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if width is not greater
 than 0 OR invalid format/mipmapMode is specified.</DL>
</DL>
<HR>

<A NAME="TextureCubeMap(int, int, int, int)"><!-- --></A><H3>
TextureCubeMap</H3>
<PRE>
public <B>TextureCubeMap</B>(int&nbsp;mipmapMode,
                      int&nbsp;format,
                      int&nbsp;width,
                      int&nbsp;boundaryWidth)</PRE>
<DL>
<DD>Constructs an empty TextureCubeMap object with specified mipmapMode
 format, width, and boundary width. 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 cube map is square in dimensions, hence specifying width 
 is sufficient.
 Note also that a texture with a non-power-of-two width 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 (and 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 is not
 greater than 0 OR invalid format/mipmapMode is specified.</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="setImage(int, int, javax.media.j3d.ImageComponent2D)"><!-- --></A><H3>
setImage</H3>
<PRE>
public void <B>setImage</B>(int&nbsp;level,
                     int&nbsp;face,
                     <A HREF="../../../javax/media/j3d/ImageComponent2D.html" title="class in javax.media.j3d">ImageComponent2D</A>&nbsp;image)</PRE>
<DL>
<DD>Sets the image for a specified mipmap level of a specified face
 of the cube map
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>level</CODE> - mipmap level<DD><CODE>face</CODE> - face of the cube map. One of: 
 <code>POSITIVE_X</code>, <code>NEGATIVE_X</code>,     
 <code>POSITIVE_Y</code>, <code>NEGATIVE_Y</code>,
 <code>POSITIVE_Z</code> or <code>NEGATIVE_Z</code>.<DD><CODE>image</CODE> - ImageComponent2D object containing the image
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if 
 <code>face</code> has a value other
 than <code>POSITIVE_X</code>, <code>NEGATIVE_X</code>, 
 <code>POSITIVE_Y</code>, <code>NEGATIVE_Y</code>,
 <code>POSITIVE_Z</code> or <code>NEGATIVE_Z</code>.
<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
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if this TextureCubeMap is live and
 the specified image is being used by a Canvas3D as an off-screen buffer.
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if this TextureCubeMap is
 being used by an immediate mode context and
 the specified image is being used by a Canvas3D as an off-screen buffer.</DL>
</DD>
</DL>
<HR>

<A NAME="setImages(int, javax.media.j3d.ImageComponent2D[])"><!-- --></A><H3>
setImages</H3>
<PRE>
public void <B>setImages</B>(int&nbsp;face,
                      <A HREF="../../../javax/media/j3d/ImageComponent2D.html" title="class in javax.media.j3d">ImageComponent2D</A>[]&nbsp;images)</PRE>
<DL>
<DD>Sets the array of images for mipmap levels from base level through
 max level for a specified face of the cube map
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>face</CODE> - face of the cube map. One of: 
 <code>POSITIVE_X</code>, <code>NEGATIVE_X</code>,     
 <code>POSITIVE_Y</code>, <code>NEGATIVE_Y</code>,
 <code>POSITIVE_Z</code> or <code>NEGATIVE_Z</code>.<DD><CODE>images</CODE> - array of ImageComponent2D objects containing the images
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if 
 <code>face</code> has a value other
 than <code>POSITIVE_X</code>, <code>NEGATIVE_X</code>, 
 <code>POSITIVE_Y</code>, <code>NEGATIVE_Y</code>,
 <code>POSITIVE_Z</code> or <code>NEGATIVE_Z</code>.
<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
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if this TextureCubeMap is live and
 any of the specified images are being used by a Canvas3D as an
 off-screen buffer.
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if this TextureCubeMap is
 being used by an immediate mode context and
 any of the specified images are being used by a Canvas3D as an
 off-screen buffer.</DL>
</DD>
</DL>
<HR>

<A NAME="getImage(int, int)"><!-- --></A><H3>
getImage</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/ImageComponent.html" title="class in javax.media.j3d">ImageComponent</A> <B>getImage</B>(int&nbsp;level,
                               int&nbsp;face)</PRE>
<DL>
<DD>Retrieves the image for a specified mipmap level of a particular
 face of the cube map.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>level</CODE> - mipmap level to get.<DD><CODE>face</CODE> - face of the cube map. One of: 
 <code>POSITIVE_X</code>, <code>NEGATIVE_X</code>,     
 <code>POSITIVE_Y</code>, <code>NEGATIVE_Y</code>,
 <code>POSITIVE_Z</code> or <code>NEGATIVE_Z</code>.
<DT><B>Returns:</B><DD>the ImageComponent object containing the texture image at
 the specified mipmap level.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if 
 <code>face</code> has a value other
 than <code>POSITIVE_X</code>, <code>NEGATIVE_X</code>, 
 <code>POSITIVE_Y</code>, <code>NEGATIVE_Y</code>,
 <code>POSITIVE_Z</code> or <code>NEGATIVE_Z</code>.