v2.0
プリセット名から DataSource オブジェクトを作成し、そのオブジェクトをパラメータに接続します。このメソッドは、Shader が戻された場合にシェーダプリセットのシェーダをパラメータに接続します。
注: このメソッドでは output arguments が使用されます。C# および一部のスクリプト言語(JScript、PerlScript、Python など)は、リファレンスによって渡される引数をサポートしていません。通常、スクリプトの場合は ISIVTCollection を使用して出力引数を取得しますが、このメソッドはすでに値を戻してします（C#では ISIVTCollection にアクセスする手段がないため、この回避策は使用できません）。
この場合の唯一の回避策は、出力引数と戻り値の両方を 1 つの配列で戻す VBScript のカスタム コマンドを作成することです。詳細については、「What Happens when the Function Already Returns a Value?」を参照してください。
DataSource Parameter.ConnectFromPreset( String in_PresetName, String in_PresetFamily, Object& out_pvPrevDataSource ); |
oReturn = Parameter.ConnectFromPreset( Name, Family, [PrevDataSource] ); |
使用されるプリセットに基づくタイプの新しく作成されたオブジェクトです。たとえば、Shader（DataSource を参照）。
| パラメータ | タイプ | 説明 |
|---|---|---|
| Name | String | プリセットの名前（Shader Presetsのリストを参照） |
| Family | siFamily | プリセットのファミリ名 |
| PrevDataSource | DataSourceオブジェクト | もしあれば、以前に接続されていた DataSource。DataSource が以前に接続されていなかった場合は、Nothing が戻されます。 |
'
' This illustrates how to connect a shader from a shader preset.
'
NewScene , false
set grid = Application.ActiveSceneRoot.AddGeometry( "Cube","MeshSurface" )
set mat = grid.AddMaterial
set surface = mat.Parameters("Surface")
set phong = surface.ConnectFromPreset( "Phong","Material Shaders" )
set shadow = mat.Parameters("Shadow")
call shadow.Connect( phong )
set photon = mat.Parameters("Photon")
call photon.Connect( phong ) |