Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

imager::transform(3pm) [debian man page]

Imager::Transform(3pm)					User Contributed Perl Documentation				    Imager::Transform(3pm)

NAME

	 Imager::Transform - a library of register machine image transformations

SYNOPSIS

	 # get a list of transformations
	 my @funcs = Imager::Transform->list;
	 # create a transformation object
	 my $tran = Imager::Transform->new($name);
	 # describe it
	 print $tran->describe;
	 # a list of constant names
	 my @constants = $tran->constants;
	 # information about some of the constants
	 my @info = $tran->constants(@constants);

DESCRIPTION

       This module provides a library of transformations that use the Imager transform2() function.

       The aim is to provide a place to collect these transformations.

       At some point there might be an interface to add new functions, but there's not a whole lot of point to that.

       The interface is a little sparse as yet.

METHODS

       my @names = Imager::Transform->list
	   Returns a list of the transformations.

       my $desc = Imager::Transform->describe($name);
       my $desc = $tran->describe()
	   Describes a transformation specified either by name (as a class method) or by reference (as an instance method).

	   The class method returns undef if there is no such transformation.

       my $tran = Imager::Transform->new($name)
	   Create a new transformation object.	Returns undef if there is no such transformation.

       my @inputs = $tran->inputs;
       my $inputs = $tran->inputs;
	   Returns a list of input image descriptions, or the number of them, depending on content.

	   The list contains hash references, which current contain only one member, "desc", a description of the use of the input image.

       $tran->constants
	   Returns a list of names of constants that can be set for the transformation.

       $tran->constants($name, $name, ...)
	   Returns a hashref for each named constant, which contains the default in key "default" and a description in key "desc".

       my $out = $tran->transform(\%opts, \%constants, @imgs)
	   Perform the image transformation.

	   Returns the new image on success, or undef on failure, in which case you can use $tran->errstr to get an error message.

       $tran->errstr
	   The error message, if any from the last image transformation.

BUGS

       Needs more transformations.

SEE ALSO

       Imager(3), transform.perl

perl v5.14.2							    2011-06-06						    Imager::Transform(3pm)

Check Out this Related Man Page

Imager::Expr::Assem(3pm)				User Contributed Perl Documentation				  Imager::Expr::Assem(3pm)

NAME

	 Imager::Expr::Assem - an assembler for producing code for the Imager
	 register machine

SYNOPSIS

	 use Imager::Expr::Assem;
	 my $expr = Imager::Expr->new(assem=>'...', ...)

DESCRIPTION

       This module is a simple Imager::Expr compiler that compiles a low-level language that has a nearly 1-to-1 relationship to the internal
       representation used for compiled register machine code.

   Syntax
       Each line can contain multiple statements separated by semi-colons.

       Anything after '#' in a line is ignored.

       Types of statements:

       variable definition
	       "var" name:type

	   defines variable name to have type, which can be any of "n" or "num" for a numeric type or "pixel", "p" or "c" for a pixel or color
	   type.

	   Variable names cannot include white-space.

       operators
	   Operators can be split into 3 basic types, those that have a result value, those that don't and the null operator, eg. jump has no
	   value.

	   The format for operators that return a value is typically:

	       result = operator operand ...

	   and for those that don't return a value:

	       operator operand

	   where operator is any valid register machine operator, result is any variable defined with "var", and operands are variables, constants
	   or literals, or for jump operators, labels.

	   The set operator can be simplified to:

	       result = operator

	   All operators maybe preceded by a label, which is any non-white-space text immediately followed by a colon (':').

BUGS

       Note that the current optimizer may produce incorrect optimization for your code, fortunately the optimizer will disable itself if you
       include any jump operator in your code.	A single jump to anywhere after your final "ret" operator can be used to disable the optimizer
       without slowing down your code.

       There's currently no high-level code generation that can generate code with loops or real conditions.

SEE ALSO

       Imager(3), transform.perl, regmach.c

AUTHOR

       Tony Cook <tony@develop-help.com>

perl v5.14.2							    2011-06-06						  Imager::Expr::Assem(3pm)
Man Page