Fass v1.02 © Copyright 1991 Jaba Development Written with DICE C v2.6 by Jan van den Baard Based on commodity code by Stefan Sticht (FISH 497) DISCAIMER --------------------------------------------------------------------------- The author is NOT responsible for the suitability or accuracy of this documentation and/or the program(s) it describes. Any damage directly or indirectly caused by the use or misuse of this documentation and/or the program(s) it describes is the sole responsibility of the user her/him self --------------------------------------------------------------------------- COPYRIGHT --------------------------------------------------------------------------- Fass v1.01, © Copyright 1991 Jaba Development. All rights reserved. This program may be distributed non-commercially only providing that the executable, source code, documentation and copyright notices remain unchanged and are included with the distribution. This program is FREEWARE so no financial donation is necessary ( but welcome ). Send me a postcard of your hometown if you use this program. --------------------------------------------------------------------------- This program is for all of you who has programs that makes use of fonts but don't offer the possibility to change the fonts directory from within the program. Fass is a commodity that offers the possibility to re-assign the fonts directory a the touch of a few keys. It's possible to start Fass from either the Shell or the Workbench. The following arguments are possible: PRIORITY= - With this argument it's possible to set the commodity it's priority in the commodities queue. Default : 0 POPWINDOW= - This enables you to tell wether or not you want Fass to open it's window uppon startup. Default : NO POPKEY= - This enables you to set your own hotkey (See below) to popup Fass it's window Default : lalt f QUIT= - This enables you to set your own hotkey (See below) to quit the commodity. Default : lalt q Here are some examples of how you can start Fass from the Shell: Run Fass POPWINDOW=YES POPKEY="lcommand p" Run Fass QUIT "control q" NOTE: You have to "Run" or "RunBack" Fass when you start it from the Shell. This is because DICE does not have an auto detach "_main.c". (Maybee I'll hack my own some day.....) You must specify the arguments via the tooltypes array of the program it's icon when it's started from the Workbench. When you start Fass from the WBStartup drawer you must specify the DONOTWAIT tooltype. The Fass window: The Fass window always opens on the default public screen. When the window is open you will see five gadgets: Get -> This pops the ASL FileRequester for you to select a new fonts directory. Please enter FONTS: path -> Type the pathname of the new fonts directory in here. NOTE: Fass only checks wether or not it's a directory you have entered here. There is no checking to see if there are really fonts in the directory. Assign -> Click on this gadget when you want to assign the FONTS: directory to you new path. A requester pops up telling you wether or not it succeeded. HIDE -> Click on this gadget to hide the Fass window. QUIT -> Click on this gadget to remove Fass from the system. Input Description Strings (HotKeys): The Input Description String (HotKeys) has the following template: [qualifier] [...] qualifier: lshift left shift key rshift right shift key shift either shift key capslock capslock key caps shift or capslock key control control key lalt left alt key ralt right alt key alt either alt key lcommand left amiga key rcommand right amiga key numericpad key on numericpad rbutton right mouse button midbutton middle mouse button leftbutton left mouse button newprefs change in preferences diskremoved disk ejected diskinserted guess what..... key f1 -> f10 function keys up cursor up key down cursor down key left cursor left key right cursor right key help help key del delete key return return key enter enter key backspace backspace key esc escape key space space key comma comma key upstroke key released a -> z, 0 -> 9 normal ansi keys Choose your keys carefully when other commodities are running. Requirements: Fass needs atleast Kickstart 2.0 V36++ to run. Error return codes. Fass doesn't print information to the screen when something didn't work. You can figure out what went wrong by checking the return code with this list. 20 FASS wasn't able to open the libraries it so desperatly needs. 21 FASS wasn't able to create a message port for the communication. 22 The broker could not be setup. This could mean that another commodity is running which has the same name as FASS. 23 FASS wasn't able to setup it's HotKey filters. This probably means that you have fed FASS wierd HotKey strings. 24 There was an error detected if the commodity objects with CxObjError. 25 Not used! 26 Not used. 27 You passed FASS wierd arguments in the Shell. History: V1.00 (15-Sep-1991) 7436 bytes. - Initial release V1.01 (21-Sep-1991) 6872 bytes. - Fass now uses the Dos routine "ReadArgs()" for parsing the arguments when run from the Shell. - By-Passed the main from c.lib to trim some bytes off the executable. V1.02 (17-Oct-1991) 7312 bytes. - Fass now enables the user to select the new fonts directory with the ASL FileRequester. Bug reports, flames, etc. to me at the following address. Jan van den Baard Bakkerstraat 176 3082 HE, Rotterdam Holland Fido: 2:500/29 (Jan van.den.Baard)