|canonize [-ah] [-s squarefilesize]|
[-w filewidth] [-n fileheight]
[-g [cg | rgb | scan]]
[-t [u | l | m]] [-C numcopies] [-q queue]
[-R dpi] [-M xmag:ymag] [-m]
[-X page_xoff] [-Y page_yoff]
[-N printheight] [-W printwidth]
[-v] [-q queue] [file.pix...]
Canonize is a user agent for printing pix(5) format files using a Canon(tm) CLC500 and the MDQS queuing system. It can read the image from the standard input, or can send one or more files whose names are specified on the command line.
By default, the image is printed using the "cg" gamma map (computer graphics), with paper from the "upper" paper tray, and the image proportionally scaled to fill the print area on the page.
-aCauses canonize to attempt to determine the size of the image to find out the number of bytes in the file. This option cannot be used if the image is provided on the standard input.
-hindicates that the input image is 1024 pixels square.
-s squaresizesets the image width and height to the size given.
-w filewidthsets the image width to be filewidth pixels. By default the image is assumed to be 512 pixels wide.
-n fileheightspecifies the height of the image in pixels. By default the image is assumed to be 512 pixels wide.
-g gammatypeSelect the gamma correction map to apply to the image before printing. There are three gamma compensation maps in the CLC500. Canon recommends the "cg" map for computer graphics images which have not been gamma corrected. The "rgb" gamma map is said to be designed for images which have already been gamma corrected. The "scan" gamma map is the one used by the CLC500 when printing images obtained from the built in scanner.
-t traynameselects the tray from which paper should be taken to produce the print. The options are "u" for the upper tray, "l" for the lower tray, and "m" for manual feed.
-C numcopiesSpecifies the number of prints of the image desired. This number must be in the range 1-99.
-q queuenamequeue job to MDQS queue "queuename". By default, the job is queued to the queue "canon".
-R dpiPrint image with dpi dots-per-inch on the output page. This option disables the automatic scaling of the image.
-M xmag:ymagPrint the image with a magnification of "xmag" in the X dimension and "ymag" in the y dimension.
-X page_xoffSpecifies the offset of left side of the image from the left side of the output page. This option is available only when -R or -M have been specified, and are especially useful in conjunction with the -m option.
-Y page_xoffSpecifies the distance from the top of the page to the top of the image. This option is available only when -R or -M have been specified, and are especially useful in conjunction with the -m option.
-NSpecifies the height of the image on the output page. This option is available only when -A AutoScaling (on by default). The image is scaled equally in the X and Y dimensions to make it fit the available print area as closely as possible. -R or -M have been specified, and are especially useful in conjunction with the -m option.
-WSpecifies the width of the image on the output page. This option is available only when -R or -M have been specified, and are especially useful in conjunction with the -m option.
-mcauses the image to be repeated across the page.
-vTurn on debugging output.
The Canon CLC500(tm) prints at 400dpi on the output page. This results in approximately 2550 by 3300 pixels on an 8.5 inch by 11 inch page. Images of less than 1024 by 1024 pixels do not look especially pleasing when printed using AutoScaling. This is because the pixels become enlarged enough to be annoying.
Because high resolution images occupy a substantial amount of disk space, it is relatively easy to run the MDQS queue server out of disk space by queuing many images at once.
pix-fb(1), pix-ipu(1), IPU Programmers Manual
If the -a option is specified when the image is being redirected from the standard input canonize will abort. This avoids wasting paper printing an image using incorrect dimensions.
Lee A. Butler
This software is Copyright (c) 1992-2013 by the United States Government as represented by U.S. Army Research Laboratory.
Reports of bugs or problems should be submitted via electronic mail to <email@example.com>.