v4.0
UserDataBlobまたはCustomPropertyを作成し、Material オブジェクトに追加します。
Property Material.AddProperty( Object in_Preset, Boolean in_Branch, String in_name ); |
oReturn = Material.AddProperty( Preset, [BranchFlag], [Name] ); |
CustomProperty、UserDataBlob、UserDataMapまたは(使用されたプリセットによる)
パラメータ | タイプ | 説明 |
---|---|---|
Preset | String |
この引数には、Property Preset の名前またはファイル名やプリセット ファイルへの完全パスを含む文字列が格納されます。 注: マテリアルには、CustomProperty Presets、UserDataBlob Presets、および UserDataMap Presets だけが有効です。 作成されるプロパティのタイプはこの引数により決定されます。たとえば、"CustomProperty" は空の CustomProperty を作成し、"UserDataBlob" は UserDataBlob を作成します。 |
BranchFlag | Boolean |
False は、唯一のサポートされる値です。 デフォルト値: False |
Name | String | 新しいプロパティの名前を表します(SIObject.Name を参照)。名前を指定しない場合には、オブジェクトは Preset引数に基づいて名前が付けられます。 |
/* This example shows how to add a CustomProperty to a Material */ NewScene( null,false ) ; var oCone = ActiveSceneRoot.AddGeometry( "Cone", "MeshSurface" ); var oMaterial = oCone.AddMaterial( "Phong" ); // Annotation is a specific CustomProperty that is shipped with Softimage var oMaterialPSet = oMaterial.AddProperty( "Annotation", false, "MaterialAnnotation" ); oMaterialPSet.Parameters("text").Value = "Annotation under a Material" // You can access any CustomProperty under the Material using Material.Properties Application.LogMessage( "Contents of annotation: " + oCone.Material.Properties("MaterialAnnotation").Text.Value ) ; // Expected Results: // INFO : "Contents of annotation: Annotation under a Material" |