#include "ofxImageEffect.h" #define kOfxImageEffectActionGetRegionsOfInterest "OfxImageEffectActionGetRegionsOfInterest"
handlehandle to the instance, cast to an
inArgshas the following properties...
outArgshas a set of 4 dimensional double properties, one for each of the input clips to the effect. The properties are each named "OfxImageClipPropRoI_" with the clip name post pended, for example "OfxImageClipPropRoI_Source". These are initialised to the default RoI.
This action allows a host to ask an effect, given a region I want to render, what region do you need from each of your input clips. In that way, depending on the host architecture, a host can fetch the minimal amount of the image needed as input. Note that there is a region of interest to be set in
for each input clip that exists on the effect. Form more details see
Image Effect Architectures
The default RoI is simply the value passed in on the
property set. All the RoIs in the
property set must initialised to this value before the action is called.