
                           Instructions for

                             GEM-FontView
                                1.09e
                              13.02.1996

                                  by
                            Reinhard Bartel
                             Bachgasse 3
                         D-67071 Ludwigshafen
                               Germany
                    MausNet: Reinard Bartel @ LU

                Original English translation by Peter West
                          Edited by Joe Connor


                               Contents


 1 What can GEM-FontView do?
 2 Hardware and software requirements
 3 Using GEM-FontView
   3.1 The menu bar
       3.1.1 The 'GEM-FontView' menu
       3.1.2 The 'Options' menu
       3.1.3 The 'Window' menu

   3.2 Keyboard operation

   3.3 The GEM-FontView windows
       3.3.1 ASCII window
       3.3.2 Vector font window
       3.3.3 Keyboard overview window

   3.4 Font selection

Appendices

 A Status and distribution
   A.1 Shareware restrictions
 B Disclaimer of liability
 C Address of author
 D Support
 E xFSL font selectors
 F History


What can GEM-FontView do?
-------------------------
GEM-FontView is a GEM program with which enables you to:

    Display all characters of an installed GDOS font (bitmap or vector
     fonts) with its ASCII coding.
    Display all characters of an installed vector font in its original
     coding (as a rule vector fonts contain more than 256 characters).
     One can select any desired size for display.
    Display a keyboard overview showing the assignment of various
     characters in a font to the keys.
    Enlarge individual characters (to 72 points if the GDOS allows
     this), in order to take a clearer look at them; the number of the
     character in the font is also shown.
    Select fonts in other programs, if these understand the
     FONT_CHANGED message.

That's all that GEM-FontView can do, but it's enough, isn't it?


Hardware and software requirements
----------------------------------
GEM-FontView should run without restrictions on all Atari computers,
Apple Macintosh running Magic Mac, and other computers runnning the
Atari operating system or equivalent (TOS, MagiC, MultiTOS etc).

In addition, a copy of GDOS with some fonts should be installed,
otherwise only the system font can be displayed.

By renaming the extension to ACC GEM-FontView runs as a desk accessory.
GEM-FontView can be loaded at any time using the 'Chameleon' desktop
accessory loader, or placed in the root directory, where it will be
loaded into memory at boot time.

GEM-FontView was developed and tested on a TT and under MagiC 3/4 with
NVDI 3.02, 4.11/SpeedoGDOS 4.11, 4.2 and 5.0c. HuGo 1.02 and Calvino
v1.00 were tested as xFSL font selectors (Revision 4).


Using GEM-FontView
------------------
 3.1 The menu bar
     3.1.1 The 'GEM-FontView' menu
     3.1.2 The 'Options' menu
     3.1.3 The 'Window' menu

 3.2 Keyboard operation

 3.3 The GEM-FontView windows
     3.3.1 ASCII window
     3.3.2 Vector font window
     3.3.3 Keyboard overview window

 3.4 Font selection


The menu bar
------------
After starting GEM-FontView the following menu bar appears,in which
one can select all the program's functions:

                  GEM-FontView   Options   Windows

For more about the use and capabilities of GEM-FontView refer to:
"What can GEM-FontView do?" and "History".


The 'GEM-FontView' menu
-----------------------
This menu offers the following option, and the selection of any
installed desk accessories:

 About GEM-FontView...
    Here you will get general information about GEM-FontView such as
    version number, creation date, address of the author as well as
    shareware information.


The 'Options' menu
------------------
This menu offers the following choices:

 Select font...
    Here you can select the font that you want to display
       ASCII font overview
       Vector font overview
       Keyboard overview

    The selection applies to the currently topped window. If an
    external xFSL font selector is present (and recognised by GEM-
    FontView), then this will appear to allow a font to be selected;
    otherwise the internal font selector of GEM-FontView can be
    used for this.

 Registration...
    Here your copy of the program can be registered in your name (see
    also below under 'Status and distribution'). Selecting this entry
    brings up a dialog into which you input your first name and
    surname, and the registrationkey (that you will have received after
    payment of the shareware fee). If your registration has been
    successful then the data will be written into the program and from
    then on you can use GEM-FontView without restrictions.
    Warning:
    This version may then NOT be distributed! If you want to pass on
    the program to others, make a back-up copy beforehand!
    If you want to pack your program with PFXPAK, Ice etc, you must
    do this AFTER registration because the program cannot write the
    registration details to a packed file.

 Quit program
    Select this option to leave GEM-FontView.


The 'Window' menu
-----------------
This menu offers the following choices:

 ASCII font...
    Here you can open the ASCII window in which the currently selected
    font is displayed as an ASCII font.
 Vector font...
    Here you can open the vector font window in which the currently
    selected font (as long as it is a vector font) is displayed in its
    original coding.
 Keyboard overview...
    Here you can open the keyboard overview window which will display
    a map of the keyboard and the characters (in the selected font
    and size) that will be output when you press the associated key.
    Notes:
       Do not select font sizes greater than 14 points for this, or
        portions of characters may be cut off.
       Both unshifted and shifted characters are shown for each key.
        Characters that may be obtained when a normal key is pressed
        together with the [Control] or [Alternate] key are NOT
        included.
       The keyboard has been mapped to the UK layout. Users in other
        countries can adapt the display by editing the appropriate
        part of GEM-FontView resource file with a disk monitor (after
        removing the 'Read only' flag of the file, if set). Note the
        layout appears twice: Once for the key representations and
        again for the characters to be displayed (search for '1 !' -
        without the quotation marks! - which is the start of the
        table in each case with the UK layout, as well as most
        others).
        BE VERY CAREFUL AND MAKE A SAFETY BACK-UP COPY FIRST!
        Neither the author or any agent he appoints accept any
        responsibility if you ruin GEM-FontView while messing around
        with a disk monitor - they are dangerous tools!!!
 Close
    This closes GEM-FontView's top window.
 Cycle
    This cycles through GEM-FontView's windows in turn.

Clicking on a character in the ASCII or vector font window will
display the character enlarged to 72 points (as long as the installed
GDOS allows this) together with the character's number.


Keyboard operation
------------------
GEM-FontView can be controlled completely from the keyboard. One can
recognise the keyboard combinations that operate the various functions
from the shortcuts that follow the menu entries. The non-character keys
are represented by:

     = [Alternate] key
    ^ = [Control] key
     = [Shift] key

Thus the following mean:

    Y = [Alternate]+[Y]
    ^Y = [Control]+[Y]
    Y = [Shift]+[Y]


The GEM-FontView windows
------------------------
GEM-FontView outputs 'cleanly' in quite normal GEM windows, which are
familiar from the desktop or other programs. To indentify it's a
window belonging to GEM-FontView, ' [GFV] ' for GEM-FontView will
always be included at the left of the window's title line.


ASCII window
------------
The ASCII window displays the selected font in Atari ASCII coding
(256 characters).

The window title bar displays: [GFV] Font-name (ASCII)

 GFV lets you know the window belongs to GEM-FontView
 Font-name is the name of the currently displayed font
 (ASCII) shows the font is displayed in ASCII code mode.

The Info line of the window contains the following information:
    Information (if available at the time) about the character over
     which the mouse cursor (shown here as a pointing hand) is
     currently positioned, namely:
      - The ASCII character itself in the Atari system-font (e.g.: A)
      - The ASCII value as hexadecimal number (e.g.: 0x41)
      - The ASCII value as decimal number (e.g.: 65).
    The font size in points in which the font is being displayed.
    Whether the font is a proportional ('Prop.') or non-proportional
     equi-spaced ('Equisp.') type.
    Whether the font is a bitmap or vector font.

Examples:

  1. A 0x41 65 | 10 point | Equisp. bitmap font
  2. B 0x42 66 | 36 point | Prop. vector font

Clicking on a character in the table (keep the mouse button pressed)
will display it in 72 point size - as long as this can be set with
the GDOS in use - together with its number.


Vector font window
------------------
The vector font window will display the selected vector font in its
original coding.

The window title bar displays: [GFV] Font-name (Original)

 GFV lets you know the window belongs to GEM-FontView
 Font-name is the name of the currently displayed font
 (Original) shows that the font is being displayed in the original
    coding, i.e. all characters in the order in which they are present
    in the font.

The Info line of the window contains the following information:
    The number (if available at the time) of the character over
     which the mouse cursor (shown here as a pointing hand) is
     currently positioned, namely:
      - as decimal number (e.g.: 65).
      - as hexadecimal number (e.g.: 0x0041)
    The font size in points in which the font is being displayed.
    Whether the font is a proportional ('Prop.') or non-proportional
     equi-spaced ('Equisp.') type.

Examples:
  1. 65 0x0041 | 10 point | Equisp. Vector font
  2. 66 0x0042 | 20 point | Prop. Vector font

Clicking on a character in the table (keep the mouse button pressed)
will display it in 72 point size, together with its number.

Pressing the [Control]+[+] or [Control]+[-] keys increases or
decreases the displayed font size by one point respectively.


Keyboard overview window
------------------------
The keyboard overview window will display a representation of the
keyboard layout together with the assignment of the selected font to
the keys, i.e. the characters produced by pressing each key both on
its own and together with the [Shift] key.

The Info line of the window contains the following information:
    The name of the font being displayed.
    The point size in which the font is being displayed.
    Whether the font is a proportional ('Prop.') or non-proportional
     equi-spaced ('Equisp.') type.
    Whether the font is a bitmap or vector font.

Examples:
  1. 6x6 system font in 10 point, Equisp. bitmap font
  2. Aldine 721 Bold BT in 20 point, Prop. vector font


Font selection
--------------
Installed GDOS fonts can be selected using the font selector. If an
external xSFL font selector (for example HuGo, Calvino, FontSel etc) is
not installed on the system, GEM-FontView will use its own internal
selector.
Its font-name window displays all installed fonts. You can select a new
font by simply clicking on its name; the scroll bar and its arrows can
be used to show parts of the list currently outside the
window in the normal GEM manner. Vector fonts are identified by a large
dot before their name.

The Point window shows all the point sizes that are available for this
font. To select a different size, just click on it (again, long lists
can be scrolled through), or input the size you want from the keyboard
(after pressing [Esc] to clear the line) and click on the entry; such
keyboard entries are only possible for vector fonts, since these are
freely scalable. The selected font is displayed using the text:

 The quick brown fox jumps over the lazy dog

The point size is indicated below the two Font-name and Point windows.

The scroll bar next to the text window can be used to change the
colour of the font (naturally, only if you are working in a colour
resolution).

A pre-requisite for selecting a font different from the system font is,
of course, that other GEM fonts are available, i.e. that a GDOS is
installed and the fonts are included correctly in the ASSIGN.SYS file.
Refer to the documentation for your GDOS version for more details.


Status and distribution
-----------------------
GEM-FontView is Shareware and may be freely distributed in
non-commercial channels so long as the software and documentation
remain together, complete with all its files and documentation.
GEM-FontView may NOT be included as part of CD-ROM collections or
distributed by magazines except by prior agreement. If after using
GEM-FontView for three weeks you cannot bring yourself to delete your
copy then you must register -otherwise you will be working with a
pirate copy! You can register directly with me or via the InterActive
support scheme run by Joe Connor, please refer to SUPPORT.TXT included
with this distribution for more details.

Registration:
-------------
It is important your name and address is included somewhere!!! In
return you will receive a key code that has been generated using your
name. You should input this in the dialog that appears when you click
on Registration. Following a successful registration, the Shareware
restrictions disappear, allowing you to make full use of GEM-FontView.
Distribution of the registered version is NOT permitted!

Copyright (c) 1994-96 by Reinhard Bartel. All rights reserved.


Shareware restrictions
----------------------
A shareware reminder dialog is displayed on starting and exiting
GEM-FontView and periodically during the program.


Disclaimer of liability
-----------------------
Neither I or any agent I may appoint accept any liability or 
responsibility for any direct or indirect damage that may arise, either 
financial, material or any other kind from either the use or misuse of 
this software and associated documentation. All trademarks used are 
recognised and acknowledged.


Address of author
-----------------
Address:

    Reinhard Bartel
    Bachgasse 3
    67071 Ludwigshafen
    Germany

Bank account:

    VR Bank Ludwigshafen
    BLZ (Sort code): 545 603 20
    A/c No.: 107 816

Email:

    reinhard_bartel@lu.maus.de (Use-/Internet)
    Reinhard Bartel @ LU (Mausnet)


Support
-------
For the convenience of British and other non-German users, support for
GEM-FontView is available via InterActive contact:

    Joe Connor
    65 Mill Road
    Colchester
    Essex
    CO4 5LJ
    England

Email: jconnor@cix.compulink.co.uk

Please refer to SUPPORT.TXT included with this distribution for more
details.


xFSL font selectors
-------------------
At present the following xFSL font selectors exist that support xFSL in
Revision 4 - which GEM-FontView uses:

 HuGo! by Stefan Rogel
 Calvino by Dirk Haun
 FontSel >=v1.07 by Holger Weets/Christoph Zwerschke


History
-------
    13.02.1996 - New Version: 1.09
      - Shareware restrictions changed.
      - English version supported via the InterActive support scheme
        run by Joe Connor.
      - English documentation edited by Joe Connor

    22.01.1996 - New Version: 1.08
      - Bugfix: Now one can really display 65536 characters in the
        vector font window (not just 65520)!
      - program source code prepared for easy to create versions in
        different languages.
      - GEM-FontView is now looking for a file GEMFVIEW.KEY which
        should include the registration datas. If this file exists
        the data will be set as preset in the registration dialog, so
        all that is to do for registration is to confirm the data
        with the OK Button.
      - English version created. Original translation by Peter West.

    23.08.1995 - New Version: 1.07
      - Bitstream window re-named to Vector font window, since this
        is a more accurate description.
      - Now one can display 65536 characters in the vector font
        window (previously only 591!) With this one should be able to
        display every character in a font.
      - When the mouse cursor is moved into an active ASCII or vector
        font window, then it turns into a pointing hand.
      - When the mouse cursor is within an active ASCII or vector
        font window then the character over which it is currently
        placed will be inverted, and the descriptive values will be
        output in the Info line in real time.
      - If no vector font is displayed in the vector font window, a
        mouse click in the window no longer produces an enlarged
        character that isn't present.
      - Window title altered: Now we have the font name and then
        (ASCII) if the characters are displayed in ASCII code
        (Original) if the characters are displayed unmapped.
      - The vector font window Info line now shows the current
        character's decimal value and Hex value.
      - The ASCII window Info line now shows the current character as
        an ASCII character in the system font, and its Hex value and
        ASCII (decimal) code.
      - The help text is now called via the *.REF file.
      - Flags now set correctly for 3D dialogs in RSC. (RSC is included
        in the program)

    22.06.1995 - New Version: 1.06
      - There is now a hypertext for ST-Guide ;-). This is called by
        pressing the [Help] key, or clicking on a [Help] dialog
        button.
      - Menu bar altered.
      - Keyboard overview now in a normal window.
      - Control-W cycles windows.
      - Control-U closes windows.
      - The internal font selector can now send FONT_CHANGED messag-
        es. Simply click on the text sample with the mouse and drag
        it to an open window! If you press the [Shift] key at the
        same time then the call will be valid for all windows of the
        application to which the window belongs.
      - Key registration and Shareware restrictions incorporated.
      - xFSL-call adapted to Revision 4. xFSL font selectors that do
        not support this xFSL revision will no longer be used; the
        internal font selector appears instead.
      - Various minor optimisations and improvements.

    31.05.1995 - New Version: 1.05 (not released!!!)
      - FONT_CHANGED message will be received and evaluated.
      - With SpeedoGDOS versions < 5.0 the vector font selection is
        blocked! -> Otherwise it bombs!
      - Now runs as an ACC with menu bar in window!
      - BugFix: When the font displayed did not fit inside a window,
        the last line and last column were not displayed when
        scrolling!!! Did nobody notice that till now?!?

    12.05.1995 - New Version: 1.04
      - Dialogs in 3D-look in 16 colour displays and up if the system
        evaluates the extended object flags (MagiC 3, MagicMac,
        MultiTOS).
      - Iconification of windows incorporated (MagiC 3, MagicMac,
        MultiTOS from V1.07).
      - xFSL system font selector will be recognised and used.

    08.02.1995 - New Version: 1.03
      - Fonts are now displayed in regular GEM windows -> Fonts can be
        displayed at any desired size.
      - All characters of a Speedo-/TrueType/Type1-font can now be
        shown complete in the original coding in their own font
        window, so that one can see what is lost through mapping the
        characters to the ASCII character-set ;-)

    20.01.1995 - New Version: 1.02
      - If XUFSL is present, it will be used instead of the internal
        font selector.
      - Clicking on characters in the font display will show each
        enlarged (in 72 point) with their ASCII code.

    14.11.1994 - New Version: 1.01
      - Dialogs corrected so that they are now visible complete also
        on an SM124 monitor ;-)
      - Selected font size will now be used for output if it is
        larger than the system font size.
      - Selected font colour will now be used as long as it is not
        <white>.
      - Menu should now be disabled correctly so that no mouse
        droppings arise when the mouse cursor is moved into the
        menu bar.

    31.10.1994 - First published version 1.00


