/********************* ES3: HELP-File english ******************************/
/*****************************************************************************/
/**** Any comment can be rewritten, the whole file can be translated.      ***/
/**** Every comment line must begin with /* and end with */. You must      ***/
/**** not use the words "Seite" and any number at the same time in a       ***/
/**** comment line. Do not change any /*Seite..*/!!!!                          ***/
/*****************************************************************************/


/*Seite 0*/
ESTAFF Version 3.0 (ES3) is a notational proram for one-part melodies.
Translatable Code is ESAC. ES3 has been tested with all common graphic-
cards.

The numbers in the headlines of help texts refer also to the manual.

General remarks: You may switch the menue using either cursor or mouse or
             the first letter of the respective option. Then either hit
             <Enter> or press the elft mouse button. <ESC> or the right
             mouse button leads you one step back. Mostly any wrong de-
             cision can be stopped by hitting <ESC>:


Bon apetito: your ESAC-Team!

/*****************************************************************************/
/*Seite 1*/             ┌──────┐
ES3      - 1  Main menue│ MAIN │ path: ???
                        └──────┘
Notes    - Submenue to write or translate staff, to load melodies, to
           read JIANPU etc. The Submenue EMG, which allows you to design
           your own 40*40Pixel-Graphs is also here!

Disc     - Anything you can do from Disk like loading and saving of screens
           in two different formats.

Sysgraph - Bind your graphics and texts into the numbered staves so that
           they are not lost when scrolling.

Graph.   - Mixed graphic functions, you may also play with them *)

Text     - Write screen texts *)

Print    - Different Options and submenue including "games"

Erase    - Deletes your screen (but asks you first)

Options  - Submenue for important program- or system parameters

Back     - that should not have to be explained!

*) CAUTION: Any graphics and texts of THESE menues will be lost after
            scrolling: Use SYSGRAF!

/******************************************************/
/*Seite 9             */
            ┌───────┐
Submenue  1 │ ERASE │ path: MAIN -> <E>
            └───────┘
You can delete the screen here but PGUP/PGDN regenerates your staff
when it was loaded. (MAIN -> <N> -> <M>)

/******************************************************/
/*Seite 10*/ ┌──────┐
Submenue 1   │ BACK │ path MAIN -> <B> = <ESC>
             └──────┘
Ends the program after having asked you again.

If you cannot make up your mind, you may choose <Eventually>. Then the
program will NOT end in 98,931pct of the cases.

"Sssst: I won't tell anyone you had to press <F1> here!"

/******************************************************/
/*Seite 3*/   ┌─────┐
Submenue- 2   │NOTES│ path: MAIN -> <N>
              └─────┘
Melody   - ESAC-files or single melodys can be chosen here. You can also
           choose several pieces by their respective numbers or by starting
           with a letter plus number. Then up to 30 melodys can be put in
           the queue. Example: A23 chooses every piece from No 23 on.

Next     - translates the next melody in the queue, should there be more
           than one.

JIANPU   - activates another menue to translate the melody into Chinese
           cypher notation (and back).

TeX      - One or more melodies of the queue can be translated into TeX-
           Format. You will be prompted but might have to look up
           <M>AIN -> <O>ptionen -> <T>eX  first!

Window   - Call this to put further staff, pauses etc. into your notation.
           They will, however, not be played.

Staff    - Write (eempty) staff on your screen.

EMG      - calls a submenue to store your own 40*40 Pixel graphs.
           EMG stands for ESTAFF MACRO GRAPHICS.

/*****************************************************************************/
/*Seite 11*/   ┌──────┐
Submenue  2.3  │JIANPU│(only with chopsticks!) path: MAIN -> <N> -> <J>
               └──────┘
Submenue to generate Chinese Cypher-notation

Translate  - writes JIANPU until you end the program beendet or choose
             <E>urope. Any new melody is represented in staff first, until
             you use PGUP/PGDN.

Europe     - deactivates JIANPU, you see then what you mistake for
             "real notation".

SysPerSc.  - choose the number of staves per screen.

Pgup/dn    - choose the number of staves to be scrolled <PGUP> or <PGDN>
             You should better choose a smaller number than in SysPerSc.

If there is anything wrong with JIANPU, then control the parameters of
             SysPerSc. and Pgup/dn!

/*****************************************************************************/
/*Seite 12*/  ┌───┐
Submenue 2.7  │EMG│ path: MAIN -> <N> -> <E>MG
              └───┘
Store and change your own work of arts, i.e. (40*40Pixel-Graphics).
Some functions don't work with CGA-cards, however.

File     - activates a submenue to load an existing file or to write a
           new one. You may store up to 20 graphs in a EMG-file. <F>ile
           must first be activated. The file has to be opened to be used
           in the following functions.
New      - write a new EMG. But unfortunately NOT for CGA.
Change   - change an existing graphic and store it at a new position. The
           original graphic won't be deleted.
           NOT FOR CGA!
All      - displays all graphics of the activated *.EMG at the upper left
           of your screen. Touch any key to "clean" your screen again.
           Use BIND to put them into your staff!
Delete   - one or more graphics of your activated *.EMG-file can be deleted.
           But you can find them again in a *.SIK file, which automatically is
           generated by the system.
           CAUTION: After deleting re-activate the file again!
SystemMG - Use this option if you do not wish to loose your EMG's after
           scrolling. (see MAIN -> <S>YSGRAF)

/*****************************************************************************/
/*Seite 4*/   ┌──────┐
Submenue - 3  │ Disk │ path: MAIN -> <D>
              └──────┘
Load      - loads your -> save(d) screens.

Save      - Stores your screen in your directory. The program atomatically
            writes the extension *.PCT. You have the options to store pages
            or sections; Section saves you disk space and als is compatible
            to other graphic cards, but Page is much faster!

Directory - displays the files of you directory. You may also use the
            common DOS-Wildcards '*' and '?'.

ReadFile  - lists a file at your screen; this is Read Only and you can
            not scroll back!

ShellDOS  - does not yet exist in this version.

/*****************************************************************************/
/*Seite 7*/ ┌────────┐
Submenue 4  │SYSTEMOP│ path: MAIN -> <S>ysgraf -> <S>
            └────────┘
Contains some options to bind graphics, texts, EMG's etc. Those things
are not lost when you scroll up or down.

Graphic    - Submenue to bind your graphics.

EMG       - binds 40*40Pixel EMG's in your staff

Text      - use THIS menue if you wish to store your text for scrolling!

Save      - stores your NOTSYS-art at your directory. The program automa-
            tically adds the extension *.UFR.

Load      - That is the opposite of Save! You'll see your art after
            Pgup ord Pgdn.

/***********************************************************************/
/*Seite 19*/  ┌──────────┐
Submenue 4.1  │ SYSGRAPH │ paths: sveral
              └──────────┘
You are first prompted to enter the staff number, because these graphics
are bound to the staves.

Line           - Surprise: draws a line
Rectangle      - draws a rectangle which also MIGHT be a square
Circle         - reminds you of an egg when your graphic card is bad...
DeleteGraph    - wipes all graphics (including texts and EMGs) from all
                 staves. Single objects cannot be deleted; one should
                 save the screen more often instead:
                 (MAIN -> <D>isk -> <S>ave).

/*****************************************************************************/
/*Seite 5*/ ┌───────┐
Submenue 5  │ GRAPH │ path: MAIN -> <G>
            └───────┘
CAUTION: after scrolling graphics can only be found when they have been
designed with SYSGRAPH.

Line      - draws a line from a to b.

Pixel     - allows you to draw single pixels. This function must be
            closed by <ESC> or right mouse button.

Rectangle - to draw rectangles first place the arrow at the upper left
            then at the lower right corner. You cannot draw from right
            to left!

Fill      - CAUTION: this fills a completely closed pattern with the
            activated color.

Circle    - Depending on the quality of your graphic card you should be
            able to draw either a perfect circle or something like an egg.

Sysgraf   - Binds graphics into the staff for scrolling

Zoom      - enlarges a section for pixel-changes.

/*****************************************************************************/
/*Seite 8*/ ┌──────┐
Submenue 6  │ TEXT │ path: MAIN -> <T>
            └──────┘
CAUTION: If you want to read your texts after scrolling, you should use
Systext (or MAIN -> <S>ysgraph -> <T>ext).

Text       - activates text editor.

Position   - You may wish to choose the cursor's position before you
             write your text(s).

Systext -    binds your texts to the special staff for scrolling.
             (cf. SYSGRAPH)

/*****************************************************************************/
/*Seite 6*/ ┌─────────┐
Submenue 7  │ PRINTER │ path: MAIN -> <P>
            └─────────┘
CAUTION: Before using this thee first time, adjust your printer via
         MAIN -> <O> -> <P> and save via MAIN -> <O> -> <S>ave!

Section    - Choose the section to be printed.

Page       - prints the screen without footline. You can also use
             the <F6>-key.

Melody     - the complete melody will be printed. You see the actual
             staff in the middle of your screen.

AllMel     - see <Melody>, but this prints everything of the queue.

Games      - contains a submenue for reflected face and magnifying
             of screen sections.

PLEASE NOTE: It is useless to print when there is no printer connected.
             The system MAY brake down in this case!

/************************************************************************/
/*Seite 21*/  ┌────────┐
Submenue 7.5  │ Games  │  path: MAIN -> <P> -> <Games>
              └────────┘
This is the most important menue because you can use it to print folios
for your teaskirt (German= tieschört)!

X-Expand     - expands a section on the X-axis (horizontally). If it is too
               large, it's put into the rubbish and cannot be recycled.

Y-Expand     - same as X-Expand but vertical

Reflected_Face  the object will be "mirrored" from the middle over the
               Y-axis.

/*****************************************************************************/
/*Seite 2*/   ┌─────────┐
Submenue - 8  │ OPTIONS │ path: MAIN -> <O>
              └─────────┘
Program -  specific options of program (colors, fonts) etc.
           (see: submenue <S>pecialities

Order    - Submenue for staff-margins, text etc.

Melody   - Transpose into any key or octave, change cleff,
           adjust MIDI-parameters, temperaments etc.

Printer  - Adjust the program for your printer. Supported are five types
           of 9-pin, 24-pin and Laser. - Print melodies into a file,
           change your printer port, change the printed distances between
           the staff.

TeX      - Submenue for MuTeX translations.

SaveOptions save your most important otions for the next sessions.

/*************************************************/
/*Seite 13*/  ┌─────────┐
Submenue 8.1  │ Program │   path: MAIN -> <O> -> <P>
              └─────────┘
Change the following parameters:

Colors    - Note- and background colors. Be careful when your computer
            runs on Hercules (or sometimes CGA).
            Place the arrow at the desired color and press <enter> or
            left mouse button.

Meltext  -  see next paragraph

Programtext - choose three different fonts for your texts.

Specialities - if your computer is SLOW, you can stop scrolling here which
            makes it a little faster. You also find two test scales here
            which was designed by the mathematician and hurts the musician.

/*****************************************************************************/
/*Seite 14*/┌───────┐
Submenue 9  │ ORDER │ path: MAIN -> <O> <O>
            └───────┘
Adjust specific parameters like staff, notes etc.

Margins  - contains two submenues to adjust the respective margin
           in pixel.

Text     - activates three menues that influence your texts

Pgup/dn  - Scroll definite numbers of staff when hitting PGUP/PGDN

SysPerSc - activates a menue to define numbers of staff per screen.
           Users of CGA should not choose more than three.

Scalings - tempo (durations) of notes (the larger the number the FASTER).
           Define number of tones per octave (does not run on MIDI; in
           this case use the <T>unings!).

/*****************************************************************************/
/*Seite 15*/ ┌──────────┐
Submenue 10  │  MELODY  │ path: MAIN -> <O> -> <M>
             └──────────┘
M-Transpo  - Submenue to transpose into any key, change major <-> minor;
             further submenue to switch between treble and bass.
Rhythm     - displays only the rhythm of the melody. You can also hear
             that. To switch back for listening press <F5> and then two
             times <ESC>.
Equallength- replaces one of our STRIP programs: shows each note in the
             shortest duration (see also next paragraph).
NoRep      - Another STRIP function whicht omits identic notes (those
             containing adjacent equal pitch and duration). Useful for
             analytical processes after NoRep.
Oktave     - octave transposition. There is a range of more than seven
             octaves (---1b to +++7#).
Tuning     - Use your own table of frequencies.
MIDI       - Submenue for MIDI options, especially Pitchbend.

/*************************************************/
/*Seite 20*/   ┌───────────┐
Submenue 10.1  │ M-Transpo │  path: MAIN -> <O> -> <N> -> <M> -> <M>
               └───────────┘
C..B    - transposes into one of these keys

Other   - further keys for transpositions

Minor-Major  ES3 reads minor when the code 3b appears. Should this be
             wrong, you can here switch your representation back to
             major.

Change  - phrasewise (linewise) transpositions.

Bass    - Submenue to switch between treble and bass. You can also let
          the program decide.

/*************************************************/
/*Seite 16*/   ┌────────┐
Submenue 10.6  │ Tuning │ path: MAIN -> <O> -> <M> -> <T>
               └────────┘
Table      - loads a predefined table. <ENTER> for list of those tables.

Algorithm  - Deactivates the tables (equal temperament again).

To use this on your Synthi you must first go to MAIN -> <O> -> <M> -> <B>
and choose your 'Bender-Range'! Here is a predefined table in Cent:

ESTAFF-Frequenztabelle: DUR-CENT
(C)opyright 1991 by Ulrich Franzke
CENT
C
523
1       0
1#      100
2       200
5b      600
3b      300
3       400
6       900
4       500
4#      600
5       700
6b      800

/*************************************************/
/* Seite 17*/  ┌────┐
Submenue 10.7  │MIDI│ path: MAIN -> <O> -> <M> -> <M>
               └────┘
Ch1-Ch4  - Choose a MIDI-channel to listen. You may switch more than
           one at a time (there are 4).

Pitch    - switches the pitch-function of your synthi. That has to be
           when you wish to listen to "tables" (MAIN -> <O> -> <T> ->
           -> <T>able).

Bender   - adjust thee Bender of your synthi to the program. The value
           shows the number of subdevisions of a semitone which your
           special synthi can perform up and down. In most cases this
           seems to be 4.

/*****************************************************************************/
/*Seite 18*/ ┌──────────┐
Submenue 11  │  PRINTER │ path: MAIN -> <O> -> <D>
             └──────────┘
Submenue to adjust your printer

9-Pin     - defines EPSON and STAR. You may then choose between draft and
            ELQ.
24-Pin    - Defines EPSON (=STAR) and NEC. A miniature printing option
            works on both.
Laser     - Any HP-LJ II compatible Laser. You may choose three different
            sices from  75 to 300 Dot per Inch.
            75 being the largest, 300 the smallest resulution.
Marginlaser  ONLY FOR LASER! You may have a good dot matrix and change
             that by hand.
File      - choose and press <F1>!
StaveDist - three different distances between your printed(!) staff can
            be defined here.

We have worked on this drivers since ESTAFF2, but they might not be
satisfying enough. If you have a better idea, please let us know!
We still consider printer manuals designed for masochists.
/************************************************************************/
/*Seite 22*/   ┌─────────────┐
Submenue 11.5  │PRINTER_Menue│ path: MAIN -> <O> -> <P> <P>
               └─────────────┘
Printer  -  The file is send to a printer. Choose this only when you had
            switched to <File> before.

File     -  will be "printed" into a file. You later can really print that
            by "TYPE <Filename> > PRN" at DOS-level.

Ports    -  Define three differen ports LPT1 to LPT3. When you end ES3,
            the port automatically is LPT1 again.

/*****************************************************************************/
/*Seite 30*/
There is no help for this. Most probably you find informations at one of
the following: Use the handbook, write to the authors ot this program...

/* End of Help screens */
