123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361 |
- /*
- * The Python Imaging Library.
- * $Id$
- *
- * encoder for uncompressed GIF data
- *
- * history:
- * 97-01-05 fl created (writes uncompressed data)
- * 97-08-27 fl fixed off-by-one error in buffer size test
- * 98-07-09 fl added interlace write support
- * 99-02-07 fl rewritten, now uses a run-length encoding strategy
- * 99-02-08 fl improved run-length encoding for long runs
- * 2020-12-12 rdg Reworked for LZW compression.
- *
- * Copyright (c) Secret Labs AB 1997-99.
- * Copyright (c) Fredrik Lundh 1997.
- *
- * See the README file for information on usage and redistribution.
- */
- #include "Imaging.h"
- #include "Gif.h"
- enum { INIT, ENCODE, FINISH };
- /* GIF LZW encoder by Raymond Gardner. */
- /* Released here under PIL license. */
- /* This LZW encoder conforms to the GIF LZW format specified in the original
- * Compuserve GIF 87a and GIF 89a specifications (see e.g.
- * https://www.w3.org/Graphics/GIF/spec-gif87.txt Appendix C and
- * https://www.w3.org/Graphics/GIF/spec-gif89a.txt Appendix F).
- */
- /* Return values */
- #define GLZW_OK 0
- #define GLZW_NO_INPUT_AVAIL 1
- #define GLZW_NO_OUTPUT_AVAIL 2
- #define GLZW_INTERNAL_ERROR 3
- #define CODE_LIMIT 4096
- /* Values of entry_state */
- enum { LZW_INITIAL, LZW_TRY_IN1, LZW_TRY_IN2, LZW_TRY_OUT1, LZW_TRY_OUT2,
- LZW_FINISHED };
- /* Values of control_state */
- enum { PUT_HEAD, PUT_INIT_CLEAR, PUT_CLEAR, PUT_LAST_HEAD, PUT_END };
- static void glzwe_reset(GIFENCODERSTATE *st) {
- st->next_code = st->end_code + 1;
- st->max_code = 2 * st->clear_code - 1;
- st->code_width = st->bits + 1;
- memset(st->codes, 0, sizeof(st->codes));
- }
- static void glzwe_init(GIFENCODERSTATE *st) {
- st->clear_code = 1 << st->bits;
- st->end_code = st->clear_code + 1;
- glzwe_reset(st);
- st->entry_state = LZW_INITIAL;
- st->buf_bits_left = 8;
- st->code_buffer = 0;
- }
- static int glzwe(GIFENCODERSTATE *st, const UINT8 *in_ptr, UINT8 *out_ptr,
- UINT32 *in_avail, UINT32 *out_avail,
- UINT32 end_of_data) {
- switch (st->entry_state) {
- case LZW_TRY_IN1:
- get_first_byte:
- if (!*in_avail) {
- if (end_of_data) {
- goto end_of_data;
- }
- st->entry_state = LZW_TRY_IN1;
- return GLZW_NO_INPUT_AVAIL;
- }
- st->head = *in_ptr++;
- (*in_avail)--;
- case LZW_TRY_IN2:
- encode_loop:
- if (!*in_avail) {
- if (end_of_data) {
- st->code = st->head;
- st->put_state = PUT_LAST_HEAD;
- goto put_code;
- }
- st->entry_state = LZW_TRY_IN2;
- return GLZW_NO_INPUT_AVAIL;
- }
- st->tail = *in_ptr++;
- (*in_avail)--;
- /* Knuth TAOCP vol 3 sec. 6.4 algorithm D. */
- /* Hash found experimentally to be pretty good. */
- /* This works ONLY with TABLE_SIZE a power of 2. */
- st->probe = ((st->head ^ (st->tail << 6)) * 31) & (TABLE_SIZE - 1);
- while (st->codes[st->probe]) {
- if ((st->codes[st->probe] & 0xFFFFF) ==
- ((st->head << 8) | st->tail)) {
- st->head = st->codes[st->probe] >> 20;
- goto encode_loop;
- } else {
- /* Reprobe decrement must be nonzero and relatively prime to table
- * size. So, any odd positive number for power-of-2 size. */
- if ((st->probe -= ((st->tail << 2) | 1)) < 0) {
- st->probe += TABLE_SIZE;
- }
- }
- }
- /* Key not found, probe is at empty slot. */
- st->code = st->head;
- st->put_state = PUT_HEAD;
- goto put_code;
- insert_code_or_clear: /* jump here after put_code */
- if (st->next_code < CODE_LIMIT) {
- st->codes[st->probe] = (st->next_code << 20) |
- (st->head << 8) | st->tail;
- if (st->next_code > st->max_code) {
- st->max_code = st->max_code * 2 + 1;
- st->code_width++;
- }
- st->next_code++;
- } else {
- st->code = st->clear_code;
- st->put_state = PUT_CLEAR;
- goto put_code;
- reset_after_clear: /* jump here after put_code */
- glzwe_reset(st);
- }
- st->head = st->tail;
- goto encode_loop;
- case LZW_INITIAL:
- glzwe_reset(st);
- st->code = st->clear_code;
- st->put_state = PUT_INIT_CLEAR;
- put_code:
- st->code_bits_left = st->code_width;
- check_buf_bits:
- if (!st->buf_bits_left) { /* out buffer full */
- case LZW_TRY_OUT1:
- if (!*out_avail) {
- st->entry_state = LZW_TRY_OUT1;
- return GLZW_NO_OUTPUT_AVAIL;
- }
- *out_ptr++ = st->code_buffer;
- (*out_avail)--;
- st->code_buffer = 0;
- st->buf_bits_left = 8;
- }
- /* code bits to pack */
- UINT32 n = st->buf_bits_left < st->code_bits_left
- ? st->buf_bits_left : st->code_bits_left;
- st->code_buffer |=
- (st->code & ((1 << n) - 1)) << (8 - st->buf_bits_left);
- st->code >>= n;
- st->buf_bits_left -= n;
- st->code_bits_left -= n;
- if (st->code_bits_left) {
- goto check_buf_bits;
- }
- switch (st->put_state) {
- case PUT_INIT_CLEAR:
- goto get_first_byte;
- case PUT_HEAD:
- goto insert_code_or_clear;
- case PUT_CLEAR:
- goto reset_after_clear;
- case PUT_LAST_HEAD:
- goto end_of_data;
- case PUT_END:
- goto flush_code_buffer;
- default:
- return GLZW_INTERNAL_ERROR;
- }
- end_of_data:
- st->code = st->end_code;
- st->put_state = PUT_END;
- goto put_code;
- flush_code_buffer: /* jump here after put_code */
- if (st->buf_bits_left < 8) {
- case LZW_TRY_OUT2:
- if (!*out_avail) {
- st->entry_state = LZW_TRY_OUT2;
- return GLZW_NO_OUTPUT_AVAIL;
- }
- *out_ptr++ = st->code_buffer;
- (*out_avail)--;
- }
- st->entry_state = LZW_FINISHED;
- return GLZW_OK;
- case LZW_FINISHED:
- return GLZW_OK;
- default:
- return GLZW_INTERNAL_ERROR;
- }
- }
- /* -END- GIF LZW encoder. */
- int
- ImagingGifEncode(Imaging im, ImagingCodecState state, UINT8* buf, int bytes) {
- UINT8* ptr;
- UINT8* sub_block_ptr;
- UINT8* sub_block_limit;
- UINT8* buf_limit;
- GIFENCODERSTATE *context = (GIFENCODERSTATE*) state->context;
- int r;
- UINT32 in_avail, in_used;
- UINT32 out_avail, out_used;
- if (state->state == INIT) {
- state->state = ENCODE;
- glzwe_init(context);
- if (context->interlace) {
- context->interlace = 1;
- context->step = 8;
- } else {
- context->step = 1;
- }
- /* Need at least 2 bytes for data sub-block; 5 for empty image */
- if (bytes < 5) {
- state->errcode = IMAGING_CODEC_CONFIG;
- return 0;
- }
- /* sanity check */
- if (state->xsize <= 0 || state->ysize <= 0) {
- /* Is this better than an error return? */
- /* This will handle any legal "LZW Minimum Code Size" */
- memset(buf, 0, 5);
- in_avail = 0;
- out_avail = 5;
- r = glzwe(context, (const UINT8 *)"", buf + 1, &in_avail, &out_avail, 1);
- if (r == GLZW_OK) {
- r = 5 - out_avail;
- if (r < 1 || r > 3) {
- state->errcode = IMAGING_CODEC_BROKEN;
- return 0;
- }
- buf[0] = r;
- state->errcode = IMAGING_CODEC_END;
- return r + 2;
- } else {
- /* Should not be possible unless something external to this
- * routine messes with our state data */
- state->errcode = IMAGING_CODEC_BROKEN;
- return 0;
- }
- }
- /* Init state->x to make if() below true the first time through. */
- state->x = state->xsize;
- }
- buf_limit = buf + bytes;
- sub_block_limit = sub_block_ptr = ptr = buf;
- /* On entry, buf is output buffer, bytes is space available in buf.
- * Loop here getting input until buf is full or image is all encoded. */
- for (;;) {
- /* Set up sub-block ptr and limit. sub_block_ptr stays at beginning
- * of sub-block until it is full. ptr will advance when any data is
- * placed in buf.
- */
- if (ptr >= sub_block_limit) {
- if (buf_limit - ptr < 2) { /* Need at least 2 for data sub-block */
- return ptr - buf;
- }
- sub_block_ptr = ptr;
- sub_block_limit = sub_block_ptr +
- (256 < buf_limit - sub_block_ptr ?
- 256 : buf_limit - sub_block_ptr);
- *ptr++ = 0;
- }
- /* Get next row of pixels. */
- /* This if() originally tested state->x==0 for the first time through.
- * This no longer works, as the loop will not advance state->x if
- * glzwe() does not consume any input; this would advance the row
- * spuriously. Now pre-init state->x above for first time, and avoid
- * entering if() when state->state is FINISH, or it will loop
- * infinitely.
- */
- if (state->x >= state->xsize && state->state == ENCODE) {
- if (!context->interlace && state->y >= state->ysize) {
- state->state = FINISH;
- continue;
- }
- /* get another line of data */
- state->shuffle(
- state->buffer,
- (UINT8*) im->image[state->y + state->yoff] +
- state->xoff * im->pixelsize, state->xsize
- );
- state->x = 0;
- /* step forward, according to the interlace settings */
- state->y += context->step;
- while (context->interlace && state->y >= state->ysize) {
- switch (context->interlace) {
- case 1:
- state->y = 4;
- context->interlace = 2;
- break;
- case 2:
- context->step = 4;
- state->y = 2;
- context->interlace = 3;
- break;
- case 3:
- context->step = 2;
- state->y = 1;
- context->interlace = 0;
- break;
- default:
- /* just make sure we don't loop forever */
- context->interlace = 0;
- }
- }
- }
- in_avail = state->xsize - state->x; /* bytes left in line */
- out_avail = sub_block_limit - ptr; /* bytes left in sub-block */
- r = glzwe(context, &state->buffer[state->x], ptr, &in_avail,
- &out_avail, state->state == FINISH);
- out_used = sub_block_limit - ptr - out_avail;
- *sub_block_ptr += out_used;
- ptr += out_used;
- in_used = state->xsize - state->x - in_avail;
- state->x += in_used;
- if (r == GLZW_OK) {
- /* Should not be possible when end-of-data flag is false. */
- state->errcode = IMAGING_CODEC_END;
- return ptr - buf;
- } else if (r == GLZW_NO_INPUT_AVAIL) {
- /* Used all the input line; get another line */
- continue;
- } else if (r == GLZW_NO_OUTPUT_AVAIL) {
- /* subblock is full */
- continue;
- } else {
- /* Should not be possible unless something external to this
- * routine messes with our state data */
- state->errcode = IMAGING_CODEC_BROKEN;
- return 0;
- }
- }
- }
|