# 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 .
# "Perlized" from C source by Manish Singh
sub patterns_refresh {
$blurb = 'Refresh current patterns. This function always succeeds.';
$help = <<'HELP';
This procedure retrieves all patterns currently in the user's pattern path
and updates all pattern dialogs accordingly.
HELP
&mitch_pdb_misc('2002');
%invoke = (
code => <<'CODE'
{
gimp_data_factory_data_refresh (gimp->pattern_factory, context);
}
CODE
);
}
sub patterns_get_list {
$blurb = 'Retrieve a complete listing of the available patterns.';
$help = <<'HELP';
This procedure returns a complete listing of available GIMP patterns. Each name
returned can be used as input to the gimp_context_set_pattern().
HELP
&std_pdb_misc;
@inargs = (
{ name => 'filter', type => 'string', null_ok => 1,
desc => 'An optional regular expression used to filter the list' }
);
@outargs = (
{ name => 'pattern_list', type => 'stringarray',
desc => 'The list of pattern names',
array => { name => 'num_patterns',
desc => 'The number of patterns in the pattern list' } }
);
%invoke = (
headers => [ qw("core/gimpcontainer-filter.h") ],
code => <<'CODE'
{
pattern_list = gimp_container_get_filtered_name_array (gimp_data_factory_get_container (gimp->pattern_factory),
filter, &num_patterns);
}
CODE
);
}
sub patterns_get_pattern {
&std_pdb_deprecated ('gimp-context-get-pattern');
@outargs = (
{ name => 'name', type => 'string',
desc => 'The pattern name' },
{ name => 'width', type => 'int32',
desc => 'The pattern width' },
{ name => 'height', type => 'int32',
desc => 'The pattern height' }
);
%invoke = (
code => <<'CODE'
{
GimpPattern *pattern = gimp_context_get_pattern (context);
if (pattern)
{
name = g_strdup (gimp_object_get_name (pattern));
width = gimp_temp_buf_get_width (pattern->mask);
height = gimp_temp_buf_get_height (pattern->mask);
}
else
success = FALSE;
}
CODE
);
}
sub patterns_get_pattern_data {
&std_pdb_deprecated ('gimp-pattern-get-pixels');
@inargs = (
{ name => 'name', type => 'string', null_ok => 1,
desc => 'The pattern name ("" means currently active pattern)' }
);
@outargs = (
{ name => 'actual_name', type => 'string',
desc => 'The pattern name' },
{ name => 'width', type => 'int32',
desc => 'The pattern width' },
{ name => 'height', type => 'int32',
desc => 'The pattern height' },
{ name => 'mask_bpp', type => 'int32',
desc => 'Pattern bytes per pixel' },
{ name => 'mask_data', type => 'int8array',
desc => 'The pattern mask data',
array => { name => 'length',
desc => 'Length of pattern mask data' } }
);
%invoke = (
code => <<'CODE'
{
GimpPattern *pattern;
if (name && strlen (name))
pattern = gimp_pdb_get_pattern (gimp, name, error);
else
pattern = gimp_context_get_pattern (context);
if (pattern)
{
actual_name = g_strdup (gimp_object_get_name (pattern));
width = gimp_temp_buf_get_width (pattern->mask);
height = gimp_temp_buf_get_height (pattern->mask);
mask_bpp = babl_format_get_bytes_per_pixel (gimp_temp_buf_get_format (pattern->mask));
length = gimp_temp_buf_get_data_size (pattern->mask);
mask_data = g_memdup (gimp_temp_buf_get_data (pattern->mask), length);
}
else
success = FALSE;
}
CODE
);
}
@headers = qw(
"core/gimp.h"
"core/gimpcontext.h"
"core/gimpdatafactory.h"
"core/gimppattern.h"
"core/gimptempbuf.h"
"gimppdb-utils.h");
@procs = qw(patterns_refresh
patterns_get_list
patterns_get_pattern
patterns_get_pattern_data);
%exports = (app => [@procs], lib => [@procs]);
$desc = 'Patterns';
$doc_title = 'gimppatterns';
$doc_short_desc = 'Functions relating to patterns.';
$doc_long_desc = 'Functions relating to patterns.';
1;