QUERY_TIFF is a method of obtaining information about a TIFF image file without having to read the file. See QUERY_* Routines for more information.
Examples
This is an example of using QUERY_TIFF to write and read a multi-image TIFF file. The first image is a 16-bit, single channel image stored using compression. The second image is an RGB image stored using 32-bits/channel uncompressed.
PRO ex_query_tiff
data = FIX(DIST(256))
rgbdata = LONARR(3,320,240)
tif_file = FILEPATH('multi.tif', /TMP)
WRITE_TIFF,tif_file,data,COMPRESSION=1,/SHORT
WRITE_TIFF,tif_file,rgbdata,/LONG,/APPEND
ok = QUERY_TIFF(tif_file,s)
IF (ok) THEN BEGIN
FOR i=0,s.NUM_IMAGES-1 DO BEGIN
imp = QUERY_TIFF(tif_file,t,IMAGE_INDEX=i)
img = READ_TIFF(tif_file,IMAGE_INDEX=i)
HELP,t,/STRUCTURE
HELP,img
ENDFOR
ENDIF
END
Syntax
Result = QUERY_TIFF ( Filename [, Info] [, GEOTIFF=variable] [, IMAGE_INDEX=index] )
Return Value
This routine returns a long with the value of 1 (one) if the query was successful (and the file type was correct) or 0 (zero) on failure.
Arguments
Filename
A scalar string containing the pathname of the TIFF file to query.
Info
Returns an anonymous structure containing information about the image in the file. The Info.TYPE field will return the value ‘TIFF’.
Note: See General Query * Routine Info Structures for detailed structure information.
Note: In addition to the fields returned in the Info structure for all image types, there are a number of extra fields in the Info structure for TIFF images. See QUERY_TIFF-Specific Routine Info Structures for detailed structure info.
Keywords
GEOTIFF
Set this keyword to a named variable in which to return an anonymous structure containing the GeoTIFF tags and keys found in the file. If no GeoTIFF information is present in the file, the returned variable is set to a scalar zero. For a description of the possible GeoTIFF tags see the GEOTIFF keyword in READ_TIFF.
Tip: This keyword returns the same information as the GEOTIFF keyword to READ_TIFF, but avoids the overhead of reading in the entire image.
IMAGE_INDEX
Image number index. If this value is larger than the number of images in the file, the function returns 0 (failure).
Version History
5.2 |
Introduced |
6.1 |
Added DESCRIPTION, DOCUMENT_NAME, DATE_TIME, and POSITION Info structures
Added GEOTIFF keyword
|
8.2 |
Added support for BigTIFF files. |
See Also
QUERY_* Routines, READ_TIFF, WRITE_TIFF