[wxWidgets.git] / src / jpeg / jidctfst.c

/*
 * jidctfst.c
 *
 * Copyright (C) 1994-1998, Thomas G. Lane.
 * This file is part of the Independent JPEG Group's software.
 * For conditions of distribution and use, see the accompanying README file.
 *
 * This file contains a fast, not so accurate integer implementation of the
 * inverse DCT (Discrete Cosine Transform).  In the IJG code, this routine
 * must also perform dequantization of the input coefficients.
 *
 * A 2-D IDCT can be done by 1-D IDCT on each column followed by 1-D IDCT
 * on each row (or vice versa, but it's more convenient to emit a row at
 * a time).  Direct algorithms are also available, but they are much more
 * complex and seem not to be any faster when reduced to code.
 *
 * This implementation is based on Arai, Agui, and Nakajima's algorithm for
 * scaled DCT.  Their original paper (Trans. IEICE E-71(11):1095) is in
 * Japanese, but the algorithm is described in the Pennebaker & Mitchell
 * JPEG textbook (see REFERENCES section in file README).  The following code
 * is based directly on figure 4-8 in P&M.
 * While an 8-point DCT cannot be done in less than 11 multiplies, it is
 * possible to arrange the computation so that many of the multiplies are
 * simple scalings of the final outputs.  These multiplies can then be
 * folded into the multiplications or divisions by the JPEG quantization
 * table entries.  The AA&N method leaves only 5 multiplies and 29 adds
 * to be done in the DCT itself.
 * The primary disadvantage of this method is that with fixed-point math,
 * accuracy is lost due to imprecise representation of the scaled
 * quantization values.  The smaller the quantization table entry, the less
 * precise the scaled value, so this implementation does worse with high-
 * quality-setting files than with low-quality ones.
 */

#define JPEG_INTERNALS
#include "jinclude.h"
#include "jpeglib.h"
#include "jdct.h"		/* Private declarations for DCT subsystem */

#ifdef DCT_IFAST_SUPPORTED


/*
 * This module is specialized to the case DCTSIZE = 8.
 */

#if DCTSIZE != 8
  Sorry, this code only copes with 8x8 DCTs. /* deliberate syntax err */
#endif


/* Scaling decisions are generally the same as in the LL&M algorithm;
 * see jidctint.c for more details.  However, we choose to descale
 * (right shift) multiplication products as soon as they are formed,
 * rather than carrying additional fractional bits into subsequent additions.
 * This compromises accuracy slightly, but it lets us save a few shifts.
 * More importantly, 16-bit arithmetic is then adequate (for 8-bit samples)
 * everywhere except in the multiplications proper; this saves a good deal
 * of work on 16-bit-int machines.
 *
 * The dequantized coefficients are not integers because the AA&N scaling
 * factors have been incorporated.  We represent them scaled up by PASS1_BITS,
 * so that the first and second IDCT rounds have the same input scaling.
 * For 8-bit JSAMPLEs, we choose IFAST_SCALE_BITS = PASS1_BITS so as to
 * avoid a descaling shift; this compromises accuracy rather drastically
 * for small quantization table entries, but it saves a lot of shifts.
 * For 12-bit JSAMPLEs, there's no hope of using 16x16 multiplies anyway,
 * so we use a much larger scaling factor to preserve accuracy.
 *
 * A final compromise is to represent the multiplicative constants to only
 * 8 fractional bits, rather than 13.  This saves some shifting work on some
 * machines, and may also reduce the cost of multiplication (since there
 * are fewer one-bits in the constants).
 */

#if BITS_IN_JSAMPLE == 8
#define CONST_BITS  8
#define PASS1_BITS  2
#else
#define CONST_BITS  8
#define PASS1_BITS  1		/* lose a little precision to avoid overflow */
#endif

/* Some C compilers fail to reduce "FIX(constant)" at compile time, thus
 * causing a lot of useless floating-point operations at run time.
 * To get around this we use the following pre-calculated constants.
 * If you change CONST_BITS you may want to add appropriate values.
 * (With a reasonable C compiler, you can just rely on the FIX() macro...)
 */

#if CONST_BITS == 8
#define FIX_1_082392200  ((INT32)  277)		/* FIX(1.082392200) */
#define FIX_1_414213562  ((INT32)  362)		/* FIX(1.414213562) */
#define FIX_1_847759065  ((INT32)  473)		/* FIX(1.847759065) */
#define FIX_2_613125930  ((INT32)  669)		/* FIX(2.613125930) */
#else
#define FIX_1_082392200  FIX(1.082392200)
#define FIX_1_414213562  FIX(1.414213562)
#define FIX_1_847759065  FIX(1.847759065)
#define FIX_2_613125930  FIX(2.613125930)
#endif


/* We can gain a little more speed, with a further compromise in accuracy,
 * by omitting the addition in a descaling shift.  This yields an incorrectly
 * rounded result half the time...
 */

#ifndef USE_ACCURATE_ROUNDING
#undef DESCALE
#define DESCALE(x,n)  RIGHT_SHIFT(x, n)
#endif


/* Multiply a DCTELEM variable by an INT32 constant, and immediately
 * descale to yield a DCTELEM result.
 */

#define MULTIPLY(var,const)  ((DCTELEM) DESCALE((var) * (const), CONST_BITS))


/* Dequantize a coefficient by multiplying it by the multiplier-table
 * entry; produce a DCTELEM result.  For 8-bit data a 16x16->16
 * multiplication will do.  For 12-bit data, the multiplier table is
 * declared INT32, so a 32-bit multiply will be used.
 */

#if BITS_IN_JSAMPLE == 8
#define DEQUANTIZE(coef,quantval)  (((IFAST_MULT_TYPE) (coef)) * (quantval))
#else
#define DEQUANTIZE(coef,quantval)  \
	DESCALE((coef)*(quantval), IFAST_SCALE_BITS-PASS1_BITS)
#endif


/* Like DESCALE, but applies to a DCTELEM and produces an int.
 * We assume that int right shift is unsigned if INT32 right shift is.
 */

#ifdef RIGHT_SHIFT_IS_UNSIGNED
#define ISHIFT_TEMPS	DCTELEM ishift_temp;
#if BITS_IN_JSAMPLE == 8
#define DCTELEMBITS  16		/* DCTELEM may be 16 or 32 bits */
#else
#define DCTELEMBITS  32		/* DCTELEM must be 32 bits */
#endif
#define IRIGHT_SHIFT(x,shft)  \
    ((ishift_temp = (x)) < 0 ? \
     (ishift_temp >> (shft)) | ((~((DCTELEM) 0)) << (DCTELEMBITS-(shft))) : \
     (ishift_temp >> (shft)))
#else
#define ISHIFT_TEMPS
#define IRIGHT_SHIFT(x,shft)	((x) >> (shft))
#endif

#ifdef USE_ACCURATE_ROUNDING
#define IDESCALE(x,n)  ((int) IRIGHT_SHIFT((x) + (1 << ((n)-1)), n))
#else
#define IDESCALE(x,n)  ((int) IRIGHT_SHIFT(x, n))
#endif


/*
 * Perform dequantization and inverse DCT on one block of coefficients.
 */

GLOBAL(void)
jpeg_idct_ifast (j_decompress_ptr cinfo, jpeg_component_info * compptr,
		 JCOEFPTR coef_block,
		 JSAMPARRAY output_buf, JDIMENSION output_col)
{
  DCTELEM tmp0, tmp1, tmp2, tmp3, tmp4, tmp5, tmp6, tmp7;
  DCTELEM tmp10, tmp11, tmp12, tmp13;
  DCTELEM z5, z10, z11, z12, z13;
  JCOEFPTR inptr;
  IFAST_MULT_TYPE * quantptr;
  int * wsptr;
  JSAMPROW outptr;
  JSAMPLE *range_limit = IDCT_range_limit(cinfo);
  int ctr;
  int workspace[DCTSIZE2];	/* buffers data between passes */
  SHIFT_TEMPS			/* for DESCALE */
  ISHIFT_TEMPS			/* for IDESCALE */

  /* Pass 1: process columns from input, store into work array. */

  inptr = coef_block;
  quantptr = (IFAST_MULT_TYPE *) compptr->dct_table;
  wsptr = workspace;
  for (ctr = DCTSIZE; ctr > 0; ctr--) {
    /* Due to quantization, we will usually find that many of the input
     * coefficients are zero, especially the AC terms.  We can exploit this
     * by short-circuiting the IDCT calculation for any column in which all
     * the AC terms are zero.  In that case each output is equal to the
     * DC coefficient (with scale factor as needed).
     * With typical images and quantization tables, half or more of the
     * column DCT calculations can be simplified this way.
     */
    
    if (inptr[DCTSIZE*1] == 0 && inptr[DCTSIZE*2] == 0 &&
	inptr[DCTSIZE*3] == 0 && inptr[DCTSIZE*4] == 0 &&
	inptr[DCTSIZE*5] == 0 && inptr[DCTSIZE*6] == 0 &&
	inptr[DCTSIZE*7] == 0) {
      /* AC terms all zero */
      int dcval = (int) DEQUANTIZE(inptr[DCTSIZE*0], quantptr[DCTSIZE*0]);

      wsptr[DCTSIZE*0] = dcval;
      wsptr[DCTSIZE*1] = dcval;
      wsptr[DCTSIZE*2] = dcval;
      wsptr[DCTSIZE*3] = dcval;
      wsptr[DCTSIZE*4] = dcval;
      wsptr[DCTSIZE*5] = dcval;
      wsptr[DCTSIZE*6] = dcval;
      wsptr[DCTSIZE*7] = dcval;
      
      inptr++;			/* advance pointers to next column */
      quantptr++;
      wsptr++;
      continue;
    }
    
    /* Even part */

    tmp0 = DEQUANTIZE(inptr[DCTSIZE*0], quantptr[DCTSIZE*0]);
    tmp1 = DEQUANTIZE(inptr[DCTSIZE*2], quantptr[DCTSIZE*2]);
    tmp2 = DEQUANTIZE(inptr[DCTSIZE*4], quantptr[DCTSIZE*4]);
    tmp3 = DEQUANTIZE(inptr[DCTSIZE*6], quantptr[DCTSIZE*6]);

    tmp10 = tmp0 + tmp2;	/* phase 3 */
    tmp11 = tmp0 - tmp2;

    tmp13 = tmp1 + tmp3;	/* phases 5-3 */
    tmp12 = MULTIPLY(tmp1 - tmp3, FIX_1_414213562) - tmp13; /* 2*c4 */

    tmp0 = tmp10 + tmp13;	/* phase 2 */
    tmp3 = tmp10 - tmp13;
    tmp1 = tmp11 + tmp12;
    tmp2 = tmp11 - tmp12;
    
    /* Odd part */

    tmp4 = DEQUANTIZE(inptr[DCTSIZE*1], quantptr[DCTSIZE*1]);
    tmp5 = DEQUANTIZE(inptr[DCTSIZE*3], quantptr[DCTSIZE*3]);
    tmp6 = DEQUANTIZE(inptr[DCTSIZE*5], quantptr[DCTSIZE*5]);
    tmp7 = DEQUANTIZE(inptr[DCTSIZE*7], quantptr[DCTSIZE*7]);

    z13 = tmp6 + tmp5;		/* phase 6 */
    z10 = tmp6 - tmp5;
    z11 = tmp4 + tmp7;
    z12 = tmp4 - tmp7;

    tmp7 = z11 + z13;		/* phase 5 */
    tmp11 = MULTIPLY(z11 - z13, FIX_1_414213562); /* 2*c4 */

    z5 = MULTIPLY(z10 + z12, FIX_1_847759065); /* 2*c2 */
    tmp10 = MULTIPLY(z12, FIX_1_082392200) - z5; /* 2*(c2-c6) */
    tmp12 = MULTIPLY(z10, - FIX_2_613125930) + z5; /* -2*(c2+c6) */

    tmp6 = tmp12 - tmp7;	/* phase 2 */
    tmp5 = tmp11 - tmp6;
    tmp4 = tmp10 + tmp5;

    wsptr[DCTSIZE*0] = (int) (tmp0 + tmp7);
    wsptr[DCTSIZE*7] = (int) (tmp0 - tmp7);
    wsptr[DCTSIZE*1] = (int) (tmp1 + tmp6);
    wsptr[DCTSIZE*6] = (int) (tmp1 - tmp6);
    wsptr[DCTSIZE*2] = (int) (tmp2 + tmp5);
    wsptr[DCTSIZE*5] = (int) (tmp2 - tmp5);
    wsptr[DCTSIZE*4] = (int) (tmp3 + tmp4);
    wsptr[DCTSIZE*3] = (int) (tmp3 - tmp4);

    inptr++;			/* advance pointers to next column */
    quantptr++;
    wsptr++;
  }
  
  /* Pass 2: process rows from work array, store into output array. */
  /* Note that we must descale the results by a factor of 8 == 2**3, */
  /* and also undo the PASS1_BITS scaling. */

  wsptr = workspace;
  for (ctr = 0; ctr < DCTSIZE; ctr++) {
    outptr = output_buf[ctr] + output_col;
    /* Rows of zeroes can be exploited in the same way as we did with columns.
     * However, the column calculation has created many nonzero AC terms, so
     * the simplification applies less often (typically 5% to 10% of the time).
     * On machines with very fast multiplication, it's possible that the
     * test takes more time than it's worth.  In that case this section
     * may be commented out.
     */
    
#ifndef NO_ZERO_ROW_TEST
    if (wsptr[1] == 0 && wsptr[2] == 0 && wsptr[3] == 0 && wsptr[4] == 0 &&
	wsptr[5] == 0 && wsptr[6] == 0 && wsptr[7] == 0) {
      /* AC terms all zero */
      JSAMPLE dcval = range_limit[IDESCALE(wsptr[0], PASS1_BITS+3)
				  & RANGE_MASK];
      
      outptr[0] = dcval;
      outptr[1] = dcval;
      outptr[2] = dcval;
      outptr[3] = dcval;
      outptr[4] = dcval;
      outptr[5] = dcval;
      outptr[6] = dcval;
      outptr[7] = dcval;

      wsptr += DCTSIZE;		/* advance pointer to next row */
      continue;
    }
#endif
    
    /* Even part */

    tmp10 = ((DCTELEM) wsptr[0] + (DCTELEM) wsptr[4]);
    tmp11 = ((DCTELEM) wsptr[0] - (DCTELEM) wsptr[4]);

    tmp13 = ((DCTELEM) wsptr[2] + (DCTELEM) wsptr[6]);
    tmp12 = MULTIPLY((DCTELEM) wsptr[2] - (DCTELEM) wsptr[6], FIX_1_414213562)
	    - tmp13;

    tmp0 = tmp10 + tmp13;
    tmp3 = tmp10 - tmp13;
    tmp1 = tmp11 + tmp12;
    tmp2 = tmp11 - tmp12;

    /* Odd part */

    z13 = (DCTELEM) wsptr[5] + (DCTELEM) wsptr[3];
    z10 = (DCTELEM) wsptr[5] - (DCTELEM) wsptr[3];
    z11 = (DCTELEM) wsptr[1] + (DCTELEM) wsptr[7];
    z12 = (DCTELEM) wsptr[1] - (DCTELEM) wsptr[7];

    tmp7 = z11 + z13;		/* phase 5 */
    tmp11 = MULTIPLY(z11 - z13, FIX_1_414213562); /* 2*c4 */

    z5 = MULTIPLY(z10 + z12, FIX_1_847759065); /* 2*c2 */
    tmp10 = MULTIPLY(z12, FIX_1_082392200) - z5; /* 2*(c2-c6) */
    tmp12 = MULTIPLY(z10, - FIX_2_613125930) + z5; /* -2*(c2+c6) */

    tmp6 = tmp12 - tmp7;	/* phase 2 */
    tmp5 = tmp11 - tmp6;
    tmp4 = tmp10 + tmp5;

    /* Final output stage: scale down by a factor of 8 and range-limit */

    outptr[0] = range_limit[IDESCALE(tmp0 + tmp7, PASS1_BITS+3)
			    & RANGE_MASK];
    outptr[7] = range_limit[IDESCALE(tmp0 - tmp7, PASS1_BITS+3)
			    & RANGE_MASK];
    outptr[1] = range_limit[IDESCALE(tmp1 + tmp6, PASS1_BITS+3)
			    & RANGE_MASK];
    outptr[6] = range_limit[IDESCALE(tmp1 - tmp6, PASS1_BITS+3)
			    & RANGE_MASK];
    outptr[2] = range_limit[IDESCALE(tmp2 + tmp5, PASS1_BITS+3)
			    & RANGE_MASK];
    outptr[5] = range_limit[IDESCALE(tmp2 - tmp5, PASS1_BITS+3)
			    & RANGE_MASK];
    outptr[4] = range_limit[IDESCALE(tmp3 + tmp4, PASS1_BITS+3)
			    & RANGE_MASK];
    outptr[3] = range_limit[IDESCALE(tmp3 - tmp4, PASS1_BITS+3)
			    & RANGE_MASK];

    wsptr += DCTSIZE;		/* advance pointer to next row */
  }
}

#endif /* DCT_IFAST_SUPPORTED */
Commit	Line	Data
e1929140 RR	1	/*
	2	* jidctfst.c
	3	*
	4	* Copyright (C) 1994-1998, 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 a fast, not so accurate integer implementation of the
	9	* inverse DCT (Discrete Cosine Transform). In the IJG code, this routine
	10	* must also perform dequantization of the input coefficients.
	11	*
	12	* A 2-D IDCT can be done by 1-D IDCT on each column followed by 1-D IDCT
	13	* on each row (or vice versa, but it's more convenient to emit a row at
	14	* a time). Direct algorithms are also available, but they are much more
	15	* complex and seem not to be any faster when reduced to code.
	16	*
	17	* This implementation is based on Arai, Agui, and Nakajima's algorithm for
	18	* scaled DCT. Their original paper (Trans. IEICE E-71(11):1095) is in
	19	* Japanese, but the algorithm is described in the Pennebaker & Mitchell
	20	* JPEG textbook (see REFERENCES section in file README). The following code
	21	* is based directly on figure 4-8 in P&M.
	22	* While an 8-point DCT cannot be done in less than 11 multiplies, it is
	23	* possible to arrange the computation so that many of the multiplies are
	24	* simple scalings of the final outputs. These multiplies can then be
	25	* folded into the multiplications or divisions by the JPEG quantization
	26	* table entries. The AA&N method leaves only 5 multiplies and 29 adds
	27	* to be done in the DCT itself.
	28	* The primary disadvantage of this method is that with fixed-point math,
	29	* accuracy is lost due to imprecise representation of the scaled
	30	* quantization values. The smaller the quantization table entry, the less
	31	* precise the scaled value, so this implementation does worse with high-
	32	* quality-setting files than with low-quality ones.
	33	*/
	34
	35	#define JPEG_INTERNALS
	36	#include "jinclude.h"
	37	#include "jpeglib.h"
	38	#include "jdct.h" /* Private declarations for DCT subsystem */
	39
	40	#ifdef DCT_IFAST_SUPPORTED
	41
	42
	43	/*
	44	* This module is specialized to the case DCTSIZE = 8.
	45	*/
	46
	47	#if DCTSIZE != 8
	48	Sorry, this code only copes with 8x8 DCTs. /* deliberate syntax err */
	49	#endif
	50
	51
	52	/* Scaling decisions are generally the same as in the LL&M algorithm;
	53	* see jidctint.c for more details. However, we choose to descale
	54	* (right shift) multiplication products as soon as they are formed,
	55	* rather than carrying additional fractional bits into subsequent additions.
	56	* This compromises accuracy slightly, but it lets us save a few shifts.
	57	* More importantly, 16-bit arithmetic is then adequate (for 8-bit samples)
	58	* everywhere except in the multiplications proper; this saves a good deal
	59	* of work on 16-bit-int machines.
	60	*
	61	* The dequantized coefficients are not integers because the AA&N scaling
	62	* factors have been incorporated. We represent them scaled up by PASS1_BITS,
	63	* so that the first and second IDCT rounds have the same input scaling.
	64	* For 8-bit JSAMPLEs, we choose IFAST_SCALE_BITS = PASS1_BITS so as to
65	* avoid a descaling shift; this compromises accuracy rather drastically
66	* for small quantization table entries, but it saves a lot of shifts.
67	* For 12-bit JSAMPLEs, there's no hope of using 16x16 multiplies anyway,
68	* so we use a much larger scaling factor to preserve accuracy.
69	*
70	* A final compromise is to represent the multiplicative constants to only
71	* 8 fractional bits, rather than 13. This saves some shifting work on some
72	* machines, and may also reduce the cost of multiplication (since there
73	* are fewer one-bits in the constants).
74	*/
75
76	#if BITS_IN_JSAMPLE == 8
77	#define CONST_BITS 8
78	#define PASS1_BITS 2
79	#else
80	#define CONST_BITS 8
81	#define PASS1_BITS 1 /* lose a little precision to avoid overflow */
82	#endif
83
84	/* Some C compilers fail to reduce "FIX(constant)" at compile time, thus
85	* causing a lot of useless floating-point operations at run time.
86	* To get around this we use the following pre-calculated constants.
87	* If you change CONST_BITS you may want to add appropriate values.
88	* (With a reasonable C compiler, you can just rely on the FIX() macro...)
89	*/
90
91	#if CONST_BITS == 8
92	#define FIX_1_082392200 ((INT32) 277) /* FIX(1.082392200) */
93	#define FIX_1_414213562 ((INT32) 362) /* FIX(1.414213562) */
94	#define FIX_1_847759065 ((INT32) 473) /* FIX(1.847759065) */
95	#define FIX_2_613125930 ((INT32) 669) /* FIX(2.613125930) */
96	#else
97	#define FIX_1_082392200 FIX(1.082392200)
98	#define FIX_1_414213562 FIX(1.414213562)
99	#define FIX_1_847759065 FIX(1.847759065)
100	#define FIX_2_613125930 FIX(2.613125930)
101	#endif
102
103
104	/* We can gain a little more speed, with a further compromise in accuracy,
105	* by omitting the addition in a descaling shift. This yields an incorrectly
106	* rounded result half the time...
107	*/
108
109	#ifndef USE_ACCURATE_ROUNDING
110	#undef DESCALE
111	#define DESCALE(x,n) RIGHT_SHIFT(x, n)
112	#endif
113
114
115	/* Multiply a DCTELEM variable by an INT32 constant, and immediately
116	* descale to yield a DCTELEM result.
117	*/
118
119	#define MULTIPLY(var,const) ((DCTELEM) DESCALE((var) * (const), CONST_BITS))
120
121
122	/* Dequantize a coefficient by multiplying it by the multiplier-table
123	* entry; produce a DCTELEM result. For 8-bit data a 16x16->16
124	* multiplication will do. For 12-bit data, the multiplier table is
125	* declared INT32, so a 32-bit multiply will be used.
126	*/
127
128	#if BITS_IN_JSAMPLE == 8
129	#define DEQUANTIZE(coef,quantval) (((IFAST_MULT_TYPE) (coef)) * (quantval))
130	#else
131	#define DEQUANTIZE(coef,quantval) \
132	DESCALE((coef)*(quantval), IFAST_SCALE_BITS-PASS1_BITS)
133	#endif
134
135
136	/* Like DESCALE, but applies to a DCTELEM and produces an int.
137	* We assume that int right shift is unsigned if INT32 right shift is.
138	*/
139
140	#ifdef RIGHT_SHIFT_IS_UNSIGNED
141	#define ISHIFT_TEMPS DCTELEM ishift_temp;
142	#if BITS_IN_JSAMPLE == 8
143	#define DCTELEMBITS 16 /* DCTELEM may be 16 or 32 bits */
144	#else
145	#define DCTELEMBITS 32 /* DCTELEM must be 32 bits */
146	#endif
147	#define IRIGHT_SHIFT(x,shft) \
148	((ishift_temp = (x)) < 0 ? \
149	(ishift_temp >> (shft)) \| ((~((DCTELEM) 0)) << (DCTELEMBITS-(shft))) : \
150	(ishift_temp >> (shft)))
151	#else
152	#define ISHIFT_TEMPS
153	#define IRIGHT_SHIFT(x,shft) ((x) >> (shft))
154	#endif
155
156	#ifdef USE_ACCURATE_ROUNDING
157	#define IDESCALE(x,n) ((int) IRIGHT_SHIFT((x) + (1 << ((n)-1)), n))
158	#else
159	#define IDESCALE(x,n) ((int) IRIGHT_SHIFT(x, n))
160	#endif
161
162
163	/*
164	* Perform dequantization and inverse DCT on one block of coefficients.
165	*/
166
167	GLOBAL(void)
168	jpeg_idct_ifast (j_decompress_ptr cinfo, jpeg_component_info * compptr,
169	JCOEFPTR coef_block,
170	JSAMPARRAY output_buf, JDIMENSION output_col)
171	{
172	DCTELEM tmp0, tmp1, tmp2, tmp3, tmp4, tmp5, tmp6, tmp7;
173	DCTELEM tmp10, tmp11, tmp12, tmp13;
174	DCTELEM z5, z10, z11, z12, z13;
175	JCOEFPTR inptr;
176	IFAST_MULT_TYPE * quantptr;
177	int * wsptr;
178	JSAMPROW outptr;
179	JSAMPLE *range_limit = IDCT_range_limit(cinfo);
180	int ctr;
181	int workspace[DCTSIZE2]; /* buffers data between passes */
182	SHIFT_TEMPS /* for DESCALE */
183	ISHIFT_TEMPS /* for IDESCALE */
184
185	/* Pass 1: process columns from input, store into work array. */
186
187	inptr = coef_block;
188	quantptr = (IFAST_MULT_TYPE *) compptr->dct_table;
189	wsptr = workspace;
190	for (ctr = DCTSIZE; ctr > 0; ctr--) {
191	/* Due to quantization, we will usually find that many of the input
192	* coefficients are zero, especially the AC terms. We can exploit this
193	* by short-circuiting the IDCT calculation for any column in which all
194	* the AC terms are zero. In that case each output is equal to the
195	* DC coefficient (with scale factor as needed).
196	* With typical images and quantization tables, half or more of the
197	* column DCT calculations can be simplified this way.
198	*/
199
200	if (inptr[DCTSIZE1] == 0 && inptr[DCTSIZE2] == 0 &&
201	inptr[DCTSIZE3] == 0 && inptr[DCTSIZE4] == 0 &&
202	inptr[DCTSIZE5] == 0 && inptr[DCTSIZE6] == 0 &&
203	inptr[DCTSIZE*7] == 0) {
204	/* AC terms all zero */
205	int dcval = (int) DEQUANTIZE(inptr[DCTSIZE0], quantptr[DCTSIZE0]);
206
207	wsptr[DCTSIZE*0] = dcval;
208	wsptr[DCTSIZE*1] = dcval;
209	wsptr[DCTSIZE*2] = dcval;
210	wsptr[DCTSIZE*3] = dcval;
211	wsptr[DCTSIZE*4] = dcval;
212	wsptr[DCTSIZE*5] = dcval;
213	wsptr[DCTSIZE*6] = dcval;
214	wsptr[DCTSIZE*7] = dcval;
215
216	inptr++; /* advance pointers to next column */
217	quantptr++;
218	wsptr++;
219	continue;
220	}
221
222	/* Even part */
223
224	tmp0 = DEQUANTIZE(inptr[DCTSIZE0], quantptr[DCTSIZE0]);
225	tmp1 = DEQUANTIZE(inptr[DCTSIZE2], quantptr[DCTSIZE2]);
226	tmp2 = DEQUANTIZE(inptr[DCTSIZE4], quantptr[DCTSIZE4]);
227	tmp3 = DEQUANTIZE(inptr[DCTSIZE6], quantptr[DCTSIZE6]);
228
229	tmp10 = tmp0 + tmp2; /* phase 3 */
230	tmp11 = tmp0 - tmp2;
231
232	tmp13 = tmp1 + tmp3; /* phases 5-3 */
233	tmp12 = MULTIPLY(tmp1 - tmp3, FIX_1_414213562) - tmp13; /* 2c4 /
234
235	tmp0 = tmp10 + tmp13; /* phase 2 */
236	tmp3 = tmp10 - tmp13;
237	tmp1 = tmp11 + tmp12;
238	tmp2 = tmp11 - tmp12;
239
240	/* Odd part */
241
242	tmp4 = DEQUANTIZE(inptr[DCTSIZE1], quantptr[DCTSIZE1]);
243	tmp5 = DEQUANTIZE(inptr[DCTSIZE3], quantptr[DCTSIZE3]);
244	tmp6 = DEQUANTIZE(inptr[DCTSIZE5], quantptr[DCTSIZE5]);
245	tmp7 = DEQUANTIZE(inptr[DCTSIZE7], quantptr[DCTSIZE7]);
246
247	z13 = tmp6 + tmp5; /* phase 6 */
248	z10 = tmp6 - tmp5;
249	z11 = tmp4 + tmp7;
250	z12 = tmp4 - tmp7;
251
252	tmp7 = z11 + z13; /* phase 5 */
253	tmp11 = MULTIPLY(z11 - z13, FIX_1_414213562); /* 2c4 /
254
255	z5 = MULTIPLY(z10 + z12, FIX_1_847759065); /* 2c2 /
256	tmp10 = MULTIPLY(z12, FIX_1_082392200) - z5; /* 2(c2-c6) /
257	tmp12 = MULTIPLY(z10, - FIX_2_613125930) + z5; /* -2(c2+c6) /
258
259	tmp6 = tmp12 - tmp7; /* phase 2 */
260	tmp5 = tmp11 - tmp6;
261	tmp4 = tmp10 + tmp5;
262
263	wsptr[DCTSIZE*0] = (int) (tmp0 + tmp7);
264	wsptr[DCTSIZE*7] = (int) (tmp0 - tmp7);
265	wsptr[DCTSIZE*1] = (int) (tmp1 + tmp6);
266	wsptr[DCTSIZE*6] = (int) (tmp1 - tmp6);
267	wsptr[DCTSIZE*2] = (int) (tmp2 + tmp5);
268	wsptr[DCTSIZE*5] = (int) (tmp2 - tmp5);
269	wsptr[DCTSIZE*4] = (int) (tmp3 + tmp4);
270	wsptr[DCTSIZE*3] = (int) (tmp3 - tmp4);
271
272	inptr++; /* advance pointers to next column */
273	quantptr++;
274	wsptr++;
275	}
276
277	/* Pass 2: process rows from work array, store into output array. */
278	/* Note that we must descale the results by a factor of 8 == 2*3, /
279	/* and also undo the PASS1_BITS scaling. */
280
281	wsptr = workspace;
282	for (ctr = 0; ctr < DCTSIZE; ctr++) {
283	outptr = output_buf[ctr] + output_col;
284	/* Rows of zeroes can be exploited in the same way as we did with columns.
285	* However, the column calculation has created many nonzero AC terms, so
286	* the simplification applies less often (typically 5% to 10% of the time).
287	* On machines with very fast multiplication, it's possible that the
288	* test takes more time than it's worth. In that case this section
289	* may be commented out.
290	*/
291
292	#ifndef NO_ZERO_ROW_TEST
293	if (wsptr[1] == 0 && wsptr[2] == 0 && wsptr[3] == 0 && wsptr[4] == 0 &&
294	wsptr[5] == 0 && wsptr[6] == 0 && wsptr[7] == 0) {
295	/* AC terms all zero */
296	JSAMPLE dcval = range_limit[IDESCALE(wsptr[0], PASS1_BITS+3)
297	& RANGE_MASK];
298
299	outptr[0] = dcval;
300	outptr[1] = dcval;
301	outptr[2] = dcval;
302	outptr[3] = dcval;
303	outptr[4] = dcval;
304	outptr[5] = dcval;
305	outptr[6] = dcval;
306	outptr[7] = dcval;
307
308	wsptr += DCTSIZE; /* advance pointer to next row */
309	continue;
310	}
311	#endif
312
313	/* Even part */
314
315	tmp10 = ((DCTELEM) wsptr[0] + (DCTELEM) wsptr[4]);
316	tmp11 = ((DCTELEM) wsptr[0] - (DCTELEM) wsptr[4]);
317
318	tmp13 = ((DCTELEM) wsptr[2] + (DCTELEM) wsptr[6]);
319	tmp12 = MULTIPLY((DCTELEM) wsptr[2] - (DCTELEM) wsptr[6], FIX_1_414213562)
320	- tmp13;
321
322	tmp0 = tmp10 + tmp13;
323	tmp3 = tmp10 - tmp13;
324	tmp1 = tmp11 + tmp12;
325	tmp2 = tmp11 - tmp12;
326
327	/* Odd part */
328
329	z13 = (DCTELEM) wsptr[5] + (DCTELEM) wsptr[3];
330	z10 = (DCTELEM) wsptr[5] - (DCTELEM) wsptr[3];
331	z11 = (DCTELEM) wsptr[1] + (DCTELEM) wsptr[7];
332	z12 = (DCTELEM) wsptr[1] - (DCTELEM) wsptr[7];
333
334	tmp7 = z11 + z13; /* phase 5 */
335	tmp11 = MULTIPLY(z11 - z13, FIX_1_414213562); /* 2c4 /
336
337	z5 = MULTIPLY(z10 + z12, FIX_1_847759065); /* 2c2 /
338	tmp10 = MULTIPLY(z12, FIX_1_082392200) - z5; /* 2(c2-c6) /
339	tmp12 = MULTIPLY(z10, - FIX_2_613125930) + z5; /* -2(c2+c6) /
340
341	tmp6 = tmp12 - tmp7; /* phase 2 */
342	tmp5 = tmp11 - tmp6;
343	tmp4 = tmp10 + tmp5;
344
345	/* Final output stage: scale down by a factor of 8 and range-limit */
346
347	outptr[0] = range_limit[IDESCALE(tmp0 + tmp7, PASS1_BITS+3)
348	& RANGE_MASK];
349	outptr[7] = range_limit[IDESCALE(tmp0 - tmp7, PASS1_BITS+3)
350	& RANGE_MASK];
351	outptr[1] = range_limit[IDESCALE(tmp1 + tmp6, PASS1_BITS+3)
352	& RANGE_MASK];
353	outptr[6] = range_limit[IDESCALE(tmp1 - tmp6, PASS1_BITS+3)
354	& RANGE_MASK];
355	outptr[2] = range_limit[IDESCALE(tmp2 + tmp5, PASS1_BITS+3)
356	& RANGE_MASK];
357	outptr[5] = range_limit[IDESCALE(tmp2 - tmp5, PASS1_BITS+3)
358	& RANGE_MASK];
359	outptr[4] = range_limit[IDESCALE(tmp3 + tmp4, PASS1_BITS+3)
360	& RANGE_MASK];
361	outptr[3] = range_limit[IDESCALE(tmp3 - tmp4, PASS1_BITS+3)
362	& RANGE_MASK];
363
364	wsptr += DCTSIZE; /* advance pointer to next row */
365	}
366	}
367
368	#endif /* DCT_IFAST_SUPPORTED */