gifimage.html

java对GIF的编解码工具,有完整的说明和例子

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set number of iterations the loop should be executed.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.Object</B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->

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

<A NAME="RESIZE_STRATEGY_CROP_TO_FIT_IMAGE_SIZE"><!-- --></A><H3>
RESIZE_STRATEGY_CROP_TO_FIT_IMAGE_SIZE</H3>
<PRE>
public static final int <B>RESIZE_STRATEGY_CROP_TO_FIT_IMAGE_SIZE</B></PRE>
<DL>
<DD><p>Represents a resize strategy, when every subsequent image frame is necessarily resized by cropping
 to fit the fixed logical screen size.</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#com.gif4j.light.GifImage.RESIZE_STRATEGY_CROP_TO_FIT_IMAGE_SIZE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="RESIZE_STRATEGY_SCALE_TO_FIT_IMAGE_SIZE"><!-- --></A><H3>
RESIZE_STRATEGY_SCALE_TO_FIT_IMAGE_SIZE</H3>
<PRE>
public static final int <B>RESIZE_STRATEGY_SCALE_TO_FIT_IMAGE_SIZE</B></PRE>
<DL>
<DD><p>Represents a resize strategy, when every subsequent image frame is necessarily resized by scaling
 to fit the fixed logical screen size.</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#com.gif4j.light.GifImage.RESIZE_STRATEGY_SCALE_TO_FIT_IMAGE_SIZE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="RESIZE_STRATEGY_EXTEND_TO_CURRENT"><!-- --></A><H3>
RESIZE_STRATEGY_EXTEND_TO_CURRENT</H3>
<PRE>
public static final int <B>RESIZE_STRATEGY_EXTEND_TO_CURRENT</B></PRE>
<DL>
<DD><p>Represents a resize strategy, when logical screen width and height are necessarily extended
 to support the adding frame's size.</p>
 <p>This strategy is used by default.</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#com.gif4j.light.GifImage.RESIZE_STRATEGY_EXTEND_TO_CURRENT">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">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="GifImage()"><!-- --></A><H3>
GifImage</H3>
<PRE>
public <B>GifImage</B>()</PRE>
<DL>
<DD>Constructs <code>GifImage</code> with <A HREF="../../../com/gif4j/light/GifImage.html#RESIZE_STRATEGY_EXTEND_TO_CURRENT"><CODE>RESIZE_STRATEGY_EXTEND_TO_CURRENT</CODE></A>&nbsp;resize&nbsp;strategy
 and indefinite general gif image width and height (these parameters will be taken from the first added <code>GifFrame</code>).
<P>
</DL>
<HR>

<A NAME="GifImage(int)"><!-- --></A><H3>
GifImage</H3>
<PRE>
public <B>GifImage</B>(int&nbsp;resizeStrategy)</PRE>
<DL>
<DD>Constructs <code>GifImage</code> of one of the predefined resize strategies
 and indefinite logical screen width and height (these parameters will be taken from the first added <code>GifFrame</code>).
<P>
<DT><B>Parameters:</B><DD><CODE>resizeStrategy</CODE> - one of the predefined resize strategies:<br>
 <A HREF="../../../com/gif4j/light/GifImage.html#RESIZE_STRATEGY_CROP_TO_FIT_IMAGE_SIZE"><CODE>RESIZE_STRATEGY_CROP_TO_FIT_IMAGE_SIZE</CODE></A>,<br>
 <A HREF="../../../com/gif4j/light/GifImage.html#RESIZE_STRATEGY_SCALE_TO_FIT_IMAGE_SIZE"><CODE>RESIZE_STRATEGY_SCALE_TO_FIT_IMAGE_SIZE</CODE></A>,<br>
 <A HREF="../../../com/gif4j/light/GifImage.html#RESIZE_STRATEGY_EXTEND_TO_CURRENT"><CODE>RESIZE_STRATEGY_EXTEND_TO_CURRENT</CODE></A><br></DL>
<HR>

<A NAME="GifImage(int, int)"><!-- --></A><H3>
GifImage</H3>
<PRE>
public <B>GifImage</B>(int&nbsp;width,
                int&nbsp;height)</PRE>
<DL>
<DD>Constructs <code>GifImage</code> with <A HREF="../../../com/gif4j/light/GifImage.html#RESIZE_STRATEGY_SCALE_TO_FIT_IMAGE_SIZE"><CODE>RESIZE_STRATEGY_SCALE_TO_FIT_IMAGE_SIZE</CODE></A>&nbsp;resize&nbsp;strategy
 and the specified general logical screen width and height. All added frames will be validated and resized if need to fit these width and height.
<P>
<DT><B>Parameters:</B><DD><CODE>width</CODE> - logical screen width (in pixels)<DD><CODE>height</CODE> - logical screen height (in pixels)
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - If width and/or height parameter less than 1.</DL>
<HR>

<A NAME="GifImage(int, int, int)"><!-- --></A><H3>
GifImage</H3>
<PRE>
public <B>GifImage</B>(int&nbsp;width,
                int&nbsp;height,
                int&nbsp;resizeStrategy)</PRE>
<DL>
<DD>Constructs <code>GifImage</code> of one of the predefined resize strategies and
 general logical screen width and height. All added frames will be validated and resized if need to fit these width and height.
<P>
<DT><B>Parameters:</B><DD><CODE>width</CODE> - logical screen width (in pixels)<DD><CODE>height</CODE> - logical screen height (in pixels)<DD><CODE>resizeStrategy</CODE> - one of the predefined resize strategies:<br>
 <A HREF="../../../com/gif4j/light/GifImage.html#RESIZE_STRATEGY_CROP_TO_FIT_IMAGE_SIZE"><CODE>RESIZE_STRATEGY_CROP_TO_FIT_IMAGE_SIZE</CODE></A>,<br>
 <A HREF="../../../com/gif4j/light/GifImage.html#RESIZE_STRATEGY_SCALE_TO_FIT_IMAGE_SIZE"><CODE>RESIZE_STRATEGY_SCALE_TO_FIT_IMAGE_SIZE</CODE></A>,<br>
 <A HREF="../../../com/gif4j/light/GifImage.html#RESIZE_STRATEGY_EXTEND_TO_CURRENT"><CODE>RESIZE_STRATEGY_EXTEND_TO_CURRENT</CODE></A><br>
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - If width and/or height parameter less than 1.</DL>

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

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

<A NAME="addGifFrame(com.gif4j.light.GifFrame)"><!-- --></A><H3>
addGifFrame</H3>
<PRE>
public <A HREF="../../../com/gif4j/light/GifImage.html" title="class in com.gif4j.light">GifImage</A> <B>addGifFrame</B>(<A HREF="../../../com/gif4j/light/GifFrame.html" title="class in com.gif4j.light">GifFrame</A>&nbsp;frame)
                     throws java.lang.InterruptedException</PRE>
<DL>
<DD>Add the specified frame to the end of the internal sequence.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>frame</CODE> - <code>GifFrame</code> to add
<DT><B>Returns:</B><DD>this <code>GifImage</code> instance
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - If frame to add is null.
<DD><CODE>java.lang.InterruptedException</CODE><DT><B>See Also:</B><DD><A HREF="../../../com/gif4j/light/GifFrame.html" title="class in com.gif4j.light"><CODE>GifFrame</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setLoopNumber(int)"><!-- --></A><H3>
setLoopNumber</H3>
<PRE>
public void <B>setLoopNumber</B>(int&nbsp;number)</PRE>
<DL>
<DD>Set number of iterations the loop should be executed.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>number</CODE> - Number of iterations the loop should be executed:
   value of 0 set indefinite looping (is set by default).
 Maximum iterations number (excluding indefinite looping) is 65535.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - If number less than 0.</DL>
</DD>
</DL>
<HR>

<A NAME="setDefaultDelay(int)"><!-- --></A><H3>
setDefaultDelay</H3>
<PRE>
public void <B>setDefaultDelay</B>(int&nbsp;delay)</PRE>
<DL>
<DD>Set default delay between frames. This delay is automatically applied to adding frames without delay set.
 If not set - value of 200 (2 seconds) is used.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>delay</CODE> - delay time in 1/100 (centiseconds) - value 100 means delay in 1 second.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - If delay less than 1.</DL>
</DD>
</DL>
<HR>

<A NAME="getCurrentLogicWidth()"><!-- --></A><H3>
getCurrentLogicWidth</H3>
<PRE>
public int <B>getCurrentLogicWidth</B>()</PRE>
<DL>
<DD>get current logic screen width
<P>
<DD><DL>

<DT><B>Returns:</B><DD>current logic screen width</DL>
</DD>
</DL>
<HR>

<A NAME="getCurrentLogicHeight()"><!-- --></A><H3>
getCurrentLogicHeight</H3>
<PRE>
public int <B>getCurrentLogicHeight</B>()</PRE>
<DL>
<DD>get current logic screen height
<P>
<DD><DL>

<DT><B>Returns:</B><DD>current logic screen height</DL>
</DD>
</DL>
<HR>

<A NAME="getLastFrame()"><!-- --></A><H3>
getLastFrame</H3>
<PRE>
public <A HREF="../../../com/gif4j/light/GifFrame.html" title="class in com.gif4j.light">GifFrame</A> <B>getLastFrame</B>()</PRE>
<DL>
<DD>Returns the last added frame
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the last added frame</DL>
</DD>
</DL>
<HR>

<A NAME="addComment(java.lang.String)"><!-- --></A><H3>
addComment</H3>
<PRE>
public void <B>addComment</B>(java.lang.String&nbsp;comment)</PRE>
<DL>
<DD>Add ASCII textual comment to be embedded in this GIF image.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>comment</CODE> - string containing ASCII text comment
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - If comment string is null</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=3 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="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="class-use/GifImage.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&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-files/index-1.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="../../../com/gif4j/light/GifFrame.html" title="class in com.gif4j.light"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../com/gif4j/light/ImageUtils.html" title="class in com.gif4j.light"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="GifImage.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;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">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;<A HREF="#field_detail">FIELD</A>&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>

</BODY>
</HTML>