home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / wxos2240.zip / wxWindows-2.4.0 / src / jpeg / jdcolor.c < prev    next >
C/C++ Source or Header  |  2002-10-16  |  14KB  |  411 lines

  1. /*
  2.  * jdcolor.c
  3.  *
  4.  * Copyright (C) 1991-1997, 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 output colorspace conversion routines.
  9.  */
  10.  
  11. #define JPEG_INTERNALS
  12. #include "jinclude.h"
  13. #include "jpeglib.h"
  14.  
  15. #if defined(__VISAGECPP__)
  16. /* Visual Age fixups for multiple declarations */
  17. #  define null_convert   null_convert2 /* already in jcmaint.c */
  18. #  define grayscale_convert   grayscale_convert2 /* already in jcmaint.c */
  19. #endif
  20.  
  21. /* Private subobject */
  22.  
  23. typedef struct {
  24.   struct jpeg_color_deconverter pub; /* public fields */
  25.  
  26.   /* Private state for YCC->RGB conversion */
  27.   int * Cr_r_tab;        /* => table for Cr to R conversion */
  28.   int * Cb_b_tab;        /* => table for Cb to B conversion */
  29.   JPEG_INT32 * Cr_g_tab;        /* => table for Cr to G conversion */
  30.   JPEG_INT32 * Cb_g_tab;        /* => table for Cb to G conversion */
  31. } my_color_deconverter;
  32.  
  33. typedef my_color_deconverter * my_cconvert_ptr;
  34.  
  35.  
  36. /**************** YCbCr -> RGB conversion: most common case **************/
  37.  
  38. /*
  39.  * YCbCr is defined per CCIR 601-1, except that Cb and Cr are
  40.  * normalized to the range 0..MAXJSAMPLE rather than -0.5 .. 0.5.
  41.  * The conversion equations to be implemented are therefore
  42.  *    R = Y                + 1.40200 * Cr
  43.  *    G = Y - 0.34414 * Cb - 0.71414 * Cr
  44.  *    B = Y + 1.77200 * Cb
  45.  * where Cb and Cr represent the incoming values less CENTERJSAMPLE.
  46.  * (These numbers are derived from TIFF 6.0 section 21, dated 3-June-92.)
  47.  *
  48.  * To avoid floating-point arithmetic, we represent the fractional constants
  49.  * as integers scaled up by 2^16 (about 4 digits precision); we have to divide
  50.  * the products by 2^16, with appropriate rounding, to get the correct answer.
  51.  * Notice that Y, being an integral input, does not contribute any fraction
  52.  * so it need not participate in the rounding.
  53.  *
  54.  * For even more speed, we avoid doing any multiplications in the inner loop
  55.  * by precalculating the constants times Cb and Cr for all possible values.
  56.  * For 8-bit JSAMPLEs this is very reasonable (only 256 entries per table);
  57.  * for 12-bit samples it is still acceptable.  It's not very reasonable for
  58.  * 16-bit samples, but if you want lossless storage you shouldn't be changing
  59.  * colorspace anyway.
  60.  * The Cr=>R and Cb=>B values can be rounded to integers in advance; the
  61.  * values for the G calculation are left scaled up, since we must add them
  62.  * together before rounding.
  63.  */
  64.  
  65. #define SCALEBITS    16    /* speediest right-shift on some machines */
  66. #define ONE_HALF    ((JPEG_INT32) 1 << (SCALEBITS-1))
  67. #define FIX(x)        ((JPEG_INT32) ((x) * (1L<<SCALEBITS) + 0.5))
  68.  
  69.  
  70. /*
  71.  * Initialize tables for YCC->RGB colorspace conversion.
  72.  */
  73.  
  74. LOCAL(void)
  75. build_ycc_rgb_table (j_decompress_ptr cinfo)
  76. {
  77.   my_cconvert_ptr cconvert = (my_cconvert_ptr) cinfo->cconvert;
  78.   int i;
  79.   JPEG_INT32 x;
  80.   SHIFT_TEMPS
  81.  
  82.   cconvert->Cr_r_tab = (int *)
  83.     (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE,
  84.                 (MAXJSAMPLE+1) * SIZEOF(int));
  85.   cconvert->Cb_b_tab = (int *)
  86.     (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE,
  87.                 (MAXJSAMPLE+1) * SIZEOF(int));
  88.   cconvert->Cr_g_tab = (JPEG_INT32 *)
  89.     (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE,
  90.                 (MAXJSAMPLE+1) * SIZEOF(JPEG_INT32));
  91.   cconvert->Cb_g_tab = (JPEG_INT32 *)
  92.     (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE,
  93.                 (MAXJSAMPLE+1) * SIZEOF(JPEG_INT32));
  94.  
  95.   for (i = 0, x = -CENTERJSAMPLE; i <= MAXJSAMPLE; i++, x++) {
  96.     /* i is the actual input pixel value, in the range 0..MAXJSAMPLE */
  97.     /* The Cb or Cr value we are thinking of is x = i - CENTERJSAMPLE */
  98.     /* Cr=>R value is nearest int to 1.40200 * x */
  99.     cconvert->Cr_r_tab[i] = (int)
  100.             RIGHT_SHIFT(FIX(1.40200) * x + ONE_HALF, SCALEBITS);
  101.     /* Cb=>B value is nearest int to 1.77200 * x */
  102.     cconvert->Cb_b_tab[i] = (int)
  103.             RIGHT_SHIFT(FIX(1.77200) * x + ONE_HALF, SCALEBITS);
  104.     /* Cr=>G value is scaled-up -0.71414 * x */
  105.     cconvert->Cr_g_tab[i] = (- FIX(0.71414)) * x;
  106.     /* Cb=>G value is scaled-up -0.34414 * x */
  107.     /* We also add in ONE_HALF so that need not do it in inner loop */
  108.     cconvert->Cb_g_tab[i] = (- FIX(0.34414)) * x + ONE_HALF;
  109.   }
  110. }
  111.  
  112.  
  113. /*
  114.  * Convert some rows of samples to the output colorspace.
  115.  *
  116.  * Note that we change from noninterleaved, one-plane-per-component format
  117.  * to interleaved-pixel format.  The output buffer is therefore three times
  118.  * as wide as the input buffer.
  119.  * A starting row offset is provided only for the input buffer.  The caller
  120.  * can easily adjust the passed output_buf value to accommodate any row
  121.  * offset required on that side.
  122.  */
  123.  
  124. METHODDEF(void)
  125. ycc_rgb_convert (j_decompress_ptr cinfo,
  126.          JSAMPIMAGE input_buf, JDIMENSION input_row,
  127.          JSAMPARRAY output_buf, int num_rows)
  128. {
  129.   my_cconvert_ptr cconvert = (my_cconvert_ptr) cinfo->cconvert;
  130.   register int y, cb, cr;
  131.   register JSAMPROW outptr;
  132.   register JSAMPROW inptr0, inptr1, inptr2;
  133.   register JDIMENSION col;
  134.   JDIMENSION num_cols = cinfo->output_width;
  135.   /* copy these pointers into registers if possible */
  136.   register JSAMPLE * range_limit = cinfo->sample_range_limit;
  137.   register int * Crrtab = cconvert->Cr_r_tab;
  138.   register int * Cbbtab = cconvert->Cb_b_tab;
  139.   register JPEG_INT32 * Crgtab = cconvert->Cr_g_tab;
  140.   register JPEG_INT32 * Cbgtab = cconvert->Cb_g_tab;
  141.   SHIFT_TEMPS
  142.  
  143.   while (--num_rows >= 0) {
  144.     inptr0 = input_buf[0][input_row];
  145.     inptr1 = input_buf[1][input_row];
  146.     inptr2 = input_buf[2][input_row];
  147.     input_row++;
  148.     outptr = *output_buf++;
  149.     for (col = 0; col < num_cols; col++) {
  150.       y  = GETJSAMPLE(inptr0[col]);
  151.       cb = GETJSAMPLE(inptr1[col]);
  152.       cr = GETJSAMPLE(inptr2[col]);
  153.       /* Range-limiting is essential due to noise introduced by DCT losses. */
  154.       outptr[RGB_RED] =   range_limit[y + Crrtab[cr]];
  155.       outptr[RGB_GREEN] = range_limit[y +
  156.                   ((int) RIGHT_SHIFT(Cbgtab[cb] + Crgtab[cr],
  157.                          SCALEBITS))];
  158.       outptr[RGB_BLUE] =  range_limit[y + Cbbtab[cb]];
  159.       outptr += RGB_PIXELSIZE;
  160.     }
  161.   }
  162. }
  163.  
  164.  
  165. /**************** Cases other than YCbCr -> RGB **************/
  166.  
  167.  
  168. /*
  169.  * Color conversion for no colorspace change: just copy the data,
  170.  * converting from separate-planes to interleaved representation.
  171.  */
  172.  
  173. METHODDEF(void)
  174. null_convert (j_decompress_ptr cinfo,
  175.           JSAMPIMAGE input_buf, JDIMENSION input_row,
  176.           JSAMPARRAY output_buf, int num_rows)
  177. {
  178.   register JSAMPROW inptr, outptr;
  179.   register JDIMENSION count;
  180.   register int num_components = cinfo->num_components;
  181.   JDIMENSION num_cols = cinfo->output_width;
  182.   int ci;
  183.  
  184.   while (--num_rows >= 0) {
  185.     for (ci = 0; ci < num_components; ci++) {
  186.       inptr = input_buf[ci][input_row];
  187.       outptr = output_buf[0] + ci;
  188.       for (count = num_cols; count > 0; count--) {
  189.     *outptr = *inptr++;    /* needn't bother with GETJSAMPLE() here */
  190.     outptr += num_components;
  191.       }
  192.     }
  193.     input_row++;
  194.     output_buf++;
  195.   }
  196. }
  197.  
  198.  
  199. /*
  200.  * Color conversion for grayscale: just copy the data.
  201.  * This also works for YCbCr -> grayscale conversion, in which
  202.  * we just copy the Y (luminance) component and ignore chrominance.
  203.  */
  204.  
  205. METHODDEF(void)
  206. grayscale_convert (j_decompress_ptr cinfo,
  207.            JSAMPIMAGE input_buf, JDIMENSION input_row,
  208.            JSAMPARRAY output_buf, int num_rows)
  209. {
  210.   jcopy_sample_rows(input_buf[0], (int) input_row, output_buf, 0,
  211.             num_rows, cinfo->output_width);
  212. }
  213.  
  214.  
  215. /*
  216.  * Convert grayscale to RGB: just duplicate the graylevel three times.
  217.  * This is provided to support applications that don't want to cope
  218.  * with grayscale as a separate case.
  219.  */
  220.  
  221. METHODDEF(void)
  222. gray_rgb_convert (j_decompress_ptr cinfo,
  223.           JSAMPIMAGE input_buf, JDIMENSION input_row,
  224.           JSAMPARRAY output_buf, int num_rows)
  225. {
  226.   register JSAMPROW inptr, outptr;
  227.   register JDIMENSION col;
  228.   JDIMENSION num_cols = cinfo->output_width;
  229.  
  230.   while (--num_rows >= 0) {
  231.     inptr = input_buf[0][input_row++];
  232.     outptr = *output_buf++;
  233.     for (col = 0; col < num_cols; col++) {
  234.       /* We can dispense with GETJSAMPLE() here */
  235.       outptr[RGB_RED] = outptr[RGB_GREEN] = outptr[RGB_BLUE] = inptr[col];
  236.       outptr += RGB_PIXELSIZE;
  237.     }
  238.   }
  239. }
  240.  
  241.  
  242. /*
  243.  * Adobe-style YCCK->CMYK conversion.
  244.  * We convert YCbCr to R=1-C, G=1-M, and B=1-Y using the same
  245.  * conversion as above, while passing K (black) unchanged.
  246.  * We assume build_ycc_rgb_table has been called.
  247.  */
  248.  
  249. METHODDEF(void)
  250. ycck_cmyk_convert (j_decompress_ptr cinfo,
  251.            JSAMPIMAGE input_buf, JDIMENSION input_row,
  252.            JSAMPARRAY output_buf, int num_rows)
  253. {
  254.   my_cconvert_ptr cconvert = (my_cconvert_ptr) cinfo->cconvert;
  255.   register int y, cb, cr;
  256.   register JSAMPROW outptr;
  257.   register JSAMPROW inptr0, inptr1, inptr2, inptr3;
  258.   register JDIMENSION col;
  259.   JDIMENSION num_cols = cinfo->output_width;
  260.   /* copy these pointers into registers if possible */
  261.   register JSAMPLE * range_limit = cinfo->sample_range_limit;
  262.   register int * Crrtab = cconvert->Cr_r_tab;
  263.   register int * Cbbtab = cconvert->Cb_b_tab;
  264.   register JPEG_INT32 * Crgtab = cconvert->Cr_g_tab;
  265.   register JPEG_INT32 * Cbgtab = cconvert->Cb_g_tab;
  266.   SHIFT_TEMPS
  267.  
  268.   while (--num_rows >= 0) {
  269.     inptr0 = input_buf[0][input_row];
  270.     inptr1 = input_buf[1][input_row];
  271.     inptr2 = input_buf[2][input_row];
  272.     inptr3 = input_buf[3][input_row];
  273.     input_row++;
  274.     outptr = *output_buf++;
  275.     for (col = 0; col < num_cols; col++) {
  276.       y  = GETJSAMPLE(inptr0[col]);
  277.       cb = GETJSAMPLE(inptr1[col]);
  278.       cr = GETJSAMPLE(inptr2[col]);
  279.       /* Range-limiting is essential due to noise introduced by DCT losses. */
  280.       outptr[0] = range_limit[MAXJSAMPLE - (y + Crrtab[cr])];    /* red */
  281.       outptr[1] = range_limit[MAXJSAMPLE - (y +            /* green */
  282.                   ((int) RIGHT_SHIFT(Cbgtab[cb] + Crgtab[cr],
  283.                          SCALEBITS)))];
  284.       outptr[2] = range_limit[MAXJSAMPLE - (y + Cbbtab[cb])];    /* blue */
  285.       /* K passes through unchanged */
  286.       outptr[3] = inptr3[col];    /* don't need GETJSAMPLE here */
  287.       outptr += 4;
  288.     }
  289.   }
  290. }
  291.  
  292.  
  293. /*
  294.  * Empty method for start_pass.
  295.  */
  296.  
  297. METHODDEF(void)
  298. start_pass_dcolor (j_decompress_ptr cinfo)
  299. {
  300.   /* no work needed */
  301. }
  302.  
  303.  
  304. /*
  305.  * Module initialization routine for output colorspace conversion.
  306.  */
  307.  
  308. GLOBAL(void)
  309. jinit_color_deconverter (j_decompress_ptr cinfo)
  310. {
  311.   my_cconvert_ptr cconvert;
  312.   int ci;
  313.  
  314.   cconvert = (my_cconvert_ptr)
  315.     (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE,
  316.                 SIZEOF(my_color_deconverter));
  317.   cinfo->cconvert = (struct jpeg_color_deconverter *) cconvert;
  318.   cconvert->pub.start_pass = start_pass_dcolor;
  319.  
  320.   /* Make sure num_components agrees with jpeg_color_space */
  321.   switch (cinfo->jpeg_color_space) {
  322.   case JCS_GRAYSCALE:
  323.     if (cinfo->num_components != 1)
  324.       ERREXIT(cinfo, JERR_BAD_J_COLORSPACE);
  325.     break;
  326.  
  327.   case JCS_RGB:
  328.   case JCS_YCbCr:
  329.     if (cinfo->num_components != 3)
  330.       ERREXIT(cinfo, JERR_BAD_J_COLORSPACE);
  331.     break;
  332.  
  333.   case JCS_CMYK:
  334.   case JCS_YCCK:
  335.     if (cinfo->num_components != 4)
  336.       ERREXIT(cinfo, JERR_BAD_J_COLORSPACE);
  337.     break;
  338.  
  339.   default:            /* JCS_UNKNOWN can be anything */
  340.     if (cinfo->num_components < 1)
  341.       ERREXIT(cinfo, JERR_BAD_J_COLORSPACE);
  342.     break;
  343.   }
  344.  
  345.   /* Set out_color_components and conversion method based on requested space.
  346.    * Also clear the component_needed flags for any unused components,
  347.    * so that earlier pipeline stages can avoid useless computation.
  348.    */
  349.  
  350.   switch (cinfo->out_color_space) {
  351.   case JCS_GRAYSCALE:
  352.     cinfo->out_color_components = 1;
  353.     if (cinfo->jpeg_color_space == JCS_GRAYSCALE ||
  354.     cinfo->jpeg_color_space == JCS_YCbCr) {
  355.       cconvert->pub.color_convert = grayscale_convert;
  356.       /* For color->grayscale conversion, only the Y (0) component is needed */
  357.       for (ci = 1; ci < cinfo->num_components; ci++)
  358.     cinfo->comp_info[ci].component_needed = FALSE;
  359.     } else
  360.       ERREXIT(cinfo, JERR_CONVERSION_NOTIMPL);
  361.     break;
  362.  
  363.   case JCS_RGB:
  364.     cinfo->out_color_components = RGB_PIXELSIZE;
  365.     if (cinfo->jpeg_color_space == JCS_YCbCr) {
  366.       cconvert->pub.color_convert = ycc_rgb_convert;
  367.       build_ycc_rgb_table(cinfo);
  368.     } else if (cinfo->jpeg_color_space == JCS_GRAYSCALE) {
  369.       cconvert->pub.color_convert = gray_rgb_convert;
  370.     } else if (cinfo->jpeg_color_space == JCS_RGB && RGB_PIXELSIZE == 3) {
  371.       cconvert->pub.color_convert = null_convert;
  372.     } else
  373.       ERREXIT(cinfo, JERR_CONVERSION_NOTIMPL);
  374.     break;
  375.  
  376.   case JCS_CMYK:
  377.     cinfo->out_color_components = 4;
  378.     if (cinfo->jpeg_color_space == JCS_YCCK) {
  379.       cconvert->pub.color_convert = ycck_cmyk_convert;
  380.       build_ycc_rgb_table(cinfo);
  381.     } else if (cinfo->jpeg_color_space == JCS_CMYK) {
  382.       cconvert->pub.color_convert = null_convert;
  383.     } else
  384.       ERREXIT(cinfo, JERR_CONVERSION_NOTIMPL);
  385.     break;
  386.  
  387.   default:
  388.     /* Permit null conversion to same output space */
  389.     if (cinfo->out_color_space == cinfo->jpeg_color_space) {
  390.       cinfo->out_color_components = cinfo->num_components;
  391.       cconvert->pub.color_convert = null_convert;
  392.     } else            /* unsupported non-null conversion */
  393.       ERREXIT(cinfo, JERR_CONVERSION_NOTIMPL);
  394.     break;
  395.   }
  396.  
  397.   if (cinfo->quantize_colors)
  398.     cinfo->output_components = 1; /* single colormapped output component */
  399.   else
  400.     cinfo->output_components = cinfo->out_color_components;
  401. }
  402.  
  403. #if defined(__VISAGECPP__)
  404. #  ifdef null_convert2
  405. #   undef null_convert2
  406. #  endif
  407. #  ifdef grayscale_convert2
  408. #   undef grayscale_convert2
  409. #  endif
  410. #endif
  411.