スクリプトプラグインを使用する

VRED Professional はカスタム Python モジュール(スクリプトプラグイン)をサポートします。次回の VRED の起動時にこれらの(スクリプトプラグインを自動的にロードするには、特定の場所にコピーする必要があります(「 スクリプトプラグインをロードする 」を参照)。この後にロードされたすべてのスクリプトプラグインは、[スクリプト]メニューに表示されます。

[スクリプト]メニュー

スクリプトプラグインの処理方法

スクリプトプラグインは、VRED の「メイン」コンテキストから独立するように作成されていて、スクリプトエディタ、ターミナル、またはスクリプトの基本設定で実行されるすべての Python コード、または VPB とともにロードされたスクリプトが、このプラグインで実行されます。スクリプトプラグインは、「メイン」コンテキストとは異なり、新しいシーンの作成の影響を受けません。フラッシュされて、既定の状態にリセットされます。

ターミナルまたはスクリプトエディタで実行される Python コマンドは、プラグインに影響を与えることも、互いに干渉することもありません。

スクリプトプラグインをロードする

SimpleExample またはユーザ独自のスクリプトプラグインを[スクリプト]メニューに追加するには、次の手順を実行します。

旧バージョンの VRED を実行している場合*は、[スクリプト]メニューが表示されない可能性があるため、メニューバーに[スクリプト]メニューを追加する必要があります。続行する前に、[スクリプト]メニューを作成する必要があります。この操作を行う手順については、「 *[スクリプト]メニューを作成する方法」を参照してください。

[スクリプト]メニューを作成しても、スクリプトを ScriptPlugins フォルダにロードして VRED を再起動していない限り、メニューバーに表示されないことに注意してください。ここでは、スクリプトプラグインをロードする方法について説明します。

Windows の場合

Windows エクスプローラーで ScriptPlugins フォルダを作成したら、次の場所に移動します。

C:\ProgramData\Autodesk\VREDPro-<internalVersion>\examples\plugins
SimpleExample フォルダをコピーして、ScriptPlugins フォルダに貼り付けます。

C:\Users\<username>\Documents\Autodesk\VRED-<internalVersion>\ScriptPlugins\
作業を保存し、閉じてから、VRED を再起動します。これで[スクリプト]メニューがメニューバーに表示されます。このメニューを選択すると、SimpleExample という例がリストされます。

Mac の場合

ScriptPlugins フォルダを作成したら、Finder ウィンドウで、次の場所に移動します。

/Users/Shared/Autodesk/VRED-<internalVersion>/examples/plugins/SimpleExample
SimpleExample フォルダをコピーして、ScriptPlugins フォルダ内に貼り付けます。

C:/Users/<user>/Documents/Autodesk/VRED-<internalVersion>/ScriptPlugins/
作業を保存し、閉じてから、VRED を再起動します。これで[スクリプト]メニューがメニューバーに表示されます。このメニューを選択すると、SimpleExample という例がリストされます。

スクリプトプラグインを更新する方法

メモリ内で実行されているコードは更新できないため、スクリプトプラグインを更新するには、[編集] > [スクリプトプラグインを再ロード]を使用して、開いているプラグインウィンドウをすべて閉じます。プラグインを編集し、プラグインのウィンドウを閉じてから、[編集] > [スクリプトプラグインを再ロード]を実行してプラグインを更新します。

ロード解除したプラグインで何らかの作業を行う必要がある場合は、次の新しいコールバック関数を試してください。

このサンプルは QtQuickStreaming.py に含まれています。

def onDestroyVREDScriptPlugin():
    """
    onDestroyVREDScriptPlugin() is called before this plugin is destroyed.
    In this plugin we want to stop all processes.
    """
    streamingPlugin.deleteAllProcesses()

スクリプトプラグインから VREDPluginWidget、VREDMainWindow、vrMainWindow にアクセスできます。これらは、スクリプトプラグインをロードまたは再ロードするときに、各プラグインの globals にコピーされます。