-----------------------------------------------------------------------------

                GIF32 stuff by TAD ( tad_uk@bigfoot.com )

-----------------------------------------------------------------------------

WOT THE FIG?
------------
        The included 80x86 source code will load and display a
        single image from a GIF87a or GIF89a file. The example
        is pretty straight forward and shows how to code a LZW
        decompression routine for the GIF TBI (Table Based Image)
        bitstream.

        The Source code contains some unused structures, these
        were typed in from the official GIF89a specs and may be
        useful to those of you who wish to extend this loader to
        deal with multiple images and all the GIF89a extensions.

GIF.INC
-------
        - contains all the GIF data structures and equates

GIF32.ASM
---------
        - this is a 32-bit FLAT mode GIF loader.
        - it was written using TASM32, WDOSX (and optionally DLINK)
          (it should also assemble under MASM 6.xx)

DISC-LAMER:
-----------
        - use it at YOUR own risk...
        - if it screws up... then tough titty..


CLIPPING:
---------
        - the slow '@@Output' allows a small section of a large GIF
          image to be decompressed and/or to be decompressed into
          a much wider buffer or screen.

        - the ClipX and ClipY indicate how many pixels/lines should
          be skipped (ie. where to start decompressing from).

        - the ClipWidth and ClipHeight define the size of the small
          decompression area.

        - the ClipPerLine defines the number of bytes-per-line in
          the destination buffer.

        eg.
                ClipX = 10
                ClipY = -50             ; NOTE: -ve !!
                ClipWidth = 60
                ClipHeight = 40
                ClipPerLine = 320

        Will decompress a 60 x 40 pixel region starting at (10,50)
        in the GIF image and outputs it to a 320-pixel/byte wide
        screen/buffer.


SUPPORT?
--------
        - nope, sorry... please download the official GIF89a
          specs or search for some other information about the
          GIF file format and/or LZW compression scheme.

IMPROVEMENTS?
-------------
        - the entire routine could be far, far, far smaller, the
          buffers could be recycled (or even alloc'd, used, free'd)
          to reduce memory requirements..

        - it could be made faster by removing the clipping features
          and modifying the 1st rep-movsb to output the phraze
          directly to the the output.

        - hey, it's only an example.. 

                        enjoy...

regards
        TAD #:o)

