EULER for XWindows/UNIX

This is a short documentation of the XWindows version of EULER. For a reference to the EULER language, look into the EULER documentation (EULER.HTML).

Introduction

EULER for UNIX/XWindows consists (at least) of There are some additional *.E files. The documentation is contained in the *.IPF files, which are translated into HTML documents, when EULER is compiled. There are also notebook files with extension *.EN. You can load these files with the notebook command.

Installation

This documentation concerns the UNIX/XWindows version of EULER. You will have to compile the source using "make".

Implementation hints This version of EULER has been programmed on an IBM-RS6000 machine, with AIX 3.1.5 and XWindows X11 Release 3. To help you solve problems on other machines, follow these instructions. I have tested the program on Linux and Sun.

Memory EULER uses a fixed portion of memory, the size of which must be specified at program start. To do this use the "-s" command line option. The default value is contained in the variable memsize (1 MByte) of "sysdepx.c". Change this according to your needs and resources. Since UNIX uses demand paging, you may choose a high and sufficient value here.

Floating point allignment If your machine requires 8-Byte allignment, you should define SPECIAL_ALIGNMENT. This is necesssary for DEC and Sun architectures.

Floating point errors EULER catches floating point errors, when the makro FPE is defined. However, it is superior to use the IEEE standard floating point extensions INF and NaN. If you have these available, do not define FPE. Most machines do not have hardware infinity and need FPE. You will notice, if you need it, when Euler crashes after the command 1/0.

Fonts EULER uses two fonts, a text and a graphics font. These fonts can be chosen in the command line. The default fonts are set in the makefile by makro definitions. Change this to the needs of your XWindow version.

Timer EULER needs a timer for the wait function. If your machine is an RS6000, you can use its accurate timer function. If not, undefine the makro definition in the makefile. Then EULER will use standard UNIX time functions.

Colors EULER uses colors for graphics. You can set these colors in the command line by name. You can also change the default colors in the file "sysdepx.c".

Directories You should create directories euler/source and euler/progs in your home directory. All *.e files and euler.cfg should be in euler/progs. The source files should be in euler/source. You should make a shell script, which switches to the directory progs and then calls xeuler there.

Special care has to be taken on Sun based machines. First of all, you need an ANSI-C compiler. Most Gnu-C++ ports will suffice, but not all. If you have it, use acc. Then you will need to define the SUN macro in the makefile. This will make your keyboard work correctly.

The command line options accepted by EULER are

-f font
sets the text font
-g font
sets the graphics font
-s Kbytes
sets the available space
-geom geometry
sets the window geometry (e.g., -geom 600x600+0+0)
-d display
sets the display
-## color
sets color ## (0 to 15) to the color name (e.g. -3 green)
-b
uses a black and white color scheme
files
are files to be loaded after EULER.CFG
First edit the makefile according to the hints above. To compile EULER, you type
    make
in the source directory. This will create xeuler in source. You can test it by running xeuler. You may also create a non-graphics version with
    make noxeuler
The command
    make install
then copies xeuler and noxeuler to the progs directory. You should then create a shell script, which starts xeuler, in your $HOME/bin file, or you can start xeuler yourself in the progs directory. There should be a file euler.cfg, which loads the ../progs/util.e.

To create the documentation, start

    make html
This will create several *.html files in the make directory, which you can read with your Web-Browser. If you want a printed documentation, start
    make doc
You can send the files docs/*.doc to your printer.

You should also issue the command

    >load "demo"
to get a good idea, what EULER can do for you.

Contact the Author

For questions, here is the EMail address of the author grothm@am.ku-eichstaett.de rene.grothmann@ku-eichstaett.de and the mail address is
Dr. R. Grothmann
Kath. Univ. Eichstaett
D-85071 Eichstaett
Germany

The UNIX/XWindows Interface

This interface has only a single window, which serves as text and graphics window. You can pop up the graphics in this window with the TAB key.

To print the graphics you may use the standard harcopy commands of XWindows. However, I am using a self made xlaser command, which produces better output an a HP laserjet printer.

There are some command line options available.

-f font
Set the text font. You may use the asterix * as usual for font selection. The font must be fixed width.
-g font
Set the graphics font.
-s KByte
Reserves the given number of KB EULER stack.
-geom geometry
The normal geometry settings for the window.
=geometry
Another form.
-## color
Sets color number ##. Specify the color with its name. Color 0 is the graphic background and one the default line color.
-b
Use a black and white scheme for graphics.
filename
Load this file after the EULER.CFG file.
The keyboard commands are more or less the same as in the OS/2 version. However, you may use Cursor-Up without the Shift key to recall old commands, since this version does not support notebooks.