Impressario Release Notes

1 Introduction

2 Installation Information

3 Changes and Additions

4 Bug Fixes

5 Known Problems and Workarounds

6 Documentation Errors

 



                                  - 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.