gifio.c File Reference

#include <string.h>
#include "allheaders.h"

Go to the source code of this file.

Detailed Description

   Reading gif
         PIX            *pixReadStreamGif()
         PIX            *pixReadMemGif()
         static l_int32  gifReadFunc()
         static PIX     *gifToPix()

   Writing gif
         l_int32         pixWriteStreamGif()
         l_int32         pixWriteMemGif()
         static l_int32  gifWriteFunc()
         static l_int32  pixToGif()

   The initial version of this module was generously contribued by
   Antony Dovgal.

   The functions that read and write from pix to gif-compressed memory,
   using gif internal functions DGifOpen() and EGifOpen() that are
   available in 5.1 and later, were contributed by Tobias Peirick.

   Version information:

   (1) This supports the gif library, version 5.1 or later, for which
       gif read-from-mem and write-to-mem allow these operations
       without writing temporary files.
   (2) There has never been a gif stream interface.  For versions
       before 5.1, it was necessary to use a file descriptor, and to
       generate a file stream from the low-level descriptor.  With the
       memory interface in 5.1 that can be used on all platforms, it
       is no longer necessary to use any API code with file descriptors.
   (3) The public interface changed with 5.0 and with 5.1, and we
       no longer support 4.6.1 and 5.0.
   (4) Version 5.1.2 came out on Jan 7, 2016.  Leptonica cannot
       successfully read gif files that it writes with this version;
       DGifSlurp() gets an internal error from an uninitialized array
       and returns failure.  The problem was fixed in 5.1.3.

   Limitations:

   (1) We do not support animated gif.  If the gif has more than one image,
       an error message is returned.

Definition in file gifio.c.