新聞中心
前言
那么如何通過js在上傳前就拿到它的總幀數(shù)來判斷呢?本文就跟大家分享一種解決方案,并將其封裝成插件發(fā)布至npm倉庫,歡迎各位感興趣的開發(fā)者閱讀本文。

寫在前面
此插件已經(jīng)發(fā)布至npm,采用原生JS編寫支持任意一個前端框架,如果你對其實現(xiàn)原理不感興趣,只是想拿來解決你的實際問題,可以直接通過npm/yarn來安裝,命令如下:
# yarn安裝
yarn add gif-parser-web
# npm安裝
npm install gif-parser-web --save
文檔地址請移步:README.md
思路分析
我們都知道無論什么文件在計算機(jī)中都是以流的形式進(jìn)行存儲的,因此我們可以通過讀取文件流來拿到它的所有信息。Gif類型的文件也是如此,我們只要能知道它的文件流結(jié)構(gòu)就可以根據(jù)它的規(guī)則進(jìn)行解析讀取了。
什么是Gif
Gif的全稱是Graphics Interchange Format,是一種位圖,以8位色重現(xiàn)真彩色的圖像。采用LZW壓縮算法進(jìn)行編碼,可以有效的減少圖像文件在網(wǎng)上的傳輸時間,我們在網(wǎng)站上看到的會動的表情包,基本上都是Gif格式的。
組成結(jié)構(gòu)
正如上面所說,我們想解析gif就得先知道它的文件流結(jié)構(gòu),在What's In A GIF網(wǎng)站中我們知道了它是由多種不同類型的塊組成,如下所示:
- 未標(biāo)記塊:Header(文件頭)、Logical Screen Descriptor(邏輯屏幕描述符)、Global Color Table(全局顏色表)、局部顏色表(Local Color Table)。
- 控制塊:圖形控制擴(kuò)展(Graphics Control Extension)。
- 圖形渲染塊:純文本擴(kuò)展(Plain Text Extension)、圖像描述符(Image Descriptor)。
- 特殊用途塊:應(yīng)用擴(kuò)展( Application Extension)、注解擴(kuò)展(Comment Extension)、數(shù)據(jù)流結(jié)束標(biāo)記(Trailer)。
- 圖像數(shù)據(jù)塊:圖像數(shù)據(jù)(Image Data)。
解析原理
了解完gif的組成結(jié)構(gòu)后,接下來我們來看下如何獲取它的數(shù)據(jù)流,如下所示:
- 讀取Gif圖片文件(從url讀取或者從本地上傳的File類型的數(shù)據(jù));
- 將讀取到的數(shù)據(jù)轉(zhuǎn)成arrayBuffer;
- 將arrayBuffer放到DataView中;
- 使用DataView底層的相關(guān)API來讀取十六進(jìn)制編碼;
- 對十六進(jìn)制編碼進(jìn)行解碼,獲取圖像的信息。
它的解碼過程如下圖所示:
- 從Header開始順著箭頭一直讀到PlainTextExtension完成第一幀的讀取,其中GlobalColorTable、ApplicationExtension、CommentExtension、LocalColorTable、PlainTextExtension不一定存在。
- 接下來重復(fù)GraphicControlExtension、ImageDescriptor、ImageData 讀取剩下的幀圖片數(shù)據(jù)。
- 直至讀取到Trailer標(biāo)識,就完成了整個Gif的讀取。
GIF file stream diagram
注意:在讀取過程中,每個塊都有自己特殊的編碼標(biāo)記。
數(shù)據(jù)塊分析
我們了解完gif的構(gòu)成后,接下來我們來看下每一個具體的數(shù)據(jù)塊的編碼信息。
Header Block
該數(shù)據(jù)塊用于標(biāo)記數(shù)據(jù)流的開始,位于文件頭數(shù)據(jù)流的上下文內(nèi),里面包含了gif的簽名與版本信息,它是必須存在的且只有一個。
該塊在數(shù)據(jù)流中占6個字節(jié),其中簽名與版本信息各占3個字節(jié),即:
- 數(shù)據(jù)流的0-2位置的元素一定表示gif的簽名信息
- 數(shù)據(jù)流的3-5位置的元素一定表示gif的版本信息
我們以89a格式的gif為例,它的Header信息就如下所示:
- Signature的16進(jìn)制值為47、49、46,將其轉(zhuǎn)換為Unicode編碼字符后就為:"G"、"I"、"F"
- Version的16進(jìn)制值為38、39、61,將其轉(zhuǎn)換為Unicode編碼字符后就為:"8"、"9"、"a";
GIF header block layout
我們來看下如何用代碼來讀取。
// 假設(shè)我們已經(jīng)得到了dataView
const signature = dataView.getUint16(0); // 使用getUint16方法從0號位置開始連續(xù)獲取2個字節(jié)的值,轉(zhuǎn)換成轉(zhuǎn)換為Unicode編碼為:G I
const version = dataView.getUint16(2); // 使用getUint16方法從2號位置開始連續(xù)獲取2個字節(jié)的值,轉(zhuǎn)換成轉(zhuǎn)換為Unicode編碼為:F 8
Logical Screen Descriptor
該數(shù)據(jù)塊中定義了圖像在設(shè)備中顯示所需的參數(shù),位于Header數(shù)據(jù)塊的后面,它是必須存在的且只有一個,其值的坐標(biāo)是相對于虛擬屏幕左上角計算出來的。
該塊在數(shù)據(jù)流中占7個字節(jié),包含的信息如下所示:
- Canvas Width 圖片的寬度(以像素為單位),占2個字節(jié)空間。
- Canvas Height 圖片的高度(以像素為單位),占2個字節(jié)空間。
- Packed Fields 壓縮字段,占1字節(jié)空間,里面包含4個值
Global Color Table Flag 全局顏色標(biāo)記,用于標(biāo)識全局顏色表。如果值為0則表示不存在全局顏色塊;如果值為1則表示全局顏色塊緊跟于此塊之后。
Color Resolution 顏色分辨率,即顏色的位數(shù),有1位、8位、16位、32位等。在gif格式的圖像定義中,它的顏色不能超過256種,深度不能超過8位。
Sort Flag 排序標(biāo)記,0為未設(shè)置,1為按重要性遞減排序,最重要的顏色在前。
Size of Global Color Table 全局顏色表的大小,如果值為1,則該字段中的值用于計算全局顏色表中包含的字節(jié)數(shù)。
- Background Color Index 背景顏色索引,它描述了全局顏色表的索引,背景顏色是用于屏幕上未被圖像覆蓋的像素的顏色。如果全局顏色標(biāo)記設(shè)置為0,該字段將會被忽略。
- Pixel Aspect Ratio 像素縱橫比,用于計算原始圖像中像素縱橫比的近似值的因子。如果該值不為0,則近似值的計算公式為:(N + 15) / 64 ,N為像素縱橫比,它的值為像素寬度與其高度的商。
GIF logical screen descriptor block layout
我們用代碼來獲取下它的寬度與高度。
// 假設(shè)我們已經(jīng)得到了dataView
const width = this.dataView.getUint16(6, true);
const height = this.dataView.getUint16(8, true);
Global Color Table
該數(shù)據(jù)塊包含了一個顏色表,由紅-綠-藍(lán)三元組的字節(jié)序列構(gòu)成。正如前面所說,它并非必須存在,如果存在的話它將位于Logical Screen Descriptor塊的后面。
所占的字節(jié)數(shù)為3*2^(N+1),N為全局顏色表的大小 + 1,該數(shù)據(jù)塊在數(shù)據(jù)流中只存在一個,如下圖所示。
GIF global color table block layout
我們來看下代碼的實現(xiàn)。
let pos = 0;
const PaletteColorsRGB = [];
const gifInfo = {}
// 解析全局調(diào)色板
const unpackedField = getBitArray(dataView.getUint8(10));
if (unpackedField[0]) {
const globalPaletteSize = getPaletteSize(unpackedField);
gifInfo.globalPalette = true;
// 計算全局調(diào)色板的大小
gifInfo.globalPaletteSize = globalPaletteSize / 3;
// 調(diào)整指針位置
pos += globalPaletteSize;
// 遍歷獲取此塊區(qū)域的所有顏色并存起來
for (let i = 0; i < gifInfo.globalPaletteSize; i++) {
const palettePos = 13 + i * 3;
const r = dataView.getUint8(palettePos);
const g = dataView.getUint8(palettePos + 1);
const b = dataView.getUint8(palettePos + 2);
PaletteColorsRGB.push({ r, g, b });
}
}
pos += 13;
// 獲取調(diào)色板大小函數(shù)
function getPaletteSize(palette: Array): number {
return 3 * Math.pow(2, 1 + bitToInt(palette.slice(5, 8)));
}
Graphics Control Extension
該數(shù)據(jù)塊包含了處理圖形渲染塊時需要使用的參數(shù),它只包含了一個數(shù)據(jù)子塊。該塊中記錄了7種數(shù)據(jù)的描述,如下所示:
- Extension Introducer 擴(kuò)展導(dǎo)入符,標(biāo)識擴(kuò)展塊的開始,包含固定值0x21。
- Graphic Control Label 圖形控制標(biāo)簽,用于將當(dāng)前塊標(biāo)識為圖形控制擴(kuò)展,包含固定值0xF9;
- Byte Size 塊中的字節(jié)數(shù),在此字段之后,直到但不包括終止符。該字段包含固定值4,里面包含了4種數(shù)據(jù)的描述。
Reserved for Future Use 保留模塊。
Disposal Method 處理方法,表示圖形在顯示后的處理方式。
User Input Flag 用戶輸入標(biāo)識,在繼續(xù)之前是否需要用戶輸入,如果是0則不需要用戶輸入,1代表需要用戶輸入。輸入的性質(zhì)由程序決定(如回車、鼠標(biāo)點擊等)。
Transparency Color Flag 透明標(biāo)識,用于描述是否在透明索引字段中給出了透明索引。0:未給出透明索引;1:給出了透明索引。
- Delay Time 當(dāng)前幀圖像的延遲時間,如果不為0,則表示該字段在繼續(xù)處理數(shù)據(jù)流之前等待的百分之一秒(即gif每一幀的時長)。
- Transparency Index 透明度指數(shù)。
- Block Terminator 塊終止符,用于標(biāo)識圖形控制擴(kuò)展塊的結(jié)束。
GIF graphic control extension block layout
此處我們最關(guān)心的就是如何取出gif每一幀的時長,我們來看下代碼的實現(xiàn)。
// 假設(shè)我們已經(jīng)得到了dataView且pos可能指向圖形控制快
const type = dataView.getUint8(pos);
// 圖形控制塊
if (type === 0xf9) {
const length = dataView.getUint8(this.pos + 2);
if (length === 4) {
// 獲取每一幀的時長
const delay = getFrameDuration(dataView.getUint16(pos + 4, true));
pos += 8;
}
}
Image Descriptor
一個gif文件可能會包含多個圖像,每個圖像都以一個圖像描述符塊開始。這個塊在數(shù)據(jù)流中占10個字節(jié)。該塊中記錄了6種數(shù)據(jù)的描述,如下所示:
- Image Separator 圖像分割符,用于標(biāo)識此數(shù)據(jù)塊的開頭,它的固定值為0x2C。
- Image Left Position 圖像左位置,圖像左邊緣距離邏輯屏幕左邊緣的行數(shù)(以像素為單位)。
- Image Top Position 圖像頂部位置,圖像頂部邊緣相對于邏輯屏幕頂部邊緣的行數(shù)(以像素為單位)。
- Image Width 圖像寬度。
- Image Height 圖像高度。
- Packed Field 壓縮塊。
Local Color Table Flag 局部顏色表標(biāo)志,緊跟在該圖像描述符之后的局部顏色表的存在,0:不存在,則使用全局顏色表,1:存在,則使用緊跟其后的Local Color Table數(shù)據(jù)塊。
Interlace Flag 隔行標(biāo)志,標(biāo)識圖像是否是隔行的(圖像以四遍交錯模式交錯)。
Sort Flag 排序標(biāo)志 - 指示本地顏色表是否已排序。0:未設(shè)置排序,1:按重要性遞減排序,最重要的顏色在前。
Size of Local Color Table 局部顏色表的大小。
GIF image descriptor block layout
Image Data
該塊由一系列子塊組成,每個子塊的大小最多為255字節(jié),包含對圖像中每個像素的活動顏色表的索引, 像素索引按從左到右和從上到下的順序排列。每個索引必須在活動顏色表的大小范圍內(nèi),從 0 開始。索引序列使用具有可變長度代碼的 LZW 算法進(jìn)行編碼,如下所示。
GIF image data block layout
GIF image data block layout
每解析完一輪Image Descriptor都需要讀取下Data Sub-blocks,直至所有子塊被讀取完畢。
實現(xiàn)代碼
通過前面的了解,我們知道了Gif圖像中每個數(shù)據(jù)塊的組成原理,接下來我們就可以編寫代碼來解決我們所遇到的問題了。
我們將數(shù)據(jù)塊分析章節(jié)的思路整理下,核心代碼如下所示:
- 插件初始化的時候,接受一個url作為可選參數(shù),如果存在則使用fetch解析這個url,將最終的數(shù)據(jù)放入dataView中。
- 暴露一個getInfo方法用于獲取Gif的信息,接受一個File類型的可選參數(shù),如果url與此參數(shù)同時傳入,則優(yōu)先使用此參數(shù)。
- 完整代碼:main.ts。
export default class GifParser {
private urlLoadStatus: boolean | undefined = undefined;
private dataView: DataView | undefined;
// 當(dāng)前指向DataView的指針位置
private pos = 0;
// 當(dāng)前解析的幀索引
private index = 0;
private gifInfo: gifInfoType = {
valid: false,
globalPalette: false,
globalPaletteSize: 0,
globalPaletteColorsRGB: [],
loopCount: 0,
height: 0,
width: 0,
animated: false,
images: [],
duration: 0,
identifier: "0"
};
constructor(url?: string) {
if (url) {
this.urlLoadStatus = false;
// 解析url,將其轉(zhuǎn)化為DataView格式的數(shù)據(jù)
fetch(url)
.then((response) => response.arrayBuffer())
.then((arrayBuffer) => {
return new DataView(arrayBuffer);
})
.then((dataView) => {
// GIF加載成功
this.urlLoadStatus = true;
this.dataView = dataView;
});
}
}
/**
* 獲取圖像信息
* @param gifStream
*/
public async getInfo(gifStream?: File): Promise {
// 參數(shù)有效性校驗
await this.validityCheck(gifStream);
// url與gifStream都未傳入則拋出異常
if (this.dataView == null) {
throw new Error("未找到GIF解析源, 請檢查參數(shù)是否正確傳入");
}
// 只解析GIF8格式的圖像:使用getUint16獲取2個字節(jié)十六進(jìn)制值,判斷它是否滿足Gif格式的Header塊的簽名與版本號
// 47 49 為簽名信息,轉(zhuǎn)換為Unicode編碼為:G I
// 46 38 為版本信息,轉(zhuǎn)換為Unicode編碼為:F 8
if (
this.dataView.getUint16(0) != 0x4749 ||
this.dataView.getUint16(2) != 0x4638
) {
return this.gifInfo;
}
// 經(jīng)過上述判斷后,此時的GIF已經(jīng)有效了
this.gifInfo.valid = true;
// 獲取GIF圖像的寬,高
this.gifInfo.width = this.dataView.getUint16(6, true);
this.gifInfo.height = this.dataView.getUint16(8, true);
// 獲取全局調(diào)色板、讀取每一幀的圖像信息等代碼省略,請移步GitHub查看完整代碼
}
} 測試用例
最后,我們將插件打包,寫一個簡單的demo來測試下。
gifParserPlugin demo
運行結(jié)果如下所示。
- gif的寬度是748px,高度是358px。
- gif的總時長為11400ms,總共有114幀。
本文題目:聊聊JS獲取GIF總幀數(shù)
新聞來源:http://m.fisionsoft.com.cn/article/cohojoo.html


咨詢
建站咨詢
