Images

• tkPhoto
• Magick

Options:

• general
• related

Examples

There are two packages which handle images which you can use:

• Tk::Photo images, which are part of tk, but only support a view formats and rather primitive operations;
• Image::Magick images, which is a package available for many operating-systems, capable of processing hardly any image format imaginable.
  See the download page on how to retrieve this optional package.

They way how images work do differ on which package you use: Tk::Photo images are related to a canvas (say viewport), while Image::Magick images are device independent.

General Image Options

-file => filename

The name of the file to be used. PPresenter searches the directories in the imageDirs list (see the addImageDir function described below) for the file, except when this is an absolute path, of course.

Each file is read only once. Each images is scaled at most once per viewport which shows the image.

-sizeBase => geometry

Overrules what the show's -imageSizeBase is defining on what screen-size this image is made. During the presentation, the image is scaled to occupy the same amount of screen-space. Of course only when resizing is enabled.

-resize => boolean

Overrules the show's -resize (by default on), on whether the images should be resized or not. Resizing can only take place when a sizeBase is defined.

-enlarge => boolean

Overrules the show's -enlarge (by default off), on whether enlarging is allowed when resizing. This is usually not a good idea, because your image quality will be decrease.

imageDirs => [ dir, ... ]

Directories where images can reside. You shall not change anything directly in this list, but only using the function:

$show->addImageDir(dir, ...);

PPresenter searches all directories from @INC to find the directories you specified, and adds them in from of the list in imageDirs.

At start, the paths "PPresenter/images" and "." are added.

Related Options

-imageSizeBase => geometry

-resizeImages => boolean

-enlargeImages => boolean

-scaledImagesDir => dirname

-bgcolor

Determines the color to be used in anti-aliasing while resizing transparent images.

-nestImages

Examples

Example 1: Use in the Markup Formatter

   use PPresenter;
   my $show = PPresenter->new;
   $show->addSlide(-template => 'main'
     , -main => '<IMG SRC=image.gif>');

If the package Image::Magick is installed, then PPresenter will resize the image with ImageMagick. In that case, nearly all imaginable image formats can be used. If the package is not installed, the image is read via Tk::Photo, which supports only a small set of formats (see manual on Tk::Photo).

Example 2: Same image twice

   use PPresenter;
   my $show = PPresenter->new;
   $show->addSlide(-main => '<IMG SRC=image.gif RESIZE>');
   $show->addSlide(-main => '<IMG SRC=image.gif RESIZE=0>');

Example 3: Predefining images

To avoid the hazard, but also to improve your possibilities to specify the images, you can define an image outside a slide:

   use PPresenter;
   my $show = PPresenter->new;
   $show->image(-file => 'image.gif', -resize => 0);
   $show->addSlide(-main => '<IMG SRC=image>');
   $show->addSlide(-main => '<IMG SRC=image>');

    -aliases => [ 'alias', 'alias2', ... ]

Example 4: Reading the images yourself

If you have created you own Photo or Magick image, you can add this to PPresenter with:

   $object = ...; # create Tk::Photo or Image::Magick object
   $show->image($object, -name => 'image');