<DataCapture> Data Interface

Provides script language access to C++ objects of this type.

Class HierarchyType » DataCapture

Function Members

Function members are as follows:

Return Type Function Name Documentation
<DataCapture>DataCaptureThe <DataCapture> constructor which allows you to set this object's <Node> container. ( The <Node> in which the <DataCapture> object is resident. )
int32ClearClears the internal <NodeSelector>, Local Data Source &tl;NodeSink>, data acquisition string value, and container object pointer.
<DataCapture>CloneReturns a pointer to a new <DataCapture> object.
<Node>FindDataSourceGets the <Node> data source from which the <DataCapture> object is capturing data. For example <LightDataCaptureAmbientColor> captures data from <Light> objects, and this function returns the <Light> object from which data is being captured. This <Light> object can be in the same document as the <DataCapture> object, in which case this function returns the <Light> directly via the <DataCapture> object's <NodeSink> object, or the <Light> object can be stored in a remote document, in which case this function gets the <Light> object from the <DataCapture> object's <NodeSelector> object.
<Int32Array>GetBooleanArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <BooleanArrayDataCapture> ), returns a pointer to the <Int32Array> data member of this object. Otherwise returns nullptr.
int32GetBooleanValueReturns the Boolean value being stored by the <DataCapture> object.
<Int32VectorArray>GetBooleanVectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <BooleanVectorArrayDataCapture> ), returns a pointer to the <Int32VectorArray> data member of this object. Otherwise returns nullptr.
<Int32Vector>GetBooleanVectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <BooleanVectorDataCapture> ), returns a pointer to the <Int32Vector> data member of this object. Otherwise returns nullptr.
TypeInformationGetCaptureTargetTypeReturns a <TypeInformation> object that indicates the type of object from which the <DataCapture> object can capture data. For example: LightDataCaptureAmbientColor returns <Light>. The LightDataCaptureAmbientColor data capture object can only capture data from objects of type <Light>.
int32GetCaptureTargetTypesPopulates a <TypeInfoArray> with auxiliary types from which a <DataCapture> object can capture data.
<ColorArray>GetColorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <ColorArrayDataCapture> ), returns a pointer to the <ColorArray> data member of this object. Otherwise returns nullptr.
<Color>GetColorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <ColorDataCapture> ), returns a pointer to the <Color> data member of this object. Otherwise returns nullptr.
TypeInformationGetContainerVariableTypeReturns a pointer to a <TypeInformation> object representing the relevant <VariableNode>-derived class. For example: LightDataCaptureAmbientColor object returns <ColorNode> and <MaterialDataCaptureShininess> returns <Float32Node>.
int32GetContainerVariableTypesPopulates a <TypeInfoArray> with any valid container object types.
stringGetDestinationNameGets a string containing the destination name for the data capture operation. For example: LightDataCaptureAmbientColor returns "lightAmbientColor", which is used to set variable names for <ColorNode> objects that use this data capture object. This provides a means by which data capture state can be applied consistently.
int32GetDimensionGets the dimension of the <DataCapture> object. For example: GLSL_Float, GLSL_Mat4x4.
<Float16Array>GetFloat16ArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float16ArrayDataCapture ), returns a pointer to the <Float16Array> data member of this object. Otherwise returns nullptr.
floatGetFloat16ValueReturns the value of this object.
<Float16VectorArray>GetFloat16VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float16VectorArrayDataCapture ), returns a pointer to the <Float16VectorArray> data member of this object. Otherwise returns nullptr.
<Float16Vector>GetFloat16VectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float16VectorDataCapture ), returns a pointer to the <Float16Vector> data member of this object. Otherwise returns nullptr.
<Float32Array>GetFloat32ArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float32ArrayDataCapture ), returns a pointer to the <Float32Array> data member of this object. Otherwise returns nullptr.
<Float32MatrixArray>GetFloat32MatrixArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float32MatrixArrayDataCapture ), returns a pointer to the <Float32MatrixArray> data member of this object. Otherwise returns nullptr.
<Float32Matrix>GetFloat32MatrixValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float32MatrixDataCapture> ), returns a pointer to the <Float32Matrix> data member of this object. Otherwise returns nullptr.
floatGetFloat32ValueReturns the <float32> value being stored by the <DataCapture> object.
<Float32VectorArray>GetFloat32VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float32VectorArrayDataCapture> ), returns a pointer to the <Float32VectorArray> data member of this object. Otherwise returns nullptr.
<Float32Vector>GetFloat32VectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float32VectorDataCapture> ), returns a pointer to the <Float32Vector> data member of this object. Otherwise returns nullptr.
<Float64Array>GetFloat64ArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float64ArrayDataCapture> ), returns a pointer to the <Float64Array> data member of this object. Otherwise returns nullptr.
<Float64MatrixArray>GetFloat64MatrixArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float64MatrixArrayDataCapture> ), returns a pointer to the <Float64MatrixArray> data member of this object. Otherwise returns nullptr.
<Float64Matrix>GetFloat64MatrixValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float64MatrixDataCapture> ), returns a pointer to the <Float64Matrix> data member of this object. Otherwise returns nullptr.
doubleGetFloat64ValueReturns the <float64> value being stored by the <DataCapture> object.
<Float64VectorArray>GetFloat64VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float64VectorArrayDataCapture> ), returns a pointer to the <Float64VectorArray> data member of this object. Otherwise returns nullptr.
<Float64Vector>GetFloat64VectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Float64VectorDataCapture> ), returns a pointer to the <Float64Vector> data member of this object. Otherwise returns nullptr.
<Int16Array>GetInt16ArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int16ArrayDataCapture ), returns a pointer to the <Int16Array> data member of this object. Otherwise returns nullptr.
int32GetInt16ValueReturns the value of this object.
<Int16VectorArray>GetInt16VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int16VectorArrayDataCapture ), returns a pointer to the <Int16VectorArray> data member of this object. Otherwise returns nullptr.
<Int16Vector>GetInt16VectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int16VectorDataCapture ), returns a pointer to the <Int16Vector> data member of this object. Otherwise returns nullptr.
<Int32Array>GetInt32ArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int32ArrayDataCapture> ), returns a pointer to the <Int32Array> data member of this object. Otherwise returns nullptr.
int32GetInt32ValueReturns the <int32> value being stored by the <DataCapture> object.
<Int32VectorArray>GetInt32VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int32VectorArrayDataCapture> ), returns a pointer to the <Int32VectorArray> data member of this object. Otherwise returns nullptr.
<Int32Vector>GetInt32VectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int32VectorDataCapture> ), returns a pointer to the <Int32Vector> data member of this object. Otherwise returns nullptr.
<Int64Array>GetInt64ArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int64ArrayDataCapture> ), returns a pointer to the <Int64Array> data member of this object. Otherwise returns nullptr.
int64GetInt64ValueReturns the <int64> value being stored by the <DataCapture> object.
<Int64VectorArray>GetInt64VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int64VectorArrayDataCapture> ), returns a pointer to the <Int64VectorArray> data member of this object. Otherwise returns nullptr.
<Int64Vector>GetInt64VectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int64VectorDataCapture> ), returns a pointer to the <Int64Vector> data member of this object. Otherwise returns nullptr.
<Int8Array>GetInt8ArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int8ArrayDataCapture ), returns a pointer to the <Int8Array> data member of this object. Otherwise returns nullptr.
int32GetInt8ValueReturns the value of this object.
<Int8VectorArray>GetInt8VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int8VectorArrayDataCapture ), returns a pointer to the <Int8VectorArray> data member of this object. Otherwise returns nullptr.
<Int8Vector>GetInt8VectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Int8VectorDataCapture ), returns a pointer to the <Int8Vector> data member of this object. Otherwise returns nullptr.
<MatrixArray>GetMatrixArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from MatrixArrayDataCapture> ), returns a pointer to the MatrixArray> data member of this object. Otherwise returns nullptr.
<Matrix>GetMatrixValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from MatrixDataCapture> ), returns a pointer to the <Matrix> data member of this object. Otherwise returns nullptr.
int32GetPackedObjectsPopulates a <List> with all <DataCapture> objects stored by a particular <DataCapture> package. For example: a <VectorDataCapturePackage> object ( which is a subclass of <DataCapture> ) may contain up to four <Float32DataCapture> objects, and a <MatrixDataCapturePackage> may contain up to four <VectorDataCapturePackage> objects, each of which can contain up to four <Float32DataCapture> objects. This function populates the <List> with all <DataCapture> objects in the package or set of packages.
stringGetSourceNameGets a string containing the destination name for the data capture operation. For example: <LightDataCaptureAmbientColor> returns "SPA_LightAmbientColor", which is used to indicate data capture state in a way that cannot be modified by an end user. If the user overrides a particular name such as 'lightAmbientColor', the underlying data capture operation can still be tracked. This provides a means by which data capture state can be applied consistently, which is especially important for algorithms running on sets of <DataCapture> objects.
<TextureReadbackParams>GetTextureReadbackParamsReturns a pointer to the <DataCapture> object's <TextureReadbackParams> data member, or nullptr if the <DataCapture> data member does not exist.
<Uint16Array>GetUint16ArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Uint16ArrayDataCapture ), returns a pointer to the <Uint16Array> data member of this object. Otherwise returns nullptr.
uint32GetUint16ValueReturns the value of this object.
<Uint16VectorArray>GetUint16VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Uint16VectorArrayDataCapture ), returns a pointer to the <Uint16VectorArray> data member of this object. Otherwise returns nullptr.
<Uint16Vector>GetUint16VectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Uint16VectorDataCapture ), returns a pointer to the <Uint16Vector> data member of this object. Otherwise returns nullptr.
<Uint32Array>GetUint32ArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Uint32ArrayDataCapture> ), returns a pointer to the <Uint32Array> data member of this object. Otherwise returns nullptr.
uint32GetUint32ValueReturns the <uint32> value being stored by the <DataCapture> object.
<Uint32VectorArray>GetUint32VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from UintVectorArrayDataCapture> ), returns a pointer to the <Uint32VectorArray> data member of this object. Otherwise returns nullptr.
<Uint32Vector>GetUint32VectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Uint32VectorDataCapture> ), returns a pointer to the <Uint32Vector> data member of this object. Otherwise returns nullptr.
<Uint64Array>GetUint64ArrayValueReturns the <uint64> array value being stored by the <DataCapture> object.
uint64GetUint64ValueReturns the <uint64> value being stored by the <DataCapture> object.
<Uint64VectorArray>GetUint64VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Uint64VectorArrayDataCapture> ), returns a pointer to the <Uint64VectorArray> data member of this object. Otherwise returns nullptr.
<Uint64Vector>GetUint64VectorValueReturns the <uint64> vector value being stored by the <DataCapture> object.
<Uint8Array>GetUint8ArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Uint8ArrayDataCapture ), returns a pointer to the <Uint8Array> data member of this object. Otherwise returns nullptr.
uint32GetUint8ValueReturns the value of this object.
<Uint8VectorArray>GetUint8VectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Uint8VectorArrayDataCapture ), returns a pointer to the <Uint8VectorArray> data member of this object. Otherwise returns nullptr.
<Uint8Vector>GetUint8VectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <Uint8VectorDataCapture ), returns a pointer to the <Uint8Vector> data member of this object. Otherwise returns nullptr.
stringGetValueStringReturns the value string, such as 'false' or '{ 1, 0, 0, 1}' or similar. This string is guaranteed to be parseable.
<Float64VectorArray>GetVectorArrayValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <VectorArrayDataCapture> ), returns a pointer to the <Float64VectorArray> data member of this object. Otherwise returns nullptr.
<Float64Vector>GetVectorValueIf the <DataCapture> object is a pointer to a compatible and relevant derived class ( such as any class derived from <VectorDataCapture> ), returns a pointer to the <Float64Vector> data member of this object. Otherwise returns nullptr.
int32GetViewFromObjectCopies <DataCapture> dimension information into the <MemberView> object parameter. For example, <LightDataCaptureNearX> is a <Float32DataCapture> object. The resulting <MemberView> object will return 1 and 1 for its rows and columns when queried. Similarly, a <LightDataCapturePosition> is a <Float32VectorDataCapture< object. The resulting <MemberView> object will return 1 and 1 for its rows and columns when queried. <Float32MatrixDataCapture> objects might return row and column counts such as 3 and 3 or 4 and 4.
int32IsArrayTypeReturns true if and only if the <DataCapture> object represents arrays such as <BooleanArrayDataCapture>, <Float32VectorArrayDataCapture, or <MatrixArrayDataCapture>.
int32IsBoolTypeReturns true if and only if the <DataCapture> object represents a Boolean type.
int32IsColorTypeReturns true if and only if the <DataCapture> object represents a Color type.
int32IsFloat16TypeReturns true if and only if the <DataCapture> object represents a <float32> type.
int32IsFloat32TypeReturns true if and only if the <DataCapture> object represents a <float32> type.
int32IsFloat64TypeReturns true if and only if the <DataCapture> object represents a <float64> type.
int32IsFloatTypeReturns true if and only if the <DataCapture> object represents any floating point type (16,32, or 64 bit) type.
int32IsInt16TypeReturns true if and only if the <DataCapture> object represents an <int16> type.
int32IsInt32TypeReturns true if and only if the <DataCapture> object represents an <int32> type.
int32IsInt64TypeReturns true if and only if the <DataCapture> object represents an <int64> type.
int32IsInt8TypeReturns true if and only if the <DataCapture> object represents an <int8> type.
int32IsIntegralTypeReturns true if and only if the <DataCapture> object represents an integral type.
int32IsMatrixArrayTypeReturns true if and only if the <DataCapture> object represents a matrix array type.
int32IsMatrixTypeReturns true if and only if the <DataCapture> object represents a matrix type.
int32IsScalarArrayTypeReturns true if and only if the <DataCapture> object represents an array of scalar types.
int32IsScalarTypeReturns true if and only if the <DataCapture> object represents a scalar type.
int32IsUint16TypeReturns true if and only if the <DataCapture> object represents a <uint16> type.
int32IsUint32TypeReturns true if and only if the <DataCapture> object represents a <uint32> type.
int32IsUint64TypeReturns true if and only if the <DataCapture> object represents a <uint64> type.
int32IsUint8TypeReturns true if and only if the <DataCapture> object represents an <uint8> type.
int32IsValueCaptureTypeReturns true if and only if the <DataCapture> object represents a value capture type such as <Float32DataCaptureScalar>, <Float32DataCaptureArray>, <Float32VectorDataCaptureVector>, or <Float32VectorArrayDataCaptureArray>.
int32IsVectorArrayTypeReturns true if and only if the <DataCapture> object represents an array of vectors.
int32IsVectorTypeReturns true if and only if the <DataCapture> object represents a vector type.
int32SetBooleanValueSets the value of this object.
int32SetFloat16ValueSets the value of this object.
int32SetFloat32ValueSets the value of this object.
int64SetFloat64ValueSets the value of this object.
int32SetInt16ValueSets the value of this object.
int32SetInt32ValueSets the value of this object.
int64SetInt64ValueSets the value of this object.
int32SetInt8ValueSets the value of this object.
int32SetObjectParametersFromViewConfigures the the <DataCapture> object's data members, array count, vector dimension, or matrix dimensions, etc. with the parameters stored in the <MemberView> object submitted to this function.
int32SetUint16ValueSets the value of this object.
uint32SetUint32ValueSets the value of this object.
uint64SetUint64ValueSets the value of this object.
int32SetUint8ValueSets the value of this object.

Object Members

Object members are as follows:

Type Name Accessor Name Documentation
<Node>ContainerGets or sets this object's container object, which is the <Node> in which the <DataCapture> object is resident. Get returns a <Node> pointer and Set requires a <Node> pointer.
<Node>ContainerLinkGets or sets this object's container object.
<DataCaptureIndices>DataCaptureIndicesReturns a pointer to this object's <DataCaptureIndices> object.
<DataCaptureList>DataCaptureListReturns a pointer to the <DataCaptureList> object if the <DataCapture> object or subclass can store sub-objects. Otherwise returns nullptr. This object enables you to nest <DataCapture> objects inside other <DataCapture> objects. For example: A <DataCapture> object may be stored in a <VariableNode> representing an array, such as <Float32ArrayNode>, and <DataCapture> sub-objects stored in this <DataCaptureList> may set individual array values.
<Node>LocalDataSourceGets or sets the local data source, which is the object from which you wish to capture data.
<Node>LocalDataSourceLinkGets or sets the local data source, which is the object from which you wish to capture data.
stringNameGets or sets the name associated with the <DataCapture> object. This is usually used to associate a GLSL or SSL variable declaration with a <DataCapture> object, but it can be used to differentiate <DataCapture> objects from one another.