               Instructions for 'Look'n See' modules

                           July 1995


                        'Look'n See' Module instructions: General
-----------------------------------------------------------------

This description documents  the position of module developments on
the 17.7.95.  By the time  of publication of this text  there will
probably have been further changes in the version numbers  and the
range of functions  offered --  perhaps there are even one or more
new modules present.

The modules originate from various authors, who permit the use of
the  modules themselves, or their  source codes,  under differing
conditions. Common to all modules is that they can be distributed
free together with  'Look'n See',  and may be used without charge
for private use with 'Look'n See'.

One plea  from the 'Look'n See' program author: The authors of the
modules  have so far received  their remuneration only in the form
that every few weeks I altered the module interface  and thus gave
them further work to do!  Most of the power of 'Look'n See' in the
processing  of colour pictures, in particular,  lies in the import
modules  from  Dirk  and John  as well as in  Thorsten's  fabulous
ditherer.  Those who love colourful pictures  should find it close
to their heart to reward the module authors  with additional small
donations when registering (nasty, these begging orgies, I know!).

The module sources  mentioned repeatedly in these instructions are
not included in the distribution version of 'Look'n See' for space
reasons, but only in the developer's archive for 'Look'n See'.

                                  Modules (c) Alexander Halbritter
------------------------------------------------------------------

MOMO.MDL     -> Processing  module, text:  Converts text  to morse
                code characters. Sends text in morse code.

ENTROPY.MDL  -> Processing module, text: Generate text statistics.

FEED_ME.MDL  -> Processing module, text: Alter line endings.

UUENCODE.MDL -> Processing module, binary: UU-code a file.

UUDECODE.MDL -> Processing module, text: Decode a UU-encoded file.

The modules are  'CardWare'.  Everyone using the modules regularly
should send me a postcard (or even better a picture postcard).
These incidentally  also have plenty of room  for suggestions  and
criticism.

Otherwise the modules may and should be  distributed unchanged for
non-commercial purposers.

Where to write?
Well, to
              Alexander Halbritter
              Freienbornstr. 19
              D-65343 Eltville

              Email: Alexander_Halbritter@WI2.maus.de


                                          Modules (c) by Dirk Haun
------------------------------------------------------------------

BRIGHTEN.MDL -> Processing module, colour images, for altering the
                brightness of images.

GIF.MDL      -> Import module, colour images, for GIF pictures.

FLI.MDL      -> Import module,  colour images,  for  FLI- and FLC-
                animations.

HTDITHER.MDL -> Dither module, halftone algorithm.

ICO.MDL      -> Import module, colour images, for Windows icons.

NOBORDER.MDL -> Processing  module, colour images, for cutting off
                image borders or margins.

PS2TXT.MDL   -> Import module, text, for PostScript files.

REDUCE.MDL   -> Dither module, reducer for 256 colour images.

REFLECT.MDL  -> Processing  module,  colour images,  for adding  a
                reflection to images.

SHOWDOC.MDL  -> Import module, text, for Wordplus documents.

SHOWSND.MDL  -> Import module, sound, for various formats.

SOUNDEXP.MDL -> Export module, sound, for HSN samples.

STG2ASC.MDL  -> Import module, text, for ST-Guide source texts.

TARGA.MDL    -> Import module, colour images, for the Targa format.

TARGAEXP.MDL -> Export module, colour images, for Targa images.

TSWS.MDL     -> Import module for Dirk's own Info-file format.

WRITE.MDL    -> Import module, text, for Windows-Write documents.

XIMG.MDL     -> Import module, colour images, for XIMG images.

These modules are Freeware, as are the source codes included for
most modules.

The author of these modules can be reached in the following ways:

 By snail-mail:

        Dirk Haun
        Europastr. 8
        D-64569 Nauheim

 By Email:

        Dirk Haun @WI2 (MausNet)


Suggested reading:

   'Computer Graphics - Principles and Practice'
   Foley, van Dam, Feiner, Hughes
   Addison-Wesley, 1990
   ISBN  0-201-12110-7


Standard disclaimer:

These modules  fulfil their objects  for me,  which does not  mean
that they will do this everywhere.  So should one of these modules
do something unexpected, I cannot be held responsible for any sort
of damage caused thereby (whatever it may be)  --  you use them at
your own risk.

Incidentally,  I'd like to point out that I am in no way connected
with, or related to Addison-Wesley publishers and I keep on citing
the above-mentioned book simply becauase it is a good one :-)


                                        Modules (c) by John McLoud
------------------------------------------------------------------

IFF.MDL      -> Import module, colour images, for the IFF format.

PCX.MDL      -> Import module, colour images, for the PCX format.

JPEG.MDL     -> Import module, colour images, for the JPEG format.

JPEG_EXP.MDL -> Export module, colour images, for the JPEG format.

MAC_DEG.MDL  -> Import module, colour images, for the Degas format.

SIG2TXT.MDL  -> Import module, text, for Signum2 documents.

SAY_IT.MDL   -> Processing module, text: Speak text aloud.

TIFF.MDL    -> Import module, colour images, for the TIFF format.


Contact address

The module author can be reached in the following ways:

 By letter/packet post

   John McLoud
   Mozartstrae 1a
   D-65439 Flrsheim am Main

 By Email

   John Mcloud @WI2 (MausNet)


Standard disclaimer

An acquaintance, who I won't identify further, would say 'It works
for me'.  If it doesn't for you, then I would ask that you send me
a detailed bug report (a sample image is always most helpful).

The use of the modules should actually cause no damage,  but if it
does, bad luck. I will not accept any kind of liability. After all
their use is free of charge.


                                     Modules (c) by Andreas Papula
------------------------------------------------------------------

ZIP.MDL   -> Import module, ASCII: Display contents of ZIP archives.


Disclaimer

No liability is accepted  for any kind of damage  arising from the
use of the module. You use it at your own risk.


Contact address

The author of the module can be reached in the following ways:

 By snail-mail:

   Andreas Papula
   Rmerstrae 20
   D-65205 Wiesbaden - Delkenheim
   Tel.:00-44-6122-52676

 By Email:

   Andreas Papula @WI2       (MausNet)
   andreas_papula@wi2.maus.de (Internet)


                                  Modules (c) by Thorsten Pohlmann
------------------------------------------------------------------

ADPCM.MDL    -> Import module, sound: ZyXEL voice-files *.ZY2 and
                *.ZY3 to 8-bit signed Sound.

APPENDIX.MDL -> Processing module, text: Join text-blocks together.

BMPMAN.MDL   -> Import module, graphics, for unpacked Windows BMPs.

BMPEXP.MDL   -> Export module, colour images, for the BMP format.

BMPEXP_M.MDL -> Export  module,  monochrome  images,  for the  BMP
                format.

BW256.MDL    -> Import module, graphics, for B&W greyscale images.

CHAINSAW.MDL -> Processing module, text: Cuts length of lines.

COMPRESS.MDL -> Processing module, sound: Volume compressor.

CUTPIC.MDL   -> Processing module, colour images: Cuts out block.

CUTSUP.MDL   -> Processing module, text: Cuts out column blocks.

IGOR_DIT.MDL -> Reduction module, graphics: TC/HC -> dither 256/16
                colours, TC/HC -> map 256 colours, dither b/w.

GIFEXP.MDL   -> Export module, colour images, for the GIF format.

MUTANT.MDL   -> Sample output module for computers with DMA-sound.

NEOMOD.MDL   -> Import module, graphics: Neochrome images.

PRUPTOR.MDL  -> Sample output module: Output via the sound-chip.

ROTATOR.MDL  -> Processing module, colour images: Rotate picture.

RUPTOR.MDL   -> Sample output module: Output via external hardware.

SOFTIE.MDL   -> Processing module, text: Create flowing body-copy.

SUCKER.MDL   -> Source module, sound: Record samples.

TABSPACE.MDL -> Processing module, text: Remove tabs from text.


The modules are 'Fireware',  meaning that those who like them  and
cannot live without them should add an extra two DM (or a quid) to
the registration fee they send  to Reiner Rosin or Joe Connor.  If
there is enough, it will help to quench my thirst at the next Maus
get-together, I hope! Don't forget to record it on the transfer or
other payment slip.


These modules may/should be distributed without any changes.  They
may be included  with other  'Look'n See'  modules in this form as
long as a sum >3 DM (1.20) is not demanded.
The sources are so scrambled that those who make sense of them may
also use them (non-commercially).

Flames, suggestions  etc. for _these, my_  modules should _not_ be
sent to Reiner Rosin, but directly to me:

       Email: Thorsten Pohlmann@WI2.maus.de
            o. 2:244/2113.8 (FIDO)

       Thorsten Pohlmann
       Frauensteinerstr. 15
       D-65199 Wiesbaden


                                       Modules (c) by Reiner Rosin
------------------------------------------------------------------

BITMAP.MDL    -> Processing module, graphics: Halving/doubling the
                 size of monochrome images.

BLD_IMP.MDL   -> Import module, graphics, for MegaPaint files.

COL_FUNC.MDL  -> Processing module, colour images:  Doubling size
                 of colour images.

COL_INFO.MDL  -> Processing module, colour images: Count colours.

ELIMINAT.MDL  -> Dither module, graphics: Colour reduction.

ESM.MDL       -> Import module, graphics, for ESM files (tms).

FAX300.MDL    -> Processing module, graphics: Fax preparation.

GDPSSCAN.MDL  -> Source module, graphics: Scan with GDPS driver.

GREP.MDL      -> Processing module, text: Search for text fragments.

GREY_MAN.MDL  -> Processing  module, graphics: Convert monochrome
                 images to greyscale.

HEX_EXT.MDL   -> Processing module, binary data:  Extract  strings
                 of text.

HIR.MDL       -> Import  module,  colour images,  for  greyscale
                 pictures from the Print-Technik digitizer.

INVERTER.MDL  -> Processing module, graphics: Invert mono images.

MAC_SAMP.MDL  -> Sample output module: XBIOS sound output.

MED_CUT.MDL   -> Dither module, graphics: Median-cut algorithm.

MONIKA.MDL    -> Source module, binary files: Memory monitor.

PAL_SORT.MDL  -> Dither module, graphics: Sort palette.

PHOTO_CD.MDL  -> Import module, colour images, for Photo-CD pics.

PIC2ASC.MDL   -> Processing module, colour images:  Convert  image
                 to ASCII.

PIC_CUT.MDL   -> Processing module, graphics: Cut off image margins.

PIC_DBL.MDL   -> Processing module, graphics:  Double the size  of
                 mono images.

PIC_EXP.MDL   -> Export module, graphics, for 32K Screen-format PIC.

PIC_TURN.MDL  -> Processing module, graphics: Rotate images.

PREVIEW.MDL   -> Processing module, text:  Create a 'greeked' page
                 miniature preview.

PUZZLER.MDL   -> Processing module, colour images: Jigsaw images.

QFAX.MDL      -> Export module, graphics: Create fax for QFAX/Coma.

RAMBO.MDL     -> Dither module, graphics: Colour reduction.

R_G_SWAP.MDL  -> Processing module, colour images:  Swap  red  and
                 green colours.

SAMPCALC.MDL  -> Processing module, sound: Increase the volume  of
                 samples.

SAMP_CUT.MDL  -> Processing module, sound: Cut samples.

SAMPMIRR.MDL  -> Processing module, sound: Play sample in reverse.

SHOWBLK.MDL   -> Import module, graphics, for GFA-Basic GET blocks.

SHOWFNT.MDL   -> Import module, graphics, for GEM fonts.

SHOWPIC.MDL   -> Import module, graphics  for Doodle images (32K).

SHOWZYX.MDL   -> Import module, sound, for ZyXel voice-files.

SIG2FONT.MDL  -> Import module, graphics, for Signum2 fonts.

SRC_DMAS.MDL  -> Source module, sound: Read out DMA-sound.

SRC_SCRN.MDL  -> Source module, graphics: Copy screen.

TINYDITH.MDL  -> Dither module, graphics: Various ditherers.

UML_CONV.MDL  -> Processing module, text: Umlaut-converter.

XIMG_EXP.MDL  -> Export module, colour images, for the XIMG format.


My modules are released for use exclusively in  'Look'n See'.  The
source codes that I have published may be used non-commercially as
long as source codes, or programs based on it, contain a reference
credit to the original source.


I can be reached at:

        Rosin Datentechnik
        Reiner Rosin
        Peter-Spahn-Str. 4
        D-65375 Oestrich-Winkel

        Telephone 00-49-6723 4978  Fax 7190

        Email: Reiner Rosin @WI2 (MausNet)
               Reiner_Rosin@wi2.maus.de


                                    Modules (c) by Andreas Schrell
------------------------------------------------------------------

EPSEXP.MDL    -> Export module, graphics, for EPS format (Encapsu-
                 lated PostScript).


The module is Freeware.

Contact address:

       Email: Andreas Schrell @RS        (MausNet)
              Andreas_Schrell@s.maus.de


                                    Modules (c) by Reiner Wiechert
------------------------------------------------------------------

PIN2LAS.MDL   -> Processing  module,  graphics:  Converts  180 dpi
                 graphics to 300 dpi.

UNIVERSE.MDL  -> Processing module, graphics: Universal scaler.


Status:   Freeware

Contact address:
        Reiner Wiechert
        Rathausstrae 1
        D-85521 Ottobrunn

        Fax: 00-49-89 609 39 48
        Email: Reiner Wiechert @M


                                       Modules (c) Ralf Zimmermann
------------------------------------------------------------------

LINESORT.MDL  -> Processing module, text: Sort lines.

WORDLIST.MDL  -> Processing module, text:  Create word-list.


Status: These modules are Freeware.

Contact address:
        Ralf Zimmermann
        Am Ruhwehr 35
        D-65207 Wiesbaden

        Email: Ralf Zimmermann @OF2
                                                             ADPCM.MDL
----------------------------------------------------------------------

Module name:   ADPCM.MDL
Module I.D.:   ADPCM
Module type:   Import module
Author:        (C) Toastware
Versions No:   00.03
Version date:  Oct 31 1994


Import module, sound: Converts  ZyXEL voice-files  *.ZY2, *.ZY3 to
                      8-bit signed Sound


Description:

Enables 'Look'n See' to load Zyxel voice-files (*.ZYX) too.
CELP-compression  is not yet supported,  but coding to ADPCM2  and
ADPCM3 (most widely distributed format) is.


                                                           BLD_IMP.MDL
----------------------------------------------------------------------

Module name:   BLD_IMP.MDL
Module I.D.:   R_MP
Module type:   Import module
Author:        Reiner Rosin
Versions No:   00.01
Version date:  Feb 28 1995


Purpose:

This module  allows  'Look'n See'  to import  packed  and unpacked
drawings in the MegaPaint format.


Limitations:

This has been tested with just two pictures,  for which I even had
to analyse the format myself. This means that errors may occur!

'BLD' could almost be a DOS format, since, thankfully,  it forgoes
a fixed I.D.  in the  header.  With unpacked images  one can still
tease out a little from the file length but with compressed images
the extension has to be '.BLD'!


                                                            BMPMAN.MDL
----------------------------------------------------------------------

Module name:   BMPMAN.MDL
Module I.D.:   BMPMAN
Module type:   Import module
Author:        (C) Toastware
Versions No:   00.03
Version date:  Oct 31 1994


Description:

Imports unpacked 24-, 8-, 4- or 1-bit Windows(TM) and BMP bitmaps.
Packed files are not supported.


                                                             BW256.MDL
----------------------------------------------------------------------

Module name:   BW256.MDL
Module I.D.:   BW256
Module type:   Import module
Author:        (C) Toastware
Versions No:   00.02
Version date:  Oct 31 1994


Description:

Importer for GEM-View dither matrices.  It is not known where this
format originated (probably AIM).


                                                               ESM.MDL
----------------------------------------------------------------------

Module name:   ESM.MDL
Module I.D.:   R_ES
Module type:   Import module
Author:        Reiner Rosin
Versions No:   00.02
Version date:  Oct 30 1994


Description:

With this one can import ESM files into  'Look'n See'.  The imple-
mentation was effected  from a format document from  tms  and  two
demo images,  i.e. one can in no way talk about an extensive test-
phase.

Features and shortcomings:

- TrueColor images are supported (tested).
- Greyscale and b/w images are supported (untested).
- CMY, CMYK and RGB colour separations are not supported.
- Images divided into several strips could give rise to crashes.
- The CLUT is not evaluated.  It seemed  pointless to me  to index
  every colour value in a TC image again via a table -- that would
  appreciably prolong the loading time.


                                                               FLI.MDL
----------------------------------------------------------------------

Module name:   FLI.MDL
Module I.D.:   FLIV
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.02
Version date:  Oct 27 1994


Description:

This module imports the first frame  of a FLI- or FLC-animation as
a colour image into 'Look'n See'.

'Look'n See' does not (yet?)  have any animation modules,  so this
is just an elementary way to take a glance at an animation. If you
are disappointed by the displayed image (say because it only shows
a single-coloured area or a few lines),  then please remember that
you are dealing with  an animation _sequence_  and the interesting
parts may only follow later. No, there is no possibility to take a
peek  at the other frames  of the  animation --  at least not with
'Look'n See'.

The Info window,  besides the animation type  (not everything that
is called 'FLI' is actually a .FLI file) will also show the number
of frames it contains.


                                                               GIF.MDL
----------------------------------------------------------------------

Module name:   GIF.MDL
Module I.D.:   QGIF
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   01.00
Version date:  Apr  4 1995


Description:

This module imports images in the well-liked GIF formats ('GIF87a'
and 'GIF89a') into 'Look'n See'.

Speed:
After I was nagged long enough, I re-wrote the module in assembler
in place of the original C (more exactly only the actual unpacking
routine). The increase in speed is at least 40% (compared to the C
version) and I believe that the result keeps pace with other Atari
GIF-viewers.

Defective pictures:
- One often comes across  defective GIFs.  The module  attempts to
  unpack the image  as far as possible.  Depending on  the type of
  image and the defect, the result may in some circumstances still
  be of (limited) use.   A corresponding note ('Image is obviously
  defective') will appear in the Info window. For the curious, the
  type of error will also be displayed:

      No.  Meaning
      1    No EOF-code found
           The end of the picture data was reached but no EOF-code
           came to light. Either a part of the picture is missing,
           or the size specification in the header is incorrect.

      2    LZW 'runs amock'
           Due to an error in the file the unpacker produces non-
           sensical data or a nonsensical amount of it.

      3    Unexpected EOF
           An EOF-code was found although not all the picture data
           had been unpacked yet.  Probably the size specification
           in the header was incorrect.

      4    Missing Free-code
           The table of the unpacker is full up,  and instead of a
           Free-code (clear table) more data arrive to be inserted
           in the table.

One finds errors 1 and 3  quite freuently,  and in most cases  the
picture still remains usable.  GIFs with errors 2 and 4 are usualy
fairly broken...

P.S.: This module is Freeware and is therefore not affected by the
licence fees that Compu$erve has recently tried to impose  for use
of the GIF format.


                                                               HIR.MDL
----------------------------------------------------------------------

Module name:   HIR.MDL
Module I.D.:   R_HI
Module type:   Import module
Author:        Reiner Rosin
Versions No:   00.01
Version date:  Jun 11 1995


Importer for greyscale pictures from the Print-Technik digitiser.


Description:

This module imports greyscale pictures originating from the Print-
Technik 'PRO-87' Video digitizer. I don't know much more about it;
I don't have such a digitizer and only two demo pictures, of which
one is home-made to boot. But as the format is  quite primitive, I
assume that the module works O.K.


                                                               ICO.MDL
----------------------------------------------------------------------

Module name:   ICO.MDL
Module I.D.:   ICOI
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.07
Version date:  Jul 15 1995


Description:

The 'ICO' label  for 'Windows' icons  apparently hides  (at least)
two different formats: Most common are ICOs  with a file length of
766 bytes.  There is a format  above this  that obviously contains
several icons  (or icons in various resolutions).  With the latter
the module attempts to find an icon with 16 colours.

In the present version the module should be able to read most (but
not yet all) ICO files (there is also, for example, a type of icon
with a file length of 1010 bytes whose build-up is again different
and which is at present displayed only  as a hex dump). I would be
very grateful  for references  to a description of this ICO format
(for my address, see below).

In order to be able to recognise anything  in such a small 'image'
(usually 32 x 32 pixels), the icon size is enlarged  to double the
size (i.e. normally 64 x 64 pixels). This can be adjusted however:
To do this, select  'ICO-importer' in the module dialog of 'Look'n
See' and click on 'Info'. If you now select the 'Parameter' button
you can choose between double and original size in the dialog that
appears. This setting will of course also be saved with the list.


                                                               IFF.MDL
----------------------------------------------------------------------

Module name:   IFF.MDL
Module I.D.:   JIFF
Module type:   Import module
Author:        John McLoud, Freeware
Versions No:   01.06
Version date:  Feb 17 1995


Description:

IFF.MDL imports images in the IFF format into 'Look'n See'.

The importer handles palette images with 2, 4, 16 and 256 colours.
Furthermore, HAM  and  HAM-8 files  will be imported as  TrueColor
images.

Note:

24-bit images are not supported at present, since the  AMIGA front
doesn't appear to have agreed quite how this is to be implemented.
I was definitely too lazy  to implement  all possible variants (no
one would pay for the time this would take, unfortunately,  and it
goes well beyond a hobby or my idealism).

Copyright

Lies completely with me! (with a little help by Dieter Fiebelkorn)


                                                              JPEG.MDL
----------------------------------------------------------------------

Module name:   JPEG.MDL
Module I.D.:   JJPG
Module type:   Import module
Author:        John McLoud, Freeware
Versions No:   01.24
Version date:  Mar 25 1995


Description:

JPEG.MDL imports images in the JPEG format into 'Look'n See'.

Both greyscale and TrueColor images according to JFIF and JPEG-RAW
definition are accepted.  Since V 1.11 32-bit JPEGs from PhotoShop
are also supported.

To overcome excessive memory demands one can, if desired, make the
colour depth of the loaded picture dependent on the current screen
resolution.

In the module dialog of 'Look'n See'  one can click on 'Info'  and
then set parameters after clicking on the 'Parameter' button.  The
JPEG.MDL permits selection of two import modes:

- Always use TrueColor
  The pictures will be passed to 'Look'n See'  as 24- or 32-bit TC
  images.

- Adapted
  This means that  when  running  under <= 16 bit resolutions  the
  module 'only' produces a HiColor image with 16 bit colour depth.
  Only when the current resolution has more than 16 bits  does one
  get a 'real' TrueColor picture.

Corresponding information about the colour depth  is output in the
'Look'n See' main 'Info' window.

If parameter support has not yet been implemented in  'Look'n See'
then an 'Adapted' picture will always be loaded.


Notes:
(1)
JPEG images require a great deal  of memory.  During the importing
process the module appropriates memory dynamically. This memory is
managed not by  'Look'n See'  but by the module.  Sometimes it may
happen that 'Look'n See'  can make sufficient memory available for
the image, but during the decoding the module 'runs out of steam'.
In such a case an alert appears referring to this;  afterwards the
image will be displayed as a hex-dump.

(2)
To prevent an excessive appetite  for memory,  the colour depth of
the displayed image will depend on the current screen resolution.

This means that with colour depths <= 16-bit  the module will show
'just'  a  HiColor  image  of 16-bit  depth. Only  if the  current
screen resolution  has a depth of  more that 16 bits  will one get
a 'real' 24-bit TrueColor image.

Corresponding  information  will be shown in the  Info  window  of
'Look'n See'.

(3)
32-bit JPEGs (e.g. from PhotoShop) still have a slight green cast.



Copyright

The module is based on source code from  'Independent JPEG Group's
software' and is therefore subject to their copyright.


                                                           MAC_DEG.MDL
----------------------------------------------------------------------

Module name:   MAC_DEG.MDL
Module I.D.:   JM&D
Module type:   Import module
Author:        John McLoud, Freeware
Versions No:   00.01
Version date:  Feb 19 1995


MAC_DEG.MDL  imports pictures  in the MacPaint  and  Degas formats
into 'Look'n See'.

DEGAS (ELITE)  PI1, PI2, PI3,  PC1, PC2 and PC3  pictures  will be
accepted. The extended TT modes (Px4-Px6) will be ignored.

Note:
This module has not yet had an extensive test  (in particular with
colour pictures).


                                                            NEOMOD.MDL
----------------------------------------------------------------------

Module name:   NEOMOD.MDL
Module I.D.:   NEOMOD
Module type:   Import module
Author:        (C) Toastware
Versions No:   00.02
Version date:  Oct 31 1994


Description:

Imports Neochrome (TM) images.


                                                               PCX.MDL
----------------------------------------------------------------------

Module name:   PCX.MDL
Module I.D.:   JPCX
Module type:   Import module
Author:        John McLoud, Freeware
Versions No:   01.05
Version date:  Feb 15 1995


Description:

PCX.MDL imports images in the PCX format into 'Look'n See'.

Images with 1, 4, 16 and 256 colours  as well as 24-bit  TrueColor
images are allowed.


                                                          PHOTO_CD.MDL
----------------------------------------------------------------------

Module name:   PHOTO_CD.MDL
Module I.D.:   R_PH
Module type:   Import module
Author:        Reiner Rosin
Versions No:   00.07
Version date:  Jun  5 1995


As the name says, this module imports Photo-CD pictures.  Since it
was hacked together  in 20 minutes, there are still a few defects,
but somehow it still tends to run. The list of shortcomings:

- I have no idea  exactly how  the PCD format is made up,  my only
  source of information is 20 lines of Pascal source-code. That is
  why the format identification,  for instance, is presently based
  on the fact that the file name extension is '.PCD'  and the file
  length exceeds 1 MB.
- Only the  uncompressed parts  of a Photo-CD picture  are loaded,
  i.e. BASE, BASE/2 or BASE/4 (768*512, 384*256, 192*128 pixels).
- Some pictures are loaded turned through 90 or 180 degrees.

Which of the three formats will be loaded can be set in the module
'Info' dialog.


                                                            PS2TXT.MDL
----------------------------------------------------------------------

Module name:   PS2TXT.MDL
Module I.D.:   PS2A
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.00
Version date:  Jul  9 1995


Description:

This module extracts ASCII texts from PostScript files.

Limitations:

The PS -> ASCII conversion is far from perfect. The module is only
intended to make it possible to take a quick peek at the text.

If the PostScript file does not contain any text, then a 'Contains
no text' message will appear instead.

The program on which the module is based contains special routines
for converting PS files that were produced with 'DVI2PS'. This has
to be selected with a switch when the program is called,  however,
and was therefore not suitable for a 'Look'n See' module. If some-
one has a PS file produced by 'DVI2PS',  and can give me a tip how
this can be differentiated from a 'normal' PS file,  then I may be
able to build this in.

Acknowledgements

This module is based  on the source code  of the 'PS2TXT' tool  by
Jason Black  (cloister@u.washington.edu)  and  Igbal Qazi.  The ST
version of said program originates from Ate Brink (ate@cs.ruu.nl).


                                                           SHOWBLK.MDL
----------------------------------------------------------------------

Module name:   SHOWBLK.MDL
Module I.D.:   R_BL
Module type:   Import module
Author:        (c) Reiner Rosin
Versions No:   01.20
Version date:  30. Oktober 1994


Description:

This module is unlikely to be of use to anyone but me. One can use
it to display monochrome bit-blocks that are produced by GFA Basic
with the 'GET' command.


                                                           SHOWDOC.MDL
----------------------------------------------------------------------

Module name:   SHOWDOC.MDL
Module I.D.:   ZDOC
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.13
Version date:  Oct 27 1994


Description:

This module imports text files in the 1st Word (Plus) 'DOC' format
as ASCII text into 'Look'n See'.  Since 'Look'n See' only supports
text in pure ASCII format, all the styling information (e.g. bold,
underlined etc.), footnotes and incorporated images  will be lost.
If the 1st Word Plus document  was formatted as fully justified or
ranged right, then that at least will be retained.


                                                           SHOWFNT.MDL
----------------------------------------------------------------------

Module name:   SHOWFNT.MDL
Module I.D.:   R_FN
Module type:   Import module
Author:        (c) Reiner Rosin
Versions No:   01.20
Version date:  30. Oktober 1994


Description:

With this module one can load screen fonts  in 8*16 or 8*8 format.
These fonts have no header (length is constant 4096 or 2048 bytes)
and may have one of two different formats:  The usual  GEM format,
in which the data are stored as a sort of bitmap  2048 pixels wide
and 16 or 8 bits high respectively, and the format used by STaD in
which all characters are arranged one after the other (virtually 8
pixels wide and 4096 or 2048 pixels high respectively). The module
attempts to distinguish these automatically,  which actually works
quite reliably.


                                                           SHOWPIC.MDL
----------------------------------------------------------------------

Module name:   SHOWPIC.MDL
Module I.D.:   R_PC
Module type:   Import module
Author:        (c) Reiner Rosin
Versions No:   01.20
Version date:  30. Oktober 1994


Description:

Import module for unpacked screen-dumps (fixed 32000 byte length)
which is also known as the Doodle format (DOO).


                                                           SHOWSND.MDL
----------------------------------------------------------------------

Module name:   SHOWSND.MDL
Module I.D.:   ZSND
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.35
Version date:  Jul  6 1995


Description:

This module  imports sound samples  into  'Look'n See'  in various
formats. The following formats in particular are supported:

 - Windows WAVE (*.WAV).
 - Creative voice-file (*.VOC).
 - Amiga IFF/8SVX.
 - AIFF (Apple).
 - AVR.
 - SoundMerlin.
 - SoundMachine.
 - SampleWizard.
 - The format of the DMA_PLAY.PRG program.
 - A format originating from Macintosh.
 - Samples of the 'Phnix' databank.
 - Several formats of unknown origin (FSSD, V8, SCRS).

The documentation  available to me  for these formats  varies from
very detailed (WAV, VOC) via sufficient (AVR, IFF)  to none at all
(Mac-SND, JON, FSSD, V8).  The aim was to be able to play anything
that even remotely looks like a sample, if possible.  With the un-
documented formats there is a possibility  that some files may not
be replayed correctly, since the file format has only been guessed
at.  But not all possibilities have been included yet even for the
well-documented formats.


Notes:

This module also handles SampleWizard files, although 'Look'n See'
can already handle this format.  However, I have some samples that
'Look'n See' replays incorrectly  (it isn't clear  whether this is
due to possible errors in these samples).  I have built in a work-
around for these - but it is possible that now  other SampleWizard
files will be replayed incorrectly.  This could be avoided if only
someone could refer me to documentation about this format ...

A propos documentation: If some WAV files are not played back  but
displayed as a hex dump on-screen instead, then this is due to the
fact that these are packed WAVs.  For these too  I do not have any
descriptive information.

The conversion from 16-bit samples  to 8-bit  is undertaken by the
module itself from Version 0.30 onwards, since 'Look'n See' simply
discards the lower byte, which often results in very flat envelope
curves.  The recalculation routine used is not necessarily a pearl
of programming art, but delivers audibly better results.


                                                           SHOWZYX.MDL
----------------------------------------------------------------------

Module name:   SHOWZYX.MDL
Module I.D.:   R_ZX
Module type:   Import module
Author:        (c) Reiner Rosin
Versions No:   01.10
Version date:  30. Oktober 1994


Description:

Importer for Zyxel voice-files.  In contrast to the ADPCM.MDL from
Thorsten one can only load 3-bit ADPCM-coded files with it. Thanks
to programming in assembler it is, however, some 6 times faster.


                                                          SIG2FONT.MDL
----------------------------------------------------------------------

Module name:   SIG2FONT.MDL
Module I.D.:   R_S2
Module type:   Import module
Author:        Reiner Rosin
Versions No:   00.01
Version date:  Jun 17 1995


With this import module  one can load  Signum2 fonts  into 'Look'n
See'.  Those supported are  screen fonts (.E24) as well as printer
fonts for 9-pin (.P9), 24-pin (.P24) and lasers (.L30), though the
9-pin support has not been tested due to lack of suitable fonts.

Signum3 fonts can NOT be displayed with this module!


                                                           SIG2TXT.MDL
----------------------------------------------------------------------

Module name:   SIG2TXT.MDL
Module I.D.:   JSIG
Module type:   Import module
Author:        John McLoud, Freeware
Versions No:   00.02
Version date:  Mar  9 1995


Description:

This module imports Signum2 documents into 'Look'n See'. But there
are some limitations:

- Images will be disregarded.
- There are no true space characters in Signum2 documents; instead
  the separation between characters is given in micro-spaces. It's
  therefore difficult to establish  whether two characters  follow
  immediately one after the other,  are blocked together (as in  a
  ligature), or whether there is a space between them;  this could
  only be done half-way reliably  by evaluating the  corresponding
  fonts to establish the width of individual characters. SIG2TEXT,
  on the other hand, uses a standard table which,  though it gives
  very usable results with most fonts, goes astray with some.


                                                           STG2ASC.MDL
----------------------------------------------------------------------

Module name:   STG2ASC.MDL
Module I.D.:   SG2A
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.05
Version date:  Jul 16 1995


Description:

This module  converts  the source  code  of an ST-Guide  hypertext
(*.STG) to ASCII.  The ST-Guide commands  will be removed and only
the actual text remains.

By inserting special commands  one can also control the conversion
and divide  the pages  of the hypertext  into chapters,  sections,
subsections, and an appendix.

Naturally  it is not necessary  to insert these commands,  but for
hypertext authors  this offers a simple method to also generate an
ASCII version of their text from the same source text.


STG2ASC commands:

The commands  for  STG2ASC  are inserted  into the source text  as
comments with the ST-Guide command  '@remark'. The special command
'@remark stg2asc' can be followed by the following command words:

  chapter       marks the following node (a page in the hypertext)
                as a chapter.
  section       marks the following node as a section.
  subsection    marks the following node as a subsection.
  appendix      marks the following node as a chapter  in  the
                appendix;  these chapters  will be marked with
                ascending letters rather than numbers.
  off           switches off output to the ASCII text,
  on            switches output to the ASCII text back on again.

The first node  will not receive a chapter number,  since normally
this will be the title page of the hypertext.

Note:  The 'remark' command,  like all ST-Guide commands,  must be
       prefixed with '@'.


Restrictions:

This module is only intended  to provide a simple means  to remove
commands from ST-Guide source texts. To be perfect, one would have
to reprogram the HCP compiler ...

The following problems and limitations are known:

- Texts in which ST-Guide commands are explained  (so the commands
  appear in the text itself)  can throw  STG2ASC  completely  (for
  example HCP.STG, STG2TEX.STG).

- The recognition that one is dealing with an STG file  could also
  apply in some circumstances  to some UDO source texts (*.U),  if
  many ST-Guide commands (with the UDO command !stg) are inserted
  at the start of such a file.

History

STG2ASC was originally  a stand-alone program  by Dirk Hagedorn. I
then undertook a few small corrections and additions,  and finally
transformed it into a module for 'Look'n See'.  Dirk Hagerdorn has
nothing more to do with the module in its present form,  so please
send any bug reports and flames to me (see 'contact address').


                                                             TARGA.MDL
----------------------------------------------------------------------

Module name:   TARGA.MDL
Module I.D.:   TGAI
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.31
Version date:  Oct 27 1994


Description:

This module imports images in the Targa format (TGA) into  'Look'n
See'. Currently the module recognises images with 2 colours (mono-
chrome), palette images with up to 256 colours, as well as HiColor
and  TrueColor images  (16 or 24 bits per pixel  respectively), in
each case unpacked or RLE-packed.

Unfortunately  I had to collect  the information  about the  Targa
format from the most varied sources,  and it is nevertheless still
not complete (apparently formats also exist  that are Huffman and/
or delta compressed). I would be very greatful for references to a
really comprehensive description of this format.

The routines for reading and unpacking RLE-packed Targa images are
based in part on routines of the P.O.V. Raytracer, (c) POV-Team.


                                                              TIFF.MDL
----------------------------------------------------------------------

Module name:   TIFF.MDL
Module I.D.:   JTIF
Module type:   Import module
Author:        John McLoud, Freeware
Versions No:   01.25
Version date:  Mar 26 1995


Description:

TIFF.MDL  imports images in the TIFF format into  'Look'n See'  in
accordance to the TIFF 5.0 specification. 2, 4, 16  and 256 colour
palette images,  4, 16  and 256 grey-tone images  and 24-bit True-
Color images are accepted.


Notes:
- There are  TrueColor TIFFs  that supply the data  separated into
  their colour components (for insiders: PlanarConfiguration = 2).
  In that case unfortunately sufficient memory has to be available
  to hold the image data twice in memory. I am however looking for
  a better solution.

- Defective LZW images usually originate from programs that return
  a wrong LZW code.  In that case these image portions will be re-
  loaded with an altered decoder. That may cost some time but will
  often give good results.

- No TIFFs to FAX G III/G IV are supported (yet);  neither is RLE-
  packing implemented. These three packing types are actually only
  defined for monochrome images and are very rare.


Thanks

Heartfelt thanks to Max Heinzlmeir who passed on to me a TIFF with
PlanarConfiguration = 2.  Two days after I established  that I had
totally forgotten this image type. (Nevertheless many thanks, dear
Max.)



Copyright

The  source codes,  with  one exception,  grew from my junk.  That
exception  is the LZW decoder,  which is based on the  'Source for


Generalised  Bitmap  Module'  by Andy Key  (but  has been  greatly
altered).


                                                              TSWS.MDL
----------------------------------------------------------------------

Module name:   TSWS.MDL
Module I.D.:   TSWS
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.08
Version date:  Jul 14 1995


Description:

This module  may prove useful to only  very few people  (I, on the
other hand, use it quite often). It displays files that are stored
in my own proprietory binary format  (in short: TSWS chunk format)
as a sort of linked hex-dump.

When it is a question of saving data  for which there is as yet no
standard format and which cannot be stored sensibly as ASCII, then
I usually fall back to this format. Thus for instance the settings
of my development environment 'Chatwin' or the packed icon data of
of 'IconMan'.

The exact make-up will not be discussed here  in detail  (it would
probably interest very few people), but in principle the files are
made up of interlinked blocks (so-called 'chunks')  that all start
with a four byte long ASCII I.D.  and a length descriptor  (also 4
bytes).  And is is just these chunks that the module displays as a
hex-dump, where the interlinking can be recognised by indenting.


                                                             WRITE.MDL
----------------------------------------------------------------------

Module name:   WRITE.MDL
Module I.D.:   IWRI
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.00
Version date:  Feb 21 1995


Description:

This module  imports  texts  that were  written with  the Window*s
'Write' program as ASCII texts into 'Look'n See'.  During this all
styling information, and any pictures that may have been included,
will be lost.  Paragraphs will be taken over  as continuous lines,
so subsequent treatment with Thorston Pohlmann's 'Chainsaw' module
is recommended.

As in many other cases, I don't have a description  of the 'Write'
format either.  Therefore I cannot guarantee  that the importation
will always worked as expected. It worked with the handful of text
files I tested it with. The sense and purpose of this module is to
just fish out texts quickly from such a document.


                                                              XIMG.MDL
----------------------------------------------------------------------

Module name:   XIMG.MDL
Module I.D.:   XIMG
Module type:   Import module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.09
Version date:  Jul 15 1995


Description:

This module  imports images  in the  XIMG format  as colour images
into  'Look'n See'.  XIMG is an extension  of the long-established
IMG format  to include colour information.  Since 'Look'n See' can
already read the monochrome IMG format, it would really be logical
if the XIMG function were also integrated into 'Look'n See' itself
(specially as the unpacking routine used here could also read mono
IMG files). Unfortunately the author of 'Look'n See' takes another
view, which is why I felt it necessary to write this module...

Note: This is not meant to be as grave as it sounds.  Nevertheless
I can't understand why dear Reiner objects,  specially as it would
not cost him anything  (neither money  nor storage  capacity,  and
virtually no work).


                                                               ZIP.MDL
----------------------------------------------------------------------

Module name:   ZIP.MDL
Module I.D.:   PZIP
Module type:   Import module
Author:        Andreas Papula @ WI2, Freeware
Versions No:   00.10
Version date:  11. Oktober 1994


Description:

This module displays the contents of ZIP archives as ASCII-Text.


                                                          GDPSSCAN.MDL
----------------------------------------------------------------------

Module name:   GDPSSCAN.MDL
Module I.D.:   R_GS
Module type:   Source module
Author:        Reiner Rosin
Versions No:   00.03
Version date:  Aug  9 1994


Description:

GDPSSCAN  searches for an installed GDPS scanner-driver  and tries
to get it to cooperate.

As the 'UMAX' GDPS-driver  on which the development of this module
was based  differs appreciably, in part, from the GDPS description
I have available,  I have attempted to  straighten out most of the
critical  points  as sensibly as possible  to accomodate  both the
specification as well as the UMAX driver.

However, it is possible  that pictures scanned with 64 grey-tones,
for instance,  or some other  'exotic' formats,  may produce  some
peculiar results now.

I would be much obliged  if owners  of scanners  with GDPS drivers
would let me know their experiences with this module!


                                                            MONIKA.MDL
----------------------------------------------------------------------

Module name:   MONIKA.MDL
Module I.D.:   R_MO
Module type:   Source module
Author:        Reiner Rosin
Versions No:   00.02
Version date:  Nov  5 1994


Description:

Although  Monika  permits deep insights, these are, unfortunately,
only into RAM memory.  Monika is a hex-dump monitor  that has been
realised as a source module.


There are two functions:

- 'Hex-dump as ASCII' creates a dump in ASCII format.
  Advantages: The original address appears in the output,  and the
  layout always follows 16-byte boundaries.
  Disadvantage: Higher memory requirement (around 5 times as much).

- 'Binary copy' simply produces a copy of the specified range.
  Advantages:  Saves room,  conversion to a sample, or similar, is
  possible.
  Disadvantage: Information about the original address is lost.


Parameters:
'Start address':   Gives the starting address in memory that forms
                   the base for the dump.
'Pre-start offset':This value is subtracted from the start address
                   so that one can,  say,  specify an address that
                   is pointed to by a vector  and by inputting '8'
                   here, any XBRA I.D.  preceding the vector  will
                   also be included in the dump.  This is purely a
                   comfort feature - one can equally well work out
                   the effective start address for oneself.
                   Note: The offset is always evaluated unsigned.
'No. of bytes':    Number of bytes from <Start address> - <Offset>
                   to be output.

All values can be specified in decimal or in hexadecimal ($1234).

WARNING NOTICE:This module can endanger your health.  If one acci-
               dentally (or on purpose) specifies incorrect values
               for the address  or length,  it will crash  without
               mercy.  Access to  protected memory regions  is not
               possible!

  In short: Those rummaging around in memory should know what they
            are doing!


                                                          SRC_DMAS.MDL
----------------------------------------------------------------------

Module name:   SRC_DMAS.MDL
Module I.D.:   SRC_DMAS
Module type:   Source module
Author:        (c) Reiner Rosin
Versions No:   01.00
Version date:  20. Februar 1994


This module is not meant for those with weak nerves.  People of an
anxious nature should delete it immediately!

What does this module do? It reads the frame registers of the DMA-
sound chip and copies to the 'Look'n See' buffer the memory region
pointed to by these registers.

What can one do with it?  One can reconstruct the last sample that
was played via DMA-sound. Thus it allows one to convert recordings
made by the telephone answering  function of CoNnect for instance.
Start CoNnect, play the recording  and under 'File/Import data...'
immediately select 'DMA-Soundlift' in the popup (this is best done
with 'Look'n See'  running in parallel,  i.e. as desk accessory or
in a multitasking environment).

What can go wrong? Several things!  The worst instances are caught
by the module:
   - DMA-sound not available (e.g. on an STFM).
   - Capital error in the frame data  (Framestart or -end = 0,  or
     End<Start).
Nevertherless a number of things can go wrong:
   - Frame register points to an invalid address (Bus-error!).
   - Memory-protection switched on.  The region in which the frame
     lies  does not necessarily  belong to 'Look'n See'  (often it
     does,  because  it lies in  the region  that 'Look'n See' has
     reserved for the module).
     At present this can only give rise to problems under MTOS.
   - Sometimes  the memory area is also being used temporarily for
     other things.  That hardly results in tragedy - but will just
     return rubbish.

****************************************************************

So take care, 'SRC_DMAS'  is a pig  of a module!  But as it is not
particularly useful  in any case, one is unlikely to need it  very
often. If one does actually use it once in a while,  then it would
be wise to first close all documents in Calamus, Tempus Write ...

As long as it is not called, it is, incidentally,  quite harmless.
So one can quietly leave it in the module folder.

****************************************************************


                                                          SRC_SCRN.MDL
----------------------------------------------------------------------

Module name:   SRC_SCRN.MDL
Module I.D.:   SRC_SCRN
Module type:   Source module
Author:        (c) Reiner Rosin
Versions No:   01.00
Version date:  20. Februar 1994


Description:

With this one can grab the current screen contents. Perhaps it can
replace a hardcopy print routine in some circumstances - one never
knows.


Risks and side-effects:

- The module only works with monochrome screens as at the time the
  module was created  'Look'n See' could not yet handle any colour
  images. That may change in the future.

- The image memory must be located  in addressable space,  meaning
  'physbase' must return a valid address (some graphics cards will
  be excluded therefore).

- The module makes a Line-A call to establish the physical and the
  logical screen widths. That should be acceptable  as only a read
  access is made.

- The function selection dialog  may sometimes not be cleared from
  the screen  before the function is called.  Remedy:  Move dialog
  to a clear portion of the screen,  or even completely off screen
  and use [Return] to activate it.

- The same applies to the mouse cursor.  The best thing is to move
  it to a corner of the screen.


                                                            SUCKER.MDL
----------------------------------------------------------------------

Module name:   SUCKER.MDL
Module I.D.:   Asuk
Module type:   Source module
Author:        Thorsten Pohlmann @WI2
Versions No:   00.05
Version date:  Feb 14 1995


Description:

'Sucker' samples sounds via a 'Scope ST' (also called 'Glanzomat')
connected to the ROMport.  One can hear  the sound  that is  being
sampled via the DMA-sound chip (if present) and via Scope ST's D/A
converter.

Sampling is stopped by pressing both [Shift] keys or automatically
when the memory is filled up.

One should always leave the 'Stop mouse'  in the parameters dialog
switched on, otherwise you get nasty pitch changes if the mouse is
moved. Under 'Frequency' one sets the sampling frequency in KHz.


                                                          APPENDIX.MDL
----------------------------------------------------------------------

Module name:   APPENDIX.MDL
Module I.D.:   APNX
Module type:   Processing module, ASCII
Author:        (C) Thorsten Pohlmann@WI2
Versions No:   00.04
Version date:  Jun 28 1995


'If you are not willing, then I'll use force!'


Description:

Marked portions of an ASCII text  will be stored in the Clipboard.
That really doesn't justify a module, but:  A file that is present
already  will not be overwritten without mercy; instead the marked
text will be appended.

That is useful,  for instance,  when one marks several files  in a
file list in order to transfer them with 'Send ASCii' to the down-
load list of a mailbox.

With 'Options'->'Modules'->'Appendix'->'Info'->'Parameter' one can
set the file name  of the destination file.  Furthermore,  one can
choose whether a CR/LF is to be inserted after each appended block.


                                                          CHAINSAW.MDL
----------------------------------------------------------------------

Module name:   CHAINSAW.MDL
Module I.D.:   CHAINSAW
Module type:   Processing module, ASCII
Author:        (c) Toastware
Versions No:   00.01
Version date:  4. Februar 1994


Description:

Chainsaw forces line-breaks in ASCII texts. So if, say, a text has
a maximum line length of 500 (eg. continuous text without Returns)
then one can select 80, for instance,  and obtain a formatted text
that one can read easily on the screen. Care is taken not to cut a
word in half (unless it is longer than the line length).


                                                            CUTSUP.MDL
----------------------------------------------------------------------

Module name:   CUTSUP.MDL
Module I.D.:   Csup
Module type:   Processing module, ASCII
Author:        (C) Thorsten Pohlmann@WI2
Versions No:   00.05
Version date:  Jul  7 1995


Description:

With this module you can cut out a  block of columns  from a text.
This cuts out the area  lying between the markers  from all marked
lines.

Note:  With older 'Look'n See' versions (pre V0.95)  it may not be
       possible in some cases to mark the end column exactly.


                                                           ENTROPY.MDL
----------------------------------------------------------------------

Module name:   ENTROPY.MDL
Module I.D.:   AHEM
Module type:   Processing module, ASCII
Author:        (c) A.Halbritter
Versions No:   01.02
Version date:  Oct 15 1994


Description:

'Entropy info!' produces statistics about ASCII texts.

For this the following values are calculated:
 - The number of different characters in the text.
 - Probability of their occurrence.
 - Information contents of these characters.
 - Text length.
 - Maximum line length.
 - Number of lines.
 - Average information contents (source entropy).


                                                           FEED_ME.MDL
----------------------------------------------------------------------

Module name:   FEED_ME.MDL
Module I.D.:   AHFM
Module type:   Processing module, ASCII
Author:        (C) A.Halbritter
Versions No:   00.01
Version date:  Nov 22 1994


Description:

'Feed Me!' adds a line-feed (LF) to every line  terminated only by
a carriage return (CR). That allows source code created under Unix
to be displayed in a sensible format on Atari and DOS systems, for
instance.


                                                              GREP.MDL
----------------------------------------------------------------------

Module name:   GREP.MDL
Module I.D.:   GREP
Module type:   Processing module, ASCII
Author:        Reiner Rosin
Versions No:   01.04
Version date:  Feb 13 1995


Description:

Grep permits searching for character strings in text files, with a
selectable number of lines around the located string  then used to
create a new text.

Parameters:
'Find:'            - Should be obvious, the string to be located.
'Lines before':    - The number of lines before the located string
                     to be copied.
'Lines after':     - The number of lines after  the located string
                     to be copied.
'Blank line divides paras'
                   - If this option is active,  copying  will stop
                     at the next blank line (within the set values)
                     before and after the located string.
'Wildcard ('?'only)'- With this option  one can choose whether the
                      question mark can be used as a wildcard.
'Cap=l.c.'         - If this box is checked, case is not relevant,
                     i.e. capitals and lower case letters  will be
                     treated as equivalent.


Example for use: In a Maus (or other BBS) file list one is looking
for uploads from a given user.  If one specifies  'From <forename>
<surname>' as the search string,  sets the line limits to  maximum
(=9) and activates 'Blank line divides paras', et voil - the list
is ready in a flash.


                                                          LINESORT.MDL
----------------------------------------------------------------------

Module name:   LINESORT.MDL
Module I.D.:   zSRT
Module type:   Processing module, ASCII
Author:        Ralf Zimmermann @ OF2
Versions No:   00.14
Version date:  17.01.95


Description:

This module sorts ASCII files.  One can configure both the sorting
order (forward: 'A B C .. a b c' or reverse: 'Z Y X .. z x y')  as
well as the portion of the lines that is to be used as a basis for
the sort. Sorting takes place in ASCII character order  (i.e. some
non-alphanumerics such as punctuation marks etc. first,  numerals,
more non-alphas, capital letters, yet more non-alphas,  lower case
letters, accented and foreign characters and maths symbols last --
see an ASCII table for details).


                                                              MOMO.MDL
----------------------------------------------------------------------

Module name:   MOMO.MDL
Module I.D.:   AHMM
Module type:   Processing module, ASCII
Author:        (C) A.Halbritter
Versions No:   01.02
Version date:  Sep 16 1994


Description:

Function: 'Text -> Morse':
MoMo converts ASCII texts into 'Morse-code texts', consisting only
of the characters '.' and '-'. Unrecognised characters will not be
converted but will be displayed within square brackets and will be
included as such in the output 'text'.

Function:'Morse text':
MoMo will output ASCII texts acoustically in Morse code.  A choice
of three speeds is offered.
Sending can be terminated by pressing both <Shift> keys.


                                                           PREVIEW.MDL
----------------------------------------------------------------------

Module name:   PREVIEW.MDL
Module I.D.:   R_PV
Module type:   Processing module, ASCII
Author:        Reiner Rosin
Versions No:   00.01
Version date:  Jul 16 1995


Description:

This module creates a miniature preview of an ASCII text,  similar
to those available in some text processing  and DTP programs. With
it one can produce an overview of the appearance of the text  when
printed.

The preview can be created in two different sizes.


                                                            SAY_IT.MDL
----------------------------------------------------------------------

Module name:   SAY_IT.MDL
Module I.D.:   Slz
Module type:   Processing module, ASCII
Author:        (c) Jens Brggemann, Freeware
Versions No:   00.01
Version date:  Mar 17 1995


This module reads ASCII texts out aloud,  but in German  (which is
most noticeable with numbers though pronounciation of many English
words is also strange). The speed, pitch etc. can be varied over a
wide range.

The module is based on the program  'Quassel'  by Jens Brggemann,
who has been kind enough to make its source code available.

Output takes place  via the Yamaha  sound-chip, so that the module
can only do its job on original ATARI hardware  and not on various
emulators (MagicMac, Janus).


                                                            SOFTIE.MDL
----------------------------------------------------------------------

Module name:   SOFTIE.MDL
Module I.D.:   SOFT
Module type:   Processing module, ASCII
Author:        (C) Thorsten Pohlmann@WI2
Versions No:   00.01
Version date:  Apr  9 1995


Description:

Softie removes 'Soft Returns', i.e. carriage returns (CR)  at ends
of lines that are preceded by a space.  With it  one can convert a
text to continuous body copy mode  (so that it can be justified or
formatted to a different width).  Paragraph endings will be recog-
nised correctly (they should have no space before the CR).

With a marked block a new window will be opened.


                                                          TABSPACE.MDL
----------------------------------------------------------------------

Module name:   TABSPACE.MDL
Module I.D.:   TABSPACE
Module type:   Processing module, ASCII
Author:        (c) Toastware
Versions No:   00.02
Version date:  27.04.1994 


Description:

'Tabulate it!' expands any  ASCII-9 (clock) Tab characters in text
files and replaces them with fixed spaces. You can select how many
are to be inserted from four preset values, or have a free choice.


                                                          UML_CONV.MDL
----------------------------------------------------------------------

Module name:   UML_CONV.MDL
Module I.D.:   R_UW
Module type:   Processing module, ASCII
Author:        Reiner Rosin
Versions No:   00.03
Version date:  Nov  2 1994


Function:

The Umlaut-converter  converts -- who'd have thought it! -- Umlaut
and  double-s characters.  There are  six possibilities  to choose
from:

   a) ->ae, ->oe, ->ue, ->Ae, ->Oe, ->Ue, ->ss.
   b) ->/"a, ->/"o, ->/"u, ->/"A, ->/"O, ->/"U, ->/"ss.
   c) ->\"a, ->\"o, ->\"u, ->\"A, ->\"O, ->\"U, ->\"s (TeX).
   d) ->"a, ->"o, ->"u, ->"A, ->"O, ->"U, ->"s (TeX).
   e) ST -> Mac characters (the upper ASCII assignments differ).
   f) Mac -> ST ASCII characters (ditto).


                                                          UUDECODE.MDL
----------------------------------------------------------------------

Module name:   UUDECODE.MDL
Module I.D.:   AHUD
Module type:   Processing module, ASCII
Author:        (C) A.Halbritter
Versions No:   01.03
Version date:  Oct 29 1994


Description:

'UU-Decode it!'  allows you to unpack any UU-encoded file.
The following formats are supported for this:

  - UUE files with or without a translation table.
  - UUE files with or without a control character  at the end of a
    line (linecheck).

If a linecheck error  should arise  during decoding,  there is the
possibility to  switch off the linecheck  in the dialog  preceding
the unpacking process and then try and unpack the file anew.
This procedure is not all that promising, however,  and one should
note that a file decoded this way may contain errors.


                                                          WORDLIST.MDL
----------------------------------------------------------------------

Module name:   WORDLIST.MDL
Module I.D.:   zLST
Module type:   Processing module, ASCII
Author:        Ralf Zimmermann @ OF2
Versions No:   00.11
Version date:  27.12.94


Description:

The module produces a list of the words contained in a text.


                                                           HEX_EXT.MDL
----------------------------------------------------------------------

Module name:   HEX_EXT.MDL
Module I.D.:   R_HX
Module type:   Processing module, binaries
Author:        Reiner Rosin
Versions No:   00.04
Version date:  Oct 26 1994


The hex-extractor extracts as if hexed...


Description:

The hex-extractor fishes out ASCII strings from hex-dumps. One can
fine-tune just what is to be extracted:


Valid characters:
 'All printable'   - All characters  whose ASCII-value  is not <32
                     and also do not belong to the hebrew letters.
 'Text chars.'     - All letters, numerals and punctuation marks.
 'Letters&Numerals'- All letters, numerals, [Space], .,+-.
 'Letters'         - All letters, [Space].
 'Cap. letters'    - All capital letters, [Space].

Line ends:
 'CR/LF'      - Strings must be terminated with CR _or_ LF
 'C-Strings'  - Strings must be terminated with a NULL-byte ($00)

These two options can also be active simultaneously, in which case
the string to be found only needs to fulfill one of the conditions
(it's in any case impossible to fulfill both!).
If neither of these options is selected then no special conditions
are imposed on string terminations.

'Minim. length:'
 This sets the lower limit  from which a row of characters are to
 be accepted as a string to be extracted.


                                                          UUENCODE.MDL
----------------------------------------------------------------------

Module name:   UUENCODE.MDL
Module I.D.:   AHUE
Module type:   Processing module, binaries
Author:        (C) A.Halbritter
Versions No:   01.03
Version date:  Oct 29 1994


UU-Encode it!


Description:

'UU-Encode it!' allows you to pack any 'Look'n See' hex-dump file,
or a block selected from it, into a UU-encoded *.UUE file.  Before
packing starts a number of parameters should be set in a dialog:

  -  'File name:' Name of the original file. Absolutely necessary!
     In newer 'Look'n See' versions the name appears in the dialog
     automatically, but can be changed if desired.
  -  'Linecheck:' Adds a control character at the end of each line
     of  the  packed  file.  This  increases  safety  of the data.
     (Default: Selected).
  -  'Translation table:' Creates its own translation table in the
     packed file.  This makes UUE-files decodable  even if some of
     the characters have changed  due to porting the coded file to
     a different computer platform.  (Default: Selected).


                                                            BITMAP.MDL
----------------------------------------------------------------------

Module name:   BITMAP.MDL
Module I.D.:   BITMAP
Module type:   Processing module, monochrome images
Author:        (c) Reiner Rosin
Versions No:   01.20
Version date:  16. Februar 1994


Function:      BITMAP makes available  some elementary  operations
               for modifying monochrome images.

These operations are:

- Halving the size of an image in X- or Y- direction, or both.
- Doubling the size of an image in X- or Y- direction, or both.
- Mirroring (reflection)  about the vertical or horizontal centre-
  line.


                                                            FAX300.MDL
----------------------------------------------------------------------

Module name:   FAX300.MDL
Module I.D.:   FAX300
Module type:   Processing module, monochrome images
Author:        (c) Reiner Rosin
Versions No:   01.20
Version date:  16. Februar 1994


Function:     Re-calculating fax-files (200*200 or 200*100 dpi) to
              laser-printer resolution (300*300 dpi).


Description:

Previously,  'Look'n See' could only print out faxes in a very un-
satisfactory manner. The reason for this is the strange resolution
that is standard for fax machines: 200*100 or 200*200 dpi (or more
exactly 198 or 98 dpi).  This resolution  is not supported  by any
printer  and also cannot be achieved with any  'simple' conversion
factor.

With FAX300 one can now however re-calculate faxes  to the 300*300
dpi format  (for laser and ink-jet printers).  One should note two
peculiarities in this:

- Faxes are around 8.7 inches wide (1728 pixels), but the printing
  width of laser printers is usually only 8 inches, giving 8*300 =
  2400 pixels.  For this reason a  modified factor of 11/8 is used
  for calculations in the X-direction.

- Usually complete DIN A4 pages will be faxed (29.7 cm long,= 2340
  pixels) to which must be added the sender/time-imprint line. But
  the printing height for laser printers is around 11 inches, i.e.
  3300 pixels. Scaling by a factor of 4/3 is therefore undertaken
  in the Y-axis.

As a consequence, the real resolution achieved will not be 300*300
but 272*264 dpi.  If the correct geometry is required then this is
naturally not a good solution,  but if not, then at least one will
get a complete fax page on one sheet.


                                                          GREY_MAN.MDL
----------------------------------------------------------------------

Module name:   GREY_MAN.MDL
Module I.D.:   R_GM
Module type:   Processing module, monochrome images
Author:        Reiner Rosin
Versions No:   00.02
Version date:  Sep  4 1994


'Hey man, I want it grey man!'


Description:

The Grey-Man  will turn your hair grey -- or any of your pictures:
It converts monochrome (1-bit) images to greyscale images.
Seven differently-sized conversion matrices are available:

 4 grey-tones:   2*2 matrix
 9 grey-tones:   3*3 matrix
16 grey-tones:   4*4 matrix
25 grey-tones:   5*5 matrix
36 grey-tones:   6*6 matrix
49 grey-tones:   7*7 matrix
64 grey-tones:   8*8 matrix

Use is only sensible in colour resolutions - on monochrome screens
the images will be immediately re-dithered to b & w.


                                                          INVERTER.MDL
----------------------------------------------------------------------

Module name:   INVERTER.MDL
Module I.D.:   INVERTER
Module type:   Processing module, monochrome images
Author:        (c) Reiner Rosin
Versions No:   01.02
Version date:  16. Februar 1994


Description:

This module inverts monochrome images -- i.e. swaps over black and
white pixels to give a 'negative' image.


                                                           PIC_CUT.MDL
----------------------------------------------------------------------

Module name:   PIC_CUT.MDL
Module I.D.:   PIC_CUT
Module type:   Processing module, monochrome images
Author:        Reiner Rosin
Versions No:   00.02
Version date:  Apr 20 1995


Function:  Cuts off the (sometimes) obtrusive white margins around
           bitmap images.

Restriction: Only a bytewise search is made, so that a left margin
             up to 7 pixels wide may remain; at right, due to word
             alignment, it may even be up to 15 pixels wide.


New addition:  One can now also delete marked blocks. However this
               only works with later 'Look'n See' versions!


                                                           PIC_DBL.MDL
----------------------------------------------------------------------

Module name:   PIC_DBL.MDL
Module I.D.:   PIC_DBL
Module type:   Processing module, monochrome images
Author:        Reiner Rosin
Versions No:   00.06
Version date:  Feb 13 1995


Description:

Doubles the height and width of a bitmap monochrome image.  Unlike
BITMAP.MDL an 'intelligent' algorithm is used here that calculates
interpolated pixels, preventing a blocky appearance  and giving as
smooth and harmonious a picture as possible.

Three algorithms are available:

'Thin out, angular' - suitable specially for technical drawings,
                      e.g. circuit diagrams.

'Thin out, round'   - suitable for dithered images.

'Thicken'           - Recommended for line drawings.


                                                          PIC_TURN.MDL
----------------------------------------------------------------------

Module name:   PIC_TURN.MDL
Module I.D.:   PIC_TURN
Module type:   Processing module, monochrome images
Author:        Reiner Rosin
Versions No:   00.15
Version date:  Feb 13 1995


Function: Rotates monochrome bitmap graphics by either 180 degrees
          or by 90 degrees right or left.


                                                           PIN2LAS.MDL
----------------------------------------------------------------------

Module name:   PIN2LAS.MDL
Module I.D.:   Nwic
Module type:   Processing module, monochrome images
Author:        Freeware by wic
Versions No:   00.02
Version date:  Mar 20 1995


Laser-scaler

Function: Converts 180 dpi dot matrix graphics to a 300 dpi output
          format for laser and inkjet printers.

Well, what can one really say about this module?  There are plenty
of modules that will enlarge or reduce a graphic  by fairly simple
factors (1.5, 2, 3 ...). A tiny font scaled to e.g. 270 dpi, stays
only just acceptable on a laser as well! Now an A4 180 dpi graphic
can be output at A4 size on a laser or inkjet printer.

Suggestions, criticism and user-reports are always welcome. Should
there be a need, then a converter from 360 dpi to 300 dpi could be
next, although if necessary this can also be achieved by using the
'halving' module first.


                                                          UNIVERSE.MDL
----------------------------------------------------------------------

Module name:   UNIVERSE.MDL
Module I.D.:   Uwic
Module type:   Processing module, monochrome images
Author:        Reiner Wiechert
Versions No:   00.09
Version date:  Feb 16 1995


Universal scaler


Function: Scales an *.IMG graphic by a factor that can be (almost)
          freely chosen in both the X- and Y-directions.

Status:   Freeware

A dialog appears  for the old and new  resolutions  to be input as
parameters. As only their ratio is important, one can also express
a conversion  from (180x180) to (300x300), say, as (3x3) -> (5x5).
This freedom of choice allows any graphic with  - let's say  60x72
pixels, or 800x600 pixels, to be scaled to the standard 640x400 ST
High screen resolution without recourse to a pocket calculator.  I
am sure that most of you can think of a more sensible example. :-)

The module uses the 'Bresenham' algorithm  for scaling,  which was
really developed for division-free calculation of a straight line.
Despite this the conversion takes a  relatively long time, as, due
to its universal character, each individual bit has to be treated.

The pop-up selection  'Pictures/Drawings' is meaningful  only when
reducing by a factor greater than 2. The 'Picture' algorithm tries
to maintain the total impression (brightness) of a graphic.

If 'Drawings' is selected, on the other hand, then all the picture
information is retained,  which is necessary  for circuit diagrams
and other technical drawings. Just try it and see.


                                                          COMPRESS.MDL
----------------------------------------------------------------------

Module name:   COMPRESS.MDL
Module I.D.:   COMPRESS
Module type:   Processing module, samples
Author:        (C) Toastware
Versions No:   00.01
Version date:  Aug 18 1994


Description:

The compressor regulates the amplification of samples depending on
the current and the _future_ sound level.

The 'Attack-' and 'Release-factor' parameters  control the rate at
which the amplification changes.  The higher the value, the slower
the change takes place.   One can take a look at the amplification
resulting from these settings in the optional V(t) window.


                                                          SAMPCALC.MDL
----------------------------------------------------------------------

Module name:   SAMPCALC.MDL
Module I.D.:   SAMPCALC
Module type:   Processing module, samples
Author:        (c) Reiner Rosin
Versions No:   01.10
Version date:  16. Februar 1994


This module contains two functions for modifying samples:

1. 'Nulling'
Moves the sample waveform linearly  so that the highest amplitudes
lie symmetrically with respect to the axis (which does _not_ imply
automatically that all sample values average out at zero).

2. 'Max. amplification'
Raises the  sound level  by the maximum possible factor  that just
prevents the signal from becoming distorted.  In your own interest
it should not be used more that once on the same sample  (rounding
errors!).


                                                          SAMPMIRR.MDL
----------------------------------------------------------------------

Module name:   SAMPMIRR.MDL
Module I.D.:   SAMPMIRR
Module type:   Processing module, samples
Author:        Reiner Rosin
Versions No:   00.11
Version date:  Mar 27 1994


Description:

'Mirrors'  a sample,  i.e. after this treatment  it will be played
in reverse.


                                                          SAMP_CUT.MDL
----------------------------------------------------------------------

Module name:   SAMP_CUT.MDL
Module I.D.:   R_SC
Module type:   Processing module, samples
Author:        Reiner Rosin
Versions No:   00.01
Version date:  Feb 12 1995


'Bing bang bong, bing bang bong, bing ba...'

Some portions of a sample  are so nice  that one would dearly love
to cut them out.  And that's exactly what this module does.  Quite
jolly, isn't it?

Warning: Due to an error, will not run in 'Look'n See'/'Zeig's mir'
versions earlier than 0.31s (i.e. it leads to a crash).


                                                          BRIGHTEN.MDL
----------------------------------------------------------------------

Module name:   BRIGHTEN.MDL
Module I.D.:   BRIG
Module type:   Processing module, colour images
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.03
Version date:  Oct 27 1994


Description:

With this module one can alter the brightness of colour images. In
the  'Apply module...'  dialog you can select from several pre-set
values (5, 25 or 33 % lighter or darker). 'Select 1 - 99%', on the
other hand, brings up a sub-dialog where you can freely select any
value between 1 and 99 % (0% is meaningless and will be rejected);
after inputting  the desired value,  a click on the  'Lighter'  or
'Darker' button (whichever you want) will alter the image,  or you
can click on  'Cancel' if you change your mind,  in which case the
picture will remain unaltered.  Note that if you want  the altered
picture to appear in a new window  rather than overwriting the old
one, you have to click on the appropriate button _before_ you open
the sub-dialog!

For the technically interested: The module converts the RGB colour
values  of the picture  into  YIQ  colour space  (where 'Y' is the
brightness and 'I' and 'Q' the colour information). After this the
Y-values  are increased or reduced  by the desired percentage  and
finally converted back to RGB colour space.

The YIQ-colour model is used,  for instance,  by the American NTSC
television system. You will find further information about this in

   'Computer Graphics - Principles and Practice'
   Foley, van Dam, Feiner, Hughes
   Addison-Wesley, 1990
   ISBN  0-201-12110-7


                                                          COL_FUNC.MDL
----------------------------------------------------------------------

Module name:   COL_FUNC.MDL
Module I.D.:   R_CF
Module type:   Processing module, colour images
Author:        Reiner Rosin
Versions No:   00.05
Version date:  Feb 13 1995


Function: At some time this will become a collection of elementary
          operations  for colour images. To start with, a doubling
          of picture size has been implemented.


Double pic-size 1: Doubles  the  picture  size   by  interpolating
                   intermediate  pixels  and lines.  The resulting
                   picture is basically stored in TrueColor, which
                   on the one hand  needs a lot of memory and disk
                   storage space and on the other may need further
                   rastering and dithering for display.
                   The interpolation results in a softening of the
                   contours but prevents blockiness and 'jaggies'.

Double pic-size 2: Doubles the  picture size by recalculating each
                   pixel to four times  its original size  (double
                   height and width).


                                                          COL_INFO.MDL
----------------------------------------------------------------------

Module name:   COL_INFO.MDL
Module I.D.:   R_CI
Module type:   Processing module, colour images
Author:        Reiner Rosin
Versions No:   00.04
Version date:  Aug  9 1994


Function: COL_INFO evaluates palette images and counts the indivi-
          dual colours in them.  Results can be displayed in  text
          form or graphically.

Module functions:
         - 'Count colours' counts the number  of different colours
           in the image,  and outputs their total  as well as  the
           lower and upper index values in text form.

         - 'Histogram (b/w)'  draws a histogram,  i.e. a frequency
           distribution (X-axis: Colour indices, Y: Frequency).

         - 'Histogram (colour)' does the same, but the columns are
           each drawn in the relevant colour.

         - 'Frequency table' creates a table in ASCII format  that
           shows for each colour index the number of pixels having
           this colour in the picture.

         - 'Draw palette'  prepares a colour mosaic containing all
           the colours occuring in the picture.

Limitations:

         - COL_INFO only works in 16 or 256 colour resolutions (in
           other words only palette pictures).


                                                            CUTPIC.MDL
----------------------------------------------------------------------

Module name:   CUTPIC.MDL
Module I.D.:   CCut
Module type:   Processing module, colour images
Author:        Thorsten Pohlmann @WI2
Versions No:   00.01
Version date:  Mar  2 1995


Description:

This module extracts a block to produce a picture of its own.


                                                          NOBORDER.MDL
----------------------------------------------------------------------

Module name:   NOBORDER.MDL
Module I.D.:   NOBO
Module type:   Processing module, colour images
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.01
Version date:  Aug 11 1994


Description:

With this module  one can remove single-colour borders from colour
images (at present only with 256-colour pictures).  One can choose
whether the margins on all four sides are to be cut off ('Off with
margins!' function) or only individual margins  (top, bottom, left
or right).

If the module sometimes  doesn't produce the desired effect,  then
it will be due to the fact that the margin  is not as uni-coloured
as it appears.  A single pixel of a different colour,  or a margin
consisting of two similar shades, prevent the module from working.
One can reveal such circumstances  by experimentally changing  the
colours with the control panel.

The 'Find margin' functions  search for continuous single-coloured
lines from the picture edges  and if they find them, they then cut
them off.  For this a maximum of one third of the picture-width or
-height (from the appropriate edge) will be searched through.

By multiple application of both posibilities, most pictures can be
freed  from annoying margins  (and possible  'adornments'  such as
mailbox-logos).


                                                           PIC2ASC.MDL
----------------------------------------------------------------------

Module name:   PIC2ASC.MDL
Module I.D.:   R_PA
Module type:   Processing module, colour images
Author:        Reiner Rosin
Versions No:   00.03
Version date:  Oct 26 1994


Description:

Converts a colour image into an ASCII text.  For this, the picture
is divided up  into small rectangles  of adjustable size,  and for
each of these rectangles an average brightness value is calculated.
By choosing a suitable ASCII character  to represent each block, a
little imagination can turn the text created into a representation
of the original image.


                                                           PUZZLER.MDL
----------------------------------------------------------------------

Module name:   PUZZLER.MDL
Module I.D.:   R_PZ
Module type:   Processing module, colour images
Author:        Reiner Rosin
Versions No:   00.02
Version date:  Oct  4 1994


Description:

The  'Puzzler'  module  provides an easy and simple way to convert
colour images into a jigsaw puzzle.  Just load a picture, call the
module and (almost) finished. 'Almost', because one still needs to
make  a colour  printout  and then use  scissors  or a sharp knife
(careful, danger of injury!) to separate the puzzle pieces.

Limitations:

- The separation colour for the edges of the puzzle pieces  is the
  one with colour index 0 for palette images.
- Depending on the picture width  and height, the puzzle pieces at
  the lower or right edge may be too small or too large.
- The separation lines still look very peculiar at times. Is there
  perhaps an artist present? I can't do things any better.
- Oh, I forgot - with unsuitable picture height one can get memory
  protection problems.


                                                           REFLECT.MDL
----------------------------------------------------------------------

Module name:   REFLECT.MDL
Module I.D.:   SPIG
Module type:   Processing module, colour images
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.00
Version date:  May 21 1995


Description:

This module doubles up images  by reflection,  i.e. after using it
one obtains  a double picture  consisting of the original  and its
reflected copy.

Usage:

In the first popup of the 'Apply module' dialog  select the module
'Mirror, mirror',  and in the  second  choose  where you want  the
reflection to take place:  At the left, right, top or bottom edge.

Restriction: At present this works only in 256-colour resolutions.


                                                           ROTATOR.MDL
----------------------------------------------------------------------

Module name:   ROTATOR.MDL
Module I.D.:   CRot
Module type:   Processing module, colour images
Author:        Thorsten Pohlmann @WI2
Versions No:   00.01
Version date:  Mar 29 1995


Description:

Rotates 256/16-colour pictures by 90 degrees clock/anticlockwise.


                                                          R_G_SWAP.MDL
----------------------------------------------------------------------

Module name:   R_G_SWAP.MDL
Module I.D.:   R_MW
Module type:   Processing module, colour images
Author:        Reiner Rosin
Versions No:   00.03
Version date:  Aug  9 1994


Description:

Who isn't familiar with this: One sits at the computer and views a
beautiful landscape-GIF. 'Oh, aah, beeeautiful, such a lovely blue
sky, luminous golden sun, the soft, green meadow,...'  and bang --
another minority group discriminated against. Because not everyone
sees  green as green  and red as red,  there are also  colourblind
fellow citizens!

'Well, there's nothing one can do about this, why blame 'GEM-View'
for it?'  Ha!  First of all we are not dealing with 'GEM-View' but
with 'Look'n See',  and secondly  'Look'n See'  can indubitably do
something about it!  Namely swap over red and green,  so that real
TrueColor shades can finally be seen even by colourblind Lonsheim-
moles  (this is specially for fellow Maus user  Patrick Glanzemann
from Lonsheim with the jug ears)!


                                                            BMPEXP.MDL
----------------------------------------------------------------------

Module name:   BMPEXP.MDL
Module I.D.:   BMPE
Module type:   Export module
Author:        Thorsten Pohlmann @WI2
Versions No:   00.04
Version date:  Oct 10 1994


Description:

This module exports 256- and 16-colour images in the Windows BMP-
format.

Usage:

After calling the module a file selector appears in which the path
and name  of the BMP file to be saved  have to be specified.  Then
the image will be saved under this name.


                                                          BMPEXP_M.MDL
----------------------------------------------------------------------

Module name:   BMPEXP_M.MDL
Module I.D.:   BMPEXP_M
Module type:   Export module
Author:        Thorsten Pohlmann @WI2
Versions No:   00.01
Version date:  Oct 10 1994


Description:

This module exports monochrome images in the Windows BMP-format.

Usage:

After calling the module  a file selector appears,  where the path
and file name of the BMP-file to be saved should be input.
The image will then be saved under this name.


                                                            EPSEXP.MDL
----------------------------------------------------------------------

Module name:   EPSEXP.MDL
Module I.D.:   EPSX
Module type:   Export module
Author:        (c) Andreas Schrell
Versions No:   00.03
Version date:  Dec 25 1994


Description:

This is an EPS export module for monochrome bitmaps. EPS files are
Encapsulated PostScript files.  They can be incorporated  in LaTeX
(via 'dVips'), say, or output on EPS-compatible page-printers.

The module is available in the  'Apply module'  menu-entry  popup,
not  'Export...'  as  might  be  expected.  The resolution  of the
exported  bitmap  is pre-set to  300 dpi.  This can,  however,  be
altered in the dialog that appears after calling the module.


                                                            GIFEXP.MDL
----------------------------------------------------------------------

Module name:   GIFEXP.MDL
Module I.D.:   GIFE
Module type:   Export module
Author:        Thorsten Pohlmann @WI2
Versions No:   00.07
Version date:  Jun  5 1995


Description:

This module exports 256- and 16-colour images in GIF 87a format.

Usage:

After calling  the module  the file selector appears, in which the
path and file name  of the GIF file  to be saved  should be input.
Then the image is saved under this name.

Note:
This module is based on various Freeware sources  from a number of
authors.  I have altered these  and adapted them to the 'peculiar'
requirements of this module interface with 'Look'n See'.  As it is
Freeware, it is excluded from licensing conditions.


 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 +
 -  GIFENCOD.C       - GIF Image compression routines
 +
 -  Lempel-Ziv compression based on 'compress'.  GIF modifications
 -  by David Rowley (mgardi@watdcsu.waterloo.edu)
 +
 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

 - GIF Image compression - modified 'compress'
 +
 - Based on: compress.c - File compression  la IEEE Computer,
 - June 1984.
 +
 - By Authors:  Spencer W. Thomas
 - (decvax!harpo!utah-cs!utah-gr!thomas)
 -              Jim McKie       (decvax!mcvax!jim)
 -              Steve Davies    (decvax!vax135!petsd!peora!srd)
 -              Ken Turkowski   (decvax!decwrl!turtlevax!ken)
 -              James A. Woods  (decvax!ihnp4!ames!jaw)
 -              Joe Orost       (decvax!vax135!petsd!joe)
 +


                                                          JPEG_EXP.MDL
----------------------------------------------------------------------

Module name:   JPEG_EXP.MDL
Module I.D.:   JJXP
Module type:   Export module
Author:        John McLoud, Freeware
Versions No:   00.04
Version date:  Jul 14 1995


Description:

This module exports colour images in the JPEG format.

Copyright:

The module is based on source code from  'Independent JPEG Group's
software' and is therefore subject to their copyright.


                                                           PIC_EXP.MDL
----------------------------------------------------------------------

Module name:   PIC_EXP.MDL
Module I.D.:   R_Px
Module type:   Export module
Author:        Reiner Rosin
Versions No:   00.01
Version date:  Jun  4 1995


Description:

This module exports monochrome images in a format  that was used a
long time ago  by nearly all  pixel drawing  programs,  namely the
ATARI ST monochrome screen format  (32,000 bytes, 640*400 pixels).
This format is also known under the name 'Doodle'.


                                                              QFAX.MDL
----------------------------------------------------------------------

Module name:   QFAX.MDL
Module I.D.:   R_QF
Module type:   Export module
Author:        Reiner Rosin
Versions No:   00.02
Version date:  Jun  5 1995


Description:

QFAX.MDL is an export module for 'Look'n See' that creates faxable
files for Coma or QFAX from monochrome bitmaps.  Coloured pictures
may be faxed via a 'monochrome dithering' detour.

The exporter is called via a popup in 'Export...'  (in the 'Extra'
menu.) The module saves the fax under the filename 'LOOK_N_C.Fnn',
where  'nn'  will usually be '01';  if faxes are already stored in
the 'OUTGOING' folder then the next free I.D. number will be used.

Notes:

- The 'OUTGOING' path  is first searched for  via the  environment
  variable 'COMA_OUT=xxx'.  If this variable is not present,  then
  C:\FAXPATH\OUTGOING is used as an alternative.  If this too does
  not work then the file will be written to the current directory.

- The fax will always be set centred horizontally, with the length
  being unlimited.  If the image width is greater than 1728 pixels
  then the right edge will be cut off.

Copyright:

QFAX.MDL is Freeware.  The module was written with the help of the
Fax-Driver Kit V1.0 of Coma 2.5.


                                                          SOUNDEXP.MDL
----------------------------------------------------------------------

Module name:   SOUNDEXP.MDL
Module I.D.:   SNDX
Module type:   Export module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.07
Version date:  Jun 16 1995


Description:

This module exports 8-bit samples in the following formats:

- CrazySounds sample
  Samples in this format are usually based on frequencies matching
  the DMA-sound hardware of Atari computers (6250, 12500, 25000 or
  50000 Hz), though this is not explicitly demanded  by the format
  description.
  The module converts samples  to the next matching DMA frequency,
  biased upwards  (i.e.  sampling at 22050 Hz  is re-calculated to
  25000 Hz).  Through this the resulting HSN samples may sometimes
  become longer than the original sample.
  If an 'MCWR' cookie is present, then its present values  will be
  evaluated for this format and adopted in the header.

- AVR sample
  For export in the AVR format  the samples are not re-calculated,
  but only provided with a suitable header.

- Wind*ws-WAV sample
  The generally well-loved  WAV format  known from  DOS computers.
  Here too no further calculations are performed on the sample.

- Phnix sample
  A special format for the 'Phnix' databank. For this the samples
  have to be converted to mono, if necessary, and re-calculated to
  the next higher frequency divisible by 1000.

Usage:

In the  'Export...'  dialog,  select 'Export sample'  in the first
popup and the desired format in the second popup.  Quit the dialog
with 'OK' and when the file selector appears enter the name of the
sample.

The re-calculation routine to higher sampling frequency originates
from Reiner Rosin himself and is also used in this form in 'Look'n
See'.


                                                          TARGAEXP.MDL
----------------------------------------------------------------------

Module name:   TARGAEXP.MDL
Module I.D.:   TGAX
Module type:   Export module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.05
Version date:  Jul  5 1995


Description:

This module exports a colour image  as a picture in unpacked Targa
format (TGA).  The module is selected  in the 'Export' dialog  via
the  popup  entry  'Save as TGA picture'.  A file selector appears
where you can input the name and path of the picture and following
this the picture will be saved under this name.

If a block is marked in the picture  then only that will be saved,
otherwise the whole picture.

Notes: At present, monochrome images are not yet supported.


                                                          TIFF_EXP.MDL
----------------------------------------------------------------------

Module name:   TIFF_EXP.MDL
Module I.D.:   JTXP
Module type:   Export module
Author:        John McLoud, Freeware
Versions No:   00.03
Version date:  Jul 14 1995


Description:

This module exports colour and monochrome pictures in TIFF format.


                                                          XIMG_EXP.MDL
----------------------------------------------------------------------

Module name:   XIMG_EXP.MDL
Module I.D.:   R_XX
Module type:   Export module
Author:        Reiner Rosin
Versions No:   00.05
Version date:  Jun  6 1995


Description:

As one may guess from its name, this module permits exportation of
colour images in the XIMG format.  What more can one say  about an
XIMG exporter?

Limitations:

- At present one can only export palette images (to be altered!).
- As a matter of principle saving is in unpacked form (will stay).


                                                          ELIMINAT.MDL
----------------------------------------------------------------------

Module name:   ELIMINAT.MDL
Module I.D.:   R_EL
Module type:   Dither module
Author:        Reiner Rosin
Versions No:   00.01
Version date:  Jul 28 1994


Function:  The 'Eliminator' reduces 256-colour images to 240 or 14
           colours  by deleting  some colours.  Like any brainless
           hooligan this fighting machine too attacks the smallest
           and weakest, in other words  those colours  that appear
           least frequently in the picture.

Algorithm: As long as  the number of colours  exceeds the maximum,
           the colour that appears least frequently is found,  and
           replaced with  the closest one  already present  in the
           image.

           The search  for the closest colour  is made via the RGB
           values where the interval between two colours is formed
           from the product of the differences of the  R-, G-, and
           B-values. Before the multiplication a constant value is
           added to each difference  (otherwise colour pairs  that
           differ only a little in one value would be favoured).

           The  colour value  of the assigned colour  will then be
           adjusted slightly towards the colour being eliminated.

Result:    With 256 colours the process in general  produces quite
           usable results,  as at most only 16 colours  have to be
           eliminated (usually there are fewer). As only the least
           frequently occuring colours are thrown out,  any colour
           adulteration  is normally  hardly perceivable.  But one
           can think of some pictures  where this could go totally
           wrong.

           Things look quite different  with 16 colours.  Here the
           eliminator usually has to clear up quite forcefully and
           this can lead to painful losses that are visible in the
           pictures.  But the results are in any case better  than
           with PALFIX, for instance. I believe that it is hard to
           obtain much better results  with acceptable effort  and
           without dithering.


                                                          HTDITHER.MDL
----------------------------------------------------------------------

Module name:   HTDITHER.MDL
Module I.D.:   HDIT
Module type:   Dither module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.15
Version date:  Jul 29 1994


Purpose: Convert colour images to monochrome.
Algorithm: Halftone-dithering.


Description:

This module converts colour pictures  into monochrome images.  The
algorithm used is the so-called halftone-dithering.

In practice you can select one of two possibilities:

'Halftone 1:1'
  Despite the use of a 3*3 matrix each pixel of the colour picture
  will be reproduced  as one pixel  in the monochrome image.  Thus
  the size of the image will remain unchanged.

'Halftone 1 -> 3x3'
  Here each pixel of the original picture will be reproduced  as a
  3*3-pixel matrix  in the  monochrome image.  Therefore the image
  will become three times as high and three times as wide.

You will know pictures that are 'halftone-dithered' from the daily
papers.  A useful application of the algorithm is to modify colour
images in a way  that enables them  to be reproduced  on an output
medium that only supports the colours black and white.  This means
particularly devices capable of high resolutions, such as printers
for instance. While the second option,  with each pixel reproduced
as a 3*3 matrix,  may not look very impressive on the monitor,  it
does give really good results on 300 or 360 dpi printers.

On screen, halftone-dithering  usually gives  rather poor results.
The 1:1 reproduction, in particular, is actually only  of interest
when no other dither algorithm is available,  since it gives quite
coarsely dithered images.

For further information  about halftone-dithering  one should once
again refer to:

   'Computer Graphics - Principles and Practice'
   Foley, van Dam, Feiner, Hughes
   Addison-Wesley, 1990
   ISBN  0-201-12110-7


                                                          IGOR_DIT.MDL
----------------------------------------------------------------------

Module name:   IGOR_DIT.MDL
Module I.D.:   TDit
Module type:   Dither module
Author:        (C) Thorsten Pohlmann @WI2
Versions No:   01.06
Version date:  Mar 30 1995


'Me Igor, you Frankenstein -- tighten up the bolts!'

What has this to do with a dither module? I don't know, but it has
to be given some kind of a name.... Oh well, this module is at the
very least just as mangled as Frankenstein's monster :-)

This module contains various dither algorithms, some of which give
very good results.

General:

Floyd-Steinberg dithering:
The errors  arising from differences  between the reproducible and
desired colours are distributed among the neighbouring pixels.  If
a pixel is too light for the screen display  it will be made a bit
darker and in return  surrounding pixels somewhat lighter.  Thanks
to this, the impression of continuous colour/brightness gradations
will be achieved at normal viewing distances.

Matrix dithering:
In the display of matrixed monochrome images each of the pixels to
be displayed is enlarged to a field of,  say,  2*2 or more pixels.
Depending on  the brightness  of the  desired  picture point, this
matrix is then filled with a given number of light and dark pixels
which appear to merge into each another when viewed from a certain
distance (like newspaper and similar screened photographs).
If one now  combines  the 'grey-tones'  achieved in this way  with
dithering, one achieves a better display,  which, however, needs a
higher resolution since the matrixing has enlarged the image.

Mapping:
The desired colour will be 'bent'  as far as is required to fit it
into the pre-set palette.  Although this happens quickly,  it also
looks like it!  Among other things you get nasty colour/brightness
stepping in place of smooth gradations.


Description of the dither options:

256 colours

1. Dithering of TrueColor and HiColor pictures to a 256/128 colour
   palette (static).  A TC or HC picture containing fewer than 240
   colours will be recognised and displayed unaltered.

2. EconoDither: Due to smaller distribution of the errors,  things
   get quicker, but the results are more 'grainy'. Otherwise as 1.

3. Mapping of the TC/HC picture to a 256 colour palette.

4. Dithering of 256-colour pictures to 128 colours. The advantage:
   One can now leave several pictures (GIFs or similar)  displayed
   on the screen and all will use the same palette.

16 colours

1. Dithering of TC, HC and 256-colour  pictures  to the  16-colour
   EGA palette. A 256-colour picture containing only <= 16 colours
   will be recognised and displayed unaltered.

Monochrome

1. Floyd-Steinberg dithering.  If necessary, grey-scale spreading
   will be performed.

2. Dither + Matrix:  Dithers the image  with a 2*2  (5 grey-tones)
   matrix. The picture doubles in size in both X and Y directions.
   It is particularly suitable for printing.


                                                           MED_CUT.MDL
----------------------------------------------------------------------

Module name:   MED_CUT.MDL
Module I.D.:   R_MC
Module type:   Dither module
Author:        Reiner Rosin
Versions No:   00.06
Version date:  Feb 13 1995


Description:

With MED_CUT, TrueColor and High-Color images  can be converted to
16 or 256 colours.  The Median-Cut algorithm  is used here,  which
has also given the module its name.

Algorithm:
The colours occuring in the picture  are first arranged  in an RGB
cubical colour-space and the length of its sides is then minimised
to only  just encompass  all the colours  present.  The  resulting
cuboid  (six-sided rectangular solid)  is then cut  at its longest
side in such a way  that the resulting two new cuboids  contain as
near as possible  equal numbers  of pixels.  Both cuboids are then
minimised  once more  as described above  and the cuboid  with the
longest side length  is cut again.  This procedure  is repeated as
often as necessary  until the number of cuboids corresponds to the
number of  desired  colours.  Every cuboid  is then allocated  one
colour and all pixels within the cuboid  will be displayed in this
colour.

Conversion:
The module first reduces the colour space to 32768 colours so that
calculation time  and RAM requirements  are kept within reasonable
bounds (some 130 KB are needed at run-time).  The reduction of the
colour cuboids then follows as described above; for allocating
the cuboid colour,  a weighted average is then formed from the
included colours  and their  frequency of occurrence.  In the 256-
colour mode  MED-CUT uses 240 colour registers,  in 16-colour mode
there are 14.

Results:
The calculation speed  is around twice as fast  as for  Thorsten's
Floyd-Steinberg  ditherers.  In 256-colour mode  the results  with
virtually all pictures  are acceptable  to very good,  though with
some you can achieve somewhat more with Floyd-Steinberg dithering.
In 16-colour mode, on the other hand, some points must be deducted
as the results,  both  with  regard to  speed and  quality,  are a
compromise between dithering and a fixed colour assignment through
mapping.  The disadvantage  of the process  is certainly the large
memory requirement.

Literature:
I don't have such a fine book as Dirk;  the idea and the basis for
MED_CUT arise from 'ST-Computer' magazine 7/8-94, pp.87 et seq.


                                                          PAL_SORT.MDL
----------------------------------------------------------------------

Module name:   PAL_SORT.MDL
Module I.D.:   R_PS
Module type:   Dither module
Author:        Reiner Rosin
Versions No:   00.01
Version date:  Aug 11 1994


Colour reduction module 'Palette sorter'.


Description:

In palette images this module sorts the colours according to their
brightness. What's this good for? I have no idea but as a pleasant
side effect  'air' is let out  of the images,  i.e. unused indices
are removed and in pictures really consisting of 256 colours these
are not just retained, but are even sorted so that colour 0 is the
lightest  and colour 255  the darkest.  Furthermore, the histogram
function of COL_INFO  perhaps becomes  somewhat more meaningful if
the colours are fist sorted with PAL_SORT.


                                                             RAMBO.MDL
----------------------------------------------------------------------

Module name:   RAMBO.MDL
Module I.D.:   R_RA
Module type:   Dither module
Author:        Reiner Rosin
Versions No:   00.01
Version date:  Jul 29 1994


The Eliminator has gained a brother...

Function: Rambo reduces 256-colour images to 120 or 14 colours but
          is actually meant more as a joke-module.


Algorithm:
See description for Eliminator. In contrast to Eliminator Rambo is
even more brutal  and uses larger calibre weapons - the colours to
be eliminated are selected by chance. This may at times affect one
or more of the colours that are represented rather more frequently
in the picture.
So that the desired effect - to achieve a result as interesting as
possible - is also obtained  in 256-colour resolution,  Rambo here
reduces not to 240 but to 120 colours.


                                                            REDUCE.MDL
----------------------------------------------------------------------

Module name:   REDUCE.MDL
Module I.D.:   R240
Module type:   Dither module
Author:        Dirk Haun @ WI2, Freeware
Versions No:   00.13
Version date:  Oct  7 1994


Description:

This module reduces the colours in palette images with 256 colours
to a maximum of 240. This is sensible so that 'Look'n See' doesn't
have to alter the 16 standard VDI-colours for such pictures.

Procedure:
The module first of all eliminates colours from the colour palette
that are not used in the picture at all. Following this, identical
colours,  i.e. colours that occur  in the palette  more than once,
are combined.

Up to this point, the procedure  has been loss-free.  If more than
240 colours still remain,  then the module  will now  produce some
losses.  The colours of the palette  are first converted from RGB-
to HSB-colourspace where it is easier to find colour similarities.
There an attempt will be made, with rising inaccuracy,  to collect
together 'similar' colours.  The procedure  will be  broken off as
soon as just 240 colours remain. Now the remaining colours will be
converted back to the RGB colour-model and passed to 'Look'n See'.

For further information about the HSB colour-model, refer to:

   'Computer Graphics - Principles and Practice'
   Foley, van Dam, Feiner, Hughes
   Addison-Wesley, 1990
   ISBN  0-201-12110-7


                                                          TINYDITH.MDL
----------------------------------------------------------------------

Module name:   TINYDITH.MDL
Module I.D.:   R_TD
Module type:   Dither module
Author:        Reiner Rosin
Versions No:   00.05
Version date:  Aug  3 1994


Description:

TINYDITH contains five dither methods,  none of which however give
particularly good results.  The module is mainly  intended to give
potential module authors a basis for their own developments.

The algorithms in detail:

1. Threshold conversion (for monochrome screens).
Converts colour  (more exactly: grey-tone) pictures to monochrome.
All pixels falling below a given threshold value are set to black,
all others to white. This method is implemented in three versions,
with different threshold values (Normal, Light, Dark).

2. Grey-tone conversion (for screens with 16/256 colours).
Converts the picture  (or the palette) to grey-tones.  For this 16
or 240 grey-tones can be used.

3. PALFIX (for screens with 16/256 colours).
Forces colour images  into a fixed pre-set palette  with 16 or 216
colours, using a rigid mathematic procedure.  No error correction,
rastering or dithering is performed.  With 16-colour screens there
are 2 levels (0 and 1) available for red and for blue and 4 levels
(0..3) for green; with 256-colour sreens there are 6 levels (0..5)
available for each colour.

4. Halftone, 5 grey-tones for monochrome resolutions.
I don't know whether this description is correct - in any case the
pictures are converted to monochrome with it using a 2*2 matrix.

5. EconoDither for monochrome resolutions.
This is a lean version  of the Floyd-Steinberg algorithm.  Instead
of distributing dithering errors  to the right and downwards, this
EconoDitherer only distributes the errors in the X-direction.
Special features: Fast (25 lines of assembler), quality: soso.


                                                          MAC_SAMP.MDL
----------------------------------------------------------------------

Module name:   MAC_SAMP.MDL
Module I.D.:   R_XS
Module type:   Sample output module
Author:        Reiner Rosin
Versions No:   00.01
Version date:  Mar 29 1995


Description:

This module  permits samples  to be output  on the Apple Macintosh
under MagicMac. To allow this, the XBIOS extension MACSOUND.PRG by
Richard Kurz has to be installed in the AUTO folder.


Installation:

Copy the module into the module folder. Under 'Samples...'  in the
'Options' menu, select  'XBIOS sample player' in the second popup,
activate  'Always use module', then click on  'OK'  and finally on
'Save options' - and that's it!


                                                            MUTANT.MDL
----------------------------------------------------------------------

Module name:   MUTANT.MDL
Module I.D.:   DMAF
Module type:   Sample output module
Author:        Thorsten Pohlmann @WI2
Versions No:   00.03
Version date:  Nov  2 1994


Mutant, the somewhat different sample player module.


Description:

On computers with DMA-sound  (TT, STE, Falcon)  and Fast-RAM  (or,
more exactly: Non-DMA-sound-capable RAM), this module can play out
samples  from all types  of RAM.  This can even be  virtual memory
(VRAM, Outside).  With it, there should now  really be no problems
with ST-RAM memory shortage ...


Usage:

Really, there's nothing to it.  Place it in the module folder, and
the rest happens automatically.

Under  'Options' -> 'Samples...' -> 'Fastram-DMA' -> 'Parameters',
a small Info box appears.


Technical note:

The module hooks into the 17 MFP interrupt, while any handler that
may have been installed previously,  with its current settings, is
saved and reinstalled after playing the sample. With high sampling
frequencies, slow machines (Falcon :-))  can in some circumstances
produce juddering  in the mouse,  caused by re-copying  in memory.

One can't have everything - in return the Falcon can otherwise not
be surpassed (those who know me will know what I mean).
However, this can only happen  when playing from  Fast-RAM or from
virtual memory.


                                                           PRUPTOR.MDL
----------------------------------------------------------------------

Module name:   PRUPTOR.MDL
Module I.D.:   PSGR
Module type:   Sample output module
Author:        Thorsten Pohlmann @WI2
Versions No:   00.02
Version date:  Nov  2 1994


   P(SG)Ruptor, a sample player module.


Description:

This module replays samples via the ST's sound-chip.


Usage:

So far, it's easy: Just place it in the module folder and the rest
happens automatically.

Parameters: (Dialog 'Options' -> 'Samples...' -> 'Parameters')

'Interrupt':
 ---------
'All'         All interrupts  created by  the MFP  will be masked.
              This produces appreciably higher sound quality,  but
              the computer 'locks up'  while the sample  is played
              (with no mouse or keyboard interrogation,  no serial
              transmission, no 200 Hz timer).

'Stop Mouse': Turns off the mouse while the sample is played. This
              should be the preferred way of playing samples.  You
              can switch replay off with <L-shift> and <R-shift>.

'Fmax'        This sets the maximum replay sampling frequency.  On
              slow computers,  a low value  permits samples  to be
              played in the background  without suffering too much
              from pitch changes.


Notes about the module:

It hooks into the  Timer-A  interrupt,  while any handler that may
have been  installed  previously,  with its  current settings,  is
saved and reinstalled after playing the sample.
Replay takes place completely  during the interrupt;  due to this,
mouse movements  can cause  undesired  speed variations  at higher
sampling frequencies (from around 12 kHz with an 8 MHz ST). So one
should best leave it alone ...

With stereo samples both channels will be mixed together to a mono
channel.


                                                            RUPTOR.MDL
----------------------------------------------------------------------

Module name:   RUPTOR.MDL
Module I.D.:   Rupt
Module type:   Sample output module
Author:        Thorsten Pohlmann @WI2
Versions No:   00.12
Version date:  Nov  2 1994


   (Inter)Ruptor, the sample player module.


Description:

This module replays samples  via a D/A converter  connected to the
parallel (printer) or ROM (cartridge) port.  In this way, even the
owners of non-DMA-sound  machines can have the dubious pleasure of
being able to hear samples in 8-bit sound.


Usage:

So far, it's easy: Just place it in the module folder and the rest
happens automatically.

Parameters: (Dialog 'Options' -> 'Samples...' -> 'Parameters')

'Hardware':
 --------

'Printer': Output via the printer port. In this connection:
'Strobe':  Creates a strobe output (for 'real' D/A-converters).

'Romport': Output via the cartridge (ROM) port. For this, the data
           will added to the under
'Adr'      specified output address. If
'Offset'   is active,  then the data will be multiplied by two (to
           circumvent UDS/LDS)

'Memory'   Here,  one  day,  one will be  able  to input a  memory
           address for 'D-i-Y' converters.

'Interrupt':
 ---------
'All'         All interrupts  created by  the MFP  will be masked.
              This produces appreciably higher sound quality,  but
              the computer 'locks up'  while the sample  is played
              (with no mouse or keyboard interrogation,  no serial
              transmission, no 200 Hz timer).

'Stop Mouse': Turns off the mouse while the sample is played. This
              should be the preferred way of playing samples.  You
              can switch replay off with <L-shift> and <R-shift>.

'Fmax'        This sets the maximum replay sampling frequency.  On
              slow computers,  a low value  permits samples  to be
              played in the background  without suffering too much
              from pitch changes.


Notes about the module:

It hooks into the  Timer-A  interrupt,  while any handler that may
have been  installed  previously,  with its  current settings,  is
saved and reinstalled after playing the sample.
Replay takes place completely  during the interrupt;  due to this,
mouse movements  can cause  undesired  speed variations  at higher
sampling frequencies (from around 12 kHz with an 8 MHz ST). So one
should best leave it alone ...

With stereo samples both channels will be mixed together to a mono
channel.


The D/A-converter:

For use one needs a D/A converter of the simplest kind, consisting
of a handful of resistors connected as follows:


                               8 x 10K
                                                                     Phono
 ---||---||---||---||---||---||---||---||------(=
 |     |    |    |    |    |    |    |    |    |
 |        |       |       |       |       |       |       |       |   _|_
||      ||     ||     ||     ||     ||     ||     ||     ||  ///
| | 20k | |     | | 20K| |     | | 20K| |     | | 20K| | 20K| |
|_|      |_|     |_|     |_|     |_|     |_|     |_|     |_|     |-|
 |        |       |       |       |       |       |       |       |
 |        |       |       |       |       |       |       |      _|_
 o        o       o       o       o       o       o       o      ///
 D0       D1      D2      D3      D4      D5      D6      D7


where  D0...D7  are the data connections  of the printer port.  No
external supply voltage is required.  One can use a DIN or a phono
socket for output, which is connected to an amplifier or similar.


The most important: The sound

As practised electronics technicians will realise immediately, the
first look at this converter should actually make their hair stand
on end - including their scalp!  The output signal  has spikes all
over the  place,  the converter  produces glitches  like mad,  the
linearity is dependent on the output frequency etc. etc... To this
must be added the jitter of the Timer-A interrupt. Nevertheless it
still sounds appreciably better than output via the sound-chip!


