summaryrefslogtreecommitdiff
path: root/README
blob: 7e471c0f8ff9a4c2b4a1508645aef1b3ae772c03 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
NAME

    Graphics::TIFF - Perl extension for the libtiff library

VERSION

    20

SYNOPSIS

    Perl bindings for the libtiff library. This module allows you to access
    TIFF images in a Perlish and object-oriented way, freeing you from the
    casting and memory management in C, yet remaining very close in spirit
    to original API.

    The following snippet can be used to read the image data from a TIFF:

     use Graphics::TIFF ':all';
     my $tif = Graphics::TIFF->Open( 'test.tif', 'r' );
     my $stripsize = $tif->StripSize;
     for my $stripnum ( 0 .. $tif->NumberOfStrips - 1 ) {
         my $buffer = $tif->ReadEncodedStrip( $stripnum, $stripsize );
         # do something with $buffer
     }
     $tif->Close;

DESCRIPTION

    The Graphics::TIFF module allows a Perl developer to access TIFF
    images. Find out more about libtiff at http://www.libtiff.org.

DIAGNOSTICS

CONFIGURATION AND ENVIRONMENT

DEPENDENCIES

 Runtime

    The runtime dependencies are just libtiff itself. In Windows this is
    satisfied by Alien::libtiff.

 Build

    The build dependencies are additionally the development headers for
    libtiff and Perl.

 Test

    In addition to the above, the Perl module Image::Magick is required to
    run some of the tests.

INCOMPATIBILITIES

BUGS AND LIMITATIONS

SEE ALSO

    The LIBTIFF Standard Reference http://www.libtiff.org/libtiff.html is a
    handy companion. The Perl bindings follow the C API very closely, and
    the C reference documentation should be considered the canonical
    source.

AUTHOR

    Jeffrey Ratcliffe, <jffry@posteo.net>

LICENSE AND COPYRIGHT

    Copyright (C) 2017--2023 by Jeffrey Ratcliffe

    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself, either Perl version 5.8.5 or, at
    your option, any later version of Perl 5 you may have available.