| /* | 
 |  * jcprepct.c | 
 |  * | 
 |  * Copyright (C) 1994-1996, 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 the compression preprocessing controller. | 
 |  * This controller manages the color conversion, downsampling, | 
 |  * and edge expansion steps. | 
 |  * | 
 |  * Most of the complexity here is associated with buffering input rows | 
 |  * as required by the downsampler.  See the comments at the head of | 
 |  * jcsample.c for the downsampler's needs. | 
 |  */ | 
 |  | 
 | #define JPEG_INTERNALS | 
 | #include "jinclude.h" | 
 | #include "jpeglib.h" | 
 |  | 
 |  | 
 | /* At present, jcsample.c can request context rows only for smoothing. | 
 |  * In the future, we might also need context rows for CCIR601 sampling | 
 |  * or other more-complex downsampling procedures.  The code to support | 
 |  * context rows should be compiled only if needed. | 
 |  */ | 
 | #ifdef INPUT_SMOOTHING_SUPPORTED | 
 | #define CONTEXT_ROWS_SUPPORTED | 
 | #endif | 
 |  | 
 |  | 
 | /* | 
 |  * For the simple (no-context-row) case, we just need to buffer one | 
 |  * row group's worth of pixels for the downsampling step.  At the bottom of | 
 |  * the image, we pad to a full row group by replicating the last pixel row. | 
 |  * The downsampler's last output row is then replicated if needed to pad | 
 |  * out to a full iMCU row. | 
 |  * | 
 |  * When providing context rows, we must buffer three row groups' worth of | 
 |  * pixels.  Three row groups are physically allocated, but the row pointer | 
 |  * arrays are made five row groups high, with the extra pointers above and | 
 |  * below "wrapping around" to point to the last and first real row groups. | 
 |  * This allows the downsampler to access the proper context rows. | 
 |  * At the top and bottom of the image, we create dummy context rows by | 
 |  * copying the first or last real pixel row.  This copying could be avoided | 
 |  * by pointer hacking as is done in jdmainct.c, but it doesn't seem worth the | 
 |  * trouble on the compression side. | 
 |  */ | 
 |  | 
 |  | 
 | /* Private buffer controller object */ | 
 |  | 
 | typedef struct { | 
 |   struct jpeg_c_prep_controller pub; /* public fields */ | 
 |  | 
 |   /* Downsampling input buffer.  This buffer holds color-converted data | 
 |    * until we have enough to do a downsample step. | 
 |    */ | 
 |   JSAMPARRAY color_buf[MAX_COMPONENTS]; | 
 |  | 
 |   JDIMENSION rows_to_go;	/* counts rows remaining in source image */ | 
 |   int next_buf_row;		/* index of next row to store in color_buf */ | 
 |  | 
 | #ifdef CONTEXT_ROWS_SUPPORTED	/* only needed for context case */ | 
 |   int this_row_group;		/* starting row index of group to process */ | 
 |   int next_buf_stop;		/* downsample when we reach this index */ | 
 | #endif | 
 | } my_prep_controller; | 
 |  | 
 | typedef my_prep_controller * my_prep_ptr; | 
 |  | 
 |  | 
 | /* | 
 |  * Initialize for a processing pass. | 
 |  */ | 
 |  | 
 | METHODDEF(void) | 
 | start_pass_prep (j_compress_ptr cinfo, J_BUF_MODE pass_mode) | 
 | { | 
 |   my_prep_ptr prep = (my_prep_ptr) cinfo->prep; | 
 |  | 
 |   if (pass_mode != JBUF_PASS_THRU) | 
 |     ERREXIT(cinfo, JERR_BAD_BUFFER_MODE); | 
 |  | 
 |   /* Initialize total-height counter for detecting bottom of image */ | 
 |   prep->rows_to_go = cinfo->image_height; | 
 |   /* Mark the conversion buffer empty */ | 
 |   prep->next_buf_row = 0; | 
 | #ifdef CONTEXT_ROWS_SUPPORTED | 
 |   /* Preset additional state variables for context mode. | 
 |    * These aren't used in non-context mode, so we needn't test which mode. | 
 |    */ | 
 |   prep->this_row_group = 0; | 
 |   /* Set next_buf_stop to stop after two row groups have been read in. */ | 
 |   prep->next_buf_stop = 2 * cinfo->max_v_samp_factor; | 
 | #endif | 
 | } | 
 |  | 
 |  | 
 | /* | 
 |  * Expand an image vertically from height input_rows to height output_rows, | 
 |  * by duplicating the bottom row. | 
 |  */ | 
 |  | 
 | LOCAL(void) | 
 | expand_bottom_edge (JSAMPARRAY image_data, JDIMENSION num_cols, | 
 | 		    int input_rows, int output_rows) | 
 | { | 
 |   register int row; | 
 |  | 
 |   for (row = input_rows; row < output_rows; row++) { | 
 |     jcopy_sample_rows(image_data, input_rows-1, image_data, row, | 
 | 		      1, num_cols); | 
 |   } | 
 | } | 
 |  | 
 |  | 
 | /* | 
 |  * Process some data in the simple no-context case. | 
 |  * | 
 |  * Preprocessor output data is counted in "row groups".  A row group | 
 |  * is defined to be v_samp_factor sample rows of each component. | 
 |  * Downsampling will produce this much data from each max_v_samp_factor | 
 |  * input rows. | 
 |  */ | 
 |  | 
 | METHODDEF(void) | 
 | pre_process_data (j_compress_ptr cinfo, | 
 | 		  JSAMPARRAY input_buf, JDIMENSION *in_row_ctr, | 
 | 		  JDIMENSION in_rows_avail, | 
 | 		  JSAMPIMAGE output_buf, JDIMENSION *out_row_group_ctr, | 
 | 		  JDIMENSION out_row_groups_avail) | 
 | { | 
 |   my_prep_ptr prep = (my_prep_ptr) cinfo->prep; | 
 |   int numrows, ci; | 
 |   JDIMENSION inrows; | 
 |   jpeg_component_info * compptr; | 
 |  | 
 |   while (*in_row_ctr < in_rows_avail && | 
 | 	 *out_row_group_ctr < out_row_groups_avail) { | 
 |     /* Do color conversion to fill the conversion buffer. */ | 
 |     inrows = in_rows_avail - *in_row_ctr; | 
 |     numrows = cinfo->max_v_samp_factor - prep->next_buf_row; | 
 |     numrows = (int) MIN((JDIMENSION) numrows, inrows); | 
 |     (*cinfo->cconvert->color_convert) (cinfo, input_buf + *in_row_ctr, | 
 | 				       prep->color_buf, | 
 | 				       (JDIMENSION) prep->next_buf_row, | 
 | 				       numrows); | 
 |     *in_row_ctr += numrows; | 
 |     prep->next_buf_row += numrows; | 
 |     prep->rows_to_go -= numrows; | 
 |     /* If at bottom of image, pad to fill the conversion buffer. */ | 
 |     if (prep->rows_to_go == 0 && | 
 | 	prep->next_buf_row < cinfo->max_v_samp_factor) { | 
 |       for (ci = 0; ci < cinfo->num_components; ci++) { | 
 | 	expand_bottom_edge(prep->color_buf[ci], cinfo->image_width, | 
 | 			   prep->next_buf_row, cinfo->max_v_samp_factor); | 
 |       } | 
 |       prep->next_buf_row = cinfo->max_v_samp_factor; | 
 |     } | 
 |     /* If we've filled the conversion buffer, empty it. */ | 
 |     if (prep->next_buf_row == cinfo->max_v_samp_factor) { | 
 |       (*cinfo->downsample->downsample) (cinfo, | 
 | 					prep->color_buf, (JDIMENSION) 0, | 
 | 					output_buf, *out_row_group_ctr); | 
 |       prep->next_buf_row = 0; | 
 |       (*out_row_group_ctr)++; | 
 |     } | 
 |     /* If at bottom of image, pad the output to a full iMCU height. | 
 |      * Note we assume the caller is providing a one-iMCU-height output buffer! | 
 |      */ | 
 |     if (prep->rows_to_go == 0 && | 
 | 	*out_row_group_ctr < out_row_groups_avail) { | 
 |       for (ci = 0, compptr = cinfo->comp_info; ci < cinfo->num_components; | 
 | 	   ci++, compptr++) { | 
 | 	expand_bottom_edge(output_buf[ci], | 
 | 			   compptr->width_in_blocks * DCTSIZE, | 
 | 			   (int) (*out_row_group_ctr * compptr->v_samp_factor), | 
 | 			   (int) (out_row_groups_avail * compptr->v_samp_factor)); | 
 |       } | 
 |       *out_row_group_ctr = out_row_groups_avail; | 
 |       break;			/* can exit outer loop without test */ | 
 |     } | 
 |   } | 
 | } | 
 |  | 
 |  | 
 | #ifdef CONTEXT_ROWS_SUPPORTED | 
 |  | 
 | /* | 
 |  * Process some data in the context case. | 
 |  */ | 
 |  | 
 | METHODDEF(void) | 
 | pre_process_context (j_compress_ptr cinfo, | 
 | 		     JSAMPARRAY input_buf, JDIMENSION *in_row_ctr, | 
 | 		     JDIMENSION in_rows_avail, | 
 | 		     JSAMPIMAGE output_buf, JDIMENSION *out_row_group_ctr, | 
 | 		     JDIMENSION out_row_groups_avail) | 
 | { | 
 |   my_prep_ptr prep = (my_prep_ptr) cinfo->prep; | 
 |   int numrows, ci; | 
 |   int buf_height = cinfo->max_v_samp_factor * 3; | 
 |   JDIMENSION inrows; | 
 |  | 
 |   while (*out_row_group_ctr < out_row_groups_avail) { | 
 |     if (*in_row_ctr < in_rows_avail) { | 
 |       /* Do color conversion to fill the conversion buffer. */ | 
 |       inrows = in_rows_avail - *in_row_ctr; | 
 |       numrows = prep->next_buf_stop - prep->next_buf_row; | 
 |       numrows = (int) MIN((JDIMENSION) numrows, inrows); | 
 |       (*cinfo->cconvert->color_convert) (cinfo, input_buf + *in_row_ctr, | 
 | 					 prep->color_buf, | 
 | 					 (JDIMENSION) prep->next_buf_row, | 
 | 					 numrows); | 
 |       /* Pad at top of image, if first time through */ | 
 |       if (prep->rows_to_go == cinfo->image_height) { | 
 | 	for (ci = 0; ci < cinfo->num_components; ci++) { | 
 | 	  int row; | 
 | 	  for (row = 1; row <= cinfo->max_v_samp_factor; row++) { | 
 | 	    jcopy_sample_rows(prep->color_buf[ci], 0, | 
 | 			      prep->color_buf[ci], -row, | 
 | 			      1, cinfo->image_width); | 
 | 	  } | 
 | 	} | 
 |       } | 
 |       *in_row_ctr += numrows; | 
 |       prep->next_buf_row += numrows; | 
 |       prep->rows_to_go -= numrows; | 
 |     } else { | 
 |       /* Return for more data, unless we are at the bottom of the image. */ | 
 |       if (prep->rows_to_go != 0) | 
 | 	break; | 
 |       /* When at bottom of image, pad to fill the conversion buffer. */ | 
 |       if (prep->next_buf_row < prep->next_buf_stop) { | 
 | 	for (ci = 0; ci < cinfo->num_components; ci++) { | 
 | 	  expand_bottom_edge(prep->color_buf[ci], cinfo->image_width, | 
 | 			     prep->next_buf_row, prep->next_buf_stop); | 
 | 	} | 
 | 	prep->next_buf_row = prep->next_buf_stop; | 
 |       } | 
 |     } | 
 |     /* If we've gotten enough data, downsample a row group. */ | 
 |     if (prep->next_buf_row == prep->next_buf_stop) { | 
 |       (*cinfo->downsample->downsample) (cinfo, | 
 | 					prep->color_buf, | 
 | 					(JDIMENSION) prep->this_row_group, | 
 | 					output_buf, *out_row_group_ctr); | 
 |       (*out_row_group_ctr)++; | 
 |       /* Advance pointers with wraparound as necessary. */ | 
 |       prep->this_row_group += cinfo->max_v_samp_factor; | 
 |       if (prep->this_row_group >= buf_height) | 
 | 	prep->this_row_group = 0; | 
 |       if (prep->next_buf_row >= buf_height) | 
 | 	prep->next_buf_row = 0; | 
 |       prep->next_buf_stop = prep->next_buf_row + cinfo->max_v_samp_factor; | 
 |     } | 
 |   } | 
 | } | 
 |  | 
 |  | 
 | /* | 
 |  * Create the wrapped-around downsampling input buffer needed for context mode. | 
 |  */ | 
 |  | 
 | LOCAL(void) | 
 | create_context_buffer (j_compress_ptr cinfo) | 
 | { | 
 |   my_prep_ptr prep = (my_prep_ptr) cinfo->prep; | 
 |   int rgroup_height = cinfo->max_v_samp_factor; | 
 |   int ci, i; | 
 |   jpeg_component_info * compptr; | 
 |   JSAMPARRAY true_buffer, fake_buffer; | 
 |  | 
 |   /* Grab enough space for fake row pointers for all the components; | 
 |    * we need five row groups' worth of pointers for each component. | 
 |    */ | 
 |   fake_buffer = (JSAMPARRAY) | 
 |     (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE, | 
 | 				(cinfo->num_components * 5 * rgroup_height) * | 
 | 				SIZEOF(JSAMPROW)); | 
 |  | 
 |   for (ci = 0, compptr = cinfo->comp_info; ci < cinfo->num_components; | 
 |        ci++, compptr++) { | 
 |     /* Allocate the actual buffer space (3 row groups) for this component. | 
 |      * We make the buffer wide enough to allow the downsampler to edge-expand | 
 |      * horizontally within the buffer, if it so chooses. | 
 |      */ | 
 |     true_buffer = (*cinfo->mem->alloc_sarray) | 
 |       ((j_common_ptr) cinfo, JPOOL_IMAGE, | 
 |        (JDIMENSION) (((long) compptr->width_in_blocks * DCTSIZE * | 
 | 		      cinfo->max_h_samp_factor) / compptr->h_samp_factor), | 
 |        (JDIMENSION) (3 * rgroup_height)); | 
 |     /* Copy true buffer row pointers into the middle of the fake row array */ | 
 |     MEMCOPY(fake_buffer + rgroup_height, true_buffer, | 
 | 	    3 * rgroup_height * SIZEOF(JSAMPROW)); | 
 |     /* Fill in the above and below wraparound pointers */ | 
 |     for (i = 0; i < rgroup_height; i++) { | 
 |       fake_buffer[i] = true_buffer[2 * rgroup_height + i]; | 
 |       fake_buffer[4 * rgroup_height + i] = true_buffer[i]; | 
 |     } | 
 |     prep->color_buf[ci] = fake_buffer + rgroup_height; | 
 |     fake_buffer += 5 * rgroup_height; /* point to space for next component */ | 
 |   } | 
 | } | 
 |  | 
 | #endif /* CONTEXT_ROWS_SUPPORTED */ | 
 |  | 
 |  | 
 | /* | 
 |  * Initialize preprocessing controller. | 
 |  */ | 
 |  | 
 | GLOBAL(void) | 
 | jinit_c_prep_controller (j_compress_ptr cinfo, boolean need_full_buffer) | 
 | { | 
 |   my_prep_ptr prep; | 
 |   int ci; | 
 |   jpeg_component_info * compptr; | 
 |  | 
 |   if (need_full_buffer)		/* safety check */ | 
 |     ERREXIT(cinfo, JERR_BAD_BUFFER_MODE); | 
 |  | 
 |   prep = (my_prep_ptr) | 
 |     (*cinfo->mem->alloc_small) ((j_common_ptr) cinfo, JPOOL_IMAGE, | 
 | 				SIZEOF(my_prep_controller)); | 
 |   cinfo->prep = (struct jpeg_c_prep_controller *) prep; | 
 |   prep->pub.start_pass = start_pass_prep; | 
 |  | 
 |   /* Allocate the color conversion buffer. | 
 |    * We make the buffer wide enough to allow the downsampler to edge-expand | 
 |    * horizontally within the buffer, if it so chooses. | 
 |    */ | 
 |   if (cinfo->downsample->need_context_rows) { | 
 |     /* Set up to provide context rows */ | 
 | #ifdef CONTEXT_ROWS_SUPPORTED | 
 |     prep->pub.pre_process_data = pre_process_context; | 
 |     create_context_buffer(cinfo); | 
 | #else | 
 |     ERREXIT(cinfo, JERR_NOT_COMPILED); | 
 | #endif | 
 |   } else { | 
 |     /* No context, just make it tall enough for one row group */ | 
 |     prep->pub.pre_process_data = pre_process_data; | 
 |     for (ci = 0, compptr = cinfo->comp_info; ci < cinfo->num_components; | 
 | 	 ci++, compptr++) { | 
 |       prep->color_buf[ci] = (*cinfo->mem->alloc_sarray) | 
 | 	((j_common_ptr) cinfo, JPOOL_IMAGE, | 
 | 	 (JDIMENSION) (((long) compptr->width_in_blocks * DCTSIZE * | 
 | 			cinfo->max_h_samp_factor) / compptr->h_samp_factor), | 
 | 	 (JDIMENSION) cinfo->max_v_samp_factor); | 
 |     } | 
 |   } | 
 | } |