raster.html

JAVA多媒体开发类库说明

<PRE>
public <B>Raster</B>(<A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;pos,
              int&nbsp;type,
              int&nbsp;xSrcOffset,
              int&nbsp;ySrcOffset,
              int&nbsp;width,
              int&nbsp;height,
              <A HREF="../../../javax/media/j3d/ImageComponent2D.html" title="class in javax.media.j3d">ImageComponent2D</A>&nbsp;image,
              <A HREF="../../../javax/media/j3d/DepthComponent.html" title="class in javax.media.j3d">DepthComponent</A>&nbsp;depthComponent)</PRE>
<DL>
<DD>Constructs a new Raster object with the specified values.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>pos</CODE> - the position in object coordinates of the upper-left
 corner of the raster<DD><CODE>type</CODE> - the type of raster object, one of: RASTER_COLOR,
 RASTER_DEPTH, or RASTER_COLOR_DEPTH<DD><CODE>xSrcOffset</CODE> - the x offset within the source array of pixels
 at which to start copying<DD><CODE>ySrcOffset</CODE> - the y offset within the source array of pixels
 at which to start copying<DD><CODE>width</CODE> - the number of columns of pixels to copy<DD><CODE>height</CODE> - the number of rows of pixels to copy<DD><CODE>image</CODE> - the ImageComponent2D object containing the
 color data<DD><CODE>depthComponent</CODE> - the DepthComponent object containing the depth
 (z-buffer) data
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the image class of the specified
 ImageComponent2D is ImageClass.NIO_IMAGE_BUFFER.</DL>
</DL>
<HR>

<A NAME="Raster(javax.vecmath.Point3f, int, java.awt.Point, java.awt.Dimension, javax.media.j3d.ImageComponent2D, javax.media.j3d.DepthComponent)"><!-- --></A><H3>
Raster</H3>
<PRE>
public <B>Raster</B>(<A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;pos,
              int&nbsp;type,
              java.awt.Point&nbsp;srcOffset,
              java.awt.Dimension&nbsp;size,
              <A HREF="../../../javax/media/j3d/ImageComponent2D.html" title="class in javax.media.j3d">ImageComponent2D</A>&nbsp;image,
              <A HREF="../../../javax/media/j3d/DepthComponent.html" title="class in javax.media.j3d">DepthComponent</A>&nbsp;depthComponent)</PRE>
<DL>
<DD>Constructs a new Raster object with the specified values.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>pos</CODE> - the position in object coordinates of the upper-left
 corner of the raster<DD><CODE>type</CODE> - the type of raster object, one of: RASTER_COLOR,
 RASTER_DEPTH, or RASTER_COLOR_DEPTH<DD><CODE>srcOffset</CODE> - the offset within the source array of pixels
 at which to start copying<DD><CODE>size</CODE> - the width and height of the image to be copied<DD><CODE>image</CODE> - the ImageComponent2D object containing the
 color data<DD><CODE>depthComponent</CODE> - the DepthComponent object containing the depth
 (z-buffer) data
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the image class of the specified
 ImageComponent2D is ImageClass.NIO_IMAGE_BUFFER.</DL>
</DL>
<HR>

<A NAME="Raster(javax.vecmath.Point3f, int, int, java.awt.Point, java.awt.Dimension, java.awt.Point, javax.media.j3d.ImageComponent2D, javax.media.j3d.DepthComponent)"><!-- --></A><H3>
Raster</H3>
<PRE>
public <B>Raster</B>(<A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;pos,
              int&nbsp;type,
              int&nbsp;clipMode,
              java.awt.Point&nbsp;srcOffset,
              java.awt.Dimension&nbsp;size,
              java.awt.Point&nbsp;dstOffset,
              <A HREF="../../../javax/media/j3d/ImageComponent2D.html" title="class in javax.media.j3d">ImageComponent2D</A>&nbsp;image,
              <A HREF="../../../javax/media/j3d/DepthComponent.html" title="class in javax.media.j3d">DepthComponent</A>&nbsp;depthComponent)</PRE>
<DL>
<DD>Constructs a new Raster object with the specified values.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>pos</CODE> - the position in object coordinates of the upper-left
 corner of the raster<DD><CODE>type</CODE> - the type of raster object, one of: RASTER_COLOR,
 RASTER_DEPTH, or RASTER_COLOR_DEPTH<DD><CODE>clipMode</CODE> - the clipping mode of the raster object, one of:
 CLIP_POSITION or CLIP_IMAGE<DD><CODE>srcOffset</CODE> - the offset within the source array of pixels
 at which to start copying<DD><CODE>size</CODE> - the width and height of the image to be copied<DD><CODE>dstOffset</CODE> - the destination pixel offset of the upper-left
 corner of the rendered image relative to the transformed position<DD><CODE>image</CODE> - the ImageComponent2D object containing the
 color data<DD><CODE>depthComponent</CODE> - the DepthComponent object containing the depth
 (z-buffer) data
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the image class of the specified
 ImageComponent2D is ImageClass.NIO_IMAGE_BUFFER.<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="setPosition(javax.vecmath.Point3f)"><!-- --></A><H3>
setPosition</H3>
<PRE>
public void <B>setPosition</B>(<A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;pos)</PRE>
<DL>
<DD>Sets the position in object coordinates of this raster.  This
 position is transformed into device coordinates and is used as
 the upper-left corner of the raster.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pos</CODE> - the new position of this raster
<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="getPosition(javax.vecmath.Point3f)"><!-- --></A><H3>
getPosition</H3>
<PRE>
public void <B>getPosition</B>(<A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;pos)</PRE>
<DL>
<DD>Retrieves the current position in object coordinates of this raster.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pos</CODE> - the vector that will receive the current position
<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="setType(int)"><!-- --></A><H3>
setType</H3>
<PRE>
public void <B>setType</B>(int&nbsp;type)</PRE>
<DL>
<DD>Sets the type of this raster object to one of: RASTER_COLOR,
 RASTER_DEPTH, or RASTER_COLOR_DEPTH.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>type</CODE> - the new type of this raster
<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.</DL>
</DD>
</DL>
<HR>

<A NAME="getType()"><!-- --></A><H3>
getType</H3>
<PRE>
public int <B>getType</B>()</PRE>
<DL>
<DD>Retrieves the current type of this raster object, one of: RASTER_COLOR,
 RASTER_DEPTH, or RASTER_COLOR_DEPTH.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>type the type of this raster
<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="setClipMode(int)"><!-- --></A><H3>
setClipMode</H3>
<PRE>
public void <B>setClipMode</B>(int&nbsp;clipMode)</PRE>
<DL>
<DD>Sets the clipping mode of this raster object.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>clipMode</CODE> - the new clipping mode of this raster,
 one of: CLIP_POSITION or CLIP_IMAGE.  The default mode
 is CLIP_POSITION.
<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="getClipMode()"><!-- --></A><H3>
getClipMode</H3>
<PRE>
public int <B>getClipMode</B>()</PRE>
<DL>
<DD>Retrieves the current clipping mode of this raster object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>clipMode the clipping mode of this raster,
 one of: CLIP_POSITION or CLIP_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="setOffset(int, int)"><!-- --></A><H3>
setOffset</H3>
<PRE>
public void <B>setOffset</B>(int&nbsp;xSrcOffset,
                      int&nbsp;ySrcOffset)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>As of Java 3D version 1.3, replaced by
 <code>setSrcOffset(int,int)</code></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setOffset(java.awt.Point)"><!-- --></A><H3>
setOffset</H3>
<PRE>
public void <B>setOffset</B>(java.awt.Point&nbsp;srcOffset)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>As of Java 3D version 1.3, replaced by
 <code>setSrcOffset(java.awt.Point)</code></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getOffset(java.awt.Point)"><!-- --></A><H3>
getOffset</H3>
<PRE>
public void <B>getOffset</B>(java.awt.Point&nbsp;srcOffset)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>As of Java 3D version 1.3, replaced by
 <code>getSrcOffset(java.awt.Point)</code></I>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setSrcOffset(int, int)"><!-- --></A><H3>
setSrcOffset</H3>
<PRE>
public void <B>setSrcOffset</B>(int&nbsp;xSrcOffset,
                         int&nbsp;ySrcOffset)</PRE>
<DL>
<DD>Sets the offset within the source array of pixels
 at which to start copying.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xSrcOffset</CODE> - the x offset within the source array of pixels
 at which to start copying<DD><CODE>ySrcOffset</CODE> - the y offset within the source array of pixels
 at which to start copying
<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="setSrcOffset(java.awt.Point)"><!-- --></A><H3>
setSrcOffset</H3>
<PRE>
public void <B>setSrcOffset</B>(java.awt.Point&nbsp;srcOffset)</PRE>
<DL>
<DD>Sets the offset within the source array of pixels
 at which to start copying.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>srcOffset</CODE> - the new source pixel offset
<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="getSrcOffset(java.awt.Point)"><!-- --></A><H3>
getSrcOffset</H3>
<PRE>
public void <B>getSrcOffset</B>(java.awt.Point&nbsp;srcOffset)</PRE>
<DL>
<DD>Retrieves the current source pixel offset.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>srcOffset</CODE> - the object that will receive the source offset