Software Product Description ___________________________________________________________________ PRODUCT NAME: HP GKS for OpenVMS Version 2.0 SPD 42.60.09 DESCRIPTION This is a software product description for HP GKS Version 7.O for Open- VMS for Integrity Servers and HP GKS for OpenVMS Alpha Version 6.5.. HP GKS (Graphical Kernel System) (formerly DIGITAL GKS) for OpenVMS for Integrity Servers and OpenVMS Alpha is a two-dimensional and three- dimensional graphics support system that provides a set of program- ming functions for creating in- teractive and noninteractive graph- ics applications. As a development tool, HP GKS is a solid base for portable, device-independent applications that define and display graph- ical images, using a variety of graphics devices. HP GKS for OpenVMS is HP's implementation of the 1988 ISO 8805 stan- dard GKS for Three Dimensions (GKS-3D) and the ISO 7942 standard GKS. HP GKS conforms to level 2c of this standard, providing full output capabilities, including workstation- independent segment storage (level 2), and full synchronous and asynchronous input capabilities (level c). HP GKS is the merger of two earlier products: o DEC GKS-3D Version 1.2, a three-dimensional product o DEC GKS Version 4.2, a two-dimensional product The resulting product provides both two-dimensional and three-dimensional capabilities in a single package, and was first made available as DEC GKS Version 5.0. HP GKS supports DECwindows Motif for OpenVMS Alpha and OpenVMS Integrity, and is supported on most HP processors running the OpenVMS Alpha or OpenVMS Integrity Operating Systems. June 2006 HP GKS is device-independent; the same program can generate graph- ical output on different devices without modification to the source code. The graphical output formats supported by HP GKS include: o CGM (Computer Graphics Metafile) o DDIF (DIGITAL Document Interchange Format) o Hewlett-Packard Graphics Language (HP-GL) o Hewlett-Packard Printer Control Language (HP PCL) o PostScript HP GKS provides four language bindings in which graphical data can be created and managed. These bindings are: C, ISO FORTRAN, GKS$ (a two- dimensional, language-independent binding), and GKS3D$ (a three-dimensional, language-independent binding). HP GKS is a subroutine library packaged as a set of shareable im- ages with which application programs are linked. The shareable images are activated at run-time as needed. NIST Certification The two-dimensional subset of DIGITAL GKS for OpenVMS Alpha received certification from the U.S. National Institute of Standards and Tech- nology in December 1994. Since then, HP GKS has been the only cer- tified GKS implementation in the industry. Besides conforming to the ISO 7942, ISO 8805, and ISO 8806/1 (Fortran binding) standards, DIGITAL GKS satisfies the requirements of FIPS PUB 120-1. Floating Point Formats HP GKS provides support for both IEEE and VAXfloat floating point for- mats. 2 PEX Support HP GKS supports output to the DIGITAL implementation of PEX Ver- sion 5.0 and PEX Version 5.1 servers. For OpenVMS Alpha, the PEX server ex- tension and the PEXlib object library are available as part of the Open3D for OpenVMS Alpha product. Output Modes With HP GKS, you can describe a graphical object using either segments or immediate mode. A segment is a set of output primitives that are created, manipulated, and deleted as a group, but are not modifiable. HP GKS manages segments internally and automatically redraws them if the display is damaged (for example, if the display window is obscured and then exposed). In immediate mode, primitives are rendered directly to the display sur- face without being stored internally in HP GKS. This mode is useful when graphical data is temporary, or will be refreshed by the appli- cation. Output Primitives HP GKS provides a variety of output primitives for creating basic two- dimensional and three-dimensional graphics. These primitives are: Cell Array A rectangular image specified by a two-dimensional array of rectangular color cells on a plane arbi- trarily placed in three-dimensional space. Fill Area A polygonal area that can be hollow or filled with a uniform color, a pattern, or a hatch style. The edges of the area are not defined and cannot be controlled. Fill Area A set of polygonal areas with holes or disjointed Set regions that are treated as a single entity. These areas can be hollow or filled with a uniform color, patterns, or hatch styles. Control of edge at- tributes is provided. 3 Generalized A primitive providing access to drawing capabilities Drawing of graphics devices not used by the other primitives Primitive listed here; circles and arcs are two common GDPs. (GDP) Polyline A set of connected lines defined by a series of points and having line type, line width, and color attributes defined. Polymarker One or more symbols that can mark significant points in a display and have type, size, scale, and color attributes defined. Text A character string at a given position in world coordinates. This string can be in 8-bit or 16- bit format, and can be displayed in a variety of fonts, orientations, sizes, and colors. Text size is affected by transformations. Attributes Each output primitive has an associated set of attributes that con- trol the primitive's appearance. Attributes can be defined in groups (bundles) or individually. Some examples of attributes are: Line Type The style of a line, for example, dotted or dashed. Line Width The width of the line. Color The color of a primitive. You can select one of the predefined colors or specify the red, green, and blue intensities required to define a particular color on color devices. Character Text attributes, including font, character spacing, Attributes height, angle, path, and alignment. Viewing Operations HP GKS allows you to specify views of three-dimensional objects and define the "working" or world coordinate system used in these views. World coordinates can have any scale. For example, one application might have a maximum range from 0 to 1000.0; another application might limit the range from 0.01 to 0.1. 4 You can control multiple, simultaneous views of the same objects on one or more display surfaces, as well as the position and size of the image on the surface. For example, one application program can dis- play an image of a cube in one window on a workstation, and at the same time, the program can display a detail of the back of the cube in an- other window (on another workstation, if required). Control Functions Control functions are used to perform system management tasks related to the HP GKS environment, the workstation environment, and the graph- ics display. These tasks include turning HP GKS on and off when re- quested by the application, directing the flow of graphics data to log- ical output devices and managing the picture process. Inquiry Functions HP GKS includes a complete set of inquiry functions. These functions are used to obtain information about the HP GKS state, segment stor- age, workstation capabilities, or the workstation state. This infor- mation is essential for developing modular, device-independent pro- grams. Escape Functions Escape functions are included with HP GKS to enable access to func- tionality not provided in the GKS standard. The HP GKS escape func- tions include: o Double buffering control o Background pixmap control o Screen dumps Logical Input Devices HP GKS supports synchronous and asynchronous input from the follow- ing logical input devices: 5 Locator Allows the user to select a point on the display. Stroke Allows the user to input a series of points on the display. Valuator Allows the user to select a real number from a range of numbers, for example, by sliding a pointer to a position on a radio dial. Choice Allows the user to make a selection, for example, from a list of choices in a menu. String Allows the user to input a character string, for example, as input to a prompt. Pick Allows the user to select an object that is visible on the display. The information returned consists of a segment name, a pick identifier, and the seg- ment status. Primitives outside segments cannot be picked. Character Fonts and Sets HP GKS includes a series of stroke-precision character fonts. These character fonts were digitized by Dr. Allen V. Hershey of the Naval Surface Weapons Laboratory, and supplied to Digital Equipment Corpo- ration by the National Bureau of Standards. HP GKS also provides text support for the native character sets of the supported graphical devices. Language Bindings HP GKS functions can be accessed by four sets of subroutine calls or "bindings," as they are referred to by the GKS standards. These bind- ings are: o A FORTRAN binding that conforms to the ISO (DIS 8806/1) FORTRAN bind- ing to GKS-3D. o A C binding that conforms to a three-dimensional extension of the- ISO (DP 8651/4) C language binding to GKS. 6 o GKS3D$, a language-independent, three-dimensional binding that fol- lows the standard calling conventions and is callable by many dif- ferent languages. o GKS$, a language-independent, two-dimensional binding that follows the standard calling conventions and is callable by many differ- ent languages. GKS-3D Metafile HP GKS provides the capability of reading and writing sequential files in two formats: the ISO 8805 suggested GKS-3D Metafile format and the ISO 7942 suggested two-dimensional GKSM Metafile format. The metafiles can be used to: o Save and restore graphical information between sessions in a de- viceindependent format o Transfer graphical information between systems with compatible ver- sions of HP GKS o Transfer graphical information between two DIGITAL GKS applications o Transfer graphical information from a DEC GKS-3D application to an HP GKS application o Store accompanying nongraphical information HP Document Interchange Format (DDIF) Output HP GKS provides support for storing two-dimensional views of three- dimensional objects encoded in DIGITAL Document Interchange Format (DDIF). Views stored in DDIF can be processed by applications that conform to the DIGITAL Compound Document Architecture (CDA). Computer Graphics Metafile (CGM) Output HP GKS provides support for storing information using the Computer Graph- ics Metafile (CGM), an approved ANSI standard format (ANSI X3.122-1986). HP GKS supports CGM output for the following formats: 7 o Clear Text Encoding - Graphical output data stored in this format is easily created, viewed, and modified using a common text edi- tor. This format is also suitable for transferring graphical out- put data through networks that support the transfer of text files only. o Character Encoding - Graphical output data is typically stored in this format to reduce the file size. This format is especially suited to transfers through networks that do not support binary transfers. o Binary Encoding - Graphical output data stored in this format is very compact and the fastest to read and write. This format is the least suitable for transmission over communication lines because all 8 bits in each byte are meaningful. Graphics Handlers HP GKS includes support for a wide variety of graphics devices pro- vided by HP and other vendors. For devices that are not supported by HP, users can develop their own graphics device handlers using the HP GKS device handler interface. Device handlers can be developed in HP Fortran and HP C. For more in- formation on this interface, refer to the Building a Device Handler System for DEC GKS and DEC PHIGS manual (Order No. QA-810AK-GZ), which can be purchased separately. CONFORMANCE TO STANDARDS HP GKS is designed to conform to the following standards: o NIST Certification-HP GKS has obtained this certification and sat- isfies the requirements of FIPS PUB 120-1. o ISO 8805 standard GKS for Three Dimensions (GKS-3D). o ISO 7942 standard GKS. o MIT X Window System Version 11 Release 5 (X11R5). o PEX Version 5.0 and 5.1. 8 o The FORTRAN binding conforms to the ISO (DIS 8806/1) FORTRAN bind- ing to GKS-3D. HARDWARE REQUIREMENTS The following Integrity Servers are supported by HP GKS: o rx1620 o rx2620 o rx3600 o rx6600 Note: For 3D graphics support in Integrity servers an AB551A needs to be added onto your Integrity Servers Options. The following Alpha Servers are supported by HP GKS: o DEC 2000 Model 300 Alpha Workstation o DEC 3000 Model 300 Alpha Workstation o DEC 3000 Model 300L Alpha Workstation o DEC 3000 Model 300LX Alpha Workstation o DEC 3000 Model 300X Alpha Workstation o DEC 3000 Model 400 AlphaServer o DEC 3000 Model 400 Alpha Workstation o DEC 3000 Model 500 AlphaServer o DEC 3000 Model 500 Alpha Workstation o DEC 3000 Model 500X Server o DEC 3000 Model 600 AlphaServer o DEC 3000 Model 600 Alpha Workstation o DEC 3000 Model 700 Alpha Workstation o DEC 3000 Model 800 AlphaServer 9 o DEC 3000 Model 800 Alpha Workstation o DEC 3000 Model 900 Alpha Workstation o DEC 4000 Model 610 Alpha System o DEC 4000 Model 700 Alpha System o DEC 7000 Model 610 Alpha System o DEC 10000 Model 610 Alpha System o DIGITAL AlphaStation 200 4/166 and 200 4 o DIGITAL AlphaStation 250 4/266 o DIGITAL AlphaStation 400 4/233 o DIGITAL AlphaServer 2100 4/200 and 4/275 Memory Requirements for DECwindows Motif Support The minimum supported memory for HP GKS running in a standalone DECwin- dows Motif environment, with both the client and server execut- ing on the same system, is 32 MB. The memory size suggested for most typ- ical hardware configurations, however, is 64 MB or more, depend- ing on the system. The system configuration and performance requirements of DECwindows Motif applications can determine the memory needed on your system as follows: o Less memory may be required on the client system (where the soft- ware is installed and executed) if the server (component display- ing the application) resides on another system. o More memory may be required on a system where improved performance is desired, or where several applications are running. 10 OPTIONAL HARDWARE HP GKS supports a variety of interactive and hard copy devices. At least one of these devices is required to display graphics output. Terminal for DECwindows Motif Clients: o DECterminal VXT 2000 Terminals: o VT125 with black and white or optional color monitor (ReGIS) o VT240 with black and white monitor (ReGIS) o VT241 with color monitor (ReGIS) o VT330 with black and white monitor o VT340 with color monitor o TEKTRONIX 4014 with enhanced graphics module (Option 34) or equiv- alent Note: The emulation of a TEKTRONIX 4014 is not supported on any hardware. o TEKTRONIX 4107 terminal o TEKTRONIX 4128 terminal o TEKTRONIX 4129 terminal o TEKTRONIX 4207 terminal Compatible Sixel Devices: o DIGITAL DEClaser 1100, 2100, 2150, 2200, 2250, 2300, 2400 Laser Print- ers o DIGITAL LN03 with LN03S-UA upgrade kit o DIGITAL LN03 PLUS Laser Printer o DIGITAL LN03S-JA Laser Printer o DIGITAL LA50 (restricted to a 2:1 aspect ratio) o DIGITAL LA75 11 o DIGITAL LA84 o DIGITAL LA86 o DIGITAL LA100 o DIGITAL LA280 o DIGITAL LA324 (Color Sixel Printer) o DIGITAL LA380 o TEKTRONIX 4611 hard copy unit when connected to the TEKTRONIX 4014 computer display terminal Compatible Hewlett-Packard Graphics Language Devices: o DIGITAL LVP16 Pen Plotter o HP7475 Hewlett-Packard Pen Plotter o HP7550 Hewlett-Packard Pen Plotter o HP7580 Hewlett-Packard Pen Plotter o HP7585 Hewlett-Packard Pen Plotter o LASERGRAPHICS MPS-2000 Film Recorder Compatible Hewlett-Packard PCL Level 4 Devices: o Hewlett-Packard LaserJet II Ink Jet Plotters: o DIGITAL LCG01 Color Ink Jet Plotter (ReGIS) o DIGITAL LJ250 (Color Sixel) Compatible PostScript Devices: o Apple LaserWriter o Apple LaserWriter Plus o DIGITAL DEClaser 1150, 2150, 2250 o DIGITAL LN03R ScriptPrinter 12 o DIGITAL LPS20 Laser Printer o DIGITAL LPS20-GJ Laser Printer o DIGITAL LPS32 Laser Printer o DIGITAL LPS40 Laser Printer o DIGITAL LPS40-AJ Laser Printer o DIGITAL LPS40-DJ Laser Printer SOFTWARE REQUIREMENTS The software requirements for HP GKS for OpenVMS Integrity Version 7.0 are: o HP OpenVMS Integrity Operating System Version 8.2-1 or higher The software requirements for HP GKS for OpenVMS Alpha Version 6.5 are: o HP OpenVMS Alpha Operating System Version 6.1 or higher o DECwindows Motif Version 1.2 or higher for OpenVMS Alpha For the development of applications and programs that use HP GKS on OpenVMS, one of the languages supported by HP GKS is also required. OpenVMS Alpha Tailoring The following OpenVMS Alpha classes are required for full HP GKS Al- pha functionality: o OpenVMS Alpha required save set o Network support o Programming support o OpenVMS Alpha workstation support-if you are using HP GKS Alpha on a workstation 13 OPTIONAL SOFTWARE The following software is required to use HP GKS on PEX worksta- tion types: o Open3D-the version supported by the OpenVMS Alpha version installed on your machine HP GKS for OpenVMS Alpha supports the following languages: o DEC Ada Version 3.0 or higher o HP C Version 5.0 or higher o HP Fortran Version 6.3 or higher o HP Pascal Version 5.0 or higher HP GKS for OpenVMS Integrity supprts the following languages: o HP C Version 7.2 or higher o HP Fortran Version 8.1 or higher o HP Pascal Version 6.0 or higher Note: Certain versions of these products depend on a specific version of the operating system. Please refer to the Software Product Descrip- tion (SPD) of the product in question to determine which version is necessary. GROWTH CONSIDERATIONS The minimum hardware and software requirements for any future version of this product may be different from the requirements for the cur- rent version. 14 DISTRIBUTION MEDIA HP GKS Alpha is distributed on the OpenVMS Alpha Software Library Pack- age CD-ROM (order number QA-03XAA-H8). HP GKS Integrity is distributed onthe OpenVMS Integrity Layered Prod- ucts Library included with the original purchase of any of the the HP Operating Environment media kits for Foundation, Enterprise or Mis- sion Critical Operating Environments beginning with the Q2, 2006 (June) quarterly update. (Order numbers are BA322AA, BA323AA or BA324AA.) Online documentation for HP GKS is distributed on the OpenVMS Alpha and OpenVMS Integrity Online Documentation Libraries, included with OpenVMS Alpha and OpenVMS Integrity media kits. ORDERING INFORMATION Licenses License types vary by platform. ___________________________________________________________________ HP_GKS_Development_Alpha___________________________________________ GKS Development Personal QL-02UAA-2B Use License: GKS Development Unlimited QL-02UA*-AA[1] Use License: GKS Run-Time Concurrent QL-02VAA-3B Use License: GKS Run-Time Unlimited QL-02VA*-AA[1] Use License: ___________________________________________________________________ [1]"*" Denotes system tier. E=workgroup tier, G=departmental tier, Q=Enterprise_tier._________________________________________________ 15 ___________________________________________________________________ GKS Development Per- BA369AC processor Core License (PCL)[1]: ___________________________________________________________________ [1]Order one PCL license for each active processor core running OpenVMS.___________________________________________________________ Media and Documentation Product binary kits and online documentation are delivered on consol- idated media libraries. Delivery model varies by platform. ___________________________________________________________________ OpenVMS_Alpha______________________________________________________ Software Library Package QA-03XAA-H8 CD-ROM[1] Online Documentation QA-03XAA-H8 Library[2] ___________________________________________________________________ [1]Quarterly update subscription is available. [2]Delivered_with_binaries._To_order_separately:_QA-4KM8A-G8_______ ___________________________________________________________________ OpenVMS_Integrity[1]_______________________________________________ Foundation Operating BA322AA#AJR Environment Enterprise Operating BA323AA#AJR Environment Mission Critical Operat- BA324AA#AJR ing Environment ___________________________________________________________________ [1]Product ships in Layered Product Library all Operating Environ- ment_media_kits._Updates_available_through_SW_Updates_Services.____ 16 NOTE: Updates are ordered for individual products per rather than as a quarterly subscription. The following media product numbers must be pulled into the order if Software Updates Services is planned: o GKS Development Media (for update only): BA369AA o GKS Run-Time Media (for update only): BA370AA SOFTWARE LICENSING HP GKS is available in two forms: as a Development Kit and as a Run- Time-Only Kit. These kits are furnished only under a license. The Development Kit license enables you to develop and run your own graphics applications. The Run-Time-Only Kit license allows you to run applications that were developed on a system where the full HP GKS prod- uct was installed. As a result, the Run-Time-Only Kit license is avail- able at a substantially lower cost per system than the Develop- ment Kit license. License Management Facility Support HP GKS supports the OpenVMS Alpha License Management Facility (LMF). This facility allocates license units for HP GKS as follows: o For the GKS Alpha Development option-on a Personal Use and Unlim- ited Use basis o For the GKS Alpha Run-Time-Only option-on a Concurrent Use and Un- limited Use basis o For the GKS Integrity Development and Run-Time-Only options-on a Per-processor Core basis. Each Personal Use License allows one identified individual to use HP GKS. Each Concurrent Use License allows only one individual at a time to use HP GKS. Each Unlimited Use License allows any number of individuals to use HP GKS at the same time. 17 Each Per-processor Core (PCL) License allows any number of individ- uals to use HP GKS at the same time, with one PCL license required for each processor core running OpenVMS. For further details on the License Management Facility, refer to the OpenVMS Operating System Software Product Description (SPD 82.35.xx) or the OpenVMS Operating System documentation. To obtain more infor- mation about the HP licensing terms and policies, contact your local HP office. SOFTWARE PRODUCT SERVICES A variety of service options are available from HP. For more infor- mation, contact your HP account representative or distributor. Infor- mation is also available on www.hp.com/hps/software. SOFTWARE WARRANTY This software is provided by HP with a ninety-day conformance warranty in accordance with the HP warranty terms applicable to a license pur- chase. © 2006 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for pos- session, use or copying. Consistent with FAR 12.211 and 12.212, Com- mercial Computer Software, Computer Software Documentation, and Tech- nical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional war- ranty. HP shall not be liable for technical or editorial errors or omis- sions contained herein. Apple is a trademark of Apple Computer, Inc., registered in the U.S. and other countries. 18 Intel, Intel Itanium and Pentium are trademarks or registered trade- marks of Intel Corporation or its subsidiaries in the United States and other countries. Motif and OSF/1 are registered trademarks of The Open Group. PostScript is a registered trademark of Adobe Systems Incorporated. TEKTRONIX and Tek are registered trademarks of Tektronix, Inc. X Window System is a trademark of Massachusetts Institute of Technol- ogy. 19