126 lines
5.1 KiB
Plaintext
126 lines
5.1 KiB
Plaintext
GIF_LIB ERROR
|
|
-------------
|
|
|
|
Errors as reported from the GIF_LIB library are divided to 2 major parts:
|
|
the encoder (errors prefixed by E_GIF_ERR), and the decoder (errors prefixed
|
|
by D_GIF_ERR). This document explains them briefly:
|
|
|
|
Encoding errors:
|
|
----------------
|
|
|
|
1. E_GIF_ERR_OpenFailed
|
|
Message printed using PrintGifError: "Failed to open given file"
|
|
IO error result when attempt to open the given GIF file.
|
|
|
|
2. E_GIF_ERR_WriteFailed
|
|
Message printed using PrintGifError: "Failed to Write to given file"
|
|
IO error result when attempt to write to the given GIF file.
|
|
|
|
3. E_GIF_ERR_HasScrnDscr
|
|
Message printed using PrintGifError: "Screen Descriptor already been set"
|
|
Attempt to write second screen descriptor to same GIF file. GIF file should
|
|
have exactly one screen descriptor which should be set directly after the
|
|
file is opened.
|
|
|
|
4. E_GIF_ERR_HasImagDscr
|
|
Message printed using PrintGifError: "Image Descriptor is still active"
|
|
Image descriptor should be sent before and image dump, and no second
|
|
image descriptor should be sent before current image dump ended. This error
|
|
occured probably because current image was not complete.
|
|
|
|
5. E_GIF_ERR_NoColorMap
|
|
Message printed using PrintGifError: "Neither Global Nor Local color map"
|
|
An image must have either global (screen) or local (image) color map.
|
|
Neither were given in this case.
|
|
|
|
6. E_GIF_ERR_DataTooBig
|
|
Message printed using PrintGifError: "#Pixels bigger than Width * Height"
|
|
The number of pixels dumped for this image is bigger than specified by
|
|
image Height times image Width.
|
|
|
|
7. E_GIF_ERR_NotEnoughMem
|
|
Message printed using PrintGifError: "Fail to allocate required memory"
|
|
Once an attemp is made to open GIF file, special structures are allocated
|
|
to hold internal data for it. If allocation fails this error is returned.
|
|
|
|
8. E_GIF_ERR_DiskIsFull
|
|
Message printed using PrintGifError: "Write failed (disk full?)"
|
|
Writing encoded data failed.
|
|
|
|
9. E_GIF_ERR_CloseFailed
|
|
Message printed using PrintGifError: "Failed to close given file"
|
|
Closing file failed.
|
|
|
|
10. E_GIF_ERR_NotWriteable
|
|
Message printed using PrintGifError: "Given file was not opened for write"
|
|
GIF files can be opened both for read (DGIF part of library) and write
|
|
(EGIF part of library). This error occurs when a file is opened for read
|
|
(using DGIF) is given to one of the encoding (EGIF) routines.
|
|
|
|
|
|
Encoding errors:
|
|
----------------
|
|
|
|
1. D_GIF_ERR_OpenFailed
|
|
Message printed using PrintGifError: "Failed to open given file"
|
|
IO error result when attempt to open the given GIF file.
|
|
|
|
2. D_GIF_ERR_ReadFailed
|
|
Message printed using PrintGifError: "Failed to Read from given file"
|
|
IO error result when attempt to write to the given GIF file.
|
|
|
|
3. D_GIF_ERR_NotGifFile
|
|
Message printed using PrintGifError: "Given file is NOT GIF file"
|
|
GIF files should have special stamp identifies them as such, If that stamp
|
|
is not found, this error is issued.
|
|
|
|
4. D_GIF_ERR_NoScrnDscr
|
|
Message printed using PrintGifError: "No Screen Descriptor detected"
|
|
Each GIF file should have screen descriptor in its header. This error will
|
|
be generated if no such descriptor was found.
|
|
|
|
5. D_GIF_ERR_NoImagDscr
|
|
Message printed using PrintGifError: "No Image Descriptor detected"
|
|
Each image should have image descriptor in its header. This error will
|
|
be generated if no such descriptor was found.
|
|
|
|
6. D_GIF_ERR_NoColorMap
|
|
Message printed using PrintGifError: "Neither Global Nor Local color map"
|
|
An image must have either global (screen) or local (image) color map.
|
|
Neither were given in this case.
|
|
|
|
7. D_GIF_ERR_WrongRecord
|
|
Message printed using PrintGifError: "Wrong record type detected"
|
|
Each record in GIF file has special identifier, in its header. If the
|
|
record has wrong identifier, this error is generated.
|
|
|
|
8. D_GIF_ERR_DataTooBig
|
|
Message printed using PrintGifError: "#Pixels bigger than Width * Height"
|
|
The number of pixels dumped for this image is bigger than specified by
|
|
image Height times image Width.
|
|
|
|
9. D_GIF_ERR_NotEnoughMem
|
|
Message printed using PrintGifError: "Fail to allocate required memory"
|
|
Once an attemp is made to open GIF file, special structures are allocated
|
|
to hold internal data for it. If allocation fails this error is returned.
|
|
|
|
10. D_GIF_ERR_CloseFailed
|
|
Message printed using PrintGifError: "Failed to close given file"
|
|
Closing file failed.
|
|
|
|
11. D_GIF_ERR_NotReadable
|
|
Message printed using PrintGifError: "Given file was not opened for read"
|
|
GIF files can be opened both for read (DGIF part of library) and write
|
|
(EGIF part of library). This error occurs when a file is opened for write
|
|
(using EGIF) is given to one of the decoding (DGIF) routines.
|
|
|
|
12. D_GIF_ERR_ImageDefect
|
|
Message printed using PrintGifError: "Image is defective, decoding aborted"
|
|
This error is generated, once the decoding failed - probably image is
|
|
defect.
|
|
|
|
13. D_GIF_ERR_EOFTooSoon
|
|
Message printed using PrintGifError: "Image EOF detected, before image complete"
|
|
This error is generated once EOF code is detected in encoded image before
|
|
all the pixels (Width * Height) has be decoded.
|