PIKApp/pdb/groups/palette_select.pdb

# PIKA - Photo and Image Kooker Application
# 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 palettes_popup {
    $blurb = 'Invokes the Pika palette selection dialog.';
    $help  = 'Opens a dialog letting a user choose a palette.';

    &mitch_pdb_misc('2002');

    @inargs = (
      { name => 'palette_callback', type => 'string', non_empty => 1,
        desc => 'The callback PDB proc to call when user chooses a palette' },
      { name => 'popup_title', type => 'string',
        desc => 'Title of the palette selection dialog' },
      { name => 'initial_palette_name', type => 'string', null_ok => 1,
        desc => 'The name of the palette to set as the initial choice.' }
    );

    %invoke = (
	code => <<'CODE'
{
  if (pika->no_interface ||
      ! pika_pdb_lookup_procedure (pika->pdb, palette_callback) ||
      ! pika_pdb_dialog_new (pika, context, progress,
                             pika_data_factory_get_container (pika->palette_factory),
                             popup_title, palette_callback, initial_palette_name,
                             NULL))
    success = FALSE;
}
CODE
    );
}

sub palettes_close_popup {
    $blurb = 'Close the palette selection dialog.';
    $help  = 'Closes an open palette selection dialog.';

    &mitch_pdb_misc('2002');

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

    %invoke = (
	code => <<'CODE'
{
  if (pika->no_interface ||
      ! pika_pdb_lookup_procedure (pika->pdb, palette_callback) ||
      ! pika_pdb_dialog_close (pika, pika_data_factory_get_container (pika->palette_factory),
                               palette_callback))
    success = FALSE;
}
CODE
    );
}

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

    &mitch_pdb_misc('2002');

    @inargs = (
      { name => 'palette_callback', type => 'string', non_empty => 1,
        desc => 'The name of the callback registered for this pop-up' },
      { name => 'palette_name', type => 'string',
        desc => 'The name of the palette to set as selected' },
    );

    %invoke = (
	code => <<'CODE'
{
  if (pika->no_interface ||
      ! pika_pdb_lookup_procedure (pika->pdb, palette_callback) ||
      ! pika_pdb_dialog_set (pika, pika_data_factory_get_container (pika->palette_factory),
                             palette_callback, palette_name,
                             NULL))
    success = FALSE;
}
CODE
    );
}


@headers = qw("core/pika.h"
              "core/pikadatafactory.h");

@procs = qw(palettes_popup
            palettes_close_popup
            palettes_set_popup);

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

$desc = 'Palette UI';
$doc_title = 'pikapaletteselect';
$doc_short_desc = 'Methods of a palette chooser dialog';
$doc_long_desc = 'A dialog letting a user choose a palette.  Read more at pikafontselect.';

1;