gimp/tools/pdbgen/pdb/message.pdb

# The GIMP -- an image manipulation program
# Copyright (C) 1998-1999 Manish Singh

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

sub message {
    $blurb = 'Displays a dialog box with a message.';

    $help = <<'HELP';
Displays a dialog box with a message. Useful for status or error reporting.
The message must be in UTF-8 encoding.
HELP

    &yosh_pdb_misc('1998');

    @inargs = (
	{ name => 'message', type => 'string',
	  desc => 'Message to display in the dialog' }
    );

    %invoke = (
        code => <<'CODE'
{
  if (gimp->current_plug_in)
    plug_in_progress_message (gimp->current_plug_in, message);
  else
    gimp_message (gimp, NULL, message);
}
CODE
    );
}

sub message_get_handler {
    $blurb = <<'BLURB';
Returns the current state of where warning messages are displayed.
BLURB

    $help = <<'HELP';
This procedure returns the way g_message warnings are displayed. They can be
shown in a dialog box or printed on the console where gimp was started.
HELP

    &yosh_pdb_misc('1998');

    @outargs = (
	{ name => 'handler', type => 'enum GimpMessageHandlerType',
	  desc => 'The current handler type: %%desc%%' }
    );

    %invoke = (
	code => <<'CODE'
{
  handler = gimp->message_handler;
}
CODE
    );
}

sub message_set_handler {
    $blurb = 'Controls where warning messages are displayed.';

    $help = <<'HELP';
This procedure controls how g_message warnings are displayed. They can be shown
in a dialog box or printed on the console where gimp was started.
HELP

    &yosh_pdb_misc('1998');

    @inargs = (
	{ name => 'handler', type => 'enum GimpMessageHandlerType',
	  desc => 'The new handler type: %%desc%%' }
    );

    %invoke = (
	code => <<'CODE'
{
  gimp->message_handler = handler;
}
CODE
    );
}


@headers = qw(<string.h> "core/gimp.h" "plug-in/plug-in.h"
              "plug-in/plug-in-progress.h" "gimp-intl.h");

@procs = qw(message message_get_handler message_set_handler);

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

$desc = 'Message procedures';

1;