NAME

App::Dthumb - Generate thumbnail index for a set of images

SYNOPSIS

    use App::Dthumb;
    use Getopt::Long qw(:config no_ignore_case);
    
    my $opt = {};
    
    GetOptions(
        $opt,
        qw{
                help|h
                size|d=i
                spacing|s=f
                no-lightbox|L
                no-names|n
                quality|q=i
                version|v
        },
    );
    
    my $dthumb = App::Dthumb->new($opt);
    $dthumb->run();

VERSION

This manual documents App::Dthumb version 0.2

METHODS

new($conf)

Returns a new App::Dthumb object. As you can see in the SYNOPSIS, $conf is designed so that it can be directly fed by Getopt::Long.

Valid hash keys are:

dir_images => directory

Set base directory for image reading, data creation etc.

Default: . (current working directory)

file_index => file

Set name of the html index file

Default: index.xhtml

lightbox => bool

Include and use javascript lightbox code

Default: true

recreate => bool

If true, unconditionally recreate all thumbnails.

Default: false

size => int

Maximum image size in pixels, either width or height (depending on image orientation)

Default: 200

spacing => float

Spacing between image boxes. 1.0 means each box is exactly as wide as the maximum image width (see size), 1.1 means slightly larger, et cetera

Default: 1.1

names => bool

Show image name below thumbnail

Default: true

quality => 0 .. 100

Thumbnail image quality

Default: 75

read_directories

Read in a list of all image files in the current directory and all files in .thumbs which do not have a corresponding full-size image.

create_files

Makes sure the .thumbs directory exists.

Also, if lightbox is enabled (which is the default), creates the .dthumb directory and fills it with all required files.

delete_old_thumbnails

Unlink all no longer required thumbnails (as previously found by read_directories).

get_files

Returns an array of all image files found by read_directories.

create_thumbnail_html($file)

Append the necessary lines for $file to the HTML.

create_thumbnail_image($file)

Load $file and save a resized version in .thumbs/$file. Skips thumbnail generation if the thumbnail already exists and has a more recent mtime than the original file.

write_out_html

Write the cached HTML data to index.xhtml.

DEPENDENCIES

• App::Dthumb::Data

• Image::Imlib2

AUTHOR

Copyright (C) 2009-2011 by Daniel Friesel <derf@chaosdorf.de>

LICENSE

    0. You just DO WHAT THE FUCK YOU WANT TO.

cpanm App::Dthumb

perl -MCPAN -e shell
install App::Dthumb