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 . - 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