Home » Archimedes archive » Micro User » MU 1991-09.adf » PD-Stuff » FracTrace/!FracTrace/!Help

FracTrace/!FracTrace/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Micro User » MU 1991-09.adf » PD-Stuff
Filename: FracTrace/!FracTrace/!Help
Read OK:
File size: 2846 bytes
Load address: 0000
Exec address: 0000
File contents
Document with FracTrace.
------------------------

FracTrace is a Public Domain program. It may be copied and shared freely, as
long as the files that go with the program are not modified. The program may
not be sold or made commercial profit of in any way, with the exception of
Archive's 'CareWare'!
The images created with FracTrace may be used in whatever way though!


What is FracTrace?

FracTrace is yet another program to display fractal sets (Mandelbrot and 
Julia of z=z^2+c, currently). It does this by means of simple raytracing;
raycasting would be a better term though! The fractal set is rendered as a
continuous height field (a 'surface', in normal English) which is lit by a 
light-source with parallel beams.
For each point on the height field the program calculates the intensity, 
depending on the angle of the incident light-ray with the surface normal in
that point. An option in the program allows for additional shadow 
calculations as well!
The program is fully RISC OS compatible and will perform most of its 
processes in the background.


The logic of FracTrace:

The different parameters needed to specify the surface's characteristics
are set using a script language: "FTS" (which stands for FracTrace Script).
The commands of this script can be used to exactly define what the program
should output.
The program also allows the user to calculate a potential map (a 2D-array
which holds the potential for each point on the surface), which can be
used, saved and reloaded, when rendering the 3D-image of the surface.
Using this map will speed up the program by a certain factor. It is more
memory-consuming though!
When the rendering process is finished, the image can be saved as a 
standard mode 12 sprite.


How to use FracTrace?

FracTrace (version 2.00 and above) runs completely from the RISC OS desktop.
Double-clicking on its icon in a filer-window starts the program... After a
succesful load, the program installs itself on the iconbar.

Clicking with Select (left-button) on the icon causes the 'report window' to
be opened: via this window, the program informs the user on what it's doing!

Clicking with Adjust (right-button) on the icon causes the 'view window' to
be opened: this window shows the image that is rendered.

Clicking with Menu (middle-button) on the icon brings up the icon menu, which
allows the user to see the program info ('About this program'...) and to quit
the program when you wish to do so!

Clicking Menu over one of the windows ('report','view' and 'panel') provided
by FracTrace brings up the 'Main FracTrace Menu': this menu gives you the 
actual control over the program, its items are described below...

Title      : Choosing this item allows you to enter a title-name for the 
             current image and its control parameters. Don't use more than
             8 characters!

Misc       : The miscellaneous submenu. From this submenu you can toggle the 
             'auto-parse' option (see below), toggle 'multitask' mode,
             open the RISC OS directory filer of your saving directory, abort
             the current process, or resume it.
             Setting the 'auto-parse' option will cause FTS files to be
             parsed immediately when they're dragged into the program.
             When 'multitask' mode is deselected, processes such as 
             calculating a potential map and raytracing take over the whole
             machine, ie. they don't multitask but they're faster!
             The 'open filer' option opens the filer of the directory in
             which FracTrace stores its output files. Normally, when you 
             want to save a file (Map, Image, or Script), you can drag the
             icon in a filer, which is the 'Acorn proposed' way of saving 
             files. However, when the program is rendering multiple images,
             then called 'frames' (for animation sequences), each 'frame'
             must be saved when rendering is finished, without the 
             intervention of the user. This is done in a directory that is 
             specified beforehand.
             The options 'abort' and 'resume' are for aborting and resuming a
             process respectively.   

Save       : From this submenu you can save your files:
             Map ... Saves the current map.
             Image ... Saves last rendered image.
             Script ... Saves a script file containing FTS commands for the
                      current parameter-settings.
             Saving is done in the conventional way, ie. by dragging the icon
             in a filer window.   
             Savepath ... Set the saving-directory for frames (see above).
                          This is also done by dragging the icon in a filer.

Process    : From this submenu you start one of the processes, being:
             Parse: Starts parsing (ie. interpreting) the last loaded FTS
                    file.
             Raytrace: Starts rendering the surface using the parameters set
                       in the last parsed FTS file.
             Calculate: Starts calculating the potential map for a surface
                        using the parameters of the last parsed FTS file.
             Any of these processes can be aborted at any time by either:
              - clicking on 'abort' in the 'report' window or icon menu. 
              - clicking any mouse button when in non-'multitask' mode.
             Note that only one of these processes can be active at a time.

Show       : With this submenu you can open the windows of FracTrace.
             The 'view' window shows the image of the current surface. When
             the program is rendering a surface, the contents of this window
             are only updated between each row of points being rendered.
             Clicking with select in this window causes an immediate update.
             The 'panel' window shows the parameters and their current
             values. The values may be changed at any time by clicking on 
             the value's icon and entering a new value from the keyboard.
             When you wish to update the parameters with the new values,
             click on the 'OK' icon in the right-hand bottom corner of this
             window, otherwise click on the 'Cancel' icon to preserve the
             parameters' values. Note that clicking on the window's back-
             ground has the same effect as clicking on 'OK'!
             The 'report' window is used by the program to inform the user of
             what it's doing. This window is constantly updated, except when
             no process is active, or when a process is running with
             'multitask' mode switched off.

Map        : From this submenu you can claim space for a map, with the 
             'claim map' option, you can free the space for this map, with
             the 'free map' option, and you can select to use the map when
             rendering a surface with the 'use map' option.
             The 'claim map' option tries to allocate enough space from the
             free pool to hold the data of a potential map. The size of this
             amount of space depends on the resolution of the surface you
             want to render (which is also the resolution of the map).
             When there isn't enough space left, the program will report an
             error and will show the amount of free space (in Kb) required.
             The user can then try to free some memory elsewhere using the
             Task Manager!
             The 'free map' option just frees the space allocated by 'claim
             map', returning the memory to the WIMP's free pool.
             The 'use map' option must be toggled on if you want the program
             to use the map when it is rendering an image.
             Note that when no map is claimed, all the submenu-options 
             concerning the map are 'shaded', ie. they can't be selected,
             because at that point, they simply are of no use! These are:
             'save map', 'calculate', 'free map' and 'use map'. You will also
             get an error when you want to load a map file and you haven't
             claimed map space.


It is possible to abort a process, quit FracTrace, and resume the same 
process at a later date. This is done by writing down the line-number at 
which you abort the process, and entering this line-number in the 'resume'
option-icon in the Control Panel with your next FracTrace session. When you
set this option and subsequently start the raytracing process, it will resume
at the line-number you entered in the icon!

If you are rendering multiple frames and want a new potential map to be 
recalculated for each different frame, you can do so by setting the
'recalculate' option in the Control Panel!

These explanations may seem 'cryptic' (and so they are!), but the best way
of getting to know FracTrace is by experimenting with the demo-files,
and trying to make some variations.


How to use FTS?
---------------
An FTS file is just a text (ASCII) file as can be made with !Edit.
When you drag an FTS file over one of the FracTrace windows it will be
loaded (provided it isn't longer than 4000 bytes), and -with the default
configuration settings- will be parsed automatically. When the 'auto-parse'
option is switched off, parsing can explicitly be started by selecting 
'parse' from the process submenu.
An explanation of each of the commands provided by FTS is given in the
file 'FTS-Def'.


Comments of the author:
-----------------------
This version of FracTrace certainly isn't the last to be released. As I (or
you) encounter bugs or 'ill behaviour' in the program, I will try to fix 
them in future versions and provide you with the updated releases!
If you find any bugs, have any comments or ideas you'd like to see 
implemented, write to the address below...

Address :          Carl Declerck
                   Vrijgeweidestraat 24
                   B-2800 Mechelen
                   Belgium
Phone   :          015-41.96.49

I can also be reached at Archive BBS as: Carl Declerck (#1071).
If you mail any comments, please allow about one week for a reply!


                                                              Carl Declerck.
00000000  44 6f 63 75 6d 65 6e 74  20 77 69 74 68 20 46 72  |Document with Fr|
00000010  61 63 54 72 61 63 65 2e  0a 2d 2d 2d 2d 2d 2d 2d  |acTrace..-------|
00000020  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00000030  2d 0a 0a 46 72 61 63 54  72 61 63 65 20 69 73 20  |-..FracTrace is |
00000040  61 20 50 75 62 6c 69 63  20 44 6f 6d 61 69 6e 20  |a Public Domain |
00000050  70 72 6f 67 72 61 6d 2e  20 49 74 20 6d 61 79 20  |program. It may |
00000060  62 65 20 63 6f 70 69 65  64 20 61 6e 64 20 73 68  |be copied and sh|
00000070  61 72 65 64 20 66 72 65  65 6c 79 2c 20 61 73 0a  |ared freely, as.|
00000080  6c 6f 6e 67 20 61 73 20  74 68 65 20 66 69 6c 65  |long as the file|
00000090  73 20 74 68 61 74 20 67  6f 20 77 69 74 68 20 74  |s that go with t|
000000a0  68 65 20 70 72 6f 67 72  61 6d 20 61 72 65 20 6e  |he program are n|
000000b0  6f 74 20 6d 6f 64 69 66  69 65 64 2e 20 54 68 65  |ot modified. The|
000000c0  20 70 72 6f 67 72 61 6d  20 6d 61 79 0a 6e 6f 74  | program may.not|
000000d0  20 62 65 20 73 6f 6c 64  20 6f 72 20 6d 61 64 65  | be sold or made|
000000e0  20 63 6f 6d 6d 65 72 63  69 61 6c 20 70 72 6f 66  | commercial prof|
000000f0  69 74 20 6f 66 20 69 6e  20 61 6e 79 20 77 61 79  |it of in any way|
00000100  2c 20 77 69 74 68 20 74  68 65 20 65 78 63 65 70  |, with the excep|
00000110  74 69 6f 6e 20 6f 66 0a  41 72 63 68 69 76 65 27  |tion of.Archive'|
00000120  73 20 27 43 61 72 65 57  61 72 65 27 21 0a 54 68  |s 'CareWare'!.Th|
00000130  65 20 69 6d 61 67 65 73  20 63 72 65 61 74 65 64  |e images created|
00000140  20 77 69 74 68 20 46 72  61 63 54 72 61 63 65 20  | with FracTrace |
00000150  6d 61 79 20 62 65 20 75  73 65 64 20 69 6e 20 77  |may be used in w|
00000160  68 61 74 65 76 65 72 20  77 61 79 20 74 68 6f 75  |hatever way thou|
00000170  67 68 21 0a 0a 0a 57 68  61 74 20 69 73 20 46 72  |gh!...What is Fr|
00000180  61 63 54 72 61 63 65 3f  0a 0a 46 72 61 63 54 72  |acTrace?..FracTr|
00000190  61 63 65 20 69 73 20 79  65 74 20 61 6e 6f 74 68  |ace is yet anoth|
000001a0  65 72 20 70 72 6f 67 72  61 6d 20 74 6f 20 64 69  |er program to di|
000001b0  73 70 6c 61 79 20 66 72  61 63 74 61 6c 20 73 65  |splay fractal se|
000001c0  74 73 20 28 4d 61 6e 64  65 6c 62 72 6f 74 20 61  |ts (Mandelbrot a|
000001d0  6e 64 20 0a 4a 75 6c 69  61 20 6f 66 20 7a 3d 7a  |nd .Julia of z=z|
000001e0  5e 32 2b 63 2c 20 63 75  72 72 65 6e 74 6c 79 29  |^2+c, currently)|
000001f0  2e 20 49 74 20 64 6f 65  73 20 74 68 69 73 20 62  |. It does this b|
00000200  79 20 6d 65 61 6e 73 20  6f 66 20 73 69 6d 70 6c  |y means of simpl|
00000210  65 20 72 61 79 74 72 61  63 69 6e 67 3b 0a 72 61  |e raytracing;.ra|
00000220  79 63 61 73 74 69 6e 67  20 77 6f 75 6c 64 20 62  |ycasting would b|
00000230  65 20 61 20 62 65 74 74  65 72 20 74 65 72 6d 20  |e a better term |
00000240  74 68 6f 75 67 68 21 20  54 68 65 20 66 72 61 63  |though! The frac|
00000250  74 61 6c 20 73 65 74 20  69 73 20 72 65 6e 64 65  |tal set is rende|
00000260  72 65 64 20 61 73 20 61  0a 63 6f 6e 74 69 6e 75  |red as a.continu|
00000270  6f 75 73 20 68 65 69 67  68 74 20 66 69 65 6c 64  |ous height field|
00000280  20 28 61 20 27 73 75 72  66 61 63 65 27 2c 20 69  | (a 'surface', i|
00000290  6e 20 6e 6f 72 6d 61 6c  20 45 6e 67 6c 69 73 68  |n normal English|
000002a0  29 20 77 68 69 63 68 20  69 73 20 6c 69 74 20 62  |) which is lit b|
000002b0  79 20 61 20 0a 6c 69 67  68 74 2d 73 6f 75 72 63  |y a .light-sourc|
000002c0  65 20 77 69 74 68 20 70  61 72 61 6c 6c 65 6c 20  |e with parallel |
000002d0  62 65 61 6d 73 2e 0a 46  6f 72 20 65 61 63 68 20  |beams..For each |
000002e0  70 6f 69 6e 74 20 6f 6e  20 74 68 65 20 68 65 69  |point on the hei|
000002f0  67 68 74 20 66 69 65 6c  64 20 74 68 65 20 70 72  |ght field the pr|
00000300  6f 67 72 61 6d 20 63 61  6c 63 75 6c 61 74 65 73  |ogram calculates|
00000310  20 74 68 65 20 69 6e 74  65 6e 73 69 74 79 2c 20  | the intensity, |
00000320  0a 64 65 70 65 6e 64 69  6e 67 20 6f 6e 20 74 68  |.depending on th|
00000330  65 20 61 6e 67 6c 65 20  6f 66 20 74 68 65 20 69  |e angle of the i|
00000340  6e 63 69 64 65 6e 74 20  6c 69 67 68 74 2d 72 61  |ncident light-ra|
00000350  79 20 77 69 74 68 20 74  68 65 20 73 75 72 66 61  |y with the surfa|
00000360  63 65 20 6e 6f 72 6d 61  6c 20 69 6e 0a 74 68 61  |ce normal in.tha|
00000370  74 20 70 6f 69 6e 74 2e  20 41 6e 20 6f 70 74 69  |t point. An opti|
00000380  6f 6e 20 69 6e 20 74 68  65 20 70 72 6f 67 72 61  |on in the progra|
00000390  6d 20 61 6c 6c 6f 77 73  20 66 6f 72 20 61 64 64  |m allows for add|
000003a0  69 74 69 6f 6e 61 6c 20  73 68 61 64 6f 77 20 0a  |itional shadow .|
000003b0  63 61 6c 63 75 6c 61 74  69 6f 6e 73 20 61 73 20  |calculations as |
000003c0  77 65 6c 6c 21 0a 54 68  65 20 70 72 6f 67 72 61  |well!.The progra|
000003d0  6d 20 69 73 20 66 75 6c  6c 79 20 52 49 53 43 20  |m is fully RISC |
000003e0  4f 53 20 63 6f 6d 70 61  74 69 62 6c 65 20 61 6e  |OS compatible an|
000003f0  64 20 77 69 6c 6c 20 70  65 72 66 6f 72 6d 20 6d  |d will perform m|
00000400  6f 73 74 20 6f 66 20 69  74 73 20 0a 70 72 6f 63  |ost of its .proc|
00000410  65 73 73 65 73 20 69 6e  20 74 68 65 20 62 61 63  |esses in the bac|
00000420  6b 67 72 6f 75 6e 64 2e  0a 0a 0a 54 68 65 20 6c  |kground....The l|
00000430  6f 67 69 63 20 6f 66 20  46 72 61 63 54 72 61 63  |ogic of FracTrac|
00000440  65 3a 0a 0a 54 68 65 20  64 69 66 66 65 72 65 6e  |e:..The differen|
00000450  74 20 70 61 72 61 6d 65  74 65 72 73 20 6e 65 65  |t parameters nee|
00000460  64 65 64 20 74 6f 20 73  70 65 63 69 66 79 20 74  |ded to specify t|
00000470  68 65 20 73 75 72 66 61  63 65 27 73 20 63 68 61  |he surface's cha|
00000480  72 61 63 74 65 72 69 73  74 69 63 73 0a 61 72 65  |racteristics.are|
00000490  20 73 65 74 20 75 73 69  6e 67 20 61 20 73 63 72  | set using a scr|
000004a0  69 70 74 20 6c 61 6e 67  75 61 67 65 3a 20 22 46  |ipt language: "F|
000004b0  54 53 22 20 28 77 68 69  63 68 20 73 74 61 6e 64  |TS" (which stand|
000004c0  73 20 66 6f 72 20 46 72  61 63 54 72 61 63 65 20  |s for FracTrace |
000004d0  53 63 72 69 70 74 29 2e  0a 54 68 65 20 63 6f 6d  |Script)..The com|
000004e0  6d 61 6e 64 73 20 6f 66  20 74 68 69 73 20 73 63  |mands of this sc|
000004f0  72 69 70 74 20 63 61 6e  20 62 65 20 75 73 65 64  |ript can be used|
00000500  20 74 6f 20 65 78 61 63  74 6c 79 20 64 65 66 69  | to exactly defi|
00000510  6e 65 20 77 68 61 74 20  74 68 65 20 70 72 6f 67  |ne what the prog|
00000520  72 61 6d 0a 73 68 6f 75  6c 64 20 6f 75 74 70 75  |ram.should outpu|
00000530  74 2e 0a 54 68 65 20 70  72 6f 67 72 61 6d 20 61  |t..The program a|
00000540  6c 73 6f 20 61 6c 6c 6f  77 73 20 74 68 65 20 75  |lso allows the u|
00000550  73 65 72 20 74 6f 20 63  61 6c 63 75 6c 61 74 65  |ser to calculate|
00000560  20 61 20 70 6f 74 65 6e  74 69 61 6c 20 6d 61 70  | a potential map|
00000570  20 28 61 20 32 44 2d 61  72 72 61 79 0a 77 68 69  | (a 2D-array.whi|
00000580  63 68 20 68 6f 6c 64 73  20 74 68 65 20 70 6f 74  |ch holds the pot|
00000590  65 6e 74 69 61 6c 20 66  6f 72 20 65 61 63 68 20  |ential for each |
000005a0  70 6f 69 6e 74 20 6f 6e  20 74 68 65 20 73 75 72  |point on the sur|
000005b0  66 61 63 65 29 2c 20 77  68 69 63 68 20 63 61 6e  |face), which can|
000005c0  20 62 65 0a 75 73 65 64  2c 20 73 61 76 65 64 20  | be.used, saved |
000005d0  61 6e 64 20 72 65 6c 6f  61 64 65 64 2c 20 77 68  |and reloaded, wh|
000005e0  65 6e 20 72 65 6e 64 65  72 69 6e 67 20 74 68 65  |en rendering the|
000005f0  20 33 44 2d 69 6d 61 67  65 20 6f 66 20 74 68 65  | 3D-image of the|
00000600  20 73 75 72 66 61 63 65  2e 0a 55 73 69 6e 67 20  | surface..Using |
00000610  74 68 69 73 20 6d 61 70  20 77 69 6c 6c 20 73 70  |this map will sp|
00000620  65 65 64 20 75 70 20 74  68 65 20 70 72 6f 67 72  |eed up the progr|
00000630  61 6d 20 62 79 20 61 20  63 65 72 74 61 69 6e 20  |am by a certain |
00000640  66 61 63 74 6f 72 2e 20  49 74 20 69 73 20 6d 6f  |factor. It is mo|
00000650  72 65 0a 6d 65 6d 6f 72  79 2d 63 6f 6e 73 75 6d  |re.memory-consum|
00000660  69 6e 67 20 74 68 6f 75  67 68 21 0a 57 68 65 6e  |ing though!.When|
00000670  20 74 68 65 20 72 65 6e  64 65 72 69 6e 67 20 70  | the rendering p|
00000680  72 6f 63 65 73 73 20 69  73 20 66 69 6e 69 73 68  |rocess is finish|
00000690  65 64 2c 20 74 68 65 20  69 6d 61 67 65 20 63 61  |ed, the image ca|
000006a0  6e 20 62 65 20 73 61 76  65 64 20 61 73 20 61 20  |n be saved as a |
000006b0  0a 73 74 61 6e 64 61 72  64 20 6d 6f 64 65 20 31  |.standard mode 1|
000006c0  32 20 73 70 72 69 74 65  2e 0a 0a 0a 48 6f 77 20  |2 sprite....How |
000006d0  74 6f 20 75 73 65 20 46  72 61 63 54 72 61 63 65  |to use FracTrace|
000006e0  3f 0a 0a 46 72 61 63 54  72 61 63 65 20 28 76 65  |?..FracTrace (ve|
000006f0  72 73 69 6f 6e 20 32 2e  30 30 20 61 6e 64 20 61  |rsion 2.00 and a|
00000700  62 6f 76 65 29 20 72 75  6e 73 20 63 6f 6d 70 6c  |bove) runs compl|
00000710  65 74 65 6c 79 20 66 72  6f 6d 20 74 68 65 20 52  |etely from the R|
00000720  49 53 43 20 4f 53 20 64  65 73 6b 74 6f 70 2e 0a  |ISC OS desktop..|
00000730  44 6f 75 62 6c 65 2d 63  6c 69 63 6b 69 6e 67 20  |Double-clicking |
00000740  6f 6e 20 69 74 73 20 69  63 6f 6e 20 69 6e 20 61  |on its icon in a|
00000750  20 66 69 6c 65 72 2d 77  69 6e 64 6f 77 20 73 74  | filer-window st|
00000760  61 72 74 73 20 74 68 65  20 70 72 6f 67 72 61 6d  |arts the program|
00000770  2e 2e 2e 20 41 66 74 65  72 20 61 0a 73 75 63 63  |... After a.succ|
00000780  65 73 66 75 6c 20 6c 6f  61 64 2c 20 74 68 65 20  |esful load, the |
00000790  70 72 6f 67 72 61 6d 20  69 6e 73 74 61 6c 6c 73  |program installs|
000007a0  20 69 74 73 65 6c 66 20  6f 6e 20 74 68 65 20 69  | itself on the i|
000007b0  63 6f 6e 62 61 72 2e 0a  0a 43 6c 69 63 6b 69 6e  |conbar...Clickin|
000007c0  67 20 77 69 74 68 20 53  65 6c 65 63 74 20 28 6c  |g with Select (l|
000007d0  65 66 74 2d 62 75 74 74  6f 6e 29 20 6f 6e 20 74  |eft-button) on t|
000007e0  68 65 20 69 63 6f 6e 20  63 61 75 73 65 73 20 74  |he icon causes t|
000007f0  68 65 20 27 72 65 70 6f  72 74 20 77 69 6e 64 6f  |he 'report windo|
00000800  77 27 20 74 6f 0a 62 65  20 6f 70 65 6e 65 64 3a  |w' to.be opened:|
00000810  20 76 69 61 20 74 68 69  73 20 77 69 6e 64 6f 77  | via this window|
00000820  2c 20 74 68 65 20 70 72  6f 67 72 61 6d 20 69 6e  |, the program in|
00000830  66 6f 72 6d 73 20 74 68  65 20 75 73 65 72 20 6f  |forms the user o|
00000840  6e 20 77 68 61 74 20 69  74 27 73 20 64 6f 69 6e  |n what it's doin|
00000850  67 21 0a 0a 43 6c 69 63  6b 69 6e 67 20 77 69 74  |g!..Clicking wit|
00000860  68 20 41 64 6a 75 73 74  20 28 72 69 67 68 74 2d  |h Adjust (right-|
00000870  62 75 74 74 6f 6e 29 20  6f 6e 20 74 68 65 20 69  |button) on the i|
00000880  63 6f 6e 20 63 61 75 73  65 73 20 74 68 65 20 27  |con causes the '|
00000890  76 69 65 77 20 77 69 6e  64 6f 77 27 20 74 6f 0a  |view window' to.|
000008a0  62 65 20 6f 70 65 6e 65  64 3a 20 74 68 69 73 20  |be opened: this |
000008b0  77 69 6e 64 6f 77 20 73  68 6f 77 73 20 74 68 65  |window shows the|
000008c0  20 69 6d 61 67 65 20 74  68 61 74 20 69 73 20 72  | image that is r|
000008d0  65 6e 64 65 72 65 64 2e  0a 0a 43 6c 69 63 6b 69  |endered...Clicki|
000008e0  6e 67 20 77 69 74 68 20  4d 65 6e 75 20 28 6d 69  |ng with Menu (mi|
000008f0  64 64 6c 65 2d 62 75 74  74 6f 6e 29 20 6f 6e 20  |ddle-button) on |
00000900  74 68 65 20 69 63 6f 6e  20 62 72 69 6e 67 73 20  |the icon brings |
00000910  75 70 20 74 68 65 20 69  63 6f 6e 20 6d 65 6e 75  |up the icon menu|
00000920  2c 20 77 68 69 63 68 0a  61 6c 6c 6f 77 73 20 74  |, which.allows t|
00000930  68 65 20 75 73 65 72 20  74 6f 20 73 65 65 20 74  |he user to see t|
00000940  68 65 20 70 72 6f 67 72  61 6d 20 69 6e 66 6f 20  |he program info |
00000950  28 27 41 62 6f 75 74 20  74 68 69 73 20 70 72 6f  |('About this pro|
00000960  67 72 61 6d 27 2e 2e 2e  29 20 61 6e 64 20 74 6f  |gram'...) and to|
00000970  20 71 75 69 74 0a 74 68  65 20 70 72 6f 67 72 61  | quit.the progra|
00000980  6d 20 77 68 65 6e 20 79  6f 75 20 77 69 73 68 20  |m when you wish |
00000990  74 6f 20 64 6f 20 73 6f  21 0a 0a 43 6c 69 63 6b  |to do so!..Click|
000009a0  69 6e 67 20 4d 65 6e 75  20 6f 76 65 72 20 6f 6e  |ing Menu over on|
000009b0  65 20 6f 66 20 74 68 65  20 77 69 6e 64 6f 77 73  |e of the windows|
000009c0  20 28 27 72 65 70 6f 72  74 27 2c 27 76 69 65 77  | ('report','view|
000009d0  27 20 61 6e 64 20 27 70  61 6e 65 6c 27 29 20 70  |' and 'panel') p|
000009e0  72 6f 76 69 64 65 64 0a  62 79 20 46 72 61 63 54  |rovided.by FracT|
000009f0  72 61 63 65 20 62 72 69  6e 67 73 20 75 70 20 74  |race brings up t|
00000a00  68 65 20 27 4d 61 69 6e  20 46 72 61 63 54 72 61  |he 'Main FracTra|
00000a10  63 65 20 4d 65 6e 75 27  3a 20 74 68 69 73 20 6d  |ce Menu': this m|
00000a20  65 6e 75 20 67 69 76 65  73 20 79 6f 75 20 74 68  |enu gives you th|
00000a30  65 20 0a 61 63 74 75 61  6c 20 63 6f 6e 74 72 6f  |e .actual contro|
00000a40  6c 20 6f 76 65 72 20 74  68 65 20 70 72 6f 67 72  |l over the progr|
00000a50  61 6d 2c 20 69 74 73 20  69 74 65 6d 73 20 61 72  |am, its items ar|
00000a60  65 20 64 65 73 63 72 69  62 65 64 20 62 65 6c 6f  |e described belo|
00000a70  77 2e 2e 2e 0a 0a 54 69  74 6c 65 20 20 20 20 20  |w.....Title     |
00000a80  20 3a 20 43 68 6f 6f 73  69 6e 67 20 74 68 69 73  | : Choosing this|
00000a90  20 69 74 65 6d 20 61 6c  6c 6f 77 73 20 79 6f 75  | item allows you|
00000aa0  20 74 6f 20 65 6e 74 65  72 20 61 20 74 69 74 6c  | to enter a titl|
00000ab0  65 2d 6e 61 6d 65 20 66  6f 72 20 74 68 65 20 0a  |e-name for the .|
00000ac0  20 20 20 20 20 20 20 20  20 20 20 20 20 63 75 72  |             cur|
00000ad0  72 65 6e 74 20 69 6d 61  67 65 20 61 6e 64 20 69  |rent image and i|
00000ae0  74 73 20 63 6f 6e 74 72  6f 6c 20 70 61 72 61 6d  |ts control param|
00000af0  65 74 65 72 73 2e 20 44  6f 6e 27 74 20 75 73 65  |eters. Don't use|
00000b00  20 6d 6f 72 65 20 74 68  61 6e 0a 20 20 20 20 20  | more than.     |
00000b10  20 20 20 20 20 20 20 20  38 20 63 68 61 72 61 63  |        8 charac|
00000b20  74 65 72 73 21 0a 0a 4d  69 73 63 20 20 20 20 20  |ters!..Misc     |
00000b30  20 20 3a 20 54 68 65 20  6d 69 73 63 65 6c 6c 61  |  : The miscella|
00000b40  6e 65 6f 75 73 20 73 75  62 6d 65 6e 75 2e 20 46  |neous submenu. F|
00000b50  72 6f 6d 20 74 68 69 73  20 73 75 62 6d 65 6e 75  |rom this submenu|
00000b60  20 79 6f 75 20 63 61 6e  20 74 6f 67 67 6c 65 20  | you can toggle |
00000b70  74 68 65 20 0a 20 20 20  20 20 20 20 20 20 20 20  |the .           |
00000b80  20 20 27 61 75 74 6f 2d  70 61 72 73 65 27 20 6f  |  'auto-parse' o|
00000b90  70 74 69 6f 6e 20 28 73  65 65 20 62 65 6c 6f 77  |ption (see below|
00000ba0  29 2c 20 74 6f 67 67 6c  65 20 27 6d 75 6c 74 69  |), toggle 'multi|
00000bb0  74 61 73 6b 27 20 6d 6f  64 65 2c 0a 20 20 20 20  |task' mode,.    |
00000bc0  20 20 20 20 20 20 20 20  20 6f 70 65 6e 20 74 68  |         open th|
00000bd0  65 20 52 49 53 43 20 4f  53 20 64 69 72 65 63 74  |e RISC OS direct|
00000be0  6f 72 79 20 66 69 6c 65  72 20 6f 66 20 79 6f 75  |ory filer of you|
00000bf0  72 20 73 61 76 69 6e 67  20 64 69 72 65 63 74 6f  |r saving directo|
00000c00  72 79 2c 20 61 62 6f 72  74 0a 20 20 20 20 20 20  |ry, abort.      |
00000c10  20 20 20 20 20 20 20 74  68 65 20 63 75 72 72 65  |       the curre|
00000c20  6e 74 20 70 72 6f 63 65  73 73 2c 20 6f 72 20 72  |nt process, or r|
00000c30  65 73 75 6d 65 20 69 74  2e 0a 20 20 20 20 20 20  |esume it..      |
00000c40  20 20 20 20 20 20 20 53  65 74 74 69 6e 67 20 74  |       Setting t|
00000c50  68 65 20 27 61 75 74 6f  2d 70 61 72 73 65 27 20  |he 'auto-parse' |
00000c60  6f 70 74 69 6f 6e 20 77  69 6c 6c 20 63 61 75 73  |option will caus|
00000c70  65 20 46 54 53 20 66 69  6c 65 73 20 74 6f 20 62  |e FTS files to b|
00000c80  65 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 70  |e.             p|
00000c90  61 72 73 65 64 20 69 6d  6d 65 64 69 61 74 65 6c  |arsed immediatel|
00000ca0  79 20 77 68 65 6e 20 74  68 65 79 27 72 65 20 64  |y when they're d|
00000cb0  72 61 67 67 65 64 20 69  6e 74 6f 20 74 68 65 20  |ragged into the |
00000cc0  70 72 6f 67 72 61 6d 2e  0a 20 20 20 20 20 20 20  |program..       |
00000cd0  20 20 20 20 20 20 57 68  65 6e 20 27 6d 75 6c 74  |      When 'mult|
00000ce0  69 74 61 73 6b 27 20 6d  6f 64 65 20 69 73 20 64  |itask' mode is d|
00000cf0  65 73 65 6c 65 63 74 65  64 2c 20 70 72 6f 63 65  |eselected, proce|
00000d00  73 73 65 73 20 73 75 63  68 20 61 73 20 0a 20 20  |sses such as .  |
00000d10  20 20 20 20 20 20 20 20  20 20 20 63 61 6c 63 75  |           calcu|
00000d20  6c 61 74 69 6e 67 20 61  20 70 6f 74 65 6e 74 69  |lating a potenti|
00000d30  61 6c 20 6d 61 70 20 61  6e 64 20 72 61 79 74 72  |al map and raytr|
00000d40  61 63 69 6e 67 20 74 61  6b 65 20 6f 76 65 72 20  |acing take over |
00000d50  74 68 65 20 77 68 6f 6c  65 0a 20 20 20 20 20 20  |the whole.      |
00000d60  20 20 20 20 20 20 20 6d  61 63 68 69 6e 65 2c 20  |       machine, |
00000d70  69 65 2e 20 74 68 65 79  20 64 6f 6e 27 74 20 6d  |ie. they don't m|
00000d80  75 6c 74 69 74 61 73 6b  20 62 75 74 20 74 68 65  |ultitask but the|
00000d90  79 27 72 65 20 66 61 73  74 65 72 21 0a 20 20 20  |y're faster!.   |
00000da0  20 20 20 20 20 20 20 20  20 20 54 68 65 20 27 6f  |          The 'o|
00000db0  70 65 6e 20 66 69 6c 65  72 27 20 6f 70 74 69 6f  |pen filer' optio|
00000dc0  6e 20 6f 70 65 6e 73 20  74 68 65 20 66 69 6c 65  |n opens the file|
00000dd0  72 20 6f 66 20 74 68 65  20 64 69 72 65 63 74 6f  |r of the directo|
00000de0  72 79 20 69 6e 0a 20 20  20 20 20 20 20 20 20 20  |ry in.          |
00000df0  20 20 20 77 68 69 63 68  20 46 72 61 63 54 72 61  |   which FracTra|
00000e00  63 65 20 73 74 6f 72 65  73 20 69 74 73 20 6f 75  |ce stores its ou|
00000e10  74 70 75 74 20 66 69 6c  65 73 2e 20 4e 6f 72 6d  |tput files. Norm|
00000e20  61 6c 6c 79 2c 20 77 68  65 6e 20 79 6f 75 20 0a  |ally, when you .|
00000e30  20 20 20 20 20 20 20 20  20 20 20 20 20 77 61 6e  |             wan|
00000e40  74 20 74 6f 20 73 61 76  65 20 61 20 66 69 6c 65  |t to save a file|
00000e50  20 28 4d 61 70 2c 20 49  6d 61 67 65 2c 20 6f 72  | (Map, Image, or|
00000e60  20 53 63 72 69 70 74 29  2c 20 79 6f 75 20 63 61  | Script), you ca|
00000e70  6e 20 64 72 61 67 20 74  68 65 0a 20 20 20 20 20  |n drag the.     |
00000e80  20 20 20 20 20 20 20 20  69 63 6f 6e 20 69 6e 20  |        icon in |
00000e90  61 20 66 69 6c 65 72 2c  20 77 68 69 63 68 20 69  |a filer, which i|
00000ea0  73 20 74 68 65 20 27 41  63 6f 72 6e 20 70 72 6f  |s the 'Acorn pro|
00000eb0  70 6f 73 65 64 27 20 77  61 79 20 6f 66 20 73 61  |posed' way of sa|
00000ec0  76 69 6e 67 20 0a 20 20  20 20 20 20 20 20 20 20  |ving .          |
00000ed0  20 20 20 66 69 6c 65 73  2e 20 48 6f 77 65 76 65  |   files. Howeve|
00000ee0  72 2c 20 77 68 65 6e 20  74 68 65 20 70 72 6f 67  |r, when the prog|
00000ef0  72 61 6d 20 69 73 20 72  65 6e 64 65 72 69 6e 67  |ram is rendering|
00000f00  20 6d 75 6c 74 69 70 6c  65 20 69 6d 61 67 65 73  | multiple images|
00000f10  2c 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 74  |,.             t|
00000f20  68 65 6e 20 63 61 6c 6c  65 64 20 27 66 72 61 6d  |hen called 'fram|
00000f30  65 73 27 20 28 66 6f 72  20 61 6e 69 6d 61 74 69  |es' (for animati|
00000f40  6f 6e 20 73 65 71 75 65  6e 63 65 73 29 2c 20 65  |on sequences), e|
00000f50  61 63 68 20 27 66 72 61  6d 65 27 0a 20 20 20 20  |ach 'frame'.    |
00000f60  20 20 20 20 20 20 20 20  20 6d 75 73 74 20 62 65  |         must be|
00000f70  20 73 61 76 65 64 20 77  68 65 6e 20 72 65 6e 64  | saved when rend|
00000f80  65 72 69 6e 67 20 69 73  20 66 69 6e 69 73 68 65  |ering is finishe|
00000f90  64 2c 20 77 69 74 68 6f  75 74 20 74 68 65 20 0a  |d, without the .|
00000fa0  20 20 20 20 20 20 20 20  20 20 20 20 20 69 6e 74  |             int|
00000fb0  65 72 76 65 6e 74 69 6f  6e 20 6f 66 20 74 68 65  |ervention of the|
00000fc0  20 75 73 65 72 2e 20 54  68 69 73 20 69 73 20 64  | user. This is d|
00000fd0  6f 6e 65 20 69 6e 20 61  20 64 69 72 65 63 74 6f  |one in a directo|
00000fe0  72 79 20 74 68 61 74 20  69 73 20 0a 20 20 20 20  |ry that is .    |
00000ff0  20 20 20 20 20 20 20 20  20 73 70 65 63 69 66 69  |         specifi|
00001000  65 64 20 62 65 66 6f 72  65 68 61 6e 64 2e 0a 20  |ed beforehand.. |
00001010  20 20 20 20 20 20 20 20  20 20 20 20 54 68 65 20  |            The |
00001020  6f 70 74 69 6f 6e 73 20  27 61 62 6f 72 74 27 20  |options 'abort' |
00001030  61 6e 64 20 27 72 65 73  75 6d 65 27 20 61 72 65  |and 'resume' are|
00001040  20 66 6f 72 20 61 62 6f  72 74 69 6e 67 20 61 6e  | for aborting an|
00001050  64 20 72 65 73 75 6d 69  6e 67 20 61 0a 20 20 20  |d resuming a.   |
00001060  20 20 20 20 20 20 20 20  20 20 70 72 6f 63 65 73  |          proces|
00001070  73 20 72 65 73 70 65 63  74 69 76 65 6c 79 2e 20  |s respectively. |
00001080  20 20 0a 0a 53 61 76 65  20 20 20 20 20 20 20 3a  |  ..Save       :|
00001090  20 46 72 6f 6d 20 74 68  69 73 20 73 75 62 6d 65  | From this subme|
000010a0  6e 75 20 79 6f 75 20 63  61 6e 20 73 61 76 65 20  |nu you can save |
000010b0  79 6f 75 72 20 66 69 6c  65 73 3a 0a 20 20 20 20  |your files:.    |
000010c0  20 20 20 20 20 20 20 20  20 4d 61 70 20 2e 2e 2e  |         Map ...|
000010d0  20 53 61 76 65 73 20 74  68 65 20 63 75 72 72 65  | Saves the curre|
000010e0  6e 74 20 6d 61 70 2e 0a  20 20 20 20 20 20 20 20  |nt map..        |
000010f0  20 20 20 20 20 49 6d 61  67 65 20 2e 2e 2e 20 53  |     Image ... S|
00001100  61 76 65 73 20 6c 61 73  74 20 72 65 6e 64 65 72  |aves last render|
00001110  65 64 20 69 6d 61 67 65  2e 0a 20 20 20 20 20 20  |ed image..      |
00001120  20 20 20 20 20 20 20 53  63 72 69 70 74 20 2e 2e  |       Script ..|
00001130  2e 20 53 61 76 65 73 20  61 20 73 63 72 69 70 74  |. Saves a script|
00001140  20 66 69 6c 65 20 63 6f  6e 74 61 69 6e 69 6e 67  | file containing|
00001150  20 46 54 53 20 63 6f 6d  6d 61 6e 64 73 20 66 6f  | FTS commands fo|
00001160  72 20 74 68 65 0a 20 20  20 20 20 20 20 20 20 20  |r the.          |
00001170  20 20 20 20 20 20 20 20  20 20 20 20 63 75 72 72  |            curr|
00001180  65 6e 74 20 70 61 72 61  6d 65 74 65 72 2d 73 65  |ent parameter-se|
00001190  74 74 69 6e 67 73 2e 0a  20 20 20 20 20 20 20 20  |ttings..        |
000011a0  20 20 20 20 20 53 61 76  69 6e 67 20 69 73 20 64  |     Saving is d|
000011b0  6f 6e 65 20 69 6e 20 74  68 65 20 63 6f 6e 76 65  |one in the conve|
000011c0  6e 74 69 6f 6e 61 6c 20  77 61 79 2c 20 69 65 2e  |ntional way, ie.|
000011d0  20 62 79 20 64 72 61 67  67 69 6e 67 20 74 68 65  | by dragging the|
000011e0  20 69 63 6f 6e 0a 20 20  20 20 20 20 20 20 20 20  | icon.          |
000011f0  20 20 20 69 6e 20 61 20  66 69 6c 65 72 20 77 69  |   in a filer wi|
00001200  6e 64 6f 77 2e 20 20 20  0a 20 20 20 20 20 20 20  |ndow.   .       |
00001210  20 20 20 20 20 20 53 61  76 65 70 61 74 68 20 2e  |      Savepath .|
00001220  2e 2e 20 53 65 74 20 74  68 65 20 73 61 76 69 6e  |.. Set the savin|
00001230  67 2d 64 69 72 65 63 74  6f 72 79 20 66 6f 72 20  |g-directory for |
00001240  66 72 61 6d 65 73 20 28  73 65 65 20 61 62 6f 76  |frames (see abov|
00001250  65 29 2e 0a 20 20 20 20  20 20 20 20 20 20 20 20  |e)..            |
00001260  20 20 20 20 20 20 20 20  20 20 20 20 20 20 54 68  |              Th|
00001270  69 73 20 69 73 20 61 6c  73 6f 20 64 6f 6e 65 20  |is is also done |
00001280  62 79 20 64 72 61 67 67  69 6e 67 20 74 68 65 20  |by dragging the |
00001290  69 63 6f 6e 20 69 6e 20  61 20 66 69 6c 65 72 2e  |icon in a filer.|
000012a0  0a 0a 50 72 6f 63 65 73  73 20 20 20 20 3a 20 46  |..Process    : F|
000012b0  72 6f 6d 20 74 68 69 73  20 73 75 62 6d 65 6e 75  |rom this submenu|
000012c0  20 79 6f 75 20 73 74 61  72 74 20 6f 6e 65 20 6f  | you start one o|
000012d0  66 20 74 68 65 20 70 72  6f 63 65 73 73 65 73 2c  |f the processes,|
000012e0  20 62 65 69 6e 67 3a 0a  20 20 20 20 20 20 20 20  | being:.        |
000012f0  20 20 20 20 20 50 61 72  73 65 3a 20 53 74 61 72  |     Parse: Star|
00001300  74 73 20 70 61 72 73 69  6e 67 20 28 69 65 2e 20  |ts parsing (ie. |
00001310  69 6e 74 65 72 70 72 65  74 69 6e 67 29 20 74 68  |interpreting) th|
00001320  65 20 6c 61 73 74 20 6c  6f 61 64 65 64 20 46 54  |e last loaded FT|
00001330  53 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |S.              |
00001340  20 20 20 20 20 20 66 69  6c 65 2e 0a 20 20 20 20  |      file..    |
00001350  20 20 20 20 20 20 20 20  20 52 61 79 74 72 61 63  |         Raytrac|
00001360  65 3a 20 53 74 61 72 74  73 20 72 65 6e 64 65 72  |e: Starts render|
00001370  69 6e 67 20 74 68 65 20  73 75 72 66 61 63 65 20  |ing the surface |
00001380  75 73 69 6e 67 20 74 68  65 20 70 61 72 61 6d 65  |using the parame|
00001390  74 65 72 73 20 73 65 74  0a 20 20 20 20 20 20 20  |ters set.       |
000013a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000013b0  69 6e 20 74 68 65 20 6c  61 73 74 20 70 61 72 73  |in the last pars|
000013c0  65 64 20 46 54 53 20 66  69 6c 65 2e 0a 20 20 20  |ed FTS file..   |
000013d0  20 20 20 20 20 20 20 20  20 20 43 61 6c 63 75 6c  |          Calcul|
000013e0  61 74 65 3a 20 53 74 61  72 74 73 20 63 61 6c 63  |ate: Starts calc|
000013f0  75 6c 61 74 69 6e 67 20  74 68 65 20 70 6f 74 65  |ulating the pote|
00001400  6e 74 69 61 6c 20 6d 61  70 20 66 6f 72 20 61 20  |ntial map for a |
00001410  73 75 72 66 61 63 65 0a  20 20 20 20 20 20 20 20  |surface.        |
00001420  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001430  75 73 69 6e 67 20 74 68  65 20 70 61 72 61 6d 65  |using the parame|
00001440  74 65 72 73 20 6f 66 20  74 68 65 20 6c 61 73 74  |ters of the last|
00001450  20 70 61 72 73 65 64 20  46 54 53 20 66 69 6c 65  | parsed FTS file|
00001460  2e 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 41  |..             A|
00001470  6e 79 20 6f 66 20 74 68  65 73 65 20 70 72 6f 63  |ny of these proc|
00001480  65 73 73 65 73 20 63 61  6e 20 62 65 20 61 62 6f  |esses can be abo|
00001490  72 74 65 64 20 61 74 20  61 6e 79 20 74 69 6d 65  |rted at any time|
000014a0  20 62 79 20 65 69 74 68  65 72 3a 0a 20 20 20 20  | by either:.    |
000014b0  20 20 20 20 20 20 20 20  20 20 2d 20 63 6c 69 63  |          - clic|
000014c0  6b 69 6e 67 20 6f 6e 20  27 61 62 6f 72 74 27 20  |king on 'abort' |
000014d0  69 6e 20 74 68 65 20 27  72 65 70 6f 72 74 27 20  |in the 'report' |
000014e0  77 69 6e 64 6f 77 20 6f  72 20 69 63 6f 6e 20 6d  |window or icon m|
000014f0  65 6e 75 2e 20 0a 20 20  20 20 20 20 20 20 20 20  |enu. .          |
00001500  20 20 20 20 2d 20 63 6c  69 63 6b 69 6e 67 20 61  |    - clicking a|
00001510  6e 79 20 6d 6f 75 73 65  20 62 75 74 74 6f 6e 20  |ny mouse button |
00001520  77 68 65 6e 20 69 6e 20  6e 6f 6e 2d 27 6d 75 6c  |when in non-'mul|
00001530  74 69 74 61 73 6b 27 20  6d 6f 64 65 2e 0a 20 20  |titask' mode..  |
00001540  20 20 20 20 20 20 20 20  20 20 20 4e 6f 74 65 20  |           Note |
00001550  74 68 61 74 20 6f 6e 6c  79 20 6f 6e 65 20 6f 66  |that only one of|
00001560  20 74 68 65 73 65 20 70  72 6f 63 65 73 73 65 73  | these processes|
00001570  20 63 61 6e 20 62 65 20  61 63 74 69 76 65 20 61  | can be active a|
00001580  74 20 61 20 74 69 6d 65  2e 0a 0a 53 68 6f 77 20  |t a time...Show |
00001590  20 20 20 20 20 20 3a 20  57 69 74 68 20 74 68 69  |      : With thi|
000015a0  73 20 73 75 62 6d 65 6e  75 20 79 6f 75 20 63 61  |s submenu you ca|
000015b0  6e 20 6f 70 65 6e 20 74  68 65 20 77 69 6e 64 6f  |n open the windo|
000015c0  77 73 20 6f 66 20 46 72  61 63 54 72 61 63 65 2e  |ws of FracTrace.|
000015d0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 54 68  |.             Th|
000015e0  65 20 27 76 69 65 77 27  20 77 69 6e 64 6f 77 20  |e 'view' window |
000015f0  73 68 6f 77 73 20 74 68  65 20 69 6d 61 67 65 20  |shows the image |
00001600  6f 66 20 74 68 65 20 63  75 72 72 65 6e 74 20 73  |of the current s|
00001610  75 72 66 61 63 65 2e 20  57 68 65 6e 0a 20 20 20  |urface. When.   |
00001620  20 20 20 20 20 20 20 20  20 20 74 68 65 20 70 72  |          the pr|
00001630  6f 67 72 61 6d 20 69 73  20 72 65 6e 64 65 72 69  |ogram is renderi|
00001640  6e 67 20 61 20 73 75 72  66 61 63 65 2c 20 74 68  |ng a surface, th|
00001650  65 20 63 6f 6e 74 65 6e  74 73 20 6f 66 20 74 68  |e contents of th|
00001660  69 73 20 77 69 6e 64 6f  77 0a 20 20 20 20 20 20  |is window.      |
00001670  20 20 20 20 20 20 20 61  72 65 20 6f 6e 6c 79 20  |       are only |
00001680  75 70 64 61 74 65 64 20  62 65 74 77 65 65 6e 20  |updated between |
00001690  65 61 63 68 20 72 6f 77  20 6f 66 20 70 6f 69 6e  |each row of poin|
000016a0  74 73 20 62 65 69 6e 67  20 72 65 6e 64 65 72 65  |ts being rendere|
000016b0  64 2e 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |d..             |
000016c0  43 6c 69 63 6b 69 6e 67  20 77 69 74 68 20 73 65  |Clicking with se|
000016d0  6c 65 63 74 20 69 6e 20  74 68 69 73 20 77 69 6e  |lect in this win|
000016e0  64 6f 77 20 63 61 75 73  65 73 20 61 6e 20 69 6d  |dow causes an im|
000016f0  6d 65 64 69 61 74 65 20  75 70 64 61 74 65 2e 0a  |mediate update..|
00001700  20 20 20 20 20 20 20 20  20 20 20 20 20 54 68 65  |             The|
00001710  20 27 70 61 6e 65 6c 27  20 77 69 6e 64 6f 77 20  | 'panel' window |
00001720  73 68 6f 77 73 20 74 68  65 20 70 61 72 61 6d 65  |shows the parame|
00001730  74 65 72 73 20 61 6e 64  20 74 68 65 69 72 20 63  |ters and their c|
00001740  75 72 72 65 6e 74 0a 20  20 20 20 20 20 20 20 20  |urrent.         |
00001750  20 20 20 20 76 61 6c 75  65 73 2e 20 54 68 65 20  |    values. The |
00001760  76 61 6c 75 65 73 20 6d  61 79 20 62 65 20 63 68  |values may be ch|
00001770  61 6e 67 65 64 20 61 74  20 61 6e 79 20 74 69 6d  |anged at any tim|
00001780  65 20 62 79 20 63 6c 69  63 6b 69 6e 67 20 6f 6e  |e by clicking on|
00001790  20 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 74  | .             t|
000017a0  68 65 20 76 61 6c 75 65  27 73 20 69 63 6f 6e 20  |he value's icon |
000017b0  61 6e 64 20 65 6e 74 65  72 69 6e 67 20 61 20 6e  |and entering a n|
000017c0  65 77 20 76 61 6c 75 65  20 66 72 6f 6d 20 74 68  |ew value from th|
000017d0  65 20 6b 65 79 62 6f 61  72 64 2e 0a 20 20 20 20  |e keyboard..    |
000017e0  20 20 20 20 20 20 20 20  20 57 68 65 6e 20 79 6f  |         When yo|
000017f0  75 20 77 69 73 68 20 74  6f 20 75 70 64 61 74 65  |u wish to update|
00001800  20 74 68 65 20 70 61 72  61 6d 65 74 65 72 73 20  | the parameters |
00001810  77 69 74 68 20 74 68 65  20 6e 65 77 20 76 61 6c  |with the new val|
00001820  75 65 73 2c 0a 20 20 20  20 20 20 20 20 20 20 20  |ues,.           |
00001830  20 20 63 6c 69 63 6b 20  6f 6e 20 74 68 65 20 27  |  click on the '|
00001840  4f 4b 27 20 69 63 6f 6e  20 69 6e 20 74 68 65 20  |OK' icon in the |
00001850  72 69 67 68 74 2d 68 61  6e 64 20 62 6f 74 74 6f  |right-hand botto|
00001860  6d 20 63 6f 72 6e 65 72  20 6f 66 20 74 68 69 73  |m corner of this|
00001870  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 77 69  |.             wi|
00001880  6e 64 6f 77 2c 20 6f 74  68 65 72 77 69 73 65 20  |ndow, otherwise |
00001890  63 6c 69 63 6b 20 6f 6e  20 74 68 65 20 27 43 61  |click on the 'Ca|
000018a0  6e 63 65 6c 27 20 69 63  6f 6e 20 74 6f 20 70 72  |ncel' icon to pr|
000018b0  65 73 65 72 76 65 20 74  68 65 0a 20 20 20 20 20  |eserve the.     |
000018c0  20 20 20 20 20 20 20 20  70 61 72 61 6d 65 74 65  |        paramete|
000018d0  72 73 27 20 76 61 6c 75  65 73 2e 20 4e 6f 74 65  |rs' values. Note|
000018e0  20 74 68 61 74 20 63 6c  69 63 6b 69 6e 67 20 6f  | that clicking o|
000018f0  6e 20 74 68 65 20 77 69  6e 64 6f 77 27 73 20 62  |n the window's b|
00001900  61 63 6b 2d 0a 20 20 20  20 20 20 20 20 20 20 20  |ack-.           |
00001910  20 20 67 72 6f 75 6e 64  20 68 61 73 20 74 68 65  |  ground has the|
00001920  20 73 61 6d 65 20 65 66  66 65 63 74 20 61 73 20  | same effect as |
00001930  63 6c 69 63 6b 69 6e 67  20 6f 6e 20 27 4f 4b 27  |clicking on 'OK'|
00001940  21 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 54  |!.             T|
00001950  68 65 20 27 72 65 70 6f  72 74 27 20 77 69 6e 64  |he 'report' wind|
00001960  6f 77 20 69 73 20 75 73  65 64 20 62 79 20 74 68  |ow is used by th|
00001970  65 20 70 72 6f 67 72 61  6d 20 74 6f 20 69 6e 66  |e program to inf|
00001980  6f 72 6d 20 74 68 65 20  75 73 65 72 20 6f 66 0a  |orm the user of.|
00001990  20 20 20 20 20 20 20 20  20 20 20 20 20 77 68 61  |             wha|
000019a0  74 20 69 74 27 73 20 64  6f 69 6e 67 2e 20 54 68  |t it's doing. Th|
000019b0  69 73 20 77 69 6e 64 6f  77 20 69 73 20 63 6f 6e  |is window is con|
000019c0  73 74 61 6e 74 6c 79 20  75 70 64 61 74 65 64 2c  |stantly updated,|
000019d0  20 65 78 63 65 70 74 20  77 68 65 6e 0a 20 20 20  | except when.   |
000019e0  20 20 20 20 20 20 20 20  20 20 6e 6f 20 70 72 6f  |          no pro|
000019f0  63 65 73 73 20 69 73 20  61 63 74 69 76 65 2c 20  |cess is active, |
00001a00  6f 72 20 77 68 65 6e 20  61 20 70 72 6f 63 65 73  |or when a proces|
00001a10  73 20 69 73 20 72 75 6e  6e 69 6e 67 20 77 69 74  |s is running wit|
00001a20  68 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 27  |h.             '|
00001a30  6d 75 6c 74 69 74 61 73  6b 27 20 6d 6f 64 65 20  |multitask' mode |
00001a40  73 77 69 74 63 68 65 64  20 6f 66 66 2e 0a 0a 4d  |switched off...M|
00001a50  61 70 20 20 20 20 20 20  20 20 3a 20 46 72 6f 6d  |ap        : From|
00001a60  20 74 68 69 73 20 73 75  62 6d 65 6e 75 20 79 6f  | this submenu yo|
00001a70  75 20 63 61 6e 20 63 6c  61 69 6d 20 73 70 61 63  |u can claim spac|
00001a80  65 20 66 6f 72 20 61 20  6d 61 70 2c 20 77 69 74  |e for a map, wit|
00001a90  68 20 74 68 65 20 0a 20  20 20 20 20 20 20 20 20  |h the .         |
00001aa0  20 20 20 20 27 63 6c 61  69 6d 20 6d 61 70 27 20  |    'claim map' |
00001ab0  6f 70 74 69 6f 6e 2c 20  79 6f 75 20 63 61 6e 20  |option, you can |
00001ac0  66 72 65 65 20 74 68 65  20 73 70 61 63 65 20 66  |free the space f|
00001ad0  6f 72 20 74 68 69 73 20  6d 61 70 2c 20 77 69 74  |or this map, wit|
00001ae0  68 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 74  |h.             t|
00001af0  68 65 20 27 66 72 65 65  20 6d 61 70 27 20 6f 70  |he 'free map' op|
00001b00  74 69 6f 6e 2c 20 61 6e  64 20 79 6f 75 20 63 61  |tion, and you ca|
00001b10  6e 20 73 65 6c 65 63 74  20 74 6f 20 75 73 65 20  |n select to use |
00001b20  74 68 65 20 6d 61 70 20  77 68 65 6e 0a 20 20 20  |the map when.   |
00001b30  20 20 20 20 20 20 20 20  20 20 72 65 6e 64 65 72  |          render|
00001b40  69 6e 67 20 61 20 73 75  72 66 61 63 65 20 77 69  |ing a surface wi|
00001b50  74 68 20 74 68 65 20 27  75 73 65 20 6d 61 70 27  |th the 'use map'|
00001b60  20 6f 70 74 69 6f 6e 2e  0a 20 20 20 20 20 20 20  | option..       |
00001b70  20 20 20 20 20 20 54 68  65 20 27 63 6c 61 69 6d  |      The 'claim|
00001b80  20 6d 61 70 27 20 6f 70  74 69 6f 6e 20 74 72 69  | map' option tri|
00001b90  65 73 20 74 6f 20 61 6c  6c 6f 63 61 74 65 20 65  |es to allocate e|
00001ba0  6e 6f 75 67 68 20 73 70  61 63 65 20 66 72 6f 6d  |nough space from|
00001bb0  20 74 68 65 0a 20 20 20  20 20 20 20 20 20 20 20  | the.           |
00001bc0  20 20 66 72 65 65 20 70  6f 6f 6c 20 74 6f 20 68  |  free pool to h|
00001bd0  6f 6c 64 20 74 68 65 20  64 61 74 61 20 6f 66 20  |old the data of |
00001be0  61 20 70 6f 74 65 6e 74  69 61 6c 20 6d 61 70 2e  |a potential map.|
00001bf0  20 54 68 65 20 73 69 7a  65 20 6f 66 20 74 68 69  | The size of thi|
00001c00  73 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 61  |s.             a|
00001c10  6d 6f 75 6e 74 20 6f 66  20 73 70 61 63 65 20 64  |mount of space d|
00001c20  65 70 65 6e 64 73 20 6f  6e 20 74 68 65 20 72 65  |epends on the re|
00001c30  73 6f 6c 75 74 69 6f 6e  20 6f 66 20 74 68 65 20  |solution of the |
00001c40  73 75 72 66 61 63 65 20  79 6f 75 0a 20 20 20 20  |surface you.    |
00001c50  20 20 20 20 20 20 20 20  20 77 61 6e 74 20 74 6f  |         want to|
00001c60  20 72 65 6e 64 65 72 20  28 77 68 69 63 68 20 69  | render (which i|
00001c70  73 20 61 6c 73 6f 20 74  68 65 20 72 65 73 6f 6c  |s also the resol|
00001c80  75 74 69 6f 6e 20 6f 66  20 74 68 65 20 6d 61 70  |ution of the map|
00001c90  29 2e 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |)..             |
00001ca0  57 68 65 6e 20 74 68 65  72 65 20 69 73 6e 27 74  |When there isn't|
00001cb0  20 65 6e 6f 75 67 68 20  73 70 61 63 65 20 6c 65  | enough space le|
00001cc0  66 74 2c 20 74 68 65 20  70 72 6f 67 72 61 6d 20  |ft, the program |
00001cd0  77 69 6c 6c 20 72 65 70  6f 72 74 20 61 6e 0a 20  |will report an. |
00001ce0  20 20 20 20 20 20 20 20  20 20 20 20 65 72 72 6f  |            erro|
00001cf0  72 20 61 6e 64 20 77 69  6c 6c 20 73 68 6f 77 20  |r and will show |
00001d00  74 68 65 20 61 6d 6f 75  6e 74 20 6f 66 20 66 72  |the amount of fr|
00001d10  65 65 20 73 70 61 63 65  20 28 69 6e 20 4b 62 29  |ee space (in Kb)|
00001d20  20 72 65 71 75 69 72 65  64 2e 0a 20 20 20 20 20  | required..     |
00001d30  20 20 20 20 20 20 20 20  54 68 65 20 75 73 65 72  |        The user|
00001d40  20 63 61 6e 20 74 68 65  6e 20 74 72 79 20 74 6f  | can then try to|
00001d50  20 66 72 65 65 20 73 6f  6d 65 20 6d 65 6d 6f 72  | free some memor|
00001d60  79 20 65 6c 73 65 77 68  65 72 65 20 75 73 69 6e  |y elsewhere usin|
00001d70  67 20 74 68 65 0a 20 20  20 20 20 20 20 20 20 20  |g the.          |
00001d80  20 20 20 54 61 73 6b 20  4d 61 6e 61 67 65 72 21  |   Task Manager!|
00001d90  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 54 68  |.             Th|
00001da0  65 20 27 66 72 65 65 20  6d 61 70 27 20 6f 70 74  |e 'free map' opt|
00001db0  69 6f 6e 20 6a 75 73 74  20 66 72 65 65 73 20 74  |ion just frees t|
00001dc0  68 65 20 73 70 61 63 65  20 61 6c 6c 6f 63 61 74  |he space allocat|
00001dd0  65 64 20 62 79 20 27 63  6c 61 69 6d 0a 20 20 20  |ed by 'claim.   |
00001de0  20 20 20 20 20 20 20 20  20 20 6d 61 70 27 2c 20  |          map', |
00001df0  72 65 74 75 72 6e 69 6e  67 20 74 68 65 20 6d 65  |returning the me|
00001e00  6d 6f 72 79 20 74 6f 20  74 68 65 20 57 49 4d 50  |mory to the WIMP|
00001e10  27 73 20 66 72 65 65 20  70 6f 6f 6c 2e 0a 20 20  |'s free pool..  |
00001e20  20 20 20 20 20 20 20 20  20 20 20 54 68 65 20 27  |           The '|
00001e30  75 73 65 20 6d 61 70 27  20 6f 70 74 69 6f 6e 20  |use map' option |
00001e40  6d 75 73 74 20 62 65 20  74 6f 67 67 6c 65 64 20  |must be toggled |
00001e50  6f 6e 20 69 66 20 79 6f  75 20 77 61 6e 74 20 74  |on if you want t|
00001e60  68 65 20 70 72 6f 67 72  61 6d 0a 20 20 20 20 20  |he program.     |
00001e70  20 20 20 20 20 20 20 20  74 6f 20 75 73 65 20 74  |        to use t|
00001e80  68 65 20 6d 61 70 20 77  68 65 6e 20 69 74 20 69  |he map when it i|
00001e90  73 20 72 65 6e 64 65 72  69 6e 67 20 61 6e 20 69  |s rendering an i|
00001ea0  6d 61 67 65 2e 0a 20 20  20 20 20 20 20 20 20 20  |mage..          |
00001eb0  20 20 20 4e 6f 74 65 20  74 68 61 74 20 77 68 65  |   Note that whe|
00001ec0  6e 20 6e 6f 20 6d 61 70  20 69 73 20 63 6c 61 69  |n no map is clai|
00001ed0  6d 65 64 2c 20 61 6c 6c  20 74 68 65 20 73 75 62  |med, all the sub|
00001ee0  6d 65 6e 75 2d 6f 70 74  69 6f 6e 73 20 0a 20 20  |menu-options .  |
00001ef0  20 20 20 20 20 20 20 20  20 20 20 63 6f 6e 63 65  |           conce|
00001f00  72 6e 69 6e 67 20 74 68  65 20 6d 61 70 20 61 72  |rning the map ar|
00001f10  65 20 27 73 68 61 64 65  64 27 2c 20 69 65 2e 20  |e 'shaded', ie. |
00001f20  74 68 65 79 20 63 61 6e  27 74 20 62 65 20 73 65  |they can't be se|
00001f30  6c 65 63 74 65 64 2c 0a  20 20 20 20 20 20 20 20  |lected,.        |
00001f40  20 20 20 20 20 62 65 63  61 75 73 65 20 61 74 20  |     because at |
00001f50  74 68 61 74 20 70 6f 69  6e 74 2c 20 74 68 65 79  |that point, they|
00001f60  20 73 69 6d 70 6c 79 20  61 72 65 20 6f 66 20 6e  | simply are of n|
00001f70  6f 20 75 73 65 21 20 54  68 65 73 65 20 61 72 65  |o use! These are|
00001f80  3a 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 27  |:.             '|
00001f90  73 61 76 65 20 6d 61 70  27 2c 20 27 63 61 6c 63  |save map', 'calc|
00001fa0  75 6c 61 74 65 27 2c 20  27 66 72 65 65 20 6d 61  |ulate', 'free ma|
00001fb0  70 27 20 61 6e 64 20 27  75 73 65 20 6d 61 70 27  |p' and 'use map'|
00001fc0  2e 20 59 6f 75 20 77 69  6c 6c 20 61 6c 73 6f 0a  |. You will also.|
00001fd0  20 20 20 20 20 20 20 20  20 20 20 20 20 67 65 74  |             get|
00001fe0  20 61 6e 20 65 72 72 6f  72 20 77 68 65 6e 20 79  | an error when y|
00001ff0  6f 75 20 77 61 6e 74 20  74 6f 20 6c 6f 61 64 20  |ou want to load |
00002000  61 20 6d 61 70 20 66 69  6c 65 20 61 6e 64 20 79  |a map file and y|
00002010  6f 75 20 68 61 76 65 6e  27 74 0a 20 20 20 20 20  |ou haven't.     |
00002020  20 20 20 20 20 20 20 20  63 6c 61 69 6d 65 64 20  |        claimed |
00002030  6d 61 70 20 73 70 61 63  65 2e 0a 0a 0a 49 74 20  |map space....It |
00002040  69 73 20 70 6f 73 73 69  62 6c 65 20 74 6f 20 61  |is possible to a|
00002050  62 6f 72 74 20 61 20 70  72 6f 63 65 73 73 2c 20  |bort a process, |
00002060  71 75 69 74 20 46 72 61  63 54 72 61 63 65 2c 20  |quit FracTrace, |
00002070  61 6e 64 20 72 65 73 75  6d 65 20 74 68 65 20 73  |and resume the s|
00002080  61 6d 65 20 0a 70 72 6f  63 65 73 73 20 61 74 20  |ame .process at |
00002090  61 20 6c 61 74 65 72 20  64 61 74 65 2e 20 54 68  |a later date. Th|
000020a0  69 73 20 69 73 20 64 6f  6e 65 20 62 79 20 77 72  |is is done by wr|
000020b0  69 74 69 6e 67 20 64 6f  77 6e 20 74 68 65 20 6c  |iting down the l|
000020c0  69 6e 65 2d 6e 75 6d 62  65 72 20 61 74 20 0a 77  |ine-number at .w|
000020d0  68 69 63 68 20 79 6f 75  20 61 62 6f 72 74 20 74  |hich you abort t|
000020e0  68 65 20 70 72 6f 63 65  73 73 2c 20 61 6e 64 20  |he process, and |
000020f0  65 6e 74 65 72 69 6e 67  20 74 68 69 73 20 6c 69  |entering this li|
00002100  6e 65 2d 6e 75 6d 62 65  72 20 69 6e 20 74 68 65  |ne-number in the|
00002110  20 27 72 65 73 75 6d 65  27 0a 6f 70 74 69 6f 6e  | 'resume'.option|
00002120  2d 69 63 6f 6e 20 69 6e  20 74 68 65 20 43 6f 6e  |-icon in the Con|
00002130  74 72 6f 6c 20 50 61 6e  65 6c 20 77 69 74 68 20  |trol Panel with |
00002140  79 6f 75 72 20 6e 65 78  74 20 46 72 61 63 54 72  |your next FracTr|
00002150  61 63 65 20 73 65 73 73  69 6f 6e 2e 20 57 68 65  |ace session. Whe|
00002160  6e 20 79 6f 75 0a 73 65  74 20 74 68 69 73 20 6f  |n you.set this o|
00002170  70 74 69 6f 6e 20 61 6e  64 20 73 75 62 73 65 71  |ption and subseq|
00002180  75 65 6e 74 6c 79 20 73  74 61 72 74 20 74 68 65  |uently start the|
00002190  20 72 61 79 74 72 61 63  69 6e 67 20 70 72 6f 63  | raytracing proc|
000021a0  65 73 73 2c 20 69 74 20  77 69 6c 6c 20 72 65 73  |ess, it will res|
000021b0  75 6d 65 0a 61 74 20 74  68 65 20 6c 69 6e 65 2d  |ume.at the line-|
000021c0  6e 75 6d 62 65 72 20 79  6f 75 20 65 6e 74 65 72  |number you enter|
000021d0  65 64 20 69 6e 20 74 68  65 20 69 63 6f 6e 21 0a  |ed in the icon!.|
000021e0  0a 49 66 20 79 6f 75 20  61 72 65 20 72 65 6e 64  |.If you are rend|
000021f0  65 72 69 6e 67 20 6d 75  6c 74 69 70 6c 65 20 66  |ering multiple f|
00002200  72 61 6d 65 73 20 61 6e  64 20 77 61 6e 74 20 61  |rames and want a|
00002210  20 6e 65 77 20 70 6f 74  65 6e 74 69 61 6c 20 6d  | new potential m|
00002220  61 70 20 74 6f 20 62 65  20 0a 72 65 63 61 6c 63  |ap to be .recalc|
00002230  75 6c 61 74 65 64 20 66  6f 72 20 65 61 63 68 20  |ulated for each |
00002240  64 69 66 66 65 72 65 6e  74 20 66 72 61 6d 65 2c  |different frame,|
00002250  20 79 6f 75 20 63 61 6e  20 64 6f 20 73 6f 20 62  | you can do so b|
00002260  79 20 73 65 74 74 69 6e  67 20 74 68 65 0a 27 72  |y setting the.'r|
00002270  65 63 61 6c 63 75 6c 61  74 65 27 20 6f 70 74 69  |ecalculate' opti|
00002280  6f 6e 20 69 6e 20 74 68  65 20 43 6f 6e 74 72 6f  |on in the Contro|
00002290  6c 20 50 61 6e 65 6c 21  0a 0a 54 68 65 73 65 20  |l Panel!..These |
000022a0  65 78 70 6c 61 6e 61 74  69 6f 6e 73 20 6d 61 79  |explanations may|
000022b0  20 73 65 65 6d 20 27 63  72 79 70 74 69 63 27 20  | seem 'cryptic' |
000022c0  28 61 6e 64 20 73 6f 20  74 68 65 79 20 61 72 65  |(and so they are|
000022d0  21 29 2c 20 62 75 74 20  74 68 65 20 62 65 73 74  |!), but the best|
000022e0  20 77 61 79 0a 6f 66 20  67 65 74 74 69 6e 67 20  | way.of getting |
000022f0  74 6f 20 6b 6e 6f 77 20  46 72 61 63 54 72 61 63  |to know FracTrac|
00002300  65 20 69 73 20 62 79 20  65 78 70 65 72 69 6d 65  |e is by experime|
00002310  6e 74 69 6e 67 20 77 69  74 68 20 74 68 65 20 64  |nting with the d|
00002320  65 6d 6f 2d 66 69 6c 65  73 2c 0a 61 6e 64 20 74  |emo-files,.and t|
00002330  72 79 69 6e 67 20 74 6f  20 6d 61 6b 65 20 73 6f  |rying to make so|
00002340  6d 65 20 76 61 72 69 61  74 69 6f 6e 73 2e 0a 0a  |me variations...|
00002350  0a 48 6f 77 20 74 6f 20  75 73 65 20 46 54 53 3f  |.How to use FTS?|
00002360  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00002370  0a 41 6e 20 46 54 53 20  66 69 6c 65 20 69 73 20  |.An FTS file is |
00002380  6a 75 73 74 20 61 20 74  65 78 74 20 28 41 53 43  |just a text (ASC|
00002390  49 49 29 20 66 69 6c 65  20 61 73 20 63 61 6e 20  |II) file as can |
000023a0  62 65 20 6d 61 64 65 20  77 69 74 68 20 21 45 64  |be made with !Ed|
000023b0  69 74 2e 0a 57 68 65 6e  20 79 6f 75 20 64 72 61  |it..When you dra|
000023c0  67 20 61 6e 20 46 54 53  20 66 69 6c 65 20 6f 76  |g an FTS file ov|
000023d0  65 72 20 6f 6e 65 20 6f  66 20 74 68 65 20 46 72  |er one of the Fr|
000023e0  61 63 54 72 61 63 65 20  77 69 6e 64 6f 77 73 20  |acTrace windows |
000023f0  69 74 20 77 69 6c 6c 20  62 65 0a 6c 6f 61 64 65  |it will be.loade|
00002400  64 20 28 70 72 6f 76 69  64 65 64 20 69 74 20 69  |d (provided it i|
00002410  73 6e 27 74 20 6c 6f 6e  67 65 72 20 74 68 61 6e  |sn't longer than|
00002420  20 34 30 30 30 20 62 79  74 65 73 29 2c 20 61 6e  | 4000 bytes), an|
00002430  64 20 2d 77 69 74 68 20  74 68 65 20 64 65 66 61  |d -with the defa|
00002440  75 6c 74 0a 63 6f 6e 66  69 67 75 72 61 74 69 6f  |ult.configuratio|
00002450  6e 20 73 65 74 74 69 6e  67 73 2d 20 77 69 6c 6c  |n settings- will|
00002460  20 62 65 20 70 61 72 73  65 64 20 61 75 74 6f 6d  | be parsed autom|
00002470  61 74 69 63 61 6c 6c 79  2e 20 57 68 65 6e 20 74  |atically. When t|
00002480  68 65 20 27 61 75 74 6f  2d 70 61 72 73 65 27 0a  |he 'auto-parse'.|
00002490  6f 70 74 69 6f 6e 20 69  73 20 73 77 69 74 63 68  |option is switch|
000024a0  65 64 20 6f 66 66 2c 20  70 61 72 73 69 6e 67 20  |ed off, parsing |
000024b0  63 61 6e 20 65 78 70 6c  69 63 69 74 6c 79 20 62  |can explicitly b|
000024c0  65 20 73 74 61 72 74 65  64 20 62 79 20 73 65 6c  |e started by sel|
000024d0  65 63 74 69 6e 67 20 0a  27 70 61 72 73 65 27 20  |ecting .'parse' |
000024e0  66 72 6f 6d 20 74 68 65  20 70 72 6f 63 65 73 73  |from the process|
000024f0  20 73 75 62 6d 65 6e 75  2e 0a 41 6e 20 65 78 70  | submenu..An exp|
00002500  6c 61 6e 61 74 69 6f 6e  20 6f 66 20 65 61 63 68  |lanation of each|
00002510  20 6f 66 20 74 68 65 20  63 6f 6d 6d 61 6e 64 73  | of the commands|
00002520  20 70 72 6f 76 69 64 65  64 20 62 79 20 46 54 53  | provided by FTS|
00002530  20 69 73 20 67 69 76 65  6e 20 69 6e 20 74 68 65  | is given in the|
00002540  0a 66 69 6c 65 20 27 46  54 53 2d 44 65 66 27 2e  |.file 'FTS-Def'.|
00002550  0a 0a 0a 43 6f 6d 6d 65  6e 74 73 20 6f 66 20 74  |...Comments of t|
00002560  68 65 20 61 75 74 68 6f  72 3a 0a 2d 2d 2d 2d 2d  |he author:.-----|
00002570  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00002580  2d 2d 0a 54 68 69 73 20  76 65 72 73 69 6f 6e 20  |--.This version |
00002590  6f 66 20 46 72 61 63 54  72 61 63 65 20 63 65 72  |of FracTrace cer|
000025a0  74 61 69 6e 6c 79 20 69  73 6e 27 74 20 74 68 65  |tainly isn't the|
000025b0  20 6c 61 73 74 20 74 6f  20 62 65 20 72 65 6c 65  | last to be rele|
000025c0  61 73 65 64 2e 20 41 73  20 49 20 28 6f 72 0a 79  |ased. As I (or.y|
000025d0  6f 75 29 20 65 6e 63 6f  75 6e 74 65 72 20 62 75  |ou) encounter bu|
000025e0  67 73 20 6f 72 20 27 69  6c 6c 20 62 65 68 61 76  |gs or 'ill behav|
000025f0  69 6f 75 72 27 20 69 6e  20 74 68 65 20 70 72 6f  |iour' in the pro|
00002600  67 72 61 6d 2c 20 49 20  77 69 6c 6c 20 74 72 79  |gram, I will try|
00002610  20 74 6f 20 66 69 78 20  0a 74 68 65 6d 20 69 6e  | to fix .them in|
00002620  20 66 75 74 75 72 65 20  76 65 72 73 69 6f 6e 73  | future versions|
00002630  20 61 6e 64 20 70 72 6f  76 69 64 65 20 79 6f 75  | and provide you|
00002640  20 77 69 74 68 20 74 68  65 20 75 70 64 61 74 65  | with the update|
00002650  64 20 72 65 6c 65 61 73  65 73 21 0a 49 66 20 79  |d releases!.If y|
00002660  6f 75 20 66 69 6e 64 20  61 6e 79 20 62 75 67 73  |ou find any bugs|
00002670  2c 20 68 61 76 65 20 61  6e 79 20 63 6f 6d 6d 65  |, have any comme|
00002680  6e 74 73 20 6f 72 20 69  64 65 61 73 20 79 6f 75  |nts or ideas you|
00002690  27 64 20 6c 69 6b 65 20  74 6f 20 73 65 65 20 0a  |'d like to see .|
000026a0  69 6d 70 6c 65 6d 65 6e  74 65 64 2c 20 77 72 69  |implemented, wri|
000026b0  74 65 20 74 6f 20 74 68  65 20 61 64 64 72 65 73  |te to the addres|
000026c0  73 20 62 65 6c 6f 77 2e  2e 2e 0a 0a 41 64 64 72  |s below.....Addr|
000026d0  65 73 73 20 3a 20 20 20  20 20 20 20 20 20 20 43  |ess :          C|
000026e0  61 72 6c 20 44 65 63 6c  65 72 63 6b 0a 20 20 20  |arl Declerck.   |
000026f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002700  56 72 69 6a 67 65 77 65  69 64 65 73 74 72 61 61  |Vrijgeweidestraa|
00002710  74 20 32 34 0a 20 20 20  20 20 20 20 20 20 20 20  |t 24.           |
00002720  20 20 20 20 20 20 20 20  42 2d 32 38 30 30 20 4d  |        B-2800 M|
00002730  65 63 68 65 6c 65 6e 0a  20 20 20 20 20 20 20 20  |echelen.        |
00002740  20 20 20 20 20 20 20 20  20 20 20 42 65 6c 67 69  |           Belgi|
00002750  75 6d 0a 50 68 6f 6e 65  20 20 20 3a 20 20 20 20  |um.Phone   :    |
00002760  20 20 20 20 20 20 30 31  35 2d 34 31 2e 39 36 2e  |      015-41.96.|
00002770  34 39 0a 0a 49 20 63 61  6e 20 61 6c 73 6f 20 62  |49..I can also b|
00002780  65 20 72 65 61 63 68 65  64 20 61 74 20 41 72 63  |e reached at Arc|
00002790  68 69 76 65 20 42 42 53  20 61 73 3a 20 43 61 72  |hive BBS as: Car|
000027a0  6c 20 44 65 63 6c 65 72  63 6b 20 28 23 31 30 37  |l Declerck (#107|
000027b0  31 29 2e 0a 49 66 20 79  6f 75 20 6d 61 69 6c 20  |1)..If you mail |
000027c0  61 6e 79 20 63 6f 6d 6d  65 6e 74 73 2c 20 70 6c  |any comments, pl|
000027d0  65 61 73 65 20 61 6c 6c  6f 77 20 61 62 6f 75 74  |ease allow about|
000027e0  20 6f 6e 65 20 77 65 65  6b 20 66 6f 72 20 61 20  | one week for a |
000027f0  72 65 70 6c 79 21 0a 0a  0a 20 20 20 20 20 20 20  |reply!...       |
00002800  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00002830  20 20 20 20 20 20 20 43  61 72 6c 20 44 65 63 6c  |       Carl Decl|
00002840  65 72 63 6b 2e 0a                                 |erck..|
00002846