THE GRAPHICS KERNEL PACKAGES

The Graphics kernel is built from 14 software packages. These packages contain the primitive graphics routines and the graphics device drivers as well as some ancillary data sets. All support libraries built by the UDF-kernel packages are put in the directory $GPH_HOME/lib; executables are left in various directories all under the $GPH_HOME directory.

Graphics kernel software packages are found in the directory $GPH_HOME/PKGS.

Package Fact Sheets







 00.GINCLUDES.Mj.Mn.tar.gz


 Contents
     GPH kernel include files


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar


 PreInstalled Packages 
     ADMIN.tar


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/include


 Support Products Produced
     None








 01.GBASE.Mj.Mn.tar.gz


 Contents
     Graphics Ancillary Files


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GRAPHICS


 Directories Created
     $GPH_HOME/maintenance

                      $GPH_HOME/testplots

                      $GPH_HOME/ctable

                      $GPH_HOME/datafiles

                      $GPH_HOME/ancillary

                      $GPH_HOME/mapdata


 Support Products Produced
     Executable: list_to_bin

                      Executable: Gdevices

                      Executable: mapswap








 02.GPRIMITIVES.Mj.Mn.tar.gz


 Contents
     Graphics Drawing Primitives


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/g_kernal


 Support Products Produced
     Library: libgraf.a








 03.GPLOTTING.Mj.Mn.tar.gz


 Contents
     Graphics Plotting Routines


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/p_kernal


 Support Products Produced
     Library: libplt.a








 04.GMAPPING.Mj.Mn.tar.gz


 Contents
     Graphics Mapping Primitives


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     UDF_HOME


 Directories Created
     $GPH_HOME/m_kernal


 Support Products Produced
     Library: libmaps.a








 05.G3D.Mj.Mn.tar.gz


 Contents
     Graphics 3D Primitives


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/t_kernal


 Support Products Produced
     Library: lib3dgf.a








 06.GCONTOUR.Mj.Mn.tar.gz


 Contents
     Graphics Contouring Primitives


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/c_kernal


 Support Products Produced
     Library: libcont.a








 07.GGIF.Mj.Mn.tar.gz


 Contents
     Graphics GIF driver


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/drivers/gif


 Support Products Produced
     Library: libgdrv.a








 08.GPOSTSCRIPT.Mj.Mn.tar.gz


 Contents
     Graphics Postscript Driver


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/drivers/pc_script


 Support Products Produced
     Library: libgdrv.a








 09.GRASTER.Mj.Mn.tar.gz


 Contents
     Graphics Raster Driver


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/drivers/raster


 Support Products Produced
     Library: libgdrv.a








 10.GTK.Mj.Mn.tar.gz


 Contents
     Graphics Tk Driver


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/drivers/Tk


 Support Products Produced
     Library: libgdrv.a








 11.GUTIL.Mj.Mn.tar.gz


 Contents
     Graphics Utility Routines
 

 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/drivers/util


 Support Products Produced
     Library: libgdrv.a








 12.GXWINDOWS.Mj.Mn.tar.gz


 Contents
     Graphics X-Windows Driver


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/drivers/xwindows


 Support Products Produced
     Library: libgdrv.a








 13.EPS.Mj.Mn.tar.gz


 Contents
     Graphics Encapsulated Postscript Driver


 Package Location 
     anonymous ftp on pluto.space.swri.edu


 Package Directory
     pub/in.coming/UDF


 Part Of 
     Graphics Kernel


 PreInstalled Packages 
     ADMIN.tar

                      00.GINCLUDES.Mj.Mn.tar.gz


 Used Environment Variables 
     GPH_HOME


 Directories Created
     $GPH_HOME/drivers/eps


 Support Products Produced
     Library: libgdrv.a






Updating the Graphics Kernel Under UNIX/WINDOWS

To update the Graphics kernel follow the steps below:

    

    

  1.  Retrieve all packages to be updated 
and place them in the directory $GPH_HOME/PKGS

    

  2. 
Invoke the UDF Administration Tool as

    

    

     UNIX

     $UDFTOOL_HOME/bin/UDFAdmin

    

     WINDOWS

    cygwish80 $UDFTOOL_HOME/bin/UDFAdmin

    

    

    
Note that if $UDFTOOL_HOME/bin is in your search path you do not need
to preappend it to the file name.  

    

    
The following window will be displayed:

    


    
The upper portion of the menu is used to select various options for
installing individual software modules, UDF data, or to perform various
maintenance operations.  The lower portion of the menu displays the
current environment variable settings used by the install routines.

    
Select INSTALL GRAPHICS SOFTWARE.  
This pops up the window:

    


    
which lists of all of the current graphics software packages under the 
directory $GPH_HOME/PKGS.  All installed packages will have their current 
major and minor revision number listed under the CURRENT VERSION 
column.  Available software packages which have version numbers greater 
than the currently installed package are pointed to by an arrow. 

    

    
Clicking on a given package selects it (entry is highlighted).  Clicking
on a selected package de-selects it.

    

    
Select all of the packages to be upgraded.  Upgrading all necessary
packages at once ensures that they get upgraded in the correct order.
It also prevents dependent packages from being compiled and linked
multiple times which though not necessarily bad can be time consuming.

    

    
When all packages to be upgraded have been selected, click on the 
PROCESS button at the top of the menu 
page.  This will install all of the selected packages.  As each package is 
installed its current version is updated.  Some information may also appear 
be found in the lower dialog box.  

    

  3.  At this point the graphics kernel is fully upgraded.  If you want to
delete older packages, highlight the packages to be deleted and then click 
on the DELETE button.  This will remove 
the selected packages.

    

  4. CLOSE the window and if there are 
no actions to be taken within the UDF Administration Tool, 
QUIT the application.





Adding/Removing Device Drivers

Programs which use the graphics kernel routines can generate plots on 
any device whose driver is both compiled in the kernel and listed in 
the Graphics Device File.  To add or remove a driver from the Graphics 
Device File click on the GRAPHICS DEVICES 
button in the INSTALL GRAPHICS SOFTWARE 
window.  This will produce the following window displaying all the graphical 
output devices available to the kernel.









A graphics device driver is to included within the graphics kernel if
its state is ON and excluded if its 
state is OFF.  The state of a device 
driver can be toggled by clicking on it.  Note that if you did not build 
the XWindows device driver do not try 
to include it in the kernel here.  This will cause problems later.  All 
device drivers are built in the initial Full Install with the possible 
exception of the XWindows device driver 
which is built only if the XLIB 
environment variable was set.




Once you have finished selecting and deselecting the device drivers, click 
on the PROCESS button.  This updates the 
Graphics Device File and recompiles the graphics routine in which graphics
devices are selected.




CLOSE the window and if there are no 
packages to be upgraded CLOSE the INSTALL 
GRAPHICS SOFTWARE window. QUIT the 
UDF Administration Tool if there is no further actions to be taken.



Compiling the Graphics Testplots

The graphics installation can be tested through a series of testplots.
If you wish to test the graphics installation, click on the 
COMPILE TESTPLOTS button in the 
INSTALL GRAPHICS SOFTWARE 
window.  This compiles a set of testplots.


Once the compiles are finished CLOSE 
the INSTALL GRAPHICS SOFTWARE window and QUIT
 the UDF Administration Tool.




The compiled testplots can be viewed through the 
following steps:



    

  1. 
Change directory to $UDFTOOL_HOME/GMenu/Examples. 

    

    

     

     cd $UDFTOOL_HOME/GMenu/Examples

    

    

  2. 
Bring up the Generic Menus Control Window.

    

    

     UNIX

     $UDFTOOL_HOME/bin/CONTROL

    

     WINDOWS

    cygwish80 $UDFTOOL_HOME/bin/CONTROL

    

    

    
Note that if $UDFTOOL_HOME/bin is in your search path you do not need
to preappend it to the file name.  

    

    
This will bring up the menu:

    

    


    

    

  3. 
In the Load Menu Entry Box type 
SHOW_PLOTS and then hit return.  The return will echo the Load Menu name 
into the Save To Box.  Now click on 
the Load Menu button.  This loads 
the requested menu, expands the the Generic Control Menu 

    

    

    


    

    
and pops up the SHOW_PLOTS menu page

    

    


    

    

  4. 
There are several selectable options on the SHOW_PLOTS menu page.  The
first of these is the OUTPUT DEVICE 
option.  This allows the output device to be selected.  Click on the 
OUTPUT DEVICE button and select one 
of the available devices, preferably either X Windows or Tk Canvas.  Make 
the selection even if the device you want to use is currently selected as 
this will resync the menu to your device drivers and to the location they 
occupy in the device driver table which was set up in the graphics install.

    

    
The COLOR TABLE button allows you to 
select between different color tables. 

    

    
The PROGRAM button allows you to select 
between the different testplots available.  The 
drmap testplot program which is an Earth mapping program requires 
the selection of a mapping projection and a longitudinal rotation.  If the 
projection selected is AZIMUTHAL then 
a LATITUDINAL ROTATION is also required.
All required inputs have reasonable defaults already set.

    

    

  5. 
Once you have a testplot selected and all needed parameters set click on 
the Run FrGnd button to view it unless 
you selected Tk Canvas as the output device then click on the 
Run TkWin button.  Both X-Windows and 
Tk Canvas will display the plot on the screen.  Other selections will 
create the appropriate plot files.  To return to the SHOW_PLOTS menu with 
an X-Window generated plot, hit a return in the plot window.  To return 
to the SHOW_PLOTS window with a Tk Canvas generated plot click on the 
continue button in the upper right-hand 
corner of the plot window.

    
Using the options shown in the SHOW_PLOTS window above will produce 
the plot