skin_porter は形状のスキンデータをエキスポート／インポートする Shade 10 用のプラグインです。
その他のおまけ機能として、選択された形状のスキンのクリア機能と、選択された形状のスキンの中から記憶されているジョイントのバインドのみを消去する機能と、変換マトリックスのリセットが付加されてます。
Shade のスキン機能はスキンウインドウで一括設定出来る点は便利ですが、まだ発展途上の感は拭えません。特にマニュアルでの設定は根気のいる仕事です。本プラグインはそのスキンの設定を多少とも楽にするためのツールです。このプラグインは形状のスキンをファイルに保存し、それを形状に再設定します。同じ名前で同じ構造の形状なら保存した形状のスキンを別の形状にも適用できます。
ファイルは、バイナリかテキストファイルかの選択ができます。
スキンクリアは選択した形状の選択した要素のスキンを一括消去します。スキン保存後に形状を再編集する時などで使えます。編集後、スキンを再読み込みすれば、以前のスキン値が再設定できます。
ジョイントスキンクリアは、スキンが掛かる側でなく、掛ける側のジョイントを選択して実行すると、シーン内のそのジョイントのスキンがバインドされている全ての形状から、そのジョイントのスキンだけ消去します。ジョイントを削除するとき、スキンが掛かっていてそのジョイントと形状が異なる変換マトリックスであったり、ジョイントが動かされている場合などでは、削除直後に形状が変形します。(場合によっては、表示上は変わらず、保存後に再読み込みしたときに始めて変形していることが判ったりして悔しい思いをすることがあります。）その状態のままで、ジョイントのスキンを取り除きたい場合に、現在の位置を保持する指定で、ジョイントのスキンを外すことができます。
変換マトリックスリセットは選択した形状およびその下の形状の変換マトリックスをワールド座標でのポイント位置を変更せずに単位マトリックスに変換します。
その他のおまけ機能として、選択された形状のスキンのクリア機能と、選択された形状のスキンの中から記憶されているジョイントのバインドのみを消去する機能と、変換マトリックスのリセットが付加されてます。
Shade のスキン機能はスキンウインドウで一括設定出来る点は便利ですが、まだ発展途上の感は拭えません。特にマニュアルでの設定は根気のいる仕事です。本プラグインはそのスキンの設定を多少とも楽にするためのツールです。このプラグインは形状のスキンをファイルに保存し、それを形状に再設定します。同じ名前で同じ構造の形状なら保存した形状のスキンを別の形状にも適用できます。
ファイルは、バイナリかテキストファイルかの選択ができます。
スキンクリアは選択した形状の選択した要素のスキンを一括消去します。スキン保存後に形状を再編集する時などで使えます。編集後、スキンを再読み込みすれば、以前のスキン値が再設定できます。
ジョイントスキンクリアは、スキンが掛かる側でなく、掛ける側のジョイントを選択して実行すると、シーン内のそのジョイントのスキンがバインドされている全ての形状から、そのジョイントのスキンだけ消去します。
変換マトリックスリセットは選択した形状およびその下の形状の変換マトリックスをワールド座標でのポイント位置を変更せずに単位マトリックスに変換します。
skin_porter.dllを Shade の pluginsフォルダか、その中のフォルダにコピーして Shade を起動するだけで使用可能になります。
３．１．スキンの保存
ファイルメニューのエクスポート サブメニューからスキン保存 を選びます。するとファイル名指定のダイアログがでますので、保存する場所と名前を指定します。その後以下のような保存時の設定を指定するダイアログが現れます。
最初の範囲：では、保存する対象を現時点で選択されている形状か、全形状かを指定します。選択形状を選んだ場合、その選択範囲にスキンを掛けているジョイントを含んでいる必要は有りません。
次の形式：では、保存をバイナリ形式かテキスト形式を指定します。テキスト形式のメリットは、後でファイルをテキストエディタ等で編集して修正したり出来ます。一方バイナリ形式のメリットは、形状名の制限が無い点です。テキストの場合、場合によっては特殊文字コードの形状名の場合うまく保存できない場合があります。
次のジョイント名：フルパス保存は、チェックを入れるとジョイント名がその親のパートも含めて保存されます。これを利用すると名前が同じジョイント名が有っても、インポート時にそのシーンの構造を経由して正しくスキンを掛けられる可能性が高まります。但し、シーン内で全てのジョイント名をユニークな名前で作られた場合は、これを指定する必要は有りません。
最後の形状の特殊文字を削除して保存を指定すると、形状の頭に付加された # | 等の特殊文字を予め取り除いて保存します。しかしインポート時にこの特殊文字を検索時に無視させることが出来ますので、あまり重要性は有りません。
設定をおこない、OKボタンを押すとスキンが保存されます
(保存されたスキン情報ファイルはテキストデータの場合、巻末のファイル仕様になっています。)
注）テキスト形式での保存の場合、パート／形状名に特殊文字（特に日本語コードの２バイト目以降）が含まれる場合に対してある程度の防護策を取ってますが、それが不可能な場合保存中にエラーメッセージを出します。その場合はバイナリ形式で保存してください。
ファイルの拡張子は バイナリ、テキストの両方とも sskです。
最初の範囲：では、保存する対象を現時点で選択されている形状か、全形状かを指定します。選択形状を選んだ場合、その選択範囲にスキンを掛けているジョイントを含んでいる必要は有りません。次の形式：では、保存をバイナリ形式かテキスト形式を指定します。テキスト形式のメリットは、後でファイルをテキストエディタ等で編集して修正したり出来ます。一方バイナリ形式のメリットは、形状名の制限が無い点です。テキストの場合、場合によっては特殊文字コードの形状名の場合うまく保存できない場合があります。
次のジョイント名：フルパス保存は、チェックを入れるとジョイント名がその親のパートも含めて保存されます。これを利用すると名前が同じジョイント名が有っても、インポート時にそのシーンの構造を経由して正しくスキンを掛けられる可能性が高まります。但し、シーン内で全てのジョイント名をユニークな名前で作られた場合は、これを指定する必要は有りません。
最後の形状の特殊文字を削除して保存を指定すると、形状の頭に付加された # | 等の特殊文字を予め取り除いて保存します。しかしインポート時にこの特殊文字を検索時に無視させることが出来ますので、あまり重要性は有りません。
設定をおこない、OKボタンを押すとスキンが保存されます
(保存されたスキン情報ファイルはテキストデータの場合、巻末のファイル仕様になっています。)
注）テキスト形式での保存の場合、パート／形状名に特殊文字（特に日本語コードの２バイト目以降）が含まれる場合に対してある程度の防護策を取ってますが、それが不可能な場合保存中にエラーメッセージを出します。その場合はバイナリ形式で保存してください。
ファイルの拡張子は バイナリ、テキストの両方とも sskです。
３．２．スキンの読み込み
インポートしたい範囲を含んで形状を選択して ファイル メニューの インポート サブメニューから ポーズ読込 を選びます。すると入力ファイル指定ダイアログボックスが現れますので、ファイル名を指定して OKを押すとインポートモードを指定するダイアログが現れます。
最初の適用は、スキンをインポートする形状の既存のスキンデータをクリアして新規設定する 新規設定と以前のスキンをそのままに重ね書きする 追加のいずれかを選択します。元々スキンがないと判っている形状の場合は、追加の方を選んだ方が多少高速です。
次のポイント位置を保持は、スキンを掛けたとき掛けられる側の形状のポイントのワールド位置をそのままに保持するかを指定します。掛ける側のジョイントが既に動いている場合など、自然にその変形に追従させたい場合などは、チェックを外し、とにかくその時点の形状の形を崩したくない場合は、チェックします。
次の特殊文字を無視は、チェックを入れるとジョイント名の先頭の特殊文字を無視して比較します。以前保存したスキンを新しいシーンに取り込もうとして、以前の形状名の頭に特殊文字を付けていたり、外していたりした場合などに指定すれば、以前のスキンファイルを再利用できます。
次のスキン元ジョイントは選択形状外は、スキンファイル内にあるスキンを掛ける側のジョイントは、その時点で選択しているパートの中に無い場合に指定します。チェックを入れるとジョイントは、シーン全体から探します。この利用面は、特定の１形状のみスキンを保存し、その形状のみ選択してスキンを掛けるような使い方をする場合などに利用します。また、逆にチェックを外して、ジョイント部分まで選択して実行すると、ジョイントの検索をその範囲に限定しますので、複数の同じ構造で同じ名前のジョイント構造がある場合などで利用できます。
饒舌な経過メッセージにチェックを入れると、形状にスキンを掛ける経過及び、形状及びジョイントの検索エラーをメッセージウインドウに表示します。実行時間は、かなり遅くなりますが、インポートしたのに意図したスキンが掛かってないような場合の原因究明に使えます
これらの設定をしてから ＯＫを押すと選択した範囲の形状に限定してスキンを適用します。シーン全体に対して行いたい場合は、ルートパートを選択して実行してください。読み込み中は、プログレスバーが現れます。キャンセル ボタンを押すと読み込みを中断します。
保存した範囲とインポート時に選択した範囲は厳密に一致している必要はありません。インポート時の選択範囲はエキスポート時の範囲より広く取ってあれば、その範囲内をサーチして設定します。
保存した範囲をひとまとめにして同じ構造のパートがあれば、別シーンでも、同じスキンを設定できます。さらに同じシーン内でも、別の部分のパートのスキンを保存し、別のパートへ同じスキンを設定するといった芸当もその二つの内部構造が同じなら可能です。
バイナリファイルかテキストファイルかは、自動認識します。
最初の適用は、スキンをインポートする形状の既存のスキンデータをクリアして新規設定する 新規設定と以前のスキンをそのままに重ね書きする 追加のいずれかを選択します。元々スキンがないと判っている形状の場合は、追加の方を選んだ方が多少高速です。
次のポイント位置を保持は、スキンを掛けたとき掛けられる側の形状のポイントのワールド位置をそのままに保持するかを指定します。掛ける側のジョイントが既に動いている場合など、自然にその変形に追従させたい場合などは、チェックを外し、とにかくその時点の形状の形を崩したくない場合は、チェックします。
次の特殊文字を無視は、チェックを入れるとジョイント名の先頭の特殊文字を無視して比較します。以前保存したスキンを新しいシーンに取り込もうとして、以前の形状名の頭に特殊文字を付けていたり、外していたりした場合などに指定すれば、以前のスキンファイルを再利用できます。
次のスキン元ジョイントは選択形状外は、スキンファイル内にあるスキンを掛ける側のジョイントは、その時点で選択しているパートの中に無い場合に指定します。チェックを入れるとジョイントは、シーン全体から探します。この利用面は、特定の１形状のみスキンを保存し、その形状のみ選択してスキンを掛けるような使い方をする場合などに利用します。また、逆にチェックを外して、ジョイント部分まで選択して実行すると、ジョイントの検索をその範囲に限定しますので、複数の同じ構造で同じ名前のジョイント構造がある場合などで利用できます。
饒舌な経過メッセージにチェックを入れると、形状にスキンを掛ける経過及び、形状及びジョイントの検索エラーをメッセージウインドウに表示します。実行時間は、かなり遅くなりますが、インポートしたのに意図したスキンが掛かってないような場合の原因究明に使えます
これらの設定をしてから ＯＫを押すと選択した範囲の形状に限定してスキンを適用します。シーン全体に対して行いたい場合は、ルートパートを選択して実行してください。読み込み中は、プログレスバーが現れます。キャンセル ボタンを押すと読み込みを中断します。
保存した範囲とインポート時に選択した範囲は厳密に一致している必要はありません。インポート時の選択範囲はエキスポート時の範囲より広く取ってあれば、その範囲内をサーチして設定します。
保存した範囲をひとまとめにして同じ構造のパートがあれば、別シーンでも、同じスキンを設定できます。さらに同じシーン内でも、別の部分のパートのスキンを保存し、別のパートへ同じスキンを設定するといった芸当もその二つの内部構造が同じなら可能です。
バイナリファイルかテキストファイルかは、自動認識します。
３．３．スキンクリア
コンテキストメニュー(ブラウザ上でマウスの右ボタンをクリックしたとき現れるポップアップメニュー)の スキンクリア を選択すると下のようなダイアログが開きます。
最初のポイント位置の保持は、スキンの読み込みと同様に、スキンをクリアしたときに、ポイント位置が変化するような場合に位置を保持させる指定です。チェックを入れない場合ポイント位置の変化は、 Shade に任されます。
次の選択ポイントのみクリアするは、 Shade が、編集モードの場合に選択されたポイントのスキンのみクリアします。チェックが入ってない場合は、全てのポイントをクリアします。
設定を行い、 OK を押すと対象のスキンが全てクリアされます。
最初のポイント位置の保持は、スキンの読み込みと同様に、スキンをクリアしたときに、ポイント位置が変化するような場合に位置を保持させる指定です。チェックを入れない場合ポイント位置の変化は、 Shade に任されます。
次の選択ポイントのみクリアするは、 Shade が、編集モードの場合に選択されたポイントのスキンのみクリアします。チェックが入ってない場合は、全てのポイントをクリアします。
設定を行い、 OK を押すと対象のスキンが全てクリアされます。
３．４．スキン内ジョイントクリア
コンテキストメニューの スキン内ジョイントクリア を選択すると使える機能です。
この機能を利用するには、予めクリアしたいジョイントを Shade に記憶させておく必要があります。記憶させてない場合、ジョイントが取得できませんでした。というメッセージを出して中断します。ジョイントが記憶された状態で、スキン内ジョイントクリアを実行すると、スキンクリアと同じダイアログが開きます。
アイテムの意味は、スキンクリアと全く同じです。
設定を行い、 OK を押すと対象のスキンの中で記憶で指定されたジョイントだけがクリアされます。
この機能を利用するには、予めクリアしたいジョイントを Shade に記憶させておく必要があります。記憶させてない場合、ジョイントが取得できませんでした。というメッセージを出して中断します。ジョイントが記憶された状態で、スキン内ジョイントクリアを実行すると、スキンクリアと同じダイアログが開きます。
アイテムの意味は、スキンクリアと全く同じです。
設定を行い、 OK を押すと対象のスキンの中で記憶で指定されたジョイントだけがクリアされます。
３．５．変換マトリックスリセット
コンテキストメニューの 変換マトリックスリセット を選択すると注意を促すメッセージボックスが開きます。
OK を押すと、選択している形状または、パート内の全ての形状の変換マトリックスが、そのポイント位置を変えないで単位マトリックス化します。キャンセルを押すと何もしないで終わります。
マトリックスのリセットが矛盾を生じる可能性がある場合があります。例えば、お互いに対称な関係にあるリンク形状とそのリンク元形状や、反転状態のマトリックスを持つジョイントや、そのスキンが掛けられている形状などです。
これらの形状が、リセット範囲に含まれている場合、予め Shade の記憶をさせておくと、その部分はリセットしません。
OK を押すと、選択している形状または、パート内の全ての形状の変換マトリックスが、そのポイント位置を変えないで単位マトリックス化します。キャンセルを押すと何もしないで終わります。
マトリックスのリセットが矛盾を生じる可能性がある場合があります。例えば、お互いに対称な関係にあるリンク形状とそのリンク元形状や、反転状態のマトリックスを持つジョイントや、そのスキンが掛けられている形状などです。
これらの形状が、リセット範囲に含まれている場合、予め Shade の記憶をさせておくと、その部分はリセットしません。
- Shade のスキンの設定は、自動バインド以外では、スキンウインドウでのマニュアルによる指定しか有りません。マニュアル場合、ジョイントを操作しながら、ウエイト量を調整していくことは、非常に根気のいる作業です。しかもジョイントとそのターゲットの選択を頻繁に切り替えて操作するため設定ミスや、意図しない形状へのミス設定する場合があります。
そこで設定完了した形状を選択して、個別に保存して置きます。そうすれば、その形状に間違えて変なスキンを掛けても、スキンをインポートすることで元に戻せます。このように、スキンの部品化が出来ます。
- 1つの共通のジョイント構造に複数の形状を適用する場合、1つのシーンの範囲なら問題はありませんが、それらを別ファイルにして保存すること(つまり部品化)は出来ません。例えば、人体モデル等で、1つのキャラクタに対して、髪や服、靴などを部品として単独で提供することだけは出来ても、人体モデルのジョイントにあわせることは無理です。しかし、そのshdファイルと人体モデル用のスキンファイルをペアにして提供すれば可能になります。
これで、異なる作者間でお互いの著作権に触れないで、個別に形状を提供しあえます。
- コピー等で作った左右対称や場所が異なるだけの形状のような場合同じスキン値を掛けたい場合など、元のスキンをエキスポートし、もう一方の形状を選択してインポートすると半分の労力でスキンを設定できます。このとき、共通なジョイントと個別なジョイントを自由に設定できます。
- 困ったことに相手がスキンを元々持たない形状の場合、プラグインでスキン掛けても、スキンは正しく掛かるのに Shade の図形ウインドウ内のワイヤフレームが、ジョイントの動きに追従しません。(その時点でのレンダリングには正しく反映してますので、ウインドウ内の描画だけの問題のようです。)
一度保存して、再読み込みすれば、ちゃんと変形しますので、それで我慢するか、もう1つの方法として、スキンウインドウで、予め仮のスキン設定(単に少しのポイントだけに適当にバインドでスキンを設定するだけです。)をしてから、スキン読込で新規設定でインポートすると何とか変形するようです。 - これは、好みの問題ですが、本プラグインの話というより、 Shade 共通の注意点です。
それは、スキンを掛ける方のジョイントと掛けられる方の形状のワールド座標系への変換マトリックスが異なるとき、特にお互いのマトリックスの要素が、正負反転している場合、スキンを掛ける時点では、ポイントの位置変形は起きないのに、スキンを外した瞬間にポイント位置が変形する現象が起きます。一度スキンを掛けたらもう形状操作はせず、ジョイントによるポーズ付けのみするのなら気にする必要は有りませんが、精神衛生上お互いの変換マトリックスを合わせることを薦めます。そのためにジョイントを反転コピーで作ったら、直ぐにその変換マトリックスをクリアすることを薦めます。 - テキスト形式で保存した場合、形状名に特殊な文字が含まれていると読み込みが出来ない可能性があります。ある程度防護策を取ってますが、私の 予期しない組み合わせがあるかもしれません。特に日本語の２バイト目が曲者です。バイナリ形式ではそのような制限は有りません。
- 保存時と読み出し時の Shade のテキストエンコードは同じに設定してください。でないと読み込みエラーになる可能性があります。
- 本プラグインの使用による何らかの障害およびデータの破壊等に付いては作者は一切の責任を負いません。
- 本プラグインおよび同梱の全てのドキュメントの著作権は作者に帰属します。
- 本プラグインはフリーソフトです。無料で自由にお使いになれます。
- 通常のユーザとしての使用以外に付いては事前に作者に連絡ください。
- 使用上の不具合、意見等がありましたら作者に連絡ください。保証するものではありませんが、改善のテーマとさせていただきます。
下の := はその左項を右項の形式であると定義している意味です。
下記の太文字は、その文字列そのものであるという意味です。文字列の実際の文字は C言語のそれに準じます。
ブランクはこの定義上の単なる区切りです。
（）で括られた文字列はその意味の説明です。
イタリック体の文字列は識別子と見なしてください。
... は、同様な形式が指定数続くという意味です。
その他は正規表現に準じます。
ファイル := ヘッダ部 本体部 フッタ部
ヘッダ部 := <skinfile>
フッタ部 := <end>
本体部 := { 形状タイプ : 形状名 : スキンポイント数 :\n 各スキン情報 子の本体部 }
子の本体部 := 本体部 （本体部と同じ構造のその子のパートの定義）
形状タイプ := [part| surface | rotator | slider | scale | uniscale | light_joint | path | morph | custom | ball | camera | link | light | line | sphere | disk | polygon ]
形状名 := (形状名の文字列です。)
スキンポイント数 :=(スキンポイント数の整数値表現したもの）
各スキン情報 := スキンポイント番号 : スキン数 : ウエイト : 対象のジョイント名 : ... \n ...
スキンポイント番号 :=（その形状内のスキン対象のポイントの番号を整数値表現したもの）
スキン数 := （そのポイントにかかっているスキンの番号を整数値表現したもの）
ウエイト := （スキンのウエイト値を実数値表現したもの)
スキン対象のジョイント名 := [フルパス形式のジョイント名 | ジョイント名 ]
フルパス形式のジョイント名 := 上位名 ターミネータ 上位名 ターミネータ ... ターミネータ ジョイント名
上位名 := （対象のジョイントの上位のパートの形状名）
ジョイント名 := （対象のジョイントの形状名）
ターミネータ := [ / | : | \ | " | ' ] （その時々に適切なターミネータが選ばれる）
下記の太文字は、その文字列そのものであるという意味です。文字列の実際の文字は C言語のそれに準じます。
ブランクはこの定義上の単なる区切りです。
（）で括られた文字列はその意味の説明です。
イタリック体の文字列は識別子と見なしてください。
... は、同様な形式が指定数続くという意味です。
その他は正規表現に準じます。
ファイル := ヘッダ部 本体部 フッタ部
ヘッダ部 := <skinfile>
フッタ部 := <end>
本体部 := { 形状タイプ : 形状名 : スキンポイント数 :\n 各スキン情報 子の本体部 }
子の本体部 := 本体部 （本体部と同じ構造のその子のパートの定義）
形状タイプ := [part| surface | rotator | slider | scale | uniscale | light_joint | path | morph | custom | ball | camera | link | light | line | sphere | disk | polygon ]
形状名 := (形状名の文字列です。)
スキンポイント数 :=(スキンポイント数の整数値表現したもの）
各スキン情報 := スキンポイント番号 : スキン数 : ウエイト : 対象のジョイント名 : ... \n ...
スキンポイント番号 :=（その形状内のスキン対象のポイントの番号を整数値表現したもの）
スキン数 := （そのポイントにかかっているスキンの番号を整数値表現したもの）
ウエイト := （スキンのウエイト値を実数値表現したもの)
スキン対象のジョイント名 := [フルパス形式のジョイント名 | ジョイント名 ]
フルパス形式のジョイント名 := 上位名 ターミネータ 上位名 ターミネータ ... ターミネータ ジョイント名
上位名 := （対象のジョイントの上位のパートの形状名）
ジョイント名 := （対象のジョイントの形状名）
ターミネータ := [ / | : | \ | " | ' ] （その時々に適切なターミネータが選ばれる）
- 作者名; まさ/MASA
- E-Mail; m-sou@mti.biglobe.ne.jp
- 2010/2/4 V10.0.0
- SDK を10に変更し機能を整理した。
- バージョン設定にSDKバージョンをメジャーバージョンに変更。ver10.0.0とした。
- Windowsの64bit版及び、MacOSX版を同梱した。
- 2005/1/25 V2.0
- スキンの読み込みの検索アルゴリズムを少し偉くして、多少同じ名前の形状があっても見付けるようにした。
- ジョイントとそのスキンが掛けられるポイントを含む形状のお互いの変換マトリックスが異なる場合のインポートで形状が変形する場合があるバグを修正。
- Shade 7 は、バージョンを全て 2.0. 以上にした。
- 2004/11/3 V1.1
- マトリックスのリセットと調整コマンドを追加。
- プログレスバーのキャンセルが正常にキャンセルされるようにした。
- 2007/6/20 V1.0.
- (初版)リリース。