ShowTIF()

Displays a TIFF image file


Syntax

ShowTIF(<cFILE.TIF>, [<Options>])


Arguments

<cFILE.TIF>
Name of the TIFF image file, and optional drive and path.

<Options>
NOBLANK, FORCEMODE, NOPALETTE.


Returns

0
Success.

-1
Can not open <cFILE>.

-2
This is not a valid TIFF 4.2/5.0 file.

-3
Unable to find a graphic mode for this image.

-4
Cannot allocate memory for line buffers.

-5
LSEEK error: file is truncated.

-6
This TIFF file type is not supported.

-7
Image width tag is missing.

-8
Image height tag is missing.

-99
Parameters are invalid.


Remarks

ShowTIF() displays 8-bit TIFF 4.2/5.0 format image files only. TIFF 
compression types supported: No compression, CCITT Modified Huffman RLE, 
CCITT Group 3-1D FAX, and Macintosh RLE.

TIFF compression types not supported: CCITT Group 3-2D FAX, CCITT Group 
4-2D FAX, LZW (Limpel-Ziv and Welch), NEXT 2-bit RLE, Thunderscan RLE, Old 
Pixar RLE, Silicon Graphics RLE, 24 -bit RGB and Planar, JPEG-in-TIFF 6.0.


Example

// Example:  "SHOWTIF.PRG"
cFileName = "FILE.TIF"
nStatus = ShowTIF(cFileName)
IF nStatus < 0
   DO CASE
      CASE nStatus = -1
         ? "Cannot open ", cFileName
      CASE nStatus = -2
         ? cFileName, " is not a TIFF 4.2/5.0 file"
      CASE nStatus = -3
         ? "Unable to find a graphic mode for this image"
      CASE nStatus = -4
         ? "Cannot allocate memory for line buffers"
      CASE nStatus = -5
         ? "LSEEK error: file is truncated"
      CASE nStatus = -6
         ? "This TIFF file type is not supported"
      CASE nStatus = -7
         ? "Image width tag is missing"
      CASE nStatus = -8
         ? "Image height tag is missing"
      CASE nStatus = -99
         ? "Parameters are invalid"
   ENDCASE
   RETURN
ENDIF
ch = 0
DO WHILE ch = 0
   ch = INKEY()
ENDDO
TextMode()

For other examples of how to use the Show<EXT>() display functions, see 
SHOW.PRG, an example program distributed with Sunshow.