TCPRDRVTEK4693D(8MDQS) COMMAND REFERENCE TCPRDRVTEK4693D(8MDQS) NAME tcprdrv_Tek4693D - MDQS color printer server GRF driver for Tektronix 4693D SYNOPSIS tcprdrvTek4693D [ -s ] [ -b blocking_factor ] DESCRIPTION tcprdrvTek4693D is an installable Generic Rastor Format (GRF) protocol driver used by the tcprserver color printer server program (see tcprserver(8mdqs)). It maps GRF image files to the Tektronix 4693D color printer by performing the protocol conversions needed to output the GRF image file to the 4693D printer. For more information on GRF see grf(5). The tcprserver program uses installable protocol drivers to configure itself to the color printer it is driving. GRF protocol drivers are executed only by the tcprserver program. They are not user-executable programs. The driver is selected by the tcprserver program by matching the GRF tag entry for the printer type found in the /etc/tcprconf file when a GRF image file header is read by the tcprserver program. This makes it possible for images processed for other copier or printer types to be sent to the 4693D color printer by adding an entry in the tcprconf file for them. tcprdrvTek4693D recognizes the following GRF tag entries to convert the GRF image file for the 4693D printer: Image Information Tags numberofscans {1-maxnumberofscans} This tag is required. Specifies the number of rastors (scan lines or scan rows) in the input scan file. The value maxnumberofscans is determined by the image format and the media type the image is printed on (see Maximum Image Size Addressability Table below). scandirection {lefttoright} This tag is required. Specifies the input pixels within a rastor line are sequenced from left to right. The 4693D driver is unable to accept image files sequenced right to left. imagetype {copydata} This tag is required. Printed 5/12/88 1
TCPRDRVTEK4693D(8MDQS) COMMAND REFERENCE TCPRDRVTEK4693D(8MDQS) Specifies the file contains an image processed for output to a hardcopy printer. scanlength {1-maxscanlength} This tag is required. Specifies the number of pixels in each rastor line before any data compression. The value maxscanlength is determined by the image format and the media type the image is printed on (see Maximum Image Size Addressability Table below). scanorder {toptobottom} This tag is required. Specifies the input rastor lines are sequenced from top to bottom. The 4693D driver is unable to accept image files sequenced from bottom to top. Data Information Tags bitspervalue {1|2|4|8|16} This tag is required. Specifies the number of significant bits in a color index or color intensity value. colorunits {cmy|rgb|mono} This tag is required. Specifies the color coordinate system used to encode color information. For indexed images, it describes the entries in the color map. For intensity images, it describes the encoding of color information for each pixel. colormap {0|[d,1-4096,3]|[d,1-4096,4]} This tag is required. Specifies the image encoding and the size of the color map table following this tag. For intensity encoded image files the value 0 must be specified. This indicates no color map follows. For indexed encode image files a color table follows that can consist of up to 4096 color map entries. Color map entries can be of two types. Color map entries of size 3 consist of 3 values per line in CMY or RGB depending on the color_units tag entry. Color map entries of size 3 are assumed to be contiguous through out the full index range. Color map entries of size 4 Printed 5/12/88 2
TCPRDRVTEK4693D(8MDQS) COMMAND REFERENCE TCPRDRVTEK4693D(8MDQS) are preceded by the color map index for the entry. This supplies only the color map entries needed to specify the image file. packinglevel {nopacking|simple|pattern|pixel} This tag is required. Specifies whether the image data has been compressed and the type of compression used. pixelfieldwidth {1|8|16|24} This tag is required. Specifies the total width in bits of the color information associated with each pixel. For indexed and monochrome images the value must be equal to the value_field_width tag entry. For color intensity encoded images the value must be at least three times the value of the value_field_width tag entry. valuefieldwidth {1|2|4|8|16} This tag is required. Specifies the total number of bits of storage allocated for an index or intensity value. This value must be greater than or equal to the bits_per_value tag entry. The index or intensity values are right-justified in the fields. pixelwidth {1-255} This tag is optional. Informs the 4693D printer of the width of the image file's pixels relative to a pixel height of 32. The default value is 32 which specifies square pixels for Tektronix terminal devices. Hardcopy Information Tags imageformat {landscape|portraitupper|portraitcenter| portraitlower|default} This tag is optional. Specifies the orientation of the hardcopy image, either landscape or portrait. The default is landscape. The following table shows the maximum image addressability for each 4693D color printer media type and image format: Printed 5/12/88 3
TCPRDRVTEK4693D(8MDQS) COMMAND REFERENCE TCPRDRVTEK4693D(8MDQS) Maximum Image Size Addressability in Pixels ______________________________________________________________________ Landscape Format Portrait Format __________________________________________________________ Media Type Scan_Length Number_of_Scans Scan_Length Number_of_Scans ______________________________________________________________________ A-Size 2492 2440 2440 2492 A4-Size 2700 2368 2368 2700 Legal-Size 3198 2440 2440 3198 B4-Size 3198 2368 2368 3198 invertbw {pass|invert|default} This tag is optional. Specifies inversion of black and white pixels. This processes screen images that have a black background as white (blank) and white as black. The default pass results in no inversion. The default option uses the 4693D front panel printer defaults. gammacorrection {2.2|2.4|2.6|2.8|default|none} This tag is optional. Specifies the built-in gamma function to use while printing the GRF image file. The gamma correction options 2.2, 2.4, 2.6, and 2.8 result in a video gamma correction on each primary based on the following formula: out_primary = ROUND(255.0 * ((in_primary)/255.0))**CCX) where CXX is 2.2, 2.4, 2.6, and 2.8. The default is the default option which uses the 4693D front panel printer defaults. The none option results in no gamma correction. colorcorrection {4692|4693d|tekterminal|default|none} This tag is optional. Manipulates pixel colors prior to image rendering in order to match screen colors of the image to the ink colors of the 4693D printer. Values have the following meaning: tekterminal Performs color matching algorithm on 4693D printer. 4693d Performs printer gamma correction on the 4693D printer. Printed 5/12/88 4
TCPRDRVTEK4693D(8MDQS) COMMAND REFERENCE TCPRDRVTEK4693D(8MDQS) 4692 Does no manipulation of the pixel color data, currently an alias for none. default Use 4693D color printer front panel settings for color correction. none No color manipulation performed on the image file. The default is default. imagerendering {eightcolor | dither16 | default} This tag is optional. Specifies color rendering for the 4693D color hardcopy image. The defined parameter values are: eightcolor Matches a pixel's color to the closest of the eight following colors: black, red, green, blue, cyan, magenta, yellow, or white. dither16 This is a standard 16X16 magic square ordered dither using a 256- entry table to make a print/no print decision. default Use 4693D user-selected front panel defaults. The default is default. imagesizing {interpolation|replication|default|none} This tag is optional. Specifies the physical or relative size of the hardcopy image. The defined parameter values are: interpolation Interpolate the image to maximum size. This enlarges the image to the maximum fractional number of times consistent with the addressability of the 4693D printer. replication Replicate the image to maximum size. This forces the image to be enlarged the maximum integer number of times consistent with the addressability of the 4693D printer. Printed 5/12/88 5
TCPRDRVTEK4693D(8MDQS) COMMAND REFERENCE TCPRDRVTEK4693D(8MDQS) default Use 4693D user-selected front panel defaults. none Do not change the image size. The image is mapped one to one. The default is default. Header End Tag headerend This tag is required. Marks the end of all GRF header information and implicitly marks the start of the image data. OPTIONS -s Sets the driver communication mode to streaming. Default for the driver is handshake mode if this option is not selected. This option only affects the transmission of pixel data since copy request header data is always sent to the 4693D printer using handshake mode. Setting the driver to streaming mode allows much higher data rates when sending data to the 4693D printer. -b blocking_factor Sets the driver minimum blocking factor in increments of 1K bytes. The value blocking_factor can range in size from 1 to 64, corresponding to a blocking output buffer size of 1K bytes to 64K bytes. To efficiently perform output to the 4693D color printer the GRF driver blocks the data up into increments of scan lengths that are equal to or greater than the blocking factor. The default value is a minimum of a 4K output buffer. Note: Most users will not need this option. It is intended for user's that want to fine tune the performance of the GRF driver on their system. EXAMPLES The following example shows the /etc/tcprconf entry for the 4693D GRF protocol driver that is loaded for executing images processed for the Tektronix 4693D printer: Tek4693D_H Copier_Type /Copier_4693/ /usr/lib/mdqs/tcprdrv_Tek4693D The following example shows the GRF driver running in streaming mode: Printed 5/12/88 6
TCPRDRVTEK4693D(8MDQS) COMMAND REFERENCE TCPRDRVTEK4693D(8MDQS) Tek4693D_S Copier_Type /Copier_4693/ /usr/lib/mdqs/tcprdrv_Tek4693D -s The following example shows how to make the 4693D color printer accept images processed for the 4692 color printer. In this case, GRF tags specific to the Tektronix 4692 printer are ignored. Tek4693D_S Copier_Type /Copier_4692/ /usr/lib/mdqs/tcprdrv_Tek4693D -s DIAGNOSTICS Diagnostics are passed back to the MDQS daemon and reported in the MDQS console log specified in the /etc/qconf file. CAVEATS These drivers are never called directly by the user. They are specified in the file /etc/tcprconf and called by the tcprserver program executed by the MDQS daemon. FILES /etc/qconf Configuration information for MDQS /etc/tcprconf Configuration information used by tcprserver to map GRF tag entries to the correct printer protocol driver. /usr/lib/mdqs/tcprdrv_Tek4693D GRF protocol driver for the Tektronix 4693D color printer. /usr/lib/mdqs/tcprserver Program called by the daemon to print GRF image files. SEE ALSO tcpr(1mdqs), processing(1), screencopy(1), tchc(4), qconf(5mdqs), tcprconf(5mdqs), grf(5), mdqsd(8mdqs), tcprserver(8mdqs), tcprdrv_Tek4692(8mdqs), tcprdrv_Tek4696(8mdqs), sysadmin(8). REFERENCES For more information, consult the Users Manual for your system. ~ Printed 5/12/88 7
%%index%% na:620,132; sy:752,370; de:1122,4193;6007,4050;10749,4615;16056,4152;20900,4513;26105,952; op:27057,1726; ex:28783,471;29946,376; fi:31020,931; di:30322,267; ca:30589,431; se:31951,555; re:32506,219; %%index%%000000000233