環境変数
- IndyZone
HDR Light Studioには、様々な制御をするための環境変数があります。
環境変数の追加方法は、このページでLogの設定方法を紹介していますが、以下の環境変数もすべて同じ手順で設定することができます。
HDRLS_HOME_V5
Maya、3ds Max、Cinema 4Dなどの3Dアプリケーションに接続してHDR Light Studioを使用する場合、HDR Light Studioの実行ファイルがあるディレクトリを指す環境変数HDRLS_HOME_V5をシステム上に設定する必要があります。これは、プラグインのConnectionにHDR Light Studioアプリケーションの場所を指定します。この環境変数は、すべてのプラットフォームで必要です。WindowsとMacOSでは、インストール時に自動的に設定されますが、Linuxでは、インストールプロセスが設定されていないため、手動で設定する必要があります。
HDRLS_USER_DIR
HDR Light Studioのユーザーディレクトリには、ライセンスファイル、プリセット、ユーザープリセット、プリセットのキャッシュ、お気に入りのプリセット設定ファイルなど、HDR Light Studioが必要とするファイルが格納されたフォルダがデフォルトで用意されています。
デフォルトのインストールでは、Windowsの場合、このパスは次のようになります。
C:\Users\Username\AppData\Local\lightmap
これらのファイルを別の場所に保存したい場合は、環境変数HDRLS_USER_DIRを設定します。
例えば以下の通りです。
HDRLS_USER_DIR = \DiskName\HDRLS_DATA\USER\
HDR Light Studioは、現在ASCII文字のみをファイルパスとしてサポートしています。そのため、OSアカウントのユーザー名に非ASCII文字が含まれている場合、この設定を使用した方が、HDR Light Studioが正常に動作する場合があります。例えば、3ds MaxでHDR Light Studioを使用する場合などです。(注意：ユーザー名にASCII文字が含まれていない場合は、この設定を使用しても、他の接続が正しく機能しない場合があります)。
HDRLS_TEMPRENDER_DIR
HDR Light Studioを使用する際、3Dソフトと共有する一時ファイルや、レンダリング時の一時ファイルが作成されます。
デフォルトのインストールでは、Windowsの場合、このパスは以下のようになります。
C:\Users\Username\AppData\Local\Temp\
その中のサブフォルダにファイルが作成され、例えば全てのtemp画像ファイルはこの中に保存されます。
HdrlsBuckets_Lightmap Ltd
これらのファイルを別の場所に保存したい場合は、環境変数HDRLS_TEMPRENDER_DIRを設定します。
例えば以下の通りです。
HDRLS_TEMPRENDER_DIR = \DiskName\HDRLS_DATA\TEMP\
HDR Light Studioは、現在ASCII文字のみをファイルパスとしてサポートしています。そのため、OSアカウントのユーザー名に非ASCII文字が含まれている場合、この設定を使用した方が、HDR Light Studioが正常に動作する場合があります。例えば、3ds MaxでHDR Light Studioを使用する場合などです。(注意：ユーザー名にASCII文字が含まれていない場合は、この設定を使用しても、他の接続が正しく機能しない場合があります)。
HDRLS_LOG_FILE
HDR Light Studioの使用中に、診断情報をテキストファイルに書き出すことができます。環境変数HDRLS_LOG_FILEに、ディレクトリ内のテキストファイルを設定します。ディレクトリのパスは存在する必要がありますが、ログファイルはHDR Light Studioの起動時に作成されます。
例えばWindowsの場合は以下の通りです。
HDRLS_LOG_FILE = C:\Users\Username\Documents\lightmaplogs\hdrls.log
アプリを起動するたびに、古いログファイルの名前が変更され、新しいログファイルが作成されます。設定されている場合、この値はPreferencesダイアログで確認できます。
HDRLS_LOG_LEVEL
ログファイルに書き込まれる診断情報の詳細性は、環境変数HDRLS_LOG_LEVELで制御することができます。値の範囲は、0（最も簡潔）～ 5（最も詳細）です。
例えばWindowsの場合は以下の通りです。
HDRLS_LOG_LEVEL = 1
設定されている場合、このログレベルの値はPreferencesダイアログで確認できます。
HDRLS_PRESETS_DIR
大規模なスタジオでは、環境変数（ログインスクリプトなど）を設定して、ライトのプリセットを保存する中央サーバーをすべてのアーティストへ指定することをお勧めします。これらのファイルは現時点で8GB以上あり、各ユーザーのマシンにこれらのファイルをインストールする時間を節約することができます。この設定は、環境変数HDRLS_USER_DIRで設定されたパスを上書きします。
例えば以下の通りです。
HDRLS_PRESETS_DIR = \DiskName\HDRLS_Presets\
HDRLS_LICENSE_DIR
大規模なスタジオでは、ログインスクリプトで環境変数を設定し、ライセンスキーの保管場所をすべてのアーティストへ指定することをお勧めします。これは、フローティング ライセンスサーバーがある場合に便利です。すべてのユーザーは、同じライセンスサーバーを指す同じ client.lic ファイルを持つことになります。これにより、ライセンスサーバーが更新された場合、中央の場所にある1つのclient.licファイルを変更すると、すべてのHDR Light Studioシートで新しいフローティングライセンスサーバーを使用できるようになります。この設定は、環境変数HDRLS_USER_DIRで設定されたパスより優先されます。
例えば以下の通りです。
HDRLS_LICENSE_DIR = \DiskName\HDRLS_Licenses\
OCIO
OpenColorIO (OCIO) は、視覚効果やコンピューターアニメーションに重点を置いた、映画制作向けの完全なカラーマネジメントソリューションです。
Lightmap社は、HDR Light Studio内でのOCIOをサポートしています。HDR Light StudioにはOCIOの設定ファイルが同梱されており、Windowsでは以下の場所にあります。
C:\Program Files\Lightmap\HDR Light Studio\OCIOConfigs
OCIO環境変数を使用すると、OCIO configファイルを指定することができます。
ここでは、HDR Light Studioに同梱されているNukeのデフォルトを指定する例を示します。
OCIO = C:\Program Files\Lightmap\HDR Light Studio\OCIOConfigs\nuke-default\config.ocio
ご注意: OCIOパスを指定する際は、スラッシュは使用しているプラットフォームに合わせて正しく使用し、二重にしないでください。
例:
\\cgi-shotgun\library\OCIO_Configs\aces_1.2_marks\config_marks_01.ocio \\\\cgi-shotgun\\library\\OCIO_Configs\\aces_1.2_marks\\config_marks_01.ocio ではありません
設定されている場合、この値はPreferencesダイアログで確認することができます。詳細については、OpenColorIO (英語)を参照してください。
HDRLS_SCALE_GUI
HDRLS_SCALE_GUI環境変数を使用することで、ユーザーインターフェースのスケールを強制的に変更できます。この値は、希望するスケールの大きさを表します。1 = 100%、2 = 200%などです。
例えば、UIのスケールを2倍にする場合は以下の通りです。
HDRLS_SCALE_GUI = 2
HDRLS_TMPDIR_OVERRIDE
この環境変数は、システムのmutexesの場所をデフォルトのposix TMPDIRから、新しい環境変数で指定された場所に変更します。これにより、非標準的なカスタムセットアップを行うお客様が、HDR Light Studioを実際に実行できるようにこれを別の場所に設定することができます。ディレクトリのセットはすでに作成されている必要があります。 見つからない場合は作成されません。
プラグインConnectionのTCPIP API 通信ポート
いくつかのプラグインは、高速で優れた新しい TCPIPベースの API を使用します。 まれに、通信用のデフォルトのTCPIPのポート設定が他のソフトウェアと競合することがあります。 たとえば、Teradici PCoIPリモートプロトコルはポート 5555 を使用するため、HDR Light Studio がデフォルト設定で動作しません。
HDR Light Studio TCPIP 通信のポート設定を変更するために設定可能な環境変数は次のとおりです。
HDRLS_LOCAL_PORT 環境変数を使用しない場合のデフォルト設定は 5555 です。
HDRLS_REMOTE_PORT 環境変数を使用しない場合のデフォルト設定は 5556 です。
HDRLS_HEARTBEAT_SVR_PORT 環境変数を使用しない場合のデフォルト設定は 5557 です。
HDRLS_HEARTBEAT_CLI_PORT 環境変数を使用しない場合のデフォルト設定は 5558 です。