このページの情報は上級ユーザー向けです。 間違ってパスをカスタマイズすると、Redshiftが正しく実行できなくなります。

• Paths
• Default Paths
  • Windows
  • Linux
  • macOS
• Customizing Paths Using Environment Variables
• Example: Centralized Deployment
  • Collecting necessary files
  • Configuring the Redshift core
  • Configuring host applications
    • Maya
    • 3ds Max
    • Softimage
    • Cinema 4D
    • Houdini
    • Katana
  • Updating a centralized installation
• Customizing Paths Using a Path Configuration XML
• Path Resolution Rules

このセクションでは、Redshiftバイナリとデータファイルの場所をカスタマイズするためのさまざまなオプションについて説明します。 これは、1台のマシンに複数のバージョンのRedshiftを並べてインストールすることを支援するために使用できます。

Path

Redshiftでは、次のパスが使用されます。

• Plugin Path – Redshift DCCプラグインを含むパス。
• Core Data Path – シェーダバイナリやその他のGPUカーネルを含むコアRedshiftデータファイルを含む最上位パス。 このパスは、一元配置シナリオで複数のマシン間で安全に共有できます。
• Local Data Path – ログディレクトリを含む最上位のパスと、ライセンスと環境設定ファイルのデフォルトの場所です。 このファイルは、複数のマシン間で共有することはできません。
• Procedurals Path –Redshift proceduralsの検索パス
• Preferences File Path – preferences xmlファイルへのフルパス。
• License Path – ライセンスファイルをスキャンするパス。

Default Path

Windows

+ MAYAVERSION:2017 redshift4maya any %REDSHIFT_COREDATAPATH%
scripts: Plugins/Maya/Common/scripts
icons: Plugins/Maya/Common/icons
plug-ins: Plugins/Maya/2017/nt-x86-64
MAYA_CUSTOM_TEMPLATE_PATH +:= Plugins/Maya/Common/scripts/NETemplates
REDSHIFT_MAYAEXTENSIONSPATH +:= Plugins/Maya/2017/nt-x86-64/extensions
REDSHIFT_PROCEDURALSPATH +:= Procedurals
PATH +:= bin

+ MAYAVERSION:2017 redshift4maya any $REDSHIFT_COREDATAPATH
scripts: Plugins/Maya/Common/scripts
icons: Plugins/Maya/Common/icons
plug-ins: Plugins/Maya/2017/nt-x86-64
MAYA_CUSTOM_TEMPLATE_PATH +:= Plugins/Maya/Common/scripts/NETemplates
REDSHIFT_MAYAEXTENSIONSPATH +:= Plugins/Maya/2017/nt-x86-64/extensions
REDSHIFT_PROCEDURALSPATH +:= Procedurals
PATH +:= bin

3ds Max

集中型Redshiftインストールで3ds Maxを使用するには、ネットワーク共有から各マシンの3ds Maxインストールフォルダにファイルをコピーする必要があります。 次の例は、コマンドラインからこれを実行する方法の例です（3ds Max 2018では、他のバージョンで必要に応じて変更します）。 これらのコマンドは各レンダリングマシンで実行する必要があり、管理者権限が必要な場合があります（3ds Maxインストールフォルダに書き込むため）。

copy /Y %REDSHIFT_COREDATAPATH%\Plugins\3dsMax\2018\redshift4max.dlr C:\Program Files\Autodesk\3ds Max 2018\plugins\
copy /Y %REDSHIFT_COREDATAPATH%\Plugins\3dsMax\scripts\* to C:\Program Files\Autodesk\3ds Max 2018\scripts\
copy /Y %REDSHIFT_COREDATAPATH%\bin\redshift-core-vc100.dll C:\Program Files\Autodesk\3ds Max 2018\
copy /Y %REDSHIFT_COREDATAPATH%\bin\OpenImageIO-1.6.17-vc100.dll C:\Program Files\Autodesk\3ds Max 2018\

 Softimage

各マシンのワークグループを共有ネットワークの場所に設定します（または既存の共有ワークグループを使用する）。 次に、適切なRedshift .xsiaddonを共有ワークグループにインストールします（この手順は、1台のマシンで行う必要があります）。

Redshift .xsiaddonを共有ワークグループに手動でインストールする代わりに、xsiaddonExtractorツールを使用してxsiaddonの内容を任意のフォルダに抽出することもできます。

構文は次のとおりです。

xsiaddonExtractor.exe [-output ]

 -output引数はオプションです。 省略すると、アドオンがカレントディレクトリに展開されます。

例

これにより、redshift4softimage2014.xsiaddonの内容がToolsディレクトリ（xsiaddonExtractor.exeが存在する場所）に抽出されます。

xsiaddonExtractor.exe ..\Plugins\Softimage\redshift4softimage2014.xsiaddon

 これにより、redshift4softimage2014.xsiaddonの内容がネットワークフォルダ\\ server \ share \ RedshiftWorkgroupに抽出されます。

xsiaddonExtractor.exe -output \\server\share\RedshiftWorkgroup ..\Plugins\Softimage\redshift4softimage2014.xsiaddon

Cinema 4D

Cinema 4Dは、C4D_PLUGINS_DIR環境変数で指定された追加の場所からプラグインを読み込むことをサポートしています。 これは、Cinema 4Dの適切なバージョンのReshiftプラグインをコピーできるネットワーク上の場所に転送することができます。

たとえば、C4D_PLUGINS_DIR環境変数を\\ server \ share \ C4D_PLUGINS_R19に設定してから、R19 Redshiftプラグインフォルダをこの場所にコピーすることができます。

誤ったインストールでの問題を防ぐため、Redshiftコアのバージョンが期待バージョンと一致しない場合、プラグインはロードされません。 さらに、1つ以上のCinema 4Dプラグインの場所で複数のインスタンスが検出された場合でも、ロードを拒否します。 これらのいずれかの条件が発生すると、次のメッセージがCinema 4D Consoleウィンドウに表示され、ログに記録されます。

Redshift: Plugin initialization failed. Please ensure that Redshift has been installed correctly and it matches this version of the plugin.

その場合は、Cinema 4DのプラグインパスにRedshiftプラグインが1つしかないこと、Redshiftコアの正しいバージョンがRedshift固有の環境変数（REDSHIFT_COREDATAPATHなど）を介してプラグインによってまたはパス設定XMLファイルを介して見つけられることを確認してください。

Houdini

ネットワーク共有上でredshift4houdiniプラグインを見つけるようにHoudiniを設定するには、各レンダリングマシンの環境変数HOUDINI_PATHにredshift4houdiniプラグインへのパスを追加する必要があります。 これは、システム環境変数を設定するか、houdini.envファイルを変更することで実現できます。 Windowsでは、redshift4houdiniが依存関係を見つけるために、RedshiftコアdllへのパスをシステムPATH環境変数に追加する必要もあります。 また、変数HOUDINI_DSO_ERRORを定義し、その値を2に設定することをお勧めします。例は、Houdini 16.0.705の場合の例です。 実行しているHoudiniのバージョンに応じて、必要に応じて変更してください。

houdini.envファイルで変数を定義するときは、プラットフォームに関係なく、環境変数とパス区切り記号にLinuxスタイルの構文を使用する必要があります。

Windows上のhoudini.envファイルの例

HOUDINI_DSO_ERROR = 2
HOUDINI_PATH = "$REDSHIFT_COREDATAPATH/Plugins/Houdini/16.0.705;&"
PATH = "$REDSHIFT_COREDATAPATH/bin;$PATH"

LinuxおよびmacOS上のhoudini.envファイルの例

HOUDINI_DSO_ERROR = 2
HOUDINI_PATH = "$REDSHIFT_COREDATAPATH/redshift4houdini/16.0.705;&"

末尾のセミコロン ';'とアンパサンド '＆'文字に注意してください。 。 これは、Houdiniが独自のネイティブプラグインを見つけられるようにするために重要です。 

Katana

ネットワーク共有上にredshift4katanaプラグインを見つけるようにKatanaを設定するには、redshift4katanプラグインへのパスを各レンダリングマシンのKATANA_RESOURCES環境変数に追加する必要があります。 これは、システム環境変数を設定するか、Katanaランチャーを変更することで実現できます。

Windowsでは、redshift4katanaが依存関係を見つけるために、RedshiftコアdllへのパスをシステムPATH環境変数に追加する必要もあります。 同様に、Linuxでは、Redshiftコアライブラリを指すようにLD_LIBRARY_PATHを変更する必要があります。

変数DEFAULT_RENDERERを定義し、その値をRedshiftに設定することもお勧めします。 Katana 2.6v1の例を以下に示します。 実行中のKatanaのバージョンに応じて必要に応じて変更してください。

Windows上のKatanaランチャースクリプトに追加する変数の例

set "PATH=%REDSHIFT_COREDATAPATH%/bin;%PATH%"
set "KATANA_RESOURCES=%REDSHIFT_COREDATAPATH%/Plugins/Katana/2.6v1;"
set "DEFAULT_RENDERER=Redshift"

 Linux上のKatanaランチャースクリプトに追加する変数の例

#render plugins
export LD_LIBRARY_PATH="${REDSHIFT_COREDATAPATH}/bin:${LD_LIBRARY_PATH}"
export KATANA_RESOURCES=${REDSHIFT_COREDATAPATH}/redshift4katana/katana2.5v4
export DEFAULT_RENDERER=Redshift

 一元インストールの更新

一元Redshiftインストールを新しいバージョンに更新するには、ネットワーク共有の内容を新しいファイルに置き換えるだけです。 Softimageの場合、共有ワークグループの既存のRedshiftアドオンファイルを、1台のマシン上の共有ワークグループに適切な.xsiaddonをインストールするか、Redshiftに含まれているxsiaddonExtractor.exeツールを使用して置き換える必要があります。

Path ConfigurationXMLを使用したパスのカスタマイズ

環境変数を使用する代わりに、ホストアプリケーションによってロードされるRedshiftプラグインと同じフォルダにpathconfig.xmlという名前のファイルを配置することによって、さまざまなRedshiftパスをカスタマイズすることもできます。 この方法は、パス設定を特定のプラグインの場所に結びつけるために便利です。プラグインの場所を設定するだけで、特定のバージョンのホストアプリケーションでRedshiftのバージョンを切り替えることができます。

pathconfig.xmlの形式は非常に簡単です。 次の形式の行が1行以上含まれている必要があります。

<path name="PATH_VARIABLE" value="//server/share/path" />

 たとえば、REDSHIFT_COREDATAPATHを// server / share / rs-core-data-pathに設定するには、次の行を追加します。

<path name="REDSHIFT_COREDATAPATH" value="//server/share/rs-core-data-path" />

xmlファイルにすべての変数を設定する必要はありません。 たとえば、REDSHIFT_COREDATAPATHを設定して他のものを省略することができます。これにより、コアデータパスを除くすべてのパスについてデフォルトの動作が行われます。

注意

パスの値は、環境変数の拡張をサポートしています。
例
server / shareという値を持つSERVER_SHAREという名前の環境変数がすでに存在する場合は、％SERVER_SHARE％（windows）または$ SERVER_SHARE（Linux / macOS）としてxmlに値を設定できます。

パス解決規則

さまざまなパスは、最初にpathconfig.xmlエントリを確認した後、環境変数をチェックし、次にデフォルト値を使用して解決されます。