gimpdisplay3LIBGIMP LibrarygimpdisplayFunctions to create, delete and flush new displays (views) on an image.Synopsis
gint32 gimp_display_new (gint32 image_ID);
gboolean gimp_display_delete (gint32 display_ID);
gboolean gimp_displays_flush (void);
gboolean gimp_displays_reconnect (gint32 old_image_ID,
gint32 new_image_ID);
Description
Functions to create, delete and flush new displays (views) on an image.
Detailsgimp_display_new ()gimp_display_newgint32 gimp_display_new (gint32 image_ID);
Create a new display for the specified image.
Creates a new display for the specified image. If the image already
has a display, another is added. Multiple displays are handled
transparently by the GIMP. The newly created display is returned and
can be subsequently destroyed with a call to 'gimp-display-delete'.
This procedure only makes sense for use with the GIMP UI.image_ID : The image.
Returns : The new display.
gimp_display_delete ()gimp_display_deletegboolean gimp_display_delete (gint32 display_ID);
Delete the specified display.
This procedure removes the specified display. If this is the last
remaining display for the underlying image, then the image is
deleted also.display_ID : The display to delete.
Returns : TRUE on success.
gimp_displays_flush ()gimp_displays_flushgboolean gimp_displays_flush (void);
Flush all internal changes to the user interface
This procedure takes no arguments and returns nothing except a
success status. Its purpose is to flush all pending updates of image
manipulations to the user interface. It should be called whenever
appropriate.Returns : TRUE on success.
gimp_displays_reconnect ()gimp_displays_reconnectgboolean gimp_displays_reconnect (gint32 old_image_ID,
gint32 new_image_ID);
Reconnect displays from one image to another image.
This procedure connects all displays of the old_image to the
new_image. If the old_image has no display or new_image already has
a display the reconnect is not performed and the procedure returns
without success. You should rarely need to use this function.old_image_ID : The old image (must have at least one display).
new_image_ID : The new image (must not have a display).
Returns : TRUE on success.