mirror of
https://gitlab.gnome.org/GNOME/gimp
synced 2024-10-22 20:41:43 +00:00
065db21d0a
2004-08-29 Michael Natterer <mitch@gimp.org> Added an API to allow plug-ins to embed the progress for the actions they trigger into their own GUI (attention: half-done and broken code ahead...) * app/core/Makefile.am * app/core/core-types.h * app/core/gimppdbprogress.[ch]: new object implementing dispatching progress calls to a temporary PDB procedure in a plug-in. * app/Makefile.am: force to link gimppdbprogress.o, bah! * app/plug-in/plug-in-progress.[ch]: added API to install, uninstall and cancel a PDB progress for this plug-in, but disabled the implementation because it doesn't work yet. * tools/pdbgen/pdb/progress.pdb: added pdb wrappers for the new install, uninstall and cancel functions. * libgimp/Makefile.am * libgimp/gimp.h * libgimp/gimpprogress.[ch]: added an API around the PDB progress stuff. * app/pdb/internal_procs.c * app/pdb/progress_cmds.c * libgimp/gimpprogress_pdb.[ch]: regenerated. * plug-ins/script-fu/script-fu-scripts.c: use the new API to show the progress in the script-fu dialog.
186 lines
4.6 KiB
C
186 lines
4.6 KiB
C
/* LIBGIMP - The GIMP Library
|
|
* Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
|
|
*
|
|
* gimpprogress_pdb.c
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
/* NOTE: This file is autogenerated by pdbgen.pl */
|
|
|
|
#include "config.h"
|
|
|
|
#include "gimp.h"
|
|
|
|
/**
|
|
* gimp_progress_init:
|
|
* @message: Message to use in the progress dialog.
|
|
|
|
*
|
|
* 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.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*/
|
|
gboolean
|
|
gimp_progress_init (const gchar *message)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp_progress_init",
|
|
&nreturn_vals,
|
|
GIMP_PDB_STRING, message,
|
|
GIMP_PDB_INT32, gimp_default_display (),
|
|
GIMP_PDB_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_progress_update:
|
|
* @percentage: Percentage of progress completed which must be between 0.0 and 1.0.
|
|
*
|
|
* 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.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*/
|
|
gboolean
|
|
gimp_progress_update (gdouble percentage)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp_progress_update",
|
|
&nreturn_vals,
|
|
GIMP_PDB_FLOAT, percentage,
|
|
GIMP_PDB_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* _gimp_progress_install:
|
|
* @progress_callback: The callback PDB proc to call.
|
|
*
|
|
* Installs a progress callback for the current plug-in.
|
|
*
|
|
* This function installs a temporary PDB procedure which will handle
|
|
* all progress calls made by this plug-in and any procedure it calls.
|
|
* Calling this function multiple times simply replaces the old
|
|
* progress callbacks.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: GIMP 2.2
|
|
*/
|
|
gboolean
|
|
_gimp_progress_install (const gchar *progress_callback)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp_progress_install",
|
|
&nreturn_vals,
|
|
GIMP_PDB_STRING, progress_callback,
|
|
GIMP_PDB_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* _gimp_progress_uninstall:
|
|
* @progress_callback: The name of the callback registered for this progress.
|
|
*
|
|
* Uninstalls the progress callback for the current plug-in.
|
|
*
|
|
* This function uninstalls any progress callback installed with
|
|
* gimp_progress_install() before.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: GIMP 2.2
|
|
*/
|
|
gboolean
|
|
_gimp_progress_uninstall (const gchar *progress_callback)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp_progress_uninstall",
|
|
&nreturn_vals,
|
|
GIMP_PDB_STRING, progress_callback,
|
|
GIMP_PDB_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|
|
|
|
/**
|
|
* gimp_progress_cancel:
|
|
* @progress_callback: The name of the callback registered for this progress.
|
|
*
|
|
* Cancels a running progress.
|
|
*
|
|
* This function cancels the currently running progress.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: GIMP 2.2
|
|
*/
|
|
gboolean
|
|
gimp_progress_cancel (const gchar *progress_callback)
|
|
{
|
|
GimpParam *return_vals;
|
|
gint nreturn_vals;
|
|
gboolean success = TRUE;
|
|
|
|
return_vals = gimp_run_procedure ("gimp_progress_cancel",
|
|
&nreturn_vals,
|
|
GIMP_PDB_STRING, progress_callback,
|
|
GIMP_PDB_END);
|
|
|
|
success = return_vals[0].data.d_status == GIMP_PDB_SUCCESS;
|
|
|
|
gimp_destroy_params (return_vals, nreturn_vals);
|
|
|
|
return success;
|
|
}
|