gimp/pdb/groups/brush_select.pdb

# 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/>.

# "Perlized" from C source by Manish Singh <yosh@gimp.org>

sub brushes_popup {
    $blurb = 'Invokes the Gimp brush selection.';
    $help  = 'This procedure opens the brush selection dialog.';

    &andy_pdb_misc('1998');

    @inargs = (
	{ name => 'brush_callback', type => 'string', non_empty => 1,
	  desc => 'The callback PDB proc to call when brush selection is
		   made' },
	{ name => 'popup_title', type => 'string',
	  desc => 'Title of the brush selection dialog' },
	{ name => 'initial_brush', type => 'string', null_ok => 1,
	  desc => 'The name of the brush to set as the first selected' },
	{ name => 'opacity', type => '0 <= float <= 100',
	  desc => 'The initial opacity of the brush' },
	{ name => 'spacing', type => 'int32 <= 1000',
	  desc => 'The initial spacing of the brush (if < 0 then use brush
                   default spacing)' },
	{ name => 'paint_mode', type => 'enum GimpLayerMode',
          default => 'GIMP_LAYER_MODE_NORMAL',
	  desc => 'The initial paint mode' }
    );

    %invoke = (
	code => <<'CODE'
{
  if (paint_mode == GIMP_LAYER_MODE_OVERLAY_LEGACY)
    paint_mode = GIMP_LAYER_MODE_SOFTLIGHT_LEGACY;

  if (gimp->no_interface ||
      ! gimp_pdb_lookup_procedure (gimp->pdb, brush_callback) ||
      ! gimp_pdb_dialog_new (gimp, context, progress,
                             gimp_data_factory_get_container (gimp->brush_factory),
                             popup_title, brush_callback, initial_brush,
                             "opacity",    opacity / 100.0,
                             "paint-mode", paint_mode,
                             "spacing",    spacing,
                             NULL))
    success = FALSE;
}
CODE
    );
}

sub brushes_close_popup {
    $blurb = 'Close the brush selection dialog.';
    $help  = 'This procedure closes an opened brush selection dialog.';

    &andy_pdb_misc('1998');

    @inargs = (
	{ name => 'brush_callback', type => 'string', non_empty => 1,
	  desc => 'The name of the callback registered for this pop-up' }
    );

    %invoke = (
	code => <<'CODE'
{
  if (gimp->no_interface ||
      ! gimp_pdb_lookup_procedure (gimp->pdb, brush_callback) ||
      ! gimp_pdb_dialog_close (gimp, gimp_data_factory_get_container (gimp->brush_factory),
                               brush_callback))
    success = FALSE;
}
CODE
    );
}

sub brushes_set_popup {
    $blurb = 'Sets the current brush in a brush selection dialog.';
    $help  = $blurb;

    &andy_pdb_misc('1998');

    @inargs = (
	{ name => 'brush_callback', type => 'string', non_empty => 1,
	  desc => 'The name of the callback registered for this pop-up' },
	{ name => 'brush_name', type => 'string',
	  desc => 'The name of the brush to set as selected' },
	{ name => 'opacity', type => '0 <= float <= 100',
	  desc => 'The initial opacity of the brush' },
	{ name => 'spacing', type => 'int32 <= 1000',
	  desc => 'The initial spacing of the brush (if < 0 then use brush
                   default spacing)' },
	{ name => 'paint_mode', type => 'enum GimpLayerMode',
          default => 'GIMP_LAYER_MODE_NORMAL',
	  desc => 'The initial paint mode' }
    );

    %invoke = (
	code => <<'CODE'
{
  if (paint_mode == GIMP_LAYER_MODE_OVERLAY_LEGACY)
    paint_mode = GIMP_LAYER_MODE_SOFTLIGHT_LEGACY;

  if (gimp->no_interface ||
      ! gimp_pdb_lookup_procedure (gimp->pdb, brush_callback) ||
      ! gimp_pdb_dialog_set (gimp, gimp_data_factory_get_container (gimp->brush_factory),
                             brush_callback, brush_name,
                             "opacity",    opacity / 100.0,
                             "paint-mode", paint_mode,
                             "spacing",    spacing,
                             NULL))
    success = FALSE;
}
CODE
    );
}


@headers = qw("core/gimp.h"
              "core/gimpdatafactory.h");

@procs = qw(brushes_popup
            brushes_close_popup
            brushes_set_popup);

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

$desc = 'Brush UI';
$doc_title = 'gimpbrushselect';
$doc_short_desc = 'Functions providing a brush selection dialog.';
$doc_long_desc = 'Functions providing a brush selection dialog.';

1;