NAME

instant_image_transform - Immediately perform all pending transformations.

SYNOPSIS

nil
instant_image_transform( vid:dst )
instant_image_transform( vid:dst, int:mask )
instant_image_transform( vid:dst, bool:trigger_last )
instant_image_transform( vid:dst, bool:trigger_last, bool:trigger_all )

DESCRIPTION

This will fast-forward through the transform chain for dst . If 'mask' is set, only the specifiied bitmask of chains ( MASK_OPACITY , MASK_ORIENTATION , MASK_POSITION , MASK_SCALE ) will be fast-forwarded.

The default behaviour is to ignore all tagged transform handlers. If trigger_last is set, all handlers except the end of each chain will be ignored. If trigger_all is set, all handlers will be triggered.

NOTES

1

The trigger_last, trigger_all forms are problematic and should only be used in exceptional circumstances as a tag transform might lead to a new transform being added which will immediately be triggered and so on, possibly causing hard to debug infinite chains.

2

EXAMPLE

function instant_image_transform0()


      a = fill_surface(32, 32, 255, 0, 0);


      show_image(a);


      move_image(a, 50, 50, 100);


      instant_image_transform(a);


      props = image_surface_properties(a);


      print(props.x, props.y);
end

SEE ALSO:

copy_image_transform(3)