ImageArray

Property

Document.ImageArray (read-write, Variant array of Floats)

Syntax

Document.ImageArray [= array]

Remarks

Returns a safearray of Floats giving the pixel data of the associated image. If the image is monochrome, the array is of dimension XSize by YSize; if it is tricolor, the array is of dimension 3 by XSize by YSize, the three planes of the three-dimensional array being the red, green, and blue image planes.

ImageArray can also be assigned to, provided the item on the right-hand side of the assignment operator is an array of floats of the proper number of dimensions (XSize by YSize if monochrome, and 3 by XSize by YSize if tricolor) for the image.

Please note that this property is incompatible with VBScript/JScript since it uses an array of Floats, and these languages can only manipulate Variants. This has been done because Variant would consume far too much memory for large image arrays. The array itself is retrievable, but any attempt to access an individual component (pixel value) will result in a "Type mismatch" error. ImageArray is fully compatible with Visual Basic.