Magical Doodle描画ファイルのUnity/VRChatへのインポート手順

■ 動作環境

Unity 2022以降（Built-in Render Pipelineのみ対応）
Magical Doodle Ver.2.71以降

■ 注意事項

描き出し時のペンの太さがすべての描画線に適用されます（ペンの太さを途中で変更するケースには対応していません）
「魔法」のアニメーションはインポートできません。
描画のアニメーションのみ設定することが可能です。
インポートしたパーティクルはスクリプトを実行できない環境(VRChat等)でも表示できるように変換されるため、Magical Doodleのアプリ上の表現とは多少異なる場合があります。

■ 生成パーティクルについて

本アセットで生成されるパーティクルは、以下３つのパーティクル（Particle System）の組み合わせで表現される（インポート設定やペンの種類によっては２つまたは１つの場合もある）

メイン(Main)パーティクル
補助(Sub)パーティクル
遠方(Far)パーティクル

■ インポート手順

1. Magical Doodleでの描画と保存

Magical Doodleを起動し、絵を描く。
左手でわっかを作ってメニューを開き、上部左上にある保存アイコン(矢印が本の中を指すアイコン)をタッチ。1～10ページのどこかに保存。

2. PCに描画ファイルを取り込む

PCとQuestをUSBケーブルで接続し、PCからQuestの内部ストレージにアクセスできるようにする。
詳しくはMeta公式サイトの「1.～3.の手順」を参照。
Questの内部ストレージからPCにファイルをコピーする。
下記パスにある Draw????.magicaldoodle ファイル(????は保存時に選択したページ番号)を、PCのローカルドライブの任意の場所にコピー。
- 日本語環境：
  内部共有ストレージ\Android\data\com.tarya.arstargraffiti.quest\files
- 英語環境：
  Internal shared storage\Android\data\com.tarya.arstargraffiti.quest\files

3. Unityプロジェクトの準備

プロジェクトの作成（必要な場合のみ）

VRChatに出力する場合：VCC（VRChat Creator Companion）からVRCHAT SDK3を含むプロジェクトを作成
上記以外の場合：Unity HubのProjectsから「New project」を選択する等して作成。
その場合のテンプレートは3D(Built-in Render Pipeline)を選択

Unity Hubでインポート先プロジェクトを開く
(未インポートの場合のみ)プロジェクトにMagical Doodle Importerをインポート
- BoothからMagicalDoodleImporterをダウンロード。
- Unityメニュー アセット/Assets > パッケージをインポート/Import Package > カスタムパッケージ/Custom Package... を選択し、
  ダウンロードした MagicalDoodleImporter.unitypackage を選択。
- "Import Unity Package"ウィンドウで、チェックの状態は変更せず、インポート/Import ボタンを押下。

4. Unityへのインポート

パーティクルの配置先となる親オブジェクト選択
- ヒエラルキー/Hierarchyウィンドウで、パーティクルを持たせたい親オブジェクトを選択。
  ここで指定した親オブジェクトに連動してパーティクルが動くようになる。
インポータ起動
- Unityメニューの ツール/Tools > Magical Doodle > インポート/Import を選択。
- プロジェクトで最初に起動した場合、使用許諾契約が表示されるので、内容に同意する場合は「同意する」をクリック。
インポートしたい.magicaldoodleファイル選択
- "Select a Magical Doodle Drawing File" ウィンドウで、「PCに描画ファイルを取り込む」の手順でコピーしたmagicaldoodleファイルを選択し、開くボタンを押下。
インポート設定
"Magical Doodle Importer" ウィンドウで、インポートを調整するためのパラメータを設定する。（よく分からない場合、最初はデフォルトのままでも問題なし）
- 最適化 ... 品質と負荷のバランスを調整するためのパラメータ群
  - Mainパーティクル削減率: 全体的なパーティクルの削減率 (0～1.0)。0が最も元絵に近いが、負荷も高い。メイン・補助・遠方パーティクルの全てに影響する
  - Subパーティクル削減率: 補助パーティクルの削減率 (0～1.0)。0が最も元絵に近いが、負荷も高い。1にすると、補助パーティクル(Sub)と遠方パーティクル(Far)が生成されない
  - Farパーティクルを作成しない: チェックすると遠方パーティクル(Far)を省略。チェックしない方が元絵に近いが、負荷も高い
- アニメーション ... アニメーション設定のためのパラメータ群
  - Enable Animation: チェックすると、筆跡に沿って線が流れるアニメーションが有効化される
  - Animation Duration: アニメーションの秒数を0以上の小数で指定 (例: 2を指定すると、2秒間でループ)
  - Stroke Length: 流れる線の長さ(0～1.0)。全体の筆跡の長さに対する割合で指定
- その他 ... その他のパラメータ群
  - 線幅: パーティクルの大きさを補正する係数(1で元サイズのまま)
  - 残像: パーティクルが移動した時の残像の強さ。メイン・補助・遠方のそれぞれのパーティクルで残像が有効となるかどうかが変化する
  - VRChat用にセットアップ: チェックでシェーダやテクスチャをVRChat向けに最適化(UnityプロジェクトにVRChat SDKがインポートされていない場合は"VRChat SDK not found"と表示され、チェック不可となる)
インポート実行
- OK ボタンを押下すると、インポートが実行される。
  完了すると「Done」のメッセージとMaxParticlesの合計数が表示される。
- ヒエラルキー/Hierarchyウィンドウの手順4)-1)で選択したオブジェクトの子供に、以下のようにパーティクルオブジェクトが作成される。
```
 親オブジェクト (選択したオブジェクト)
  ┗ (ファイル名_連番)_Main ：メインパーティクル
      ┣ (ファイル名_連番)_Sub ：補助パーティクル（Sub reductionが1の場合は生成されない）
      ┗ (ファイル名_連番)_Far ：遠方パーティクル（Exclude far particlesにチェック、またはSub reductionが1の場合は生成されない）
```
パラメータ調整
- パーティクル数などを再調整したい場合は、再度「パーティクルの配置先となる親オブジェクト選択」からやり直す。

5. インポート後の操作

(必要な場合)位置・向きなどの調整
- ヒエラルキー/Hierarchyウィンドウで生成された (ファイル名)_Main オブジェクトを選択。
- シーン/SceneビューのMove Tool/Rotate ToolやInspectorなどで位置/向き/スケールを調整。
- パーティクルのパラメータ調整や、(ファイル名)_Main、(ファイル名)_Sub、(ファイル名)_Farのうちの一部または全部の削除も可。
(VRChatの場合)アップロード
- 表示／非表示を切り替えられるようにする場合、必要に応じてModular Avatorなどを活用しながら、エクスプレッションメニューへの割当などを行う。
- BuilderタブのValidationsリストの内容を確認後、問題なければアップロード実行。

■ Importerのアップデート手順

すでにMagical Doodle Importerをインポート済みのプロジェクトでImporterをアップデートしたい場合、まずAssetsフォルダにある既存のMagical Doodle Importerフォルダを削除したのち、再度インポート手順3.の3. プロジェクトにMagical Doodle Importerをインポートの手順を実行してください。