ForDevelopper.jis           Last Update 1999.10.02   ActX  Version0.99.0

★☆★ ActX Developper向け情報 ★☆★
 Readがあまりに肥大化してきたため、アニメーションデータ開発向け用の情報を
 こちらのドキュメントで記述致します。





   ★Menu用リソース ＄HOME/.actxrc の作成
     パッケージには作者が通常使用しているサンプル sample.actxrcが附属
     しています。これを見ていただければ，だいたい作成の仕方はわかると
     思いますが，いちおう順をおって説明します。
     
     基本的にこれの書き方は一般的なXのリソースファイル(~/.Xdefaults等)
     と同じです。
     
   ○マスコットの数 (メニューに登録するマスコットの数)
                     ↓この14だけ自分の環境に合わせてかえればよい
     Actx*numsOfMenu: 14
     
   ○Menu Title (General Config Window内で表示されるのみです)
     Actx*titleOfMenuJ: ONE  〜輝く季節へ〜
     Actx*titleOfMenuE: ONE  - for Bright Season -
       Jが着いている方はI18Nの指定がされているときに利用します。
       こちらに日本語のメニュー名を入れてください。
   
     
   ○XPM ファイル 格納Dir (マスコットのXPM-Fileを入れておくディレクトリ
                           です。すべてのXPMファイルは同一ディレクトリに
                           入れるようにして下さい)
     Actx*xpmDir: /home/taji/lib/evamascot

   ○音声再生用コマンド名
     Actx*sndCom: /usr/local/bin/wavplay -q %s
       ver0.95以降ではマスコットをクリックしたときに外部コマンドを使って
       音声を再生できるようにしました。
       そのとき使うコマンド名です。
       %sのところには後で指定するサウンドファイル名が入りますので、これを
       必ず含めて記述してください。
       音声再生を使わない場合は指定しなくてもいいです。
  
     
   これ以降は各マスコットに対する指定になります。
     
   ○メニュー中のタイトル (ポップアップにでる名前です)
     Actx*menu.titleJ: 長森 瑞佳 (メイドVersion)
     Actx*menu.titleE: Mizuka Nagamori (Maid Version)
       Jが着いている方はI18Nの指定がされているときに利用します。
       こちらに日本語のメニュー名を入れてください。

   ○オプション名 (これは，コマンドラインからこのマスコットを呼び出す
                   オプションです，かならず，他のマスコットのものと一
                   緒にならないよう注意して下さい)
     Actx*menu.option:  -asuka

   ○Shape機能のON/OFF (マスコットの各アニメパターンの外形が違う場合は
                        これをON(全部大文字で)して下さい。そうでない場
                        合はメモリの無駄になりますのでOFFとして下さい)
     Actx*menu.shapeFlag: OFF

   ○X,Yのオフセット (マスコットを表示させるフォーカスWindowの右肩から
                      の距離です)
     Actx*menu.xPosition: 120
     Actx*menu.yPosition: 113

   ○クリックしたときに再生するサウンドファイル名
     Actx*menu.sndClk: /home/taji/wav/click1.wav
       指定しなければ、再生しません。

   ○クリックしたときのアニメーションのスタートフレーム
     Actx*menu.startClk: 5
       マウスがクリックされたときここで指定したフレームに処理がスキップ
       します。
       これで、あたかもクリックに対して動作するかのように見せかけます。
       指定しなければクリックアニメーションは行いません。

   ○クリックアニメーションの終了フレーム
     Actx*menu.endClk: 7
       クリックが連続して行われた場合、このフレームが表示終了するまでの
       クリックを無視します(サウンドが指定してあれば、音声だけはなります)。
       startClkを指定したときはこちらも必ず指定してください。

   ○アニメーションのフレーム数 (アニメーションを構成するXPMファイルの数
                                 です。ノーマルで20フレームまでとれます)
     Actx*menu.numFrame: 2

    
   ここから下は各アニメーションフレームに対して設定します。

   ○各アニメーションフレームのXPMファイル名 (これらのファイルは上記の
                                              xpmDirに入れた上で，ファ
                                              イル名のみ記入して下さい
                                              (パスはいらない)))
     Actx*menu.xpmFile0: asuka0.xpm
     Actx*menu.xpmFile1: asuka0_1.xpm
                       ↑アニメーションフレームの番号です。
                         この場合上で2フレームだと宣言していますので
                         *0〜1*の二つになります。
                         (やはり0からというのに注意)

   ○最小描画枚数
     Actx*menu.minFrame0: 1
     Actx*menu.minFrame1: 1

   ○最大描画枚数
     Actx*menu.maxFrame0: 80
     Actx*menu.maxFrame1: 1
       これら二つはいずれも一枚約1/6秒のアニメーションフレームに対する
       描画枚数です。
       最小と最大が違う場合はそれら二つのあたいの間でランダムな数字を
       とるようになってます。
       逆に描画枚数を固定にしたい場合は両方とも同じ数にして下さい。
       上の例のアニメーションは現実的には以下のようになります。

                 asuka0.xpm               ↓asuka0_1.xpm
     スタート┝━━━━━━━━━━━━━┿┥最初に戻る
              (1〜80の間のランダム)x1/6秒 ↑
                                          1/6秒
                        (等幅フォントでご覧になってください)

      このようなかんじにするとランダムな間隔の目パチ等が実行できます。
      (要するにランダム間隔の目パチアニメに特化した作りになってるんで
       すね^^; もちろん，他のアニメにも使えますが)


   ●より複雑なアニメーションを実現するために「No.xxフレームから
     No.yyフレームまでをa回からb回の間のランダムな回数で繰り返す」
     というモードをver0.96以降でサポートしました。
     以下、このモードを『ブロックループ』アニメーションと呼ぶことにしま
     す。このモードを設定するのに使用するリソースには以下のようなものが
     あります。

     ○ブロックループの最初のフレーム番号
       Actx*menu.nextFrame3: 0
         この指定はブロックループの最後のフレーム(この場合は3)に対して指定
         します。
         ようするにこの場合は3番のフレームの次に0番のフレームに戻るという
         ことを意味しています。
         ブロックループの最後になるフレーム以外にはこのリソースを指定する
         必要はありません。

     ○ブロックループの最小ループ数
       Actx*menu.minFloop3: 1
  
     ○ブロックループの最大ループ数
       Actx*menu.maxFloop3: 5
         この二つの数字の間でランダムな回数だけループを行った後、次のフレ
         ーム(この場合は4番)に移ります。



     以上 ○メニュー中のタイトル 以降を各マスコットについて(この場合は
     13番まで)を作成していけばいいわけです。
     あと順番はぜんぜんバラバラでかまいません。行頭を"!"にするとコメント
     行になります。
     ただし，ポップアップメニューからリソースのセーブを行なうと，そうし
     たコメントは消されてしまいますので，各自バックアップをとっておいた
     方がよいでしょう。
     

  ●ふきだし表示のメッセージ
     ver0.99.0以降ではクリックした際にふきだしを画面内に表示し、i18nとは
     無関係に日本語メッセージを表示させることができます。
     この際、表示するメッセージは
      Actx*menu.wordClk: …嫌です/恥ずかしいから/嫌です
     という様に指定します。
     ===================================================================
          なお、この文字列には基本的に2byte文字しか記載できません。
     ===================================================================
     1byte文字では、半角スペースとコロン, セミコロン, カンマ, スラッシュ
     (" :;,/")が文字列のデリミタ(区切り)として使用できます。
     (どの文字でも働きは同じです。)
     区切られた各部分はデフォルトでは15フレームおきにふきだしの中に表示
     されます。