roCompositor's ChangeMatchingRegions has this terse description:
"ifCompositor" wrote:
ChangeMatchingRegions(oldRegion as Object, newRegion as Object) as Void
Global search and replace of Sprite roRegions.
Replaces regions that match oldRegion with newRegion.
It's unclear here
- what "global" means (local to roCompositor instance - or global to the player?), also
- what it means by using plural "regions" (can params be lists of regions?) and
- what to "match" means (identity? dimension equality?).
Going out on a limb here, i am guessing perhaps what it does is: go over all
roSprites for this
roCompositor instance, checks their respective
roRegions and if it finds literally the same oldRegion (the same pointer, that is), replaces it with newRegion. Am i close?
Also, shouldn't
roCompositor support some way to enumerate all belonging sprites, like
ifEnum ?