d0ab9a7470
2004-10-27 Michael Natterer <mitch@gimp.org> * app/core/gimp-transform-utils.[ch]. switch from x1,y1,x2,y2 bounding boxes to x,y,width,height ones. Added gimp_transform_matrix_flip_free(). Renamed some parameters to be consistent with others. Some internal cleanup. * app/tools/gimpperspectivetool.c * app/tools/gimpscaletool.c * app/tools/gimpsheartool.c * tools/pdbgen/pdb/drawable_transform.pdb * tools/pdbgen/pdb/transform_tools.pdb: changed accordingly. * tools/pdbgen/pdb/drawable_transform.pdb * tools/pdbgen/pdb/transform_tools.pdb: guard all transform wrappers with if(gimp_drawable_mask_intersect(...)), also the ones which don't need the returned bounding box. * tools/pdbgen/pdb/drawable_transform.pdb: renamed some parameters and added gimp_drawable_transform_matrix() which takes the 9 coefficients of a 3x3 matrix for ultimate flexibility ;) * app/pdb/drawable_transform_cmds.c * app/pdb/internal_procs.c * app/pdb/transform_tools_cmds.c * libgimp/gimpdrawabletransform_pdb.[ch]: regenerated.
488 lines
16 KiB
Text
488 lines
16 KiB
Text
# The GIMP -- an image manipulation program
|
|
# Copyright (C) 1995 Spencer Kimball and Peter Mattis
|
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation; either version 2 of the License, or
|
|
# (at your option) any later version.
|
|
|
|
# This program 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 General Public License for more details.
|
|
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program; if not, write to the Free Software
|
|
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
|
|
# "Perlized" from C source by Manish Singh <yosh@gimp.org>
|
|
|
|
# Transform Tools
|
|
|
|
# shortcuts
|
|
|
|
sub drawable_arg () {{
|
|
name => 'drawable',
|
|
type => 'drawable',
|
|
desc => 'The affected drawable',
|
|
}}
|
|
|
|
sub drawable_out_arg {
|
|
my $type = shift;
|
|
my $arg = &drawable_arg;
|
|
$arg->{desc} = "The $type drawable";
|
|
$arg->{no_declare} = 1;
|
|
$arg;
|
|
}
|
|
|
|
|
|
# The defs
|
|
|
|
sub flip {
|
|
$blurb = <<'BLURB';
|
|
Flip the specified drawable about its center either vertically or
|
|
horizontally.
|
|
BLURB
|
|
|
|
$help = <<'HELP';
|
|
This tool flips the specified drawable if no selection exists. If a selection
|
|
exists, the portion of the drawable which lies under the selection is cut from
|
|
the drawable and made into a floating selection which is then flipd by the
|
|
specified amount. The return value is the ID of the flipped drawable. If there
|
|
was no selection, this will be equal to the drawable ID supplied as input.
|
|
Otherwise, this will be the newly created and flipped drawable. The flip type
|
|
parameter indicates whether the flip will be applied horizontally or
|
|
vertically.
|
|
HELP
|
|
|
|
&std_pdb_misc;
|
|
|
|
@inargs = (
|
|
&drawable_arg,
|
|
{ name => 'flip_type', type => &std_orientation_enum,
|
|
desc => 'Type of flip: %%desc%%' }
|
|
);
|
|
|
|
@outargs = ( &drawable_out_arg('flipped') );
|
|
|
|
%invoke = (
|
|
code => <<'CODE'
|
|
{
|
|
gint x, y, width, height;
|
|
|
|
success = gimp_item_is_attached (GIMP_ITEM (drawable));
|
|
|
|
if (success &&
|
|
gimp_drawable_mask_intersect (drawable, &x, &y, &width, &height))
|
|
{
|
|
success = gimp_drawable_transform_flip (drawable, context,
|
|
flip_type, TRUE, 0.0, FALSE);
|
|
}
|
|
}
|
|
CODE
|
|
);
|
|
}
|
|
|
|
sub perspective {
|
|
$blurb = <<'BLURB';
|
|
Perform a possibly non-affine transformation on the specified drawable.
|
|
BLURB
|
|
|
|
$help = <<'HELP';
|
|
This tool performs a possibly non-affine transformation on the specified
|
|
drawable by allowing the corners of the original bounding box to be arbitrarily
|
|
remapped to any values. The specified drawable is remapped if no selection
|
|
exists. However, if a selection exists, the portion of the drawable which lies
|
|
under the selection is cut from the drawable and made into a floating selection
|
|
which is then remapped as specified. The interpolation parameter can be set to
|
|
TRUE to indicate that either linear or cubic interpolation should be used to
|
|
smooth the resulting remapped drawable. The return value is the ID of the
|
|
remapped drawable. If there was no selection, this will be equal to the
|
|
drawable ID supplied as input. Otherwise, this will be the newly created and
|
|
remapped drawable. The 4 coordinates specify the new locations of each corner
|
|
of the original bounding box. By specifying these values, any affine
|
|
transformation (rotation, scaling, translation) can be affected. Additionally,
|
|
these values can be specified such that the resulting transformed drawable will
|
|
appear to have been projected via a perspective transform.
|
|
HELP
|
|
|
|
&std_pdb_misc;
|
|
|
|
@inargs = (
|
|
&drawable_arg,
|
|
{ name => 'interpolation', type => 'boolean',
|
|
desc => 'Whether to use interpolation' }
|
|
);
|
|
|
|
my $pos = 0;
|
|
foreach $where (qw(upper-left upper-right lower-left lower-right)) {
|
|
foreach (qw(x y)) {
|
|
push @inargs,
|
|
{ name => "$_$pos", type => 'float',
|
|
desc => "The new $_ coordinate of $where corner of original
|
|
bounding box",
|
|
alias => "trans_info[\U$_\E$pos]", no_declare => 1 }
|
|
}
|
|
$pos++;
|
|
}
|
|
|
|
@outargs = ( &drawable_out_arg('newly mapped') );
|
|
|
|
%invoke = (
|
|
vars => [ 'gdouble trans_info[8]' ],
|
|
code => <<'CODE'
|
|
{
|
|
gint x, y, width, height;
|
|
|
|
success = gimp_item_is_attached (GIMP_ITEM (drawable));
|
|
|
|
if (success &&
|
|
gimp_drawable_mask_intersect (drawable, &x, &y, &width, &height))
|
|
{
|
|
GimpMatrix3 matrix;
|
|
GimpInterpolationType interpolation_type = GIMP_INTERPOLATION_NONE;
|
|
|
|
/* Assemble the transformation matrix */
|
|
gimp_transform_matrix_perspective (x, y, width, height,
|
|
trans_info[X0], trans_info[Y0],
|
|
trans_info[X1], trans_info[Y1],
|
|
trans_info[X2], trans_info[Y2],
|
|
trans_info[X3], trans_info[Y3],
|
|
&matrix);
|
|
|
|
if (interpolation)
|
|
interpolation_type = gimp->config->interpolation_type;
|
|
|
|
if (progress)
|
|
gimp_progress_start (progress, _("Perspective..."), FALSE);
|
|
|
|
/* Perspective the selection */
|
|
success = gimp_drawable_transform_affine (drawable, context,
|
|
&matrix,
|
|
GIMP_TRANSFORM_FORWARD,
|
|
interpolation_type, TRUE, 3,
|
|
FALSE, progress);
|
|
|
|
if (progress)
|
|
gimp_progress_end (progress);
|
|
}
|
|
}
|
|
CODE
|
|
);
|
|
}
|
|
|
|
sub rotate {
|
|
$blurb = <<'BLURB';
|
|
Rotate the specified drawable about its center through the specified angle.
|
|
BLURB
|
|
|
|
$help = <<'HELP';
|
|
This tool rotates the specified drawable if no selection exists. If a selection
|
|
exists, the portion of the drawable which lies under the selection is cut from
|
|
the drawable and made into a floating selection which is then rotated by the
|
|
specified amount. The interpolation parameter can be set to TRUE to indicate
|
|
that either linear or cubic interpolation should be used to smooth the
|
|
resulting rotated drawable. The return value is the ID of the rotated drawable.
|
|
If there was no selection, this will be equal to the drawable ID supplied as
|
|
input. Otherwise, this will be the newly created and rotated drawable.
|
|
HELP
|
|
|
|
&std_pdb_misc;
|
|
|
|
@inargs = (
|
|
&drawable_arg,
|
|
{ name => 'interpolation', type => 'boolean',
|
|
desc => 'Whether to use interpolation' },
|
|
{ name => 'angle', type => 'float',
|
|
desc => 'The angle of rotation (radians)' }
|
|
);
|
|
|
|
@outargs = ( &drawable_out_arg('rotated') );
|
|
|
|
%invoke = (
|
|
code => <<'CODE'
|
|
{
|
|
gint x, y, width, height;
|
|
|
|
success = gimp_item_is_attached (GIMP_ITEM (drawable));
|
|
|
|
if (success &&
|
|
gimp_drawable_mask_intersect (drawable, &x, &y, &width, &height))
|
|
{
|
|
GimpMatrix3 matrix;
|
|
GimpInterpolationType interpolation_type = GIMP_INTERPOLATION_NONE;
|
|
|
|
/* Assemble the transformation matrix */
|
|
gimp_transform_matrix_rotate (x, y, width, height,
|
|
angle, &matrix);
|
|
|
|
if (interpolation)
|
|
interpolation_type = gimp->config->interpolation_type;
|
|
|
|
if (progress)
|
|
gimp_progress_start (progress, _("Rotating..."), FALSE);
|
|
|
|
/* Rotate the selection */
|
|
success = gimp_drawable_transform_affine (drawable, context,
|
|
&matrix,
|
|
GIMP_TRANSFORM_FORWARD,
|
|
interpolation_type, FALSE, 3,
|
|
FALSE, progress);
|
|
|
|
if (progress)
|
|
gimp_progress_end (progress);
|
|
}
|
|
}
|
|
CODE
|
|
);
|
|
}
|
|
|
|
sub scale {
|
|
$blurb = 'Scale the specified drawable.';
|
|
|
|
$help = <<'HELP';
|
|
This tool scales the specified drawable if no selection exists. If a selection
|
|
exists, the portion of the drawable which lies under the selection is cut from
|
|
the drawable and made into a floating selection which is then scaled by the
|
|
specified amount. The interpolation parameter can be set to TRUE to indicate
|
|
that either linear or cubic interpolation should be used to smooth the
|
|
resulting scaled drawable. The return value is the ID of the scaled drawable.
|
|
If there was no selection, this will be equal to the drawable ID supplied as
|
|
input. Otherwise, this will be the newly created and scaled drawable.
|
|
HELP
|
|
|
|
&std_pdb_misc;
|
|
|
|
@inargs = (
|
|
&drawable_arg,
|
|
{ name => 'interpolation', type => 'boolean',
|
|
desc => 'Whether to use interpolation' }
|
|
);
|
|
|
|
my $pos = 0;
|
|
foreach $where (qw(upper-left lower-right)) {
|
|
foreach (qw(x y)) {
|
|
push @inargs,
|
|
{ name => "$_$pos", type => 'float',
|
|
desc => "The new $_ coordinate of $where corner of newly
|
|
scaled region",
|
|
alias => "trans_info[\U$_\E$pos]", no_declare => 1 }
|
|
}
|
|
$pos++;
|
|
}
|
|
|
|
@outargs = ( &drawable_out_arg('scaled') );
|
|
|
|
%invoke = (
|
|
vars => [ 'gdouble trans_info[4]' ],
|
|
code => <<'CODE'
|
|
{
|
|
gint x, y, width, height;
|
|
|
|
success = (gimp_item_is_attached (GIMP_ITEM (drawable)) &&
|
|
trans_info[X0] < trans_info[X1] &&
|
|
trans_info[Y0] < trans_info[X1]);
|
|
|
|
if (success &&
|
|
gimp_drawable_mask_intersect (drawable, &x, &y, &width, &height))
|
|
{
|
|
GimpMatrix3 matrix;
|
|
GimpInterpolationType interpolation_type = GIMP_INTERPOLATION_NONE;
|
|
|
|
/* Assemble the transformation matrix */
|
|
gimp_transform_matrix_scale (x, y, width, height,
|
|
trans_info[X0],
|
|
trans_info[Y0],
|
|
trans_info[X1] - trans_info[X0],
|
|
trans_info[Y1] - trans_info[Y0],
|
|
&matrix);
|
|
|
|
if (interpolation)
|
|
interpolation_type = gimp->config->interpolation_type;
|
|
|
|
if (progress)
|
|
gimp_progress_start (progress, _("Scaling..."), FALSE);
|
|
|
|
/* Scale the selection */
|
|
success = gimp_drawable_transform_affine (drawable, context,
|
|
&matrix,
|
|
GIMP_TRANSFORM_FORWARD,
|
|
interpolation_type, TRUE, 3,
|
|
FALSE, progress);
|
|
|
|
if (progress)
|
|
gimp_progress_end (progress);
|
|
}
|
|
}
|
|
CODE
|
|
);
|
|
}
|
|
|
|
sub shear {
|
|
$blurb = <<'BLURB';
|
|
Shear the specified drawable about its center by the specified magnitude.
|
|
BLURB
|
|
|
|
$help = <<'HELP';
|
|
This tool shears the specified drawable if no selection exists. If a selection
|
|
exists, the portion of the drawable which lies under the selection is cut from
|
|
the drawable and made into a floating selection which is then sheard by the
|
|
specified amount. The interpolation parameter can be set to TRUE to indicate
|
|
that either linear or cubic interpolation should be used to smooth the
|
|
resulting sheared drawable. The return value is the ID of the sheard drawable.
|
|
If there was no selection, this will be equal to the drawable ID supplied as
|
|
input. Otherwise, this will be the newly created and sheard drawable. The shear
|
|
type parameter indicates whether the shear will be applied horizontally or
|
|
vertically. The magnitude can be either positive or negative and indicates the
|
|
extent (in pixels) to shear by.
|
|
HELP
|
|
|
|
&std_pdb_misc;
|
|
|
|
@inargs = (
|
|
&drawable_arg,
|
|
{ name => 'interpolation', type => 'boolean',
|
|
desc => 'Whether to use interpolation' },
|
|
{ name => 'shear_type', type => &std_orientation_enum,
|
|
desc => 'Type of shear: %%desc%%' },
|
|
{ name => 'magnitude', type => 'float',
|
|
desc => 'The magnitude of the shear' }
|
|
);
|
|
|
|
@outargs = ( &drawable_out_arg('sheared') );
|
|
|
|
%invoke = (
|
|
code => <<'CODE'
|
|
{
|
|
gint x, y, width, height;
|
|
|
|
success = gimp_item_is_attached (GIMP_ITEM (drawable));
|
|
|
|
if (success &&
|
|
gimp_drawable_mask_intersect (drawable, &x, &y, &width, &height))
|
|
{
|
|
GimpMatrix3 matrix;
|
|
GimpInterpolationType interpolation_type = GIMP_INTERPOLATION_NONE;
|
|
|
|
/* Assemble the transformation matrix */
|
|
gimp_transform_matrix_shear (x, y, width, height,
|
|
shear_type, magnitude,
|
|
&matrix);
|
|
|
|
if (interpolation)
|
|
interpolation_type = gimp->config->interpolation_type;
|
|
|
|
if (progress)
|
|
gimp_progress_start (progress, _("Shearing..."), FALSE);
|
|
|
|
/* Shear the selection */
|
|
success = gimp_drawable_transform_affine (drawable, context,
|
|
&matrix,
|
|
GIMP_TRANSFORM_FORWARD,
|
|
interpolation_type, FALSE, 3,
|
|
FALSE, progress);
|
|
|
|
if (progress)
|
|
gimp_progress_end (progress);
|
|
}
|
|
}
|
|
CODE
|
|
);
|
|
}
|
|
|
|
sub transform_2d {
|
|
$blurb = <<'BLURB';
|
|
Transform the specified drawable in 2d.
|
|
BLURB
|
|
|
|
$help = <<'HELP';
|
|
This tool transforms the specified drawable if no selection exists. If a
|
|
selection exists, the portion of the drawable which lies under the
|
|
selection is cut from the drawable and made into a floating selection which
|
|
is then transformed. The interpolation parameter can be set to TRUE to
|
|
indicate that either linear or cubic interpolation should be used to smooth
|
|
the resulting drawable. The transformation is done by scaling the image by
|
|
the x and y scale factors about the point (source_x, source_y), then rotating
|
|
around the same point, then translating that point to the new position
|
|
(dest_x, dest_y). The return value is the ID of the rotated drawable. If
|
|
there was no selection, this will be equal to the drawable ID supplied as
|
|
input. Otherwise, this will be the newly created and transformed drawable.
|
|
HELP
|
|
|
|
&std_pdb_misc;
|
|
|
|
@inargs = (
|
|
&drawable_arg,
|
|
{ name => 'interpolation', type => 'boolean',
|
|
desc => 'Whether to use interpolation' },
|
|
{ name => 'source_x', type => 'float',
|
|
desc => 'X coordinate of the transformation center' },
|
|
{ name => 'source_y', type => 'float',
|
|
desc => 'Y coordinate of the transformation center' },
|
|
{ name => 'scale_x', type => 'float',
|
|
desc => 'Amount to scale in x direction' },
|
|
{ name => 'scale_y', type => 'float',
|
|
desc => 'Amount to scale in y direction' },
|
|
{ name => 'angle', type => 'float',
|
|
desc => 'The angle of rotation (radians)' },
|
|
{ name => 'dest_x', type => 'float',
|
|
desc => 'X coordinate of where the centre goes' },
|
|
{ name => 'dest_y', type => 'float',
|
|
desc => 'Y coordinate of where the centre goes' }
|
|
);
|
|
|
|
@outargs = ( &drawable_out_arg('transformed') );
|
|
|
|
%invoke = (
|
|
code => <<'CODE'
|
|
{
|
|
gint x, y, width, height;
|
|
|
|
success = gimp_item_is_attached (GIMP_ITEM (drawable));
|
|
|
|
if (success &&
|
|
gimp_drawable_mask_intersect (drawable, &x, &y, &width, &height))
|
|
{
|
|
GimpMatrix3 matrix;
|
|
GimpInterpolationType interpolation_type = GIMP_INTERPOLATION_NONE;
|
|
|
|
/* Assemble the transformation matrix */
|
|
gimp_matrix3_identity (&matrix);
|
|
gimp_matrix3_translate (&matrix, -source_x, -source_y);
|
|
gimp_matrix3_scale (&matrix, scale_x, scale_y);
|
|
gimp_matrix3_rotate (&matrix, angle);
|
|
gimp_matrix3_translate (&matrix, dest_x, dest_y);
|
|
|
|
if (interpolation)
|
|
interpolation_type = gimp->config->interpolation_type;
|
|
|
|
if (progress)
|
|
gimp_progress_start (progress, _("2D Transform..."), FALSE);
|
|
|
|
/* Transform the selection */
|
|
success = gimp_drawable_transform_affine (drawable, context,
|
|
&matrix, GIMP_TRANSFORM_FORWARD,
|
|
interpolation_type, TRUE, 3,
|
|
FALSE, progress);
|
|
|
|
if (progress)
|
|
gimp_progress_end (progress);
|
|
}
|
|
}
|
|
CODE
|
|
);
|
|
}
|
|
|
|
@headers = qw("libgimpmath/gimpmath.h" "config/gimpcoreconfig.h"
|
|
"core/gimp.h" "core/gimp-transform-utils.h" "core/gimpimage.h"
|
|
"core/gimpdrawable.h" "core/gimpdrawable-transform.h"
|
|
"core/gimpprogress.h"
|
|
"gimp-intl.h");
|
|
|
|
@procs = qw(flip perspective rotate scale shear transform_2d);
|
|
|
|
%exports = (app => [@procs], lib => [@procs]);
|
|
|
|
$desc = 'Transform Tool procedures';
|
|
|
|
1;
|