Click or drag to resize
SoSFImage3StartEditing Method (SbVec3i32, Int32, SoSFImageDataTypes)

These methods can be used to efficiently edit the values in an image field.

Namespace: OIV.Inventor.Fields
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 10.12.3.0 (10.12.3.0)
Syntax
public SbNativeArray<byte> StartEditing(
	out SbVec3i32 size,
	out int nc,
	out SoSFImageDataTypes dataType
)

Parameters

size
Type: OIV.InventorSbVec3i32
nc
Type: SystemInt32
dataType
Type: OIV.Inventor.FieldsSoSFImageDataTypes

Return Value

Type: SbNativeArrayByte
Remarks

OIV.Inventor.Fields.SoSFImage3.StartEditing(OIV.Inventor.SbVec3i32@, System.Int32@, OIV.Inventor.Fields.SoSFImage.DataTypes@) returns the size of the image in the size and nc arguments; writing past the end of the array returned is a good way to cause hard-to-find core dumps.

Calling this method is the same as doing a call to setSubValues on the whole texture. The getSubTexture will return one more updated regions when called after finishEditing.

Avoid copying the values in/out, if you are just changing the bytes and not changing the dimensions of the image.Using OIV.Inventor.Fields.SoSFImage3.StartEditing(OIV.Inventor.SbVec3i32@, System.Int32@, OIV.Inventor.Fields.SoSFImage.DataTypes@) allows subtexturing, which is a more efficient way of doing texture modification.

See Also