@database FinalCalc.hyper
@font topaz.font 8                                                                                                              

@remark Warning!  Do not edit this file!

@index Main

@$VER: FinalCalc.part9.guide 1.04 (14 February 1996)
@author "Khalid Aldoseri"
@(c) "Copyright © 1995-1996 Khalid Aldoseri"


@node Main "Program Settings..."
@toc "FinalCalc:guide/main.guide/Main"
@{b}@{u}
	Program Settings:
@{uu}@{fg highlight}
	@{" > " link part8.1 } Display Settings
	@{" > " link part8.2 } User Interface Settings
	@{" > " link part8.3 } Program Paths
	@{" > " link part8.4 } User Menus
	@{" > " link part8.5 } The Program Clock
	@{" > " link part8.6 } Saving and Resetting Program Settings
	@{" > " link part8.7 } Program Icon Tool Types
@endnode


@node part8.1 "Display Settings..."
@toc "Main"
@{b}@{u}@{fg highlight}Display Settings:@{ub}@{uu}@{fg text}
The Display Settings define the type of screens FinalCalc opens, the default
font used for the user interface, and the colors used for FinalCalc screen.

@{b}@{u}Program Screen@{ub}@{uu}
The 'Settings - Display - Screen' menu brings up the 'Select Screen Type'
requester which allows you to define the basic screen type that FinalCalc opens
for its user interface on which sheet and graph views are shown.

You can set the screen type to one of the following:

a.	Hires:

	Opens a hi-res screen in the default monitor mode for your system.  This can
	open either an NTSC (640x200 pixels or more) or a PAL (640x256 or more)
	screen.  This is the default mode FinalCalc uses when you run it for the
	first time.

b.	Hires/Lace:

	Opens a hi-res interlaced screen in the default monitor mode for your
	system.  This can open either an NTSC (640x400 pixels or more) or a PAL
	(640x512 or more) screen.

c.	Workbench:

	Shows all FinalCalc sheet and graph views on the Workbench screen.

d.	Custom Screen:

	Brings up the 'Screen Mode Settings' requester, which allows you to define
	any Amiga screen mode to use as the display mode for FinalCalc screens.

	You can define custom screens that are of any depth supported by the machine
	you are running on.  Normally FinalCalc uses 2 bitplanes of depth, which
	gives 4 colors on the display.  This is the best mode for working in as it
	provides a very fast display update.  The only penalty for this is that
	@{"cell colors" link "FinalCalc:guide/part2.guide/part2.5.9"} are not shown since there are only 4 colors available for the
	display.

	If you want to display cell colors, you need to use a screen depth of 3
	bitplanes (8 colors) or bitplanes (16 colors).  This will also allow graph
	views to show more colors.  If you are running on an Amiga with the AGA
	chipset (Amiga 1200 or 4000) using 3 or 4 bitplanes is recommended.  If
	you are using an Amiga with a fast graphics board, you can use up to 8
	bitplanes (256 colors) without a speed penalty, depending on your
	graphics board.  In general, the more bitplanes you have, the better
	color selection graph views have.  If you do not use graph views, then
	any depth more than 4 bitplanes is not useful and simply slows down the
	display.

	You can define screens that are wider or taller than the actual monitor you
	are using.  If you do, FinalCalc will open the screen as usual, and you will
	have to use the mouse pointer to scroll around the screen.  Program
	requesters will always open in the currently visible portion of the screen.

If you change the screen type when you have more than one view open, FinalCalc
will automatically open a second screen and move the current view to it,
leaving the other views in the current screen.  There is no restriction on how
many screens that can be opened in this way.  When you close a project with
multiple views in multiple screens, all the screens are automatically closed if
the last view on the screen is closed.


@{b}@{u}Display Font@{ub}@{uu}
The Display Font is the Amiga system font used for the FinalCalc user
interface.  You can set this to any font (fixed or proportional spacing) of up
to 20 points in size.

To set the display font, use the 'Settings - Display - Font' menu.  It will
bring up the system font requester.  Simply select the font and size you want
to use.

There is a speed penalty when using a proportional font as compared to a fixed
spacing font.

FinalCalc also treats two fonts with special handling.  These are the Topaz 8
and Topaz 11 fonts.  These use special drawing routines that make them render
much faster than other fonts.

You cannot change the display font if FinalCalc has more than one screen open.


@{b}@{u}Display Color Palette@{ub}@{uu}
The 'Settings - Display - Palette' menu brings up the 'Edit Color Palette'
requester.  It allows you to change the colors used for the FinalCalc sheet
and graph view screens.

If the current screen type selected is the Workbench screen, the system
Preferences Palette tool will be launched instead.


@{b}@{u}Preview screen@{ub}@{uu}
The Preview screen is the screen used to show a @{"preview" link "FinalCalc:guide/part6.guide/part6.5"} of a print job.  The
'Settings - Display - Preview' menu allows you to define its screen mode.


@{b}@{u}Graph screen@{ub}@{uu}
The Graph Screen is the screen used to show a @{"graph" link "FinalCalc:guide/part5.guide/part5.1.1"}.  The 'Settings -
Display - Graph' menu allows you to define its screen mode it comes up in.


@{b}@{u}Saving the Display Settings@{ub}@{uu}
To save all the display settings, use the 'Settings - Globals - Save Settings'
menu.  This will save all program settings (including the display settings) so
that FinalCalc will always use them.
@endnode

@node part8.2 "User Interface Settings..."
@toc "Main"
@{b}@{u}@{fg highlight}User Interface Settings:@{ub}@{uu}@{fg text}

The 'Settings - Global - User Interface' menu brings up the 'Edit User
Interface Settings' requester, which controls the following settings:

@{fg highlight}Default Cell Text Color:@{fg text}
The default cell text color defines what color to show the cell text in if
it is set to color 0 (default).  This is normally set to color 1.

@{fg highlight}Background View Color:@{fg text}
This allows you to change the background color in a sheet view.  This
defaults to 0.

@{fg highlight}Auto-Activate string gadgets in requesters:@{fg text}
If you turn this setting on, whenever a requester is opened that has a
string gadget, the first string gadget in that requester is automatically
activated so you can type into it.

@{fg highlight}Highlight ranges with pattern:@{fg text}
By default, this is on, which draws a shading pattern over ranges
highlighted in a sheet view.  If you turn it off, the range will be
highlighted with a simple border only.

@{fg highlight}Show Grid in sheet views:@{fg text}
If you turn this option on, all sheet views will have a grid surrounding
each cell in the display.

@{fg highlight}Always open full-sized views:@{fg text}
This forces FinalCalc to always open a full sized view when loading or
opening a project from disk, disregarding the size of the view saved with
the project.  This helps when using FinalCalc in many different screen sizes
and sharing files.

@{fg highlight}File requester selection:@{fg text}
FinalCalc normally uses its own file requester, which is loaded in as a
system library.  This library is named 'kd_freq.library' and is placed in
the system Libs: directory.

You can, however, force FinalCalc to use the normal system requester (the
ASL requester) by setting the 'Use asl.library File Requester' option on.
This is recommended if you need to save on RAM usage as kd_freq.library
uses approximately 90k of RAM, or if you want to use a requester that
replaces the normal system requester.

@{fg highlight}Inches or Centimeters:@{fg text}
FinalCalc supports either Inches or Centimeters as its measurement system
for printing.  This affects all print requesters as well as default paper
sizes.
@endnode

@node part8.3 "Program Paths..."
@toc "Main"
@{b}@{u}@{fg highlight}Program Paths:@{ub}@{uu}@{fg text}

The @{"Program Paths" link "FinalCalc:guide/part2.guide/part2.9.2"} define where to find different kinds of user files on your
system. 
@endnode

@node part8.4 "User Menus..."
@toc "Main"
@{b}@{u}@{fg highlight}User Menus:@{ub}@{uu}@{fg text}
The User Menus are custom menus you design that are attached to the FinalCalc
program menus, after the last menu.

To define user menus, you must first generate a User Menus File, which is a
standard text file that contains a description of the menus, their shortcuts,
and what each menu does.

The User Menus are menus defined by the user and are attached to the end of the
FinalCalc menus.  They are contained in a text file, normally named
FinalCalc:user.menus.

To use this file, set the User Menus File entry in the Settings Globals Paths
requester to the file that contains the User Menus.


@{b}@{u}@{fg highlight}User Menus Format:@{ub}@{uu}@{fg text}
You can define menus, items and subitems.  Each of those takes a single line
entry that consists of the following details:

Menu ID:
	A 4 digit number.  This must be a unique number that defines the menu.
	It also defines whether it is a menu, item, or subitem.

	Menus always end in 00, items always end in 0, subitems never have
	a 0 as the end number.  e.g.

		1000    menu1
		1010    item1.1
		1020    item1.2
		1021    subitem1.2.1
		1022    subitem1.2.2
		1023    subitem1.2.3
		1030    item1.3
		2000    menu2
		2010    item2.1

Name:
	Name of the menu.  This can be of any length.  If it has spaces
	then you must surround it with single quotes, e.g. 'My menu'.

Amiga Key:
	Optional single letter.  If defined, then an Amiga-hotkey is
	assigned to the menu.

Hotkey:
	The number of the letter to use as the underlined hotkey when using
	keyboard menus.  Defaults to 0.  If you don't want a hotkey, use 255.

Command:
	The command to execute when this menu is selected.  This can be a
	single FinalCalc command, multiple FinalCalc commands (seperated by
	semi-colons), or ARexx scripts.  You must surround the entry with
	single-quotes if it contains spaces.

Comment:
	(Optional)  The help line to show up when using keyboard menus.  It
	must start with a ~ character and can be as long as you like.  No
	quotes are needed to separate it, as anything after the ~ sign on
	the line is considered to be the comment.


Once you have created the user menus file, you have to tell FinalCalc where it
is.  This is done by using the 'Settings - Global - Paths' menu, which calls
the 'Edit Paths for Program Objects' menus.  Simply enter the name of the user
menus file into the 'User Menus File' entry, or click on the [?] gadget and
select the name of the file from the file requester that comes up.

The menus file is read in and the user menus are immediately attached.  You can
change the user menus selection at any time.
@endnode

@node part8.5 "The Program Clock..."
@toc "Main"
@{b}@{u}@{fg highlight}The Program Clock:@{ub}@{uu}@{fg text}

The Program Clock is the current date and time shown on all FinalCalc screens, 
in the @{"Screen Title Bar" link "FinalCalc:guide/part2.guide/part2.3.4"}.  You can edit how the clock looks like.
@endnode

@node part8.6 "Saving and Resetting Program Settings..."
@toc "Main"
@{b}@{u}@{fg highlight}Saving and Resetting Program Settings:@{ub}@{uu}@{fg text}
To save all the program settings, use the 'Settings - Globals - Save Settings'
menu.  This will save all program and display settings so that FinalCalc will
always use them.

You can also reset all settings to the default factory settings by using the
'Settings - Global - Reset Settings'.  This will have no immediate effect on
the currently running FinalCalc program, but all future runs will use the
default settings.
@endnode


@node part8.7 "Program Icon Tool Types..."
@toc "Main"
@{b}@{u}@{fg highlight}Program Icon Tool Types:@{ub}@{uu}@{fg text}

Program Icon Tool Types are entries in the FinalCalc program icon that control
basic operational settings of the program.

To set a tooltype, click on the program's icon from the Workbench screen, then
use the Workbench 'Icons - Information' menu, which brings up the details of
the tooltypes set for the program.  To add a tool type, click on the New button
and enter it in the tool types string gadget.

@{b}@{u}The following are the Tool Types supported by FinalCalc:@{ub}@{uu}
@{fg highlight}
stringfrontpen=number
stringbackpen=number
stringhifrontpen=number
stringhibackpen=number@{fg text}
  These tooltypes set the color of the text (normal and highlighted) in all
  string gadgets in FinalCalc.  They default to the following:

         stringfrontpen=1
         stringbackpen=0
         stringhifrontpen=1
         stringhibackpen=0

@{fg highlight}negativecolor=number@{fg text}
  This defines a color to show all negative valued cells in.  To show them
  in red, use  "negativecolor=2"

@{fg highlight}rangeinfo=no@{fg text}
  If this is defined, the current range's sum and count information is not
  shown at the bottom of sheet views.

@{fg highlight}autopaste=no@{fg text}
  If this is defined, clicking on a cell or range while editing a formula will
  not automatically paste it into the formula being edited.

@{fg highlight}fasttopaz=no@{fg text}
  If you are noting slow display rendering when using the Topaz font, try
  setting this tooltype.  It forces FinalCalc to use the system text rendering
  routines.

@{fg highlight}menuskey=key@{fg text}
  This tooltype allows you to change the trigger key for keyboard menus from
  the default '/' key.  Note that it is best to use a key without any shift
  or alt modifiers.

@{fg highlight}amigaguide=no@{fg text}
  If this is defined, it will disable the help guide system, saving a lot of
  memory while FinalCalc is running.

@{fg highlight}spoolpath=path@{fg text}
  Defines the @{"Spool Path" link "FinalCalc:guide/part6.guide/part6.8"}, which is the directory to store printer spooler and
  preview files in.

@{fg highlight}testprinter=no@{fg text}
  If this is defined, FinalCalc will not test the printer's online status
  before attempting to print.  This should only be used with some PRT: device
  replacements that always show <<Printer Busy>> or <<Printer Offline>>.

@{fg highlight}recalcstack=number@{fg text}
  This defines the basic formula nesting stack size.  It defaults to 32k,
  which is enough for functions nested to a level of 2,730 or more.  However,
  if FinalCalc complains that the Recalc Stack has run out, you can increase
  this by setting this tooltype.  (e.g. "recalcstack=100" will set the stack
  to 100k).
@next "FinalCalc:guide/part9.guide/Main"
@endnode