SoSFImage3.SetValue Method (SbVec3i32, Int32, SoSFImage.DataTypes, SoBufferObject, SoSFImage3.CopyPolicies)

SoSFImage3SetValue Method (SbVec3i32, Int32, SoSFImageDataTypes, SoBufferObject, SoSFImage3CopyPolicies)

Sets the value of this field to be an image of the given size, with the given number of components, and with the given pixel values.

Namespace: OIV.Inventor.Fields
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 10.12.3.0 (10.12.3.0)

Syntax

C++

Copy

public void SetValue(
	SbVec3i32 size,
	int nc,
	SoSFImageDataTypes dataType,
	SoBufferObject bufferObject,
	SoSFImage3CopyPolicies copy
)

Public Sub SetValue ( 
	size As SbVec3i32,
	nc As Integer,
	dataType As SoSFImageDataTypes,
	bufferObject As SoBufferObject,
	copy As SoSFImage3CopyPolicies
)

public:
void SetValue(
	SbVec3i32 size, 
	int nc, 
	SoSFImageDataTypes dataType, 
	SoBufferObject^ bufferObject, 
	SoSFImage3CopyPolicies copy
)

member SetValue : 
        size : SbVec3i32 * 
        nc : int * 
        dataType : SoSFImageDataTypes * 
        bufferObject : SoBufferObject * 
        copy : SoSFImage3CopyPolicies -> unit

Parameters

size: Type: OIV.InventorSbVec3i32
nc: Type: SystemInt32
dataType: Type: OIV.Inventor.FieldsSoSFImageDataTypes
bufferObject: Type: OIV.Inventor.DevicesSoBufferObject
copy: Type: OIV.Inventor.FieldsSoSFImage3CopyPolicies

Remarks

size[0]*size[1]*size[2]*nc*sizeof(<dataType>) bytes from the given array will be copied into internal storage maintained by the OIV.Inventor.Fields.SoSFImage3 field.

At times, OIV.Inventor.Fields.SoSFImage3 may need to manipulate large amounts of memory. Therefore, it is useful to be able to specify the memory usage policy dynamically. By default, the memory policy is COPY, which is consistent with other Open Inventor fields. The most likely to be efficient is NO_COPY. See also OIV.Inventor.Fields.SoSFImage3.SetNeverWrite(System.Boolean).

Reference

SoSFImage3 Class

SetValue Overload

OIV.Inventor.Fields Namespace