TCPR(1MDQS) COMMAND REFERENCE TCPR(1MDQS) NAME tcpr - queued printing of GRF image to color printer via MDQS SYNOPSIS tcpr [ -a atime ] [ -c count ] [ -f form ] [ -o device ] [ -m ] [ -n ] [ -p priority ] [ -q queue ] [ -r ] [ -u useraddr ] [ -v ] [ -R ruser ] [ -C local|none ] [ -B local|none ] [ -G local|remote|none ] [ -I local|color1=color2|none ] [ -D [rotate:]matrix_size[:local|:remote] ] [ -b border_color ] [ -M colormap_file ] [ -d dither_file ] [ -g gamma_file ] [ filename... ] DESCRIPTION The command tcpr (Tektronix color printer) queues Generic Raster Format (GRF) files to a Tektronix color printer. GRF is used for transmitting and storing color raster images. GRF files are either screendata or copydata files. A screendata file is run through the processing(1) command to convert it to copydata suitable for printing. For more information on GRF, see grf(5). If no files are specified, the standard input is read until an end-of-file. The original file can be deleted and the file printed will be the file as of the time of the request. If the -n or -r option is used, the original file is not spooled. Hence the original file should not be deleted until printing is completed. Once the request is queued, it can be deleted using the lprm(1mdqs) command or modified using the qmod(1mdqs) command. Current status is returned with the lpq(1mdqs) command. A print request can be directed to a local or remote color printer. OPTIONS -a atime Start this job after atime. See getdate(5mdqs) for a full description of time specifications. The most useful time specification is hour:minute [meridian]. If no meridian -- am or pm -- is specified, a 24-hour clock is used. -c count Print count copies of the specified file. -f form Print the file on the specified form. The default form Printed 5/19/88 1
TCPR(1MDQS) COMMAND REFERENCE TCPR(1MDQS) is specified in /etc/qconf. The form must match an entry in the tcprform(5) file for the color printer. -m Send a message via mail(1mh) to the user when printing is completed. -n Do not spool the specified files, but enter the filename only. This option can be used when image files are extremely large and available space for second copies is limited. When using this option and directing the request to a remote printer, local spooling is bypassed but remote spooling is always done. -p priority Override the default request priority. The priorities are 0 -- 10; 5 is the default. Only the superuser, the MDQS user or a member of the systems group can request a priority of 0. -q queue Request a queue other than the default. The default print queue is specified in /etc/qconf. Queuing a request to other than a print queue gives unpredictable results. -r Remove the specified files when the print request is completed. If the request is printed on a remote host the files are not removed. The -r option implies the -n option. -R ruser Specify another user on the remote host for rsh privileges. When a print request is to a remote host, MDQS requires the requesting local user name to exist on the remote host with rsh(1n) privileges. -u useraddr Override the default notification address with the address useraddr; this address should be a valid address to your mail system. The default notification address is the name of the user on the current host. -v Normally tcpr works silently. The -v (verbose) option acknowledges the request is queued and prints the request number. These are options to the processing(1) command. If the GRF image file is a screendata file the processing command converts it into a copydata file table for printing. These options specify the type of processing. See processing(1) for additional information. Printed 5/19/88 2
TCPR(1MDQS) COMMAND REFERENCE TCPR(1MDQS) -o device Override the destinationdevice GRF tag in the GRF header of the screendata image file. This GRF tag specifies the type of output device-dependent processing to perform on the GRF image file. Valid output device types are the Tektronix color printer types: 4693d, 4692, and 4696. -C local|none Enable (local) or disable (none) the processing command's built-in color correction. Color correction is designed to match the screen colors to the ink colors of the color printer. The default is specified by the original colorcorrection GRF tag entry in the image- data file. -B local|none Enable(local) or disable (none) the processing command's built-in black correction. Black correction is designed to match gray levels of the screen to the color printer. The default is specified by the original blackcorrection GRF tag entry in the image-data file. -G local|remote|none Specify the processing command's built-in gamma correction using either local or remote intensity values. Gamma correction is designed to match the intensity of the screen to the color printer. The local option specifies the gamma intensity values come from the local host. Local gamma intensity values are included in the GRF header before the image file is spooled. The remote option specifies the gamma intensity values come from the remote host. If spooling to a remote host, specifying local calls the local intensity values. The none option disables gamma correction. The default is specified in the original gammacorrection GRF tag entry in the image-data file. -I local|color1=color2|none Specify color pixel inversion, excluding the image border, by the processing command. The local option specifies black and white pixel inversion. Text is best reproduced on paper as black letters on a white background, though usually displayed on terminals as light letters on a dark background. Printed 5/19/88 3
TCPR(1MDQS) COMMAND REFERENCE TCPR(1MDQS) The color1=color2 option inverts any two color pixels. Valid colors are red, green, blue, cyan, magenta, yellow, black and white. The none option specifies no inversion. The default is specified by the original invertbw GRF tag entry in the image-data file. -D [rotate:]matrix_size[:local|:remote] Specify built-in dithering by the processing command using local or remote dithering matrices of size n by n, where n is specified by matrix_size. Ordered dithering produces a full palette of colors using the three ink colors of the color printer. The dither matrix_size parameter can be 2, 4, 8, or 16 which corresponds to a 2 by 2, 4 by 4, 8 by 8, or 16 by 16 matrix. A parameter value of 0 specifies no dithering. The various sizes allow for the tradeoff between the truer colors obtained with a larger dither size and the finer detail of a smaller dither size. Dither patterns can also be rotated 90 degrees using the -D rotate:matrix_size option. The local option specifies the dithering matrices come from the local host. Local dithering matrices are included in the GRF header before the image file is spooled. The remote option specifies the dithering matrices come from the remote host. If spooling to a remote host, specifying local calls the local dithering matrices. The default is specified in the original dithermatrix GRF tag in the image-data file. -b border_color Specify the border color, or no border, around the image. The values for bordercolor are red, green, blue, cyan, magenta, yellow, white, black or none. A white border places white pixels around the image, making the edges white if on paper and clear if on a transparency. Other border color values fill all unused image border with the specified color. A black border is best for making transparencies for an overhead projector. A GRF tag value of none specifies no border. This is the same as specifying white except the image border is not filled in. The default for this option is specified in Printed 5/19/88 4
TCPR(1MDQS) COMMAND REFERENCE TCPR(1MDQS) the original bordercolor GRF tag in the image-data file. -M colormap_file Specify an alternate color map file for the GRF image. If this option is specified the new color map replaces the existing color map. -d dither_file Specify an alternate dithering matrix file used by processing(1); use the -D option to specify rotation and matrix size. -g gamma_file Specify an alternate gamma correction data file used by processing(1); the -G local option must be specified also. Defaults used by tcpr are found in the /etc/qconf file. The following entries are used to set up tcpr defaults: tcpr-forms <forms> Defines the default forms on the color printer. tcpr-limit <maxcopies> Defines the maximum number of copies made at one time on the color printer. Making copies on a color printer is relatively expensive and the system administrator may want to set this limit low. A value of 0 implies that no limit exists. tcpr-prior <priority> Defines the default priority for the queued request. tcpr-queue <queue> Defines the default color printer queue. EXAMPLES The following example prints two GRF image files on the default color printer: tcpr file1 file2 The following example converts the GRF image-data file using built-in color correction and gamma correction into a copydata file and prints it on the default color printer. processing -C local -G local <file1 | tcpr Printed 5/19/88 5
TCPR(1MDQS) COMMAND REFERENCE TCPR(1MDQS) The following example does the same as the previous example, only the processing is done under MDQS management. Gamma intensity correction values come from the local host. If the queue was on a remote host, processing would be done by the remote host. tcpr -C local -G local file1 The following example shows the etc/qconf entry for a file printed on the current host using a Tektronix 4693D color printer in streaming mode: qconf Queue/Device Mapping Description entry: tcpr tcpr0 /usr/lib/mdqs/tcprserver -c /etc/tcprconf -P tek4693D_S The following example shows the etc/qconf entry for a file rerouted to a remote host (jondoe): qconf Queue/Device Mapping Description entry: tcpr2 net /usr/lib/mdqs/netsend jondoe tcpr This example prints the file on the remote host jondoe from the previous example: tcpr -q tcpr2 file1 FILES /etc/qconf Configuration information for MDQS. /etc/tcprconf Configuration information used by the tcpr server to map GRF printer tag entries to the correct printer protocol driver. /usr/lib/tcpr/tcprdither Contains the local host's ordered dithering matrices. The file contains entries for 16 by 16, 8 by 8, 4 by 4, and 2 by 2 ordered matrices. /usr/lib/tcpr/tcprgamma Contains the local host's gamma intensity correction values. /usr/lib/tcpr/tcprforms Contains the valid set of tcpr media forms for all valid Tektronix color printer types. /usr/lib/mdqs/tcprserver Program called by the daemon to print GRF image files. Printed 5/19/88 6
TCPR(1MDQS) COMMAND REFERENCE TCPR(1MDQS) /usr/lib/mdqs/netsend Program called to send to remote queue. /usr/spool/q Top of spooling directory tree. RETURN VALUE [NO_ERRS] Command completed without error. [USAGE] Incorrect command line syntax. Execution terminated. [NP_WARN] An error warranting a warning message occurred. Execution continues. [NP_ERR] An error occurred that was not a system error. Execution terminated. [P_WARN] A system error occurred. Execution continues. See intro(2) for more information on system errors. [P_ERR] A system error occurred. Execution terminated. See intro(2) for more information on system errors. CAVEATS When specifying -n (no copy), remote requests are always spooled. SEE ALSO grf_compress(1), grf_expand(1), processing(1), screencopy(1), st_grf(1), x_grf(1), lpq(1mdqs), lprm(1mdqs), qmod(1mdqs), qstat(1mdqs), tchc(4), forms(5mdqs), grf(5), tcprdither(5), tcprgamma(5), mdqsd(8mdqs), and tcprserver(8mdqs). REFERENCES For more information, consult the Users Manual for your system. Printed 5/19/88 7
%%index%% na:336,118; sy:454,1842; de:2296,1728; op:4024,686;5118,2969;8495,4328;13231,4257;17896,2456; ex:20352,642;21402,1110; fi:22512,1447;24367,216; rv:24583,836; ca:25419,175; se:25594,649; re:26243,220; %%index%%000000000233