Get Array Index#

Returns a copy of an input array’s element at the given index, where the index can take any value in the domain [-arrayLength, arrayLength). Indices that are positive indicate positions counted from the beginning of the array, while negative indices count from the back of the array.

Installation#

To use this node enable omni.graph.nodes_core in the Extension Manager.

Inputs#

Name

Type

Descripton

Default

Array (inputs:array)

['bool[]', 'colord[3][]', 'colord[4][]', 'colorf[3][]', 'colorf[4][]', 'colorh[3][]', 'colorh[4][]', 'double[2][]', 'double[3][]', 'double[4][]', 'double[]', 'float[2][]', 'float[3][]', 'float[4][]', 'float[]', 'frame[4][]', 'half[2][]', 'half[3][]', 'half[4][]', 'half[]', 'int64[]', 'int[2][]', 'int[3][]', 'int[4][]', 'int[]', 'matrixd[2][]', 'matrixd[3][]', 'matrixd[4][]', 'normald[3][]', 'normalf[3][]', 'normalh[3][]', 'pointd[3][]', 'pointf[3][]', 'pointh[3][]', 'quatd[4][]', 'quatf[4][]', 'quath[4][]', 'string', 'texcoordd[2][]', 'texcoordd[3][]', 'texcoordf[2][]', 'texcoordf[3][]', 'texcoordh[2][]', 'texcoordh[3][]', 'timecode[]', 'token[]', 'transform[4][]', 'uchar[]', 'uint64[]', 'uint[]', 'vectord[3][]', 'vectorf[3][]', 'vectorh[3][]']

The array that will be searched by index to find the corresponding element’s value.

None

Index (inputs:index)

int

The index into the array. Indices in the domain [0, arrayLength) correspond to the usual element locations in the array, e.g. an “Index” of 2 equates to the third element in the array. Indices in the domain [-arrayLength, 0) correspond to array indexing starting from the back of the list, e.g. for an array of size 5, an “Index” of -5 equates to the last element in the array (i.e. the element at position 4), an “Index” of -4 equates to the second-to-last element in the array (i.e. the element at position 3), etc. Attempting to compute this node with “Index” values outside of the [-arrayLength, arrayLength) domain will result in a runtime error.

0

Outputs#

Name

Type

Descripton

Default

Value (outputs:value)

['bool', 'colord[3]', 'colord[4]', 'colorf[3]', 'colorf[4]', 'colorh[3]', 'colorh[4]', 'double', 'double[2]', 'double[3]', 'double[4]', 'float', 'float[2]', 'float[3]', 'float[4]', 'frame[4]', 'half', 'half[2]', 'half[3]', 'half[4]', 'int', 'int64', 'int[2]', 'int[3]', 'int[4]', 'matrixd[2]', 'matrixd[3]', 'matrixd[4]', 'normald[3]', 'normalf[3]', 'normalh[3]', 'pointd[3]', 'pointf[3]', 'pointh[3]', 'quatd[4]', 'quatf[4]', 'quath[4]', 'texcoordd[2]', 'texcoordd[3]', 'texcoordf[2]', 'texcoordf[3]', 'texcoordh[2]', 'texcoordh[3]', 'timecode', 'token', 'transform[4]', 'uchar', 'uint', 'uint64', 'vectord[3]', 'vectorf[3]', 'vectorh[3]']

A copy of the value in the “Array” at the specified “Index”.

None

Metadata#

Name

Value

Unique ID

omni.graph.nodes.ArrayIndex

Version

1

Extension

omni.graph.nodes_core

Has State?

False

Implementation Language

C++

Default Memory Type

cpu

Generated Code Exclusions

None

uiName

Get Array Index

Categories

math:array

Generated Class Name

OgnArrayIndexDatabase

Python Module

omni.graph.nodes_core