       %                               DIGITAL    Software Product  Description   C ___________________________________________________________________   C PRODUCT NAME:  DIGITAL GKS Version 6.5 for OpenVMS Alpha        SPD  42.60.08   DESCRIPTION   J DIGITAL GKS (Graphical Kernel System) (formerly DEC GKS) for OpenVMS AlphaC Systems is a two-dimensional and three-dimensional graphics support D system that provides a set of programming functions for creating in-D teractive and noninteractive graphics applications. As a developmentF tool, DIGITAL GKS is a solid base for portable, device-independent ap-D plications that define and display graphical images, using a variety of graphics devices.  D DIGITAL GKS for OpenVMS Alpha is Digital Equipment Corporation's im-C plementation of the 1988 ISO 8805 standard GKS for Three Dimensions E (GKS-3D) and the ISO 7942 standard GKS. DIGITAL GKS conforms to level O 2c of this standard, providing full output capabilities, including workstation- E independent segment storage (level 2), and full synchronous and asyn- & chronous input capabilities (level c).  2 DIGITAL GKS is the merger of two earlier products:  6 o  DEC GKS-3D Version 1.2, a three-dimensional product  1 o  DEC GKS Version 4.2, a two-dimensional product   I The resulting product provides both two-dimensional and three-dimensional I capabilities in a single package, and was first made available as DEC GKS E Version 5.0. DIGITAL GKS supports DECwindows Motif for OpenVMS Alpha, E and is supported on most DIGITAL processors running the OpenVMS Alpha  Operating System.   C                                                          April 1997   C                                                         AE-Q13DJ-TE        G DIGITAL GKS is device-independent; the same program can generate graph- C ical output on different devices without modification to the source D code. The graphical output formats supported by DIGITAL GKS include:  # o  CGM (Computer Graphics Metafile)   - o  DDIF (DIGITAL Document Interchange Format)   , o  Hewlett-Packard Graphics Language (HP-GL)  4 o  Hewlett-Packard Printer Control Language (HP PCL)  
 o  PostScript   C DIGITAL GKS provides four language bindings in which graphical data D can be created and managed. These bindings are: C, ISO FORTRAN, GKS$6 (a two-dimensional, language-independent binding), and; GKS3D$ (a three-dimensional, language-independent binding).   F DIGITAL GKS is a subroutine library packaged as a set of shareable im-E ages with which application programs are linked. The shareable images $ are activated at run-time as needed.   NIST Certification  D The two-dimensional subset of DIGITAL GKS for OpenVMS Alpha receivedE certification from the U.S. National Institute of Standards and Tech- G nology in December 1994. Since then, DIGITAL GKS has been the only cer- * tified GKS implementation in the industry.  E Besides conforming to the ISO 7942, ISO 8805, and ISO 8806/1 (Fortran M binding) standards, DIGITAL GKS satisfies the requirements of FIPS PUB 120-1.    Floating Point Formats  I DIGITAL GKS for OpenVMS Alpha provides support for both IEEE and VAXfloat  floating point formats.       "                                  2        PEX Support   E DIGITAL GKS supports output to the DIGITAL implementation of PEX Ver- G sion 5.0 and PEX Version 5.1 servers. For OpenVMS Alpha, the PEX server D extension and the PEXlib object library are available as part of the) DIGITAL Open3D for OpenVMS Alpha product.    Output Modes  G With DIGITAL GKS, you can describe a graphical object using either seg- E ments or immediate mode. A segment is a set of output primitives that C are created, manipulated, and deleted as a group, but are not modi- E fiable. DIGITAL GKS manages segments internally and automatically re- F draws them if the display is damaged (for example, if the display win-" dow is obscured and then exposed).  G In immediate mode, primitives are rendered directly to the display sur- F face without being stored internally in DIGITAL GKS. This mode is use-E ful when graphical data is temporary, or will be refreshed by the ap- 
 plication.   Output Primitives   D DIGITAL GKS provides a variety of output primitives for creating ba-D sic 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- 8               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.           "                                  3         ? Fill Area     A set of polygonal areas with holes or disjointed @ Set           regions that are treated as a single entity. TheseA               areas can be hollow or filled with a uniform color, <               patterns, or hatch styles. Control of edge at-#               tributes is provided.   B Generalized   A primitive providing access to drawing capabilitiesB 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.   B 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 ofB               fonts, orientations, sizes, and colors. Text size is*               affected by transformations.  
 Attributes  C Each output primitive has an associated set of attributes that con- D 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         The width of the line.  Width         "                                  4         @ Color        The color of a primitive. You can select one of theB              predefined colors or specify the red, green, and blueA              intensities required to define a particular color on               color devices.   @ Character    Text attributes, including font, character spacing,0 Attributes   height, angle, path, and alignment.   Viewing Operations  D DIGITAL GKS allows you to specify views of three-dimensional objectsH and define the "working" or world coordinate system used in these views.H World coordinates can have any scale. For example, one application mightF have a maximum range from 0 to 1000.0; another application might limit the range from 0.01 to 0.1.   C You can control multiple, simultaneous views of the same objects on E one or more display surfaces, as well as the position and size of the C image on the surface. For example, one application program can dis- G play an image of a cube in one window on a workstation, and at the same E time, the program can display a detail of the back of the cube in an- 3 other window (on another workstation, if required).    Control Functions   E Control functions are used to perform system management tasks related D to the DIGITAL GKS environment, the workstation environment, and theD graphics display. These tasks include turning DIGITAL GKS on and offF when requested by the application, directing the flow of graphics data; to logical output devices and managing the picture process.    Inquiry Functions   E DIGITAL GKS includes a complete set of inquiry functions. These func- F tions are used to obtain information about the DIGITAL GKS state, seg-F ment storage, workstation capabilities, or the workstation state. ThisC information is essential for developing modular, device-independent 	 programs.   "                                  5        Escape Functions  H Escape functions are included with DIGITAL GKS to enable access to func-H tionality not provided in the GKS standard. The DIGITAL GKS escape func- tions include:   o  Double buffering control    o  Background pixmap control   o  Screen dumps    Logical Input Devices   E DIGITAL GKS supports synchronous and asynchronous input from the fol-  lowing logical input devices:   : Locator  Allows the user to select a point on the display.  @ Stroke   Allows the user to input a series of points on the dis-          play.  @ Valuator Allows the user to select a real number from a range ofA          numbers, for example, by sliding a pointer to a position           on a radio dial.   A Choice   Allows the user to make a selection, for example, from a #          list of choices in a menu.   B 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 A          the display. The information returned consists of a seg- >          ment name, a pick identifier, and the segment status.6          Primitives outside segments cannot be picked.        "                                  6        Character Fonts and Sets  H DIGITAL GKS includes a series of stroke-precision character fonts. TheseC character fonts were digitized by Dr. Allen V. Hershey of the Naval C Surface Weapons Laboratory, and supplied to DIGITAL by the National  Bureau of Standards.  D DIGITAL GKS also provides text support for the native character sets# of the supported graphical devices.    Language Bindings   F DIGITAL GKS functions can be accessed by four sets of subroutine callsH or "bindings," as they are referred to by the GKS standards. These bind-	 ings are:   H o  A FORTRAN binding that conforms to the ISO (DIS 8806/1) FORTRAN bind-    ing to GKS-3D.   D o  A C binding that conforms to a three-dimensional extension of the-    ISO (DP 8651/4) C language binding to GKS.   F o  GKS3D$, a language-independent, three-dimensional binding that fol-E    lows the standard calling conventions and is callable by many dif-     ferent languages.  E o  GKS$, a language-independent, two-dimensional binding that follows C    the standard calling conventions and is callable by many differ-     ent languages.    GKS-3D Metafile   E DIGITAL GKS provides the capability of reading and writing sequential C files in two formats: the ISO 8805 suggested GKS-3D Metafile format D and the ISO 7942 suggested two-dimensional GKSM Metafile format. The metafiles can be used to:   G o  Save and restore graphical information between sessions in a device-     independent format   F o  Transfer graphical information between systems with compatible ver-    sions of DIGITAL GKS   "                                  7       F o  Transfer graphical information between two DIGITAL GKS applications  D o  Transfer graphical information from a DEC GKS-3D application to a    DIGITAL GKS application  . o  Store accompanying nongraphical information  1 DIGITAL Document Interchange Format (DDIF) Output   H DIGITAL GKS provides support for storing two-dimensional views of three-J dimensional objects encoded in DIGITAL Document Interchange Format (DDIF).E Views stored in DDIF can be processed by applications that conform to 1 the DIGITAL Compound Document Architecture (CDA).   ' Computer Graphics Metafile (CGM) Output   G DIGITAL GKS provides support for storing information using the Computer G Graphics Metafile (CGM), an approved ANSI standard format (ANSI X3.122- A 1986). DIGITAL GKS supports CGM output for the following formats:   D o  Clear Text Encoding - Graphical output data stored in this formatC    is easily created, viewed, and modified using a common text edi- D    tor. This format is also suitable for transferring graphical out-D    put data through networks that support the transfer of text files    only.  D o  Character Encoding - Graphical output data is typically stored inH    this format to reduce the file size. This format is especially suitedF    to transfers through networks that do not support binary transfers.  C o  Binary Encoding - Graphical output data stored in this format is E    very compact and the fastest to read and write. This format is the C    least suitable for transmission over communication lines because *    all 8 bits in each byte are meaningful.            "                                  8        Graphics Handlers   C DIGITAL GKS includes support for a wide variety of graphics devices D provided by DIGITAL and other vendors. For devices that are not sup-C ported by DIGITAL, users can develop their own graphics device han- 5 dlers using the DIGITAL GKS device handler interface.   C Device handlers can be developed in DEC Fortran and DEC C. For more E information on this interface, refer to the Building a Device Handler F System for DEC GKS and DEC PHIGS manual (Order No. QA-810AK-GZ), which can be purchased separately.   CONFORMANCE TO STANDARDS  > DIGITAL GKS is designed to conform to the following standards:  E o  NIST Certification-DIGITAL GKS has obtained this certification and 0    satisfies the requirements of FIPS PUB 120-1.  7 o  ISO 8805 standard GKS for Three Dimensions (GKS-3D).    o  ISO 7942 standard GKS.   4 o  MIT X Window System Version 11 Release 5 (X11R5).   o  PEX Version 5.0 and 5.1.   E o  The FORTRAN binding conforms to the ISO (DIS 8806/1) FORTRAN bind-     ing to GKS-3D.    HARDWARE REQUIREMENTS   3 The following systems are supported by DIGITAL 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  "                                  9       ! 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   ' 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    Disk Space Requirements   E The disk space requirements for DIGITAL GKS depend on the kit you in-  stall, as shown.  "                                 10        DIGITAL GKS Development Kit:  * Disk space required for      46,000 blocks
 installation:   * Disk space required for      45,000 blocks use (permanent):   DIGITAL GKS Run-Time-Only Kit:  * Disk space required for      25,000 blocks
 installation:   * Disk space required for      24,000 blocks use (permanent):  E These counts refer to the disk space required on the system disk. The D sizes are approximate; actual sizes may vary depending on the user's8 system environment, configuration, and software options.  0 Memory Requirements for DECwindows Motif Support  D The minimum supported memory for DIGITAL GKS running in a standaloneE DECwindows Motif environment, with both the client and server execut- D ing on the same system, is 32 MB. The memory size suggested for mostC typical hardware configurations, however, is 64 MB or more, depend-  ing on the system.  C The system configuration and performance requirements of DECwindows D Motif applications can determine the memory needed on your system as follows:  D o  Less memory may be required on the client system (where the soft-D    ware is installed and executed) if the server (component display-2    ing the application) resides on another system.  E o  More memory may be required on a system where improved performance 9    is desired, or where several applications are running.     "                                 11        OPTIONAL HARDWARE   D DIGITAL GKS supports a variety of interactive and hard copy devices.E At least one of these devices is required to display graphics output.i  & Terminal for DECwindows Motif Clients:   o  DECterminal VXT 2000I  
 Terminals:  ? o  VT125 with black and white or optional color monitor (ReGIS)s  - o  VT240 with black and white monitor (ReGIS)   # o  VT241 with color monitor (ReGIS)   % o  VT330 with black and white monitore   o  VT340 with color monitorh  / o  TEKTRONIX 4014 with enhanced graphics moduleK    (Option 34) or equivalent  H    Note: The emulation of a TEKTRONIX 4014 is not supported on any hard-    ware.   o  TEKTRONIX 4107 terminal   o  TEKTRONIX 4128 terminal   o  TEKTRONIX 4129 terminal   o  TEKTRONIX 4207 terminal   Compatible Sixel Devices:S  K o  DIGITAL DEClaser 1100, 2100, 2150, 2200, 2250, 2300, 2400 Laser Printersf  ) o  DIGITAL LN03 with LN03S-UA upgrade kitg  " o  DIGITAL LN03 PLUS Laser Printer  ! o  DIGITAL LN03S-JA Laser Printerr  2 o  DIGITAL LA50 (restricted to a 2:1 aspect ratio)  "                                 12 A  K   o  DIGITAL LA75t   o  DIGITAL LA84:   o  DIGITAL LA86e   o  DIGITAL LA100   o  DIGITAL LA280  & o  DIGITAL LA324 (Color Sixel Printer)   o  DIGITAL LA380  E o  TEKTRONIX 4611 hard copy unit when connected to the TEKTRONIX 4014a    computer display terminal  5 Compatible Hewlett-Packard Graphics Language Devices:G   o  DIGITAL LVP16 Pen Plotter  % o  HP7475 Hewlett-Packard Pen Plottero  % o  HP7550 Hewlett-Packard Pen Plottern  % 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:a  . o  DIGITAL LCG01 Color Ink Jet Plotter (ReGIS)   o  DIGITAL LJ250 (Color Sixel)   Compatible PostScript Devices:   o  Apple LaserWriter   o  Apple LaserWriter PlusM  $ o  DIGITAL DEClaser 1150, 2150, 2250  "                                 13        o  DIGITAL LN03R ScriptPrinter   o  DIGITAL LPS20 Laser Printer  ! o  DIGITAL LPS20-GJ Laser PrinterP   o  DIGITAL LPS32 Laser Printer   o  DIGITAL LPS40 Laser Printer  ! o  DIGITAL LPS40-AJ Laser Printern  ! o  DIGITAL LPS40-DJ Laser PrinterR   SOFTWARE REQUIREMENTSn  : The software requirements for DIGITAL GKS Version 6.5 are:  7 o  OpenVMS Alpha Operating System Version 6.1 or highers  ; o  DECwindows Motif Version 1.2 or higher for OpenVMS Alpha   E For the development of applications and programs that use DIGITAL GKSeG on OpenVMS Alpha, one of the languages supported by DIGITAL GKS is alsos	 required.A   OpenVMS Alpha Tailoringe  E The following OpenVMS Alpha classes are required for full DIGITAL GKSh functionality:  " o  OpenVMS Alpha required save set   o  Network support   o  Programming support  D o  OpenVMS Alpha workstation support-if you are using DIGITAL GKS on    a workstation  "                                 14 f      OPTIONAL SOFTWAREI  E The following software is required to use DIGITAL GKS on PEX worksta-  tion types:o  D    DIGITAL Open3D-the version supported by the OpenVMS Alpha version    installed on your machine  ? DIGITAL GKS for OpenVMS Alpha supports the following languages:i    o  DEC Ada Version 3.0 or higher   o  DEC C Version 5.0 or higher  $ o  DEC Fortran Version 6.3 or higher  # o  DEC Pascal Version 5.0 or higheri  E Note: Certain versions of these products depend on a specific versiontF of the operating system. Please refer to the Software Product Descrip-C tion (SPD) of the product in question to determine which version ism
 necessary.   GROWTH CONSIDERATIONSd  E The minimum hardware and software requirements for any future version C of this product may be different from the requirements for the cur- 
 rent version.    DISTRIBUTION MEDIA  G This product is distributed on the OpenVMS Alpha Software Library Pack- & age CD-ROM (order number QA-03XAA-H8).  D Online documentation only is distributed on the OpenVMS Alpha OnlineF Documentation Library CD-ROM (order number QA-4KM8A-G8). Binaries onlyE are distributed on the OpenVMS Alpha Software Products Library CD-ROMo (order number QA-4KL8A-A8).i    "                                 15 s  a  D These library packages contain the DIGITAL GKS software binaries andI online documentation in Bookreader and PostScript format. The DIGITAL GKSlE documentation is also available in printed form, which can be ordered  separately.l   ORDERING INFORMATION  - Personal Use License DIGITAL GKS: QL-02UAA-2B . Unlimited Use License DIGITAL GKS: QL-02UA*-AA, Software Library Package CD-ROM: QA-03XAA-H8/ Software Documentation DIGITAL GKS: QA-02UA*-GZ 3 Software Product Services DIGITAL GKS: QT-810A*-**,  QT-02UA*-**e   Run-Time-Only Option:a  / Concurrent Use License DIGITAL GKS: QL-02VAA-3Bn. Unlimited Use License DIGITAL GKS: QL-02VA*-AA, Software Library Package CD-ROM: QA-03XAA-H83 Software Product Services DIGITAL GKS: QT-811A*-**,s QT-02VA*-**l  F *  Denotes variant fields. For additional information on available li-E    censes, services, documentation, and media, refer to the appropri-c    ate price book.   SOFTWARE LICENSING  D DIGITAL GKS is available in two forms: as a Development Kit and as aA Run-Time-Only Kit. These kits are furnished only under a license.   C The Development Kit license enables you to develop and run your own F graphics applications. The Run-Time-Only Kit license allows you to runG applications that were developed on a system where the full DIGITAL GKSiD product was installed. As a result, the Run-Time-Only Kit license isD available at a substantially lower cost per system than the Develop- ment Kit license.i      "                                 16    m  # License Management Facility Supportf  I DIGITAL GKS supports the OpenVMS Alpha License Management Facility (LMF). A This facility allocates license units for DIGITAL GKS as follows:m  G o  For the Development option-on a Personal Use and Unlimited Use basisa  E o  For the Run-Time-Only option-on a Concurrent Use and Unlimited Use.    basis  N Each Personal Use License allows one identified individual to use DIGITAL GKS.C Each Concurrent Use License allows only one individual at a time to D use DIGITAL GKS. Each Unlimited Use License allows any number of in-. dividuals to use DIGITAL GKS at the same time.  D For further details on the License Management Facility, refer to theJ OpenVMS Alpha Operating System Software Product Description (SPD 41.87.xx)C or the OpenVMS Alpha Operating System documentation. To obtain more C information about the DIGITAL licensing terms and policies, contact  your local DIGITAL office.   SOFTWARE PRODUCT SERVICESt  E A variety of service options are available from DIGITAL. For more in-s- formation, contact your local DIGITAL office.    SOFTWARE WARRANTYx  G Warranty for this software product is provided by DIGITAL with the pur-rC chase of a DIGITAL GKS license, as defined in the Software Warrantyt Addendum of this SPD.o  H The information in this document is valid at the time of release. PleaseF contact your local DIGITAL office for the most up-to-date information.  = [R]  Apple and LaserWriter are registered trademarks of Apple       Computer, Inc.       "                                 17    a    < [R]  Hewlett-Packard, HP, HP-GL, and LaserJet are registered+      trademarks of Hewlett-Packard Company.   > [R]  LASERGRAPHICS MPS-2000 is a registered trademark of Laser      Graphics, Inc.L  ? [R]  Motif and OSF/1 are registered trademarks of Open Softwares      Foundation, Inc.d  : [R]  PostScript is a registered trademark of Adobe Systems      Incorporated.  > [R]  TEKTRONIX and Tek are registered trademarks of Tektronix,	      Inc.o  A [TM] X Window System is a trademark of Massachusetts Institute off      Technology.  ; [TM] AlphaServer, AlphaStation, Bookreader, CDA, DDIF, DEC,DB      DEC Ada, DEC C, DEC Fortran, DEC GKS, DEC GKS-3D, DEC Pascal,@      DEClaser, DECwindows, DIGITAL, DIGITAL GKS, DIGITAL Open3D,>      LA50, LA75, LA84, LA86, LA100, LA280, LA324, LA380, LN03,A      LN03 PLUS, LN03 ScriptPrinter, LVP16, OpenVMS, ReGIS, VT125,e@      VT240, VT241, VT330, VT340, and the DIGITAL logo are trade-,      marks of Digital Equipment Corporation.  9 1997 Digital Equipment Corporation. All Rights Reserved.                         "                                 18