12 PPS と PDFlib Block Plugin

12.8 ブロックをプログラム 的 に 生 成 ・ 取 り 込 み
12.8.1 PDFlib ブロックを POCA で 生 成
PDFlib ブ ロ ッ ク は、PPS に 内 蔵 さ れてい る POCA イ ン タ フ ェースでプ ロ グ ラ ム 的 に 生 成 す
る こ と も 可 能 です。 POCA を 用 い る と 、 ブ ロ ッ ク のために 必 要 な PDF データ 構 造 を 作 成
したうえで、PDF_begin/end_page_ext( ) の blocks オプシ ョ ンに 与 える こ とができ ます。 ブ
ロ ッ ク 定 義 を 作 成 する 際 には、 357 ページ 「12.9 PDFlib ブ ロ ッ ク の 仕 様 」 の 要 請 に 従 う 必
要 があ り ます。 ブ ロ ッ ク プ ロパテ ィ は、 340 ページ 「12.6 ブ ロ ッ ク のプ ロパテ ィ 」 に 挙 げ
たデータ 型 に 従 って 作 成 する 必 要 があ り ます。
クックブック PDFlib ブロックを PPS で 作 成 するためのコードサンプルが PDFlib クックブックのblockhandling-and-pps
カテゴリにあります。
PDFlib ブ ロ ッ ク の 仕 様 には、 1 つのブ ロ ッ ク の 名 前 が 2 回 記 録 さ れてい る と い う 残 念 な 冗
長 性 があ り ます。 ページの メ イ ン Blocks 辞 書 内 に 1 回 と 、 特 定 のブ ロ ッ ク 辞 書 内 の Name
項 目 に も う 1 回 です。 こ の 2 個 の 名 前 は、 そのブ ロ ッ ク に PPS で 流 し 込 みを 行 う 際 や、 そ
のブ ロ ッ ク を Block Plugin でプレ ビ ューする 際 に 問 題 が 起 こ る こ と を 避 け る ために、 同 一
でなければな り ません。 PDF_begin/end_page_ext( ) はそのため、 blocks オプシ ョ ンで 与 え
られた 辞 書 がこの 「 同 一 ブロ ッ ク 名 」 規 則 に 違 反 するブロ ッ ク 定 義 を 含 んでいる 場 合 に
は、 例 外 を 発 生 さ せます。 下 記 のコー ド サンプルでは、 対 応 する 対 を 青 色 で 示 し ています。
下 記 のコー ド 断 片 では、357 ページ「ブ ロ ッ ク 辞 書 のキー」で 示 すブ ロ ッ ク 定 義 を POCA
関 数 群 を 用 いて 作 成 する 様 子 を 演 示 し ています :
/* ブロック 辞 書 を 作 成 */
blockdict = p.poca_new("containertype=dict usage=blocks");
/* ---------------------------------------------------------
* テキストブロックを 作 成
* ---------------------------------------------------------
*/
textblock = p.poca_new("containertype=dict usage=blocks type=name key=Type value=Block");
container1 = p.poca_new("containertype=array usage=blocks " +
"type=integer values={70 640 300 700}");
p.poca_insert(textblock, "type=array key=Rect value=" + container1);
p.poca_insert(textblock, "type=name key=Name value=job_title");
p.poca_insert(textblock, "type=name key=Subtype value=Text");
p.poca_insert(textblock, "type=name key=fitmethod value=auto");
p.poca_insert(textblock, "type=name key=fontname value=Helvetica");
p.poca_insert(textblock, "type=float key=fontsize value=12");
/* このブロックをページのブロック 辞 書 内 に 挿 入 */
p.poca_insert(blockdict, "type=dict key=job_title direct=false value=" + textblock);
/* ---------------------------------------------------------
* 画 像 ブロックを 作 成
* ---------------------------------------------------------
*/
imageblock = p.poca_new("containertype=dict usage=blocks " +
"type=name key=Type value=Block");
container2 = p.poca_new("containertype=array usage=blocks " +
12.8 ブロ ッ ク を プ ログ ラム 的 に 生 成 ・ 取 り 込 み 355