MacroScript は、MacroRecorder の出力、MAXScript リスナ、または MAXScript エディタからツールバー上にスクリプト コードをドラッグ アンド ドロップすると、自動的に生成されます。新しいスクリプトには .mcr という拡張子が付けられ、既定では #userMacros フォルダに書き込まれます(「3ds Max システム ディレクトリ」を参照)。
#userMacros フォルダの位置は、メイン メニューの[カスタマイズ] (Customize)/[システムパスを設定](Configure System Paths)/[追加マクロ](Additional Macros)で設定できます。 設定の内容を確認するには、MAXScript リスナーに以下のように入力します。
getDir #userMacros
ドラッグ アンド ドロップで MacroScript を作成するには:
MacroRecorder の出力、MAXScript リスナー、MAXScript エディタのうちいずれかから一部のコードを選択します。
選択内容をクリックし、マウスの左ボタンを押したままツールバーにドラッグします。
マウスの左ボタンを放し、選択内容をツールバーにドロップします。
結果: 新しいボタンが作成され、一般的な MacroScript アイコンが表示されます。 新しいスクリプトには「MacroN」という名前が付きます。Nは、ドラッグ アンド ドロップ操作を行うたびに増加する一意の数値です。新しいスクリプトのカテゴリは「DragAndDrop」です。
MacroScript は、メニュー、クアッド メニュー、ツールバー、キーボード ショートカットの ActionItem として使用することもできます。
スクリプトを開発するときには、手入力で記述することもできますが、自動的に生成された MacroRecorder コードをテンプレートとして使用すれば、効率的に作成することができます。開発者のソース コードを .ms ファイルに入れることもできます。
標準的な MacroScript は通常、次の行で始まります。
macroScript scriptName category:"CategoryName" ( ... )
category: の名前に注意してください。 [カスタマイズ]ダイアログ ボックスでスクリプトを検索するときに必要になります。
MacroScript をインストールするには:
メインメニューの MAXScript 項目をクリックし、[スクリプトを開く]を選択します。
または、[ユーティリティ]パネルに移動して MAXScript Utility を開き、[スクリプトを開く]を押します。
スクリプトを選択し、[開く]をします。
MacroScript の名前とカテゴリ名を書きとめます。
MAXScript エディタで[ツール]メニューをクリックし、[すべてを評価]を選択するか[Ctrl]+[E]を押します。これで、スクリプトが評価されます。
[カスタマイズ]/[ユーザ インタフェースをカスタマイズ] に移動し、使用したいタブ (キーボード、ツールバー、クアッド、またはメニュー) を選択します。
カテゴリ内で 3. でメモした名前を検索します。
スクリプトをツールバー、メニューまたはクアッドメニューにドラッグするか、ショートカットに割り当てます。
評価される MacroScript がアクション項目の[カスタマイズ]ダイアログ ボックスのカテゴリに表示されます。このスクリプトは、そのソースの場所を記憶しています。MacroScript の定義が評価されると、ソースのコピーが #userMacros フォルダに自動的に保存されます。保存名は、カテゴリ名、MacroScript 名、.mcr 拡張子で構成されます。
スクリプトを変更または更新したときに、同じ名前とカテゴリを使って新しいバージョンまたは別のバージョンを評価すると、#userMacros フォルダ内のスクリプトのコピーが変更または更新されたスクリプトで上書きされます。
あらかじめ定義されている MacroScripts が含まれている #macroScripts*、およびユーザ定義の MacroScripts が含まれている *#userMacros はすべて起動時に自動的に評価され、ユーザはそれ以降のセッションで使用することができます。 MacroScript を永久に削除するには、#userMacros フォルダから .mcr ファイルを個別に削除する必要があります。
MacroScript ソースは、#startupScripts またはプラグイン パスなど、自動的に起動されるフォルダにはできるだけ保存しないでください。1 つのソース コードが、2 つの異なる場所から二重に評価されることになります。 MacroScripts のソース (独自に作成したスクリプト、Web から無料でダウンロードしたスクリプト、または市販のスクリプト) は、[パスを設定]ダイアログ ボックスに表示されていないパスに保存してください。3ds Max では、このように自動的に管理される #macroScripts および #userMacros フォルダの内容だけが使用されます。
項目: