home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / graphics / gif-util.zip / LIBERROR.DOC < prev    next >
Text File  |  1989-08-01  |  5KB  |  126 lines
  1.         GIF_LIB ERROR
  2.         -------------
  3.  
  4. Errors as reported from the GIF_LIB library are divided to 2 major parts:
  5. the encoder (errors prefixed by E_GIF_ERR), and the decoder (errors prefixed
  6. by D_GIF_ERR). This document explains them briefly:
  7.  
  8. Encoding errors:
  9. ----------------
  10.  
  11. 1. E_GIF_ERR_OpenFailed
  12.    Message printed using PrintGifError: "Failed to open given file"
  13.    IO error result when attempt to open the given GIF file.
  14.  
  15. 2. E_GIF_ERR_WriteFailed
  16.    Message printed using PrintGifError: "Failed to Write to given file"
  17.    IO error result when attempt to write to the given GIF file.
  18.  
  19. 3. E_GIF_ERR_HasScrnDscr
  20.    Message printed using PrintGifError: "Screen Descriptor already been set"
  21.    Attempt to write second screen descriptor to same GIF file. GIF file should
  22.    have exactly one screen descriptor which should be set directly after the
  23.    file is opened.
  24.  
  25. 4. E_GIF_ERR_HasImagDscr
  26.    Message printed using PrintGifError: "Image Descriptor is still active"
  27.    Image descriptor should be sent before and image dump, and no second
  28.    image descriptor should be sent before current image dump ended. This error
  29.    occured probably because current image was not complete.
  30.  
  31. 5. E_GIF_ERR_NoColorMap
  32.    Message printed using PrintGifError: "Neither Global Nor Local color map"
  33.    An image must have either global (screen) or local (image) color map.
  34.    Neither were given in this case.
  35.  
  36. 6. E_GIF_ERR_DataTooBig
  37.    Message printed using PrintGifError: "#Pixels bigger than Width * Height"
  38.    The number of pixels dumped for this image is bigger than specified by
  39.    image Height times image Width.
  40.  
  41. 7. E_GIF_ERR_NotEnoughMem
  42.    Message printed using PrintGifError: "Fail to allocate required memory"
  43.    Once an attemp is made to open GIF file, special structures are allocated
  44.    to hold internal data for it. If allocation fails this error is returned.
  45.  
  46. 8. E_GIF_ERR_DiskIsFull
  47.    Message printed using PrintGifError: "Write failed (disk full?)"
  48.    Writing encoded data failed.
  49.  
  50. 9. E_GIF_ERR_CloseFailed
  51.    Message printed using PrintGifError: "Failed to close given file"
  52.    Closing file failed.
  53.  
  54. 10. E_GIF_ERR_NotWriteable
  55.    Message printed using PrintGifError: "Given file was not opened for write"
  56.    GIF files can be opened both for read (DGIF part of library) and write
  57.    (EGIF part of library). This error occurs when a file is opened for read
  58.    (using DGIF) is given to one of the encoding (EGIF) routines.
  59.  
  60.  
  61. Encoding errors:
  62. ----------------
  63.  
  64. 1. D_GIF_ERR_OpenFailed
  65.    Message printed using PrintGifError: "Failed to open given file"
  66.    IO error result when attempt to open the given GIF file.
  67.  
  68. 2. D_GIF_ERR_ReadFailed
  69.    Message printed using PrintGifError: "Failed to Read from given file"
  70.    IO error result when attempt to write to the given GIF file.
  71.  
  72. 3. D_GIF_ERR_NotGifFile
  73.    Message printed using PrintGifError: "Given file is NOT GIF file"
  74.    GIF files should have special stamp identifies them as such, If that stamp
  75.    is not found, this error is issued.
  76.  
  77. 4. D_GIF_ERR_NoScrnDscr
  78.    Message printed using PrintGifError: "No Screen Descriptor detected"
  79.    Each GIF file should have screen descriptor in its header. This error will
  80.    be generated if no such descriptor was found.
  81.  
  82. 5. D_GIF_ERR_NoImagDscr
  83.    Message printed using PrintGifError: "No Image Descriptor detected"
  84.    Each image should have image descriptor in its header. This error will
  85.    be generated if no such descriptor was found.
  86.  
  87. 6. D_GIF_ERR_NoColorMap
  88.    Message printed using PrintGifError: "Neither Global Nor Local color map"
  89.    An image must have either global (screen) or local (image) color map.
  90.    Neither were given in this case.
  91.  
  92. 7. D_GIF_ERR_WrongRecord
  93.    Message printed using PrintGifError: "Wrong record type detected"
  94.    Each record in GIF file has special identifier, in its header. If the
  95.    record has wrong identifier, this error is generated.
  96.  
  97. 8. D_GIF_ERR_DataTooBig
  98.    Message printed using PrintGifError: "#Pixels bigger than Width * Height"
  99.    The number of pixels dumped for this image is bigger than specified by
  100.    image Height times image Width.
  101.  
  102. 9. D_GIF_ERR_NotEnoughMem
  103.    Message printed using PrintGifError: "Fail to allocate required memory"
  104.    Once an attemp is made to open GIF file, special structures are allocated
  105.    to hold internal data for it. If allocation fails this error is returned.
  106.  
  107. 10. D_GIF_ERR_CloseFailed
  108.    Message printed using PrintGifError: "Failed to close given file"
  109.    Closing file failed.
  110.  
  111. 11. D_GIF_ERR_NotReadable
  112.    Message printed using PrintGifError: "Given file was not opened for read"
  113.    GIF files can be opened both for read (DGIF part of library) and write
  114.    (EGIF part of library). This error occurs when a file is opened for write
  115.    (using EGIF) is given to one of the decoding (DGIF) routines.
  116.  
  117. 12. D_GIF_ERR_ImageDefect
  118.    Message printed using PrintGifError: "Image is defective, decoding aborted"
  119.    This error is generated, once the decoding failed - probably image is
  120.    defect.
  121.  
  122. 13. D_GIF_ERR_EOFTooSoon
  123.    Message printed using PrintGifError: "Image EOF detected, before image complete"
  124.    This error is generated once EOF code is detected in encoded image before
  125.    all the pixels (Width * Height) has be decoded.
  126.