diff options
Diffstat (limited to 'vendor/x11iraf/README')
| -rw-r--r-- | vendor/x11iraf/README | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/vendor/x11iraf/README b/vendor/x11iraf/README new file mode 100644 index 00000000..c1c32109 --- /dev/null +++ b/vendor/x11iraf/README @@ -0,0 +1,91 @@ +# X11IRAF -- X11/GUI development utilities and applications developed by the +# IRAF Project, National Optical Astronomy Observatories, 1994. +# +# Version 1.2 - Fri Apr 28 14:01:32 MST 2000 +# (Principal authors Doug Tody, Mike Fitzpatrick. Email: iraf@noao.edu) + + README This file + README.install Installation instructions for source or binaries + Imakefile Global x11iraf Imakefile + Revisions Package revisions log + X11IRAF.tmpl Imakefile template for x11iraf + + bin,<arch> The binaries get installed here + lib,<arch> The libraries get installed here + doc Postscript documentation for the programs + include The header files get installed here + app-defaults The applications defaults files get installed here + man The manual pages are installed here + + cdl Source for the Client Display Library (CDL) + obmsh Source for the OBM shell + xgterm Source for xgterm (xterm with OBM graphics) + ximtool Source for ximtool (image display server/browser) + guidemo Some sample GUI applications + xtapemon IRAF tape monitor GUI + vximtool Source for Virtual XImtool dummy display server + + obm Source for the Object Manager (OBM) + xpm OBM-compatible copy of the X pixmap source + xaw3d OBM-compatible copy of the 3D Xaw widget set + util Miscellaneous utility programs + +The Xaw3D and XPM libraries are publically available software packages which +x11iraf only uses, we did did not develop them. Similarly OBM uses Tcl as +well as a collection of Xt-based widgets, including the FWF (Free Widget +Foundation) widgets, which were developed by others. Even if you already +have copies of these libraries on your system you should let x11iraf use the +included versions, as interface evolution will likely render other versions +incompatible with x11iraf (we periodically update our copies and perform the +necessary integration). + +Both XGterm and XImtool rely upon the IRAF Object Manager for the GUI. +The GUIDEMO package illustrates how to use GUIs in IRAF applications. + +XGterm provides a Tek 4012 compatible graphics terminal emulation plus, for +clients in the know, a datastream driven widget server capability using the +Object Manager to provide full access to the underlying toolkit and widget +set. The remote client application downloads a GUI file to the widget +server (xgterm) which executes the GUI. While the GUI is executing it +exchanges messages with the remote client application at runtime via +interprocess communication. In the case of Xgterm, this currently uses +a serial (tty based) protocol. + +XImtool is an image display server. This provides an image display +capability to remote client applications using the standard imtool/iis image +display protocol. The image display server allows a number of image frame +buffers to be created and displayed. The client can read and write data in +these frame buffers. Any frame or combination of frames can be displayed. +Various display options are provided, e.g., zoom and pan, flip about either +axis, frame blink, windowing of the display, and colortable enhancement. + +XTapemon is a conventional Xt/Athena application which allows the status of +an IRAF tape job to be monitored continuously while the tape is being +accessed. + +Manual pages are included for all the above utilities. + + +INSTALLATION + +Before building x11iraf you should check the archives on iraf.noao.edu to +see if there are already pre-built binaries available for your platform. +To build x11iraf type, in the x11iraf root directory, + + % xmkmf + % make World # (or preferably, make World >& spool &) + +This will do a "make World", build everything, and install into the x11iraf +bin and other install directories. To install somewhere else you can manually +move the binaries to /usr/local/bin or wherever you wish to install them. +Alternatively the X11IRAF.tmpl file can be edited to customize the install. +The minimal install requires moving the executables in bin to a public +directory, and installing the app-defaults files "XGterm" and "XTapemon". +ximtool does not require installation of an app-defaults file. See the +manual pages for more detailed configuration instructions. + +To build the GUIDEMO IRAF package type "mkpkg" in the guidemo directory. + +The LIB and INCLUDE directories should be referenced in applications which +use any of the x11iraf libaries (libobm.a, libXaw3d.a, libXpm.a, libcdl.a). + |