Free gimp feature 1.211 software for linux

Gimp::Fu is a "easy to use" framework for Gimp scripts.

SYNOPSIS

use Gimp;
use Gimp::Fu;

(this module uses Gtk, so make sure its correctly installed)

Currently, there are only three functions in this module. This fully suffices to provide a professional interface and the ability to run this script from within the Gimp and standalone from the commandline.

In general, a Gimp::Fu script looks like this:

#!/path/to/your/perl

use Gimp;
use Gimp::Fu;

register , sub {
your code;
}

exit main;

(This distribution comes with example scripts. One is examples/example-fu.pl, which is small Gimp::Fu-script you can take as starting point for your experiments)

Gimp::Data is a Perl module to set and get state data.

SYNOPSIS

use Gimp::Data;

$Gimp::Data{value1} = "Hello";
print $Gimp::Data{value1},", World!!n";

With this module, you can access plugin-specific (or global) data in Gimp, i.e. you can store and retrieve values that are stored in the main Gimp application.

An example would be to save parameter values in Gimp, so that on subsequent invocations of your plug-in, the user does not have to set all parameter values again (Gimp::Fu does this already).

Gimp::Compat is a Perl module with compatibility functions for older versions of Gimp.

SYNOPSIS

< loaded automatically on demand >

Older versions of Gimp (version 1.0 at the time of this writing) lack some very important or useful functions.

This module is providing the most needed replacement functions. If you happen to miss a function then please create a replacement function and send it to me ;)
These functions are handled in exactly the same way as PDB-Functions, i.e. the (hypothetical) function gimp_image_xyzzy can be called as $image->xyzzy, if the module is available.

FUNCTIONS

gimp_text_fontname, gimp_get_extents_fontname

These are emulated in 1.0.

gimp_paintbrush

The last two arguments only available in 1.1 are simply dropped.

Gimp::Util is a Perl module to some handy routines for Gimp-Perl users.

SYNOPSIS

use Gimp;
use Gimp::Util;

Gimp-Perl is nice, but when you have to write everytime 10 lines just to get some simple functions done, it very quickly becomes tedious :-/

This module tries to define some functions that aim to automate frequently used tasks, i.e. its a sort of catch-all-bag for (possibly) useful macro functions. If you want to add a function just mail the author of the Gimp-Perl extension (see below).

In Gimp-Perl (but not in Gimp as seen by the enduser) it is possible to have layers that are NOT attached to an image. This is, IMHO a bad idea, you end up with them and the user cannot see them or delete them. So we always attach our created layers to an image here, too avoid memory leaks and debugging times.

These functions try to preserve the current settings like colors, but not all do.

These functions can also be handled in exactly the same way as PDB-Functions, i.e. the (hypothetical) function gimp_image_xyzzy can be called as $image->xyzzy, if the module is available.

The need to explicitly use Gimp::Util will go away in the future.

FUNCTIONS

get_state (), set_state state

get_state returns a scalar representing most of gimps global state (at the moment foreground colour, background colour, active gradient, pattern and brush). The state can later be restored by a call to set_state. This is ideal for library functions such as the ones used here, at least when it includes more state in the future.

layer_create image,name,color,pos

create a colored layer, insert into image and return layer

text_draw image,layer,text,font,size,fgcolor

Create a colored text, draw over a background, add to img, ret img.

image_create_text text,font,size,fgcolor,bgcolor

Create an image, add colored text layer on a background layer, return img.

layer_add_layer_as_mask image,layer,layermask

Take a layer and add it as a mask to another layer, return mask.

gimp_text_wh $text,$fontname

returns the width and height of the "$text" of the given font (XLFD format)

gimp_image_layertype $alpha

returns the corresponding layer type for an image, alpha controls wether the layer type is with alpha or not. Example: imagetype: RGB -> RGB_IMAGE (or RGBA_IMAGE).

gimp_layer2imagetype $layertype

returns the corresponding layer type for an image, alpha controls wether the layer type is with alpha or not. Example: imagetype: RGB -> RGB_IMAGE (or RGBA_IMAGE).

gimp_image_add_new_layer $image,$index,$fill_type,$alpha

creates a new layer and adds it at position $index (default 0) to the image, after filling it with gimp_drawable_fill $fill_type (default BG_IMAGE_FILL). If $alpha is non-zero (default 1), the new layer has alpha.

gimp_image_set_visible $image,@layers, gimp_image_set_invisible $image,@layers

mark the given layers visible (invisible) and all others invisible (visible).

gimp_layer_get_position $layer

return the position the layer has in the image layer stack.

gimp_layer_set_position $layer,$new_index

moves the layer to a new position in the layer stack.

Gimp::Lib is an interface to libgimp (as opposed to Gimp::Net).

SYNOPSIS

use Gimp; # internal use only

This is the package that interfaces to The Gimp via the libgimp interface, i.e. the normal interface to use with the Gimp. You dont normally use this module directly, look at the documentation for the package "Gimp".

Gimp::Config is a Perl module with config options found during configure time.

The Gimp::Config module creates a tied hash %Gimp::Config which contains all the definitions the configure script and perl deduced from the system configuration at configure time. You can access these values just like you access any other values, i.e. $Gimp::Config{KEY}. Some important keys are:

IN_GIMP => true when gimp-perl was part of the Gimp distribution.
GIMP => the path of the gimp executable
prefix => the installation prefix
libdir => the gimp systemwide libdir
bindir => paths where gimp binaries are installed
gimpplugindir => the gimp plug-in directory (without the /plug-ins-suffix)

Gimp::PDL is a Perl module to overwrite Tile/Region functions to work with piddles. This module is obsolete, please remove any references to it.

SYNOPSIS
use Gimp;
use Gimp::PDL;
use PDL;

This module overwrites some methods of Gimp::Tile and Gimp::PixelRgn. The new functions return and accept piddles. The last argument (height) of gimp_pixel_rgn_set_rect is calculated from the piddle. There is no other way to access the raw pixeldata in Gimp.

Some exmaples:

$region = $drawable->get->pixel_rgn (0,0, 100,100, 1,0);
$pixel = $region->get_pixel (5,7); # fetches the pixel from (5|7)
print $pixel; # outputs something like
# [255, 127, 0], i.e. in
# RGB format ;)
$region->set_pixel ($pixel * 0.5, 5, 7);# darken the pixel
$rect = $region->get_rect (3,3,70,20); # get a horizontal stripe
$rect = $rect->hclip(255/5)*5; # clip and multiply by 5
$region->set_rect($rect); # and draw it!
undef $region; # and update it!