5 Known Problems and Workarounds
- 1 - 1. Introduction Impressario is a visual printing and scanning environment for IRISr workstations. It consists of the Impressario software, the Impressario Developer's Kit, and 22 Type 1 PostScriptr fonts. Together, these pieces provide a total printing and scanning solution for IRIS workstations. The Impressario software provides a visual printing and scanning environment. It contains filters and drivers for sending print jobs to a printer connected directly to a host workstation. In addition, all Impressario drivers maintain status information in a printer object database. The Graphical Scan tool allows you to view data from a scanner, file, or workstation display and send the data to a printer, file, or workstation display. The Scanner installation tool provides a simple interface for installing and configuring scanners on your workstation. The Impressario Developer's Kit allows application and driver developers to create software that fully supports printing and scanning in a manner that is consistent with the Impressario architecture. The Impressario fonts subsystem contains 22 Type 1 PostScript fonts, which complement the base 13 fonts provided with Display PostScript. These additional fonts provide you with a complete set of industry standard fonts used in most PostScript printers. In addition, these fonts can be used with the Display PostScript system to create true WYSIWYG applications. Note: Packaged with your software is a separate sheet that contains the Software License Agreement. This software is provided to you solely under the terms and conditions of the Software License Agreement. Please take a few moments to review the Agreement. This document contains the following chapters: 1. Introduction 2. Installation Information 3. Changes and Additions 4. Bug Fixes 5. Known Problems and Workarounds - 2 - 6. Documentation Errors 1.1 Release_Identification_Information Following is the release identification information for Impressario: Software Option Product Impressario Version 1.2 Product Code Impressario SC4-IMP-1.2 Impressario Developer's Kit SC4-IMPD-1.2 System Software Requirements IRIX 5.2 1.2 Online_Release_Notes After you install the online release notes for a product (the relnotes subsystem), you can view the release notes on your screen. Note: You can read the online release notes for most products before installing the software. Refer to the booklet in your CD-ROM case for more information. If you have a graphics system, select ``Release Notes'' from the Help submenu of the Toolchest. This displays the grelnotes(1) graphical browser for the online release notes. Refer to the grelnotes(1) man page for information on options to this command. If you do not have a graphics system, you can use the relnotes command. Refer to the relnotes(1) man page for accessing the online release notes. 1.3 Product_Support Silicon Graphics, Inc., provides a comprehensive product support maintenance program for its products. If you are in the U.S. or Canada and would like support for your Silicon Graphics-supported products, contact the Technical Assistance Center at (800)800-4SGI. If you are outside these areas, contact the Silicon Graphics subsidiary or authorized distributor in your country. - 3 - - 1 - 2. Installation_Information This chapter lists supplemental information to the IRIS Software Installation Guide. The information listed here is product- and release-specific; use it with the Installation Guide to install this product. 2.1 Impressario_Subsystems Impressario consists of two separate products: the runtime product and the developer's kit. Depending on the Impressario product you have purchased, one or more of the following subsystems are on your distribution media. The runtime Impressario product includes the following subsystems: impr_base.man.relnotes Release notes for Impressario 1.2. impr_base.man.impr Manual pages for the base Impressario software. impr_base.books.user Impressario User's Guide. impr_base.sw.impr Base Impressario software. This subsystem should be installed by all users. impr_base.sw.il_image Support for the processing of Kodak Photo CD, TIFF and FIT images. Users wishing to work with these images must install this subsystem. impr_fonts.sw.adobe22 Additional 22 Adobe Type 1 fonts. This subsystem must be installed on the printer server machine. impr_fonts.man.gifts Manual pages for unsupported font installation tools. impr_fonts.sw.gifts Unsupported font installation tools. This is an optional subsystem. impr_scan.man.impr Manual pages for the Impressario scanning software. - 2 - impr_scan.sw.impr Base Impressario scanning software. This subsystem must be installed by all scanner users. In addition, you must install the appropriate scanning software subsystem for your model of scanner. impr_scan.sw.epson Support for the Epson GT-6000. impr_scan.sw.hp Support for the HP ScanJetr IIC. impr_scan.sw.ricoh Support for the Ricoh FS1. impr_scan.sw.sharpscsi Support for the Sharp JX 320. impr_scan.sw.utek Support for the MicroTek ScanMaker 600ZS. impr_server.man.impr Manual pages for the Impressario print server software. impr_server.sw.impr Base Impressario printer server software. All users with a printer physically connected to their system should install this subsystem. impr_server.sw.laserwriter Driver for the Appler LaserWriterr printers. Note that since the LaserWriter contains a built-in PostScript interpreter, the impr_rip subsystem is not required for this printer. impr_rip.man.impr Manual pages for the host- based PostScriptr interpreter. impr_rip.sw.impr Host-based PostScriptr interpreter. If you intend to connect any of the printers listed in the impr_rip_printers subsystem you must install this subsystem. impr_rip_printers.man.designjet Manual pages for the HP DesignJetr 650C printer. - 3 - impr_rip_printers.sw.designjet Driver for the HP DesignJet 650C printer. impr_rip_printers.man.deskjet Manual pages for the HP color DeskJetr and PaintJetr XL300 printers. impr_rip_printers.sw.deskjet Driver for the HP color DeskJet and PaintJet XL300 printers. impr_rip_printers.man.laserjet Manual page for the HP LaserJet printers. impr_rip_printers.sw.laserjet Drivers for the HP LaserJet IIP and later printers. The Impressario Developer's Kit includes all of the subsystems found on the Impressario runtime product plus these subsystems: impr_dev.books.developer Impressario Programming Guide. impr_dev.man.impr Manual pages for the Impressario developer's kit. impr_dev.sw.impr Base developer's kit software. All developers should install this subsystem. impr_dev.man.print Manual pages for the printing-specifc portions of the developer's kit. impr_dev.sw.print Printing developer's kit software. impr_dev.man.scan Manual pages for the scanning-specifc portions of the developer's kit. impr_dev.sw.scan Scanning developer's kit software impr_dev.man.tests Manual pages for the Impressario developer test programs. impr_dev.sw.tests Test programs and data for Impressario developers. - 4 - 2.2 Impressario_Subsystem_Disk_Space_Requirements This section lists the subsystems (and their sizes) for Impressario. If you are installing this product for the first time, the subsystems marked ``default'' are the ones that are installed if you use the ``go'' menu item. To install a different set of subsystems, use the ``install,'' ``remove,'' ``keep,'' and ``step'' commands in inst to customize the list of subsystems to be installed, then select the ``go'' menu item. Note: The listed subsystem sizes are approximate. Refer to the IRIS Software Installation Guide for information on finding exact sizes. Subsystem Name Subsystem Size (512-byte blocks) impr_base.man.relnotes (default) 38 impr_base.man.impr (default) 160 impt_base.books.user (default) 609 impr_base.sw.impr (default) 4258 impr_base.sw.il_image (default) 76 impr_fonts.sw.adobe22 (default) 3789 impr_fonts.man.gifts (default) 26 impr_fonts.sw.gifts (default) 108 impr_scan.man.impr (default) 11 impr_scan.sw.impr (default) 1661 impr_scan.sw.epson (default) 209 impr_scan.sw.hp (default) 188 impr_scan.sw.ricoh (default) 187 impr_scan.sw.sharpscsi (default) 200 impr_scan.sw.utek (default) 121 impr_server.man.impr (default) 27 impr_server.sw.impr (default) 820 impr_server.sw.laserwriter (default) 933 impr_rip.man.impr (default) 38 impr_rip.sw.impr (default) 2188 - 5 - impr_rip_printers.man.designjet (default) 14 impr_rip_printers.sw.designjet (default) 244 impr_rip_printers.man.deskjet (default) 13 impr_rip_printers.sw.deskjet (default) 1214 impr_rip_printers.man.laserjet (default) 15 impr_rip_printers.sw.laserjet (default) 1222 impr_dev.books.developer (default) 2584 impr_dev.man.impr (default) 209 impr_dev.sw.impr (default) 1599 impr_dev.man.print (default) 437 impr_dev.sw.print (default) 5549 impr_dev.man.scan (default) 112 impr_dev.sw.scan (default) 486 impr_dev.man.tests (default) 13 impr_dev.sw.tests (default) 7548 2.3 Installation_Method Complete installation of Impressario requires that the following steps be performed: 1. Install the Impressario software onto your system. 2. Restart the File Manager by logging out and then logging back in. 3. Connect the printer or scanner to the system. 4. Configure the Impressario software for use with the printer or scanner. The next three sections describe these steps in more detail. 2.3.1 Impressario_Software_Installation All of the subsystems for Impressario can be installed using IRIX. You do not need to use the miniroot. Refer to the IRIS Software Installation Guide for complete installation instructions. After software installation you must restart the File Manager in order for the file typing rules installed by Impressario to be read by the system. To restart the File Manager log out of the system and then log back in. - 6 - 2.3.2 Hardware_Installation If you are connecting a printer or scanner to your workstation, follow the instructions for installing the device that are provided by the manufacturer. Impressario does not support the Ikon VME parallel port board as a means of connecting printers or scanners. Note that when connecting an Apple LaserWriter printer to the serial port, the maximum cable length is 50 feet. Note that the HP LaserJet II and III series printers must have at least 1.5 MBytes of memory installed for proper operation with Impressario. HP LaserJet 4 printers require at least 4 MBytes of memory. All HP printers are faster if more than the minimum memory is installed. If the minimum required memory is not installed, a printer memory overflow error might occur, which generally produces odd artifacts such as clipped pages and garbage printed on subsequent pages. Most LaserJet printers come with less than the minimum memory required by Impressario so additional memory must be purchased. Note that the Apple LaserWriter IIf with 2 Mbytes of memory is not supported. You must have at least 4 Mbytes of memory installed in the printer. The Apple LaserWriter IIg with less than 8 Mbytes of memory cannot print the entire imageable area of the paper. See Chapter 3, ``Known Problems and Workarounds,'' for details. 2.3.3 Configuring_the_Impressario_Software Impressario printer software is configured using the Printer Manager tool. Printer Manager can be accessed from the Toolchest System menu. See the Personal System Administration Guide for details on installing printers. Impressario scanner software is configured using the Scanners tool that comes with Impressario. The Scanners tool can be accessed from either the System Manager or a shell. See the Impressario User's Guide for details on installing scanners. Impressario includes support for the following printers: o Apple LaserWriter Plus, II, IINT, IINTX, IIf, and IIg o Hewlett-Packard DeskJet 500C, 550C, and PaintJet XL300 o Hewlett-Packard DesignJet 650C. - 7 - o Hewlett-Packard LaserJet IIP, IIP+, III, IIIP, 4, 4P and 4L. All Apple LaserWriter printers must be connected to the system using a serial port. All Hewlett-Packard printers must be connected to the system using a parallel port. Note that all existing printers, including networked printers, must be deleted and reinstalled using the Printer Manager after you install Impressario. Networked printers can no longer be accessed via multiple levels of indirection. When using the Printer Manager to add a networked printer, only the printers directly connected to the specified host machine are displayed. Impressario includes support for the following scanners: o Hewlett-Packard ScanJet IIc o Ricoh FS1 o MicroTek ScanMaker 600 ZS o Sharp JX 320 o Epson GT 6000 2.4 Prerequisites Your workstation must be running at least IRIX release 4D1- 5.2 in order to use Release 1.2 of Impressario. To determine the IRIX system release, use the command: uname -a A number of Impressario subsystems require that other software subsystems be installed on the system. The following table lists the prerequisite subsystems for each Impressario subsystem. Note that the prerequisite subsystems may be other Impressario subsystems or subsystems in the base IRIX release. To use this table effectively, select the Impressario subsystems you wish to install and read the prerequisite subsystems. Use the versions(1M) command to determine whether the prerequisite subsystems are installed and use the inst(1M) program to install any missing subsystems. Impressario subsystems not listed in the table below do not have prerequisites. - 8 - ______________________________________________________ ______________________________________________________ impr_base.sw.impr eoe1.sw.unix print.sw.desktop ______________________________________________________ impr_base.sw.il_image il_eoe.sw.c++ il_eoe.sw.fit il_eoe.sw.photocd il_eoe.sw.sgi ______________________________________________________ impr_base.books.user insight.sw.client ______________________________________________________ ______________________________________________________ impr_scan.sw.epson impr_scan.sw.impr ______________________________________________________ ______________________________________________________ impr_scan.sw.ricoh impr_scan.sw.impr ______________________________________________________ ______________________________________________________ impr_scan.sw.utek impr_scan.sw.impr ______________________________________________________ ______________________________________________________ impr_server.sw.laserwriter impr_server.sw.impr ______________________________________________________ impr_rip.sw.impr impr_fonts.sw.adobe22 ______________________________________________________ impr_rip_printers.sw.designjet impr_server.sw.impr impr_rip.sw.impr ______________________________________________________ impr_rip_printers.sw.deskjet impr_server.sw.impr ______________________________________________________ impr_rip_printers.sw.laserjet impr_server.sw.impr impr_rip.sw.impr ______________________________________________________ ______________________________________________________ TABLE 1. Impressario Prerequisites 2.5 Compatibility Impressario 1.2 is backwards compatible with all previous releases of Impressario. In addition, Impressario 1.2 has been tested for compatibility with the following products: Company Product ___________________________________________________________ Tektronix PhaserPrint for Impressario 1.0 SRS Imaging SRSPrint for Impressario Genicom GenicomPrint 1.1 for Impressario 1.1 Seiko SeikoPrint for Impressario 1.1 Ricoh FS2 for Impressario 1.1 TABLE 2. Impressario Compatibility - 9 - Impressario 1.2 is not compatible with the Tektronix TekPhaser product. - 1 - 3. Changes_and_Additions o The Impressario Client software, impr_client, no longer exists. Part of the client's functionality has been merged into the print subsystem provided with the base IRIX operating system. The remainder of the client software has been merged into the Impressario Server software. Note that installing the impr_server subsystem will replace previously installed impr_client subsystems. o Impressario 1.2 supports direct printing of Kodak Photo CD, GIF, TIFF, FIT, and JPEG images. In addition both ASCII and binary PPM, PGM and PBM images can be directly printed. o The PrintBox widget included with the Impressario developer's kit now provides access to the printer graphical options panels and supports the saving and retrieval of these options. o Network scanning is now supported. o The gscan program can now handle 16 bits-per-channel image data. o The type argument to the SCSetup(3) function is now a pointer to a an SCDATATYPE structure. - 1 - 4. Bug_Fixes o A bug in the libpod library prevented applications from finding the POD database when the network resolution order was set to local. This has been fixed. o In the libstiff library the value for the STDateTime tag was incorrect. The tag value was actually specified as the TIFF Artist tag. The proper value for the STDateTime tag is now specified. This bug affected the psrip program output in that the images written by psrip were given time stamps that appear to TIFF image readers as being an Artist tag rather than a DateTime tag. o The STArtist tag was left out of stiff.h. It has now been added to the file. o In stiff.h the tags STPrimaryChromaticities and STJPEGInterchangeFormatLength were misspelled. They now have the correct spelling. o The DeskJet and PaintJet printers no longer report their printer type incorrectly as Color Raster. They now report the correct type ColorRaster. o The saving of options from glp when run from the printstatus program now works. o The printstatus program no longer polls for printer status once an unrecoverable error has occurred. To restart polling, choose Update Status from the Printer menu. o The Impressario PostScript interpreter, psrip, had an unintentional output image width limitation. The number of bytes per output image row could not exceed 8191. This limitation has been removed. o Printing on servers without graphics was problematic due to the need to set the DISPLAY environment variable. This problem has been resolved and the environment variable does not need to be set. - 1 - 5. Known_Problems_and_Workarounds 5.1 Impressario_Product_Specific o After installing the Impressario software, you must delete and reinstall all of the printers with the Printer Manager and restart the File Manager by logging out and back in. o If you run out of disk space in /usr/tmp on the Impressario server, print jobs fail silently. o Hewlett-Packard LaserJet II and III series printers do not work properly with less than 1.5 Mbytes of memory. LaserJet 4 series printers require at least 4 Mbytes of memory. If your output is garbled or only partially printed, make sure that you have enough memory installed in the printer. o Support for the Apple LaserWriter covers the LaserWriter Plus, II, IINT, IINTX, IIf, and IIg. Any other models of Apple LaserWriter are not currently supported. o Apple LaserWriter IIf printers with less than 4 Mbytes of memory are not supported. o Apple LaserWriter IIg printers with less than 8 Mbytes of memory cannot print the entire imageable area of the page. You must send the file /usr/lib/print/data/LW_2G_photograde_off to printers with less than 8 Mbytes of memory using the command: cat /usr/lib/print/data/LW_2G_photograde_off > /dev/ttyd[n] where [n] is the serial port number. This file turns off the PhotoGrade feature of the printer. The recommended solution is to upgrade your printer to at least 8 Mbytes of memory. o Early versions of the Apple LaserWriter IIg do not contain the Zapf Dingbatsr font in their built-in standard set of fonts. This was fixed in a firmware upgrade. Contact your Apple dealer for more information. o Networked printers can no longer be accessed via multiple levels of indirection. When using the Printer Manager to add a networked printer, only the printers directly connected to the host machine are displayed. - 2 - o The logging functions documented with libpod are not implemented in this release. o If two PrintBox widgets request a printer specific options panel for the same printer at the same time, it is possible for one options panel to appear over one PrintBox while being managed by the other PrintBox. The effect of this is that when one PrintBox is iconified, the options panel for the other PrintBox is removed from the screen and vice versa. This problem does not effect the setting of printer specific options. o The busy cursor may not return to normal after a printer specific options panel is displayed by the PrintBox widget. This does not effect the operation of the options panel. The problem exists only with the options panels provided by certain third party printer products. o Impressario 1.2 is not compatible with the Tektronix TekPhaser product. You are required to install Tektronix's PhaserPrint for Impressario product if you wish to use Tektronix printers with Impressario. o PostScript files created by the Microsoft Windows PostScript driver may print text incorrectly. The bug appears as text that should be on a single line stair- stepping down multiple lines. This is due to a bug in the Windows Win35Dict resource set. The bug is ignored by some PostScript Level 1 interpreters but Impressario's Level 1 RIP is susceptible to the problem. The PostScript file must be hand-edited to print correctly. Change the first occurrence of /yAscent Ascent def to /yAscent 0 def. This line is in the procedure called font but since there is only one occurrence of this line a simple text replace should edit the line without any need to find the procedure. o You may experience SCSI resets when attempting to open the Sharp JX-320 scanner. o The Epson GT-6000 cannot scan more than 4096 dots per scan line. Thus, at higher resolutions, it might not be possible to scan all of the scannable area. o The MicroTek ScanMaker 600ZS scanner driver does not support Black and White scanning. Only Color and Greyscale scanning are supported for this scanner. - 3 - 5.2 Third_Party_Products o The Tektronix PhaserPrint for Impressario product supports only the printing of PostScript, SGI Image and plain text files. The printing of Photo CD, GIF, TIFF, FIT and JPEG files is not supported. o GenicomPrint's options panel may be missing portions of the Format Text section. - 1 - 6. Documentation_Errors 6.1 Impressario_Product_Specific o The Impressario man pages and documentation mention the printer object database log file. Although the documentation of this file is correct, the log files are not used in this release of Impressario.