Skip to content

Blender用のPLYツール。PLYを読み込んで、アーマチュアへの適用やテクスチャーの出力を行う。

License

Notifications You must be signed in to change notification settings

am1tanaka/ply2fbx

Repository files navigation

PLY2FBX

MagicaVoxelPLY形式で出力したボクセルのキャラクターにウェイトを設定して、テクスチャーを生成して、FBXとPNGを出力するBlender用のスクリプトです。

  • v1.0.4(2018/8/30) インストール方法をアドオンからできるように改善
  • v1.0.3(2018/8/30) エクスポート時にデータに含めるオブジェクトを選択する機能を追加

2通りの方法で、ウェイト設定をしたキャラクターを作ることができます。

  • Blenderのみ利用する方法
  • Blenderとmixamoを利用
    • BlenderでエクスポートしたテクスチャーとFBXファイルをZIP圧縮して、mixamoにアップロードしてウェイト設定とアニメーション付けをする

PLY形式のボクセルモデルのテクスチャーを作成して、FBXにエクスポートするのにも利用できます。

バージョンアップする前に

v1.0.4からアドオンとしてインストールするように変更しました。v1.0.3以前からバージョンアップする場合は、以下の手順に従ってstartupフォルダーに入れたply2fbx-armature.pyを削除してください。

  • Blenderが起動していたら閉じてください
  • Windowsの場合、C:\Program Files\Blender Foundation\Blender\2.79\scripts\startupを開きます
  • macの場合、Finderでアプリケーションを選択 -> blender-2.??-macOS-?? -> blenderを[Ctrl]+クリック -> パッケージの内容を表示 -> Contents -> Resources -> 2.79 -> scripts -> startupを開きます
  • ply2fbx-armature.pyを削除します(なければ大丈夫です)

copy py file

インストール

Blender 2.79bにインストールする手順です。Blenderはインストール済みとします。

  • こちらから最新バージョンのply2fbx-armature.pyを、分かりやすい場所(デスクトップなど)にダウンロードします
  • Blenderを起動して、FileメニューからUser Preferencesを選択します
  • Add-onsを選択したら、*Install Add-on from File...*をクリックします

From File

  • ダウンロード先を指定したら、ply2fbx-armature.pyを選択して、*Install Add-on from File...*ボタンをクリックします

Install Add-on

  • 左上からTextingをクリックして選択して、Import Export: PLY2FBXエクスポーターにチェックを入れて、左下のSave User Settingsボタンをクリックして状態を保存します

Enable Add-on

以上でインストール完了です。Blender User Preferencesウィンドは閉じて構いません。

左のパネルの一番下にMiscタブが追加されるのでクリックしてください。Import PLY, Auto Weight, Export FBX and Textureの3つのボタンが確認できればOKです。

show ply tool

本来はAdd-onにした方がよい気もしましたが、詳しくないのでとりあえずStartupで読み込むようにしました。(対応しました!2018/8/30)

タブ名のMiscもそのままです。気になるようでしたらMITライセンスですのでご自由に修正ください。プルリク歓迎!

チュートリアル

詳しい利用手順は以下を参照ください。

使い方

Import PLY

Import PLY

機能

以下の処理をします。

  • PLYファイルをインポート
  • 重複頂点を削除(Remove Doublesの実行)
  • 原点を中心に、左下のScaleの倍率でモデルの大きさを変更

使い方

Panel

  1. ファイルを読み込む場所を指定します
  2. PLYファイルを選択します(上のファイル名欄にファイル名を入力してもよいです)
  3. Importを実行するボタンです

自動スケーリング機能

MagicaVoxelでモデリングしたキャラクターをUnityに持っていくと、1ボクセル1m換算されるので巨大になります。そこで、インポート時に自動的にそれっぽいサイズに縮小する機能をつけています。

左下のScale欄の値で、モデルをインポートした後に大きさを変更します。デフォルトは0.22倍で、だいし様のブログで配布されている素体をこの設定で読み込むとベースアーマチュアと丁度よい大きさになります。

そのままのサイズで読み込む場合は1を設定するか、普通にFileメニューのImportで読み込んでください。

自動ウェイト設定

Auto Weight

機能

アーマチュアとキャラクターのメッシュを読み込んでいるとボタンが有効になります。以下を行います。

  • メッシュとアーマチュアに親子関係を設定
  • その際に、アーマチュアとメッシュに自動ウェイト設定

使い方

  1. 事前にアーマチュアのblenderファイルと、キャラクターのメッシュをインポートしておきます
  2. Auto Weightボタンをクリックします

以上で、読み込まれているアーマチュアとメッシュを自動的に選択して、親子設定します。

複数のアーマチュアやメッシュがあることは想定していないので、1体分で作業してください。

Export FBX and Texture

Export

機能

PLYファイルをUnityで表示できるFBXにするために以下を実行します。

  • 頂点カラーからテクスチャーを生成
  • マテリアルを作成してアタッチ(マテリアルは白色に設定)
  • 指定のフォルダーとファイル名でFBXPNGファイルをエクスポート

使い方

事前にPLYファイルをインポートしておきます

Export

  1. 保存先のフォルダーを設定します
  2. ファイル名を入力します
  3. Export FBX and Textureボタンをクリックします

以上で、指定したフォルダーに、ファイル名.fbxファイル名.pngが出力されます。

  • Unityにインポートする場合
    • 出力された2つのファイルを選択して、まとめてUnityのProjectビューにドラッグ&ドロップします
  • mixamoにアップロードする場合
    • 出力された2つのファイルをZIP圧縮して、mixamoにアップロードします

テクスチャーサイズの変更について

デフォルトでは512x512ピクセルのテクスチャーを生成します。このサイズはウィンドウの左下のTexture WidthTexture Heightで変更できます。

ボクセル数が多いと、テクスチャーの解像度が足りなくなるかも知れません。その場合は、10242048に変更してみてください。

逆に、512も必要ない場合は、128256に変更してみてください。

データに含めるオブジェクトの選択

デフォルトでは、CAMERALAMPは含めないようになっています。含めたい場合は、FBXのファイル名を指定する画面の左下で、[Shift]キーを押しながらCAMEARLAMPをクリックして追加してください。

参考・関連URL


ライセンス

MIT License

Copyright (c) 2018 Yu Tanaka

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

Blender用のPLYツール。PLYを読み込んで、アーマチュアへの適用やテクスチャーの出力を行う。

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages