Share

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:

Interface: DataViewItem

Was this information helpful?