PDF を FlashPlayer 内で作成する為のライブラリです。 Java の iText ライブラリを AS3 移植とのことです。 チャプタ・セクション・パラグラフ・フレーズ・イメージなどの基本要素と、カラム・リスト・テーブル・セルなどのレイアウト要素を用い自由にレイアウトした PDF を作成することができます。 また、 AS の GraphicsAPI のようなベクターグラフィックスやグラデーション塗りにも対応した多機能なライブラリです。

purePDF についての情報は下記リンクをご覧下さい。

• purePDF, a complete actionscript PDF library - sephiroth.it - flash world
• purepdf - Project Hosting on Google Code
• purepdfを使って日本語フォントを指定したpdfを作る - nod::ぶろぐ:RIA::Flex/AIR/Flash

問題点

日本語などの 2 バイト文字が特定の環境下で正常に出力できません。 これはライブラリのバグではなく、 FlashPlayer 10.0 のバグです。 FlashPlayer 10.1 (10/05/10 時点では RC4) だとバグフィックスされているので、バグ対応することなく日本語の使用が可能です。（nod さんからTwitter で教えて頂きました。ありがとうございます。） Windows FlashPlayer 10.0 では日本語が全て文字化けして出力されます。 Macintosh FlashPlayer 10.0 では 2 バイト文字中に 1 バイト文字が入ると同要素内の以降の文字が出力されません。 Linux FlashPlayer 10.0 では何も出力されません。

原因

環境によって問題の現象が異なりますが、原因は同じ関数のバグによるものです。 ByteArray.writeMultiByte(hoge, 'unicodeFFFE')が FlashPlayer10.0 で 正常に動作していないことが直接の原因です。

対処法

FlashPlayer10.0 で encoding が 'UnicodeBigUnmarked' の場合、文字列を走査し、キャラクタコードを書き込みます。 jp.ferv.blog » Blog Archive » ByteArray に ‘unicodeFFFE’ を書き込む際のバグ に諸環境下でのバグの症状と対応策の詳細を書きましたので、合わせてご覧下さい。

バグFIX済み purePDF によるプレビュー

ローマ字・半角カナ・第一水準漢字・第二水準漢字を書き込んだ PDF を FlashPlayer 内で作成します。

• Windows FlashPlayer 10.0.45.2 plug-in
• Windows FlashPlayer 10.0.45.2 activeX
• Macintosh FlashPlayer 10.0.45.2 plug-in
• Linux FlashPlayer 10.0.45.2 plug-in

対応済み purePDF のソース・swc と Expample 用の as ファイルのダウンロード

purePDF_jp.zip

purePDF のライセンスは LGPL なので、継承して LGPL ライセンスでの配布となります。

変更箇所

バグのある関数をコールしている箇所を、 ByteArrayUtils クラス内のバグ対応用の関数をコールするように変更します。

• ActionScript
• PdfEncodings.as
• Source

//byte.buffer.writeMultiByte( text, ByteArrayUtils.getEncoding( encoding ) );
ByteArrayUtils.writeMultiByte( byte.buffer, text, ByteArrayUtils.getEncoding( encoding ) ); // modified by dsk(http://ferv.jp)

バグ対応用の関数です。 まず Capabilities.version から FlashPlayer のバージョンを判定します。 問題のないバージョンの場合は文字列を走査せず、 そのまま writeMultiByte() で書き込みます。 問題のあるバージョンの場合は文字列を走査しつつキャラクタコードを取得し、 2 バイトに収まるキャラクタコードの場合は writeShort() で書き込み、 収まらない場合は 4 バイトとして writeUnsignedInt() で書き込みます。

• ActionScript
• ByteArrayUtils.as
• Source

import flash.system.Capabilities;

• ActionScript
• ByteArrayUtils.as
• Source

/**
 * @author dsk (http://ferv.jp)
 */
private static var _specifiedVersion:Boolean = false;

/**
 * @author dsk (http://ferv.jp)
 */
private static var _isUnder10_1:Boolean;

• ActionScript
• ByteArrayUtils.as
• Source

/**
 * bug fix : fail to work "buffer.writeMultiByte( value, 'unicodeFFFE' )" at FP10.0;
 * @author dsk (http://ferv.jp)
 */
public static function writeMultiByte( buffer: ByteArray, value: String, charSet: String ):void
{
	if (!_specifiedVersion)
		_specifyVersion();
	
	if (!(_isUnder10_1 && charSet = 'unicodeFFFE'))
		buffer.writeMultiByte( value, charSet );
	else
		_writeUnicodeFFFEByte( buffer, value );
	
	buffer.position = 0;
}

/**
 * emulate writing utf-16 BE
 * bug fix : fail to work "buffer.writeMultiByte( value, 'unicodeFFFE' )" at FP10.0
 * @author dsk (http://ferv.jp)
 */
private static function _writeUnicodeFFFEByte( buffer: ByteArray, value: String ):void
{
	var len:int = value.length;
	var i:int, code:uint;
	for (i = 0; i < len; i ++)
	{
		code = value.charCodeAt(i);
		if (code < 0x10000)
			buffer.writeShort(code);
		else
			buffer.writeUnsignedInt(code);
	}
}

/**
 * specify the Flash Player platform and version
 * @author dsk (http://ferv.jp)
 */
private static function _specifyVersion():void
{
	var info:Array = Capabilities.version.split(' ');
	var versions:Array = info[1].split(',');
	var majorMinor:Number = parseFloat(versions[0] + '.' + versions[1]);
	_isUnder10_1 = (majorMinor < 10.1);
	trace('ByteArrayUtils.specifyVersion. to be implemented :', 'isUnder10_1 =', _isUnder10_1);
	
	_specifiedVersion = true;
}

ByteArray.writeMultiByte() メソッドには 2 バイト文字の 処理に不具合があります。 utf-16 BE (BigEndian) を書き込んだ際の諸環境で起こるバグの症状の確認の為の サンプルを wonderfl で書いてみました。 また、バグ対応のコードも合わせて確認します。

Windows FlashPlayer 10.0.45.2 plug-in/activeX

unicodeFFFE を指定したにもかかわらず shif_jis のキャラクタコードで書き込まれます。

Macintosh FlashPlayer 10.0.45.2 plug-in

2 バイト文字のみの間は utf-16 BE のキャラクタコードが正常に書き込まれますが、 1 バイト文字が混在すると以降のキャラクタコードが書き込まれません。

Linux FlashPlayer 10.0.45.2 plug-in

何も書き込まれません。

バグの対処法の解説

unicodeFFFE とは、utf-16 BE (BigEndian) なので String.charCodeAt(index);で一文字ずつですが取得可能です。 utf-16 では 1 文字を 2 バイトもしくは 4 バイトで定義しています。 つまり、文字列を一文字ずつ走査し、 charCodeAt() メソッドでキャラクタコードを取得し、 0x0000 〜 0xFFFF の範囲なら writeShort() メソッドで 2 バイトとして書き込み、 0x00010000 〜 0xFFFFFFFF の範囲なら writeUnsignedInt() メソッドで 4 バイトとして ByteArray に書き込めばよいことになります。
// ただし、日本語の場合は第二水準漢字まで含めても 2 バイト内に収まります。

FlashPlayer10ではFileReferenceクラスが拡張され、ローカルのデータをサーバーを介することなくFlashPlayerに読み込めるようになりました。

試してみようと思いつつ、データをFlashPlayerにロードしてローカルにセーブするだけだと面白くないんで、iPhone風のアイコンジェネレータiConeを作ってみました。
アイコンはiPhone Icon Style .psd KitWEIRDのを使ってます。
背景透明の矩形のpngとかgifを"Load"して、アイコン色とか背景色変えて"セーブ"でローカルに保存するって感じで使います。

またひとつFlashの守備範囲が広くなって楽しくなったなーと。ただ、AIRのメリットはひとつ減ったような気がしますけど。

flashplayer10_api.swf

FlashPlayer10のflash.text.engine.*が気になったけど、サンプル見つからなかった。
手始めにElementFormatがどんな感じか見てみることに。

ごりごり使うには、オーサリングツール側で調整できるようにならないと現実問題厳しい感じ。
FlashCS4に期待。