SWF Editor for PHP
目的
- Flash SWF ファイル内のコンテンツを入れ替える
- テキストツールで貼り付けた文字列の入れ替え
- JPEG画像の入れ替え
- Adobe CS3 等で生成した SWF の必要な部分だけ PHP+swfed で書き換える事で、Flash 開発者と PHP 開発者が得意な部分に注力できます。
- 最小限の処理で書き換えを行っているので、ming のように1からファイルを構成するより負荷が軽めです。
設計
- PHP extension (php 5.1.6, 5.2.5 で動作確認)
- bit stream 処理は自作 (もし良いのがあったら誰か教えて…)
- tag ブロック分割は無条件で処理するが、tag の詳細parse は必要な時だけ行う。
- CWF (zlib 圧縮) 対応
は後回し (でも、後で対応できるように) ← 対応しました
仕様
- php.ini の ext 設定に swfed.so を追加
- PHP extension API (実装済)
class SWFEditor {
function input(string swddata) return true/false;
function output() return string swfdata;
function swfInfo() return ; // print swfInfo
function getTagList();
return array(array('tag'=>long,
'length'=>long,
'detail'=>bool),
...)
function getTagDetail(integer seqno);
return array(...); image_id とかそれ系
function getJpegData(integer image_id)
return string jpegdata;
function getJpegAlpha(integer image_id)
return string alphadata;
function replaceJpegData(integer image_id, string jpegdata
[,string alphadata])
return true/false;
function getEditTextString(string variable_name); return text;
function replaceEditTextString(string variable_name, string text)
return true/false;
※ Flash ver 6 以降は UTF-8 だが、Flash Lite は ver 4 相当なので CP932(SJIS-Win)エンコーディング。
- PHP extension API (一部実装) compress のみ実装、frame とか色々追加予定
function getHeaderInfo() return array('compress'=>...);
function setHeaderInfo(array('compress'=>...))
return true/false;
- PHP extension API (未実装)
function getSymbolSWF(string symbol_name)
return swfdata;
function replaceSymbolSWF(string symbol_name, string swfdata)
return true/false;
function getActionData(integer seqno); // 微妙
function disasmActionData(string actiondata);
return Array(Array('op'=>$code,
'len'=>$len
'data'=>$data)
);
function asmActiondata(Array());
return action_data;
function replaceActionData(integer seqno, string actiondata);
return true/false;
function getAlphaDataFromGIFData(string gifdata)
return alphadata;
function getTagData(integer seqno);
return string tagdata;
(BMP を読み込むライブラリを知らないので、とりあえず PNG だけ)
function getPNGData(integer image_id)
return string pngdata;
function replacePNGData(integer image_id, string pngdata)
return true/false;
}
使用例 (サンプルコード)
実装
- なるべく swf_{object|header|tag|...}.c 側に処理を作って、swfed.c はそこへの橋渡しに徹する。
- swf_tag_<タグ名の省略形>.[hc]
swf_tag_info_table に swf_tag_detail_handler_t の形式で関数ポインタ群を設定
-> {create, identity, output, print, destroy}
成果物
プログラム
実験ページ
インストール方法
モジュールのビルド
- swfed をディレクトリ毎もってくる
php ソースツリーの ext 以下に swfed を配置 任意のディレクトリで大丈夫です
- swfed で phpize & configure & make
cd swfed
phpize
./configure
make
モジュール(新規)設置
- php の extension ディレクトリに so を copy
- php.ini に extension 設定追加
- apachectl graceful
su
cp modules/swfed.so <php_ext_dir>/.
vi <php_ini_dir>/php.ini
apache graceful
モジュール更新
- apachectl stop
- extension ディレクトリに so を copy
- apachectl start
su
apache stop
cp modules/swfed.so <php_ext_dir>/.
apache start
※ もし、無停止で更新する方法があれば、どなたかご教授頂けませんか。(無理っぽいけど)
日記
課題
近日中に対応
- メモリ管理のブラッシュアップ
- エージングに耐えられるように
- おかしな SWF を食わせてもリークしないように
- swfed.c の new_buff の処理を何とかする。
未定
- ベクタ画像の入れ替えを検討中。(携帯でビットマップを多用すると容量的にキツい)
- DefineBitsLossless(未圧縮画像, BMP とか PNG 等)も要望があれば対応する。
- swf_tag.c の処理が冗長なので何とかする
FAQ
loadVariable や loadMovie でよくない?
- それらを実行する時に通信が発生しますが、初めに送る Flash に反映されていれば、その通信がいらなくなるかなと…。そんな事気にしないと言われてたら、それまでですが。
- あと、携帯ではボタンを押してイベントを発生させないと、これらで通信が出来ません。なので、開いてすぐに動的なデータを使いたい。といった場合に対応できません。
何故、ming を使わないの?
- ming は一から SWF ファイルを生成するツールで、既存の SWF ファイルを書き換える機能はありません。
- 動的でなくても良いデータも真面目にビット列を構築するので、ちょっと処理が勿体無いかなと。
- ming に SWF 読み込み機能を追加するのも考えましたが、全種類のタグの parse を実装するのは手間(人的にもPC的にも)すぎますし、(parse を省く為に) tag ブロックを raw データでも保存できるようにするには、ming の基本構造に手を入れる事になるので、それは無しの方向で…
何故、swfmill を使わないの?
- swfmill で SWF ファイルを XML に落として必要部分を書き換え、SWF ファイルに戻す事でも目的は達成出来ますが、パフォーマンスを気にする環境にその処理を入れる勇気が自分には無いです。^^;
php current に swf extension があるけど?
- cvs の履歴を見ると2000年頃に pecl に移動したらしいのですが、pecl で検索しても見つからないし、実際に利用している例も見当たらないので、にんともかんとも…
資料
調査
参考
未参考
- SWF::Parser - SWFファイルをパース
- SWF::Builder - SWFファイル生成
- PECL swf
その他
関連ページ