Adam Roth > Image-Magick-Brand-0.01 > Image::Magick::Brand

Download:
Image-Magick-Brand-0.01.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View Bugs
Report a bug
Module Version: 0.01   Source  

NAME ^

Image::Magick::Brand - Perl extension for creating branded images with ImageMagick.

SYNOPSIS ^

  use Image::Magick::Brand;
  my $b = new Image::Magick::Brand;
  
  $b->debug(1); # debugging statements on
  
  # Required parameters
  $b->brand( source => 'brand.png',
             target => 'photo.jpg',
             output => 'branded.jpg' );
   
  # Required and optional parameters
  $b->brand( source    => 'brand.png',
             target    => 'photo.jpg',
             output    => 'branded.jpg',
             gravity   => 'SouthWest',
             format    => 'jpg',
             composite => 'over',
             quality   => 75 );

DESCRIPTION ^

Create branded images by composing one image on top of another. For optimal results, use a transparent png (or gif...if you must) as the source image. Note: You must have the appropriate system libraries installed to use certain image formats (ie: lipjpeg, libpng). ImageMagick will complain if you don't.

Source + Target = Branded Image

       +---------+   +---------+
       |         |   |         |
       |         |   |         |
       |         |   | +--+    |
+--+   |         |   | |  |    |
|  | + |         | = | +--+    |
+--+   +---------+   +---------+

PREREQUISITES ^

Image::Magick

PARAMETERS ^

REQUIRED PARAMETERS

source

The input path of the source image ('brand image').

target

The input path of the target image.

output

The output path of the branded image.

OPTIONAL PARAMETERS

gravity

The gravity (location) of the source image on top of the target image.

 +---------+
 | 1  2  3 |
 |    4    |
 | 5  6  7 |
 +----------
 
 1 = NorthWest
 2 = North
 3 = NorthEast
 4 = Center
 5 = SouthWest (default)
 6 = South
 7 = SouthEast
quality

Quality for JPG/MIFF/PNG output (0-100). Default = 100.

composite

The 'composite' value as passed to ImageMagick's composite function. Default = 'over'. Read the docs for the other possible values.

format

The output format. Default = jpg.

EXPORT ^

None by default.

VERSION HISTORY ^

Version 0.01 (03 May 2005): Initial Revision

SEE ALSO ^

Image::Magick

Image::Magick::Thumbnail::Fixed

http://imagemagick.org/script/perl-magick.php

AUTHOR ^

Adam Roth, <aroth@cpan.org>

Originally developed for http://www.fetishcyclesfanclub.com. Let me know if you find this module useful.

COPYRIGHT AND LICENSE ^

Copyright 2005 by Adam Roth

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.