— Get a handle for an image in a clip at the indicated time and indicated region
||OfxImageClipHandle clip ,|
|OfxTime time ,|
|const OfxRectD * region ,|
An image is fetched from a clip at the indicated time for the given region and returned in the imageHandle.
If the region parameter is not set to NULL, then it will be clipped to the clip's Region of Definition for the given time. The returned image will be m at m least as big as this region. If the region parameter is not set, then the region fetched will be at least the Region of Interest the effect has previously specified, clipped the clip's Region of Definition.
If clipGetImage is called twice with the same parameters, then two separate image handles will be returned, each of which must be release. The underlying implementation could share image data pointers and use reference counting to maintain them.
should continue operation, but assume the image was black and transparent.