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