ChangeVertexColorDatatype

指定された VertexColor プロパティについて、 VertexColorChangeDatatype オペレータを追加します。頂点カラープロパティは、Short (8 ビットカラー)および Float (32 ビット)というカラーを表す 2 種類の内部データ表現をサポートするようになりました。 RenderMap は 32 ビットカラーを CAV にベークするように設定できますが、CAV もまた、処理後に 8 ビットまたは 32 ビットカラーに変更できます。これによって、たとえば、ユーザは SDK を使用して 32 ビットの精密なカラーを CAV に書き込んだり CAV から読み出したりすることができます。

Vertex Color Change Datatype オペレータを使用すると、通常は読み取り専用であり、SetValue、Parameter.Value、または Parameter.PutValue2 などを介して変更することのできない「datatype」パラメータを修正できます。以下の JScript のサンプルは、この原則を示しています。

DesiredDatatype 入力パラメータは必須です。現在の VertexColor プロパティで既に目的のデータ型を使用している場合は、警告メッセージが記録され、どのオペレータもインストールされません。

通常、このコマンドは、VertexColorChangeDatatype オペレータを適用するために 1 回だけ呼び出すことができます。その後、「datatype」設定を再度変更する必要がある場合は、このコマンドを使用して別のオペレータを適用するのではなく、現在のオペレータの「desireddatatype」パラメータにアクセスします。以下の JScript の例が示すように、同じ VertexColor プロパティに複数のオペレータを適用している場合は、必ず現在のオペレータの「desireddatatype」パラメータを修正するように注意してください。

1. JScript の例

/*
        This example demonstrates how to set the read-only DataType on a VertexColor (CAV) property, including 
        avoiding some of the pitfalls of applying more than one Vertex Color Change Datatype operator.
*/
NewScene( "", false );
var obj = Application.ActiveSceneRoot.AddGeometry( "Cube", "MeshSurface" );
var VtxColors = CreateVertexColorSupport( null, null, obj );
// Get the datatype parameter (on the VertexColor property)
var DataType = VtxColors(0).Parameters("datatype");
Application.LogMessage( "Default DataType: " + DataType.Value );
// The datatype parameter is readonly
try {
        // This will throw an error
        DataType.Value = 1;
} catch(e) {
        Application.LogMessage( "Error on DataType.Value = 1: " + e.description, siWarning );
        try {
                // SetValue will also fail
                SetValue( DataType, 1 );
        } catch(f) {
                Application.LogMessage( "Error on SetValue( DataType, 1 ): " + f.description, siWarning );
        }
}
// Use the VertexColorChangeDatatype operator instead
var DataChgOps1 = ChangeVertexColorDatatype( VtxColors, 1 );
var DesiredDType1 = DataChgOps1(0).Parameters("desireddatatype");
Application.LogMessage( "DataType after 1st operator: " + DataType.Value );
// Now that you have the VertexColorChangeDatatype operator, you can 
// use its DesiredDatatype parameter to toggle back and forth
DesiredDType1.Value = 0;
Application.LogMessage( "Back to default: " + DataType.Value );
DesiredDType1.Value = 1;
Application.LogMessage( "Switched to float again: " + DataType.Value );
// However, if you try to apply another operator, only the last one 
// applied will affect the actual data type
var DataChgOps2 = ChangeVertexColorDatatype( VtxColors, 0 );
var DesiredDType2 = DataChgOps2(0).Parameters("desireddatatype");
Application.LogMessage( "DataType after 2nd operator: " + DataType.Value );
DesiredDType1.Value = 1;
Application.LogMessage( "Changed old operator: " + DataType.Value );
DesiredDType2.Value = 1;
Application.LogMessage( "Changed new operator: " + DataType.Value );
// For the truly cautious, get the last operator applied
var CAVProp = obj.ActivePrimitive.Geometry.VertexColors(0);
var LastChgDataTypeOp;
for ( var i=CAVProp.NestedObjects.Count-1; i>=0; i++ ) {
        if ( CAVProp.NestedObjects.Item(i).Type == "vertexcolorchangedatatype" ) {
                LastChgDataTypeOp = CAVProp.NestedObjects.Item(i);
                break;
        }
}
Application.LogMessage( "LastChgDataTypeOp == DataChgOps1: " + LastChgDataTypeOp.IsEqualTo(DataChgOps1(0)) );
Application.LogMessage( "LastChgDataTypeOp == DataChgOps2: " + LastChgDataTypeOp.IsEqualTo(DataChgOps2(0)) );
var LastDesiredDType = LastChgDataTypeOp.Parameters("desireddatatype");
LastDesiredDType.Value = 0;
Application.LogMessage( "Changed final operator: " + DataType.Value );
// Output:
// INFO : Default DataType: 0
// WARNING : 2011 - Error on DataType.Value = 1: Member not found
// ERROR : 2011-EDIT-SetValue - Member not found
// WARNING : Error on SetValue( DataType, 1 ): Object doesn't support this property or method
// INFO : DataType after 1st operator: 1
// INFO : Back to default: 0
// INFO : Switched to float again: 1
// INFO : DataType after 2nd operator: 0
// INFO : Changed old operator: 0
// INFO : Changed new operator: 1
// INFO : LastChgDataTypeOp == DataChgOps1: false
// INFO : LastChgDataTypeOp == DataChgOps2: true
// INFO : Changed final operator: 0

2. VBScript の例

'
' This example creates a Vertex Color property (CAV) and plays with one of the colors 
' to demonstrate how switching the datatype can affect the color values
'
dim CAVObjs, dtype, chgOp, aColors
NewScene , false
SetDisplayMode "Camera", "constant"
CreatePrim "Sphere", "MeshSurface"
' The VertexColor property is the first element in the returned collection
set CAVObj = CreateVertexColorSupport()(0)
set dtype = CAVObj.Parameters("datatype")
' Print current datatype
Application.LogMessage "CAV datatype = " & dtype.Value
' Change datatype to float and print new datatype
set chgOp = ChangeVertexColorDatatype( CAVObj, 1 )(0)
Application.LogMessage "CAV new datatype = " & dtype.Value
' Set Color 47 (facing front view) to be RGBA ( 0.1 , 0.2 , 0.3, 0.4 )
aColors = CAVObj.Elements.Array
aColors(0,47) = 0.1
aColors(1,47) = 0.2
aColors(2,47) = 0.3
aColors(3,47) = 0.4
CAVObj.Elements.Array = aColors
' Retrieve the color and print it
aColors = CAVObj.Elements.Array
Application.LogMessage "Color 47 is (" & aColors(0,47) & ", " & aColors(1,47) & ", " & aColors(2,47) & ", " & aColors(3,47) & ")" 
' Now switch to short datatype and print it
chgOp.Parameters("desireddatatype").Value = 0           ' == SetValue chgOp & ".desireddatatype", 0
Application.LogMessage "CAV last datatype = " & dtype.Value
' Retrieve the color and print it
aColors = CAVObj.Elements.Array
Application.LogMessage "Color 47 is (" & aColors(0,47) & ", " & aColors(1,47) & ", " & aColors(2,47) & ", " & aColors(3,47) & ")" 
'Output
' INFO : CAV datatype = 0
' INFO : CAV new datatype = 1
' INFO : Color 47 is (0.100000001490116, 0.200000002980232, 0.300000011920929, 0.400000005960464)
' INFO : CAV last datatype = 0
' INFO : Color 47 is (9.80392172932625E-02, 0.200000002980232, 0.298039227724075, 0.400000005960464)