ReserveArrayNode

 

Introduced

7.0

UI Location

• Array

Description

Manually reserves memory internally to store an array that will eventually grow to the specified size. Reserve does not resize the array.

The main reason for using Reserve is efficiency. If you know the size the array will eventually grow to in advance, reserving the space in memory ahead can help improve performance when increasing the array size frequently.

Port Description

Inputs

Group ID

Instances

Port Name

Connection Info

Description

0

1

size

Type: siICENodeDataLong

Structure: siICENodeStructureSingle

Context: siICENodeContextAny

The number of array cells to reserve. This is typically the maximum size you know the array will grow to.

array

Type: siICENodeDataValue or siICENodeDataLocation

Structure: siICENodeStructureAny

Context: siICENodeContextAny

The array to reserve memory for.

Outputs

Port Name

Connection Info

Description

result

Type: siICENodeDataValue or siICENodeDataLocation

Structure: siICENodeStructureArray

Context: siICENodeContextAny

The input array but with reserved memory.

Restrictions

• These types must match: array, result

• These contexts must match: size, array, result

See Also

BuildArrayFromConstantNode

BuildArrayNode

GetArraySizeNode

ResizeArrayNode

Accessing Data from Array Nodes

 

 

 



Autodesk Softimage v7.5