# GTA Skin I/O for Metasequoia

### 概要

登録済みのMetasequoia 2.4.9以上でKeynoteと連携してGTA:SA用のスキンモデルの入出力を行います。

### インストール

登録済みのMetasequoia 2.4.9以上とKeynoteが必要になります。メタセコイアは\5000なので買いましょう。
(Metasequoia)\Plugins\Import\に同封のGTASkinImport.dll、(Metasequoia)\Plugins\Export\に同封のGTASkinExport.dllを放り込むか
Metasequoiaのメニューバーのヘルプ>プラグインについて>インストールでGTASkinImport.dll、GTASkinExport.dllを選択してください。
正常にインストールされればファイルダイアログのファイルの種類にGTA:SA Skinned Meshが追加されます。
メタセコイア - metaseq.net
Keynote - mqdl

### インポート

開く、またはオブジェクトの挿入で.dffを選択すると右のようなダイアログが現れます。

- クランプ - プレイヤーモデルなどの複数のクランプを含んでいる場合に選択できます。
- 拡大率 - モデルの拡大率を指定します。デフォルトでは100.0倍です。

メタセコイア・Keynoteの仕様上、ウェイト・法線のインポートはできません。

### エクスポート

Keynoteが起動されている状態([ボーン]が押された状態)になっている必要があります。
名前をつけて保存でGTA:SA Skinned Meshをファイルの種類に選んで保存すると右のようなダイアログが現れます。

- 接地させる - モデルのうちもっともY座標の小さい点が地面にくるようにずらします。
- 頂点の分割処理 - オブジェクトを再構築し、以下の2つの処理を有効にします。
- UV値で頂点を分割 - UV値が異なる場合に頂点を分割します。DFFでは頂点ごとにUV座標を1つ持ちます。
- 法線で頂点を分割 - 法線が異なる場合に頂点を分割します。DFFでは頂点ごとに法線を1つ持ちます。
- テクスチャ(.txd)を出力 - DFFと同名のテクスチャの入ったTXDを作成します。TXD Workshopで圧縮できます。
- 拡大率 - モデルの拡大率を指定します。デフォルトでは0.01倍です。

プレイヤーモデルを作成する際にはマテリアルのテクスチャ設定を削除してください。
プレイヤーモデルなどの複数のクランプを含んだモデルを作成するにはRipped、Fat、Normalそれぞれのモデルを
別々のDFFに出力し、ファイル名を指定して実行で以下のコマンドを実行します。
`copy [ripped].dff /b + [fat].dff /b + [normal].dff /b [dest].dff`
GTA:SAの仕様上、頂点色のエクスポートはできません。
また、マテリアルの色は反映されません。

### モデルの作成

同梱のmale01.mqoを参考にしてください。
ボーン、アンカーも完全で、そのまま出力できる状態のモデルです。
自作モデルを使用する場合も極力male01.mqoのボーンを変形させて使ってください。
アンカーは何でもいいです。関節は主にHeadの回転をします。
また、出力する前にはミラー・曲面等をフリーズしておいてください。
インポートして作成されたボーン用のマテリアルのバンプマップにはボーンの情報が入っています。
他のボーンを流用する際などには注意してください。

### 既知の不具合

- インポートしたモデルのポリゴンが1枚欠けることがあります。
- インポートしたモデルの向きが変になっていることがあります。

### 作者

Ryosuke
GTA SA Modification Center