Click or drag to resize
SoSFImage3StartEditing Method (SbVec3s, Int32)

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: 2023.1.3.0 (2023.1.3)
Syntax
public SbNativeArray<byte> StartEditing(
	out SbVec3s size,
	out int nc
)

Parameters

size
Type: OIV.InventorSbVec3s
nc
Type: SystemInt32

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. This is a convenience method for the unsigned char datatype.

See Also