647ebffe7b
This implied a lot of other core changes, which also pushed me into improving some of the edit actions and PDB calls to be multi-layer aware in the same time. Note that it is still work-in-progress, but I just had to commit something in an acceptable intermediate state otherwise I was just going crazy. In particular now the various transform tools are multi-layer aware and work simultaneously on all selected layers (and the linked layers if any of the selected layers is linked too). Both preview and final transform processing works. In the limitations, preview doesn't work well (only one layer in the preview) when there is a selection (though the actual transform works). Also I am left to wonder how we should process this case of canvas selection+transform on multi-layers. Indeed currently I am just creating a floating selection (like we used to for the selection+transform case) containing a transform result of the composited version of all selected layers. This is a possible expected result, but another could be to get several transformed layers (without composition). But then should the "Floating Selection" concept allow for multiple Floating Selections? Sooo many questions left to answer.
475 lines
16 KiB
C
475 lines
16 KiB
C
/* LIBGIMP - The GIMP Library
|
|
* Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
|
|
*
|
|
* gimpedit_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 3 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, see
|
|
* <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/* NOTE: This file is auto-generated by pdbgen.pl */
|
|
|
|
#include "config.h"
|
|
|
|
#include "gimp.h"
|
|
|
|
|
|
/**
|
|
* SECTION: gimpedit
|
|
* @title: gimpedit
|
|
* @short_description: Edit menu functions (cut, copy, paste, clear, etc.)
|
|
*
|
|
* Edit menu functions (cut, copy, paste, clear, etc.)
|
|
**/
|
|
|
|
|
|
/**
|
|
* gimp_edit_cut:
|
|
* @num_drawables: The number of drawables.
|
|
* @drawables: (array length=num_drawables) (element-type GimpItem): The drawables to cut from.
|
|
*
|
|
* Cut from the specified drawables.
|
|
*
|
|
* If there is a selection in the image, then the area specified by the
|
|
* selection is cut from the specified drawables and placed in an
|
|
* internal GIMP edit buffer. It can subsequently be retrieved using
|
|
* the gimp_edit_paste() command. If there is no selection and only one
|
|
* specified drawable, then the specified drawable will be removed and
|
|
* its contents stored in the internal GIMP edit buffer. This procedure
|
|
* will fail if the selected area lies completely outside the bounds of
|
|
* the current drawables and there is nothing to cut from.
|
|
*
|
|
* Returns: TRUE if the cut was successful, FALSE if there was nothing to copy from.
|
|
**/
|
|
gboolean
|
|
gimp_edit_cut (gint num_drawables,
|
|
const GimpItem **drawables)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean non_empty = FALSE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
G_TYPE_INT, num_drawables,
|
|
GIMP_TYPE_OBJECT_ARRAY, NULL,
|
|
G_TYPE_NONE);
|
|
gimp_value_set_object_array (gimp_value_array_index (args, 1), GIMP_TYPE_ITEM, (GObject **) drawables, num_drawables);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-edit-cut",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
non_empty = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return non_empty;
|
|
}
|
|
|
|
/**
|
|
* gimp_edit_copy:
|
|
* @num_drawables: The number of drawables to save.
|
|
* @drawables: (array length=num_drawables) (element-type GimpItem): Drawables to copy from.
|
|
*
|
|
* Copy from the specified drawables.
|
|
*
|
|
* If there is a selection in the image, then the area specified by the
|
|
* selection is copied from the specified drawables and placed in an
|
|
* internal GIMP edit buffer. It can subsequently be retrieved using
|
|
* the gimp_edit_paste() command. If there is no selection, then the
|
|
* specified drawables' contents will be stored in the internal GIMP
|
|
* edit buffer. This procedure will fail if the selected area lies
|
|
* completely outside the bounds of the current drawables and there is
|
|
* nothing to copy from. All the drawables must belong to the same
|
|
* image.
|
|
*
|
|
* Returns: TRUE if the cut was successful, FALSE if there was nothing to copy from.
|
|
**/
|
|
gboolean
|
|
gimp_edit_copy (gint num_drawables,
|
|
const GimpItem **drawables)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean non_empty = FALSE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
G_TYPE_INT, num_drawables,
|
|
GIMP_TYPE_OBJECT_ARRAY, NULL,
|
|
G_TYPE_NONE);
|
|
gimp_value_set_object_array (gimp_value_array_index (args, 1), GIMP_TYPE_ITEM, (GObject **) drawables, num_drawables);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-edit-copy",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
non_empty = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return non_empty;
|
|
}
|
|
|
|
/**
|
|
* gimp_edit_copy_visible:
|
|
* @image: The image to copy from.
|
|
*
|
|
* Copy from the projection.
|
|
*
|
|
* If there is a selection in the image, then the area specified by the
|
|
* selection is copied from the projection and placed in an internal
|
|
* GIMP edit buffer. It can subsequently be retrieved using the
|
|
* gimp_edit_paste() command. If there is no selection, then the
|
|
* projection's contents will be stored in the internal GIMP edit
|
|
* buffer.
|
|
*
|
|
* Returns: TRUE if the copy was successful.
|
|
*
|
|
* Since: 2.2
|
|
**/
|
|
gboolean
|
|
gimp_edit_copy_visible (GimpImage *image)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gboolean non_empty = FALSE;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_IMAGE, image,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-edit-copy-visible",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
non_empty = GIMP_VALUES_GET_BOOLEAN (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return non_empty;
|
|
}
|
|
|
|
/**
|
|
* gimp_edit_paste:
|
|
* @drawable: The drawable to paste to.
|
|
* @paste_into: Clear selection, or paste behind it?
|
|
*
|
|
* Paste buffer to the specified drawable.
|
|
*
|
|
* This procedure pastes a copy of the internal GIMP edit buffer to the
|
|
* specified drawable. The GIMP edit buffer will be empty unless a call
|
|
* was previously made to either gimp_edit_cut() or gimp_edit_copy().
|
|
* The \"paste_into\" option specifies whether to clear the current
|
|
* image selection, or to paste the buffer \"behind\" the selection.
|
|
* This allows the selection to act as a mask for the pasted buffer.
|
|
* Anywhere that the selection mask is non-zero, the pasted buffer will
|
|
* show through. The pasted buffer will be a new layer in the image
|
|
* which is designated as the image floating selection. If the image
|
|
* has a floating selection at the time of pasting, the old floating
|
|
* selection will be anchored to its drawable before the new floating
|
|
* selection is added. This procedure returns the new floating layer.
|
|
* The resulting floating selection will already be attached to the
|
|
* specified drawable, and a subsequent call to floating_sel_attach is
|
|
* not needed.
|
|
*
|
|
* Returns: (transfer none): The new floating selection.
|
|
**/
|
|
GimpLayer *
|
|
gimp_edit_paste (GimpDrawable *drawable,
|
|
gboolean paste_into)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpLayer *floating_sel = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_DRAWABLE, drawable,
|
|
G_TYPE_BOOLEAN, paste_into,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-edit-paste",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
floating_sel = GIMP_VALUES_GET_LAYER (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return floating_sel;
|
|
}
|
|
|
|
/**
|
|
* gimp_edit_paste_as_new_image:
|
|
*
|
|
* Paste buffer to a new image.
|
|
*
|
|
* This procedure pastes a copy of the internal GIMP edit buffer to a
|
|
* new image. The GIMP edit buffer will be empty unless a call was
|
|
* previously made to either gimp_edit_cut() or gimp_edit_copy(). This
|
|
* procedure returns the new image or -1 if the edit buffer was empty.
|
|
*
|
|
* Returns: (transfer none): The new image.
|
|
*
|
|
* Since: 2.10
|
|
**/
|
|
GimpImage *
|
|
gimp_edit_paste_as_new_image (void)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpImage *image = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-edit-paste-as-new-image",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
image = GIMP_VALUES_GET_IMAGE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return image;
|
|
}
|
|
|
|
/**
|
|
* gimp_edit_named_cut:
|
|
* @num_drawables: The number of drawables.
|
|
* @drawables: (array length=num_drawables) (element-type GimpItem): The drawables to cut from.
|
|
* @buffer_name: The name of the buffer to create.
|
|
*
|
|
* Cut into a named buffer.
|
|
*
|
|
* This procedure works like gimp_edit_cut(), but additionally stores
|
|
* the cut buffer into a named buffer that will stay available for
|
|
* later pasting, regardless of any intermediate copy or cut
|
|
* operations.
|
|
*
|
|
* Returns: (transfer full):
|
|
* The real name given to the buffer, or NULL if the cut failed.
|
|
* The returned value must be freed with g_free().
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gchar *
|
|
gimp_edit_named_cut (gint num_drawables,
|
|
const GimpItem **drawables,
|
|
const gchar *buffer_name)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gchar *real_name = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
G_TYPE_INT, num_drawables,
|
|
GIMP_TYPE_OBJECT_ARRAY, NULL,
|
|
G_TYPE_STRING, buffer_name,
|
|
G_TYPE_NONE);
|
|
gimp_value_set_object_array (gimp_value_array_index (args, 1), GIMP_TYPE_ITEM, (GObject **) drawables, num_drawables);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-edit-named-cut",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
real_name = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return real_name;
|
|
}
|
|
|
|
/**
|
|
* gimp_edit_named_copy:
|
|
* @num_drawables: The number of drawables.
|
|
* @drawables: (array length=num_drawables) (element-type GimpItem): The drawables to copy from.
|
|
* @buffer_name: The name of the buffer to create.
|
|
*
|
|
* Copy into a named buffer.
|
|
*
|
|
* This procedure works like gimp_edit_copy(), but additionally stores
|
|
* the copied buffer into a named buffer that will stay available for
|
|
* later pasting, regardless of any intermediate copy or cut
|
|
* operations.
|
|
*
|
|
* Returns: (transfer full):
|
|
* The real name given to the buffer, or NULL if the copy failed.
|
|
* The returned value must be freed with g_free().
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gchar *
|
|
gimp_edit_named_copy (gint num_drawables,
|
|
const GimpItem **drawables,
|
|
const gchar *buffer_name)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gchar *real_name = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
G_TYPE_INT, num_drawables,
|
|
GIMP_TYPE_OBJECT_ARRAY, NULL,
|
|
G_TYPE_STRING, buffer_name,
|
|
G_TYPE_NONE);
|
|
gimp_value_set_object_array (gimp_value_array_index (args, 1), GIMP_TYPE_ITEM, (GObject **) drawables, num_drawables);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-edit-named-copy",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
real_name = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return real_name;
|
|
}
|
|
|
|
/**
|
|
* gimp_edit_named_copy_visible:
|
|
* @image: The image to copy from.
|
|
* @buffer_name: The name of the buffer to create.
|
|
*
|
|
* Copy from the projection into a named buffer.
|
|
*
|
|
* This procedure works like gimp_edit_copy_visible(), but additionally
|
|
* stores the copied buffer into a named buffer that will stay
|
|
* available for later pasting, regardless of any intermediate copy or
|
|
* cut operations.
|
|
*
|
|
* Returns: (transfer full):
|
|
* The real name given to the buffer, or NULL if the copy failed.
|
|
* The returned value must be freed with g_free().
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gchar *
|
|
gimp_edit_named_copy_visible (GimpImage *image,
|
|
const gchar *buffer_name)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
gchar *real_name = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_IMAGE, image,
|
|
G_TYPE_STRING, buffer_name,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-edit-named-copy-visible",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
real_name = GIMP_VALUES_DUP_STRING (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return real_name;
|
|
}
|
|
|
|
/**
|
|
* gimp_edit_named_paste:
|
|
* @drawable: The drawable to paste to.
|
|
* @buffer_name: The name of the buffer to paste.
|
|
* @paste_into: Clear selection, or paste behind it?
|
|
*
|
|
* Paste named buffer to the specified drawable.
|
|
*
|
|
* This procedure works like gimp_edit_paste() but pastes a named
|
|
* buffer instead of the global buffer.
|
|
*
|
|
* Returns: (transfer none): The new floating selection.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
GimpLayer *
|
|
gimp_edit_named_paste (GimpDrawable *drawable,
|
|
const gchar *buffer_name,
|
|
gboolean paste_into)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpLayer *floating_sel = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
GIMP_TYPE_DRAWABLE, drawable,
|
|
G_TYPE_STRING, buffer_name,
|
|
G_TYPE_BOOLEAN, paste_into,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-edit-named-paste",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
floating_sel = GIMP_VALUES_GET_LAYER (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return floating_sel;
|
|
}
|
|
|
|
/**
|
|
* gimp_edit_named_paste_as_new_image:
|
|
* @buffer_name: The name of the buffer to paste.
|
|
*
|
|
* Paste named buffer to a new image.
|
|
*
|
|
* This procedure works like gimp_edit_paste_as_new_image() but pastes
|
|
* a named buffer instead of the global buffer.
|
|
*
|
|
* Returns: (transfer none): The new image.
|
|
*
|
|
* Since: 2.10
|
|
**/
|
|
GimpImage *
|
|
gimp_edit_named_paste_as_new_image (const gchar *buffer_name)
|
|
{
|
|
GimpValueArray *args;
|
|
GimpValueArray *return_vals;
|
|
GimpImage *image = NULL;
|
|
|
|
args = gimp_value_array_new_from_types (NULL,
|
|
G_TYPE_STRING, buffer_name,
|
|
G_TYPE_NONE);
|
|
|
|
return_vals = gimp_pdb_run_procedure_array (gimp_get_pdb (),
|
|
"gimp-edit-named-paste-as-new-image",
|
|
args);
|
|
gimp_value_array_unref (args);
|
|
|
|
if (GIMP_VALUES_GET_ENUM (return_vals, 0) == GIMP_PDB_SUCCESS)
|
|
image = GIMP_VALUES_GET_IMAGE (return_vals, 1);
|
|
|
|
gimp_value_array_unref (return_vals);
|
|
|
|
return image;
|
|
}
|