/* pnmscale.c - read a portable anymap and scale it ** ** Copyright (C) 1989, 1991 by Jef Poskanzer. ** ** Permission to use, copy, modify, and distribute this software and its ** documentation for any purpose and without fee is hereby granted, provided ** that the above copyright notice appear in all copies and that both that ** copyright notice and this permission notice appear in supporting ** documentation. This software is provided "as is" without express or ** implied warranty. ** ** Modified: ** ** June 6, 2001: Christopher W. Boyd ** - added -reduce N to allow scaling by integer value ** in this case, scale_comp becomes 1/N and x/yscale ** get set as they should ** ** */ #include #include #include "pm_c_util.h" #include "mallocvar.h" #include "shhopt.h" #include "pnm.h" /* The pnm library allows us to code this program without branching cases for PGM and PPM, but we do the branch anyway to speed up processing of PGM images. */ /* We do all our arithmetic in integers. In order not to get killed by the rounding, we scale every number up by the factor SCALE, do the arithmetic, then scale it back down. */ #define SCALE 4096 #define HALFSCALE 2048 struct cmdline_info { /* All the information the user supplied in the command line, in a form easy for the program to use. */ const char *input_filespec; /* Filespecs of input files */ unsigned int xsize; unsigned int ysize; float xscale; float yscale; unsigned int xbox; unsigned int ybox; unsigned int pixels; unsigned int verbose; }; static void parse_command_line(int argc, char ** argv, struct cmdline_info *cmdline_p) { /*---------------------------------------------------------------------------- Note that the file spec array we return is stored in the storage that was passed to us as the argv array. -----------------------------------------------------------------------------*/ optEntry * option_def; /* Instructions to OptParseOptions3 on how to parse our options. */ optStruct3 opt; unsigned int option_def_index; int xysize, xsize, ysize, pixels; int reduce; float xscale, yscale, scale_parm; MALLOCARRAY_NOFAIL(option_def, 100); option_def_index = 0; /* incremented by OPTENTRY */ OPTENT3(0, "xsize", OPT_UINT, &xsize, NULL, 0); OPTENT3(0, "width", OPT_UINT, &xsize, NULL, 0); OPTENT3(0, "ysize", OPT_UINT, &ysize, NULL, 0); OPTENT3(0, "height", OPT_UINT, &ysize, NULL, 0); OPTENT3(0, "xscale", OPT_FLOAT, &xscale, NULL, 0); OPTENT3(0, "yscale", OPT_FLOAT, &yscale, NULL, 0); OPTENT3(0, "pixels", OPT_UINT, &pixels, NULL, 0); OPTENT3(0, "xysize", OPT_FLAG, &xysize, NULL, 0); OPTENT3(0, "verbose", OPT_FLAG, &cmdline_p->verbose, NULL, 0); OPTENT3(0, "reduce", OPT_UINT, &reduce, NULL, 0); /* Set the defaults. -1 = unspecified */ xsize = -1; ysize = -1; xscale = -1.0; yscale = -1.0; pixels = -1; xysize = 0; reduce = -1; cmdline_p->verbose = FALSE; opt.opt_table = option_def; opt.short_allowed = FALSE; /* We have no short (old-fashioned) options */ opt.allowNegNum = FALSE; /* We have no parms that are negative numbers */ pm_optParseOptions3(&argc, argv, opt, sizeof(opt), 0); /* Uses and sets argc, argv, and some of *cmdline_p and others. */ if (xsize == 0) pm_error("-xsize/width must be greater than zero."); if (ysize == 0) pm_error("-ysize/height must be greater than zero."); if (xscale != -1.0 && xscale <= 0.0) pm_error("-xscale must be greater than zero."); if (yscale != -1.0 && yscale <= 0.0) pm_error("-yscale must be greater than zero."); if (reduce <= 0 && reduce != -1) pm_error("-reduce must be greater than zero."); if (xsize != -1 && xscale != -1) pm_error("Cannot specify both -xsize/width and -xscale."); if (ysize != -1 && yscale != -1) pm_error("Cannot specify both -ysize/height and -yscale."); if (xysize && (xsize != -1 || xscale != -1 || ysize != -1 || yscale != -1 || reduce != -1 || pixels != -1) ) pm_error("Cannot specify -xysize with other dimension options."); if (pixels != -1 && (xsize != -1 || xscale != -1 || ysize != -1 || yscale != -1 || reduce != -1) ) pm_error("Cannot specify -pixels with other dimension options."); if (reduce != -1 && (xsize != -1 || xscale != -1 || ysize != -1 || yscale != -1) ) pm_error("Cannot specify -reduce with other dimension options."); if (pixels == 0) pm_error("-pixels must be greater than zero"); /* Get the program parameters */ if (xysize) { /* parameters are xbox, ybox, and optional filespec */ scale_parm = 0.0; if (argc-1 < 2) pm_error("You must supply at least two parameters with -xysize:\n " "x and y dimensions of the bounding box."); else if (argc-1 > 3) pm_error("Too many arguments. With -xysize, you need 2 or 3 " "arguments."); else { cmdline_p->xbox = atoi(argv[1]); cmdline_p->ybox = atoi(argv[2]); if (argc-1 < 3) cmdline_p->input_filespec = "-"; else cmdline_p->input_filespec = argv[3]; } } else { cmdline_p->xbox = 0; cmdline_p->ybox = 0; if (xsize == -1 && xscale == -1 && ysize == -1 && yscale == -1 && pixels == -1 && reduce == -1) { /* parameters are scale factor and optional filespec */ if (argc-1 < 1) pm_error("With no dimension options, you must supply at least " "one parameter: \nthe scale factor."); else { scale_parm = atof(argv[1]); if (scale_parm == 0.0) pm_error("The scale parameter %s is not " "a positive number.", argv[1]); else { if (argc-1 < 2) cmdline_p->input_filespec = "-"; else cmdline_p->input_filespec = argv[2]; } } } else { /* Only parameter allowed is optional filespec */ if (argc-1 < 1) cmdline_p->input_filespec = "-"; else cmdline_p->input_filespec = argv[1]; if (reduce != -1) { scale_parm = ((double) 1.0) / ((double) reduce); pm_message("reducing by %d gives scale factor of %f.", reduce, scale_parm); } else scale_parm = 0.0; } } cmdline_p->xsize = xsize == -1 ? 0 : xsize; cmdline_p->ysize = ysize == -1 ? 0 : ysize; cmdline_p->pixels = pixels == -1 ? 0 : pixels; if (scale_parm) { cmdline_p->xscale = scale_parm; cmdline_p->yscale = scale_parm; } else { cmdline_p->xscale = xscale == -1.0 ? 0.0 : xscale; cmdline_p->yscale = yscale == -1.0 ? 0.0 : yscale; } } static void compute_output_dimensions(const struct cmdline_info cmdline, const int rows, const int cols, int * newrowsP, int * newcolsP) { if (cmdline.pixels) { if (rows <= cmdline.pixels / cols) { *newrowsP = rows; *newcolsP = cols; } else { const double scale = sqrt( (float) cmdline.pixels / ((float) cols * (float) rows)); *newrowsP = rows * scale; *newcolsP = cols * scale; } } else if (cmdline.xbox) { const double aspect_ratio = (float) cols / (float) rows; const double box_aspect_ratio = (float) cmdline.xbox / (float) cmdline.ybox; if (box_aspect_ratio > aspect_ratio) { *newrowsP = cmdline.ybox; *newcolsP = *newrowsP * aspect_ratio + 0.5; } else { *newcolsP = cmdline.xbox; *newrowsP = *newcolsP / aspect_ratio + 0.5; } } else { if (cmdline.xsize) *newcolsP = cmdline.xsize; else if (cmdline.xscale) *newcolsP = cmdline.xscale * cols + .5; else if (cmdline.ysize) *newcolsP = cols * ((float) cmdline.ysize/rows) +.5; else *newcolsP = cols; if (cmdline.ysize) *newrowsP = cmdline.ysize; else if (cmdline.yscale) *newrowsP = cmdline.yscale * rows +.5; else if (cmdline.xsize) *newrowsP = rows * ((float) cmdline.xsize/cols) +.5; else *newrowsP = rows; } /* If the calculations above yielded (because of rounding) a zero dimension, we fudge it up to 1. We do this rather than considering it a specification error (and dying) because it's friendlier to automated processes that work on arbitrary input. It saves them having to check their numbers to avoid catastrophe. */ if (*newcolsP < 1) *newcolsP = 1; if (*newrowsP < 1) *newrowsP = 1; } static void horizontal_scale(const xel inputxelrow[], xel newxelrow[], const int cols, const int newcols, const long sxscale, const int format, const xelval maxval, int * stretchP) { /*---------------------------------------------------------------------------- Take the input row inputxelrow[], which is 'cols' columns wide, and scale it by a factor of 'sxcale', which is in SCALEths to create the output row newxelrow[], which is 'newcols' columns wide. 'format' and 'maxval' describe the Netpbm format of the both input and output rows. *stretchP is the number of columns (could be fractional) on the right that we had to fill by stretching because of rounding problems. -----------------------------------------------------------------------------*/ long r, g, b; long fraccoltofill, fraccolleft; unsigned int col; unsigned int newcol; newcol = 0; fraccoltofill = SCALE; /* Output column is "empty" now */ r = g = b = 0; /* initial value */ for (col = 0; col < cols; ++col) { /* Process one pixel from input ('inputxelrow') */ fraccolleft = sxscale; /* Output all columns, if any, that can be filled using information from this input column, in addition what's already in the output column. */ while (fraccolleft >= fraccoltofill) { /* Generate one output pixel in 'newxelrow'. It will consist of anything accumulated from prior input pixels in 'r','g', and 'b', plus a fraction of the current input pixel. */ switch (PNM_FORMAT_TYPE(format)) { case PPM_TYPE: r += fraccoltofill * PPM_GETR(inputxelrow[col]); g += fraccoltofill * PPM_GETG(inputxelrow[col]); b += fraccoltofill * PPM_GETB(inputxelrow[col]); r /= SCALE; if ( r > maxval ) r = maxval; g /= SCALE; if ( g > maxval ) g = maxval; b /= SCALE; if ( b > maxval ) b = maxval; PPM_ASSIGN( newxelrow[newcol], r, g, b ); break; default: g += fraccoltofill * PNM_GET1(inputxelrow[col]); g /= SCALE; if ( g > maxval ) g = maxval; PNM_ASSIGN1( newxelrow[newcol], g ); break; } fraccolleft -= fraccoltofill; /* Set up to start filling next output column */ newcol++; fraccoltofill = SCALE; r = g = b = 0; } /* There's not enough left in the current input pixel to fill up a whole output column, so just accumulate the remainder of the pixel into the current output column. */ if (fraccolleft > 0) { switch (PNM_FORMAT_TYPE(format)) { case PPM_TYPE: r += fraccolleft * PPM_GETR(inputxelrow[col]); g += fraccolleft * PPM_GETG(inputxelrow[col]); b += fraccolleft * PPM_GETB(inputxelrow[col]); break; default: g += fraccolleft * PNM_GET1(inputxelrow[col]); break; } fraccoltofill -= fraccolleft; } } *stretchP = 0; /* initial value */ while (newcol < newcols) { /* We ran out of input columns before we filled up the output columns. This would be because of rounding down. For small images, we're probably missing only a tiny fraction of a column, but for large images, it could be multiple columns. So we fake the remaining output columns by copying the rightmost legitimate pixel. We call this stretching. */ *stretchP += fraccoltofill; switch (PNM_FORMAT_TYPE(format)) { case PPM_TYPE: r += fraccoltofill * PPM_GETR(inputxelrow[cols-1]); g += fraccoltofill * PPM_GETG(inputxelrow[cols-1]); b += fraccoltofill * PPM_GETB(inputxelrow[cols-1]); r += HALFSCALE; /* for rounding */ r /= SCALE; if ( r > maxval ) r = maxval; g += HALFSCALE; /* for rounding */ g /= SCALE; if ( g > maxval ) g = maxval; b += HALFSCALE; /* for rounding */ b /= SCALE; if ( b > maxval ) b = maxval; PPM_ASSIGN(newxelrow[newcol], r, g, b ); break; default: g += fraccoltofill * PNM_GET1(inputxelrow[cols-1]); g += HALFSCALE; /* for rounding */ g /= SCALE; if ( g > maxval ) g = maxval; PNM_ASSIGN1(newxelrow[newcol], g ); break; } newcol++; fraccoltofill = SCALE; } } int main(int argc, char **argv ) { struct cmdline_info cmdline; FILE* ifp; xel* xelrow; xel* tempxelrow; xel* newxelrow; xel* xP; xel* nxP; int rows, cols, format, newformat, rowsread, newrows, newcols; int row, col, needtoreadrow; xelval maxval, newmaxval; long sxscale, syscale; long fracrowtofill, fracrowleft; long* rs; long* gs; long* bs; int vertical_stretch; /* The number of rows we had to fill by stretching because of rounding error, which made us run out of input rows before we had filled up the output rows. */ pnm_init( &argc, argv ); parse_command_line(argc, argv, &cmdline); ifp = pm_openr(cmdline.input_filespec); pnm_readpnminit( ifp, &cols, &rows, &maxval, &format ); /* Promote PBM files to PGM. */ if ( PNM_FORMAT_TYPE(format) == PBM_TYPE ) { newformat = PGM_TYPE; newmaxval = PGM_MAXMAXVAL; pm_message( "promoting from PBM to PGM" ); } else { newformat = format; newmaxval = maxval; } compute_output_dimensions(cmdline, rows, cols, &newrows, &newcols); /* We round the scale factor down so that we never fill up the output while (a fractional pixel of) input remains unused. Instead, we will run out of input while some of the output is unfilled. We can address that by stretching, whereas the other case would require throwing away some of the input. */ if (newcols > INT_MAX / SCALE) pm_error("New image width (%d) is uncomputably large", newcols); if (newrows > INT_MAX / SCALE) pm_error("New image height (%d) is uncomputably large", newrows); sxscale = SCALE * newcols / cols; syscale = SCALE * newrows / rows; if (cmdline.verbose) { pm_message("Scaling by %ld/%d = %f horizontally to %d columns.", sxscale, SCALE, (float) sxscale/SCALE, newcols ); pm_message("Scaling by %ld/%d = %f vertically to %d rows.", syscale, SCALE, (float) syscale/SCALE, newrows); } xelrow = pnm_allocrow(cols); if (newrows == rows) /* shortcut Y scaling if possible */ tempxelrow = xelrow; else tempxelrow = pnm_allocrow( cols ); rs = (long*) pm_allocrow( cols, sizeof(long) ); gs = (long*) pm_allocrow( cols, sizeof(long) ); bs = (long*) pm_allocrow( cols, sizeof(long) ); rowsread = 0; fracrowleft = syscale; needtoreadrow = 1; for ( col = 0; col < cols; ++col ) rs[col] = gs[col] = bs[col] = HALFSCALE; fracrowtofill = SCALE; vertical_stretch = 0; pnm_writepnminit( stdout, newcols, newrows, newmaxval, newformat, 0 ); newxelrow = pnm_allocrow( newcols ); for ( row = 0; row < newrows; ++row ) { /* First scale vertically from xelrow into tempxelrow. */ if ( newrows == rows ) { /* shortcut vertical scaling if possible */ pnm_readpnmrow( ifp, xelrow, cols, newmaxval, format ); } else { while ( fracrowleft < fracrowtofill ) { if ( needtoreadrow ) if ( rowsread < rows ) { pnm_readpnmrow( ifp, xelrow, cols, newmaxval, format ); ++rowsread; } switch ( PNM_FORMAT_TYPE(format) ) { case PPM_TYPE: for ( col = 0, xP = xelrow; col < cols; ++col, ++xP ) { rs[col] += fracrowleft * PPM_GETR( *xP ); gs[col] += fracrowleft * PPM_GETG( *xP ); bs[col] += fracrowleft * PPM_GETB( *xP ); } break; default: for ( col = 0, xP = xelrow; col < cols; ++col, ++xP ) gs[col] += fracrowleft * PNM_GET1( *xP ); break; } fracrowtofill -= fracrowleft; fracrowleft = syscale; needtoreadrow = 1; } /* Now fracrowleft is >= fracrowtofill, so we can produce a row. */ if ( needtoreadrow ) { if ( rowsread < rows ) { pnm_readpnmrow( ifp, xelrow, cols, newmaxval, format ); ++rowsread; needtoreadrow = 0; } else { /* We need another input row to fill up this output row, but there aren't any more. That's because of rounding down on our scaling arithmetic. So we go ahead with the data from the last row we read, which amounts to stretching out the last output row. */ vertical_stretch += fracrowtofill; } } switch ( PNM_FORMAT_TYPE(format) ) { case PPM_TYPE: for ( col = 0, xP = xelrow, nxP = tempxelrow; col < cols; ++col, ++xP, ++nxP ) { register long r, g, b; r = rs[col] + fracrowtofill * PPM_GETR( *xP ); g = gs[col] + fracrowtofill * PPM_GETG( *xP ); b = bs[col] + fracrowtofill * PPM_GETB( *xP ); r /= SCALE; if ( r > newmaxval ) r = newmaxval; g /= SCALE; if ( g > newmaxval ) g = newmaxval; b /= SCALE; if ( b > newmaxval ) b = newmaxval; PPM_ASSIGN( *nxP, r, g, b ); rs[col] = gs[col] = bs[col] = HALFSCALE; } break; default: for ( col = 0, xP = xelrow, nxP = tempxelrow; col < cols; ++col, ++xP, ++nxP ) { register long g; g = gs[col] + fracrowtofill * PNM_GET1( *xP ); g /= SCALE; if ( g > newmaxval ) g = newmaxval; PNM_ASSIGN1( *nxP, g ); gs[col] = HALFSCALE; } break; } fracrowleft -= fracrowtofill; if ( fracrowleft == 0 ) { fracrowleft = syscale; needtoreadrow = 1; } fracrowtofill = SCALE; } /* Now scale tempxelrow horizontally into newxelrow & write it out. */ if (newcols == cols) /* shortcut X scaling if possible */ pnm_writepnmrow(stdout, tempxelrow, newcols, newmaxval, newformat, 0); else { int stretch; horizontal_scale(tempxelrow, newxelrow, cols, newcols, sxscale, format, newmaxval, &stretch); if (cmdline.verbose && row == 0 && stretch != 0) pm_message("%d/%d = %f right columns filled by stretching " "because of arithmetic imprecision", stretch, SCALE, (float) stretch/SCALE); pnm_writepnmrow(stdout, newxelrow, newcols, newmaxval, newformat, 0 ); } } if (cmdline.verbose && vertical_stretch != 0) pm_message("%d/%d = %f bottom rows filled by stretching due to " "arithmetic imprecision", vertical_stretch, SCALE, (float) vertical_stretch/SCALE); pm_close( ifp ); pm_close( stdout ); exit( 0 ); }