]>
Commit | Line | Data |
---|---|---|
1 | /* | |
2 | * jutils.c | |
3 | * | |
4 | * Copyright (C) 1991-1996, Thomas G. Lane. | |
5 | * This file is part of the Independent JPEG Group's software. | |
6 | * For conditions of distribution and use, see the accompanying README file. | |
7 | * | |
8 | * This file contains tables and miscellaneous utility routines needed | |
9 | * for both compression and decompression. | |
10 | * Note we prefix all global names with "j" to minimize conflicts with | |
11 | * a surrounding application. | |
12 | */ | |
13 | ||
14 | #define JPEG_INTERNALS | |
15 | #include "jinclude.h" | |
16 | #include "jpeglib.h" | |
17 | ||
18 | ||
19 | /* | |
20 | * jpeg_zigzag_order[i] is the zigzag-order position of the i'th element | |
21 | * of a DCT block read in natural order (left to right, top to bottom). | |
22 | */ | |
23 | ||
24 | #if 0 /* This table is not actually needed in v6a */ | |
25 | ||
26 | const int jpeg_zigzag_order[DCTSIZE2] = { | |
27 | 0, 1, 5, 6, 14, 15, 27, 28, | |
28 | 2, 4, 7, 13, 16, 26, 29, 42, | |
29 | 3, 8, 12, 17, 25, 30, 41, 43, | |
30 | 9, 11, 18, 24, 31, 40, 44, 53, | |
31 | 10, 19, 23, 32, 39, 45, 52, 54, | |
32 | 20, 22, 33, 38, 46, 51, 55, 60, | |
33 | 21, 34, 37, 47, 50, 56, 59, 61, | |
34 | 35, 36, 48, 49, 57, 58, 62, 63 | |
35 | }; | |
36 | ||
37 | #endif | |
38 | ||
39 | /* | |
40 | * jpeg_natural_order[i] is the natural-order position of the i'th element | |
41 | * of zigzag order. | |
42 | * | |
43 | * When reading corrupted data, the Huffman decoders could attempt | |
44 | * to reference an entry beyond the end of this array (if the decoded | |
45 | * zero run length reaches past the end of the block). To prevent | |
46 | * wild stores without adding an inner-loop test, we put some extra | |
47 | * "63"s after the real entries. This will cause the extra coefficient | |
48 | * to be stored in location 63 of the block, not somewhere random. | |
49 | * The worst case would be a run-length of 15, which means we need 16 | |
50 | * fake entries. | |
51 | */ | |
52 | ||
53 | const int jpeg_natural_order[DCTSIZE2+16] = { | |
54 | 0, 1, 8, 16, 9, 2, 3, 10, | |
55 | 17, 24, 32, 25, 18, 11, 4, 5, | |
56 | 12, 19, 26, 33, 40, 48, 41, 34, | |
57 | 27, 20, 13, 6, 7, 14, 21, 28, | |
58 | 35, 42, 49, 56, 57, 50, 43, 36, | |
59 | 29, 22, 15, 23, 30, 37, 44, 51, | |
60 | 58, 59, 52, 45, 38, 31, 39, 46, | |
61 | 53, 60, 61, 54, 47, 55, 62, 63, | |
62 | 63, 63, 63, 63, 63, 63, 63, 63, /* extra entries for safety in decoder */ | |
63 | 63, 63, 63, 63, 63, 63, 63, 63 | |
64 | }; | |
65 | ||
66 | ||
67 | /* | |
68 | * Arithmetic utilities | |
69 | */ | |
70 | ||
71 | GLOBAL(long) | |
72 | jdiv_round_up (long a, long b) | |
73 | /* Compute a/b rounded up to next integer, ie, ceil(a/b) */ | |
74 | /* Assumes a >= 0, b > 0 */ | |
75 | { | |
76 | return (a + b - 1L) / b; | |
77 | } | |
78 | ||
79 | ||
80 | GLOBAL(long) | |
81 | jround_up (long a, long b) | |
82 | /* Compute a rounded up to next multiple of b, ie, ceil(a/b)*b */ | |
83 | /* Assumes a >= 0, b > 0 */ | |
84 | { | |
85 | a += b - 1L; | |
86 | return a - (a % b); | |
87 | } | |
88 | ||
89 | ||
90 | /* On normal machines we can apply MEMCOPY() and MEMZERO() to sample arrays | |
91 | * and coefficient-block arrays. This won't work on 80x86 because the arrays | |
92 | * are FAR and we're assuming a small-pointer memory model. However, some | |
93 | * DOS compilers provide far-pointer versions of memcpy() and memset() even | |
94 | * in the small-model libraries. These will be used if USE_FMEM is defined. | |
95 | * Otherwise, the routines below do it the hard way. (The performance cost | |
96 | * is not all that great, because these routines aren't very heavily used.) | |
97 | */ | |
98 | ||
99 | #ifndef NEED_FAR_POINTERS /* normal case, same as regular macros */ | |
100 | #define FMEMCOPY(dest,src,size) MEMCOPY(dest,src,size) | |
101 | #define FMEMZERO(target,size) MEMZERO(target,size) | |
102 | #else /* 80x86 case, define if we can */ | |
103 | #ifdef USE_FMEM | |
104 | #define FMEMCOPY(dest,src,size) _fmemcpy((void FAR *)(dest), (const void FAR *)(src), (size_t)(size)) | |
105 | #define FMEMZERO(target,size) _fmemset((void FAR *)(target), 0, (size_t)(size)) | |
106 | #endif | |
107 | #endif | |
108 | ||
109 | ||
110 | GLOBAL(void) | |
111 | jcopy_sample_rows (JSAMPARRAY input_array, int source_row, | |
112 | JSAMPARRAY output_array, int dest_row, | |
113 | int num_rows, JDIMENSION num_cols) | |
114 | /* Copy some rows of samples from one place to another. | |
115 | * num_rows rows are copied from input_array[source_row++] | |
116 | * to output_array[dest_row++]; these areas may overlap for duplication. | |
117 | * The source and destination arrays must be at least as wide as num_cols. | |
118 | */ | |
119 | { | |
120 | register JSAMPROW inptr, outptr; | |
121 | #ifdef FMEMCOPY | |
122 | register size_t count = (size_t) (num_cols * SIZEOF(JSAMPLE)); | |
123 | #else | |
124 | register JDIMENSION count; | |
125 | #endif | |
126 | register int row; | |
127 | ||
128 | input_array += source_row; | |
129 | output_array += dest_row; | |
130 | ||
131 | for (row = num_rows; row > 0; row--) { | |
132 | inptr = *input_array++; | |
133 | outptr = *output_array++; | |
134 | #ifdef FMEMCOPY | |
135 | FMEMCOPY(outptr, inptr, count); | |
136 | #else | |
137 | for (count = num_cols; count > 0; count--) | |
138 | *outptr++ = *inptr++; /* needn't bother with GETJSAMPLE() here */ | |
139 | #endif | |
140 | } | |
141 | } | |
142 | ||
143 | ||
144 | GLOBAL(void) | |
145 | jcopy_block_row (JBLOCKROW input_row, JBLOCKROW output_row, | |
146 | JDIMENSION num_blocks) | |
147 | /* Copy a row of coefficient blocks from one place to another. */ | |
148 | { | |
149 | #ifdef FMEMCOPY | |
150 | FMEMCOPY(output_row, input_row, num_blocks * (DCTSIZE2 * SIZEOF(JCOEF))); | |
151 | #else | |
152 | register JCOEFPTR inptr, outptr; | |
153 | register long count; | |
154 | ||
155 | inptr = (JCOEFPTR) input_row; | |
156 | outptr = (JCOEFPTR) output_row; | |
157 | for (count = (long) num_blocks * DCTSIZE2; count > 0; count--) { | |
158 | *outptr++ = *inptr++; | |
159 | } | |
160 | #endif | |
161 | } | |
162 | ||
163 | ||
164 | GLOBAL(void) | |
165 | jzero_far (void FAR * target, size_t bytestozero) | |
166 | /* Zero out a chunk of FAR memory. */ | |
167 | /* This might be sample-array data, block-array data, or alloc_large data. */ | |
168 | { | |
169 | #ifdef FMEMZERO | |
170 | FMEMZERO(target, bytestozero); | |
171 | #else | |
172 | register char FAR * ptr = (char FAR *) target; | |
173 | register size_t count; | |
174 | ||
175 | for (count = bytestozero; count > 0; count--) { | |
176 | *ptr++ = 0; | |
177 | } | |
178 | #endif | |
179 | } |