SWF Editor for PHP
(c) 2008/03/09- yoya@awm.jp

目的

  • Flash SWF ファイル内のコンテンツを入れ替える
    • テキストツールで貼り付けた文字列の入れ替え
    • JPEG画像の入れ替え
    • PNG画像の入れ替えも一部対応 (パレットとグレーの形式は未対応)
  • Adobe CS3 等で生成した SWF の必要な部分だけ PHP+swfed で書き換える事で、Flash 開発者と PHP 開発者が得意な部分に注力できます。
  • 最小限の処理で書き換えを行っているので、ming のように１からファイルを構成するより負荷が軽めです。軽くなるかもしれません。

設計

  • PHP extension (php 5.1.6, 5.2.5 で動作確認)
  • bit stream 処理は自作 (もし良いのがあったら誰か教えて…)
  • ファイル全体から tag ブロックへの分割は無条件で処理するが、tag ブロックの詳細分割は必要な時だけ行う。
  • 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|edit_id]); return text;
     function replaceEditTextString(string [variable_name|edit_id], 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 (一部実装) 8bit RGB αチャネル無しのみ実装 
         function replacePNGData(integer image_id, string pngdata)
                                    return true/false;
  • PHP extension API (一部実装) format 5 = bitmap 形式のみ実装、 
         function getPNGData(integer image_id)
                                    return string pngdata;
  • 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,
                                                       'data'=>$data)
                                                 );
     function asmActiondata(Array(Array('op'=>$code, 'data'=>$data)));
                                    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;
}

使用例 (サンプルコード)

実装

  • なるべく 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-?.??.tar.gz をディレクトリ毎もってきて伸張
  • src 以下で phpize & configure & make
cd src
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
apachectl graceful

モジュール更新

  • apachectl stop
  • extension ディレクトリに so を copy
  • apachectl start
su
apachectl stop
cp modules/swfed.so <php_ext_dir>/.
apachectl start

※ もし、無停止で更新する方法があれば、どなたかご教授頂けませんか。(無理な気がしてますが…)

日記

課題

常に

  • メモリ管理のブラッシュアップ
    • エージングに耐えられるように
    • おかしな SWF を食わせてもリークしないように
  • swfed.c の new_buff の処理を何とかする。

絶賛対応中

  • DefineBitsLossless(未圧縮画像, BMP とか PNG 等)の対応。

近日中に対応

  • Windows 対応
  • midi 対応 (DefineSound?、構造を見ると違うっぽいけど…)

未定

  • ベクタ画像の入れ替えを検討中。(携帯でビットマップを多用すると容量的にキツい)
    • Flash in Flash の対応？
  • swf_tag.c の処理が冗長なので何とかする

FAQ

loadVariable や loadMovie でよくない？

  • それらを実行する時に通信が発生しますが、初めに送る Flash に反映されていれば、その通信がいらなくなるかなと…。そんな事気にしないと言われてたら、それまでですが。
  • あと、携帯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 で検索しても見つからないし、実際に利用している例も見当たらないので、にんともかんとも…

資料

調査

参考

未参考

その他

関連ページ
Reload   Diff   Front page List of pages Search Recent changes Backup Referer   Help   RSS of recent changes