TCPRDRVTEK4692(8MDQS) COMMAND REFERENCE TCPRDRVTEK4692(8MDQS) NAME tcprdrv_Tek4692 - MDQS color printer server GRF driver for Tektronix 4692 SYNOPSIS tcprdrvTek4692 [ -s ] [ -b blocking_factor ] DESCRIPTION tcprdrvTek4692 is an installable Generic Raster Format (GRF) protocol driver used by the tcprserver color printer server program (see tcprserver(8mdqs)). It is used to map GRF image files to the Tektronix 4692 color printer by performing the protocol conversions needed to output the GRF image file to the 4692 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 currently driving. GRF protocol drivers can only be executed 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 4692 color printer by adding an entry in the /etc/tcprconf file for them. tcprdrvTek4692 recognizes the following GRF tag entries needed to convert the GRF image file for the 4692 printer: Image Information Tags numberofscans {1-maxnumberofscans} This tag is required. Specifies the number of rasters (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 raster line are sequenced from left to right. The 4692 driver is unable to accept image files that are sequenced right to left. imagetype {copydata} This tag is required. Printed 4/6/89 1
TCPRDRVTEK4692(8MDQS) COMMAND REFERENCE TCPRDRVTEK4692(8MDQS) Specifies the file contains an image that is processed for output to a hardcopy printer. scanlength {1-maxscanlength} This tag is required. Specifies the number of pixels in each raster 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 raster lines are sequenced from top to bottom. The 4692 driver is unable to accept image files that are sequenced from bottom to top. Data Information Tags bitspervalue {1|2|4|8} 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 three consist of 3 values per line in CMY or RGB depending on the colorunits 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 4/6/89 2
TCPRDRVTEK4692(8MDQS) COMMAND REFERENCE TCPRDRVTEK4692(8MDQS) are preceded by the color map index for the entry. This allows for suppling only the color map entries that are needed to specify the image file. packinglevel {nopacking|simple|pattern|pixel} This tag is required. Indicates whether the image data has been compressed and what type of compression was 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 valuefieldwidth tag entry. For color intensity encoded images this value must be at least three times the value of the valuefieldwidth 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 bitspervalue tag entry. The index or intensity values are right-justified in the fields. 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 4692 color printer media type and image format: Maximum Image Size Addressability in Pixels _______________________________________________________________________ Landscape Format Portrait Format _______________________________________________________________________ Media Type Scan_Length Number_of_Scans Scan_Length Number_of_Scans _______________________________________________________________________ A-Size 1532 1150 1150 1532 Printed 4/6/89 3
TCPRDRVTEK4692(8MDQS) COMMAND REFERENCE TCPRDRVTEK4692(8MDQS) A4-Size 1536 1152 1152 1536 _______________________________________________________________________ invertbw {pass|invert|default} This tag is optional. Specifies black and white pixel inversion on the 4692. This is especially useful for printing text images. The default is pass which is no inversion. The default tag parameter is an alias for the pass parameter. imagequality {variable|high|highest} This tag is optional. Specifies whether the 4692 printer exhibits fixed or variable resolution. Each parameter has the following meaning: variable The printer can adjust its resolution to expand the image data if required. However, if the image is less than or equal to 1/2, 1/3, or 1/4 of the page size, the printer replicates pixels 2, 3, or 4 times in both directions. high The printer remains fixed at maximum resolution, but still does pixel replication. highest An alias for the high tag parameter on the 4692 printer. The default is high. repaintpasses {1-4} This tag is optional. Specifies the number of repaint passes the 4692 printer makes. This is usually done when making transparencies. The default is 1. A value of 1 makes one pass over the image by the 4692 printer. 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. Printed 4/6/89 4
TCPRDRVTEK4692(8MDQS) COMMAND REFERENCE TCPRDRVTEK4692(8MDQS) 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 4692 printer using handshake mode. Setting the driver to streaming mode allows for much higher data rates in sending data to the 4692 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 4692 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 for a minimum 4K output buffer. Note: Most users do not need be concerned with this option. It is intended for users 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 4692 GRF protocol driver that is loaded for executing images processed for the Tektronix 4692 printer: Tek4692_H Copier_Type /Copier_4692/ /usr/lib/mdqs/tcprdrv_Tek4692 The following example is for the GRF driver running in streaming mode: Tek4692_S Copier_Type /Copier_4692/ /usr/lib/mdqs/tcprdrv_Tek4692 -s The following example shows how to make the 4692 printer accept images processed for the 4693D color printer. In this case, GRF tags specific to the Tektronix 4693D printer are ignored. Tek4692_S Copier_Type /Copier_4693D/ /usr/lib/mdqs/tcprdrv_Tek4692 -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. Printed 4/6/89 5
TCPRDRVTEK4692(8MDQS) COMMAND REFERENCE TCPRDRVTEK4692(8MDQS) 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_Tek4692 GRF protocol driver for the Tektronix 4692 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_Tek4693D(8mdqs), tcprdrv_Tek4696(8mdqs), sysadmin(8). REFERENCES For more information, consult the Users Manual for your system. Printed 4/6/89 6
%%index%% na:596,130; sy:726,359; de:1085,4236;5989,4106;10763,5028;16459,3622; op:20749,1739; ex:22488,836; fi:24689,891; di:23324,267; ca:23591,430; se:25580,558; re:26138,235; %%index%%000000000202