gimpprogress 3 LIBGIMP Library
gimpprogress Functions for embedding the progress bar into a plug-in's GUI.

## Synopsis

    void        (*GimpProgressStartCallback)    (const gchar *message,
                                                 gboolean cancelable,
                                                 gpointer user_data);
    void        (*GimpProgressEndCallback)      (gpointer user_data);
    void        (*GimpProgressTextCallback)     (const gchar *message,
                                                 gpointer user_data);
    void        (*GimpProgressValueCallback)    (gdouble percentage,
                                                 gpointer user_data);
    gboolean    gimp_progress_init              (const gchar *message);
    gboolean    gimp_progress_update            (gdouble percentage);
    const gchar* gimp_progress_install          (GimpProgressStartCallback start_callback,
                                                 GimpProgressEndCallback end_callback,
                                                 GimpProgressTextCallback text_callback,
                                                 GimpProgressValueCallback value_callback,
                                                 gpointer user_data);
    gpointer    gimp_progress_uninstall         (const gchar *progress_callback);
    gboolean    gimp_progress_cancel            (const gchar *progress_callback);

## Description

Functions for embedding the progress bar into a plug-in's GUI.

## Details

### GimpProgressStartCallback ()

    void        (*GimpProgressStartCallback)    (const gchar *message,
                                                 gboolean cancelable,
                                                 gpointer user_data);

message :

cancelable :

user_data :

GimpProgressStartCallback

### GimpProgressEndCallback ()

    void        (*GimpProgressEndCallback)      (gpointer user_data);

user_data :

GimpProgressEndCallback

### GimpProgressTextCallback ()

    void        (*GimpProgressTextCallback)     (const gchar *message,
                                                 gpointer user_data);

message :

user_data :

GimpProgressTextCallback

### GimpProgressValueCallback ()

    void        (*GimpProgressValueCallback)    (gdouble percentage,
                                                 gpointer user_data);

percentage :

user_data :

GimpProgressValueCallback

### gimp_progress_init ()

    gboolean    gimp_progress_init              (const gchar *message);

Initializes the progress bar for the current plug-in.

Initializes the progress bar for the current plug-in. It is only valid to call this procedure from a plug-in.

message :

  Message to use in the progress dialog.

Returns :

  TRUE on success.

gimp_progress_init

### gimp_progress_update ()

    gboolean    gimp_progress_update            (gdouble percentage);

Updates the progress bar for the current plug-in.

Updates the progress bar for the current plug-in. It is only valid to call this procedure from a plug-in.

percentage :

  Percentage of progress completed which must be between 0.0 and 1.0.

Returns :

  TRUE on success.

gimp_progress_update

### gimp_progress_install ()

    const gchar* gimp_progress_install          (GimpProgressStartCallback start_callback,
                                                 GimpProgressEndCallback end_callback,
                                                 GimpProgressTextCallback text_callback,
                                                 GimpProgressValueCallback value_callback,
                                                 gpointer user_data);

start_callback :

  the function to call when progress starts

end_callback :

  the function to call when progress finishes

text_callback :

  the function to call to change the text

value_callback :

  the function to call to change the value

user_data :

  a pointer that is returned when uninstalling the progress

Returns :

  the name of the temporary procedure that's been installed

Since GIMP 2.2

gimp_progress_install

### gimp_progress_uninstall ()

    gpointer    gimp_progress_uninstall         (const gchar *progress_callback);

Uninstalls a temporary progress procedure that was installed using `gimp_progress_install()`.

progress_callback :

  the name of the temporary procedure to uninstall

Returns :

  the user_data that was passed to `gimp_progress_install()`.

Since GIMP 2.2

gimp_progress_uninstall

### gimp_progress_cancel ()

    gboolean    gimp_progress_cancel            (const gchar *progress_callback);

Cancels a running progress.

This function cancels the currently running progress.

progress_callback :

  The name of the callback registered for this progress.

Returns :

  TRUE on success.

Since GIMP 2.2

gimp_progress_cancel