Hi again,
This is what we ended up in the last discussion. Anyone have some final
comments or objections before I push this to master and port plug-ins to
use this?
/ Martin
/**
* gimp_export_prepare_image:
* @image_ID: Pointer to the image_ID.
* @drawable_ID: Pointer to the drawable_ID.
* @capabilities: What can the image_format do?
*
* Takes an image and a drawable to be saved together with a
* description of the capabilities of the image_format. If the type of
* image doesn't match the capabilities of the format a copy is
* created. This copy is then converted, the image_ID and drawable_ID
* are changed to point to the new image and the procedure returns
* GIMP_EXPORT_EXPORT. The save_plugin has to take care of deleting
* the created image using gimp_image_delete() when it has saved it.
*
* If no converson is done, the image_ID and drawable_ID is not
* altered, GIMP_EXPORT_IGNORE is returned and the save_plugin should
* try to save the original image.
*
* This function has identical semantics to gimp_export_image() except
* that it doesn't ask the user any questions.
*
* Returns: An enum of #GimpExportReturn describing the action.
*
* Since: GIMP 2.8
**/
GimpExportReturn
gimp_export_prepare_image (gint32 *image_ID,
gint32 *drawable_ID,
GimpExportCapabilities capabilities)
/**
* gimp_export_dialog_new:
* @format_name: The short name of the image_format (e.g. JPEG or PNG).
* @role: The dialog's @role which will be set with
* gtk_window_set_role().
* @help_id: The GIMP help id.
*
* Creates a new export dialog. All file plug-ins should use this
* dialog to get a consistent look on the export dialogs. Use
* gimp_export_dialog_get_content_area() to get a #GtkVBox to be
* filled with export options. The export dialog is a wrapped
* #GimpDialog.
*
* Returns: The new export dialog.
*
* Since: GIMP 2.8
**/
GtkWidget *
gimp_export_dialog_new (const gchar *format_name,
const gchar *role,
const gchar *help_id)
/**
* gimp_export_dialog_get_content_area:
* @dialog: A dialog created with gimp_export_dialog_new()
*
* Returns the #GtkVBox of the passed export dialog to be filled with
* export options.
*
* Returns: The #GtkVBox to fill with export options.
*
* Since: GIMP 2.8
**/
GtkWidget *
gimp_export_dialog_get_content_area (GtkWidget *dialog)
_______________________________________________
Gimp-developer mailing list
Gimp-developer@xxxxxxxxxxxxxxxxxxxxxx
https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-developer
