$Id: convicon.txt,v 1.1.1.3 2002/11/19 11:41:41 Yoshizawa1 Exp $

アイコンコンバーター for PS2

										2001/2/14
										K.Kano

1. 概要
  これは、MDL(MGS2モデルフォーマット)からPS2用の3Dアイコンを
生成するツールです。PS2のアイコンの仕様に全て対応してあります。


2. ファイル
  アイコンの変換に使うツールは、以下の三つです。

  convicon [options] <icon conf file> <icon model file>
  bmp2rgb16 [options] <bmp file> <rgb16 raw format file>
  pic2rgb16 [options] <pic file> <rgb16 raw format file>


3. convicon
  これは、アイコンのモデルの情報が書かれた<icon conf file>を
もとに、アイコンのモデル、アニメーションのバイナリーファイルを
生成するツールです。

  options :
	-f  ...... このオプションを付けますと、アイコンの変換の際の、
	           制限チェックを省いて強制的に変換を行います。
	           PS2のアイコンには、頂点の数、座標値に制限がありますが、
	           このオプションではその制限チェックを省きます。
	           頂点座標値の制限 :
	                -10.0 <= x <= 10.0
                      0.0 <= y <= 20.0
                    -10.0 <= z <= 10.0
	                    ( MDLとPS2ではyの向きが逆なので、ツール内で
	                      反転させています。ですからPS2のマニュアルでは、
                          yの制限を-20.0 <= y <= 0.0としています。)
	           三角形(頂点)の数の制限 :
	                MIMEアニメーションのためのモデルの数   三角形の数(頂点の数)
                                      1                           600(1800)
                                      4                           500(1500)
                                      6                           450(1350)
                                      8                           400(1200)

	-ot ...... テクスチャを出力します。通常はモデル部分のみを生成しますが、
	           このオプションを付けますと、MDLに含まれているテクスチャを取り出し、
	           BMPやPICとして出力します。
    -d dir ... .mdl,.rptを読み込む時の基準ディレクトリを指定します。
               ここで指定されたディレクトリは、<icon conf file>のmdlの指定の
               基準ディレクトリになります。

4. bmp2rgb16,pic2rgb16
  この二つのツールは、入力ファイルフォーマットが違うだけで、出力フォーマットは
PS2アイコンテクスチャ形式のファイルと同じです。ですから、オプションも同じものを
使います。

  options :
	-arc    ... PS2のアイコン用テクスチャには、圧縮を掛けることができます。
	            このオプションは、圧縮したファイルを出力することを指示します。
	-chk128 ... PS2のアイコンの大きさは、128x128を一枚で固定です。
	            このオプションを付けると、大きさが適切かどうかをチェックして、
	            出力するかどうかを判定します。


5. 変換手順

  <mdl file 1> <mdl file 2> ... -------> convicon ------> <icon model file>
                                   |                |
  <icon conf file> -----------------                ----> <bmp or pic file>

  <bmp or pic file> -------------------> pic2rgb16 -----> <icon texture file>
                                         bmp2rgb16

  <icon model file> -------> cat <icon model file> <icon texture file> > <icon file>
                        |                    |
  <icon texture file> ---                    |
                                             |
                                             -----------> <icon file>

  これらの手順をまとめて、convicon.shというスクリプトにしてあります。
  使い方は、

		convicon.sh <icon conf file> <icon file>

  と呼び出すだけで、PS2用アイコンファイルの作成まで行います。


6. <icon conf file>について
  このファイルは、PS2アイコンファイルに出力する内容を記述するテキストファイルです。
PS2アイコンファイルで指定できる全ての内容を網羅しています。

  例 :
		mdl vanim0.mdl vanim1.mdl vanim2.mdl vanim3.mdl
		scale 0.01							; Scaling icon
		bface 1.0							; bface value
		gour on								; on/off
		texture arcuive						; on/off/arcuive
		seq 400.0 1.0 0						; <nbframe> <speed> <offset>
		key 0.0   1.0 0.0 0.0 0.0			; <frame number> <weight> ... 
		key 100.0 0.0 1.0 0.0 0.0			;   ウェイトはモデルの数と同じ数要る
		key 200.0 0.0 0.0 1.0 0.0
		key 300.0 0.0 0.0 0.0 1.0
		key 400.0 1.0 0.0 0.0 0.0

		mdl <mdl file> ...
           MDLファイルの名前を記述します。PS2のアイコンでは、アニメーションモデルの数が
           1,4,6,8個のいずれかという規定がありますので、その数分のMDLファイルの名前を
           書きます。

       scale <floating scale value>
           MDLファイル内のモデルの大きさをスケーリングする数値です。
           PS2アイコンには、頂点の座標値に制限がありますので、それを越えてしまった
           場合の調節用です。

       bface <floating value>
           PS2アイコンには、必ずアンチエイリアスがかかりますが、PS2はその機能が不完全で、
           場合によってはアイコンが化けて出てしまいます。この数値は、その現象を抑制するための
           パラメータです。具体的には、この数値以下の面積のポリゴンの消去を行います。
           これは、PS2のアンチエイリアス機能が小さなポリゴンに対して弱いためです。
           小さなポリゴンが欠けてしまう場合は、この数値を小さくして試してみて下さい。

       gour <on|off>
           グーローシェーディング機能を使うか使わないか選択します。

       texture <on|off|arcuive>
           テクスチャを使うか使わないか選択します。"arcuive"にした場合は、圧縮された
           テクスチャを使うことを指定しています。

       seq <nbframe> <speed> <offset> <nbksp>
           アニメーションの全体の情報を指定します。<nbframe>は、アニメーションの
           総フレーム数の指定です。<speed>は、アニメーションの再生スピードを、フレーム
           きざみ値で指定します。<offset>は、再生オフセットフレーム番号です。

       key <frame number> <weight> ...
           アニメーションのキーフレームの内容を指定します。<frame number>の瞬間に、各モデルが
           <weight>で表される重み値で混ぜ合わされ、表示されます。

7. 変換の確認
  無事変換できたがどうかの確認用に、ダンプツールも用意してあります。dumpicon <icon file>が
それです。これを使うと、アイコンファイル内にある三角形、アニメーションのデータが確認できます。
