Home | History | Annotate | Download | only in jpeg
      1 /*
      2  * wrppm.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 routines to write output images in PPM/PGM format.
      9  * The extended 2-byte-per-sample raw PPM/PGM formats are supported.
     10  * The PBMPLUS library is NOT required to compile this software
     11  * (but it is highly useful as a set of PPM image manipulation programs).
     12  *
     13  * These routines may need modification for non-Unix environments or
     14  * specialized applications.  As they stand, they assume output to
     15  * an ordinary stdio stream.
     16  */
     17 
     18 #include "cdjpeg.h"		/* Common decls for cjpeg/djpeg applications */
     19 
     20 #ifdef PPM_SUPPORTED
     21 
     22 
     23 /*
     24  * For 12-bit JPEG data, we either downscale the values to 8 bits
     25  * (to write standard byte-per-sample PPM/PGM files), or output
     26  * nonstandard word-per-sample PPM/PGM files.  Downscaling is done
     27  * if PPM_NORAWWORD is defined (this can be done in the Makefile
     28  * or in jconfig.h).
     29  * (When the core library supports data precision reduction, a cleaner
     30  * implementation will be to ask for that instead.)
     31  */
     32 
     33 #if BITS_IN_JSAMPLE == 8
     34 #define PUTPPMSAMPLE(ptr,v)  *ptr++ = (char) (v)
     35 #define BYTESPERSAMPLE 1
     36 #define PPM_MAXVAL 255
     37 #else
     38 #ifdef PPM_NORAWWORD
     39 #define PUTPPMSAMPLE(ptr,v)  *ptr++ = (char) ((v) >> (BITS_IN_JSAMPLE-8))
     40 #define BYTESPERSAMPLE 1
     41 #define PPM_MAXVAL 255
     42 #else
     43 /* The word-per-sample format always puts the LSB first. */
     44 #define PUTPPMSAMPLE(ptr,v)			\
     45 	{ register int val_ = v;		\
     46 	  *ptr++ = (char) (val_ & 0xFF);	\
     47 	  *ptr++ = (char) ((val_ >> 8) & 0xFF);	\
     48 	}
     49 #define BYTESPERSAMPLE 2
     50 #define PPM_MAXVAL ((1<<BITS_IN_JSAMPLE)-1)
     51 #endif
     52 #endif
     53 
     54 
     55 /*
     56  * When JSAMPLE is the same size as char, we can just fwrite() the
     57  * decompressed data to the PPM or PGM file.  On PCs, in order to make this
     58  * work the output buffer must be allocated in near data space, because we are
     59  * assuming small-data memory model wherein fwrite() can't reach far memory.
     60  * If you need to process very wide images on a PC, you might have to compile
     61  * in large-memory model, or else replace fwrite() with a putc() loop ---
     62  * which will be much slower.
     63  */
     64 
     65 
     66 /* Private version of data destination object */
     67 
     68 typedef struct {
     69   struct djpeg_dest_struct pub;	/* public fields */
     70 
     71   /* Usually these two pointers point to the same place: */
     72   char *iobuffer;		/* fwrite's I/O buffer */
     73   JSAMPROW pixrow;		/* decompressor output buffer */
     74   size_t buffer_width;		/* width of I/O buffer */
     75   JDIMENSION samples_per_row;	/* JSAMPLEs per output row */
     76 } ppm_dest_struct;
     77 
     78 typedef ppm_dest_struct * ppm_dest_ptr;
     79 
     80 
     81 /*
     82  * Write some pixel data.
     83  * In this module rows_supplied will always be 1.
     84  *
     85  * put_pixel_rows handles the "normal" 8-bit case where the decompressor
     86  * output buffer is physically the same as the fwrite buffer.
     87  */
     88 
     89 METHODDEF(void)
     90 put_pixel_rows (j_decompress_ptr cinfo, djpeg_dest_ptr dinfo,
     91 		JDIMENSION rows_supplied)
     92 {
     93   ppm_dest_ptr dest = (ppm_dest_ptr) dinfo;
     94 
     95   (void) JFWRITE(dest->pub.output_file, dest->iobuffer, dest->buffer_width);
     96 }
     97 
     98 
     99 /*
    100  * This code is used when we have to copy the data and apply a pixel
    101  * format translation.  Typically this only happens in 12-bit mode.
    102  */
    103 
    104 METHODDEF(void)
    105 copy_pixel_rows (j_decompress_ptr cinfo, djpeg_dest_ptr dinfo,
    106 		 JDIMENSION rows_supplied)
    107 {
    108   ppm_dest_ptr dest = (ppm_dest_ptr) dinfo;
    109   register char * bufferptr;
    110   register JSAMPROW ptr;
    111   register JDIMENSION col;
    112 
    113   ptr = dest->pub.buffer[0];
    114   bufferptr = dest->iobuffer;
    115   for (col = dest->samples_per_row; col > 0; col--) {
    116     PUTPPMSAMPLE(bufferptr, GETJSAMPLE(*ptr++));
    117   }
    118   (void) JFWRITE(dest->pub.output_file, dest->iobuffer, dest->buffer_width);
    119 }
    120 
    121 
    122 /*
    123  * Write some pixel data when color quantization is in effect.
    124  * We have to demap the color index values to straight data.
    125  */
    126 
    127 METHODDEF(void)
    128 put_demapped_rgb (j_decompress_ptr cinfo, djpeg_dest_ptr dinfo,
    129 		  JDIMENSION rows_supplied)
    130 {
    131   ppm_dest_ptr dest = (ppm_dest_ptr) dinfo;
    132   register char * bufferptr;
    133   register int pixval;
    134   register JSAMPROW ptr;
    135   register JSAMPROW color_map0 = cinfo->colormap[0];
    136   register JSAMPROW color_map1 = cinfo->colormap[1];
    137   register JSAMPROW color_map2 = cinfo->colormap[2];
    138   register JDIMENSION col;
    139 
    140   ptr = dest->pub.buffer[0];
    141   bufferptr = dest->iobuffer;
    142   for (col = cinfo->output_width; col > 0; col--) {
    143     pixval = GETJSAMPLE(*ptr++);
    144     PUTPPMSAMPLE(bufferptr, GETJSAMPLE(color_map0[pixval]));
    145     PUTPPMSAMPLE(bufferptr, GETJSAMPLE(color_map1[pixval]));
    146     PUTPPMSAMPLE(bufferptr, GETJSAMPLE(color_map2[pixval]));
    147   }
    148   (void) JFWRITE(dest->pub.output_file, dest->iobuffer, dest->buffer_width);
    149 }
    150 
    151 
    152 METHODDEF(void)
    153 put_demapped_gray (j_decompress_ptr cinfo, djpeg_dest_ptr dinfo,
    154 		   JDIMENSION rows_supplied)
    155 {
    156   ppm_dest_ptr dest = (ppm_dest_ptr) dinfo;
    157   register char * bufferptr;
    158   register JSAMPROW ptr;
    159   register JSAMPROW color_map = cinfo->colormap[0];
    160   register JDIMENSION col;
    161 
    162   ptr = dest->pub.buffer[0];
    163   bufferptr = dest->iobuffer;
    164   for (col = cinfo->output_width; col > 0; col--) {
    165     PUTPPMSAMPLE(bufferptr, GETJSAMPLE(color_map[GETJSAMPLE(*ptr++)]));
    166   }
    167   (void) JFWRITE(dest->pub.output_file, dest->iobuffer, dest->buffer_width);
    168 }
    169 
    170 
    171 /*
    172  * Startup: write the file header.
    173  */
    174 
    175 METHODDEF(void)
    176 start_output_ppm (j_decompress_ptr cinfo, djpeg_dest_ptr dinfo)
    177 {
    178   ppm_dest_ptr dest = (ppm_dest_ptr) dinfo;
    179 
    180   /* Emit file header */
    181   switch (cinfo->out_color_space) {
    182   case JCS_GRAYSCALE:
    183     /* emit header for raw PGM format */
    184     fprintf(dest->pub.output_file, "P5\n%ld %ld\n%d\n",
    185 	    (long) cinfo->output_width, (long) cinfo->output_height,
    186 	    PPM_MAXVAL);
    187     break;
    188   case JCS_RGB:
    189     /* emit header for raw PPM format */
    190     fprintf(dest->pub.output_file, "P6\n%ld %ld\n%d\n",
    191 	    (long) cinfo->output_width, (long) cinfo->output_height,
    192 	    PPM_MAXVAL);
    193     break;
    194   default:
    195     ERREXIT(cinfo, JERR_PPM_COLORSPACE);
    196   }
    197 }
    198 
    199 
    200 /*
    201  * Finish up at the end of the file.
    202  */
    203 
    204 METHODDEF(void)
    205 finish_output_ppm (j_decompress_ptr cinfo, djpeg_dest_ptr dinfo)
    206 {
    207   /* Make sure we wrote the output file OK */
    208   fflush(dinfo->output_file);
    209   if (ferror(dinfo->output_file))
    210     ERREXIT(cinfo, JERR_FILE_WRITE);
    211 }
    212 
    213 
    214 /*
    215  * The module selection routine for PPM format output.
    216  */
    217 
    218 GLOBAL(djpeg_dest_ptr)
    219 jinit_write_ppm (j_decompress_ptr cinfo)
    220 {
    221   ppm_dest_ptr dest;
    222 
    223   /* Create module interface object, fill in method pointers */
    224   dest = (ppm_dest_ptr)
    225       (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE,
    226 				  SIZEOF(ppm_dest_struct));
    227   dest->pub.start_output = start_output_ppm;
    228   dest->pub.finish_output = finish_output_ppm;
    229 
    230   /* Calculate output image dimensions so we can allocate space */
    231   jpeg_calc_output_dimensions(cinfo);
    232 
    233   /* Create physical I/O buffer.  Note we make this near on a PC. */
    234   dest->samples_per_row = cinfo->output_width * cinfo->out_color_components;
    235   dest->buffer_width = dest->samples_per_row * (BYTESPERSAMPLE * SIZEOF(char));
    236   dest->iobuffer = (char *) (*cinfo->mem->alloc_small)
    237     ((j_common_ptr) cinfo, JPOOL_IMAGE, dest->buffer_width);
    238 
    239   if (cinfo->quantize_colors || BITS_IN_JSAMPLE != 8 ||
    240       SIZEOF(JSAMPLE) != SIZEOF(char)) {
    241     /* When quantizing, we need an output buffer for colormap indexes
    242      * that's separate from the physical I/O buffer.  We also need a
    243      * separate buffer if pixel format translation must take place.
    244      */
    245     dest->pub.buffer = (*cinfo->mem->alloc_sarray)
    246       ((j_common_ptr) cinfo, JPOOL_IMAGE,
    247        cinfo->output_width * cinfo->output_components, (JDIMENSION) 1);
    248     dest->pub.buffer_height = 1;
    249     if (! cinfo->quantize_colors)
    250       dest->pub.put_pixel_rows = copy_pixel_rows;
    251     else if (cinfo->out_color_space == JCS_GRAYSCALE)
    252       dest->pub.put_pixel_rows = put_demapped_gray;
    253     else
    254       dest->pub.put_pixel_rows = put_demapped_rgb;
    255   } else {
    256     /* We will fwrite() directly from decompressor output buffer. */
    257     /* Synthesize a JSAMPARRAY pointer structure */
    258     /* Cast here implies near->far pointer conversion on PCs */
    259     dest->pixrow = (JSAMPROW) dest->iobuffer;
    260     dest->pub.buffer = & dest->pixrow;
    261     dest->pub.buffer_height = 1;
    262     dest->pub.put_pixel_rows = put_pixel_rows;
    263   }
    264 
    265   return (djpeg_dest_ptr) dest;
    266 }
    267 
    268 #endif /* PPM_SUPPORTED */
    269