Convert : ReferenceTarget
Convert - superclass: ReferenceTarget; super-superclass:MAXWrapper - 20:0 - classID: #(1137313544, 554188032)
Description:
The Convert Particle Data View sub-operator transforms data type from one format to another.
Available in 3ds Max 2014 and higher.
Constructor:
Convert...
Properties:
<Convert>.Type Integer default: 10 -- integer
Possible values are:
0 - Boolean --> Integer
1 - Boolean --> Real
2 - Integer --> Real
3 - Integer --> Time
4 - Real --> Integer
5 - Real --> Time
6 - Real --> Vector
7 - Real --> Quaternion
8 - Time --> Integer
9 - Time --> Real
10 - Vector --> Real (default)
11 - Vector --> Quaternion
12 - Vector --> Matrix
13 - Vector --> Pair
14 - Vector --> Complex
15 - Quaternion --> Real
16 - Quaternion --> Vector
17 - Quaternion --> Matrix
18 - Matrix --> Vector
19 - Matrix --> Quaternion
20 - Pair --> Integer
21 - Pair --> Vector
22 - Pair --> Complex
23 - Complex --> Vector
24 - Complex --> Integer
25 - Complex --> Time
26 - Complex --> Pair
27 - Integer --> Compound Index
28 - Compound Index --> Integer
<Convert>.Boolean_Conversion Integer default: 0 -- radiobtnIndex
Used when .Type
is set to 0 - Boolean --> Integer or 1 - Boolean --> Real.
Possible values are:
0 - False As 0 / 0.0 (default)
1 - False As -1 / -1.0
<Convert>.Integer_Time_Conversion Integer default: 1 -- radiobtnIndex
Used when .Type
is set to 3 - Boolean --> Integer.
Possible values are:
0 - Tick As 1 (default)
1 - Frame As 1
<Convert>.Real_Integer_Conversion Integer default: 0 -- radiobtnIndex
Used when .Type
is set to 4 - Real --> Integer.
Possible values are:
0 - Round to Even (default)
1 - Round Up
2 - Round Down
<Convert>.Negative_Up_Toward_Zero BooleanClass default: true -- boolean
Used when .Type
is set to 4 - Real --> Integer.
<Convert>.Real_Time_Conversion Integer default: 1 -- radiobtnIndex
Used when .Type
is set to 5 - Real --> Time or 9 - Time --> Real
Possible values are:
0 - Tick As 1.0
1 - Frame As 1.0 (default)
2 - Second As 1.0
<Convert>.Real_Vector_Conversion Integer default: 0 -- radiobtnIndex
Used when .Type
is set to 6 - Real --> Vector
Possible values are:
0 - Cartesian Coordinates (default)
1 - Cylindrical Polar Coordinates
2 - Spherical Polar Coordinates
<Convert>.Vector_Real_Conversion Integer default: 0 -- radiobtnIndex
Used when .Type
is set to 10 - Vector --> Real.
Possible values are:
0 - Length (default)
1 - Average
2 - Minimum
3 - Min Absolute
4 - Maximum
5 - X
6 - Y
7 - Z
8 - Max Absolute
9 - Axial Radius
10 - Bearing
11 - Latitude
<Convert>.Vector_Quaternion_Conversion Integer default: 0 -- radiobtnIndex
Used when .Type
is set to 11 - Vector --> Quaternion.
Possible values are:
0 - Euler Rotation / Angles (default)
1 - [ Roll, Pitch, Yaw ]
<Convert>.Vector_Pair_Conversion Integer default: 0 -- radiobtnIndex
Used when .Type
is set to 13 - Vector --> Pair, 14 - Vector --> Complex.
Possible values are:
0 - I2 As Face/Vertex Index (default)
1 - I3 As Compound Index
<Convert>.Use_I3_As_Object_Index BooleanClass default: true -- boolean
Get/set the state of the "I3 As Object Index" checkbox.
Used when .Type
is set to 13 - Vector --> Pair
<Convert>.Quaternion_Real_Conversion Integer default: 0 -- radiobtnIndex
Used when .Type
is set to 15 - Quaternion --> Real
Possible values are:
0 - Rotation Angle (default)
1 - Roll
2- Pitch
3 - Yaw
<Convert>.Quaternion_Vector_Conversion Integer default: 2 -- radiobtnIndex
Used when .Type
is set to 16 - Quaternion --> Vector
Possible values are:
0 - Rotation Axis (default)
1 - Euler Rotation / Angles
2 - [ Roll, Pitch, Yaw ]
<Convert>.Matrix_Vector_Conversion Integer default: 3 -- radiobtnIndex
Used when .Type
is set to 18 - Matrix --> Vector
Possible values are:
0 - Euler Rotation / Angles
1 - [ Roll, Pitch, Yaw ]
2 - Rotation Axis
3 - Translation (default)
4 - Scale Factors
5 - X Axis
6 - Y Axis
7 - Z Axis
<Convert>.Pair_Integer_Conversion Integer default: 0 -- radiobtnIndex
Used when .Type
is set to 24 - Complex --> Integer or 28 - Compound Index --> Integer
Possible values when .Type
is 24 - Complex --> Integer are:
0 - Face/Vertex Index
1 - Object Index As Output
2 - Compound Index As Output
Possible values when .Type
is 28 - Compound Index --> Integer are:
0 - Face/Vertex Index
1 - Object Index As Output
Input and Filter Sockets
<Convert>.Input_1 UndefinedClass default: undefined -- maxObject
<Convert>.Input_2 UndefinedClass default: undefined -- maxObject
<Convert>.Input_3 UndefinedClass default: undefined -- maxObject
<Convert>.Input_4 UndefinedClass default: undefined -- maxObject
Get/set the sub-operators connected to the four Input sockets of the Convert sub-operator.
Setting an Input to a sub-operator of the expected type will effectively wire that sub-operator to the corresponding Input of the Convert sub-operator.
The Input types depend on the .Type
property as listed below:
.Type | .Input_1 | .Input_2 | .Input_3 | .Input_4 |
---|---|---|---|---|
0 - Boolean --> Integer | Boolean | -- | -- | -- |
1 - Boolean --> Real | Boolean | -- | -- | -- |
2 - Integer --> Real | Integer | -- | -- | -- |
3 - Integer --> Time | Integer | -- | -- | -- |
4 - Real --> Integer | Real | -- | -- | -- |
5 - Real --> Time | Real | -- | -- | -- |
6 - Real --> Vector | Real | Real | Real | -- |
7 - Real --> Quaternion | Real | Vector | -- | -- |
8 - Time --> Integer | Time | -- | -- | -- |
9 - Time --> Real | Time | -- | -- | -- |
10 - Vector --> Real (default) | Vector | -- | -- | -- |
11 - Vector --> Quaternion | Vector | -- | -- | -- |
12 - Vector --> Matrix | Vector | Vector | Vector | Vector |
13 - Vector --> Pair | Vector | Integer | (Integer) | -- |
14 - Vector --> Complex | Vector | Integer | Integer | Time |
15 - Quaternion --> Real | Quaternion | -- | -- | -- |
16 - Quaternion --> Vector | Quaternion | -- | -- | -- |
17 - Quaternion --> Matrix | Quaternion | Vector | Vector | -- |
18 - Matrix --> Vector | Matrix | -- | -- | -- |
19 - Matrix --> Quaternion | Matrix | -- | -- | -- |
20 - Pair --> Integer | Pair | -- | -- | -- |
21 - Pair --> Vector | Pair | -- | -- | -- |
22 - Pair --> Complex | Pair | Time | -- | -- |
23 - Complex --> Vector | Complex | -- | -- | -- |
24 - Complex --> Integer | Complex | -- | -- | -- |
25 - Complex --> Time | Complex | -- | -- | -- |
26 - Complex --> Pair | Complex | -- | -- | -- |
27 - Integer --> Compound Index | Integer (Object Index) | Integer (Face/Vertex Index) | -- | -- |
28 - Compound Index --> Integer | Integer | -- | -- | -- |
<Convert>.Filter UndefinedClass default: undefined -- maxObject
Get/set the sub-operator connected to the Filter Input of the Convert sub-operator.
Convert interfaces:
The following common interface is exposed by the Convert Particle Data View sub-operator: