1PDF::Builder::Resource:U:sXeOrbjCeoPcnDttF:r::i:IbBmuuatigeledd:e:PrTe:Ir:FlRFe_DsGooTcu(ur3mc)een:t:aXtOibojnect::Image::TIFF_GT(3)
2
3
4

NAME

6       PDF::Builder::Resource::XObject::Image::TIFF_GT - TIFF image support
7       (Graphics::TIFF enabled)
8

METHODS

10       $res = PDF::Builder::Resource::XObject::Image::TIFF_GT->new($pdf,
11       $file, $name, %opts)
12       $res = PDF::Builder::Resource::XObject::Image::TIFF_GT->new($pdf,
13       $file, $name)
14       $res = PDF::Builder::Resource::XObject::Image::TIFF_GT->new($pdf,
15       $file)
16           Returns a TIFF-image object. $pdf is the PDF object being added to,
17           $file is the input TIFF file, and the optional $name of the new
18           parent image object defaults to IxAAA.
19
20           If the Graphics::TIFF package is installed, and its use is not
21           suppressed via the "-nouseGT" flag (see Builder documentation for
22           "image_tiff"), the TIFF_GT library will be used. Otherwise, the
23           TIFF library will be used instead.
24
25           Options:
26
27           -notrans => 1
28               Ignore any alpha layer (transparency) and make the image fully
29               opaque.
30
31           TIFF support (when using Graphics::TIFF) is for
32           "PhotometricInterpretation" values of 0 (bilevel/gray, white is 0),
33           1 (bilevel/gray, black is 0), 2 (RGB), and 3 (Palette color). It
34           currently does not support 4 (transparency mask), 5 (separated
35           CMYK), 6 (YCbCr), 8 (CIELab), or higher. There is limited support
36           for an Alpha (transparency) channel (due to extremely limited test
37           cases).  Some tags are not supported, and a PlanarConfiguration of
38           2 is unknown until we get some test cases.
39
40           Some applications seem to take odd liberties with TIFF tags, such
41           as adding a SamplePerPixel without specifying ExtraSamples type. In
42           such cases, we treat one extra sample (not otherwise defined) as an
43           Alpha channel, and hope for the best!
44
45           If there are invalid tags or field values within a tag, the
46           Graphics::TIFF library will attempt to pop-up a warning dialog,
47           rather than just ignoring invalid things. If we can find a switch
48           to disable this behavior, we will look into adding it as an option.
49           According to Graphic::TIFF's owner (ticket RT 133955), this is
50           coming directly from libtiff (as write to STDERR), so he can't do
51           anything about it!
52
53       $mode = $tif->usesLib()
54           Returns 1 if Graphics::TIFF installed and used, 0 if not installed,
55           or -1 if installed but not used (-nouseGT option given to
56           "image_tiff").
57
58           Caution: this method can only be used after the image object has
59           been created. It can't tell you whether Graphics::TIFF is available
60           in advance of actually using it, in case you want to use some
61           functionality available only in TIFF_GT. See the PDF::Builder
62           LA_GT() call if you need to know in advance.
63
64
65
66perl v5.34.0                PDF::B2u0i2l2d-e0r1:-:2R1esource::XObject::Image::TIFF_GT(3)
Impressum