Quelle  group_layer.pdb  Sprache: unbekannt

# GIMP - The GNU 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 3 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, see <https://www.gnu.org/licenses/>.


sub group_layer_new {
    $blurb = 'Create a new group layer.';

    $help = <<'HELP';
This procedure creates a new group layer with a given @name. If @name is
%NULL, GIMP will choose a name using its default layer name algorithm.


The new group layer still needs to be added to the image, as this is
not automatic. Add the new layer with the [method@Image.insert_layer]
method.

Other attributes such as layer mask, modes and offsets should be set
with explicit procedure calls.


Other procedures useful with group layers: [method@Image.reorder_item],
[method@Item.get_parent], [method@Item.get_children], [method@Item.is_group].
HELP

    &barak_pdb_misc('2010', '2.8');

    @inargs = (
 { name => 'image', type => 'image',
   desc => 'The image to which to add the group layer' },
 { name => 'name', type => 'string', none_ok => 1,
   desc => "The group layer name" }
    );

    @outargs = (
 { name => 'group_layer', type => 'group_layer',
   desc => 'The newly created group layer' }
    );
    %invoke = (
 code => <<'CODE'
{
  group_layer = GIMP_GROUP_LAYER (gimp_group_layer_new (image));

  if (! group_layer)
    {
      success = FALSE;
    }
  else if (name != NULL && strlen (name) > 0)
    {
      gimp_item_rename (GIMP_ITEM (group_layer), name, error);
    }
}
CODE
    );
}

sub group_layer_merge {
    $blurb = 'Merge the passed group layer\'s layers into one normal layer.';

    $help = <<'HELP';
This procedure combines the layers of the passed group layer into
a single normal layer, replacing the group.

The group layer is expected to be attached to an image.
HELP

    &ell_pdb_misc('2019', '2.10.14');

    @inargs = (
        { name => 'group_layer', type => 'group_layer',
          desc => 'The group layer to merge' },
    );

    @outargs = (
        { name => 'layer', type => 'layer',
          desc => 'The resulting layer' }
    );

    %invoke = (
        headers => [ qw("core/gimpimage-merge.h") ],
        code => <<'CODE'
{
  if (gimp_pdb_item_is_attached (GIMP_ITEM (group_layer), NULL, 0, error) &&
      gimp_pdb_item_is_group (GIMP_ITEM (group_layer), error))
    {
      GimpImage *image = gimp_item_get_image (GIMP_ITEM (group_layer));

      layer = gimp_image_merge_group_layer (image, group_layer);

      if (! layer)
        success = FALSE;
    }
  else
    success = FALSE;
}
CODE
    );
}
@headers = qw(<cairo.h>
              "libgimpbase/gimpbase.h"
              "core/gimp.h"
              "core/gimpgrouplayer.h"
              "gimppdb-utils.h"
              "gimp-intl.h");

@procs = qw(group_layer_new
            group_layer_merge);

%exports = (app => [@procs], lib => [@procs]);

$desc = 'Group Layer';
$doc_title = 'gimpgrouplayer';
$doc_short_desc = 'Operations on a group layer.';
$doc_long_desc = 'Operations on a group layer.';

1;