| SoSFArray2D Class |
Field containing a 2D array value.
Inheritance HierarchyOIV.InventorSoNetBase
OIV.Inventor.FieldsSoField
OIV.Inventor.FieldsSoSField
OIV.Inventor.FieldsSoSFArray
OIV.Inventor.FieldsSoSFArray2D
Namespace: OIV.Inventor.Fields
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 2024.1.0.0 (2024.1.0)
SyntaxThe SoSFArray2D type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | SoSFArray2D | Default constructor. |
Methods| Name | Description | |
|---|---|---|
| AppendConnection(SoEngineOutput) | Appends this field to the list of connections from another engineOutput. |
| AppendConnection(SoField) | Appends this field to the list of connections from another field. |
| ConnectFrom(SoEngineOutput) | Connects this field from an engine output. |
| ConnectFrom(SoField) | Connects this field to another field. |
| CopyFrom(SoSFArray) | Copy from another field of same type. |
| CopyFrom(SoSFArray2D) | Copy from another field of same type. |
| Disconnect | Disconnect the field from whatever it was connected to. |
| Disconnect(SoEngineOutput) | Disconnect the field from the requested engineOutput. |
| Disconnect(SoField) | Disconnect the field from the requested field. |
| EnableConnection | Field connections may be enabled and disabled. |
| Equals | (Inherited from SoSFArray.) |
| FinishEditing | Indicates that batch edits have finished. |
| Get | Returns the value of the field in the Open Inventor file format, even if the field has its default value. |
| GetConnectedEngine | Returns true if this field is being written into by an engine, and returns the engine output it is connected to in engineOutput. |
| GetConnectedField | Returns true if this field is being written into by another field, and returns the field it is connected to in writingField. |
| GetConnections | Returns a list of the connections to this field. |
| GetContainer | Returns the object that contains this field. |
| GetDataType | Returns the data type of the array. |
| GetForwardConnections | Adds references to all of the fields that this field is writing into (either fields in nodes, global fields or engine inputs) to the given field list, and returns the number of forward connections. |
| GetHashCode |
Overrides GetHashCode().
(Inherited from SoNetBase.) |
| GetNumConnections | Returns the number of connections to this field. |
| GetSize | Returns the dimensions of the array. |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetValue | Returns a read-only pointer to the array's values . |
| GetValue(SbVec2i32, SoSFArrayDataTypes) | Returns a read-only pointer to the 2D array's values and its dimensions and data type. |
| GetValue(SbVec2s, SoSFArrayDataTypes) | Returns a read-only pointer to the 2D array's values and its dimensions and data type. |
| GetValue(SbVec3i32, SbDataType) | Returns a read-only pointer to the array's values and its dimensions and data type. |
| GetValueSize | Gets the size of the value. |
| IsConnected | Returns true if the field is connected to anything. |
| IsConnectedFromEngine | Returns true if the field is connected to an engine's output. |
| IsConnectedFromField | Returns true if the field is connected to another field. |
| IsConnectedFromVRMLInterp | Returns true if the field is connected to a VRML interpOutput. |
| IsConnectionEnabled | Returns false if connections to this field are disabled. |
| IsDefault | Gets the state of default flag of the field. |
| IsEmpty | Returns true if the current array is empty. |
| IsIgnored | Gets the ignore flag for this field. |
| IsNeverWrite | Returns the "neverWrite" flag. |
| Set | Sets the field to the given value, which is an ASCII string in the Open Inventor file format. |
| SetIgnored | Sets the ignore flag for this field. |
| SetNeverWrite | Sets the "neverWrite" flag. |
| SetValue(SbVec2i32, SoSFArrayDataTypes, SbNativeArrayByte) | Calls SetValue(size, dataType, data, OIV.Inventor.Fields.SoSFArray.CopyPolicies( .SoSFArray.COPY )). |
| SetValue(SbVec2s, SoSFArrayDataTypes, SbNativeArrayByte) | Calls SetValue(size, dataType, data, OIV.Inventor.Fields.SoSFArray.CopyPolicies( .SoSFArray.COPY )). |
| SetValue(SbVec3i32, SbDataType, SbNativeArrayByte) | Calls SetValue(size, dataType, data, OIV.Inventor.Fields.SoSFArray.CopyPolicies( .SoSFArray.COPY )). (Inherited from SoSFArray.) |
| SetValue(SbVec2i32, SoSFArrayDataTypes, SbNativeArrayByte, SoSFArrayCopyPolicies) | Fill the 2D array with data of the specified dimensions and type using the specified copy policy. |
| SetValue(SbVec2s, SoSFArrayDataTypes, SbNativeArrayByte, SoSFArrayCopyPolicies) | Fill the 2D array with data of the specified dimensions and type using the specified copy policy. |
| SetValue(SbVec3i32, SbDataType, SbNativeArrayByte, SoSFArrayCopyPolicies) | Fill the array with data of the specified dimensions and type using the specified copy policy. |
| StartEditing(SbVec2i32, SoSFArrayDataTypes) | Returns a pointer to the internally maintained array that can be modified. |
| StartEditing(SbVec2s, SoSFArrayDataTypes) | Returns a pointer to the internally maintained array that can be modified. |
| StartEditing(SbVec3i32, SbDataType) | Returns a pointer to the internally maintained array that can be modified. |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Touch | Simulates a change to the field, causing attached sensors to fire, connected fields and engines to be marked as needing evaluation, and so forth. |
RemarksThis field contains a 2D array of values of a specified type. The OIV.Inventor.Fields.SoSFArray2D.SetValue(OIV.Inventor.SbVec2s, OIV.Inventor.Fields.SoSFArray.DataTypes, OIV.Inventor.Generic.SbNativeArray{{System.Byte}}, OIV.Inventor.Fields.SoSFArray.CopyPolicies) method allows you to specify the dimensions and type of data the array will contain. The CopyPolicy allows you to control whether Open Inventor will make a copy of the data and, if not, whether the application or Open Inventor is responsible for managing the memory.
In ASCII format, an OIV.Inventor.Fields.SoSFArray2D is written to file in the following format:
Two numbers define the dimensions of the array
One string defines the type of the data:
BYTE for signed bytes
UBYTE for unsigned bytes
SHORT for signed shorts
USHORT for unsigned shorts
INT32 for signed 32 bits ints
UINT32 for unsigned 32 bits ints
FLOAT for floating point values
A list of values in decimal, hexadecimal, or octal format for integers or in standard scientific notation for float. Numbers are separated by a blank (space, tab, return...).
2 2 UBYTE 0 1 2 3Below is a 2x3 array of floats:
2 3 FLOAT 0.5 1 .72 0.33 6.2e4 0.9
EXAMPLE
SbVec2i32 size = new SbVec2i32(2,2); byte[] bytes = new byte[4]; SbNativeArray<byte> data = new SbNativeArray<byte>(bytes); . . . SoIndexedTexture2 indexedTexture = new SoIndexedTexture2(); indexedTexture.imageIndex.SetValue(size, SoSFArray.DataTypes.UNSIGNED_BYTE, data);
See Also