### 3-5　DscToNj

SOFTIMAGE 3Dのシーンファイル（.dsc）からNinja形式のデータを出力する「NinjaExport for SOFTIMAGE 3D」のコマンドライン版コンバータです。大量のファイルの一括変換、プログラマ用として利用します。

####

3-5-1　動作環境

SOFTIMAGE 3DがインストールされているSGI

現在、SOFTIMAGE 3D 3.8(SGI mips2用)に対応しています

DscToNjはバックグラウンドでSOFTIMAGEを実行します。 必ず、SOFTIMAGEがインストールされている環境でご使用ください。

####

3-5-2　入力書式

DscToNj [-rs ] -db -sc [Option]
-rs or resourcepath ：リソースのパスを指定します。（省略可）
-db or databasename ：データベースのパスを指定します。
-sc or scenename ：シーンファイル(.dsc)名を指定します。

※コマンドの書式について

[ ]で括られたコマンドは省略できます。

システム環境変数に、ツールのPathを設定した場合は、コマンド入力時にツールのパスを省略できます。（詳細はWindows,IRIXのマニュアルを参照してください。）

####

3-5-3　オプションコマンド

DscToNjは、「NinjaExport for SOFTIMAGE 3D」のコマンドライン版である為、一部説明を簡略化しています。

オプションコマンドの説明において、詳細が必要な場合は「NinjaExport for SOFTIMAGE 3D」の頁を参照してください。

また、注意事項もそちらを読んだ上で使用してください。

#### ファイルに関するオプション

#### -o

出力ディレクトリを指定します。

#### -nmd or -nomodel

モデルファイル(.nja)を出力しません。

#### -st or -septex

モデルファイルとテクスチャファイルを分けて出力します。

#### -nmt or -nomotion

モーションファイル(.nam)を出力しません。

#### -outm or -outmrs

モデル階層情報ファイル(.mrs)を出力します。

#### -inm or -inmrs

モーションファイルを生成するためのMRSファイルまたは、MRSを記述しているシーンファイル(.nsc)を指定します。

記述されているパスに期待したMRSファイルが存在しない場合は、コンバートした状態を基本姿勢としてモーションファイルを出力します。

#### -preview

ファイル出力を行わず、指定されたコンバートオプションによるモデルのプレビューを行います。

#### Basic/Chunkモデルファイルに関するオプション

#### -bin or -BIN

バイナリ形式で出力します。

#### -pn or -polynormal

モデルファイルにポリゴン法線を出力します。

#### -nd or -nodiffuse

Diffuseの指定を無視します。

#### -pvc

ポリゴン側の頂点色を出力します。（頂点側の頂点色は無視されます。）

#### -g or -gibase

テクスチャのグローバルインデックスの開始番号を指定します。

#### -G (Global Freeze)

全頂点にトランス、ローテーション、スケールをかけて親子階層をなくしたデータを出力します。親子階層のない地形データなどのためのオプションです。

#### -gs or -gscale (Global Scale)

モデル、モーションにスケールをかけます。

キャラクターを100倍のサイズで作ってモーションの精度を確保し、最終的に100分の1にするなどのときに使います。

#### Chunkモデルファイルに関するオプション

#### -B or -basic

ベーシックモデル形式でモデルファイルを出力します。

#### -pvn

ポリゴン側の頂点法線を出力します。（頂点側の頂点法線は無視されます。）

#### -co3 or -volume3

#### -co34 or -volume34

#### -coS or -volumeS

コリジョン用チャンクボリュームです。

三角形ボリューム(-co3)で作られるデータはモデファイアボリュームでも利用します。

(-co34)で作られるデータは接続面角度が0.1以下の三角形を四角形として出力します。

(-coS)を指定するとストリップ形式で出力します。

#### -dma or -delmatall

マテリアルを削除します。

#### -dm or -delmat

テクスチャを指定したマテリアルを削除します。

#### -vctouf

頂点色を頂点ユーザーフラグに設定します。

#### -pctouf

ポリゴン色をポリゴンユーザーフラグに設定します。

#### Chunk Vertexの設定

Chunk Vertexの出力形式を指定します。

これにより、モデルの頂点に関する設定ができます。

略号の意味は以下のとおりです。

頂点法線あり

VN | 頂点法線あり。標準的な形式です。
VNX | 頂点法線あり。頂点法線データを削減し、データ量を少なくします。
D8 | 頂点法線なし。頂点カラーあり。(ARGB8888)
S5 | 頂点法線なし。頂点カラーあり。(RGB565)頂点カラーにスペキュラーの設定を予定。
S4 | 頂点法線なし。頂点カラーあり。(ARGB4444)頂点カラーにスペキュラーの設定を予定。
IN | 頂点法線なし。処理の高速なIntensityモードにおいて頂点カラーを与えます。
NF | 頂点法線なし。Ninja拡張フラグ領域を持ち、機能を拡張できます。
UF | 頂点法線なし。ユーザフラグ領域を持ちます。

※略号の合わさったもの（例 VN_D8）は、頂点法線がない形式の特徴を引き継ぎながら、頂点法線を付加したものです。

#### テクスチャに関するオプション

#### -ft or -forcetex

出力先に同じ名前のテクスチャがあっても上書きします。

通常は、出力先に同じ名前のファイルがあると変換しません。

#### -nc or -nocrop

CROP指定を無視します。

#### -uvh

UV値の精度（マッピングの精度）を1024段階にします。

デフォルトは256段階です。

#### -texn3 or -TEXN3

texlistのマクロをTEXN3にします。

#### -rva

頂点色のアルファ値を反転して判定します。(0<->255)

これは、Softimageのバージョンにより取得できるアルファ値が反転するためのものです。

#### モーションファイルに関するオプション

#### -sp or -spline

補間方法をスプライン（曲線）とします。

このオプションを指定しない場合はリニア（直線）補間です。

#### -key

モーションデータをキーフレームで出力します。

このオプションを指定しない場合、全フレームを用いたモーションを行います。その場合、データ量が増える、変換時間が掛かるという不具合がありますが、より忠実なモーション情報が得られます。

#### -ef or -effecto

上記[-key]オプションと同様ですが、スケルトンモデルのエフェクタに指定されたキーフレーム単位にモーションを出力します。

#### -us

シーン別にモーションファイルを出力するために、モーションファイル名にシーン名を付加します。

#### -a or -trr

モーションファイルをType Aで出力します。

総親のノードのみがTrans,Rotを持ち、他のノードはRotのみを出力するタイプです。

#### -b or -trt

モーションファイルをType Bで出力します。

全ノードがTransとRotを持つ形式で出力します。

#### -c or -trs

モーションファイルをType Cで出力します。

全ノードがTrans,Rot,Scaleを持つ形式で出力します。

#### -pt or -printtrans :Print translation

#### -pr or -printrot :Print rotation

#### -ps or -printscale :Print scale

モーションにおいてMRSファイルの値と比較圧縮を行いません。

このオプションを指定しない場合はMRSファイルの値と比較され、差がないモーションは削除されます。

#### -tk or -transkey :Print all translation keyframes

#### -rk or -rotkey :Print all rotation keyframes

#### -sk or -scalekey :Print all scale keyframes

モーションフレーム間の圧縮を行いません。

このオプションを指定しない場合、フレーム間の変化量が指定可能なしきい値より少ない場合はこの部分のキーフレームをカットします。

#### -te or -teps :Set translation epsilon

#### -re or -reps : Set rotation epsilon

#### -se or -seps : Set scale epsilon

フレーム間の差のしきい値を設定します。

連続するフレーム間での差が、この値よりも小さいと同じ値として処理します。

全フレームでこの値よりも小さな変化しかない場合モーションデータはNULLになります。

前後のフレーム間でこの値よりも変化が小さい場合はキーフレームが省略されます。デフォルトは0.001です。

データ量を削減したい場合は値を大きくし、細かなモーションが必要な場合は値を小さくして精度を上げます。

#### -IM0 or -ImpMot0

モーションキャプチャ用のモーション補間アルゴリズムを利用します。

これにより不正に回転してしまう症状を改善できます。

（このコマンドの“0”は“ゼロ”です。）

#### ストリップ変換に関するオプション

#### -S

3頂点ポリゴンをストリップポリゴンに変換します。

#### -St

4頂点ポリゴンを3頂点ポリゴンに変換し、そのポリゴンを含む3頂点ポリゴンをストリップポリゴンに変換します。

#### -ST

N頂点ポリゴンを3頂点ポリゴンに変換し、そのポリゴンを含む3頂点ポリゴンをストリップポリゴンに変換します。

#### -STt

4とN頂点ポリゴンを3頂点ポリゴンに変換し、そのポリゴンを含む3頂点ポリゴンをストリップポリゴンに変換します。

#### シェイプファイルに関するオプション

#### -sh or -shape

シェイプモーションファイルを出力します。

#### -shn or -shnormal

シェイプモーションの法線情報を出力します。

#### テクスチャ変換に関するオプション

#### テクスチャ変換の初期値

texture format | twiddled（正方形の場合）

| rectangle（長方形の場合）

auto mipmap ON
dither OFF
alpha dither OFF
stride OFF
pixel format RGB565（アルファ値が存在しない）

ARGB4444（アルファ値が0から255）

ARGB1555（アルファ値が0または255）
VQ auto mipmap ON

#### Texture format

-t or -twiddled | twiddled texture
-r or -rectangle | rectangle texture
-s or -stride | stride texture
-v3 or -vq3 | VQ algorithm3
-v3a or -vq3auto | VQ and smallVQ(32x32,16x16) algorithm3
-sv3 or -smallvq3 | smallVQ algorithm3
-v4 or -vq4 | VQ algorithm4
-v4a or -vq4auto | VQ and smallVQ(32x32,16x16) algorithm4
-sv4 or -smallvq4 | smallVQ4 algorithm4

※-v3aおよび、-v4aは、VQとsmallVQを自動的に切り替えます。

#### Pixel format

-5 or -565 | pixel format RGB565
-4 or -4444 | pixel format ARGB4444
-1 or -1555 | pixel format ARGB1555
-t1 or -t1555 | translucent pixel format ARGB1555
-b4 or -b4444 | bilevel translucent pixel format ARGB4444

#### -ra or -ralpha

アルファ値を反転します。

#### -di or -dither

ディザ処理します。

#### -adi or -adither

アルファディザ処理します。

#### -ns or -nosuffix

テクスチャの拡張子を無視して読み込みます。

#### -f or -flip

すべてのテクスチャを上下反転します。

#### -nm or -nomipmap

自動ミップマップ変換を行いません。

#### -nvm or -novqmipmap

自動VQミップマップを行いません。

#### -nua、-noautoua

自動αビット設定を行いません。

#### シーンファイルに関するオプション

#### -nsc or -scene

Ninjaシーンファイル(.nsc)を出力します。

#### -I or -Info

オブジェクトツリーのルートノードのTrans,Rot,ScaleがNSCファイルに出力されます。これはマップ用モデルの配置に使います。

#### カメラに関するオプション

#### -cam or -camera

カメラファイルを出力します。

#### -cm or cammot

カメラのモーションファイルを出力します。

#### -ck or -camkey

キー設定したフレームを出力します。

#### -cpa or -cprintall

全フレームを出力します。

#### -cs or -camspline

カメラモーションのキーフレームの補間にスプラインを使用します。

このオプションはキーフレームモーション時に有効です。

#### -cpe or -cpeps :Camera Position Epsilon

#### -cve or -cveps :Camera Vector Epsilon

#### -cae or -caeps :Camera Angle Epsilon

カメラモーションデータについてのEpsilon（フレーム間変化量のしきい値）を設定します。デフォルトはすべて0.001です。

#### ライトに関するオプション

#### -lig or -light

ライトファイルを出力します。

#### -lm or ligmot

ライトのモーションファイルを出力します。

モーションを出力する際にはライトファイルも出力されます。

#### -lk or -ligkey

キー設定したフレームを出力します。

#### -lpa or -lprintall

全フレームを出力します。

#### -ls or -ligspline

ライトモーションのキーフレームの補間にスプラインを使用します。

このオプションはキーフレームモーション時に有効です。

#### フレーム間変化量のしきい値の設定

ライトモーションデータについてのEpsilon（フレーム間変化量のしきい値）を設定します。デフォルトはcolorが0.004で、他は0.001です。

-lce or -lceps | Light Color Epsilon
-lpe or -lpeps | Light Position Epsilon
-lve or -lveps | Light Vector Epsilon
-lie or -lieps | Light Intensity Epsilon
-lae or -laeps | Light Angle Epsilon
-lre or -lreps | Light Fall off range Epsilon

[←] | [INDEX] | [→]