EyeonTips:Script/Reference/Applications/Fuse/Classes/Image

From VFXPedia

Further Methods and Members

• Clear() has been added in Fusion 6.1.4 Build 760 and will fill all channels with zeros.
• GetChanSize(<channel>), introduced in 6.31, returns the number of bytes or 0 if the channel is not present.
• .Metadata contains a table of image metadata (or nil if no metadata is available) that can both be read and written. Refer to the metadata example fuses on how to leverage custom metadata in your fuses. Using the LUA functions eyeon.writestring() and eyeon.readstring(), you can place almost anything into the metadata that gets passed around.

Domain of Definition

Since Fusion 6.2 (build 897) there are two more members that are important for DoD:

• .DataWindow contains the actual size of the pixel area that may be accessed. Writing outside of its bounds may crash Fusion.
• .ValidWindow specifies the area for which the image is valid (usually the Region of interest. If a new request that is just a subarea of the old one is performed, no re-rendering will take place. You can test this in the viewport yourself).

Both attributes are read-only. To set them during image creation, use the IMG_DataWindow and IMG_ValidWindow attributes. Both expect FuRectInt objects which are basically four integer pixel values for the left, bottom, right and top edges of a rectangle.

All of this is demonstrated in the clBC and clMerge example Fuses that ship with current versions of Fusion and explained in the ROIDS tutorial.