v7.0
ファイルからパラメータの DataSource であるオブジェクトを作成し、パラメータに接続します。このメソッドは、シェーダプリセットのファイル名に基づいてShaderをパラメータに接続するために使用できます。また、接続されたソースを表す Parameter オブジェクトが戻された場合に、複数出力シェーダまたはシェーダコンパウンドをパラメータに接続する場合にも使用できます。
注: このメソッドでは output arguments が使用されます。C# および一部のスクリプト言語(JScript、PerlScript、Python など)は、リファレンスによって渡される引数をサポートしていません。通常、スクリプトの場合は ISIVTCollection を使用して出力引数を取得しますが、このメソッドはすでに値を戻してします（C#では ISIVTCollection にアクセスする手段がないため、この回避策は使用できません）。
この場合の唯一の回避策は、出力引数と戻り値の両方を 1 つの配列で戻す VBScript のカスタム コマンドを作成することです。詳細については、「What Happens when the Function Already Returns a Value?」を参照してください。
DataSource Parameter.ConnectFromFile2( String in_FileName, String in_SourceName, Object& out_pvPrevDataSource ); |
oReturn = Parameter.ConnectFromFile2( FileName, [SourceName], [PrevDataSource] ); |
使用される定義に基づくタイプの新しく作成されたオブジェクトです。たとえば、Shader（DataSourceを参照）。
| パラメータ | タイプ | 説明 |
|---|---|---|
| FileName | String | データソース定義を含むファイル（プリセットファイルなど。Shader Presets のリストを参照）の名前 |
| SourceName | String | 作成するシェーダ上のソース（または出力ポート）の名前。デフォルトの出力または単一出力シェーダに接続する場合は、空のままにします。. |
| PrevDataSource | DataSource | 以前に接続されていた DataSource（存在する場合）。以前に接続されていた DataSource がない場合は、Nothing が戻されます。 |