samples/README

   1 This directory includes example code for Imager.
   2
   3 If you have sample code to contribute, please contact the maintainer.
   4
   5 The notes here just provide a basic description and the functions
   6 used.
   7
   8 anaglyph.pl
   9
  10   Produce a color, grey or pure anaglyph image given left and right
  11   images of a stereoscopic pair.
  12
  13   Uses transform2() and convert().
  14
  15 interleave.pl
  16
  17   Produce an interleaved image given the left and right images of a
  18   stereoscopic pair.  Note that the source images must be pre-scaled.
  19
  20   This includes 3 different implementations, first using transform2(),
  21   the second using the internal i_copyto() function and the third using
  22   the internal i_glin() and i_plin() functions.
  23
  24 samp-form.cgi
  25 samp-image.cgi
  26
  27   Example that demonstrates generating an image linked from a HTML form.
  28
  29   The POD for this sample discusses alternate approaches and security
  30   considerations.
  31
  32 samp-scale.html
  33 samp-scale.cgi
  34
  35   Example that demonstrates reading an image uploaded via a HTML form.
  36
  37   Produces an output image scaled to fit inside 200x200.
  38
  39 samp-tags.html
  40 samp-tags.cgi
  41
  42   Example that demonstrates reading an image uploaded via a HTML form.
  43
  44   Produces a text/plain report of the tags that Imager defined for the
  45   image.
  46
  47   This and the previous sample are very similar, the intent is to show
  48   the common elements and to demonstrate that the output is independent
  49   of the input.
  50
  51   See the section "Parsing an image posted via CGI" in Imager::Cookbook
  52   for cautions and details on reading uploaded images.