gimp-image-undo-freeze

Adam D. Moss

Description

Freeze the image's undo stack.

Help

This procedure freezes the image's undo stack, allowing subsequent operations to ignore their undo steps. This is generally called in conjunction with 'gimp-image-undo-thaw' to temporarily disable an image undo stack. This is advantageous because saving undo steps can be time and memory intensive. 'gimp-image-undo-freeze' / 'gimp-image-undo-thaw' and 'gimp-image-undo-disable' / 'gimp-image-undo-enable' differ in that the former does not free up all undo steps when undo is thawed, so is more suited to interactive in-situ previews. It is important in this case that the image is back to the same state it was frozen in before thawing, else 'undo' behaviour is undefined.


Type

unknown

Parameters

Type Name Description
PF_IMAGE image The image

Return

Type Name Description
PF_INT frozen TRUE if the image undo has been frozen (TRUE or FALSE)