Manpages

名 前

csepdjvu − 分 割 デ ー タ フ ァ イ ル 用 DjVu エ ン コ ー ダ

書 式

csepdjvu [options] [sepfiles]... outputdjvufile

説 明

こ の プ ロ グ ラ ム は 分 割 さ れ た デ ー タ フ ァ イ ル sepfiles か ら DjVuDocument フ ァ イ ル outputdjvufile を 作 成 し ま す 。 分 割 あ さ れ た デ ー タ フ ァ イ ル の 名 前 の 代 わ り に ダ ッ シ ュ を 一 つ 入 力 す る と 標 準 入 力 か ら デ ー タ を 読 み 込 み ま す 。 こ の 機 能 は パ イ プ か ら csepdjvu へ 分 割 さ れ た デ ー タ を プ ッ シ ュ す る 別 の プ ロ グ ラ ム と 組 み 合 わ せ て 使 用 す る た め に あ り ま す 。 そ れ ぞ れ の 分 割 デ ー タ フ ァ イ ル は 一 つ 以 上 の ペ ー ジ 画 像 を 表 し ま す 。 プ ロ グ ラ ム の 引 数 が マ ル チ ペ ー ジ を 指 定 し て い る 場 合 、 全 て の ペ ー ジ は バ ン ド ル ド 形 式 の 文 書 と し て エ ン コ ー ド さ れ ま す 。 引 数 に シ ン グ ル ペ ー ジ を 指 定 し た 場 合 、 ペ ー ジ は シ ン グ ル ペ ー ジ と し て 保 存 さ れ ま す 。

オ プ シ ョ ン

-d n 出 力 フ ァ イ ル に エ ン コ ー ド さ れ る 解 像 度 情 報 を

DPI で 指 定 し ま

す 。 DjVu フ ァ イ ル に 書 き 込 ま れ る 解 像 度 情 報 は 、 デ コ ー ダ が 画 像 を デ ィ ス プ レ イ に 展 開 す る と き の ど の よ う に ス ケ ー リ ン グ す る か を 決 定 し ま す 。 25 か ら 1200 ま で 指 定 す る こ と が 出 来 ま す 。 デ フ ォ ル ト 値 は 300 dpi で す 。

-q n,...,n
-q
n+...+n

IW44 出 エ ン コ ー ド さ れ る 背 景 レ イ ヤ の 画 質 を 指 定 し ま す 。 オ プ シ ョ ン 引 数 は チ ャ ン ク ご と に カ ン マ や プ ラ ス 記 号 で 区 切 ら れ た 複 数 の 数 値 を 指 定 し ま す 。 オ プ シ ョ ン は c44 プ ロ グ ラ ム の -slice オ プ シ ョ ン と 同 様 で す 。 詳 細 は c44(1) の man page を ご 覧 く だ さ い 。 デ フ ォ ル ト の 画 質 設 定 は -q 72,83,93,103 で す 。 こ の オ プ シ ョ ン は 、 分 割 デ ー タ に 指 定 さ れ て る 野 で は な く DjVu の 仕 様 上 必 要 な 真 っ 白 の 背 景 に は 適 用 出 来 ま せ ん 。 こ う し た 背 景 画 像 は 常 に 可 能 な 限 り 低 い 解 像 度 と 色 の 均 一 性 を 保 証 す る 標 準 の 画 質 設 定 を 使 用 し ま す 。

-v 各 ペ ー ジ を 示 す 短 い メ ッ セ ー ジ を 表 示 し ま す 。

-vv 変 換 中 に 付 加 的 な 情 報 を 表 示 し ま す 。

分 割 デ ー タ フ ァ イ ル 形 式

そ れ ぞ れ の 分 割 デ ー タ フ ァ イ ル 形 式 は 複 数 の 分 割 ペ ー ジ 画 像 の 関 連 情 報 を 持 っ て い ま す 。 各 ペ ー ジ は 論 理 的 に は 透 明 な 前 景 レ イ ヤ と 、 透 明 な ピ ク セ ル か ら 透 け て 見 え る 背 景 レ イ ヤ を 持 ち ま す 。 各 分 割 さ れ た ペ ー ジ 画 像 の デ ー タ は 以 下 の デ ー タ ブ ロ ッ ク の 連 続 で す :

* 「 カ ラ ー

RLE 形 式 」 ま た は 「 白 黒 RLE 形 式 」 で エ ン コ ー ド さ れ た 前 景 画

像 。 形 式 は こ の セ ク シ ョ ン の 後 半 で 解 説 し ま す 。

*

"Portable Pixmap" ( PPM ) で エ ン コ ー ド さ れ た オ プ シ ョ ン の 背 景 画 像 。 こ の 良 く 知 ら れ た フ ォ ー マ ッ ト は こ の セ ク シ ョ ン の 後 半 で 解 説 し ま す 。 背 景 画 像 が 無 い 場 合 は 単 に 真 っ 白 な 背 景 が あ る と 仮 定 し ま す 。

*

"#" 記 号 で 始 ま っ て ラ イ ン フ ィ ー ド 文 字 で 区 切 ら れ る 任 意 の コ メ ン ト 行 。 最 初 の 語 句 が 大 文 字 で 始 ま る コ メ ン ト 行 は 将 来 の 拡 張 の た め に 予 約 さ れ て い ま す 。

背 景 画 像 の 大 き さ (幅 と 高 さ ) は 前 景 画 像 の サ イ ズ を 1 か ら 12 で 割 っ た 値 を 切 り 上 げ で 縮 小 し た も の で な け れ ば な り ま せ ん 。 た と え ば 、 前 景 画 像 の 幅 が 2,507 で 3 で 割 っ て 縮 小 す る 場 合 、 背 景 画 像 の 幅 は (2507+2)/3 の 整 数 値 に な り ま す 。 カ ラ ー RLE 形 式 カ ラ ー RLE 形 式 は イ ン デ ッ ク ス カ ラ ー 用 の シ ン プ ル な run-length エ ン コ ー ド で す 。 デ ー タ は 常 に "R6" の 二 文 字 、 列 数 、 行 数 、 パ レ ッ ト エ ン ト リ の 数 の テ キ ス ト ヘ ッ ダ で 始 ま り ま す 。 全 て の 数 値 は 10 進 数 の ASCII コ ー ド で 表 さ れ ま す 。 こ れ ら の 四 つ の 要 素 は 空 白 文 字 (ス ペ ー ス 、 タ ブ 、 キ ャ リ ッ ジ リ タ ー ン 、 ラ イ ン フ ィ ー ド ) ま た は 、 "#" で 始 ま る コ メ ン ト 行 で 区 切 ら れ て い ま す 。 最 後 の 数 字 に は 通 常 ラ イ ン フ ィ ー ド 一 文 字 が 続 き ま す 。 ヘ ッ ダ の 後 に は カ ラ ー エ ン ト リ 毎 に 3 バ イ ト の カ ラ ー パ レ ッ ト が 続 き ま す 。 各 バ イ ト は RGB の か ら コ ン ポ ー ネ ン ト を 表 し ま す 。 パ レ ッ ト の 後 に は 各 色 に 相 当 す る ピ ク セ ル の run を 示 す 4 バ イ ト の 整 数 (最 も 重 要 な ビ ッ ト が 最 初 ) の 集 ま り が 続 き ま す 。 最 初 の 12 ビ ッ ト は パ レ ッ ト エ ン ト リ の

run の カ ラ ー イ ン デ ッ ク ス を 示 し ま す 。 0xff0 よ り 大 き い カ ラ ー イ ン デ ッ ク ス は 予 約 さ れ て い ま す 。 カ ラ ー イ ン デ ッ ク ス 0xfff は 透 明 な run に 使 用 さ れ ま す 。 各 行 は 画 像 の 幅 に 達 す る ま で 追 加 さ れ る run の シ ー ケ ン ス を 示 し ま す 。 行 は 最 初 の 行 か ら 始 ま っ て 最 後 の 行 ま で 連 続 的 に エ ン コ ー ド さ れ ま す 。 白 黒 RLE 形 式 白 黒 RLE 形 式 は 白 黒 画 像 用 の シ ン プ ル な run-lenght エ ン コ ー ド で す 。 デ ー タ は 常 に "R4" の 二 文 字 、 列 数 、 行 数 の テ キ ス ト ヘ ッ ダ で 始 ま り ま す 。 全 て の 数 値 は 10 進 数 の ASCII コ ー ド で 表 さ れ ま す 。 こ れ ら の 三 つ の 要 素 は 空 白 文 字 (ス ペ ー ス 、 タ ブ 、 キ ャ リ ッ ジ リ タ ー ン 、 ラ イ ン フ ィ ー ド ) ま た は 、 "#" で 始 ま る コ メ ン ト 行 で 区 切 ら れ て い ま す 。 最 後 の 数 字 に は 通 常 ラ イ ン フ ィ ー ド 一 文 字 が 続 き ま す 。 フ ァ イ ル の 残 り の 部 分 は 交 互 に 現 れ る 透 明 な ピ ク セ ル と 黒 い ピ ク セ ル の run の 長 さ を 示 す 数 値 の シ ー ケ ン ス が エ ン コ ー ド さ れ ま す 。 行 は 最 初 の 行 か ら 始 ま っ て 最 後 の 行 ま で 連 続 的 に エ ン コ ー ド さ れ ま す 。 各 行 は 白 の run か ら 始 ま り ま す 。 デ コ ー ダ は run の 長 さ が 画 像 の 列 数 に 一 致 し て い る 場 合 、 行 が 終 わ っ て い る こ と が 分 か り ま す 。 0 か ら 191 は 一 つ の バ イ ト の 0x00 か ら 0xbf で 表 さ れ ま す 。 192 か ら 16383 は 2 バ イ ト シ ー ケ ン ス で 表 さ れ ま す : 最 初 の バ イ ト は 0xc0 か ら 0xff の 範 囲 で 6 つ の 最 も 重 要 な ビ ッ ト を エ ン コ ー ド し 、 二 つ 目 の バ イ ト は 残 り の 8 ビ ッ ト を エ ン コ ー ド し ま す 。 こ の 方 法 は run が 黒 ピ ク セ ル で 始 ま っ て い た り 、 16383 を 超 え る よ う な 非 常 に 長 い run を 分 割 す る 必 要 が あ る 場 合 に 便 利 な 、 長 さ 0 の run を 可 能 に し ま す 。

Portable Pixmap (PPM) 形 式
Portable Pixmap 形 式 は カ ラ ー 画 像 の 形 式 と し て 良 く 知 ら れ て い ま す 。 詳 細 に つ い て は ppm(1) の man Page を ご 覧 く だ さ い 。 デ ー タ は 常 に "P6" の 二 文 字 、 列 数 、 行 数 、 お よ び カ ラ ー コ ン ポ ー ネ ン ト の 最 大 値 (通 常 は 255) か ら な る テ キ ス ト の ヘ ッ ダ で 始 ま り ま す 。 全 て の 数 値 は 10 進 数 の ASCII コ ー ド で す 。 こ れ ら の 三 つ の 要 素 は 空 白 文 字 (ス ペ ー ス 、 タ ブ 、 キ ャ リ ッ ジ リ タ ー ン 、 ラ イ ン フ ィ ー ド ) ま た は 、 "#" で 始 ま る コ メ ン ト 行 で 区 切 ら れ て い ま す 。 最 後 の 数 字 に は 通 常 ラ イ ン フ ィ ー ド 一 文 字 が 続 き ま す 。 残 り の フ ァ イ ル は 全 て の ピ ク セ ル を エ ン コ ー ド し ま す 。 各 ピ ク セ ル は RGB を 示 す 3 バ イ ト の 値 で 表 さ れ ま す 。 ピ ク セ ル は 左 か ら 右 へ 、 上 か ら 下 へ 並 べ ら れ ま す 。

ク レ ジ ッ ト

こ の プ ロ グ ラ ム は Léon Bottou <leonb [AT] users.net> が 開 発 し 、 Bill Riemers <docbill [AT] sourceforge.net> そ の 他 の 方 々 に よ り 改 良 さ れ ま し た 。 こ の man page は Nobchika Morimoto <morimoto [AT] lizardtech.com> が 翻 訳 し ま し た 。

参 照

djvu(1)ppm(5)c44(1)