ExportShaderTree

導入

v9.0 (2011)

詳細

シェーダ ツリーを .xsishaders ファイルに書き出します。 シェーダ ツリーとは、コンパウンドで表現したシェーダ ノードのようなものです(Render Tree コンパウンドの .xsirtcompound ファイルに似ています)。 基本的にシェーダ ツリーは公開されたポートのないシェーダ コンパウンドです。 シェーダ ツリーの形式は、シェーダおよびマテリアルのプリセットに相当します。

このコマンドは、Render Tree のノード コンテキスト メニューから[選択したノードを書き出す]を選択する操作に相当します。

スクリプト構文

oString = ExportShaderTree( [Shaders], FullPath, DisplayName, Category, [ForceEmbedded] );

戻り値

新しい.xsirtshadersファイルの完全パスとファイル名を表すString

パラメータ

パラメータ タイプ 説明
Shaders 文字列 書き出すシェーダのリスト

デフォルト値: 現在選択されている値

FullPath 文字列 シェーダ ツリーを保存するディスク上の場所。
DisplayName 文字列 Preset Manager で表示する名前。 表示名が空の場合は、そのファイルは Preset Manager に表示されません。
Category 文字列 Preset Manager で使用するカテゴリ。 カテゴリが空の場合は、そのファイルは Preset Manager に表示されません。
ForceEmbedded Boolean True の場合、ネストされたシェーダ コンパウンドは通常どおり参照される代わりに、書き出された同じ .xsirtshaders ファイルに強制的に埋め込まれます。

注: ネストされたシェーダがまだ書き出されていない場合(つまり、ディスク上に.xsirtshaders ファイルがない場合)は、この設定に関わらず埋め込まれます。

デフォルト値: False

関連項目

ImportShaderTree ReplaceShadersDefinition CreateShaderFromPreset CreateShaderFromCLSID CreateShaderFromProgID CreateShaderCompound NestShaders UnnestShaders AddShaderCompoundPort RemoveShaderCompoundPort MoveShaderCompoundPort RenameShaderCompoundPort ExportShaderCompound ExportShaderCompound ImportShaderTree ExplodeShaderCompound SetShaderCompoundPropertiesEx GetShaderCompoundProperties EditShaderCompoundPPGLogic