FunctionReferenceTarget - superclass: ReferenceTarget; super-superclass:MAXWrapper - 44:0 - classID: #(1137313545, 554188032)

Description:

The FunctionReferenceTarget Particle Data View sub-operator performs arithmetic or vector operations on particle data.

Available in 3ds Max 2014 and higher.

Constructor:

FunctionReferenceTarget...

Properties:

First Operand group of controls

<FunctionReferenceTarget>.First_Operand_Type     Integer    default: 4   --  integer

Get/set the selection of the First Operand's "Type" drop-down list.

Possible values are:

0 - Boolean

1 - Integer

2 - Real

3 - Time

4 - Vector (default)

5 - Quaternion

6 - Matrix

<FunctionReferenceTarget>.Factor_For_First_Operand     Float    default: 1.0   --  animatable; float

Get/set the value of the floating point "Pre-Factor" spinner (R3) used to multiply the First Operand when it is of type Quaternion, Real, Time or Vector.

<FunctionReferenceTarget>.Integer_Factor_For_First_Operand     Integer    default: 1   --  animatable; integer

Get/set the value of the integer "Pre-Factor" spinner (I3) used to multiply the First Operand when it is of type Integer.

<FunctionReferenceTarget>.Offset_For_First_Operand     Float    default: 0.0   --  animatable; float

Get/set the First Operand's offset value when it is of type Real or Time. Not exposed to the UI.

<FunctionReferenceTarget>.Integer_Offset_For_First_Operand     Integer    default: 0   --  animatable; integer

Get/set the First Operand's offset value when it is of type Integer. Not exposed to the UI.

<FunctionReferenceTarget>.Use_R_As_Factor_For_First_Operand     BooleanClass    default: false   --  boolean

Get/set the state of the "R3" checkbutton.

When set to True, the Pre-Factor will be taken from the sub-operator's output connected to the .Input_3 property.

When set to False (default), the .Factor_For_First_Operand or .Integer_Factor_For_First_Operand value will be used.

<FunctionReferenceTarget>.Use_Second_Operand     BooleanClass    default: true   --  boolean

Get/set the state of the "Use Second Operand" checkbox.

Second Operand group of controls

<FunctionReferenceTarget>.Factor_For_Second_Operand     Float    default: 1.0   --  animatable; float

Get/set the value of the floating point "Pre-Factor" spinner (R4) used to multiply the Second Operand when it is of type Quaternion, Real, Time or Vector.

<FunctionReferenceTarget>.Integer_Factor_For_Second_Operand     Integer    default: 1   --  animatable; integer

Get/set the value of the integer "Pre-Factor" spinner (I4) used to multiply the Second Operand when it is of type Integer.

<FunctionReferenceTarget>.Second_Operand_Type_For_Integer_Real     Integer    default: 2   --  integer

Get/set the selection of the "Type" drop-down list used when the First Operand's type is Integer or Real.

Possible values are:

1 - Integer

2 - Real (default)

<FunctionReferenceTarget>.Second_Operand_Type_For_Quaternion     Integer    default: 5   --  integer

Get/set the selection of the "Type" drop-down list used when the First Operand's type is Quaternion.

Possible values are:

1 - Integer

2 - Real

3 - Time

5 - Quaternion (default)

<FunctionReferenceTarget>.Second_Operand_Type_For_Vector     Integer    default: 4   --  integer

Get/set the selection of the "Type" drop-down list used when the First Operand's type is Integer or Vector.

Possible values are:

1 - Integer

2 - Real

3 - Time

4 - Vector (default)

5 - Quaternion

6 - Matrix

<FunctionReferenceTarget>.Use_R_As_Factor_For_Second_Operand     BooleanClass    default: false   --  boolean

Get/set the state of the "R4" checkbutton.

When set to True, the Pre-Factor will be taken from the sub-operator's output connected to the .Input_4 property.

When set to False (default), the .Factor_For_Second_Operand or .Integer_Factor_For_Second_Operand value will be used.

Function drop-down list

<FunctionReferenceTarget>.Function_Type_For_Boolean_And_Boolean     Integer    default: 3   --  integer

Get/set the selection of the "Function" drop-down list when the First and Second Operands are both of Boolean type.

Possible values are:

3 - AND (default)

41 - OR

57 - XOR / Exclusive OR

<FunctionReferenceTarget>.Function_Type_For_Boolean_Single     Integer    default: 40   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Boolean type and the Second Operand is turned off.

Possible values are:

4 - AND / All Particles

23 - False Count / All Particles

40 - NOT (default)

42 - OR / All Particles

54 - True Count / All Particles

<FunctionReferenceTarget>.Function_Type_For_Integer_And_Real     Integer    default: 2   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Integer type and the Second Operand is of Real type.

Possible values are:

2 - Addition X+Y (default)

6 - Average (X+Y)/2

20 - Division X/Y

21 - Division Remainder X%Y

24 - Geometric Mean (X*Y)**1/2

27 - Interpolation t*X+(1-t)*Y

30 - Logarithm log(X)base(Y)

31 - Maximum

33 - Minimum

35 - Multiplication X*Y

43 - Power XY**

52 - Subtraction X-Y

<FunctionReferenceTarget>.Function_Type_For_Integer_Real_Single     Integer    default: 50   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Integer or Real type and the Second Operand is turned off.

Possible values are:

0 - Absolute

7 - Average / All Particles

8 - Binary Exponent 2**X

9 - Binary Logarithm log2(X)

12 - Cosine cos(X)

13 - Cotangent ctg(X)

14 - Cube X**3

15 - Cubic Root X**1/3

16 - Decimal Exponent 10**X

17 - Decimal Logarithm log10(X)

25 - Geometric Mean / All Particles

26 - Identity

28 - Inverse 1/X

32 - Maximum / All Particles

34 - Minimum / All Particles

36 - Natural Exponent e**X

37 - Natural Logarithm ln(X)

45 - Reverse ID Indexing

49 - Sine sin(X)

50 - Square X*X (default)

51 - Square Root X**1/2

53 - Tangent tg(X)

58 - Sign

59 - Arcsin asin(X)

60 - Arccos acos(X)

61 - Sum / All Particles

62 - Arctangent atan(X)

<FunctionReferenceTarget>.Function_Type_For_Matrix_And_Matrix     Integer    default: 11   --  integer

Get/set the selection of the "Function" drop-down list when the First and Second Operands are both of Matrix type.

Possible values are:

11 - Composition X*Y (default)

27 - Interpolation t*X+(1-t)*Y

<FunctionReferenceTarget>.Function_Type_For_Matrix_Single     Integer    default: 44   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Matrix type and the Second Operand is turned off.

The only possible value is:

44 - Inverse (default)

<FunctionReferenceTarget>.Function_Type_For_Quaternion_And_Integer_Time     Integer    default: 35   --  integer; Function_Type_For_Quaternion_And_Integer_Real

Get/set the selection of the "Function" drop-down list when the First Operand is of Quaternion type and the Second Operand is of Time or Integer type.

Possible values are:

20 - Division X/Y

35 - Multiplication X*Y (default)

<FunctionReferenceTarget>.Function_Type_For_Quaternion_And_Quaternion     Integer    default: 2   --  integer

Get/set the selection of the "Function" drop-down list when the First and Second Operands are both of Quaternion type.

Possible values are:

2 - Addition X+Y (default)

27 - Interpolation t*X+(1-t)*Y

52 - Subtraction X-Y

<FunctionReferenceTarget>.Function_Type_For_Quaternion_And_Real     Integer    default: 35   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Quaternion type and the Second Operand is of Real type.

Possible values are:

20 - Division X/Y

35 - Multiplication X*Y (default)

<FunctionReferenceTarget>.Function_Type_For_Quaternion_Single     Integer    default: 44   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Quaternion type and the Second Operand is turned off.

The only possible value is:

44 - Reverse (default)

<FunctionReferenceTarget>.Function_Type_For_Time_And_Time     Integer    default: 2   --  integer

Get/set the selection of the "Function" drop-down list when the First and Second Operands are both of Time type.

Possible values are:

2 - Addition X+Y (default)

27 - Interpolation t*X+(1-t)*Y

52 - Subtraction X-Y

<FunctionReferenceTarget>.Function_Type_For_Time_Single     Integer    default: 7   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Time type and the Second Operand is turned off.

The only possible value is:

7 - Average / All Particles (default)

26 - Identity

32 - Maximum / All Particles

34 - Minimum / All Particles

<FunctionReferenceTarget>.Function_Type_For_Vector_And_Integer_Time     Integer    default: 35   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Vector type and the Second Operand is of Time type.

Possible values are:

20 - Division X/Y

35 - Multiplication X*Y (default)

<FunctionReferenceTarget>.Function_Type_For_Vector_And_Matrix     Integer    default: 10   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Vector type and the Second Operand is of Matrix type.

Possible values are:

10 - Complete Transform (default)

56 - Vector Transform

63 - Overwrite M2.X

64 - Overwrite M2.Y

65 - Overwrite M2.Z

66 - Overwrite M2.T

67 - Align M2.X to V1

68 - Align M2.Y to V1

69 - Align M2.Z to V1

<FunctionReferenceTarget>.Function_Type_For_Vector_And_Quaternion     Integer    default: 46   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Vector type and the Second Operand is of Quaternion type.

The only possible value is:

46 - Rotate By (default)

<FunctionReferenceTarget>.Function_Type_For_Vector_And_Real     Integer    default: 35   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Vector type and the Second Operand is of Real type.

Possible values are:

20 - Division X/Y

35 - Multiplication X*Y (default)

<FunctionReferenceTarget>.Function_Type_For_Vector_And_Vector     Integer    default: 2   --  integer

Get/set the selection of the "Function" drop-down list when the First and Second Operands are both of Vector type.

Possible values are:

2 - Addition X+Y (default)

5 - Angle Between Vectors

6 - Average (X+Y)/2

18 - Deflection X:Speed Y:Normal

19 - Distance length(X-Y)

27 - Interpolation t*X+(1-t)*Y

38 - Orthogonalization

47 - Scalar Product

48 - Scale Product

52 - Subtraction X-Y

55 - Vector Product

<FunctionReferenceTarget>.Function_Type_For_Vector_Single     Integer    default: 29   --  integer

Get/set the selection of the "Function" drop-down list when the First Operand is of Vector type and the Second Operand is turned off.

The only possible value is:

7 - Average / All Particles (default)

26 - Identity

39 - Normalize

58 - Sign

Result group of control

<FunctionReferenceTarget>.Post_Factor     Float    default: 1.0   --  animatable; float

Get/set the value of the floating point "Post-Factor" spinner used to multiply the Result when it is of type Quaternion, Real, Time or Vector.

<FunctionReferenceTarget>.Integer_Post_Factor     Integer    default: 1   --  animatable; integer

Get/set the value of the floating point "Post-Factor" spinner used to multiply the Result when it is of type Integer.

Parameters Animation Sync group of controls

<FunctionReferenceTarget>.Sync_Type     Integer    default: 0   --  animatable; integer

Get/set the selection of the "Parameters Animation Sync" drop-down list.

Possible values are:

0 - Absolute Time (default)

1 - Particle Age

2 - Particle Lifespan

3 - Event Duration

4 - Time Data Input

<FunctionReferenceTarget>.Use_E5     BooleanClass    default: false   --  boolean

Get/set the state of the "E5" checkbutton.

Restrict By Group ID controls

<FunctionReferenceTarget>.Restrict_By_Group_ID     BooleanClass    default: false   --  boolean

Get/set the state of the "Restrict By Group ID" checkbox.

<FunctionReferenceTarget>.Group_ID_Data_Channel     UndefinedClass    default: undefined   --  maxObject

Get/set the Group ID Data Channel object.

<FunctionReferenceTarget>.Group_ID_Data_Handle     Integer    default: 0   --  integer

Get/set the Group ID Data Handle.

<FunctionReferenceTarget>.Input_1     UndefinedClass    default: undefined   --  maxObject

Get/set the sub-operator connected to the first Input socket, representing the First Operand.

<FunctionReferenceTarget>.Input_2     UndefinedClass    default: undefined   --  maxObject

Get/set the sub-operator connected to the second Input socket, representing the Second Operand.

<FunctionReferenceTarget>.Input_3     UndefinedClass    default: undefined   --  maxObject

Get/set the sub-operator connected to the third Input socket, representing the Pre-Factor used when .Use_R_As_Factor_For_First_Operand is set to True.

<FunctionReferenceTarget>.Input_4     UndefinedClass    default: undefined   --  maxObject

Get/set the sub-operator connected to the fourth Input socket, representing the Post-Factor used when .Use_R_As_Factor_For_Second_Operand is set to True.

<FunctionReferenceTarget>.Input_5     UndefinedClass    default: undefined   --  maxObject

Get/set the sub-operator connected to the fifth Input socket, representing the Sync Time.

<FunctionReferenceTarget>.Filter     UndefinedClass    default: undefined   --  maxObject

Get/set the sub-operator connected to the Filter Input of the Function sub-operator.

FunctionReferenceTarget interfaces:

The following common interface is exposed by the FunctionReferenceTarget Particle Data View sub-operator:

Interface: DataViewItem