• 前へ
• 次へ

複数の効果音･画像を１つのDLLに

概要

ScenarioMod では、複数の効果音や画像を個別のファイルとして扱うこともできますが、
｢配布する｣場合には、個別のファイルのままにするよりも、1 つの dll にパック化するほうがスマートです。

一度やり方を知ってしまえば、誰でもできる程度のことなので、
やり方の流れをみていきましょう。

パック化の手順

• さて、では、VC++のメニューより、｢新規作成｣=>｢プロジェクト｣を選択しましょう。
  

  
  

• 引き続いて、｢Win32｣=>｢Win32プロジェクト｣となります。
  プロジェクト名に｢MyResPack｣などと入力し、OKしましょう。
  名前は何でもよいのですが、リソースのパックであることが分かる名前にするとよいでしょう。
  

  
  

  Visual Studio 2019 や Visual Studio 2022など

  比較的新しい Visual Studio の場合は、以下のようなインターフェイスで選択します。

  
  

  dllmainなどは整形不要ですので、構成プロパティへとすすんでください。

• ｢次へ｣と続けて

• ｢DLL｣と「空のプロジェクト」にチェックを入れ、他はチェックをはずします。｢完了｣を押しましょう。
  

  
  

• そうすると、ソリューションエキスプローラーは下図のようなツリーとなります。
  

  
  

• 「ソースファイル」のところを右クリックで「追加」->「新しい項目」と進み、
  以下のように「dllmain.cpp」というソースをくっつけましょう。

  
  

• 以上で下図のように、｢dllmain.cpp｣だけくっついた状態となります。
  

  
  

• この段階では、「dllmain.cpp」のソースの中身は空っぽです。
  １行も何も書かれていない状態。
  

• さて、少し話を変えて、
  メニューのちょっと下あたりに｢Release｣もしくは｢Debug｣と見えている下図のようなところがあるはずです。
  ｢Release｣を一度選択しましょう。
  

  
  

• シンプルなDLLにふさわしい設定にするために、プロジェクトの設定を変更する必要があります。
  下図のようにソリューションエキスプローラの｢MyResPack｣を右クリックして、｢プロパティー」に入ります。
  

  
  

• 構成プロパティの｢全般｣もしくは「詳細」の項目に

  ｢文字セット｣という項目がありますので、｢Unicode文字セットを使用する｣というのを変えて、｢マルチバイト文字セットを使用する｣

  にしましょう。
  天翔記では、元々がShiftJIS(正確にはCP932)ですので、DLLをUnicode文字で管理するより、通常のマルチバイト文字セットの方が、はるかに扱いやすいためです。
  

  
  

• 同様に、構成プロパティの｢C/C++｣の項目(もしくはC/C++の「コード生成」の項目）に

  ｢ランタイムライブラリ｣という項目がありますので、｢マルチスレッド DLL(/MD)｣ではなく、｢マルチスレッド (/MT)｣へと変更します。
  

  これは、このDLL内に必要なものを内包するか、それとも、できるだけ外部のDLLに頼りサイズを減らすかの選択です。
  両者はファイルサイズがかなり異なりまずが、どのみちファイルサイズは小さいため、
  特に問題がなければ、 トラブル防止のため、｢マルチスレッド (/MT)｣を選択しておきましょう。
  

  
  

• ｢適用｣=>｢OK｣を押して、すべてを反映させましょう。
  

• さて、それでは、dllmain.cpp を選択して、話を戻しましょう。
  

  
  

• 「呼び出されるだけで、機能的には何もしない dll」を作成します。
  

  
  

  あってるかどうか、コピペが可能なソース

  #include <windows.h>
  
  BOOL APIENTRY DllMain( HMODULE hModule, DWORD ul_reason_for_call, LPVOID lpReserved ) {
      return TRUE;
  }
      

• さて、ソースは以上です。
  

• それでは、いよいよリソースを埋め込みます。
  

  「リソースファイル」のところで右クリックを選びます。
  

  
  

  「resource.rc」というファイルをくっつけましょう。
  拡張子が「.rc」であれば、名前は自由です。
  

  
  

  
  

• それでは、リソースをテキストで編集します。
  

  「resource.rc」のところで、右クリックして、コード表示。
  

  
  

  以下のようにテキスト入力してみましょう。
  

  
  

• 青線が「シンボル名」、IMAGEやWAVEが「グループ名」、"abc.png"や"mylove.wav"がファイル名という理解をしておきましょう。
  

• Windowsのエキスプローラー上で、「resource.rc」と同じフォルダに、"mylove.wav"と"abc.png"というファイルを適当に用意してコピーなどして入れましょう。
  

  
  

• 準備はすべて終わりました。プロジェクトをビルドしましょう。
  

  
  

• エラーなく dll ファイルを作成できましたか？
  

• これでdllファイルそれ自体に、wav相当のバイナリデータや、png相当のバイナリデータが「埋め込まれた」形となります。
  

  
  

• では、「このMyResPack.dll」を天翔記フォルダにコピーしましょう。
  

ScenarioModからの利用

先ほどパック化したdllを利用して、ScenarioModで利用してみましょう。

• ScenarioModでこのMyResPack.dllの画像リソースや効果音リソースを利用してみましょう。
  

  先ほどの話を思い出してください、MyResPack.dllに埋め込んだ「シンボル名」やリソースデータは下記のように定義しました。
  この「シンボル名」を指定します。
  (「IMAGE」や「WAVE」といったグループ名は TSMod 側が処理しています。)
  

  
  

• ScenarioMod上で、「On_起動時」あたりに、以下のようにすることで「dllを読み込む」ことができます。
  

  void カスタム::On_起動時() {
    Set_効果音ＤＬＬ追加("MyResPack.dll");
    Set_画像ＤＬＬ追加("MyResPack.dll");
  }
  
      

• そして効果音用関数や、画像用関数で以下のように利用します。
  

  void カスタム::On_プレイヤ担当ターン《メイン画面》() {
  
    // "Image01"という文字は大文字小文字は問わない
    画像ダイアログ表示("Image01", "MyResPack.dll");
  
    // 上と合わせるなら、本来は "101" と数字文字列にて指定するべきところ。
    // しかし、ScenarioModでは特別に天翔記の「効果音は全部番号」という仕様を踏まえ、「数字文字列」ではなく「数値」で指定する。
    効果音再生(101, "MyResPack.dll");
  }
      

• 前へ
• 次へ