NAME

Graphics::DZI::Files - DeepZoom Image Pyramid Generation, File-based

SYNOPSIS

  use Graphics::DZI::Files;
  my $dzi = new Graphics::DZI::Files (image    => $image,
                                      overlap  => 4,
                                      tilesize => 256,
                                      scale    => 2,
                                      format   => 'png',
                                      prefix   => 'xxx',
                                      path     => '/where/ever/');
  use File::Slurp;
  write_file ('/where/ever/xxx.xml', $dzi->descriptor);
  $dzi->iterate ();

  # since 0.05
  use Graphics::DZI::Files;
  my $dzi = new Graphics::DZI::Files (image => $image,
                                      dzi   => '/tmp/xxx.dzi');

DESCRIPTION

This subclass of Graphics::DZI generates tiles and stores them at the specified path location.

INTERFACE

Constructor

Additional to the parent class Graphics::DZI, the constructor takes the following fields:

format (default png):: An image format (png, jpg, ...). Any format Image::Magick understands will do.
path: (deprecated from 0.05 onwards, use dzi): A directory name (including trailing /) where the tiles are written to. This has to include the _files part required by the DZI format.
prefix: (deprecated from 0.05 onwards, use dzi): The string to be prefixed the _files/ part in the directory name. Usually the name of the image to be converted. No slashes.
dzi (since 0.05): Alternatively to specifying the path and the prefix separately, you can also provide the full path to the DZI file, say, /var/www/photo.dzi. The tiles will be written to /var/www/photo_files.

This method generates everything, the tiles and the XML descriptor. If you have specified a dzi field in the constructor, then you do not need to specify it as parameter. If you have used the path/prefix, then you need to provide the full path.

manifest

This method writes any tile to a file, appropriately named for DZI inclusion.

AUTHOR

Robert Barta, <drrho at cpan.org>

COPYRIGHT & LICENSE

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