@(#)readme.doc 10.1 (OAA-ASTRONET) 8/7/95 19:23:13
HEADER : readme.doc - Vers. 3.6.001 - L. Fini, May 1990
AGL 3.61
ASTRONET Graphics library
AGL is a graphic library designed to be portable on different
systems, with both a C and a FORTRAN programmin interface.
Systems for which the porting of AGL has been tested up to now
are:
Apollo/AEGIS/Unix
HP/UX
Linux
MS-DOS (vers. 3.20 and up)
Solaris
Stellix (Stellar Unix)
Sun OS (Unix BSD 4.2)
Ultrix (DEC Unix)
VAX/VMS (vers. 4.x, 5.x)
Library building directions:
1. Copy all the distribution files on a suitable directory
in your disk (if AGL is already in use you MUST use a
DIFFERENT directory).
2. Follow directions into the "AGL Installation and Custo-
mization Guide".
NOTE: A bug has been discovered into the routine AG_RVAL
since version 3.51; the value return array was incor-
rectly declared as "double": a violation of the stand-
ard type float for floating point arguments used
throughout AGL. It has been corrected to float. This
MAY AFFECT some application programs suited to previous
AGL versions!
WHERE TO FIND INFORMATION
File name Contents
aglinsta.doc Installation and Customization Manual.
agldriv.doc Guide to writing an AGL Device driver.
cintf.doc C language Programmer's Reference Manual
devices.doc Implementation notes concerning AGL device drivers
and device specific information.
fintf.doc FORTRAN language Programmer's Reference Manual
ip.doc AGL Testing Program Reference Manual
readme.doc This document
AGL 3.61
Distribution notice
===================
The Astronet Graphic library has been designed and
implemented under the coordination of the Astronet Working Group
"Graphics and Image Displays".
The software is officially supported by Astronet and is
distributed by:
Astronet Documentation Facility (ADOC)
Osservatorio Astronomico di Trieste
C.P. Succ. TS 5
Via G.B.Tiepolo, 11
34131 Trieste, Italia
Tel: +39 40 319911
Fax: +39 40 309418
e-mail: adoc@astrts.astro.it
The distribution release may also be obtained by anonymous ftp
at:
sisifo.arcetri.astro.it:pub/agl
or via e-mail, from the author:
Luca Fini
Osservatorio Astrofisico di Arcetri
L.go E. Fermi 5,
50125 Firenze, Italia
Tel: +39 55 27521
Fax: +39 55 220039
e-mail: lfini@astrfi.astro.it
Files Included within AGL 3.61 kit
==================================
A) C Interface modules
ag_axes.c AG_AXES routine
ag_axis.c AG_AXIS routine
ag_cdef.c AG_CDEF routine
ag_cls.c AG_CLS routine
ag_dmsg.c AG_DMSG routine
ag_driv.c AG_DRIV routine
ag_esc.c AG_ESC routine
ag_fill.c AG_FILL routine
ag_gerr.c AG_GERR routine
ag_getn.c AG_GETN routine
ag_gets.c AG_GETS routine
ag_gint.c AG_GINT routine
ag_gplg.c AG_GPLG routine
ag_gpll.c AG_GPLL routine
ag_gplm.c AG_GPLM routine
ag_gtxt.c AG_GTXT routine
ag_hist.c AG_HIST routine
ag_idn.c AG_IDN routine
ag_iget.c AG_IGET routine
ag_iset.c AG_ISET routine
ag_ival.c AG_IVAL routine
ag_magn.c AG_MAGN routine
ag_mcls.c AG_MCLS routine
ag_mopn.c AG_MOPN routine
ag_mrdw.c AG_MRDW routine
ag_mres.c AG_MRES routine
ag_msus.c AG_MSUS routine
ag_newn.c AG_NEWN routine
ag_nlin.c AG_NLIN routine
ag_orax.c AG_ORAX routine
ag_rget.c AG_RGET routine
ag_rset.c AG_RSET routine
ag_rval.c AG_RVAL routine
ag_scan.c AG_SCAN routine
ag_sset.c AG_SSET routine
ag_stdo.c AG_STDO routine
ag_sval.c AG_SVAL routine
ag_tget.c AG_TGET routine
ag_trns.c AG_TRNS routine
ag_trot.c AG_TROT routine
ag_vdef.c AG_VDEF routine
ag_vers.c AG_VERS routine
ag_vkil.c AG_VKIL routine
ag_vloc.c AG_VLOC routine
ag_vlos.c AG_VLOS routine
ag_vn2u.c AG_VN2U routine
ag_vsel.c AG_VSEL routine
ag_vu2n.c AG_VU2N routine
ag_vupd.c AG_VUPD routine
ag_wdef.c AG_WDEF routine
B) Support modules
aglaxutl.c Support routines for axes generation
aglbsd.c Unix BSD dependencies
aglchar.c Character and symbol generator code
agldash.c Dot-dash support routines
aglddef.c Driver entry point customization file
agldos.c MS-DOS dependencies
aglerror.c Error management routines
aglfonts.c Standard fonts definitions
aglget.c AGL get status support routines
aglgraph.c Low level graphic routines
aglinit.c Initialization routines
aglloc.c Locator support routines
aglmfaux.c Metafile management routines
aglpoly.c Auxiliary polyline operations
aglposix.c Posix dependencies
aglset.c AGL set status support routines
aglstat.c Status operations routines
aglsys.c System dependent code include file
aglsysv.c Unix System-V dependencies
aglunix.c Generic Unix dependencies
aglutil.c Miscellaneous utility routines
aglvms.c VAX/VMS dependencies
C) FORTRAN interface
uxcfintf.c Unix fortran interface
fintf.fc Unix/VMS fortran interface for MIDAS
aglerror.f FORTRAN style error codes definition
msfintf.for Microsoft FORTRAN 4.0 interface
vmsfienv.for VAX/VMS FORTRAN interface definitions
vmsfintf.for VAX/VMS FORTRAN interface
D) Drivers and device related modules
agluosx.c Unix process communication interface routines
aglvosx.c VAX/VMS process communication interface routines
epson.c Rasterizer for Epson FX-80 printer
gpxserv.for Program to create a Tek window on VMS GPX W/S
hpgldef.c Driver interface definitions for HPGL plotters
hpgldrv.c Driver for HPGL plotters
ibmpcdef.c Driver interface definitions for IBM PC screen
ibmpcdrv.c Driver for IBM PC screen
ididef.c Driver interface definitions for IDI devices
ididrv.c Driver for IDI devices
killserv.c AGL Window server killer
nulldef.c Driver interface definitions for null device
nulldrv.c Driver for null device
plotv80.c Rasterizer for Versatec
pscrdef.c Driver interface definitions for PostScript printers
pscrdrv.c Driver for PostScript printers
rastdef.c Driver interface definitions for raster devices
rastdrv.c Driver for raster devices
sendv80.c Rasterizer for Versatec
tekdef.c Driver interface definitions for tektronix like dev.
tekdrv.c Driver for tektronix like devices
versatec.c Rasterizer for Versatec
winddef.c Driver interface definitions for window server devices
winddrv.c Driver for window server devices
x11def.c Driver interface definitions for X11 direct driver
x11drv.c Driver for X11 direct driver
x11aux.c X11 support auxiliary modules
x11serv.c AGL window server for X11
E) Auxiliary programs
mf2ascii.c AGL metafile to ASCII metafile conversion utility
ascii2mf.c ASCII to AGL standard metafile conversion utility
F) Test programs
fonts.c AGL fonts display program
ip.c Interactive Plotting utility program
ipaux.c Ip module
ipcalc.c Ip module
ipcommnd.c Ip module
iperrors.c Ip module
ipplot.c Ip module
mkcspeed.c AGL speed tester program generator
test1.f Fortran test program
test2.f Fortran test program
testfo.f Fortran test program
G) Test procedures to be used with program ip
axes.m Test AG_AXES routine
axis.m Test AG_AXIS routine
devinfo.m Get device related information
ident.m Get identification information
testbw.m Test some "black & white" characteristics
testch.m Test character generation
testcl.m Test color capabilities
testfi.m Test AG_FILL routine
testhi.m Test AG_HIST routine
testlc.m Test locator
testls.m Test line styles generation
testlw.m Test line width support
testmf.m Test metafile management
testpl.m Test Polar plots
testsy.m Test AG_GPLM routine
testtx.m More tests for text generation
H) Include files
agl.h Include file with function definitions
aglaxes.h Include file for axes generation support
aglbsd.h Unix BSD dependencies
agldcaps.h Drivers capability flags definition
agldcom.h Driver communication structure definition
agldos.h MS-DOS dependencies
aglenvr.h Environment set up
aglerror.h Error codes definitions
aglmacro.h Definiton of macros to be used in the source code
aglosx.h Standard process communication interface definitions
aglparam.h Global parameters definition
aglposix.h Posix dependencies
aglnlin.h Polar plot support definitions
aglproto.h AGL internal function prototypes
aglserv.h Window server driver definitions
aglstat.h AGL status declaration
aglstruc.h Data structures definitions
aglsys.h System dependencies selection file
aglsysv.h Unix System-V dependencies
aglunix.h Generic Unix dependencies
aglvcmd.h Versatec definitions include file
aglvms.h VAX/VMS dependencies
ip.h Ip program definitions
uxcfintf.h Unix fortran interface (C layer definitions)
versatec.h Include file for the Versatec V-80 rasterizer.
I) Library generation and auxiliary procedures
agldos.bat MS-DOS library building procedure
aglvms.com VAX/VMS building procedure
gpxserv.com Command file to create gpxserv.exe
makefile.gen Unix generic makefile (named "makefile" in the kit)
makefile.mid Makefile to be used by Midas installation (named
"makefile" in the midas kit)
makefile.vms Makefile wich builds the VMS installation procedures
vmscmd.com VAX/VMS foreign command definition template procedure
J) Run time support files
agldevs.dat Device description file template
cit101.cap Caps file for Itoh CIT 101 terminal
cit324.cap Caps file for Itoh CIT 324+ terminal
cit324x.cap Caps file for Itoh CIT 324+ terminal (alternate)
hds22.cap Caps file for Human design 2200 terminal
ln03.cap Caps file for LN03 laser printer
ln03x.cap Caps file for LN03 laser printer (Old version)
qms.cap Caps file for the QMS Laser printer
t4010.cap Caps file for Tektronix 4010
t4014.cap Caps file for Tektronix 4014
t4100.cap Caps file for Tektronix 41xx
vt640.cap Caps file for VT640 terminal
greek.nfn Greek font description file
oldengl.nfn Old England font description file
quality.nfn Quality roman font description file
script.nfn Script font description file
tiny.nfn Tiny roman font description file
K) Documentation files
agldriv.doc Guide to writing an AGL 3.x device driver
aglinsta.doc Installation and customization guide
check.doc List of File identification strings
cintf.doc AGL C Language Programming Interface description
devices.doc Devices and driver related documentation
fintf.doc AGL FORTRAN Language Programming Interface description
ip.doc Interactive Plotting Utility Manual
readme.doc This file
