                          'Look'n See'
                  Version 0.95 of 21.07.1995
                  Documentation of 17.07.1995
                  English version of 27.1.1996

         "Wait a minute - I'll really show you something..."

                                                      Introduction
------------------------------------------------------------------

0.01 The author speaks

Dear reader!  A wonderfully  translated manual  of a high literaly 
quality is awaiting you.  Don't get embarrassed of the bad English
you are  confronted  with in this  first chapter.  This chapter is
written by me,  Reiner Rosin, the original author of 'Zeig's mir',
which is the German counterpart of 'Look'n see'.  The rest of this
manual was  translated  by Peter West,  whom I'd like to thank for
the great job he did from the bottom of my heart.
Please don't  get confused about  some details in this manual that
you don't understand.  Peter translated the text  very thoroughly,
so that many humorous  comments still appear in it,  although they
may not  be understandable  if one  doesn't know  about the inter-
relations.

0.1 Introduction
Well, I've done it. As with every new release, here too everything 
went wrong just before the deadline. One would have thought that 9 
months would be enough not only to write a new program version but 
also to revise the documentation, hypertext,  module documentation 
and everything else nice and peacefully. That obviously wasn't the 
case, which is why this time too the last couple of weeks proved a 
bit of a slog.

Was it worth it?  I think so.  Those who know  earlier versions of 
'Zeig's mir'  (the German original of this program),  will look in 
vain for any sensational changes  this time round,  simply because 
nothing earth-shattering  has occurred to me  that could have been
incorporated.  Still there are quite a number of unpretentious but 
extemely useful extensions and improvements.

There have also been developments  in the modules department.  Two 
new programmers  have made the leap  and joined the honoured ranks 
of the 'Zeig's mir'/'Look'n See' module authors club. 

Last  but  not  least  there is now an English language version of 
'Zeig's mir'  that answers to the name 'Look'n See',  with support 
for the program in the U.K.

That's the positive side,  but there is also something negative to 
report. From this version on the registration fee for 'Zeig's mir' 
is now DM 10.- more than previously. This will only be of interest 
to owners of the German version; if they are registered users they 
will find further information in the enclosed UPDATE.TXT.

I should perhaps explain why this release bears the version number 
0.95.  Actually, this should be self-evident: It is an allusion to 
'Windows 95'.  If the chronological numbering of the beta-versions 
was followed, this version  should really be called 0.33 or 0.34 - 
the development history of 'Zeig's mir' could even justify a V 3.5 
version number, or something like that.  I am sure  that one could 
draw some very interesting psychological conclusions from the fact 
that the number nevertheless is 0.95. But one can also leave it be 
and that is exactly what I'll do now.


0.2 Quick start
You don't like reading long instruction manuals? You prefer to use 
a program intuitively? I like that approach. However, you will not 
discover all the options offered by 'Look'n See' this way, so I'll 
let you into the secret of which chapters of the documentation you 
definitely ought to read:


  1.4.     Installation
  3.2.1.   'Open...'
  5.1.4.   The [Alternate] key
  6.       Things worth knowing about 'Look'n See'.
  7.       The modules
  7.1.     Loading the modules


0.3. New in Version 0.95
Bug fixes:
- Adaptation for MagiCMac.
- More memory made available for loading QFAX faxes.
- GEM images sometimes saved with mangled left edge.
- Numerous further small changes.

Alterations:
- Closing of multiple windows now works markedly faster.
- Internal font selector eliminated due to xFSL/UFSL support.
- 3D-look adapted to MagiC3,  and can also be switched off (due to 
  MagiC 3.0 as well).
- Image output on a LaserJet/DeskJet is now adjustable in position.
- The AES's  iconifying function too  can now be triggered  with a 
  keyboard shortcut or via the window 'closer'.
- Marking of words in a text with a double-click.
- Blocks can now also be marked in sound samples.

Innovations:
- Sample output via modules,  which permits adaptation to specific 
  output hardware.
- Modules can now make use of savable parameters.
- The module concept  has been completely revised,  giving shorter 
  loading times and smaller memory allocations.
- Complete AV-protocol incorporated, making for better cooperation 
  with modern desktops (Gemini, Ease, Thing).
- Drag&Drop for MTOS and MagiC from V3.0
- Other new protocols:  SNAP-protocol,  Font-protocol,  new  ICFS-
  features (snapping, double-size icons).
- Up to 10 frequently needed files can be called via shortcuts.  
- Support for external font-selectors  following the xFSL standard 
  (Calvino, HuGo!) or UFSL as well.
- At last a separate export interface.
- For sound samples without a header,  the sample type  (signed or
  unsigned) is established by analysing the data.
- A double-click on blocks marked in pictures shows their size and 
  allows numeric changes to be made.
- When modules take some time to execute, a progress bar shows how 
  much of the task has been accomplished.

                                                           General
------------------------------------------------------------------
1. General
1.1. A few words of introduction
If everything had gone as planned, then the new  German version of 
Zeig's Mir'  would have been published on 6.7.95.  That would have 
been exactly two years to the day since the first beta version was 
released to the beta-testers. Unfortunately that was not possible, 
so that publication is taking place  a little later.  After such a 
long time  it is hard not just to keep to planned deadlines  while  
finding  and incorporating  new features, but also  to formulate a 
brilliantly witty introduction (such as people expect from me). So 
this time I will simply do without with it. Too bad!


1.2. File types supported
A file-viewer  can be as good  as you like - but if it can not  do 
anything  with  the files  of your  favourite painting program  or 
whatever else you would like to view,  then it is of no use to you 
personally.  That is why the technical part  of this documentation 
begins with a list of the file types supported by 'Look'n See':

1.2.1. (Monochrome) graphics:
IMG       GEM images
PAC       STaD graphics, packed, 640*400 pixels
PCB       Printed circuit layouts from Mega-PCB and PCB-Edit [1]*)
CRG       Calamus raster-graphics
001,002.. Fax-files from ZFAX (PC)
F01,F02.. Fax-files from QFAX and Coma
PRN       Output files of the 'In-file'-driver of Papyrus
PAGE.IMG  Output files of the 'To disk'-driver of Calamus
???       Quicklink faxes
IFX       Faxes from Teleoffice and Junior-Office

*): You will find the footnotes right at the end of this text.

Note: The file extensions quoted are only meant as an example.  As 
far as it can, 'Look'n See' does not take its information from the 
program names,  but analyses  the data structure  to establish the 
format of a file.

1.2.2. Colour pictures
'Look'n See' can load most of the colour picture formats only with 
a corresponding import module.  Suitable modules are available, of 
course, for all the important formats (GIF, TIF, JPEG, Targa, BMP, 
XIMG, PCX, IFF).

1.2.3. Texts
There isn't really that much to say about text files, except maybe 
'Hallo text, how are you?...',  but that would be trivial.  Not so 
trivial  is the fact  that  'Look'n See'  can  recognise  reliably  
whether the file it is presented with is a text or not. [2]

1.2.4. Hex-dumps

Anything that 'Look'n See' cannnot recognise unambiguously will be 
displayed as a hex-dump.

1.2.5. Samples
My quite personal opinion:  A file-viewer that cannot replay sound 
samples deserves to be dragged before a tribunal. 'Look'n See', of 
course, has comprehensive sample-playing support.  [3]
SMP       Totosam format (without header)
HSN       Crazy-Sound samples
SMP       Sample-Wizard format

1.2.6. Resource files
Resource files are loaded by 'Look'n See'  and displayed correctly 
as long as their length does not exceed 64 KB, and they contain no 
colour icons.

1.2.7. Fonts

1.2.7.1. GDOS fonts
GDOS fonts can be loaded both in the Intel as well as the Motorola 
format.  Type recognition  is naturally a little shaky since there 
is no fixed identifier present in the header.

1.2.7.2. Calamus fonts
Unlicensed Calamus fonts can be displayed without problems. Though 
'Look'n See'  could equally well load registered (licensed) fonts, 
I have foregone this feature for legal reasons.

1.2.8. GEM metafiles
GEM metafiles can also be loaded in versions commencing with V0.28 
but support on the part of 'Look'n See' is still rather patchy. It 
may at times lead to crashes and other defective behaviour.

1.2.9. Virtual files
Here  these instructions  become really interesting  for the first 
time.  'Look'n See'  can also display files that are so large that 
they do not fit into the  available memory.  Such files are called 
'virtual files'  in these instructions.  This points less  to them  
apparently not being  present (a look in the directory  would soon 
prove the opposite) but more to the fact  that they are not really 
loaded.  'Look'n See'  rather loads  only a part of the file  into 
memory at any one time  and displays that.  If the window contents 
are scrolled  then the new portion that is to be displayed will be 
loaded in.

1.2.10. Other formats
'Look'n See', just like GEM-View, also has a module interface [4].
That makes it possible  for anyone  with the required abilities to 
themself incorporate any file formats of their choice into 'Look'n 
See'. In particular a large part of the work needed to load colour 
pictures  and convert them  to the  current  screen resolution  is 
accomplished by modules.


1.3. Status
'Look'n See' is shareware. That means that you may install and use 
it without hesitation to begin with. If, contrary to expectations, 
it doesn't appeal to you, then simply delete it again. Only if you 
find it good enough  to deserve a lasting place  on your hard disk 
(or - if you don't have one - want to keep on using it from floppy
disks) then you have to pay a (relatively small) amount to me, the 
program author. [5]

For the convenience of U.K. and other non-German users, support is 
available in the U.K. from Joe Connor - see README.TXT.

1.3.1. Shareware restrictions
Experience has shown  that the payment of shareware fees  is often 
forgotten easily.  To refresh  your memory  a little, 'Look'n See' 
will occasionally (every other time it is run, on average)  remind 
you with decorous inserts in the data window that you have not yet 
paid.  For colour pictures  displayed in colour resolutions,  only 
the first picture will be coloured,  the second and following ones 
appearing only in greyscale. There are no other restrictions.

1.3.2. Registration
'Look'n See' is made up to a full version  via a personal key that 
you can only obtain  from me  (or through my representative).  The 
snag with this is that you will naturally  only get this key after 
you have paid the shareware fee.  The way you do this,  whether by 
bank transfer, cheque, letter with cash or Pony Express I'll leave 
to you.

The much-quoted shareware fee amounts to 40.- DM,  or 20 sterling 
or US $25 if dealing with my U.K. representative.  As soon as this 
amount reaches  one of us, a suitable key  based on your name  and 
address (which naturally have to be included with the application) 
will be generated and passed on to you.

The shareware fee  has been kept low  deliberately  so that really 
anyone can register. If you can afford it and find 'Look'n See' is 
worth more, then you may pay a higher amount  with pleasure.  Some 
extra reward intended for your favourite module authors would also 
not go amiss (they and their wares are listed in LNC_MDL.TXT/HYP).

You can obtain the key in one of four ways:

- By Email, if you include your Email address.  Most convenient is
  representation  in the MausNet,  but Internet and Fido addresses 
  are also suitable.

- By telephone, as long as you don't call too early in the day. If 
  you want to be on the safe side,  please wait until 9.30 a.m. at 
  least.

- By ordinary mail, as long as you have included (suitable) stamps 
  or an International Reply Coupon with your registration request.
  If you also include a blank formatted disk, or an additional 3.- 
  DM (1.50), you will receive the current program version. Please 
  think about including  extra return postage in that case, or two 
  more IRCs. 'Suitable stamps' above mean German stamps if writing 
  to Germany, U.K. stamps if to Joe Connor.

I would advise you  that payment  by bank transfer  needs a lot of 
patience.  I only get account statements every two weeks, and then 
have to first reconcile the receipts with the registration request 
forms (the transfer slips usually do not contain addresses).  So a 
payment by   V- or Euro-cheque is faster, easier and equally safe. 
The above applies to registration fees paid directly to the author 
in Germany;  for those paying  via Joe Connor,  cheques, postal or 
money orders  (International MOs from outside the U.K.) or cash in 
pounds sterling or U.S. dollars are acceptable.

The 'Look'n See' shareware restrictions are removed when the name, 
address and personal key are input into the dialog that is reached 
by clicking on  'Registration...' in the  'Options' menu  (written 
from now on as 'Options' -> 'Registration...', with similar syntax  
for other mouse selections) .

1.3.3. The author
You can find out who is responsible for creating 'Look'n See', and 
where to send the shareware payment, in section 9.1. 'The author'.

1.3.4. Distribution
'Look'n See'  may, and should,  be distributed  in any way you can 
think of. The unregistered version may be freely copied and passed 
on.  Filing in non-commercial mailbox systems  and distribution on 
PD discs is also permitted.  For the latter there is, however, the 
restrictions that media prices may not exceed 10.- DM (4.00).

Inclusion of 'Look'n See' on CDs is not permitted without explicit 
written permission of the author!

The following applies to all forms of distribution:  All files may 
only be passed on in their original form and grouping!  Changes to 
individual  or all  files, or the deletion of individual files, is 
not permitted!


1.4. Installation
Use of 'Look'n See' is not possible on computers  with 512 KB RAM.
With 1 MB of memory it should be installed only as a program, from 
2 MB up it may also be used as a desk accessory ('DA').

On principle, 'Look'n See' can run  on all computers using the TOS 
operating system. This includes all Ataris in the ST/STE/TT series 
and Falcons, as well as the  Apple Macintosh  running the MagicMac 
operating system. No problems have been reported with any graphics 
cards, processor accelerators, PC-emulators or other supplementary 
components.

'Look'n See'  should be usable  with  all TOS versions, as well as 
with  Mag!X  and  MultiTOS.  The use of TOS 1.00  and 1.02  is not 
recommended on principle (this applies with all programs).


The following text assumes that you have a hard disk. One can also 
use 'Look'n See' with floppy drives only but as I find this rather 
digressive I won't go into this further.  (See the README.1ST file
about unpacking and using 'Look'n See' without a hard disk.)

1.4.1. PRG
Simply copy the file LOOKNSEE.PRG to the desired directory on your 
hard disk.

1.4.2. ACC
With TOS 2.06 and above, you only need to copy LOOKNSEE.PRG to the
root directory  of your boot partition (usually C:) and rename the 
'.PRG' extension to '.ACC'  (by using 'Show Information...' in the 
'File' menu of the desktop, for instance). If using a utility that 
permits loading of desk accessories  from a folder, then  the file 
has to be placed in that folder, of course.  

With earlier TOS versions (such as 1.04)  the accessory won't load 
properly from the root directory, but if you have a DA loader such 
as 'Chameleon' in the root directory, you can load in 'Look'n See' 
later, when it is required  for viewing something.  In view of the 
amount of memory  the program  (and its optional modules)  occupy, 
this is the preferable method of working anyway, specially on 2 MB 
machines.  Note that Chameleon will NOT unload 'Look'n See' again,
so to free up the memory you will have to perform a reset.

Except with Multi-TOS the maximum number of accessories is limited 
to six with all current TOS versions.  If you already have six DAs 
installed then you have to deactivate one of them.

1.4.3. Modules
The  MODULES.LNC  folder, with its contents, can be  copied to any 
desired partition.

1.4.4. Set 'Options' parameters
Start up  'Look'n See', either by double-clicking on  LOOKNSEE.PRG 
from the desktop, or (if you have installed it as a DA) by a click 
in the menu-bar  ('Desk' menu at left,  'Look'n See V0.95' item). 
Once the program has loaded,  select each entry  in the  'Options' 
menu in turn  and set the various parameters  to suit your wishes.
With items you are not clear about, leave the original settings or 
consult this text further on.  It is specially important to select 
the correct printer, and to set the path to the MODULES.LNC folder 
in 'Modules list...': Click on the field next to 'Module path' and 
when the  file selector appears, find the folder  on the drive you 
copied it to, open it and click on 'OK'. Check that the right path 
now appears in the field. Finally save all the selections you have 
made by clicking on 'Save options'. An 'INF' file will be saved to 
your root drive partition (or floppy; write-protection must be off 
for this - once written, protect both program disks!).

1.4.5. Installation as a file-viewer
'Look'n See' is particularly useful  if it is installed as a file-
viewer for all, or only some, types of file.  The procedure varies 
according to the desktop being used - if in doubt you will have to 
consult the relevant documentation. Naturally it is also important 
that after installation the desktop function 'Save Desktop' or any 
similar equivalent ('Save options'...) is called.

1.4.5.1. Atari desktop
On Atari's original desktop you can only install programs.  With a 
single click  select the 'LOOKNSEE' program icon or file, click on  
'Install Application...'  and type in  the desired  file extension 
for which you want to install 'Look'n See'. If you want to install 
'Look'n See'  for ALL files,  then you have to  type in  an easily 
recognisable extension temporarily (say 'XXX'), use 'Save Desktop' 
and later load the  NEWDESK.INF  or  DESKTOP.INF file  into a text 
editor and edit it manually to change the 'XXX' to a '*'; you also 
have make sure that the 'LOOKNSEE' entry lies after all other '#G' 
lines.  This change is required so that one can continue  to start 
programs from the desktop, not pass them to 'Look'n See'.

1.4.5.2. Ease
The corresponding menu entry is called  'Applikationen...'  in the 
German version, 'Applications...' in the English.  You can install 
both the .PRG  as well as the .ACC  version,  and install it for a
number of file-types.

1.4.5.3. Gemini
Here the option is called  'Anwendungen...'  in German,  and again 
'Applications...' in English, and here too you can install several 
extensions  and both the .PRG and .ACC version.  Important for the
latest Gemini (V1.99): The fields 'Es  ist  eine  GEM-Applikation'
('It's a  GEM application')  and also  'Versteht VA-Start-Meldung' 
('Understands VA-Start messages') should be activated!

1.4.5.4. Thing
With 'Thing' the menu entry is once again 'Applications...'.  Here 
too  one can install  both the .PRG and .ACC versions  for several 
types of file. Here too it is important to activate  'Supports VA- 
Start' under 'Extra'->'Applications...'->'New'->'Options'. One can
also click on 'Files'  and enter 'Look'n See'  as a file-viewer in 
the '... to view:' field.

1.4.5.5. MagX-Desk
MagX-Desk has a menu entry  'Programme' ('Programs')  in which one 
can enter 'Look'n See' under 'Anzeige:' ('Display:'). This doesn't 
work for the DA  in the versions that I have tried,  but there are  
no problems with the .PRG version.

1.4.5.6. Neodesk
I have no information available about use with this desktop. [6]

1.4.6. The Help-system
'Look'n See' uses a  context-sensitive  help-system,  i.e. you can 
press the [Help] key at any time  to call up a help-text that will
explain what is currently happening on the screen.

The help-texts are provided in a so-called hypertext format. To be
able to use it you need to install a suitable help-system that can
display this hypertext.  A very compact and easy to use example is
'ST-Guide' by  Holger Weets,  which is included  with the  'Look'n
See' package.  It is best to copy this to your boot partition  (C:
as a rule, though it can also be A: when using floppies) and reset
the computer. 'Look'n See' will call 'ST-Guide' when required.

1.4.7. Use with MagicMac 
As a sensible GEM program,  'Look'n See'  will naturally  also run
under MagicMac without problems. One only has to watch two things:

- Under 'Options' -> 'Printer' the 'Direct'  radio button may only
  be activated  if the hardware extension  'McStout' is installed.
  Also you may not activate 'Atari Laser SLM' as the printer type.

- Some modules will not work under MagicMac on principle,  or only
  if certain premises  have been fulfilled  (e.g. if 'McStout', as 
  mentioned above, is installed).  In most cases the modules  will 
  themselves react to this and refuse their services,  but in some
  cases this is not possible and a crash will result.

 The following modules are affected:
   MOMO      Turning text into morse code signals does not work as
             MagicMac does not emulate the complete ST-/TT-sound.
   SAY_IT    Sound output is not possible for the same reason.
   GDPSSCAN  Not usable due to lack of suitable GDPS drivers.
   MONIKA    Works,  but with the risks  described  in the  module 
             description.
   SRC_DMAS  Accesses the  DMA hardware  directly,  but checks the
             DMA-sound cookie.  Warning:  There are programs  that
             set this cookie in an unauthorised way, which  causes
             an obligatory crash!
   SRC_SCRN  Runs,  with the restrictions mentioned  in the module 
             description.
   SUCKER    May only be used  if a ROM-port has been added to the 
             Mac, otherwise a crash results.
   RUPTOR    May only be used if 'McStout' has been built in, or a
             crash will result.
   PRUPTOR   Always crashes.
   MUTANT    Always crashes.

Above this there is the problem that some keyboards of the various
Macintosh models treat both [Shift] keys as one.  Some modules use
a simultaneous depression of both [Shift] keys  to break off their
operation - these modules can then not be interrupted.


                                                           Windows
------------------------------------------------------------------
2. 'Look'n See' and windows
The files to be viewed are,  logically,  displayed by 'Look'n See' 
in windows. Above this there are three further windows that have a 
special significance, and the dialogs too follow the current trend 
and may be displayed in windows if desired.

2.1. The 'Info' window
The 'Info' window contains details about the file  whose window is 
currently topped, or was the last at the top of a pile of windows. 
The file name (with path), the length,  as well as format-specific 
information will be shown.  The lowest line  is a status line that 
describes the internal conditions of 'Look'n See'.

2.2. File list
If one or more files are to be displayed then there may be several 
reasons why these may not be shown at a particular time  (the most 
common reasons:  No more windows available, or insufficient memory 
free).  'Look'n See'  will memorise  the name of these files  in a 
list and can display this on request.

2.3. Help
The 'Help' window is only intended for coarse orientation, in case 
someone has received  the program  without these instructions  for 
some reason.  If a help-system (e.g. ST-Guide)  has been installed 
then this will be called automatically.  Please make sure  in that 
case that the files  LOOKNSEE.HYP,  LOOKNSEE.REF,  LNC_MDL.HYP and 
LNC_MDL.REF are present in the current  'Look'n See' directory  or 
in a folder used by the help-system  (specified in ST-GUIDE.INF by
'PATHS=').

2.4. Window dialogs
Window dialogs in 'Look'n See' are application-modal.  This horrid 
expression simply means that you have to first close such a dialog 
before you can call other 'Look'n See' functions. In multi-process 
environments (yet another slogan)  all other processes continue to 
run, even when you are using a  'Look'n See' dialog - they are not 
system-modal, therefore.  If you can't understand this, it's not a 
tragedy.  Comfort yourself with the thought that 'Look'n See' uses 
up-to-date dialog handling and works well under MagiC or MTOS too.


2.5. Data windows
These are the windows that you will be actually interested in. The 
data windows will display  whatever you ask 'Look'n See'  to show. 
There are essentially six types of data windows:

- Image windows  display a graphic  created  either by unpacking a
  standard  format (.IMG, .PAC or similar) or by the conversion of 
  special data (e.g. GDOS fonts).

- Colour image windows contain,  obviously,  coloured pictures  or 
  images,  which are always converted  to the colour depth  of the 
  current display screen.

- Sample windows  are a sub-class  of image windows.  They display 
  the envelope-curve  of a  sound sample.  But  'Look'n See'  also 
  memorises the associated sample and plays it back on request.

- Text windows are...  well, text windows. Really, everyone should 
  know what these are.

- Hex-dump windows  are also text windows  in principle,  only the 
  display  of the data  is somewhat different.  File contents  are  
  shown byte-wise with their hexadecimal values and in ASCII.

- Special format windows,  of which there are currently  just two.
  This window type is selected by 'Look'n See' for file types that 
  can not be classified  in the above  standard scheme.  These are 
  .RSC files (resources) and .CFN files (Calamus fonts).

With all data windows (including Info, Help and file-list windows) 
you can move the window's contents by cliking and holding down the 
right mouse button and then dragging the cursor  (as flat hand) in 
the desired direction;  naturally this only works if the window is 
smaller than needed to display the entire contents.

In all data windows (except those for the special formats) you can 
mark portions of a text or image by clicking the left mouse button 
in the window and holding it down while dragging out a frame. With 
text and hex-dump windows the block start and end will snap to the 
ends of lines if the [Control] key is depressed  at the same time.
With image windows  the position and size coordinates of the block 
can be manipulated numerically by a double-click in the block.  To 
clear a block, input a width or height of 0.


                                                          The menu
------------------------------------------------------------------
3. Structure of the menu-bar
The menu-bar is accessible in desk accessory operation in all data 
windows and in the Info window.  Data windows that can not take up 
the full width of the menu bar only show the 'Extra' menu entry.


3.1. 'Look'n See' menu

3.1.1. 'About 'Look'n See...'
This brings up an information dialog on screen. There are two good 
reasons  to do this:  First,  one can establish  the exact version 
number and creation date of the version being used, and second one 
can take a look at the official  'Look'n See'  symbol.  The amazed 
Atari-user  community  can thank  Alex Halbritter  for this extra-
ordinary work  of high artistic significance,  who is also praised 
for it again in the final observations.


3.2. 'File' menu

3.2.1. 'Open...'
This calls the standard file selector  to the screen.  Contrary to 
the obvious assumption  that this needs  no further clarification, 
there are some specialities that are worth knowing about:

- With Selectric, BoxKite or Freedom installed the multi-selection 
  possibilities of these programs may be taken advantage of.  With 
  [Shift] + mouse-click up to 10 files may be selected.
  One can also select one or more folders, which will then display 
  all the files they contain.

- If,  instead of a  file name,  one inputs a mask,  e.g. '*.IMG',
  'TEST*.*', 'AB??N.DO?' or also '*.*',  then all files that match 
  the mask in the current and all lower-lying  directories will be 
  loaded.
  An empty entry field  will be treated as a '*.*' mask,  i.e. all 
  files will be loaded!

- For files  archived  with LHarc or Zip, normally  only a summary 
  of file names contained in the archive and their statistics will 
  be displayed. The same applies to any TOS files created from LZH 
  and ZIP originals. To show their contents, see next paragraph.

- Holding down the  [Alternate] key  while calling the function or 
  leaving the file selector forces display of the selected file(s) 
  in the  hex-dump mode. This may be necessary too with executable  
  files  that have been packed with PFXPAK, for instance:  As this 
  packer  uses the same algorithm  as LHarc, 'Look'n See'  falsely 
  recognises it  as an .LZH file  and displays just the summary of 
  the files it contains - generally none! Pressing the [Alternate] 
  key overcomes this.


3.2.2. 'Re-load'
This option is not implemented at present and therefore disabled.

3.2.3. 'Load clipboard'
If a valid clipboard path has been installed,  or a CLIPBRD folder 
is present in a suitable place, one can load all SCRAP files  with 
this entry.

3.2.4. 'Import data...'
Calls up a source module [7]. Source modules serve to read in data 
from an external source (e.g. a scanner).

3.2.5. 'Close'
Closes the top window.

3.2.6. 'Close all'
Closes all data windows  (and only those - not the Info,  Help  or 
file list windows).

3.2.7. 'To editor'
Calls up an external program and passes to it the file name of the 
currently topped window.  If an editor  has been installed for the 
file displayed in this window (see Section 3.5.6.)  then this will 
be called immediately.

Otherwise a 'Call program' selection box will appear containing up 
to seven  pre-defined programs - all the programs  whose existence  
'Look'n See'  knows about  thanks to certain protocols  (XACC, AV) 
and,  under MTOS or Mag!X,  all currently active applications  and 
desk accessories.  With the 'File select' button one can also call 
up any other desired program.

If one presses the [Alternate] key while selecting 'To editor' the 
'Call program' selector  will appear in any case,  irrespective of 
whether an editor is specified for the topped window or not.

3.2.8. 'Quit'
Naturally one quits the program with this. If it is installed as a 
desk accessory under Single-TOS or Mag!X however it will remain in
memory, and all the windows will just be closed  (this time really 
all of them) and any entries that may remain in the file list will 
be discarded.


3.3. 'Windows' menu

3.3.1. 'Cycle'
Moves the window at the top of the window stack  right to the back 
and brings the next one  to the front.  If a correctly working AV-
server  (e.g. Gemini, Thing)  is installed then the window cycling 
will also work across applications - i.e. cycle open windows  that 
do not belong to 'Look'n See' (however many programs unfortunately 
do not support this).

3.3.2. 'Arrange'
Arranges the data windows on the screen in a definable manner. The 
sorting arrangement can be predefined globally (see Section 3.5.2. 
'Windows...') or chosen freely by pressing [Alternate]  during the 
call, which brings up a selection dialog.

3.3.3. 'Info window'
Opens the Info window or,  if it is already open, brings it to the 
front.

3.3.4. 'File list'
As for 'Info widow', this time with the window for the file list.

3.3.5. Data windows
Up to ten open data windows will receive their own entries  at the 
bottom of the 'Windows' menu so that any one can be brought to the 
front simply and quickly just by clicking on their name.


3.4. 'Extra' menu
This menu column  is furnished with functions  that depend  on the 
type of window currently at the top of the stack.  Further details 
are given in the next part (Section 4.).


3.5. 'Options' menu

3.5.1. 'System...'
- 'File selector at program start': If one calls 'Look'n See' as a 
  program without parameters or activates it as a DA in the 'Desk' 
  menu,  then with this check-box crossed  the 'File' -> 'Open...' 
  function will be jumped to immediately the program starts up.

- 'No multitasking': Importing or dithering of colour pictures can 
  take an appreciable time in some circumstances. During this time 
  one can, since 'Look'n See' V0.28, move, resize or close windows 
  as usual.  This extra feature naturally occupies some (trifling) 
  calculation time,  therefore one can disable  this process  with 
  this option to speed up the processing by a minimal amount.
 
- 'Create ZMP files':  With this one can activate  the creation of
  special index files when displaying virtually-loaded ASCII texts.
  When such a text  is loaded in again  it will be processed  much 
  faster.  This feature is recommended  if one frequently displays 
  large text files virtually (Fido node lists, long file lists and 
  similar) that are only seldom altered.

- 'Ease-compatible AV-protocol': The 'Ease' desktop in version 3.5 
  contains an error in cross-application window cycling with '^W'. 
  This error can be removed by activating this entry.

- 'No 3D-Look': The 3D-look for dialogs  available since MTOS  for 
  resolutions of 16 colours upwards has been implemented in Magic3 
  so catastrophically that one can switch it off here.

- 'Spektrum-TC-Fix for NVDI 3.0': NVDI 3.0 contains an error when 
   displaying  in True-Color mode  on graphics cards  of the type 
  'Spektrum'.  If you have such a card and colour pictures appear 
  in false colours, you have to activate this option.

- 'Help system': Click here  and use the file selector  to locate 
  the help-system  that is to be called  by 'Look'n See'  for the 
  context-sensitive help (usually the path to 'ST-Guide').

3.5.2. 'Windows...'
- 'Dialogs in windows': If desired,  dialogs can also be displayed 
  system-modally. In that case this option should NOT be crossed. 

- 'Close and Quit': If this option is active then the program will 
  be quit automatically when the last data window is closed.

- 'Inverse window dragging':  Selects the direction  in which  the 
  window  contents  will move  when dragged  with the  right mouse 
  button (with mouse movement when active or against it when off).

- 'Use clipboard': Determines whether the clipboard  is to be used 
  for the saving of blocks,  or whether these should be saved to a 
  file.

- 'Automatically open Info window': If this option is active, then 
  'Look'n See'  will open the Info window automatically as soon as 
  any substantial change occurs.  This will be at  program starts, 
  at the receipt  of an AV- or VIEW message,  when an error arises 
  (memory shortage, no window available) etc.

- 'Colour iconify with contents': With some colour depths, 'Look'n 
  See' is in a position to display a reduced size colour image in 
  an iconified window. This option can be activated here.

- '^[Shift][Space] = All_in_one_Iconify':  [Control][Shift][Space] 
  normally triggers  the iconification  of all windows separately. 
  With this option active, all windows will be shrunk  to a single 
  iconified window.

- 'No. of windows': Here one can select the maximum number of data 
  windows  that can be open  simultaneously.  Values of 1 - 99 are 
  permissible,  though in many cases the operating system will set 
  a limit below this maximum.

- 'Arrangement': Selects the  sorting method for the  'Windows' ->
  'Arrange' function.

- (HEX-dump window) 'Line length':  Sets the  number of bytes  per 
  line in the hex-dump display mode.

- 'Virtual mode from xx KB': Files that are larger than this value 
  will be loaded in the virtual mode.

3.5.3. 'Printer...'
-'Printer type':- For use with the Atari Laser the Diablo emulator 
                  has to be installed.
                - 'Bubblejet' means the model from Canon, not that 
                  from Brother!
                - 'Print module'  pre-supposes an installed module 
                  for printer output. Up to now, nothing like this 
                  is available (yet), unfortunately.

- 'Output':     - 'GEMDOS' prints out via the operating system.
                - 'Direct' accesses the parallel port with its own 
                  fast routines.  This can  give rise  to problems 
                  (network operation,  printer connected to serial 
                  port or similar).
                - 'In background'  prints via GEMDOS,  but permits 
                  one to keep on working in parallel.
                - 'To file' saves the print data to a file.

- '-conversion': Replaces the '' character of the Atari font for 
                  text printing with an IBM '' (for printers that
                  would otherwise print a 'Peseta' character).

- 'Execute formfeeds in text': Form-feed commands in a text can be 
                               suppressed if desired.

- 'Form-feed after printing': Triggers a form-feed at the end of a 
                              printout.

3.5.4. 'Modules list...'
- 'Info': Gives information about the number of installed modules. 
          One can also select  any desired amount  of modules  and 
          display more detailed information about them.

- 'Index new': This function  should always  be called  if one has 
               made some changes to the assortment of modules  and 
               'Look'n See' does not react to this properly.  As a 
               rule the index of the installed modules will be up-
               dated automatically,  but there are also some cases 
               when,  due to an optimised way  of loading modules, 
               this cannot be guaranteed.

- 'Flags': This option is not in use yet.

- 'Module path': Here one sets the path to the folder in which the
                 modules are contained by using the file selector.

3.5.5. 'Module options...'
- 'Modules preferably to TT-Ram': This is a sensible option to use 
                                  on a TT since TT-RAM is accessed 
                                  faster i.e. the module functions 
                                  (importing, dithering  etc.) run 
                                  somewhat  faster,  depending  on 
                                  the RAM-card used. The same will 
                                  apply for computers  fitted with 
                                  PAK/3 and Fast-RAM card.

- 'Remove after use': If only limited working memory is available,
                      it can be  sensible  to remove  the  modules 
                      from meory immediately after use.

- 'Import modules':
 - 'Depending on extension': Only those import modules  that match 
                             the file extension will be loaded.

 - 'Load all if necessary':  As above,  but if the file can not be 
                             decoded  then all the  import modules 
                             will be loaded nevertheless.

 - 'Always load all':        On first opening  a file,  all import 
                             modules will be loaded immediately.

 - 'Keep resident':          Cancels the operation of the  'Remove 
                             after use' setting for import modules.

3.5.6. 'Programs...'
Up to 7 programs can be installed  as external applications: Click 
on the first box  on each line  to bring up a file selector, where 
you can set the path to the desired program.  For each program, up 
to 7 extensions can be specified, for which one can also  use wild 
cards (*, ?). You can move along the line with the [] key. 

When 'To editor' is called,  the program list will be checked from 
top to bottom and the first matching program will be called. If no 
matching program is found,  then,  depending on the displayed file 
type, a search will be made for the following pseudo-extensions:
     - <A> specifies all ASCII files.
     - <H>   -"-         hex-dump files.
     - <S>   -"-         Samples.
     - <I>   -"-         all images/pictures.

Under 'AV' one can specify whether the program understands the AV-
protocol (more exactly: the 'VA-Start' message). This is relevant,
above all, when working under a multi-tasking operating system, or 
when the process is installed as a desk accessory.

3.5.7. 'Font...'
One can select any desired non-proportional font  for the text and 
hex-dump windows. However 'Look'n See' no longer contains a built-
in font selector  but uses one  installed on  the system  instead.
This can be an xFSL- or UFSL-capable representative of this genre. 
Specially recommended are 'Calvino' and 'HuGO!', because currently 
only these offer popup support.

3.5.8. 'Colour images...'     
In this dialog one can select the method to be used for processing 
colour images  so that one can display them  at the current screen 
resolution/colour depth.

- 'Hi/TrueColor images': In the popup one can select a process for 
                         images with direct colour assignment.

- 'Palette images':      Ditto  for palette images.  At the bottom 
                         one can choose when the process should be 
                         called: 'Always..', 'Only when needed' or
                         'Never...'

- 'Resolution':        One can select different processes here for 
                       displays with different colour depths: 256,
                       16 and 2 (monochrome) colours.

3.5.9. 'Samples...'
- 'Play sample':   In this popup you can choose whether and when a 
                   sample is to be played.

- 'Module':        With this popup  you can choose the module that 
                   is to be used for outputting the sound sample.

- 'Always use module': If this option is active, then samples will 
                       never be output via the internal  DMA-sound
                       (STE and TT), but always  via the  selected  
                       module.

3.5.10. 'Default paths...'
Files needed regularly  can be listed  in this dialog  by clicking 
on one of the entries  and then selecting the file (and path) with 
the file selector . These files can be loaded into 'Look'n See' by 
pressing [Control] and one of the numerical keys [0] to [9]. Note: 
This can only be done when the dialog is closed.

In a similar way, a file that has already been loaded into 'Look'n 
See' can be assigned  to a numbered entry  by pressing [Alternate] 
and a numrical key. This however prevents the possibility of using 
wild cards in the assignment,  as one can with the above-mentioned 
dialog. Note: This too can only be done when the dialog is closed.

3.5.11. 'Fuzzy search...'
Fuzzy search is one of the specialities of 'Look'n See'. With this 
one can search through texts  for words  whose spelling one is not 
certain about.  The meaning of the various parameters is described 
in Section 6.5., 'Fuzzy search via the Levenshtein-distance'.

3.5.12. 'Registration...'
Here you can type in your name and address, which are then used to 
create a registration order file 'REGISTER.TXT'  when you click on 
'Save order text'.  This file will be placed in the currently open 
directory of the active window on the desktop or, if none is open, 
in the directory  from which 'Look'n See' was run.  You then print 
out the form,  tick the relevant parts,  enclose your payment  and 
send it to me or my representative.

Once you have registered you will receive your personal key, which 
should be input at the bottom of this dialog  to turn your copy of 
'Look'n See' into a full version.  Remember to  'Save options'  to 
make the registration permanent.
NOTE: You may NOT pass on the registered version to other people - 
that would be a breach of the licensing conditions. If you want to 
distribute  'Look'n See'  after you have registered, and no longer 
have the original LOOKNSEE.INF file, load the registered .INF file 
into a text editor and delete everything after the '=' sign on the
five lines starting with  'User_' (lines 3-7).  Save it to another 
directory, and you can then include it in the distribution.

3.5.13. 'Save options'
Saves the current settings in LOOKNSEE.INF file on the boot drive.


                                                  The 'Extra' menu
------------------------------------------------------------------
4. File-specific functions
The 'Extra' menu contains different menu entries, depending on the 
type of window currently at the top of the stack:

4.1. File list

4.1.1. 'Abandon list'
Deletes the current file list.

4.2. Images

4.2.1. 'Apply module...'
Calls up a processing module.  Only possible, naturally, if such a 
module has been installed.

4.2.2. 'Export...'
Calls up an export module, as long as a suitable one is available.

4.2.3. 'Print'
Prints out the image  on the selected printer  (or to a file - see 
'Options' -> 'Printer...').  On a LaserJet/DeskJet  one can adjust 
the position of the printout on the page first.

4.2.4. 'Copy block'
Copies a selected block to the clipboard as SCRAP.IMG,  or, if you
hold down the [Alternate] key,  saves it to a file under a name of 
your choice.

4.2.5. 'Save IMG'
Saves the complete image  as an IMG graphic  under a name and path 
you can choose in the file selector.


4.3. Texts

4.3.1. 'Apply module...'
Calls up a processing module.  Only possible, naturally, if such a 
module has been installed.

4.3.2. 'Export...'
Calls up an export module, as long as a suitable one is available.

4.3.3. 'Print'
Prints out the text  on the selected  printer  (or to a file - see 
'Options' -> 'Printer...').

4.3.4. 'Copy block'
Copies a selected block to the clipboard as SCRAP.TXT,  or, if you
hold down the [Alternate] key,  saves it to a file under a name of 
your choice.

4.3.5. 'Find...'
Calls up the 'Search text' dialog.
- 'Wild cards': Determines  whether the  quoted  placeholders  are 
                valid. When crossed, '?' represents any one chara-
                cter and '*' any number of characters (even none).
                When not crossed,  the equalities apply,  i.e. '?' 
                and '*' will be treated as normal characters.
                 
- 'Ignore Caps/l.c. differences': Should be clear enough - 'l.c.'=
                                  lower case.

- 'Fuzzy logic': See further details in Section 6.5. 'Fuzzy search 
                 via the Levenshtein-distance'.

- 'Search from': Selects the portion of the file to be searched.

- 'Search for/Find:' Should also be clear.

If the [Alternate] key  is pressed  when the 'Find...' function is 
called  then a previously marked block  (up to 50 characters long) 
will be adopted as the string to be searched for.

4.3.6. 'Find next'
Calls the  'Find...' function  again with the  previously selected 
settings.

4.3.7. 'Hex display'
Switches over to a hex-dump display.

4.3.8. 'To editor'
Corresponds to the function with the same name in the 'File' menu.

4.3.9. 'Display...'
Calls up the font selector.


4.4. Hex-dumps

4.4.1. 'Apply module...'
Calls up a processing module.  Only possible, naturally, if such a 
module has been installed.

4.4.2. 'Export...'
Calls up an export module, as long as a suitable one is available.

4.4.3. 'Print'
Prints out the dump on the selected printer. Basically a layout of 
16 bytes/line will be used.

4.4.4. 'Copy block'
Copies a selected block to the clipboard, or, if you hold down the 
[Alternate] key,  saves it to a file  under a name of your choice.
Two formats will be created:  Binary data and hex-dumps.  Decisive 
is the file extension  (ASC/HEX/TXT for dumps,  otherwise binary).
Both formats will be written to CLIPBRD (SCRAP.TXT and SCRAP.BIN).

4.4.5. 'Find...'
The options are similar to those for the 'Search text' dialog, but 
only the question-mark is available as a wild card  (replaces just 
one character)  and the syntax for the search-string  is different 
(see Section 6.6. 'The input of search-strings in hex-searches').

4.4.6. 'Find next'
Calls the  'Find...' function  again with the  previously selected 
settings.

4.4.7. 'ASCII display'
Switches over to an ASCII display.

4.4.8. 'As sample'
Switches over to the sample display mode. By analysing the data an 
attempt is  made  to differentiate  between  signed  and  unsigned 
samples, and if necessary to convert the data  accordingly.

4.4.9. 'To editor'
Corresponds to the function with the same name in the 'File' menu.

4.4.10. 'Display...'
Calls up the font selector.


4.5. Sound samples

4.5.1. 'Apply module...'
Calls up a processing module.  Only possible, naturally, if such a 
module has been installed.

4.5.2. 'Export...'
Calls up an export module, as long as a suitable one is available.

4.5.3. 'Play'
Replays a sound sample.

4.5.4. 'Stop output'
Interrupts sample output.  (Note that this may not be available if 
either of the interrupt masks are switched on in the  'Options' -> 
'Samples' -> 'Parameters' dialog).

4.5.5. 'Negate bit 7'
Converts signed samples to unsigned ones and vice versa.

4.5.6. 'Frequency'
Calls up the 'Sample options' dialog.
- 'Frequency': This selects the sampling frequency  with which the 
               sample will be replayed. There are four preselected 
               values  (which correspond to those of the DMA-sound 
               hardware  of the  STE/TT  and Falcon)  as well as a 
               field for inputting any desired frequency.

- 'Mode':  Switch-over between mono and stereo.  (Note that if you 
           replay a mono sample as stereo both the speed and pitch 
           will be doubled).

- 'Hear':  Plays the sample with the current settings.

- 'Transform': Re-calculates the sample from any desired frequency 
               to one of the 4 standard frequencies.  For this one 
               has to input the start frequency in Hz and click on 
               one of the other buttons 6.25, 12.5, 25 or 50 kHz.

4.5.7. 'Save IMG'
Saves the displayed envelope-curve as an IMG graphic.

4.5.8. 'Hex display'
Switches back to a hex-dump display of the sample data.

4.5.9. 'To editor'
Corresponds to the function with the same name in the 'File' menu.


4.6. Resource files

4.6.1. 'Next tree'
Moves on to the next object tree.

4.6.2. 'Previous tree'
Moves back by one tree.


4.7. GDOS fonts
GDOS fonts are converted to graphics  on loading, and will then be 
handled as such ->4.2.  Note: Only bitmap fonts will be displayed.


4.8. Calamus fonts
There are no special functions for .CFN files.


4.9. Virtual ASCII files
Here there is a special feature.  In order  to be able  to display 
ASCII files,  'Look'n See'  must first of all load in the whole of 
the file  (although in pieces!)  and look for the starts of lines. 
With long files this may, in some circumstances, take quite a long 
time.  So that one doesn't have to waste this period each time the 
file is called, 'Look'n See' creates a file with the extension ZMP 
in which the positions of the starts of lines are saved. When next 
displaying the same file  (e.g. with longish files lists  that one 
needs  frequently),  'Look'n See' checks  whether the ZMP  file is 
still current and loads it in again - so it is no longer necessary 
to examine the complete virtual file.

4.9.1. 'Print'
Printing of virtual files  only works  with the  specified printer 
types, not yet with printing modules.

4.9.2. 'Find...'
Corresponds to the search dialog for texts.

4.9.3. 'Find next'
Again as 'Find next' for texts.

4.9.4. 'Hex display'
Switches over to a (virtual) hex-dump mode.


4.10. Virtual hex-dumps

4.10.1. 'Print'
Printing of virtual files  only works  with the  specified printer 
types, not yet with printing modules.

4.10.2. 'Find...'
Corresponds to the search dialog for hex-dumps.

4.10.3. 'Find next'
Corresponds to 'Find next' for hex-dumps.

4.10.4. 'ASCII display'
Switches over to the (virtual) ASCII display.


4.11. GEM Metafiles

4.11.1. 'Original size'
Switches the display of the metafile to its original size.

4.11.2. 'Whole page'
Enlarges or reduces a metafile to exactly fill the screen.


4.12. Colour images

4.12.1. 'Apply module...'
Calls up a processing module.  Only possible, naturally, if such a 
module has been installed.

4.12.2. 'Export...'
Calls up an export module, as long as a suitable one is available.

4.12.3. 'Grey transform...'
Recalculates a colour image to a greyscale image.

4.12.4. 'Monochrome dither..'
Calls a dithering module manually,  to convert a colour image to a 
monochrome image. Useful if one wants to print out colour images.

4.12.5. 'Reduction module...'
Calls a reduction module manually. Only available when the current 
screen resolution supports exactly 256 colours.

4.12.6. 'Save colour image'
Saves the image  in a special format,  only used by  'Look'n See'. 
The created pictures occupy a very large amount of disk space, but 
in return may be re-loaded very quickly.


                              Keyboard operation and mouse control
------------------------------------------------------------------
5. Keyboard operation and mouse control

5.1. Keyboard operation
As far as possible keyboard operation has been implemented in line 
with existing (pseudo-) standards.
In general: [Control] plus a letter calls up a menu function  (for 
options [Alternate] is used instead), in dialogs selections can be 
made by pressing [Alternate] together with  the underlined letter, 
and for certain functions  the [Alternate] key is used for special 
purposes (in one case [Control] and [Shift] as well).

5.1.1. In the dialogs
- Underlined options  (buttons and popups)  are called by pressing 
  [Alternate] + [letter] keys.

- Popups will be opened by pressing [Alternate] and the underlined 
  letter in the string in front of the popup. [Shift][Alternate] +
  underlined letter correspond to a click on the circle-button, so 
  switch one entry further.

- In the popups, one can move the selection with [Cursor up/down], 
  [Return] or [Enter] execute the selection, [Undo] or [ESC] close
  the popup without making any changes.

- [Undo] and [Return] close a dialog,  and correspond  to clicking 
  on 'Cancel' and 'OK' respectively.

- In editable fields,  [Control][C], [V] and [X]  can be used  for 
  copying, inserting and cutting out of texts (to/from CLIPBRD).

5.1.2. Globally valid keyboard shortcuts
Some shortcuts are valid globally,  so have the same  significance 
all the time the program runs (except while servicing dialogs). In 
the following listing '^' corresponds to the [Control] key, '[Alt]'
the [Alternate] key.

^D   - Close all data windows
^I   - Open Info window, or bring it the front
^L   - Open file list, or bring it to the font
^O   - Open file
^Q   - Quit program
^U   - Close window
^V   - Load from clipboard
^W   - Cycle windows
^Y   - Delete file list
Help - Open Help window, or bring it to the front
^#   - Arrange windows
^[Space] - Iconify one window
^[Shift][Space] - Iconify all windows
^[Alt]U - Close all non-iconified windows except the top one
* (on the number keypad) - Enlarge window to full size (like click 
                           on the  'Fuller'  symbol at top right). 
                           A second '*' returns to former size.
^ 0..9 - Loads one of the 10 files  defined in 'Default paths...'.
         (This can only be done with the above dialog closed).

[Alt]B - 'Options'->'Colour images' display
[Alt]D - 'Options'->'Printer'
[Alt]F - 'Options'->'Windows'
[Alt]M - 'Options'->'Modules list'
[Alt]N - 'Options'->'Modules'
[Alt]P - 'Options' ->external 'Programs'
[Alt]S - 'Options'->'Save options' settings
[Alt]Y - 'Options'->'Font'
[Alt]Z - 'Options'->'System settings'
[Alt] 0..9 - Assigns the currently displayed file to this key.


The window contents can be scrolled with the [Cursor] keys: By one 
character or line on their own,  together with [Shift] by a window 
width or height,  and with [Control]  to the end-stop.  [Clr Home] 
and [Shift][Clr Home] position to the top and bottom of the window 
contents respectively.

5.1.3. Only partially valid shortcuts
Some shortcuts are only valid when a given window lies at the top. 
These are, with topped window type(s) in angle brackets:

^A - Switch to ASCII display <Hex>
^B - Apply module <Texts,  Hex,  Images,  Samples,  Colour images>
     Calls up a processing module
^C - Copy block <Texts, Hex, Images>
^E - Call editor (external program) <All data windows>
^F - Open 'Find' dialog <Texts, Hex> or Frequency dialog <Samples>
^G - Find next <Texts, Hex>
^H - Switch to hex-dump display <Texts, Samples>
^M - Dither to monochrome <Colour images only>
^P - Print <Texts, Hex, Images> or Play sample <Samples>
^R - Call reduction module <Only colour images below 256 colours>
^S - Switch to sample display <Hex>, or
     Save as IMG graphic <Images, samples>
+  - Display next tree <Resource files>
-  - Display previous tree <Resource files>
Fx - The function keys [F1]..[F10]  can be assigned processing and 
     source modules (see also Section 7.4)
HELP calls up the hypertext system in text windows in which only a 
     small block has been marked, with the block as the keyword to 
     be looked for. Note: Often there won't be a matching entry!

5.1.4. The [Alternate] key
For some functions one can influence the behaviour of 'Look'n See' 
by pressing [Alternate] at the time a call is made:

- When opening files, or when these have been passed via VA_START, 
  pressing [Alternate]  makes 'Look'n See' use the hex-dump format 
  for display irrespective of recognising the file type.  The same 
  applies  if one passes one or more files  to 'Look'n See'  via a 
  command line at start-up and holds down [Alternate] during this.

- When passing files to external programs (menu entry 'To editor') 
  pressing  [Alternate]  will force the appearance  of the program 
  selection dialog, which otherwise appears only if the file being 
  passed is of a type  not installed  for any of the  pre-selected 
  programs.

- When copying blocks, pressing [Alternate]  reverses the reaction 
  to the 'Options' -> 'Windows...' -> 'Use clipboard'  setting. In 
  other words, if 'Use clipboard' is active,  pressing [Alternate] 
  will bring up a file selector, allowing you to save the block to 
  a file, and the opposite happens if this button is not active.

- With 'Windows' -> 'Arrange',  pressing  [Alternate]  brings up a 
  small dialog in which you can select the desired sort order.

- When closing a window with '^U', pressing [Alternate] will close 
  not the top window but all non-iconified windows  except for the 
  top window.

- When calling the  'Find...' function,  pressing [Alternate] will 
  transfer a marked block to the search-string field,  provided it 
  isn't too large (< 50 characters).

5.1.5. Iconifying
[Shift],  [Alternate] and  [Control]  are used in conjunction with 
the window 'Closer' button (top left)  to mimic the  iconification 
function of MultiTOS 1.08 under Single-TOS and Mag!X.  For further 
details see Section 6.11. 'Iconifying also without MTOS'.


5.2. Mouse control

5.2.1. Left mouse button
In almost all windows a block can be drawn out with the left mouse 
button. A short click removes the block marking, in sample windows 
the block disappears and the whole sample is replayed.

A double-click in an image window opens a dialog for numeric input 
of block coordinates - both position  and size.  In text windows a 
double-click will mark the word clicked on.

5.2.2. Right mouse button
The right mouse button  permits moving the displayed portion  of a 
file, if this does not fit completely into the window.

                         Things you should know about 'Look'n See'
------------------------------------------------------------------
6. Things you should know about 'Look'n See'

6.1. The INF file
A tiresome problem  can arise  when programs are started  not from 
the desktop but from within other programs:  How do these programs 
locate the support files that they require  (such as .INF and .RSC 
files)? Many calling programs (and, in certain circumstances, this 
can also happen with nearly all desktops) do not reset the current 
pre-call path to the path of the program they have started.

Due to this the called programs (text editors and file viewers are 
those most likely to be affected) are cut off from their INF files 
if they create these  in their own current directory.  Even worse: 
If,  in these circumstances,  you save an INF file  in the current 
directory, it will  almost certainly  end up  somewhere  it has no 
business to be in.

'Look'n See' tries to solve  this dilemma  by using a  multi-stage 
procedure to find the best possible place for storing its INF file 
(LOOKNSEE.INF). The individual stages are:

- Checking the environment variable LOOK'N SEE=

- Checking the environment variable LOOK_N_SEE=

- Testing whether a file LOOKNSEE.INF exists on the boot drive

- Checking whether a LOOKNSEE.INF file exists  in one of the paths 
  specified in PATH=

- Last of all, searching in the current directory.

In the first two cases it is enough if the ENV-variable (which can 
be written in capitals or lower case,  the path specification  may 
include or omit a final '\') points to a valid path; with the rest 
of the options a LOOKNSEE.INF  file has to be present. If all this 
does not apply, then the .INF file will be created on C:\ (if this 
drive is present) or in the current directory.


6.2. The clipboard
A further dismal chapter lies in locating the clipboard folder. In 
principle the mechanism is fairly clearly specified, but since the 
clipboard  suffered a  shadowy existence  for a long time,  some -
specially older - programs (1st Word Plus)  still have appreciable 
problems with it. 'Look'n See' looks for the clipboard as follows:

- Checking whether  scrp_read()  points to a valid path

- Searching the environment for SCRAPDIR=, CLIPBRD= and CLIPBOARD=
  (in that order)

- Testing whether \CLIPBRD\ is presebnt on the boot drive.


6.3. Discrimination between various file formats
With most files it is possible to decide very reliably  what file 
format one is dealing with  from fixed I.D.s  in the file header. 
Unfortunately this is not possible with some formats and for these 
'Look'n See'  will analyse  secondary charactersistics of the file 
(name,  extension,  file length,  specific characteristics  in the 
construction).


6.4. Recognition of ASCII texts
If occasionally  it is not possible to assign  a given format to a 
file, then it will be displayed as a hex-dump. But before this, as 
a final possibility, 'Look'n See' checks whether the file might be 
a plain ASCII text.  This is likely to be the case when the number 
of non-alphanumeric characters  (ASCII <32)  is low,  the  maximum 
line length has a 'sensible' value (max. 200 characters) and CR/LF 
has been used to separate lines.


6.5. Fuzzy search via the Levenshtein-distance.
Traditional  text-search procedures  suffer from one disadvantage: 
They either find  the target word  (the one they are asked to look 
for) or they don't find it. If one knows exactly how a word should 
be spelt and is absolutely certain that it is written correctly in 
the text, then this isn't a problem. But if not, then 'Look'n See' 
is up to now  the only  (as far as I know)  file viewer offering a
similarity search via the Levenshtein-distance.

The Levenshtein-distance is calculated by taking the first word to 
be examined  and applying some  elementary operations to it  until 
it matches the second word. The smallest number of operations that 
is required to perform such a transformation  is then a measure of 
the similarity of the two words.

Three elementary operations are available for this transformation: 
The exchange of one letter for another (swap), the insertion  of a 
letter or the deletion of one.

Examples:
'Meyer'  becomes 'Maier' [8]  by exchanging  'e'->'a' and 'y'->'i' 
(2  operations)  or by deleting 'e' and 'y'  and inserting 'a' and 
'i'  (4  operations). So the Levenshtein-distance here would be 2, 
as _at least_ 2 operations are required for the transformation.

'Meier' becomes 'Meyr' by exchanging 'i'->'y' and deleting the 'e' 
or by deleting the 'i' and exchanging 'e'->'y',  i.e. 2 operations 
in each case, so the Levenshtein-distance is 2.

One can obtain a weighted Levenshtein-distance if one assigns some 
weighting factors  to the  individual operations.  As a rule,  for 
instance, one will seldom input more letters than are contained in 
the word being searched for, and therefore the deletion of letters 
is assigned a higher weighting then exchanges or insertions.

When using 'Fuzzy search',  'Look'n See' searches the text word by 
word [9]  and calculates the  weighted Levenshtein-distance to the 
target word.  The weighting factors for insertions,  deletions and
swaps (exchanges)  of letters,  as well as the maximum permissible 
distance between two words  that are to be treated as 'equal'  for
words  of different lengths  can be specified  under  'Options' -> 
'Fuzzy search'. 


6.6. The input of search-strings for hex-searches
The search-string in the hex-dump mode has the following format:

[Expression],[Expression],[Expression]

Where '[Expression]' can consist of the following:

[Expression]  Example    Meaning
------------------------------------
'Text'        'Text'     ASCII text (case sensitive)
"Text"        "Text"     ASCII text (case sensitive)
xxxx          FFFF       Hex-byte(s)
$xxxx         $FFFF      Hex-byte(s)
0xxxxx        0xFFFF     Hex-byte(s)
&Hxxxx        &HFFFF     Hex-byte(s)
%xxxxxxxx     %1001      Binary data
&Xxxxxxxx     &X10101    Binary data
(xxx)         (100)      Decimal number
.xxx          .100       Decimal number

Prefixing '[Expression]'  with a 'W:' or 'L:'  forces an extension 
to WORD or LONG  (16 or 32 bits) respectively.  For binary and hex 
inputs  one can also cover  a larger number of bytes by  inputting 
more places. A few examples:

Input        Finds
--------------------
'ABC'      41 42 43 
$99        99
$199       01 99
$1299      12 99
$01299     00 12 99
17         17
W:17       00 17
L:17       00 00 00 17
.100       64
W:.100     00 64
W:.1000    03 E8
.1000      E8 (_NO_ extension in decimal mode!!)
L:'ABC'    41 42 43 ('L:' and 'W:' _NOT_ effective in ASCII mode!)
%11111111  FF
%111111111 01 FF


6.7. The MCWR cookie
The DMA-sound system  on the STE and TT  has a  critical drawback:  
Due to a design error in the hardware  and lack of support  by the 
operating  system,  it is not  possible  to obtain returns  of the 
current values for volume, bass or treble settings.

Some programs that are capable of altering such values (e.g. Crazy 
Sounds)  have no means of  restoring the original values when they  
terminate.

A solution is provided by the MCWR cookie ('Microwire' is the name 
of the interface used for control of the audio mixer output stage) 
as the cookie can store default values for volume, bass and treble 
levels.  If the cookie is present,  then 'Look'n See' will set the 
levels stored in it before replaying a DMA sample.


6.8. Replaying of sound samples
Sound samples  can be replayed by  'Look'n See'  via the DMA-sound 
hardware  or via a sample module.  Unless something else  has been 
specified under 'Samples...' the first output attempt will be made 
via the DMA-sound. If this is impossible because not enough memory 
is available to copy the sample to ST-RAM, say,  or to recalculate 
it to one of the sampling frequencies supported by DMA-sound, then 
output will be made via the installed sample module.

In both cases  'Look'n See'  will, if necessary, first convert the 
sampling frequency to one of those  supported by  the sound-system 
to be used.  If this should not be possible  at times,  then small 
deviations will be tolerated, though this will lead  to some pitch 
changes.


6.9. How 'Look'n See' starts external programs
  - If a suitable program is already running and understands 'VA', 
    it will be sent a VA_START message in any case.

  - Under  Mag!X/MTOS it will be started subsequently  in parallel 
    via 'shel_write(100)'.

  - Under Single-TOS there are two possibilities:
    - 'Look'n See' is a desk accessory:
      A VA_STARTPROG message is sent to the application with ID 0.
      Under  GEMINI/EASE  the program will then be started  by the 
      desktop.
        The hitch with this is that a subsequent  appl_find() call  
        will not find the started program but GEMINI/EASE instead.
        Passing of further files via VA_START is then not possible 
        (because 'Look'n See' never knows whether the desktop or a 
        subsequently-started program is running at any given time).

    - 'Look'n See' is an application:
      The program to be called is started via shel_write().


6.10. Communication with external programs

6.10.1. The XACC-protocol
'Look'n See'  supports the corresponding XACC-protocol  both under 
Single-TOS  as well as in multitasking environments.  One can pass 
to it keyboard shortcuts,  texts, image graphics and GEM metafiles 
from other processes via XACC messages:

  ACC_KEY    (0x502)  Keyboard shortcut commands
  ACC_TEXT   (0x501)  Text
  ACC_META   (0x503)  GEM-Metafile (will be displayed as hex-dump)
  ACC_IMG    (0x504)  GEM-Image.

For the last two commands,  transfer is only possible  if the data 
are sent complete in a single package.

6.10.2. The AV-protocol
'Look'n See'  also supports the AV-protocol for communication with 
other programs. In detail, these are the following commands:

AV_PROTOKOLL       (0x4700)  Registration with the AV-server
VA_PROTOSTATUS     (0x4701)  Confirmation by the AV-server
VA_START           (0x4711)  Causes 'Look'n See'  to load the file 
                             with  the  passed  file name.  If the 
                             <Alternate>  key  is  pressed  at the 
                             instant that the VA_START message  is 
                             received  by  'Look'n See',  then the 
                             passed file  will be displayed in the 
                             hex-dump mode
AV_STARTPROG       (0x4722)  Instruction to the AV-server to start 
                             the specified  program.  Is only used 
                             under Single-TOS when 'Look'n See' is 
                             installed as a desk accessory
AV_ACCWINDOPEN     (0x4724)  Registration  of own window  with the 
                             AV-server
VA_DRAGACCWIND     (0x4725)  Will be sent  by the  AV-server  when 
                             files are dragged  to a  'Look'n See' 
                             window
AV_ACCWINDCLOSED   (0x4726)  Deregistration of own window with the 
                             AV-server
AV_PATH_UPDATE     (0x4730)  Is sent  by  'Look'n See'  when files 
                             have been  saved;  the AV-server  can 
                             then update  the corresponding  drive 
                             window
AV_EXIT            (0x4736)  Deregistration at program end.


The AV-server will be ascertained by the following methods:
    - Searching for GEMINI, AVSERVER and THING under ap_id=0
    - Searching for GEMINI, AVSERVER and THING  under _any_  ap_id 
      (i.e. if two of the listed programs  are in memory,  the one 
      with the ID 0 becomes the AV-server)
    - Checking the environment variable AVSERVER=xxx
    - If the 'Look'n See'-ID is not 0,  then the program  with the 
      ap_id=0 becomes the server.

6.10.3. The VIEW-protocol
'Look'n See'  also understands the VIEW-protocol  that was defined 
by Peter Seitz.

'Look'n See'  installs a  'View' cookie with a pointer to its file 
name.  Those wishing to cover all eventualities  should also write 
the following in their environment:

      View C:\LOOKNSEE.ACC
      SHSHOW C:\LOOKNSEE.ACC

 (adapt paths as necessary).

Since V 0.28 'Look'n See' also supports the extended View-protocol 
that also permits passing of data in memory.  This process is used 
optimally by Christian Grunenberg's 'LZH-Shell', for instance.

6.10.4. Drag&Drop
Under newer Multi-TOS versions and MagiC 3.0 onwards, programs can 
exchange data via 'Drag&Drop'.  'Look'n See' supports this process 
passively,  i.e. can receive paths,  file names  and real data.

6.10.5. xFSL / UFSL / Font protocols
'Look'n See' makes use of external font selectors installed in the 
system for selecting fonts. Specially recommended are those selec-
tors that support the xFSL standard and make use of a user-defined 
popup (to date these are only 'Calvino' and 'HuGo!'). These selec-
tors fit in seamlessly with the operating surface of  'Look'n See' 
and allow all setting options to be used in an optimum manner.

The possibilities are somewhat more limited  when using a selector 
following the  (antiquated) UFSL standard.  These do not appear as 
window dialogs and also do not support separate font selection for 
different types of windows.

A further option  for selecting fonts  is the use of a 'Drag&Drop' 
font selector.  With this  one drags a font  from a selector  or a 
font palette to the desired 'Look'n See' window. 

Messages of the font protocols by Christian Grunenberg  as well as 
those by Peter Hellinger  are supported.  The same option  is also 
offered by the above-named xFSL selectors.

6.10.6. SNAP
The SNAP-protocol serves to allow processing of screen hard-copies
directly, without detouring via a file first.  This protocol is at 
present only suported by the latest version of JML-Snapshot, which 
however is not publicly available.


6.11. Iconifying also without MTOS
A real novelty was introduced by Atari  with MTOS 1.07, namely the 
iconification  of  windows  and  whole applications  at the user's 
behest. This means that windows with a corresponding symbol can be 
reduced to a minimum size. The shrunk windows are arranged next to 
one another  at the bottom edge of the screen, and look like large 
icons - hence the name.

Unfortunately one tends to wait in vain for the publication of new 
M-TOS versions. Also, iconifying would be a desirable feature even 
under Single-TOS and Mag!X. Hence 'Look'n See' imitates iconifica-
tion under these operating systems  as realistically as possible - 
it even offers a useful extension.

Iconifying is triggered by clicking on the 'Closer' symbol (at the 
extreme left  of the window title bar)  while holding down  one of 
the keys performing a 'shift' function:

[Alternate]  - Shrinks one window
[Control]    - Shrinks all windows into a single icon 
[Shift]      - Shrinks all windows into individual icons.

Since mouse-clicks  on the 'Closer' field  with [Control]  are not 
always executed under WINX, one can also use [Shift] + [Alternate] 
+ mouse-click instead.

To enlarge a window again, one only needs to click once in it (but 
if it is not  currently  the top window then another click  in the 
window  or its title bar will be needed first  to top it).  If one 
presses the [Shift] key at the same time  then all windows will be 
restored to their original positions and sizes.

Iconification  can also be  triggered  from the keyboard  with the 
combination [Control] + [Space] which iconifies the top window, or 
restores it to its original size. If the [Shift] key is pressed at 
the same time then all windows will follow this procedure.

Since AES-iconifying  modelled on Multi-TOS  has been  implemented 
from  MagiC 3.0 onwards, 'Look'n See' has retained for the sake of 
standardisation the above-mentioned assignment for the mouse-click 
on the 'Closer' or the iconified window.


6.12. ICFS
So that other programs can also support iconifying,  following the 
example of  'Look'n See', a concept  has been developed  to assign 
centrally the screen positions  at which the iconified windows are 
to be placed.  The program  ICFS.PRG  by Dirk Haun is required for 
this, which is best copied into the AUTO folder.

From version 0.14 onwards ICFS offers additional functions,  which  
naturally are used by 'Look'n See'.  For instance, when moving the 
icon windows they snap to valid positions, and larger icon windows 
are assigned for colour images.


6.13. This is how 'Look'n See' treats colour images
Just as some of the snapshots that you took last year of your Aunt 
Emma at the seaside  turned out reasonably well  though most would 
be better off vanishing for ever  into some dark shoebox, so there 
are differing quality levels for digital pictures.  Coarsely these 
can be subdivided  into two groups, namely palette and true-colour 
images.

Palette images contain a limited range of colours whereas in true-
colour images every pixel (picture element) can assume any desired 
colour.  Above this, there are further graduations  in both groups 
with respect to  the achievable quality, either due to the size of 
the palette (16, 64 or 256 colours are commonly used for instance) 
or the precision with which the colours of a true-colour image are 
specified (e.g. 15 bits per colour permits 32,768 possible colours 
while 24 bits/colour permits some 16.7 million possible colours).

The current screen resolution can also be  either palette oriented 
or use direct colour assignment. With programs that process colour 
images there is always a dilemma how these are best dealt with. In 
'Look'n See' I have decided always to convert images after loading 
to the current screen resolution, and to discard the original data 
(naturally only in memory, the file on the disk won't be affected).
'Look'n See' can do this  because we are dealing with  just a file 
viewer - a picture processing program would, of course, have other 
requirements.


'Look'n See' recognises five different colour depths on screen:

 No. of    Bits per  Screen type
 colours    pixel
----------------------------------------------------------
       2      1    Monochrome display
      16      4    Palette with 16 colours
     256      8    Palette with 256 colours
   65536     16    direct colour assignment, 5 bits/primary colour
16777216     24    direct colour assignment, 8 bits/primary colour

Notes:
- In the 65536 colour mode, primary colours red and blue each have 
  5 bits  and green 6 bits available to them.  Most graphics cards 
  also offer a mode  with 32768 colours, which can be treated with 
  a few restrictions as 65536-colour mode.

- Linguistic convention: Images with 32768 or 65536 colours can be 
  also described as  32K or 64K respectively , or collectively  as 
  High-Color (Hi-C.) images. Pictures with 24 bit colour depth are 
  called 'True-Color' images (abbreviated as TC).

The conversion of an image with a certain colour depth  to that of 
a specified screen colour depth may - depending on circumstances - 
present no, some or very great problems.  Near lossless conversion 
to a greater colour depth is always possible ('near', because when 
converting palette images to Hi-Color insignificant losses have to 
be taken into account).  This conversion is undertaken by internal 
routines of 'Look'n See' itself.

Conversion  in the other direction  is not so simple,  and various 
attempts at solutions exist  that produce  different results  with 
respect to speed, attained quality and similarity of the converted 
image  to the original.  'Look'n See' leaves  such conversions  to 
external modules, therefore, permitting you to select the one that 
best suits your requirements ('Options' -> 'Colour images...').


                                                       The modules
------------------------------------------------------------------
7. The modules
'Look'n See'  provides an interface  that allows  external program 
elements  specially written for it - the so-called modules - to be 
called when required to perform specific tasks.


7.1. Loading the modules
Modules (extender MDL) must lie within a folder specially provided 
for them (specified  in the  'Module path'  field of  'Options' ->
Modules list...').  They will be loaded  automatically by  'Look'n 
See' when required, and possibly also  automatically removed  from 
memory  after use.  The exact behaviour  can be configured  within 
wide limits in 'Options' -> 'Module options...'


7.2. Import modules
Import modules make functions available to 'Look'n See' with which 
it can recognise various file types and convert them to a standard 
format.  They are called up automatically by  'Look'n See'  when a 
file is to be displayed.  The user will not notice anything at all
except that  'Look'n See'  will be able to display files  suddenly
that could only be handled as hex-dumps without such modules.


7.3. Source modules
Source modules supply data from external sources to  'Look'n See'.
This includes scanner drivers  and similar,  for instance.  Source 
modules care called from the 'File' menu with the 'Import data...' 
entry. For assignment to function keys, see Section 7.4.


7.4. Processing modules
Processing modules permit modification or processing of data  held 
in computer memory in many ways. They can be called via the 'Apply 
module...' entry in the 'Extra' menu.

Module functions  that are used frequently  can be assigned to the 
function keys  [F1]..[F10].  To do this, open the popup  at bottom 
right of the rectangle in the 'Apply module...' dialog  and select 
the desired function key.  Keys already assigned are marked with a 
dot '.'.  'Look'n See' can handle six different levels of function 
keys (one each for source modules and processing modules for mono-
chrome images, colour images, samples, texts and binary data). The 
level that is active at any given time is determined by the topped 
window.


7.5. Print modules
The purpose of these modules should be self-evident. Print modules 
serve to control  even the most exotic of printers,  or to fulfill 
unusual print requests way above the purpose of a file viewer.


7.6. Dithering and reduction modules
These modules  serve to process  given types of  colour images  so 
that they can be displayed  in the current  screen resolution.  In 
this context  'reduction'  means lessening the number colours that
occur in a palette image and 'dithering' the conversion of a true-
colour image into a palette image by applying a dithering process. 
This division is not static, however - in practice  there are also 
reduction methods for true-colour images and ditherers for palette 
images.


7.7. Sample output modules
Sample output modules permit the audible replay  of sound samples. 
Sound output is strongly dependent on the hardware.  For computers 
with DMA-sound  (TT, STE and Falcon) 'Look'n See'  itself contains 
the required routines;  for output  via the sound-chip  or special 
output hardware  one can install special drivers  as sample output 
modules.


7.8. Export modules
Export modules serve to export loaded data, as their name implies. 
This export can be to a file (the usual case) but they can also do 
other things. One can envisage exporters that output to the serial 
or other ports, for instance. 

Since the  export interface  was only  implemented  at a very late 
stage, there are unfortunately a number of export modules that are 
configured as processing modules, meaning that they are called via 
the 'Apply module...' menu entry. Although the module authors have 
been requested to adapt their modules,  this has unfortunately not 
been possible in all cases for reasons of time.


7.9. The bundled modules
The description of the modules bundled with  'Look'n See'  will be 
found in the text file 'LNC_MDL.TXT'.


                                              The module interface
------------------------------------------------------------------
8. For programmers: The module interface
This part of the documentation  has been moved elsewhere.  Special 
developer's documentation for 'Zeig's mir', the German original of 
'Look'n See', is available (in German only at present), which also 
contains a program version that outputs debugging information.

                                                

Final observations
------------------------------------------------------------------
9. Final observations

9.1. Author

             Rosin Datentechnik
             Reiner Rosin
             Peter-Spahn-Str. 4
             D-65375 Oestrich-Winkel
             Telephone: + 49 6723 4978   Fax: ... 7190

Email Reiner Rosin @ WI2 (MausNet) / Reiner_Rosin@wi2.maus.de
  
             Bank account:  1211-04-601,
             Postgiro Frankfurt, BLZ 500 100 60


9.2. Thanks
An appreciable part  of the development of  'Look'n See'  has been 
undertaken  by a multitude  of beta-testers  (during the course of 
time  this will have been  around 60, the composition changing all 
the time), to whom I would  collectively like to express my thanks 
hereby.  Deserving explicit mention due to their hard work are (in 
alphabetical order):

Dirk  Allard for the conversion of the manual into a hypertext for 
ST-Guide. [10] (German release only)

Rene Bartholomay  for revision  of the .RSC file, also included in 
the program (adaptation to the 3D-look under MTOS and Falcon-TOS).

Carsten Guthardt-Schulz for the attempt to write the program docu-
mentation.  Unfortunately this failed, which is why I then  had to 
write this text completely by myself.

Alexander Halbritter  for the design of the official 'Look'n See'-
symbol  and its conversion to icons,  also for entering himself in 
the list of module authors.  

Dirk Haun  for his  modules,  many critical  hints and  tips,  the 
colour version  of the icons, his involvement in matters  ICFS and 
Calvino and very much more.

John McLoud  [11]  for his colour image import modules  and source 
code for incorporating metafiles.

Andreas Papula for his import modules for packed archives, even if 
the LHARC module still tries to deal with files it has no business 
interfering with.

Thorsten Pohlmann for his modules and some obscure suggestions, as 
well as for the fact that he has left to posterity the saying  'It 
works for me (TM)'  [12].  Extra praise  is due for the GIF-export 
module because I personally need it regularly but would never have 
got it together.

David Reitter,  who exhibited  an unexpected  sales talent  at the 
Protos '94 in Hennef.

Andreas Schrell for his EPS-exporter module.

Peter West  for the English translation  (program, modules and the 
manual).

Reiner Wiechert, to whom is due the honour of being the first non-
member of the WI2-clan to have written a module.

Ralf Zimmermann for both of his modules.


The rest of the  Maus members  of Wiesbaden2  who have withstood a 
merciless beta-test (Joachim 'Joggi' Drr, Holger 'Bring the cups' 
Franko, Manfred Mller-Spth, Klaus Opel, Gerhard Ru [13], Markus 
Schnhaber, Thomas Steffen, Elmar Szych, Arndt Weinmann, Christian 
Wolf).


Not participating in the beta-testing but thanks to their products 
critical for the development of 'Look'n See' were:

Christof Schardt (ergo! pro)
Gregor Duchalski (Shell for ergo! pro, Flydials)
Christoph Conrad (Patches to GFA-interpreter and compiler)
Harald Sommerfeldt (XACC-Test and analysis program)
Holger Weets (ST-Guide).


Hints for all GFA-Basic programmers:
1. Buy Gregor's Flydials. They are good! [14]
2. Buy ergo! pro. It is also good! [15] 
3. If you have  any money left, buy  'Look'n See'.  I want to live 
   too, you know :-).


9.3. Disclaimer
'Look'n See' was developed with the greatest of care. Nevertheless 
I can't exclude the possibility that it still includes some errors. 
Therefore I decline any responsibility for the use of the program, 
and any damage that may arise from it [16].

Use of 'Look'n See' is at your own risk.


9.4. Known Bugs
There are a few things  that haven't been resolved fully in V 0.95 
and may give rise  to some problems.  One should know  about these 
stumbling blocks  so that one can take steps to protect oneself as 
best as one can from possible consequences.

- In the desk accessory mode, the menu bar in the window is formed 
  in a slightly 'impure' way. In some circumstances, therefore, it 
  may be invisible  even though the top window belongs to  'Look'n 
  See'.  This happens particularly under Single-TOS  without WINX. 
  However, the menu entries still appear if you click in the right 
  area of the (invisible) menu bar, and things can be restored  to 
  normal by redrawing the window with [Control][W].

- During printing  in the 'Direct' mode  it may not be possible to 
  move the mouse cleanly in some cases (depending on the printer).
  The direct mode  is optimised  for maximum printing speed, which 
  is why it is not easy to switch off this effect.

- During printing in the 'Background' mode,  when 'Look'n See' has 
  been started  as an accessory  under Single-TOS,  one should not 
  quit the main application or start a program from the desktop.

- After booting as an accessory under Single-TOS, the 'Look'n See' 
  menu entry  is sometimes missing  in the 'Desk' menu.  This is a 
  problem of GFA-Basic which prevents 'menu_register()' from being 
  applied in time.  After starting any program this effect will be 
  removed.   

- Under Single-TOS there is no clean way for DAs to reserve memory 
  durably and safely.  Loading and removing modules  can therefore 
  give rise to difficulties, right up to causing a crash.


9.5. Future outlook
What next?  I don't know either.  I hope you will forgive me,  but 
after two years of sometimes very intensive work on 'Look'n See' I 
am a bit out of breath. Adaptation to use long file names would be 
rather nice, specially as I could use these myself meanwhile under 
MagicMac [17].

The development of 'Look'n See' has certainly not been financially 
worth while, even though a reasonable number of registrations have 
been received. But here and there it has been a lot of fun and has 
also brought me  completely new knowledge - that is also some sort 
of reward.


9.6. Names and trademarks used
Many of the program names and other products used in this text are 
registered trademarks of their originators. The programs come from 
the following authors:

Name        Status and originator
-------------------------------------------------
BoxKite     Shareware by Harald Becker
            File selector, similar to Selectric

Calamus     Commercial software by DMC
            DTP system

Calvino     Freeware by Dirk Haun
            xFSL font-selector

Coma        Commercial software by Softbr
            Fax program

CoNnect     Shareware by Wolfgang Wander
            Terminal program

Crazy       Commercial software by Maxon
Sounds      Assigns sounds to various actions

Ease        Commercial software by ASH (Author Dirk Sabiwalsky)
            Alternative desktop

ergo! pro   Commercial software by Columbus Soft
            Easy-to-use development environment for GFA-Basic

Freedom     Shareware by Christian Krger and Kolja Koischwitz
            File selector, highly recommended

GEM         Trademark by Digital Research

Gemini      Shareware by Stefan Eissing
            Alternative desktop

GEM-View    Shareware by Dieter Fiebelkorn
            Very usable file viewer,  majoring in colour graphics, 
            unfortunately with an extremely nonsensical interface

GFA-Basic   Commercial software by GFA-Systemtechnik
            Programming language,  used to produce  the kernel  of 
            'Look'n See'

GFA-        Shareware by Gregor Duchalski
Flydials    Library for flying and window dialogs under GFA-Basic

Guck        Shareware by Patrick Seemann
            File viewer, unfortunately doesn't use GEM

HuGo!       Freeware by Stefan Rogel
            xFSL font-selector

ICFS        Freeware by Dirk Haun
            Utility, assigns positions for Iconified windows

JML-Snap    Shareware by John McLoud
            Utility for preparing screenshots

Junior-     Commercial software by TKR
Office      Fax program

LZH-Shell   PD by Christian Grunenberg
            Packer shell for LHarc

Mag!X       Commercial software by Behne&Behne
            Multitasking extension for ST/TT

MagiC       Commercial software by Behne&Behne
            Newer name of Mag!X  from version 3.  Both these names 
            are used interchangeably in this manual

MagicMac    Commercial software by ASH
            Adaption of MagiC 3.0 for the Apple Macintosh

MASM        Commercial software by Borland
            Macro-assembler

MTOS/       Commercial software by Atari GmbH
Multi-TOS   Multitasking extension for ST/TT/Falcon

Papyrus     Commercial software by R.O.M.
            Text processing system

Pure  C     Commercial software by Application Systems Heidelberg
            Development environment for  C  and  Assembler.  Large 
            parts of  'Look'n See'  and most of  the modules  were 
            developed with it

QFAX        Commercial software by Computer & Design
            Fax program

Quiklink    ?
            Fax program for PCs under DOS

Selectric   Shareware by Stefan Radermacher
            File selector, highly recommended

STaD        Commercial software by Application Systems
            Pixel drawing program

ST-Guide    Fairware by Holger Weets
            Highly recommended hypertext help-system

Tele-Office Commercial software by TKR
            Fax program

Thing       Program by Arno Welzel
            Alternative desktop

Totosam     Public-Domain by Torsten Thiel
            Very usable sample program

1st-View    Freeware by Guido Vollbeding
            File viewer

WINX        Freeware by Martin Osieka
            Extended  screen-manager  for Single-TOS,  among other 
            things  permitting a greater number  of windows,  very 
            useful

ZFAX        (c) ZyXEL-Corporation
            Fax program for PCs under DOS


                                                           Glossary
-------------------------------------------------------------------
10.1. Glossary

Atari
  - A firm that,  in the 80s,  built good computers  but supported 
    them poorly. In the 90s it's building games consoles again but 
    has unfortunately retained the low standard of support.

AV-protocol
  - Standardised communications process between applications.  Can 
    at present  only be used to its full extent  under Gemini  and 
    Thing.  Ease supports  at least the elementary portions of the 
    AV-protocol.
    (See also: XACC-protocol).

Beta-testers
  - Special genus of user, irreplaceable  for program development. 
    Can only be pacified temporarily  through steady feeding  with 
    new  program (so-called  'beta'-) versions, otherwise grumbles 
    steadily. Terrible people!

Clipboard
  - The clipboard serves for the exchange of data in  standardised 
    formats between different programs.

Commercial software
  - Programs  sold commerically,  that you can only test after you 
    have bought them.
    (See also: Freeware, Shareware).

Cookie
  - An entry in the cookie-jar can fulfill various functions, such 
    as providing information  (what processor  is installed, say), 
    or discovering program functions made available by one process 
    to others.

Diablo emulator
  - If you have a laser printer  from Atari  (SLM804, SLM605), you 
    have to install  the Diablo emulator  to be able to print with 
    'Look'n See'. The way to do this will be found in the handbook 
    for your printer.  Version 1.6  of the emulator is the current 
    one.

DMA-sound
  - Special hardware extension to replay ->Samples without the aid 
    of the central processor in the background.  Only found in the 
    STE/TT and Falcon, but fitted as standard in them.

Email
  - 'Electronic  mail'.  A form of communication by which letters, 
    programs and news can be exchanged via the telephone line. The 
    author of 'Look'n See'  can be reached  by Email  either under
    'Reiner Rosin @ WI2' (in the  ->MausNet)  or under the address 
    'Reiner_Rosin@wi2.maus.de' (in the Internet).

Environment
  - Configuration area in memory where users can  pass information  
    to started programs. Apart from the programming fraternity, it 
    leads a rather shadowy existence on the Atari.  DOS-users will 
    surely know the 'PATH' line in the AUTOEXEC.BAT file where one 
    informs DOS where it should look for batch- and EXE-files.

Extender, Extension
  - Also called file extension:  The three letters after the point 
    following the file name. It has become usual to assign certain 
    extensions to some  frequently encountered file types  to make 
    them easier to classify (e.g. TXT, IMG and many others).

Freeware
  - Programs to which the author attaches no financial strings for 
    their use or distribution.  Often such programs  belong to the 
    best that exist (e.g. WINX, Let'em Fly). 
    (See also: Commercial software, Shareware).

Fuzzy logic
  - Alternative to the customary, binary, logic.  Instead of using 
    absolute concepts (1 and 0, 'true' and 'false'), relationships 
    are classified on a more extended scale. This corresponds more 
    closely to the way people evaluate things in practice.
    (See also: Levenshtein-distance).

Iconifying
  - Part of the user interface. Specially under ->Multitasking one 
    can easily lose a clear view when too many windows are open at 
    once.  With iconifying  one reduces windows  not needed at the 
    time to a minimum size and lines them up next to each other at 
    the bottom edge of the screen.

Levenshtein-distance
  - Numerical value  that expresses the 'similarity' of two words. 
    Used in 'Look'n See' for searching in texts  for words/phrases 
    whose spelling one is not quite sure about.

MausNet
  - Private mailbox net, with some 100 nodes in Germany  and three 
    participants in Austria and Switzerland.  The fastest and most 
    reliable private net, strongly Atari biased and always worth a 
    few telephone units (if you can understand German).

Maus WI2
  - The secret loony-bin of the ->MausNet.  If the line isn't busy 
    for a change one can feel right at the top of the world on the 
    lowest intellectual plane here.
    Number: 00 49 611 9419126
    Here will also be found the current versions of 'Look'n See'.

Microwire
  - Part of the  ->DMA-sound hardware  in theTE/TT   and   Falcon. 
    Describes the interface between the processor and DMA-sound.

Module
  - Program portion  that is not contained  in the actual  program 
    code but is loaded in later when required. This concept offers 
    advantages for the programmer and the user: The program can be 
    extended at any time by third parties;  one only needs to load 
    in those parts of the program  that one actually wishes to use 
    (saving memory usage).

Multitasking
  - (Quasi-) simultaneous usage of several programs (->Process) in 
    parallel. Only possible to its full extent on the Atari ST/TT/
    Falcon since ->MTOS and Mag!X.

Multi-TOS, MTOS
  - ->Multitasking-capable operating system version by Atari.

Palette image
  - Colour image  in which the maximum number of colours  that can 
    appear is limited.  In practice  this means that although some 
    16 million colour shades may be possible,  only 256 colours at 
    most may appear in the image, for instance.
    (->True-colour images).

Parallel starting of programs
  - Starting  of a  program  from within  a  ->Process,  where the 
    starting process is not ended afterwards  but continues to run 
    independently of the started program.
    (See also: Multitasking)

Process
  - Description of a program or desk accessory  loaded into memory 
    and started. Besides this there are also system processes such 
    as the screen-manager and the desktop, for instance.

Popup
  - Selection  menu  that only appears  after a  mouse click  on a 
    dialog object.

Sample
  - Digitalised  portion  of music  or speech.  The latter  can be 
    particularly  witty:  If, for instance,  the phrase  'You have 
    removed Spock's brain'  issues from the loudspeaker  after the 
    computer has crashed, while this doesn't reverse the crash  it 
    does, at least, give one something to smile about - if one has 
    saved one's work shortly before this. But usually one hasn't...

Sarcasm
  - Part of my life's philosophy  and the only productive reply to 
    reality.  'Fight hunger in the world - eat more blacks!'.

Shareware
  - Special form of software.  Wildly optimistic programmers  once 
    believed that one could sell programs by allowing free copying 
    and distribution, trusting the honesty of users to pay the due 
    fee after a shortish try-out period. Unfortunately this didn't 
    work,  which is why  recently  many have built in restrictions 
    that are only lifted on payment of the shareware fee.
    (See also: Commercial software, Freeware).

Single-tasking
  - Opposite of ->Multitasking, i.e. a system environment in which 
    only one program can be active in memory at any given time. In  
    fact  there never was  true single-tasking under  ->Single-TOS  
    but only an extended form, as desk accessories  were parallel-
    running processes in a limited way.

Single-TOS
  - Description of all TOS versions before Multi-TOS, with each of 
    which only ->Single-tasking was possible.

3D display
  - Has brought me to the edge of despair  and even pushed me over 
    it!  It is a design feature  introduced by Atari with MTOS and 
    the Falcon AES  where all objects in windows  and dialogs take 
    on a three-dimensional (solid) appearance in the higher colour 
    resolutions. If one gets it wrong, everything goes black.  But 
    even if one  gets it right,  there will be  a bitter awakening  
    with the next  MagiC  release at the latest, because in MagiC, 
    naturally, everything has to be solved in a different way once 
    again.

True-colour image
  - Image with direct colour assignment, meaning that  any picture 
    point  (pixel)  can have  any desired colour value  within the 
    available colour-space.  The quality  depends only on the size 
    of the colour-space, with 5 or 8 bits per primary colour (red, 
    green and blue) being usual. -> Palette image.

Voice-file
  - Special form of a ->Sample.  Is created by modems that include 
    a telephone answering mode.  The quality  is not  something to 
    shout about (though noise is perhaps  not an absurd expression 
    here), but in return the compression factor  is very high.  If 
    one uses the computer as a combined fax/data/answering station 
    then this is something not to be sneezed at.

XACC-protocol
  - A further communications protocol  for data exchange between a 
    number of ->Processes.
    (See also: AV-protocol).


10.2. Footnotes

[1] Two  programs  that  are  not  only  extraordinary  pearls  of
    software art, but also originate from me.

[2] For this statement  I once had to endure  a scolding  from our
    favourite fireman Rolf 'Grisu Backdraft' Bensch.

[3] This is just the right moment  to mention  'our mole'  Patrick
    Glanz.  Though he has very little to do with 'Look'n See',  he
    has a lot to do with samples. He is responsible, for instance,
    for the  first sample  with  official approval  by the  postal
    authorities.  This sample is available from me on request, and 
    is  also  included  on  the  'Look'n See'  distribution  disk. 
    Patrick himself is colour-blind and not available on disk. Not
    even on request. He also does not have a large-screen monitor.

[4] Cynics  maintain  that  'Look'n See'  is anyway  just a module 
    interface surrounded by a bit of visual frippery. But one does 
    not have to take that too seriously, specially when that cynic 
    is then mutated  to a  'Lddernielfhrt' (rinocerus benschus) 
    and pumped full of Pentium-dope of the Highscreen brand.

[5] You can also send any other amount to any other recipient. But 
    that won't get you any closer to receiving the desired key for 
    'Look'n See'. So you'd better pay me or my representative!

[6] Evidently  we are dealing here  with not just the  most widely 
    sold desktop but also the one most infrequently used. At least 
    no one could advise me about this matter...

[7] I know the name is far from aposite.  But since no one took up 
    my offer to create a better one, receiving a free registration 
    in return, it will have to do.

[8] Naturally one can't really transform a  Herr Meyer into  Maier 
    by exchanging a pair of letters.  That would require  far more 
    comprehensive geneto-technical manipulations!

[9] Since otherwise one would not see how ingenious a programmer I
    am  (self-praise, I know!),  I would like to refer here to the 
    fact  that the search routine runs at turbo-speed not only due 
    to machine-code programming, but also clever optimisation. I'd 
    like to see anyone else do this!

[10] Though this time I have cunningly dropped him in it and wrote 
     the hypertext myself behind his back. Sorry, Dirk, but I just 
     wanted to try it out for myself. 

[11] Yes, the name is real.  Yes, we have checked this.  No, he is 
     not related to the Highlander.

[12] In addition he has broken my mains power-unit and cut off the 
     current to my torch as well as my pocket calculator. For this 
     he deserves  no thanks - I only  mention it  for the  sake of 
     completeness.

[13] Gerhard, who has his problems ...

[14] Greetings to Helge Schneider. 

[15] Also pinched from Helge.

[16] Now the layman will get a huge shock  and wonder what kind of 
     totally screwed up program he has got hold of.  Have no fear, 
     that is absolutely not the case!  Something like this will be 
     found in the documentation of any program today and is really 
     quite meaningless, though it does provide legal protection.

[17] Those who still do not know what  MagicMac is  should at once 
     run to the nearest Apple dealer  and take a look at it.  I am 
     typing this text, for instance, on an Apple Power-Book at 26
     in the shade on my balcony. It works like a dream!

[18] EOF stands for 'End of file'  and only means than there is no 
     point looking any further.


-------------------------------------------------------------------
10.3. Index

0.1.     Introduction
0.2.     Quick start
0.3.     New in Version 0.95
1.       General
1.1.     A few words of introduction
1.2.     File types supported
1.2.1.   (Monochrome) graphics
1.2.2.   Colour pictures
1.2.3.   Texts
1.2.4.   Hex-dumps
1.2.5.   Samples
1.2.6.   Resource files
1.2.7.   Fonts
1.2.7.1. GDOS fonts
1.2.7.2. Calamus fonts
1.2.8.   GEM metafiles
1.2.9.   virtual files
1.2.10.  Other formats
1.3.     Status
1.3.1.   Shareware restrictions
1.3.2.   Registration
1.3.3.   The author
1.3.4.   Distribution
1.4.     Installation
1.4.1.   PRG
1.4.2.   ACC
1.4.3.   Module
1.4.4.   Set 'Options' parameters
1.4.5.   Installation as a file-viewer
1.4.5.1. Atari desktop
1.4.5.2. Ease
1.4.5.3. Gemini
1.4.5.4. Thing
1.4.5.5. MagX-Desk
1.4.5.6. Neodesk
1.4.6.   The Help-system
1.4.7.   Use with MagicMac
2.       'Look'n See' and windows
2.1.     The 'Info' window
2.2.     File list
2.3.     Help
2.4.     Window dialogs
2.5.     Data windows
3.       Structure of the menu-bar
3.1.     'Look'n See' menu
3.1.1.   'About 'Look'n See...'
3.2.     'File' menu
3.2.1.   'Open...'
3.2.2.   'Re-load'
3.2.3.   'Load clipboard'
3.2.4.   'Import data...'
3.2.5.   'Close'
3.2.6.   'Close all'
3.2.7.   'To editor'
3.2.8.   'Quit'
3.3.     'Windows' menu
3.3.1.   'Cycle'
3.3.2.   'Arrange'
3.3.3.   'Info window'
3.3.4.   'File list'
3.3.5.   Data windows
3.4.     'Extra' menu
3.5.     'Options' menu
3.5.1.   'System...'
3.5.2.   'Windows...'
3.5.3.   'Printer...'
3.5.4.   'Module list...'
3.5.5.   'Module options...'
3.5.6.   'Programs...'
3.5.7.   'Font...'
3.5.8.   'Color pictures...'
3.5.9.   'Samples...'
3.5.10.  'Default paths...
3.5.11.  'Fuzzy search...'
3.5.12.  'Registration...'
3.5.13.  'Save options'
4.       File-specific functions
4.1.     File list
4.1.1.   'Abandon list'
4.2.     Images
4.2.1.   'Apply module...'
4.2.2.   'Export...'
4.2.3.   'Print'
4.2.4.   'Copy block'
4.2.5.   'Save IMG...'
4.3.     Texts
4.3.1.   'Apply module...'
4.3.2.   'Export...'
4.3.3.   'Print'
4.3.4.   'Copy block'
4.3.5.   'Find...'
4.3.6.   'Find next'
4.3.7.   'Hex display'
4.3.8.   'To editor'
4.3.9.   'Display...'
4.4.     Hex-dumps
4.4.1.   'Apply module...'
4.4.2.   'Export...'
4.4.3.   'Print'
4.4.4.   'Copy block'
4.4.5.   'Find...'
4.4.6.   'Find next'
4.4.7.   'ASCII display'
4.4.8.   'As sample'
4.4.9.   'To editor'
4.4.10.  'Display...'
4.5.     Sound samples
4.5.1.   'Apply module...'
4.5.2.   'Export...'
4.5.3.   'Play'
4.5.4.   'Stop output'
4.5.5.   'Negate bit 7'
4.5.6.   'Frequency'
4.5.7.   'Save IMG...'
4.5.8.   'Hex display'
4.5.9.   'To editor'
4.6.     Resource files
4.6.1.   'Next tree'
4.6.2.   'Previous tree'
4.7.     GDOS fonts
4.8.     Calamus fonts
4.9.     Virtual ASCII files
4.9.1.   'Print'
4.9.2.   'Find...'
4.9.3.   'Find next'
4.9.4.   'Hex display'
4.10.    Virtual hex-dumps
4.10.1.  'Print'
4.10.2.  'Find...'
4.10.3.  'Find next'
4.10.4.  'ASCII display'
4.11.    GEM Metafiles
4.11.1.  'Original size'
4.11.2.  'Whole page'
4.12.    Colour images
4.12.1.  'Apply module...'
4.12.2.  'Export...'
4.12.3.  'Grey transform...'
4.12.4.  'Monochrome dither..'
4.12.5.  'Reduction module...'
4.12.6.  'Save colour image'
5.       Keyboard operation and mouse control
5.1.     Keyboard operation
5.1.1.   In the dialogs
5.1.2.   Globally valid keyboard shortcuts
5.1.3.   Only partially valid shortcuts
5.1.4.   The [Alternate] key
5.1.5.   Iconifying
5.2.     Mouse control
6.       Things you should know about 'Look'n See'
6.1.     The INF file
6.2.     The clipboard
6.3.     Discrimination between various file formats
6.4.     Recognition of ASCII texts
6.5.     Fuzzy search via the Levenshtein-distance.
6.6.     The input of search-strings for hex-searches
6.7.     The MCWR cookie
6.8.     Replaying of sound samples
6.9.     How 'Look'n See' starts external programs
6.10.    Communication with external programs
6.10.1.  The XACC-protocol
6.10.2.  The AV-protocol
6.10.3.  The VIEW-protocol
6.10.4.  Drag&Drop
6.10.5.  xFSL / UFSL / Font protocols
6.10.6.  SNAP
6.11.    Iconifying also without MTOS
6.12.    ICFS
6.13.    This is how 'Look'n See' treats colour images
7.       The modules
7.1.     Loading the modules
7.2.     Import modules
7.3.     Source modules
7.4.     Processing modules
7.5.     Print modules
7.6.     Dithering and reduction modules
7.7.     Sample output modules
7.8.     Export modules
7.9.     The bundled modules
8.       For programmers: The module interface
9.       Final observations
9.1.     Author
9.2.     Thanks
9.3.     Disclaimer
9.4.     Known Bugs
9.5.     Future outlook
9.6.     Names and trademarks used
10.1.    Glossary
10.2.    Footnotes
10.3.    Index


-EOF- [19]

