PDFlib Text Extraction Toolkit (TET) Manual

Table 10.17 Options for TET_write_image_file( ) and TET_get_image_data( )
option
preferredtiffcompression
typeonly 1
description
(Keyword) Compression scheme used for most extracted TIFF images (default: flate):
lzw LZW compression (TIFF compression scheme 5)
flate Flate compression, also called Adobe Deflate or zlib compression (TIFF compression scheme 8)
(Boolean) The image type will be determined according to the supplied options, but no image file will be
written. This is useful for determining the type of image returned by TET_get_image_data( ), which does
not return the image type itself. Default: false
1. Only for TET_write_image_file( )
C++ const char *get_image_data(int doc, size_t *length, int imageid, wstring optlist)
C# Java final byte[ ] get_image_data(int doc, int imageid, String optlist)
Perl PHP string get_image_data(long doc, long imageid, string optlist)
VB RB Function get_image_data(doc As Long, imageid As Long, optlist As String)
C
const char * TET_get_image_data(TET *tet, int doc, size_t *length, int imageid, const char *optlist)
Retrieve image data from memory.
doc A valid document handle obtained with TET_open_document*( ).
length (C and C++ language bindings only) C-style pointer to a memory location where
the length of the returned data in bytes will be stored.
imageid The pCOS ID of the image. This ID can be retrieved from the imageid field after
a successful call to TET_get_image_info( ), or by looping over all entries in the images
pCOS array (there are length:images entries in this array).
optlist An option list specifying image-related options according to Table 10.17. The
following options can be used: compression, keepxmp
Returns
Details
Bindings
The data representing the image according to the specified options. In case of an error
(including images which cannot be extracted) a NULL pointer will be returned in C and
C++, and empty data in other language bindings. If an error happens it is recommended
to call TET_get_errmsg( ) to find out more details about the error.
This function will convert the pixel data for the image with the specified pCOS ID to one
of several image formats, and make the data available in memory.
COM: Most client programs will use the Variant type to hold the image data.
C and C++ language bindings: The returned data buffer can be used until the next call to
this function.
REALbasic: the result will be provided as REALbasic string with encoding -1 (binary data).
If no more text is available an empty string will be returned.
184 Chapter 10: TET Library API Reference