imagecomponent2d.html

JAVA多媒体开发类库说明

</DD>
</DL>
<HR>

<A NAME="getRenderedImage()"><!-- --></A><H3>
getRenderedImage</H3>
<PRE>
public java.awt.image.RenderedImage <B>getRenderedImage</B>()</PRE>
<DL>
<DD>Retrieves the image from this ImageComponent2D object.  If the
 data access mode is not by-reference, a copy of the image
 is made.  If the data access mode is by-reference, the
 reference is returned.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>either a new RenderedImage object created from the data
 in this image component, or the RenderedImage object referenced
 by this image component.
<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
<DD><CODE>java.lang.IllegalStateException</CODE> - if the image class is not one of:
 ImageClass.BUFFERED_IMAGE or ImageClass.RENDERED_IMAGE.<DT><B>Since:</B></DT>
  <DD>Java 3D 1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getNioImage()"><!-- --></A><H3>
getNioImage</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/NioImageBuffer.html" title="class in javax.media.j3d">NioImageBuffer</A> <B>getNioImage</B>()</PRE>
<DL>
<DD>Retrieves the image from this ImageComponent2D object.  If the
 data access mode is not by-reference, a copy of the image
 is made.  If the data access mode is by-reference, the
 reference is returned.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>either a new NioImageBuffer object created from the data
 in this image component, or the NioImageBuffer object referenced
 by this image component.
<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
<DD><CODE>java.lang.IllegalStateException</CODE> - if the image class is not
 ImageClass.NIO_IMAGE_BUFFER.<DT><B>Since:</B></DT>
  <DD>Java 3D 1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setSubImage(java.awt.image.RenderedImage, int, int, int, int, int, int)"><!-- --></A><H3>
setSubImage</H3>
<PRE>
public void <B>setSubImage</B>(java.awt.image.RenderedImage&nbsp;image,
                        int&nbsp;width,
                        int&nbsp;height,
                        int&nbsp;srcX,
                        int&nbsp;srcY,
                        int&nbsp;dstX,
                        int&nbsp;dstY)</PRE>
<DL>
<DD>Modifies a contiguous subregion of the image component.
 Block of data of dimension (width * height)
 starting at the offset (srcX, srcY) of the specified 
 RenderedImage object will be copied into the image component
 starting at the offset (dstX, dstY) of the ImageComponent2D object.
 The specified RenderedImage object must be of the same format as
 the current RenderedImage object in this image component.
 This method can only be used if the data access mode is
 by-copy. If it is by-reference, see updateData().
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>image</CODE> - RenderedImage object containing the subimage.<DD><CODE>width</CODE> - width of the subregion.<DD><CODE>height</CODE> - height of the subregion.<DD><CODE>srcX</CODE> - starting X offset of the subregion in the 
 specified image.<DD><CODE>srcY</CODE> - starting Y offset of the subregion in the 
 specified image.<DD><CODE>dstX</CODE> - starting X offset of the subregion in the image 
 component of this object.<DD><CODE>dstY</CODE> - starting Y offset of the subregion in the image 
 component of this object.
<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
<DD><CODE>java.lang.IllegalStateException</CODE> - if the data access mode is
 <code>BY_REFERENCE</code>.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>width</code> or 
 <code>height</code> of
 the subregion exceeds the dimension of the image of this object.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>dstX</code> < 0, or
 (<code>dstX</code> + <code>width</code>) > width of this object, or 
 <code>dstY</code> < 0, or
 (<code>dstY</code> + <code>height</code>) > height of this object.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>srcX</code> < 0, or
 (<code>srcX</code> + <code>width</code>) > width of the RenderedImage
 object containing the subimage, or 
 <code>srcY</code> < 0, or
 (<code>srcY</code> + <code>height</code>) > height of the 
 RenderedImage object containing the subimage.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the specified RenderedImage
 is not compatible with the existing RenderedImage.
<DD><CODE>java.lang.IllegalStateException</CODE> - if the image class is not one of:
 ImageClass.BUFFERED_IMAGE or ImageClass.RENDERED_IMAGE.<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="updateData(javax.media.j3d.ImageComponent2D.Updater, int, int, int, int)"><!-- --></A><H3>
updateData</H3>
<PRE>
public void <B>updateData</B>(<A HREF="../../../javax/media/j3d/ImageComponent2D.Updater.html" title="interface in javax.media.j3d">ImageComponent2D.Updater</A>&nbsp;updater,
                       int&nbsp;x,
                       int&nbsp;y,
                       int&nbsp;width,
                       int&nbsp;height)</PRE>
<DL>
<DD>Updates image data that is accessed by reference.
 This method calls the updateData method of the specified
 ImageComponent2D.Updater object to synchronize updates to the
 image data that is referenced by this ImageComponent2D object.
 Applications that wish to modify such data must perform all
 updates via this method.
 <p>
 The data to be modified has to be within the boundary of the
 subregion
 specified by the offset (x, y) and the dimension (width*height).
 It is illegal to modify data outside this boundary.
 If any referenced data is modified outisde the updateData
 method, or any data outside the specified boundary is modified,
 the results are undefined.
 <p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>updater</CODE> - object whose updateData callback method will be
 called to update the data referenced by this ImageComponent2D object.<DD><CODE>x</CODE> - starting X offset of the subregion.<DD><CODE>y</CODE> - starting Y offset of the subregion.<DD><CODE>width</CODE> - width of the subregion.<DD><CODE>height</CODE> - height of the subregion.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">CapabilityNotSetException</A></CODE> - if the appropriate capability
 is not set, and this object is part of a live or compiled scene graph
<DD><CODE>java.lang.IllegalStateException</CODE> - if the data access mode is
 <code>BY_COPY</code>.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>width</code> or
 <code>height</code> of
 the subregion exceeds the dimension of the image of this object.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if <code>x</code> < 0, or
 (<code>x</code> + <code>width</code>) > width of this object, or
 <code>y</code> < 0, or
 (<code>y</code> + <code>height</code>) > height of this object.<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="cloneNodeComponent()"><!-- --></A><H3>
cloneNodeComponent</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/NodeComponent.html" title="class in javax.media.j3d">NodeComponent</A> <B>cloneNodeComponent</B>()</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>replaced with cloneNodeComponent(boolean forceDuplicate)</I>
<P>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE><A HREF="../../../javax/media/j3d/NodeComponent.html#cloneNodeComponent()">cloneNodeComponent</A></CODE> in class <CODE><A HREF="../../../javax/media/j3d/NodeComponent.html" title="class in javax.media.j3d">NodeComponent</A></CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/media/j3d/ImageComponent.ImageClass.html" title="enum in javax.media.j3d"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/media/j3d/ImageComponent2D.Updater.html" title="interface in javax.media.j3d"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html?javax/media/j3d/ImageComponent2D.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="ImageComponent2D.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;<A HREF="#nested_class_summary">NESTED</A>&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_javax.media.j3d.ImageComponent">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<font size="-1">Copyright (c) 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to <a href="../../../LICENSE-SPEC.html">license terms</a>.
</BODY>
</HTML>