3 Compatibility With Previous Release
5 Silicon Graphics-Specific Behavior of Display PostScript/X
- 1 - 1. Introduction PostScriptr is an interpretive programming language with graphics capabilities for printing or displaying pages of text, two-dimensional graphics, and sampled images. Display PostScript/X (DPS/X) is a PostScript interpreter that renders on the screen. DPS/X is based on Level 2 PostScript language; Silicon Graphics' version of DPS/X is an extension of its X Window System. The first time you run an application that uses DPS/X, DPS/X is loaded into the X server dynamically. DPS/X applications are X applications as well and are run in much the same way. Note: Packaged with your system 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. Compatibility With Previous Release 4. DPS/X Application Examples 5. Silicon Graphics-Specific Behavior of Display PostScript/X 6. Documentation Errors 1.1 Release_Identification_Information Following is the release identification information for Display PostScript/X: Software Option Product Display PostScript/X Version 2.0.2 Product Code SC4-W4D-5.2 System Software Requirements IRIX 5.2 - 2 - 1.2 Online_Release_Notes After you install the online documentation for a product (the relnotes subsystem), you can view the release notes on your screen. You can also view the release notes directly from the CD, without installing them; see the pamphlet in the CD case for instructions. If you have a graphics system, select ``Release Notes'' from the Help 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 1-800-800-4SGI. If you are outside these areas, contact the Silicon Graphics subsidiary or authorized distributor in your country. - 1 - 2. Installation_Information Display PostScript/X should be installed if you want to use PostScript in a visual fashion: that is, to run applications that display and manipulate PostScript. xpsview (included with DPS/X), Adobe Illustratorr and FrameMaker are examples of such applications. This chapter lists supplemental information to the IRIS Software Installation Guide. The information listed here is product-specific; use it with the installation guide to install this product. 2.1 Display_PostScript/X_Subsystems The Display PostScript/X option includes these subsystems: dps_eoe.man.dps This subsystem contains man pages for some of the DPS/X applications, such as xpsview. dps_eoe.man.dpsdemo This subsystem contains man pages for some of the DPS/X demo applications, such as fontview. dps_eoe.sw.dps This subsystem contains the files required for DPS/X to execute properly in an X11 client environment. The most important requirement for these X11 client applications to run correctly is the X11 DISPLAY shell variable or the -display command line argument must indicate an X server with the Adobe-DPS extensions enabled and installed. To provide this capability on an SGI X11 server, the subsystem x_eoe.sw.xdps must be installed on the server the client is referencing in its DISPLAY shell variable. dps_eoe.sw.dpsdemo This subsystem contains DPS/X demonstration applications. Some may be useful as tools, such as fontview, which allows you to view the DPS/X fonts available on the system (like text in the previous release). Most of the applications are intended only to demonstrate some of the capabilities of DPS/X, such as wonderland and texteroids. These demonstration programs reside in /usr/demos/bin. - 2 - dps_eoe.sw.dpsfonts This subsystem contains 13 Adobe type 1 fonts. There are four styles (regular, bold, italic, bold-italic) of Courierr, Helvetica, and Times, and one style of Symbol. These fonts are in /usr/lib/DPS/outline/base. Additional fonts products may be purchased separately. An example is SGI's Impressario product, which contains an additional 22 Adobe type 1 fonts. dps_eoe.man.relnotes This subsystem contains these release notes. Note: All DPS/X client programs require the presence of the Adobe-DPS-Extension or 2DPSExtension in the X server referred to by the DISPLAY shell variable. On SGI systems, this requires the installation of the x_eoe.sw.xdps subsystem. If any SGI DPS/X client is run without the Adobe-DPS-Extension enabled in the X server, an error message will be displayed: ``The X11 Server DPS/X extension failed to initialize.'' If this happens, see if the Adobe-DPS-Extension is enabled by running the X command xdpyinfo. If the Adobe-DPS-Extension is not present, install the x_eoe.sw.xdps subsystem. 2.2 Installation_Method All of the subsystems for Display PostScript/X can be installed using IRIX. You do not need to use the miniroot. Refer to the IRIS Software Installation Guide for complete installation instructions. 2.3 Display_PostScript/X_Subsystem_Disk_Space_Requirements This section lists the subsystems of the Display PostScript/X option, along with their sizes and whether they are installed by default. If you are installing this option for the first time, the subsystems marked ``default'' 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, before you 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. - 3 - Subsystem Name Subsystem Size (512-byte blocks) dps_eoe.sw.dps (default) 1979 dps_eoe.sw.dpsfonts (default) 2205 dps_eoe.sw.dpsdemo 2952 dps_eoe.man.dps 67 dps_eoe.man.dpsdemo 16 dps_eoe.man.relnotes 17 2.4 Prerequisites To install dps_eoe.sw.dpsdemo, you must also install motif_eoe.sw.eoe. - 1 - 3. Compatibility_With_Previous_Release Display PostScript/X based on PostScript level 1 was new in IRIX 4.0, and Display PostScript/X based on PostScript level 2 was new in IRIX 5.0.1. However, Silicon Graphics' previous window system, 4Sight/NeWS, had similar functionality. DPS/X differs from 4Sight/NeWS by specializing only in rendering. This promotes standardization by allowing the native window system to handle all nonrendering activities such as input events. Because DPS/X is licensed from Adobe Systems, Inc., it adheres closely to the PostScript standard. Many of the incompatibility problems encountered with the PostScript interpreter in 4Sight/NeWS are alleviated with DPS/X. Just as Display PostScript/X is similar to NeWS, the DPS/X application xpsview is similar to the NeWS application psview. - 1 - 4. DPS/X_Application_Examples The Display PostScript/X previewer, xpsview, is a DPS/X application that allows you to view PostScript programs on the screen before (or instead of) sending them to a printer. Because it is also an X and Motif application, its behavior is much the same as other X and Motif applications, including launching, moving, resizing, and specifying resources for. xpsview replaces much of the functionality of the PostScript previewer, psview, found in previous IRIX releases. For more information on xpsview, see the man page or invoke xpsview (in /usr/bin/X11) with the -help option. The application xpsview can be launched from the Toolchest. Like many DPS/X applications, it runs in the X server's default visual. It is mentioned here simply because it is included in the default DPS/X installation. There are other DPS/X applications available as separate products, such as FrameMaker and Adobe Illustrator. - 1 - 5. Silicon Graphics-Specific Behavior of Display PostScript/X DPS/X is dynamically loaded into the X server when the first DPS/X extension request is made (that is, when the first DPS/X application is launched). It remains loaded until the server is reset. DPS/X creates a 4x4x4-cell colorcube and an 8-cell gray-ramp in the standard colormap. These colors can be ``swapped- out'' when applications that use a nonstandard colormap (such as GL applications) receive focus (just as their cells can be ``swapped-out'' when another X or DPS/X application receives focus). Although colors in windows that do not have input focus might look wrong, this is the correct behavior and ensures that the window with focus always shows the correct colors. The PostScript operator selectfont substitutes the Courier font if the requested font is not found. Normally Display PostScript/X uses prebuilt fonts (hand- tuned-bitmaps versus outline-rendering), but due to a bug this type of font rendering has been disabled. In future releases of DPS/X, SGI will either correct the problem with the prebuilt fonts or provide comparable bitmap fonts, such as the X portable compiled fonts (pcf's). All PostScript program file operators execute in the IRIX file system relative to /, the root directory. The string ``..'' is prohibited in filenames. Several of the DPS/X demos provide the DPS/X FontSelection panel window. In the current version of DPS/X, the demos that provide this feature have a longer than usual startup time. Future releases of DPS/X will hopefully improve this startup time. When launching the DPS/X demos from the toolchest, users should be careful to wait until the demo has started before launching a second DPS/X demo. Otherwise the X server may exit. This problem does not occur when multiple DPS/X demos are launched from a user shell. At least one IRIX 4.0.5-based DPS/X client causes the DPS/X extension to initialize incorrectly when it is the first DPS/X client run after a system reboot. The symptom is that the X server hangs. This problem can be avoided by running any one of the SGI-delivered DPS/X clients first, which initializes the DPS/X extension correctly. Once this is done, the problem 4.0.5 client can be run without problem. - 2 - - 1 - 6. Documentation_Errors There are no known documentation errors.