# av.video.gif 库模块帮助文档
## av.video 成员列表 #
### av.video.gif #
GIF 动图编码：每帧自适应调色板，只写变化区域，相同帧自动合并；C 内核量化与 LZW，不依赖外部组件
### av.video.gif(path,width,height,opt) #
创建 GIF 写出器：opt: fps(write 省略时长时的帧率，默认 12.5，最高 50),loop(默认无限循环；false 只播一遍；数字为重复次数),
colors(每帧最多颜色数 2~256，默认 256),dither(true 用误差扩散，照片、渐变有色带时用),
matte(半透明像素的铺底色 0xRRGGBB，默认白),tolerance(各通道差不超过它的像素视为没变，默认 0)
[返回对象:avVideoGifObject](#avVideoGifObject)
## avVideoGifObject 成员列表 #
### avVideoGifObject.close() #
写完并关闭文件，返回 {path;width;height;frames(实际写出的帧数);seconds;bytes;kb}
### avVideoGifObject.frames #
已写出的帧数
### avVideoGifObject.path #
输出文件完整路径
### avVideoGifObject.write(frame,seconds) #
写一帧：frame 为 gdip.bitmap、av.video.frame、图片路径或预乘 BGRA buffer，尺寸须与 GIF 一致；
seconds 为本帧显示时长（秒，默认 1/fps）。与上一帧完全相同的帧并入上一帧的延时