AnimatedGifEncoder (hutool-core 5.8.9 API)

java.lang.Object
- cn.hutool.core.img.gif.AnimatedGifEncoder

public class AnimatedGifEncoder
extends Object

动态GIF动画生成器，可生成一个或多个帧的GIF。

 Example:
    AnimatedGifEncoder e = new AnimatedGifEncoder();
    e.start(outputFileName);
    e.setDelay(1000);   // 1 frame per sec
    e.addFrame(image1);
    e.addFrame(image2);
    e.finish();

来自：https://github.com/rtyley/animated-gif-lib-for-java

从以下版本开始:: 5.3.8
版本:: 1.03 November 2003
作者:: Kevin Weiner, FM Software

字段概要

字段
限定符和类型	字段和说明
`protected Color`	`background`
`protected boolean`	`closeStream`
`protected int`	`colorDepth`
`protected byte[]`	`colorTab`
`protected int`	`delay`
`protected int`	`dispose`
`protected boolean`	`firstFrame`
`protected int`	`height`
`protected BufferedImage`	`image`
`protected byte[]`	`indexedPixels`
`protected OutputStream`	`out`
`protected int`	`palSize`
`protected byte[]`	`pixels`
`protected int`	`repeat`
`protected int`	`sample`
`protected boolean`	`sizeSet`
`protected boolean`	`started`
`protected int`	`transIndex`
`protected Color`	`transparent`
`protected boolean`	`transparentExactMatch`
`protected boolean[]`	`usedEntry`
`protected int`	`width`

构造器概要

构造器
构造器和说明

AnimatedGifEncoder()

构造器
构造器和说明
`AnimatedGifEncoder()`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`boolean`	`addFrame(BufferedImage im)` Adds next GIF frame.
`protected void`	`analyzePixels()` Analyzes image colors and creates color map.
`protected int`	`findClosest(Color c)` Returns index of palette color closest to c
`protected int`	`findExact(Color c)` Returns index of palette exactly matching to color c or -1 if there is no exact matching.
`boolean`	`finish()` Flushes any pending data and closes output file.
`protected void`	`getImagePixels()` Extracts image pixels into byte array "pixels"
`boolean`	`isStarted()`
`void`	`setBackground(Color c)` Sets the background color for the last added frame and any subsequent frames.
`void`	`setDelay(int ms)` 设置每一帧的间隔时间 Sets the delay time between each frame, or changes it for subsequent frames (applies to last frame added).
`void`	`setDispose(int code)` Sets the GIF frame disposal code for the last added frame and any subsequent frames.
`void`	`setFrameRate(float fps)` Sets frame rate in frames per second.
`void`	`setQuality(int quality)` Sets quality of color quantization (conversion of images to the maximum 256 colors allowed by the GIF specification).
`void`	`setRepeat(int iter)` Sets the number of times the set of GIF frames should be played.
`void`	`setSize(int w, int h)` Sets the GIF frame size.
`void`	`setTransparent(Color c)` Sets the transparent color for the last added frame and any subsequent frames.
`void`	`setTransparent(Color c, boolean exactMatch)` Sets the transparent color for the last added frame and any subsequent frames.
`boolean`	`start(OutputStream os)` Initiates GIF file creation on the given stream.
`boolean`	`start(String file)` Initiates writing of a GIF file with the specified name.
`protected void`	`writeGraphicCtrlExt()` Writes Graphic Control Extension
`protected void`	`writeImageDesc()` Writes Image Descriptor
`protected void`	`writeLSD()` Writes Logical Screen Descriptor
`protected void`	`writeNetscapeExt()` Writes Netscape application extension to define repeat count.
`protected void`	`writePalette()` Writes color table
`protected void`	`writePixels()` Encodes and writes pixel data
`protected void`	`writeShort(int value)` Write 16-bit value to output stream, LSB first
`protected void`	`writeString(String s)` Writes string to output stream

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - width
```
protected int width
```
  - height
```
protected int height
```
  - transparent
```
protected Color transparent
```
  - transparentExactMatch
```
protected boolean transparentExactMatch
```
  - background
```
protected Color background
```
  - transIndex
```
protected int transIndex
```
  - repeat
```
protected int repeat
```
  - delay
```
protected int delay
```
  - started
```
protected boolean started
```
  - out
```
protected OutputStream out
```
  - image
```
protected BufferedImage image
```
  - pixels
```
protected byte[] pixels
```
  - indexedPixels
```
protected byte[] indexedPixels
```
  - colorDepth
```
protected int colorDepth
```
  - colorTab
```
protected byte[] colorTab
```
  - usedEntry
```
protected boolean[] usedEntry
```
  - palSize
```
protected int palSize
```
  - dispose
```
protected int dispose
```
  - closeStream
```
protected boolean closeStream
```
  - firstFrame
```
protected boolean firstFrame
```
  - sizeSet
```
protected boolean sizeSet
```
  - sample
```
protected int sample
```
- 构造器详细资料
  - AnimatedGifEncoder
```
public AnimatedGifEncoder()
```
- 方法详细资料
  - setDelay
```
public void setDelay(int ms)
```
    设置每一帧的间隔时间 Sets the delay time between each frame, or changes it for subsequent frames (applies to last frame added).
    
    参数:
    
    ms - 间隔时间，单位毫秒
  - setDispose
```
public void setDispose(int code)
```
    Sets the GIF frame disposal code for the last added frame and any subsequent frames. Default is 0 if no transparent color has been set, otherwise 2.
    
    参数:
    
    code - int disposal code.
  - setRepeat
```
public void setRepeat(int iter)
```
    Sets the number of times the set of GIF frames should be played. Default is 1; 0 means play indefinitely. Must be invoked before the first image is added.
    
    参数:
    
    iter - int number of iterations.
  - setTransparent
```
public void setTransparent(Color c)
```
    Sets the transparent color for the last added frame and any subsequent frames. Since all colors are subject to modification in the quantization process, the color in the final palette for each frame closest to the given color becomes the transparent color for that frame. May be set to null to indicate no transparent color.
    
    参数:
    
    c - Color to be treated as transparent on display.
  - setTransparent
```
public void setTransparent(Color c,
                           boolean exactMatch)
```
    Sets the transparent color for the last added frame and any subsequent frames. Since all colors are subject to modification in the quantization process, the color in the final palette for each frame closest to the given color becomes the transparent color for that frame. If exactMatch is set to true, transparent color index is search with exact match, and not looking for the closest one. May be set to null to indicate no transparent color.
    
    参数:
    
    c - Color to be treated as transparent on display.
    
    exactMatch - If exactMatch is set to true, transparent color index is search with exact match
  - setBackground
```
public void setBackground(Color c)
```
    Sets the background color for the last added frame and any subsequent frames. Since all colors are subject to modification in the quantization process, the color in the final palette for each frame closest to the given color becomes the background color for that frame. May be set to null to indicate no background color which will default to black.
    
    参数:
    
    c - Color to be treated as background on display.
  - addFrame
```
public boolean addFrame(BufferedImage im)
```
    Adds next GIF frame. The frame is not written immediately, but is actually deferred until the next frame is received so that timing data can be inserted. Invoking finish() flushes all frames. If setSize was not invoked, the size of the first image is used for all subsequent frames.
    
    参数:
    
    im - BufferedImage containing frame to write.
    
    返回:
    
    true if successful.
  - finish
```
public boolean finish()
```
    Flushes any pending data and closes output file. If writing to an OutputStream, the stream is not closed.
    
    返回:
    
    is ok
  - setFrameRate
```
public void setFrameRate(float fps)
```
    Sets frame rate in frames per second. Equivalent to setDelay(1000/fps).
    
    参数:
    
    fps - float frame rate (frames per second)
  - setQuality
```
public void setQuality(int quality)
```
    Sets quality of color quantization (conversion of images to the maximum 256 colors allowed by the GIF specification). Lower values (minimum = 1) produce better colors, but slow processing significantly. 10 is the default, and produces good color mapping at reasonable speeds. Values greater than 20 do not yield significant improvements in speed.
    
    参数:
    
    quality - int greater than 0.
  - setSize
```
public void setSize(int w,
                    int h)
```
    Sets the GIF frame size. The default size is the size of the first frame added if this method is not invoked.
    
    参数:
    
    w - int frame width.
    
    h - int frame width.
  - start
```
public boolean start(OutputStream os)
```
    Initiates GIF file creation on the given stream. The stream is not closed automatically.
    
    参数:
    
    os - OutputStream on which GIF images are written.
    
    返回:
    
    false if initial write failed.
  - start
```
public boolean start(String file)
```
    Initiates writing of a GIF file with the specified name.
    
    参数:
    
    file - String containing output file name.
    
    返回:
    
    false if open or initial write failed.
  - isStarted
```
public boolean isStarted()
```
  - analyzePixels
```
protected void analyzePixels()
```
    Analyzes image colors and creates color map.
  - findClosest
```
protected int findClosest(Color c)
```
    Returns index of palette color closest to c
    
    参数:
    
    c - Color
    
    返回:
    
    index
  - findExact
```
protected int findExact(Color c)
```
    Returns index of palette exactly matching to color c or -1 if there is no exact matching.
    
    参数:
    
    c - Color
    
    返回:
    
    index
  - getImagePixels
```
protected void getImagePixels()
```
    Extracts image pixels into byte array "pixels"
  - writeGraphicCtrlExt
```
protected void writeGraphicCtrlExt()
                            throws IOException
```
    Writes Graphic Control Extension
    
    抛出:
    
    IOException - IO异常
  - writeImageDesc
```
protected void writeImageDesc()
                       throws IOException
```
    Writes Image Descriptor
    
    抛出:
    
    IOException - IO异常
  - writeLSD
```
protected void writeLSD()
                 throws IOException
```
    Writes Logical Screen Descriptor
    
    抛出:
    
    IOException - IO异常
  - writeNetscapeExt
```
protected void writeNetscapeExt()
                         throws IOException
```
    Writes Netscape application extension to define repeat count.
    
    抛出:
    
    IOException - IO异常
  - writePalette
```
protected void writePalette()
                     throws IOException
```
    Writes color table
    
    抛出:
    
    IOException - IO异常
  - writePixels
```
protected void writePixels()
                    throws IOException
```
    Encodes and writes pixel data
    
    抛出:
    
    IOException - IO异常
  - writeShort
```
protected void writeShort(int value)
                   throws IOException
```
    Write 16-bit value to output stream, LSB first
    
    参数:
    
    value - 16-bit value
    
    抛出:
    
    IOException - IO异常
  - writeString
```
protected void writeString(String s)
                    throws IOException
```
    Writes string to output stream
    
    参数:
    
    s - String
    
    抛出:
    
    IOException - IO异常

类 AnimatedGifEncoder

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

width

height

transparent

transparentExactMatch

background

transIndex

repeat

delay

started

out

image

pixels

indexedPixels

colorDepth

colorTab

usedEntry

palSize

dispose

closeStream

firstFrame

sizeSet

sample

构造器详细资料

AnimatedGifEncoder

方法详细资料

setDelay

setDispose

setRepeat

setTransparent

setTransparent

setBackground

addFrame

finish

setFrameRate

setQuality

setSize

start

start

isStarted

analyzePixels

findClosest

findExact

getImagePixels

writeGraphicCtrlExt

writeImageDesc

writeLSD

writeNetscapeExt

writePalette

writePixels

writeShort

writeString