【Pocket Mesh Maker ver.1.4】選択メッシュをプリミティブとしてライブラリ化するアドオンジェネレータ

●アドオン本体(Add-on)
■Pocket Mesh Maker (ver.1.2)
text: pmmaker14.py
zip: pmmaker14.zip

(更新記録)
2014/9/22 7:18 PM (ver.1.4)
選択した登録元のメッシュオブジェクトにメッシュデータがない場合にエラーを起こしていたのを修正

2014/9/23 9:23 AM (ver.1.3)
とほほな書き出しルーチンを全面修正したのでポケットメッシュアドオンの生成時間が大幅に速くなりました。
ポリゴン数が多いために生成に３０分かかっていたものが数秒で完了します（をいをいw）
また、ややこしいので追加登録機能をなくして常に上書きするようにしました。

2014/9/19 1:24 AM (ver.1.2)
ポケットメッシュアドオンのファイル指定項目を簡素化して手間を省き、エラーチェックを強化。
出力されたポケットメッシュアドオンがアンドゥーに対応。

2014/9/18 7:00 AM (ver.1.1)
ポケットメッシュアドオンの出力ファイルパスまわりの不具合修正と仕様を1.0から変更しました。
BLUG.jpさん、Pentanさんありがとうございました。

このアドオンは選択したメッシュ（複数選択可）の面、辺データをスクリプト（テキスト）化し、
それをリストから選んで作成するアドオン（ポケットメッシュアドオン）を生成するアドオンジェネレータです。

生成されたアドオンを普通にインストールすることにより、任意のメッシュをプリミティブ
としてライブラリ化し、いつでもポケットから取り出すように気軽に好きなメッシュを
パーツや小物、素体等のオブジェクトとして再利用することができます。

生成する際、ダイアログ上でクラス名とＩＤ名（詳しくは後述）を変更することで、いくつでもポケット
メッシュアドオンを併用することができます。これを使ってカテゴリごとにプリミティブ集を作るといった
こともできます。

生成されたものは普通のアドオンなので、自作のプリミティブ集として他者にあげたり、公開するのも
簡単です。
また、テキストデータですから、使い慣れたテキストエディタで登録したメッシュの名前を変更することも
できます。

ただし、ポリゴン数の多いメッシュの利用は大量にメモリを消費し、アドオンの生成にも長い時間
がかかりますので、基本的にはローポリゴンベースやパーツベースでご利用ください。

基本的には以下の手順で使用します。

１．pmmaker10.pyを「ファイル→ユーザー設定→アドオンタブ→ファイルからインストール」でインストール

２．Blender2.7以降では「作成」タブ（それ以前はツールシェルフ）上に本アドオンが表示されます

３．オブジェクトモードでライブラリ化したいメッシュオブジェクトを選択します。（複数選択可）
　　選択オブジェクトに他のタイプのオブジェクトが混じってもメッシュオブジェクトだけが対象になる
　　ので、全選択も気軽に使えます。

４．「ポケットメッシュアドオンを生成」ボタンを押します

５．ダイアログ上で生成するアドオンのファイル名等を指定します。（詳しくは後述）

６．ＯＫを押すとユーザーのアドオン用フォルダ上にポケットメッシュアドオンが生成されます。
　　５．でファイル名の前のパスを変更すればそのフォルダ上に生成されます。

　　ここでトータルのポリゴン数が多いとアドオンが生成されるまでかなり時間がかかります（数分から
　　数十分Blenderが無反応になる）のでご注意ください。
　　同じファイル名で生成を繰り返すと、選択したメッシュがそのたびにそのファイルに追加されます。
　　５．で「上書きする」にチェックを入れると選択中のメッシュのみが登録され、以前のデータは消去
　　されます。（選択したメッシュのサイズや角度だけを一括修正したい時などに使います）
　　生成時間は大幅に速くなりました。
　　また、同じファイルは常に上書きするよう、仕様を変更しました（ver.1.3)

７．「ファイル→ユーザー設定→アドオンタブ」の下にある「更新ボタン」を押して、マウスの中ボタン等で軽く
　　スクロールしたり一旦別なタブに移動して戻ると生成されたポケットメッシュアドオンが表示されます。
　　また、同じファイル名のものをすでに登録してある場合は一度有効化のチェックボックスを外し、再度
　　有効化すれば更新されます。

　　なお、左上の虫眼鏡のついた検索欄に文字が入っているといつまでも生成したアドオンが表示されない
　　場合があります。
　　その場合は文字を削除し、カテゴリでPOCKET_MESHを再度選んでください。

　　上記は６．でファイルパスを変更しなかった場合です。
　　変更した場合はそこから「ファイルからインストール」でインストールしなおします。（ver.1.1で仕様変更）

８．ポケットメッシュアドオンを有効にすると２．と同様にBlender2.7以降では「作成」タブにアドオンが
　　表示されます。

９．メッシュを配置ボタンを押して、メッシュリストから作成したいメッシュの名前を選んでＯＫすれば
　　３ｄカーソル上にそのメッシュが作成されます。

１０．下の欄でスケールや角度を指定して作成することもできます。
　　　「変換を適用する」にチェックを入れると、スケール・角度の変換が適用（Ctrl+A）されます。
　　　登録されたメッシュの大きさを一度にスケールしなおして再度ポケットメッシュアドオンを生成
　　　する際にも利用できます。
　　　「全てを配置」をチェックすると、登録された全てのメッシュが３ｄカーソル上に横一列に作成
　　　されます。

　　　

●「ポケットメッシュアドオンを生成」ダイアログのパラメータの指定について

アドオンの保存先：
　　　ここが空だとユーザーのアドオンフォルダに保存され、インストールはユーザー設定の更新
　　　ボタンを使います。
　　　ポケットメッシュアドオンの保存先のパスを指定するとそちらに保存されます。
　　　パスばWindowsの場合、c:やc:\userなどと指定します。

アドオンのファイル名：
　　　ポケットメッシュアドオンのファイル名を半角英数字で指定してください。（大文字も可）
　　　拡張子の.pyはつけないでください。
　　　デフォルトでユーザーのアドオンディレクトリ上にアドオンが作成されます。
　　　ファイル名の前のパスを変更することで、任意のフォルダに作成することもできます。

アドオンの作者名：
　　　作者名を入力してください。そのままでも特に問題ありません。日本語やスペースを使用しても
　　　ＯＫです。

アドオンのタイトル：
　　　ツールシェルフ上に表示されるタイトルです。ユーザー設定のPOCKET_MESHカテゴリ
　　　上にもタイトルとして表示されます。
　　　日本語やスペースを使用しても大丈夫ですし、どんな名前でもＯＫです。
　　　自動車とか武器、植物、動物、家具、顔パーツ、人体等、登録されたメッシュのカテゴリ名として
　　　使うとよいでしょう。

＜使用上の注意点＞
ローポリベースで使う分には特に問題ないと思いますが、ユーザー設定でサイズが大きな（大量の
ポリゴンを含む）ポケットメッシュアドオンを有効にしたまま「ユーザー設定を保存」するとBlenderの
起動が目に見えて遅くなったりしますので、大きなサイズのポケットメッシュアドオンはBlenderが
起動した後、必要に応じて有効にするのがよいと思います。

↓ポケットメッシュアドオンを併用している例：