170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/*
270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * jutils.c
370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine *
470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * Copyright (C) 1991-1996, Thomas G. Lane.
570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * This file is part of the Independent JPEG Group's software.
670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * For conditions of distribution and use, see the accompanying README file.
770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine *
870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * This file contains tables and miscellaneous utility routines needed
970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * for both compression and decompression.
1070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * Note we prefix all global names with "j" to minimize conflicts with
1170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * a surrounding application.
1270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine */
1370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
1470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#define JPEG_INTERNALS
1570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#include "jinclude.h"
1670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#include "jpeglib.h"
1770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
1870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
1970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/*
2070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * jpeg_zigzag_order[i] is the zigzag-order position of the i'th element
2170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * of a DCT block read in natural order (left to right, top to bottom).
2270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine */
2370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
2470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#if 0				/* This table is not actually needed in v6a */
2570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
2670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkineconst int jpeg_zigzag_order[DCTSIZE2] = {
2770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine   0,  1,  5,  6, 14, 15, 27, 28,
2870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine   2,  4,  7, 13, 16, 26, 29, 42,
2970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine   3,  8, 12, 17, 25, 30, 41, 43,
3070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine   9, 11, 18, 24, 31, 40, 44, 53,
3170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  10, 19, 23, 32, 39, 45, 52, 54,
3270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  20, 22, 33, 38, 46, 51, 55, 60,
3370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  21, 34, 37, 47, 50, 56, 59, 61,
3470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  35, 36, 48, 49, 57, 58, 62, 63
3570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine};
3670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
3770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#endif
3870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
3970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/*
4070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * jpeg_natural_order[i] is the natural-order position of the i'th element
4170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * of zigzag order.
4270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine *
4370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * When reading corrupted data, the Huffman decoders could attempt
4470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * to reference an entry beyond the end of this array (if the decoded
4570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * zero run length reaches past the end of the block).  To prevent
4670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * wild stores without adding an inner-loop test, we put some extra
4770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * "63"s after the real entries.  This will cause the extra coefficient
4870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * to be stored in location 63 of the block, not somewhere random.
4970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * The worst case would be a run-length of 15, which means we need 16
5070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * fake entries.
5170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine */
5270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
5370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkineconst int jpeg_natural_order[DCTSIZE2+16] = {
5470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  0,  1,  8, 16,  9,  2,  3, 10,
5570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine 17, 24, 32, 25, 18, 11,  4,  5,
5670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine 12, 19, 26, 33, 40, 48, 41, 34,
5770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine 27, 20, 13,  6,  7, 14, 21, 28,
5870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine 35, 42, 49, 56, 57, 50, 43, 36,
5970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine 29, 22, 15, 23, 30, 37, 44, 51,
6070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine 58, 59, 52, 45, 38, 31, 39, 46,
6170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine 53, 60, 61, 54, 47, 55, 62, 63,
6270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine 63, 63, 63, 63, 63, 63, 63, 63, /* extra entries for safety in decoder */
6370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine 63, 63, 63, 63, 63, 63, 63, 63
6470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine};
6570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
6670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
6770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/*
6870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * Arithmetic utilities
6970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine */
7070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
7170a18cd874a22452aca9e39e22275ed4538ed20bVladimir ChtchetkineGLOBAL(long)
7270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkinejdiv_round_up (long a, long b)
7370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/* Compute a/b rounded up to next integer, ie, ceil(a/b) */
7470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/* Assumes a >= 0, b > 0 */
7570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine{
7670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  return (a + b - 1L) / b;
7770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine}
7870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
7970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
8070a18cd874a22452aca9e39e22275ed4538ed20bVladimir ChtchetkineGLOBAL(long)
8170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkinejround_up (long a, long b)
8270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/* Compute a rounded up to next multiple of b, ie, ceil(a/b)*b */
8370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/* Assumes a >= 0, b > 0 */
8470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine{
8570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  a += b - 1L;
8670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  return a - (a % b);
8770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine}
8870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
8970a18cd874a22452aca9e39e22275ed4538ed20bVladimir ChtchetkineGLOBAL(long)
9070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkinejmin (long a, long b)
9170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine{
9270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  return a < b ? a : b;
9370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine}
9470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
9570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
9670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/* On normal machines we can apply MEMCOPY() and MEMZERO() to sample arrays
9770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * and coefficient-block arrays.  This won't work on 80x86 because the arrays
9870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * are FAR and we're assuming a small-pointer memory model.  However, some
9970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * DOS compilers provide far-pointer versions of memcpy() and memset() even
10070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * in the small-model libraries.  These will be used if USE_FMEM is defined.
10170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * Otherwise, the routines below do it the hard way.  (The performance cost
10270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * is not all that great, because these routines aren't very heavily used.)
10370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine */
10470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
10570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#ifndef NEED_FAR_POINTERS	/* normal case, same as regular macros */
10670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#define FMEMCOPY(dest,src,size)	MEMCOPY(dest,src,size)
10770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#define FMEMZERO(target,size)	MEMZERO(target,size)
10870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#else				/* 80x86 case, define if we can */
10970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#ifdef USE_FMEM
11070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#define FMEMCOPY(dest,src,size)	_fmemcpy((void FAR *)(dest), (const void FAR *)(src), (size_t)(size))
11170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#define FMEMZERO(target,size)	_fmemset((void FAR *)(target), 0, (size_t)(size))
11270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#endif
11370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#endif
11470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
11570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
11670a18cd874a22452aca9e39e22275ed4538ed20bVladimir ChtchetkineGLOBAL(void)
11770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkinejcopy_sample_rows (JSAMPARRAY input_array, int source_row,
11870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine		   JSAMPARRAY output_array, int dest_row,
11970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine		   int num_rows, JDIMENSION num_cols)
12070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/* Copy some rows of samples from one place to another.
12170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * num_rows rows are copied from input_array[source_row++]
12270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * to output_array[dest_row++]; these areas may overlap for duplication.
12370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine * The source and destination arrays must be at least as wide as num_cols.
12470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine */
12570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine{
12670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  register JSAMPROW inptr, outptr;
12770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#ifdef FMEMCOPY
12870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  register size_t count = (size_t) (num_cols * SIZEOF(JSAMPLE));
12970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#else
13070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  register JDIMENSION count;
13170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#endif
13270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  register int row;
13370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
13470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  input_array += source_row;
13570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  output_array += dest_row;
13670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
13770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  for (row = num_rows; row > 0; row--) {
13870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine    inptr = *input_array++;
13970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine    outptr = *output_array++;
14070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#ifdef FMEMCOPY
14170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine    FMEMCOPY(outptr, inptr, count);
14270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#else
14370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine    for (count = num_cols; count > 0; count--)
14470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine      *outptr++ = *inptr++;	/* needn't bother with GETJSAMPLE() here */
14570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#endif
14670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  }
14770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine}
14870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
14970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
15070a18cd874a22452aca9e39e22275ed4538ed20bVladimir ChtchetkineGLOBAL(void)
15170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkinejcopy_block_row (JBLOCKROW input_row, JBLOCKROW output_row,
15270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine		 JDIMENSION num_blocks)
15370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/* Copy a row of coefficient blocks from one place to another. */
15470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine{
15570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#ifdef FMEMCOPY
15670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  FMEMCOPY(output_row, input_row, num_blocks * (DCTSIZE2 * SIZEOF(JCOEF)));
15770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#else
15870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  register JCOEFPTR inptr, outptr;
15970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  register long count;
16070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
16170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  inptr = (JCOEFPTR) input_row;
16270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  outptr = (JCOEFPTR) output_row;
16370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  for (count = (long) num_blocks * DCTSIZE2; count > 0; count--) {
16470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine    *outptr++ = *inptr++;
16570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  }
16670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#endif
16770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine}
16870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
16970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
17070a18cd874a22452aca9e39e22275ed4538ed20bVladimir ChtchetkineGLOBAL(void)
17170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkinejzero_far (void FAR * target, size_t bytestozero)
17270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/* Zero out a chunk of FAR memory. */
17370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine/* This might be sample-array data, block-array data, or alloc_large data. */
17470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine{
17570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#ifdef FMEMZERO
17670a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  FMEMZERO(target, bytestozero);
17770a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#else
17870a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  register char FAR * ptr = (char FAR *) target;
17970a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  register size_t count;
18070a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine
18170a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  for (count = bytestozero; count > 0; count--) {
18270a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine    *ptr++ = 0;
18370a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine  }
18470a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine#endif
18570a18cd874a22452aca9e39e22275ed4538ed20bVladimir Chtchetkine}
186