'Zeig's mir'-Modulanleitung                                Allgemeines
----------------------------------------------------------------------

Diese Beschreibung dokumentiert den Stand der Modulentwicklung
am 17.8.94. Zum Zeitpunkt der Verffentlichung dieses Textes hat
es bei den Versionsnummern und beim Funktionsumfang sehr
wahrscheinlichund schon wieder nderungen gegeben, vielleicht ist
sogar das ein oder andere Modul zustzlich vorhanden.

Die Module stammen von verschiedenen Autoren, die die Nutzung
der Module selbst oder der Sourcecodes zu unterschiedlichen
Konditionen erlauben. Allen Modulen gemein ist, da sie zusammen
mit 'Zeig's mir' frei verbreitet und zum privaten Gebrauch mit
'Zeig's mir' unentgeltlich benutzt werden drfen.

Eine Bitte vom Programmautor von 'Zeig's mir': Die Autoren von
Modulen haben ihr Honorar bisher nur in der Form erhalten, da
ich alle paar Wochen die Modulschnittstelle gendert und ihnen
damit neue Arbeit verschafft habe. Insbesondere was die
Verarbeitung von Farbbildern angeht, steckt ein Groteil der
Leistungsfhigkeit von 'Zeig's mir' in den Importmodulen von
Dirk und John sowie Thorstens fabulsem Ditherer. Den Freunden
bunter Bilder sei deshalb besonders ans Herz gelegt, die Modul-
autoren bei der Registrierung zustzlich mit einer kleinen Spende
zu bedenken (schlimm, diese Bettelorgien, ich wei!).

Die in dieser Anleitung mehrfach erwhnten Modulsourcen sind in
der Vertriebsversion von 'Zeig's mir' aus Platzgrnden nicht
enthalten, sondern nur im Entwicklerarchiv zu 'Zeig's mir'.


                                               Module (c) by Dirk Haun
----------------------------------------------------------------------

BRIGHTEN.MDL  -> Bearbeitungsmodul(Farbbild) Helligkeit
                 von Bildern ndern

GIF.MDL/
ASCGIF.MDL    -> Importmodul(Farbbilder) fr GIF-Bilder

FLI.MDL       -> Importmodul(Farbbilder) fr FLI/FLC-Animationen

HTDITHER.MDL  -> Dithermodul, Halbtonalgorithmus

ICO.MDL       -> Importmodul(Farbbilder) fr Windows-Icons

NOBORDER.MDL  -> Bearbeitungsmodul(Farbbilder) zum Abscneiden von
                 Bildrndern

REDUCE.MDL    -> Dithermodul, Reduzierer fr 256 Farben

SOUNDEXP.MDL  -> Exportmodul(Sound) fr HSN-Samples

TARGA.MDL     -> Importmodul(Farbbilder) fr das Targa-Format

TARGAEXP.MDL  -> Exportmodul(Farbbilder) fr Targa-Bilder

TSWS.MDL      -> Importmodul fr Dirks eigenes Infofileformat

XIMG.MDL      -> Importmodul(Farbbilder) fr XIMG-Bilder

ZEIGSND.MDL   -> Importmodul(Sound) fr diverse Formate

ZEIGDOC.MDL   -> Importmodul(Text) fr Wordplus-Dokumente


Diese Module sind Freeware, ebenso wie die bei den meisten
Modulen mitgelieferten Sourcen.

Der Autor dieser Module kann auf folgenden Wegen erreicht werden:

 per Sackpost

        Dirk Haun
        Europastr. 8
        64569 Nauheim

 per e-mail

        Dirk Haun @ WI2 (MausNet)


Literaturempfehlung

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


Standard-Disclaimer

Diese Module erfllen bei mir ihren Zweck, was aber nicht heit,
da sie das  berall  tun.  Sollte eines dieser Module daher etwas
unvorgesehenes anrichten, so kann ich fr die dadurch entstandenen
Schden (was  auch  immer das sein  sollte)  nicht haftbar gemacht
werden - die Benutzung erfolgt auf eigene Gefahr.

Zudem  mchte ich darauf hinweisen,  da ich in keinster Weise mit
oder  am  Addison-Wesley-Verlag  verwandt  oder  beteiligt bin und
obiges Buch nur deshalb immer wieder erwhne,  weil ich es einfach
gut finde :-)


                                             Module (c) by John McLoud
----------------------------------------------------------------------

IFF.MDL     -> Importmodul(Farbbilder) fr das IFF-Format

PCX.MDL     -> Importmodul(Farbbilder) fr das PCX-Format

JPEG.MDL    -> Importmodul(Farbbilder) fr das JPEG-Format

TIFF.MDL    -> Importmodul(Farbbilder) fr das TIFF-Format


Kontaktadresse

Der Modulautor ist folgendermaen erreichbar:

 per Brief/Paketpost

   John McLoud
   Mozartstrae 1a
   65439 Flrsheim am Main

 per e-mail

   John Mcloud @ WI2 (MausNet)


Standard-Disclaimer

Ein nicht nher benannter Bekannter wrder sagen "Bei mir
funktioniert's". Wenn nicht, bitte ich um einen, mglichst
genauen, Bugreport (ein Beispielbild ist immer ne gute Hilfe).

Die Benutzung der Module drfte eigentlich keinerlei Schden
verursachen, wenn doch, Pech gehabt. Haftung bernehme ich in
keiner Weise. Dafr ist die Verwendung kostenlos.



                                       Module (c) by Thorsten Pohlmann
----------------------------------------------------------------------

ADPCM.MDL    -> Importmodul(Sound): ZyXEL Voice-Files *.ZY2,*.ZY3
                nach 8-Bit-signed Sound

BMPMAN.MDL   -> Importmodul(Grafik) fr ungepackte _Windows_-BMPs

BW256.MDL    -> Importmodul(Grafik) fr B&W Graustufenbilder

CHAINSAW.MDL -> Bearbeitungsmodul(Text): Zeilenumbruch

IGOR_DIT.MDL -> Reduziermodul(Grafik): TC/HC -> 256/16 Farben
                dithern TC/HC -> 256 Farben mappen, s/w dithern

KOMPRESS.MDL -> Bearbeitungsmodul(Sound): Lautstrkekompressor

NEOMOD.MDL   -> Importmodul(Grafik): Neochromebilder

TABSPACE.MDL -> Bearbeitungsmodul(Text):Tabs aus Texten entfernen


Die Module sind 'Feuerware', d.h. wer sie mag und ohne sie
nicht mehr leben kann, soll bei seiner 'Zeig's mir'-Registrierung
zwei DM (in Worten 'zwei') mehr an Reiner Rosin berweisen. Damit
wird dann beim nchsten Maustreff mein Durst gelscht, wenn genug
zusammenkommt. Hoffe ich. Bitte auf der berweisung vermerken!


Diese Module drfen/sollen ohne nderungen weitergegeben werden.
Sie drfen anderen 'Zeig's mir'-Modulen in dieser Form beigelegt
werden, sofern fr sie kein Betrag >3 DM verlangt wird.
Die Sourcen sind so verquirlt, dass wer da durchblickt sie auch
(nichtkommerziell) benutzen darf.

Flames, Anregungen fr _diese, meine_ Module etc. bitte _nicht_
an Reiner Rosin, sondern direkt an mich:

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

       Thorsten Pohlmann
       Frauensteinerstr. 15
       65199 Wiesbaden


                                            Module (c) by Reiner Rosin
----------------------------------------------------------------------

BITMAP.MDL    -> Bearbeitungsmodul(Grafik): Halbieren/Verdoppeln
                 von Monochrombildern

COL_FUNC.MDL  -> Bearbeitungsmodul(Farbbild): Farbbild verdoppeln

COL_INFO.MDL  -> Bearbeitungsmodul(Farbbild): Farben zhlen

ELIMINAT.MDL  -> Dithermodul(Grafik): Farbreduktion

FAX300.MDL    -> Bearbeitungsmodul(Grafik): Fax-Aufbereitung

GDPSSCAN.MDL  -> Sourcemodul(Grafik): Scannen per GDPS-Treiber

GREP.MDL      -> Bearbeitungsmodul(Text): Textteile suchen

INVERTER.MDL  -> Bearbeitungsmodul(Grafik): Bilder invertieren

MAULWURF.MDL  -> Bearbeitungsmodul(Farbbild): Rot-Grn tauschen

MED_CUT.MDL   -> Dithermodul (Grafik): Median-Cut-Algorithmus

PAL_SORT.MDL  -> Dithermodul (Grafik): Palettensortierung

PIC2ASC.MDL   -> Bearbeitungsmodul(Farbbild): Bild->ASCII wandeln

PIC_CUT.MDL   -> Bearbeitungsmodul(Grafik): Bildrand wegschneiden

PIC_DBL.MDL   -> Bearbeitungsmodul(Grafik): Bild verdoppeln

PIC_TURN.MDL  -> Bearbeitungsmodul(Grafik): Bilder drehen

RAMBO.MDL     -> Dithermodul(Grafik): Farbreduktion

SAMPCALC.MDL  -> Bearbeitungsmodul(Sound): Sample verstrken

SAMPMIRR.MDL  -> Bearbeitungsmodul(Sound): Sample rckwrts
                 abspielen

SRC_DMAS.MDL  -> Sourcemodul(Sound): DMA-Sound auslesen

SRC_SCRN.MDL  -> Sourcemodul(Grafik): Bildschirm kopieren

TINYDITH.MDL  -> Dithermodul(Grafik): verschiedene Ditherer

UML_WAND.MDL  -> Bearbeitungsmodul(Text): Umlautwandler

ZEIGBLK.MDL   -> Importmodul(Grafik) fr GFA-Basic-GET-Blcke

ZEIGFNT.MDL   -> Importmodul(Grafik) fr GEM-Fonts

ZEIGPIC.MDL   -> Importmodul(Grafik) fr Doodle-Bilder (32K)

ZEIGZYX.MDL   -> Importmodul(Sound) fr ZyXel-Voicefiles


Meine Module sind zur ausschlielichen Verwendung in 'Zeig's mir'
freigegeben. Der Sourcecode der Module, von denen ich diesen
verffentlicht habe, darf nichtkommerziell verwendet werden, wenn
in den darauf basierenden Sourcecodes oder Programmen ein Hinweis
auf die Originalquelle enthalten ist.


Mich kann man erreichen unter:

        Rosin Datentechnik
        Reiner Rosin
        Peter-Spahn-Str. 4
        D-65375 Oestrich-Winkel
        Telefon 06723 4978  Fax 7190

        email Reiner Rosin @ WI2 (MausNet)
              Reiner_Rosin@wi2.maus.de
                                                             ADPCM.MDL
----------------------------------------------------------------------

Modulname:     ADPCM.MDL
Modulkennung:  ADPCM
Modultyp:      Importmodul
Autor:         (C) Toastware
Versionsnr:    00.02
Versionsdatum: Aug  9 1994


Importmodul(Sound): ZyXEL Voice-Files *.ZY2,*.ZY3
                    nach 8-Bit-signed Sound

Beschreibung

Verhilft 'Zeig's mir' dazu, auch Zyxel-Voicefiles (*.ZYX) laden
zu knnen. Die CELP-Kompression wird noch nicht untersttzt, aber
die Codierung nach ADPCM2 und ADPCM3 (verbreitetstes Format).


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

Modulname:     BMPMAN.MDL
Modulkennung:  BMPMAN
Modultyp:      Importmodul
Autor:         (C) Toastware
Versionsnr:    00.03
Versionsdatum: Aug 18 1994


Beschreibung

Importiert ungepackte 24,8,4,1 Bit Windows(TM) und OS/2(TM)
Bitmaps. Gepackte BMP-Dateien (gibt's die?) werden nicht
untersttzt.

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

Modulname:     BW256.MDL
Modulkennung:  BW256
Modultyp:      Importmodul
Autor:         (C) Toastware
Versionsnr:    00.01
Versionsdatum: Aug 18 1994


Beschreibung

Importer fr GEM-View-Dithermatrizen. Woher dieses Format
ursprnglich herkommt, ist nicht bekannt (wahrscheinlich AIM).


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

Modulname:     FLI.MDL
Modulkennung:  FLIV
Modultyp:      Importmodul
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.01
Versionsdatum: Jul 24 1994


Beschreibung

Dieses Modul importiert den ersten Frame (d.h. das erste Bild)
einer FLI- oder FLC-Animation als Farbbild in Zeig's mir.

Zeig's mir kennt (noch?) keine Animationsmodule, daher ist dies
nur eine einfache Mglichkeit, sich Einblick in die Animation zu
verschaffen. Falls Sie von dem erzeugten Bild enttuscht sind
(z.B. weil es nur eine einfarbige Flche oder ein paar Linen
zeigt), so bedenken Sie bitte, da es sich um eine Animation
handelt, und der interessante Teil mglicherweise erst noch
folgt. Nein, es gibt keine Mglichkeit, die anderen Frames der
Animation auch noch zu Gesicht zu bekommen - zumindest nicht mit
Zeig's mir.

Im Infofenster wird auer dem Typ der Animation (nicht alles,
was FLI heit, ist auch ein FLI) noch die Anzahl der enthaltenen
Frames angegeben.


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

Modulname:     GIF.MDL / ASCGIF.MDL
Modulkennung:  GIFI / GIFA
Modultyp:      Importmodul
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.30
Versionsdatum: Aug 14 1994


Beschreibung

GIF.MDL importiert Bilder im GIF-Format in Zeig's mir, und zwar
sowohl den verbreitetsten Typ "GIF87a" als auch das weniger
verbreitete "GIF89a". Das Modul ASCGIF importiert die GIF-Bilder
als ASCII-Texte, d.h. die Bilddaten werden so in ASCII-Zeichen
umgesetzt, da sich (mit etwas Phantasie) der ursprngliche Bild-
inhalt noch erkennen lt.

Diese Module basieren auf dem Quelltext des Programms ASCGIF von
John Ferrell Jr. (Original) und Oliver Klink (Atari-Version),
daher auch das "Doppelleben" als zwei Module.

Anmerkungen:
- Das Modul versucht bei defekten GIFs das Bild noch so weit als
  mglich zu entpacken. Bei einem defekten Bild findet sich im
  Infofenster dann ein entsprechender Hinweis ("Das Bild ist
  offenbar defekt"). Je nach Art des Bildes und des Fehlers kann
  das Ergebnis unter Umstnden noch (eingeschrnkt) brauchbar
  sein.
- Dieses Modul ist sicher nicht der schnellste GIF-Viewer fr
  Ataris, aber auch nicht gerade der langsamste. Ich behaupte
  einfach mal, da es in C nicht viel schneller geht. Ein
  Umsetzung nach Assembler wre zwar programmtechnisch reizvoll,
  aber finanziell uninteressant ...


Hinweis: Man sollte nicht gleichzeitig GIF.MDL und ASCGIF.MDL im
Modulordner stehen haben! Andernfalls wird nmlich, je nach
Reihenfolge in dem Ordner, immer nur eines der beiden Module
verwendet. Man sollte ASCGIF als das betrachten, was es ist: Ein
Gag und ein "Abfallprodukt" des eigentlichen GIF-Importmoduls.
Wer unbedingt Bilder in ASCII-Texte umsetzen lassen will, sollte
das Modul PIC2ASC.MDL von Reiner Rosin verwenden (welches den
Vorteil hat, da es auch auf andere Bildformate angewendet werden
kann).

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

Modulname:     ICO.MDL
Modulkennung:  ICOI
Modultyp:      Importmodul
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.01
Versionsdatum: Jul 24 1994


Beschreibung

Dieses Modul kann Icons, die im Windows-ICO-Format vorliegen, als
Farbbilder in Zeig's mir importieren. Es werden aber nur solche
ICO-Files erkannt, die 32x32 Pixel groe Icons mit 16 Farben
enthalten und deren Dateilnge 768 Bytes nicht bersteigt (dies
drfte aber fr die weitaus meisten ICOs zutreffen).

Damit man bei einem so kleinen "Bild" berhaupt etwas erkennen
kann, wird das Icon auf das Doppelte (also 64x64 Pixel)
vergrert.


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

Modulname:     IFF.MDL
Modulkennung:  JIFF
Modultyp:      Importmodul
Autor:         John McLoud, Freeware
Versionsnr:    01.02
Versionsdatum: Aug 14 1994


Beschreibung

IFF.MDL importiert Bilder im IFF-Format in Zeig's mir.

Der Importer verarbeitet Palettenbilder mit 2, 4, 16 und 256
Farben. Weiterhin werden HAM und HAM-8 Files als TrueColor-Bilder
importiert.



Anmerkung

24 Bit Bilder finden z.Zt. noch keine Untersttzung, da sich die
AMIGA-Front nicht so ganz einig zu sein scheint, wie man das
implementiert. Um alle mglichen Flle zu implementieren war ich
definitiv zu bequem (die bentigete Zeit bezahlt leider keiner
und geht ber Hobby und Idealismus weit hinaus).


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

Modulname:     JPEG.MDL
Modulkennung:  JJPG
Modultyp:      Importmodul
Autor:         John McLoud, Freeware
Versionsnr:    01.03
Versionsdatum: Aug 14 1994


Beschreibung

JPEG.MDL importiert Bilder im JPEG-Format in Zeig's mir.

Akzeptiert werden Grayscale und TrueColor Bilder gem JFIF und
JPEG-RAW Definition.


Copyright

Das Modul basiert auf den Sourcen der "Independent JPEG Group's
software" und unterliegt somit deren Copyright.


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

Modulname:     NEOMOD.MDL
Modulkennung:  NEOMOD
Modultyp:      Importmodul
Autor:         (C) Toastware
Versionsnr:    00.01
Versionsdatum: Apr 27 1994


Beschreibung

Importiert Neochrome(TM) Bilder.


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

Modulname:     PCX.MDL
Modulkennung:  JPCX
Modultyp:      Importmodul
Autor:         John McLoud, Freeware
Versionsnr:    01.02
Versionsdatum: Aug 14 1994


Beschreibung

PCX.MDL importiert Bilder im PCX-Format in Zeig's mir.

Erlaubt sind Bilder mit 1, 4, 16 und 256 Farben, sowie 24 Bit
TrueColor-Bilder



Copyright

Liegt komplett bei mir!


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

Modulname:     TARGA.MDL
Modulkennung:  TGAI
Modultyp:      Importmodul
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.30
Versionsdatum: Aug  6 1994


Beschreibung

Dieses Modul importiert Bilder im Targa-Format (TGA) in Zeig's
mir. Das Modul kennt bisher Bilder mit 2 Farben (monochrom),
Palettenbilder mit bis zu 256 Farben, sowie High-Color- und
True-Color-Bilder (16 bzw. 24 Bit pro Pixel), jeweils ungepackt
oder RLE-gepackt.

Die Informationen ber das Targa-Format mute ich mir leider aus
den verschiedensten Quellen zusammensuchen und sind trotzdem noch
nicht vollstndig (offenbar existieren auch Formate, die Huffman-
und/oder Delta-komprimiert sind). Fr Hinweise auf eine wirklich
umfassende Beschreibung dieses Formats wre ich sehr dankbar.

Die Routinen zum Lesen und Entpacken eines RLE-gepackten Targa-
Bildes basieren zum Teil auf Routinen des P.O.V.-Raytracers,
(C) POV-Team.


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

Modulname:     TIFF.MDL
Modulkennung:  JTIF
Modultyp:      Importmodul
Autor:         John McLoud, Freeware
Versionsnr:    01.04
Versionsdatum: Aug 14 1994


Beschreibung

TIFF.MDL importiert Bilder im TIFF-Format in Zeig's mir, gem
TIFF 5.0 Spezifikation. Es werden 2, 4, 16 und 256 Farben bei
Palettenbildern, 4-, 16- und 256-Graustufenbilder und 24 Bit True-
Colorbilder akzeptiert.



Anmerkungen

- Defekte LZW-Bilder stammen meist von Programmen, die einen
  falschen LZW-Code liefern. In dem Fall werden diese Bildteile
  nochmal mit einem genderten Decoder geladen. Das kostet zwar
  Zeit, bringt aber oft gute Ergebnisse.

- Es werden (noch) keine TIFFs nach FAX G III/G IV untersttzt;
  auch RLE-packing ist nicht implementiert. Diese drei Packarten
  sind allerdings auch nur fr Monochrome Bilder definiert und
  uerst selten.



Copyright

Die Sourcen sind bis auf eine Ausnahme auf meinem Mist gewachsen.
Diese Ausnhme ist der LZW-Decoder, der auf dem 'Source for
Generalised Bitmap Module' von Andy Key basiert (aber krftig
gendert wurde).


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

Modulname:     TSWS.MDL
Modulkennung:  TSWS
Modultyp:      Importmodul
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.06
Versionsdatum: Aug  6 1994


Beschreibung

Dieses Modul drfte nur fr die wenigsten Menschen von Nutzen sein
(ich dagegen brauche es sehr oft). Es zeigt Dateien, die in meinem
hauseigenen Binrformat vorliegen (kurz: TSWS-Chunk-Format) als
eine Art gegliederter Hexdump an.

Wenn es darum geht, Daten zu speichern, fr die es noch kein
Standardformat gibt und fr die auch eine Speicherung als ASCII
keinen Sinn macht, greife ich fr gewhnlich auf dieses Format
zurck. So z.B. fr die Settings meiner Entwicklungsumgebung
Chatwin oder fr die gepackten Icondaten des IconMan.

Der genaue Aufbau soll hier und jetzt nicht bis ins kleinste
Detail ausgebreitet werden (das drfte auch kaum jemanden interes-
sieren), aber im Prinzip bestehen die Dateien aus ineinander ge-
schachtelten Blcken (sogenannten "Chunks"), die alle mit einer
vier Byte langen ASCII-Kennung und einer Lngenangabe (ebenfalls
in vier Byte) beginnen. Und genau diese Chunks stellt das Modul
als Hexdump dar, wobei sich die Verschachtelung anhand der Ein-
rckung erkennen lt.


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

Modulname:     XIMG.MDL
Modulkennung:  XIMG
Modultyp:      Importmodul
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.05
Versionsdatum: Aug  6 1994


Beschreibung

Dieses Modul importiert Bilder im XIMG-Format als Farbbilder in
Zeig's mir. XIMG ist die Erweiterung des IMG-Formats um Farb-
informationen. Da Zeig's mir bereits Bilder im monochromen IMG-
Format lesen kann, wre es nur logisch, da die XIMG-Funktion
auch selbst in Zeig's mir integriert wrde (zumal die hier ver-
wendete Entpackroutine auch monochrome IMGs lesen knnte). Leider
ist der Autor von Zeig's mir da anderer Meinung, weshalb ich mich
gezwungen sah, dieses Modul zu schreiben ...

Anmerkung: Das ist nur halb so ernst gemeint, wie es klingt.
Trotzdem verstehe ich nicht, warum der gute Reiner sich strubt,
zumal es ihn nichts kosten wrde (weder Geld noch Speicherplatz
und so gut wie keine Arbeit).


                                                           ZEIGBLK.MDL
----------------------------------------------------------------------

Modulname:     ZEIGBLK.MDL
Modulkennung:  ZEIGBLK
Modultyp:      Importmodul
Autor:         (c) Reiner Rosin
Versionsnr:    01.10
Versionsdatum: 16. Februar 1994


Beschreibung

Dieses Modul kann wahrscheinlich niemand auer mir gebrauchen.
Man kann damit monochrome Bitblcke anzeigen, wie sie GFA-Basic
 mit dem GET-Befehl erzeugt.


                                                           ZEIGDOC.MDL
----------------------------------------------------------------------

Modulname:     ZEIGDOC.MDL
Modulkennung:  ZDOC
Modultyp:      Importmodul
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.12
Versionsdatum: Aug  6 1994


Beschreibung

Dieses Modul importiert Texte im DOC-Format von 1stWord(plus) als
ASCII-Texte in Zeig's mir. Da Zeig's mir bei Texten nur das reine
ASCII-Format untersttzt, gehen smtliche Schriftinformationen
(fett, unterstrichen, usw.), Funoten und eingebundene Bilder
verloren. Wurde das 1stWord-Dokument im Blocksatz geschrieben, so
bleibt zumindest dieser erhalten.


                                                           ZEIGFNT.MDL
----------------------------------------------------------------------

Modulname:     ZEIGFNT.MDL
Modulkennung:  ZEIGFNT
Modultyp:      Importmodul
Autor:         (c) Reiner Rosin
Versionsnr:    01.10
Versionsdatum: 16. Februar 1994


Beschreibung

Mit diesem Modul lassen sich Screenfonts im Format 8*16 oder
8*8 laden. Diese Fonts haben keinen Header (Lnge konstant 4096
bzw. 2048 Bytes) und es gibt zwei unterschiedliche Formate: Das
GEM-bliche Format, in dem die Daten quasi als Bitmap mit 2048
Pixeln Breite und 8 resp. 16 Pixel Hhe gespeichert sind und das
von STaD verwendete Format, bei dem alle Zeichen hintereinander
angeordnet sind (quasi 8 Pixel breit und 2048 resp. 4096 Pixel
hoch). Das Modul versucht eine automatische Unterscheidung, die
sogar recht zuverlssig funktioniert.


                                                           ZEIGPIC.MDL
----------------------------------------------------------------------

Modulname:     ZEIGPIC.MDL
Modulkennung:  ZEIGPIC
Modultyp:      Importmodul
Autor:         (c) Reiner Rosin
Versionsnr:    01.10
Versionsdatum: 16. Februar 1994


Beschreibung

Importmodul fr ungepackte Screendumps (Lnge konstant 32000
Bytes), auch bekannt als Doodle-Format (DOO).


                                                           ZEIGSND.MDL
----------------------------------------------------------------------

Modulname:     ZEIGSND.MDL
Modulkennung:  ZSND
Modultyp:      Importmodul
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.18
Versionsdatum: Aug  6 1994


Beschreibung

Dieses Modul importiert Samples in verschiedenen Formaten in
Zeig's mir. Im einzelnen werden folgende Formate untersttzt:

 - Windows WAVE (*.WAV)
 - Creative Voice File (*.VOC)
 - Amiga IFF/8SVX
 - AVR
 - SoundMerlin
 - SoundMachine
 - das Format des Programms DMA_PLAY.PRG
 - ein vom Macintosh stammendes Format
 - einige Formate unbekannter Herkunft (JON, FSSD, V8)

Die mir zu diesen Formaten vorliegenden Dokumentationen reichen
von sehr ausfhrlich (WAV, VOC) ber ausreichend (AVR, IFF) bis
zu nicht vorhanden (Mac-SND, JON, FSSD, V8). Das Bestreben war,
mglichst alles abspielen zu knnen, was auch nur im entferntesten
nach einem Sample aussieht. Bei den nicht dokumentierten Formaten
besteht die Mglichkeit, da sich einzelne Files nicht richtig
abspielen lassen, da das Dateiformat eben nur geraten ist. Aber
auch bei den gut dokumentierten Formaten sind noch nicht alle
Mglichkeiten bercksichtigt.


                                                           ZEIGZYX.MDL
----------------------------------------------------------------------

Modulname:     ZEIGZYX.MDL
Modulkennung:  ZEIGZYX
Modultyp:      Importmodul
Autor:         (c) Reiner Rosin
Versionsnr:    01.00
Versionsdatum: 16. Februar 1994


Beschreibung

Importer fr Zyxel-Voicefiles. Im Gegensatz zu ADPCM.MDL von
Thorsten kann man hiermit nur die 3-Bit-ADPCM-codierten Dateien
laden. Durch Assemblerprogrammierung ist es dafr aber um etwa
den Faktor 6 schneller.


                                                           ASCTEST.MDL
----------------------------------------------------------------------

Modulname:     ASCTEST.MDL
Modulkennung:  ASCTEST
Modultyp:      Bearbeitungsmodul ASCII
Autor:         (c) Reiner Rosin
Versionsnr:    01.00
Versionsdatum: 7. September 1993




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

Modulname:     CHAINSAW.MDL
Modulkennung:  CHAINSAW
Modultyp:      Bearbeitungsmodul ASCII
Autor:         (c) Toastware
Versionsnr:    00.01
Versionsdatum: 4. Februar 1994


Beschreibung

Chainsaw macht einen Zeilenumbruch bei Asciitexten. Wenn also
ein Text die max. Zeilenlnge 500 hat (z.B. ein blockgesetzter
Text ohne Returns), stellt man z.B. 80 ein und erhlt dann einen
Text, den man ohne Probleme lesen kann. Es wird sogar darauf
geachtet, da kein Wort zersgt wird (es sei denn es ist lnger
als die Zeilenlnge).


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

Modulname:     GREP.MDL
Modulkennung:  GREP
Modultyp:      Bearbeitungsmodul ASCII
Autor:         Reiner Rosin
Versionsnr:    01.02
Versionsdatum: Aug 11 1994


Beschreibung

Mit Grep lassen sich in Texten Zeichenketten suchen und der
Bereich um die Fundstelle zeilenweise als neuer Text anlegen.

Parameter:
Suchstring         - drfte klar sein, der zu suchende String
Zeilen vorher      - soviele Zeilen vor der Fundstelle werden
                     kopiert
Zeilen nachher     - soviele Zeilen nach der Fundstelle werden
                     kopiert
Leerzeile trennt Abstze
                   - ist diese Option aktiviert, dann wird vor
                     und nach der Fundstelle nur maximal bis zur
                     nchsten Leerzeile kopiert
Wildcard (nur '?') - mit dieser Option whlt man, ob das
                     Fragezeichen als Wildcard zulssig ist
Gro=Klein         - legt fest, ob Gro-Kleinschreibung unter-
                     schieden werden soll


Anwendungsbeispiel: Man sucht in einer Maus-Dateiliste alle
Uploads eines bestimmten Users. Als Suchstring gibt man "Von
<Vorname> <Nachname>" ein, setzt die Zeilenlimits auf Maximum
(=9) und whlt "Leerzeile trennt Abstze" --> et voila - da ist
die Liste.


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

Modulname:     TABSPACE.MDL
Modulkennung:  TABSPACE
Modultyp:      Bearbeitungsmodul ASCII
Autor:         (c) Toastware
Versionsnr:    00.02
Versionsdatum: 27.04.1994 


Beschreibung

TABSPACE expandiert die in Texten vorkommenden Tabulatoren und
ersetzt sie durch feste Leerzeichen.


                                                          UML_WAND.MDL
----------------------------------------------------------------------

Modulname:     UML_WAND.MDL
Modulkennung:  R_UW
Modultyp:      Bearbeitungsmodul ASCII
Autor:         Reiner Rosin
Versionsnr:    00.02
Versionsdatum: Aug  9 1994


Beschreibung

Der Umlautwandler wandelt - wer htte es gedacht - Umlaute.
Dabei gibt es zwei Mglichkeiten:

    a) ->ae, ->oe, ->ue, ->Ae, ->Oe, ->Ue, ->ss
    b) ->/"a, ->/"o, ->/"u, ->/"A, ->/"O, ->/"U, ->/"s


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

Modulname:     BITMAP.MDL
Modulkennung:  BITMAP
Modultyp:      Bearbeitungsmodul Monochrombilder
Autor:         (c) Reiner Rosin
Versionsnr:    01.20
Versionsdatum: 16. Februar 1994


Funktion:      BITMAP stellt elementare Operationen zur
               Bearbeitung von monochromen Bildern zur Verfgung

Diese Operationen sind:

-Halbieren eines Bildes in X- oder Y-Richtung oder beides
-Verdoppeln eines Bildes in X- oder Y- oder beiden Richtungen
-Spiegeln an der vertikalen oder horizontalen Mittellinie


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

Modulname:     FAX300.MDL
Modulkennung:  FAX300
Modultyp:      Bearbeitungsmodul Monochrombilder
Autor:         (c) Reiner Rosin
Versionsnr:    01.20
Versionsdatum: 16. Februar 1994


Funktion: Umrechnen von Faxdateien (200*200 oder 200*100 DPI) auf
          Laserdruckerauflsung (300*300 DPI)

Beschreibung:

Faxe liessen sich bis jetzt nur sehr unbefriedigend von Zeig's
mir ausdrucken. Grund dafr ist die merkwrdige Auflsung, in der
Faxe definitionsgem vorliegen: 200*100 bzw. 200*200 DPI
(genaugenommen 198 bzw. 98 DPI). Diese Auflsung wird von keinem
Drucker untersttzt und ist auch nicht mit "glatten" Umrechnungs-
faktoren erreichbar.

Mit FAX300 kann man jedoch jetzt Faxe auf das Format 300*300 DPI
umrechnen (fr Laser- und Tintenstrahldrucker). Dabei gibt es
zwei Besonderheiten:

-Faxe sind ca. 8.7 Zoll breit (1728 Pixel), die Druckbreite von
 Laserdruckern betrgt jedoch i.d.R. nur 8 Zoll, d.h. 8*300 =
 2400 Pixel. Deshalb wird in X-Richtung mit einem krummen Faktor
 von 11/8 gerechnet.

-Meist wird eine ganze DIN-A4-Seite gefaxt (29.7 cm = 2340
 Pixel), dazu kommt noch die Stampline. Die Druckhhe bei Laser-
 druckern ist jedoch nur ~11 Zoll, also 3300 Pixel gro. In der
 Y-Achse wird deshalb eine Skalierung um den Faktor 4/3 vorgenommen.

Daraus folgt: In Wirklichkeit betrgt die erzielte Auflsung
nicht 300*300, sondern 272*264 DPI. Wenn Mahaltigkeit gefragt
ist, ist das natrlich keine gute Lsung, im andern Fall bekommt
man so  wenigstens eine ganze Faxseite auf ein Blatt.


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

Modulname:     INVERTER.MDL
Modulkennung:  INVERTER
Modultyp:      Bearbeitungsmodul Monochrombilder
Autor:         (c) Reiner Rosin
Versionsnr:    01.02
Versionsdatum: 16. Februar 1994


Beschreibung

Dieses Modul invertiert Monochrombilder.


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

Modulname:     PIC_CUT.MDL
Modulkennung:  PIC_CUT
Modultyp:      Bearbeitungsmodul Monochrombilder
Autor:         Reiner Rosin
Versionsnr:    00.01
Versionsdatum: Mar 27 1994


Funktion: Schneidet die (manchmal) strenden weien Rnder um
          Bitmaps ab.

Einschrnkung: Es wird nur byteweise gesucht, also bleibt links
               ein bis zu 7 Pixel breiter Rand brig, rechts
               wegen des Word-Alignements sogar ein bis zu 15
                Pixel breiter.


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

Modulname:     PIC_DBL.MDL
Modulkennung:  PIC_DBL
Modultyp:      Bearbeitungsmodul Monochrombilder
Autor:         Reiner Rosin
Versionsnr:    00.04
Versionsdatum: Aug  9 1994


Beschreibung

Verdoppelt eine Bitmap in Breite und Hhe. Im Gegensatz zum
Bitmaptool-Modul wird ein "intelligenter" Algorithmus benutzt,
der Zwischenpixel berechnet, d.h. es entstehen keine
Kltzchengrafiken, sondern, soweit mglich, harmonische Bilder.

Es stehen drei Algorithmen zur Verfgung:

"Ausdnnen, eckig" - besonders fr technische Zeichnungen,
                     z.B. Schaltplne geeignet

"Ausdnnen, rund"  - fr gerasterte Bilder geeignet

"Verdicken"        - fr Strichzeichnungen empfehlenswert


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

Modulname:     PIC_TURN.MDL
Modulkennung:  PIC_TURN
Modultyp:      Bearbeitungsmodul Monochrombilder
Autor:         Reiner Rosin
Versionsnr:    00.13
Versionsdatum: Aug  9 1994


Funktion: Dreht monochrome Bitmapgrafiken um 180 Grad oder um
          90 Grad nach rechts oder links


                                                          KOMPRESS.MDL
----------------------------------------------------------------------

Modulname:     KOMPRESS.MDL
Modulkennung:  KOMPRESS
Modultyp:      Bearbeitungsmodul Samples
Autor:         (C) Toastware
Versionsnr:    00.01
Versionsdatum: Aug 18 1994


Beschreibung

Der Kompressor regelt die Verstrkung von Samples in Abhngigkeit
von momentaner und _kommender_ Lautstrke.
Mit den Parametern 'Abkling-' und 'Anklingfaktor' wird die
Geschwindigkeit der Verstrkungsnderung geregelt. Je grer
der Wert, desto langsamer. Im optionalen V(t)-Fenster kann man
sich die daraus entstandene Verstrkung ansehen.


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

Modulname:     SAMPCALC.MDL
Modulkennung:  SAMPCALC
Modultyp:      Bearbeitungsmodul Samples
Autor:         (c) Reiner Rosin
Versionsnr:    01.10
Versionsdatum: 16. Februar 1994


Dieses Modul beinhaltet zwei Funktionen zur Bearbeitung von
Samplen:

1. Nullage
Verschiebt die Amplituden linear, so da die grten Amplituden
symmetrisch zur Mittellinie liegen (was nicht automatisch
impliziert, da auch der Mittelwert aller Samplewerte 0 ergibt).

2. Maximale Verstrkung
Hebt die Lautstrke um den maximal mglichen Faktor an, so da
das Signal gerade eben noch nicht verzerrt wird. Sollte im
eigenen Interesse nicht mehrmals auf das gleiche Sample
angewendet werden (Rundungsfehler!).


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

Modulname:     SAMPMIRR.MDL
Modulkennung:  SAMPMIRR
Modultyp:      Bearbeitungsmodul Samples
Autor:         Reiner Rosin
Versionsnr:    00.11
Versionsdatum: Mar 27 1994


Beschreibung

Spiegelt ein Sample, d.h. es wird danach rckwrts abgespielt.


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

Modulname:     SOUNDEXP.MDL
Modulkennung:  SNDX
Modultyp:      Bearbeitungsmodul Samples
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.02
Versionsdatum: Aug  6 1994


Beschreibung

Dieses Modul exportiert 8-Bit-Samples als HSN-Files, wie sie z.B.
von dem Programm CrazySounds verwendet werden. Die Frequenzen der
CrazySounds-Samples orientieren sich an den Frequenzen der Atari-
Rechner mit DMA-Sound-Hardware, deshalb werden die Samples vor dem
Export ntigenfalls noch in eine der Frequenzen 6258, 12517,
25033 oder 50066 Hz umgerechnet (mit Tendenz zur hheren, d.h. ein
Sample, das mit 22050 Hz vorliegt, wird auf 25033 Hz umgerechnet).
Beachten Sie bitte, da die Samples dadurch u.U. lnger werden,
als das Ausgangs-Sample.

Bedienung: Whlen Sie im Dialog "Bearbeiten" im Popup den Men-
punkt "Sample exportieren" und geben Sie im Fileselector den Namen
des Samples ein (Extension sollte "HSN" sein).

Die Routine zum Umrechnen auf eine hhere Frequenz stammt von
Reiner Rosin himself und findet in dieser Form auch schon in
Zeig's mir Verwendung.


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

Modulname:     GDPSSCAN.MDL
Modulkennung:  R_GS
Modultyp:      Sourcemodul
Autor:         Reiner Rosin
Versionsnr:    00.03
Versionsdatum: Aug  9 1994


Beschreibung

GDPSSCAN sucht einen installierten GDPS-Scannertreiber und
versucht diesen zur Mitarbeit zu berreden.

Einschrnkungen
-Getestet wurde es mit einem einzigen Scanner (UMAX UC630) in den
 Betriebsarten s/w, 256 Graustufen und TrueColor. Da der UMAX-
 GDPS-Treiber stellenweise stark von der mir vorliegenden GDPS-
 Beschreibung abweicht, habe ich versucht, die kritischen Punkte
 mglichst vernnftig geradezubgeln, um sowohl der Spezifikation
 als auch dem UMAX-Treiber gerecht zu werden.
 Es kann jetzt allerdings vorkommen, da z.B. mit 64 Graustufen
 gescante Bilder oder sonstige Exoten sonderbare Ergebnisse
 liefern.


Ich wre den Besitzer von Scannern mit GDPS-Treibern sehr
verbunden, wenn sie mir ihre Erfahrungen mit diesem Modul bitte
mitteilen knnten!


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

Modulname:     SRC_DMAS.MDL
Modulkennung:  SRC_DMAS
Modultyp:      Sourcemodul
Autor:         (c) Reiner Rosin
Versionsnr:    01.00
Versionsdatum: 20. Februar 1994


Dieses Modul ist nichts fr schwache Nerven. ngstliche Naturen
solten es sofort lschen!

Was macht dieses Modul? Es liest die Frameregister des DMA-Sound-
chips aus und kopiert den Speicherbereich, auf den diese Register
zeigen in den Speicher von 'Zeig's mir'.

Was kann man damit machen? Man stellt so das letzte per DMA-Sound
gespielte Sample wieder her. Damit kann man z.B. die Aufnahmen
des Anrufbeantworters von CoNnect konvertieren. CoNnect starten,
Aufnahme abspielen und sofort (am besten aus dem parallel
laufenden 'Zeig's mir', d.h. Accessory oder Multitaskingumgebung)
"DMA-Sample klauen" ausfhren.

Was kann schiefgehen? Einiges! Die grbsten Flle fngt das Modul
ab:
   - DMA-Sound nicht vorhanden
   - kapitale Fehler in den Framedaten (Framestart/-ende = 0 oder
     Ende<Start)
Trotzdem kann einiges kaputtgehen:
   - Frameregister zeigen auf ungltige Adresse (Bus-Error!)
   - Memory-Protection eingeschaltet. Der Bereich, in dem der
     Frame liegt, gehrt nicht unbedingt 'Zeig's mir' (Oft tut er
     es doch, weil er in dem Bereich liegt, den 'Zeig's mir' fr
     das Modul angefordert hat).
     Bis jetzt kann das aber nur unter MTOS zu Problemen fhren.
   - Manchmal ist auch der Speicher mittlerweile anderweitig
     benutzt. Das ist nicht weiter tragisch - dann wird einfach
     Mll zurckgeliefert.

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

Obacht also, SRC_DMAS ist ein Schweinemodul! Da es sowieso nicht
sonderlich ntzlich ist, wird man's aber nicht oft brauchen. Und
wenn man's dann doch einmal einsetzt, vielleicht vorher besser
doch alle Dokumente in Calamus, Tempus Write usw. schlieen...

Solange es nicht gestartet wird, ist es brigens vllig
unschdlich. Man kann's also beruhigt im Modulordner lassen.

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


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

Modulname:     SRC_SCRN.MDL
Modulkennung:  SRC_SCRN
Modultyp:      Sourcemodul
Autor:         (c) Reiner Rosin
Versionsnr:    01.00
Versionsdatum: 20. Februar 1994


Beschreibung

Hiermit kann der aktuelle Bildschirminhalt gegrabbed werden.
Vielleicht kann's ja in dem einen oder anderen Fall eine
Hardcopy ersetzen - man wei ja nie.


Risiken und Nebenwirkungen:

-Das Modul arbeitet nur auf monochromen Bildschirmen, da
 'Zeig's mir' zum Zeitpunkt der Modulerstellung noch keine
 Farbbilder verarbeiten konnte. Wird evtl. noch gendert.

-Der Bildspeicher mu im Adressraum eingeblendet sein, d.h.
 Physbase eine gltige Adresse liefern (einige Grafikkarten
 scheiden also aus)

-Das Modul ruft LineA auf, um die physikalische und logische
 Bildschirmbreite zu ermitteln. Das drfte akzeptabel sein - es
 wird nur lesend zugegriffen.

-Die Dialogbox zur Funktionsauswahl wird evtl. vor dem Funktions-
 aufruf nicht vom Bildschirm gelscht. Abhilfe: Box auf einen
 freien Bildbereich schieben  oder aus dem Bildschirm heraus und
 mit [Return] auslsen.

-Gleiches gilt fr den Mauszeiger. Am besten in eine Bildecke
 schieben.


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

Modulname:     BRIGHTEN.MDL
Modulkennung:  BRIG
Modultyp:      Bearbeitungsmodul Farbbilder
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.02
Versionsdatum: Aug  6 1994


Beschreibung

Mit diesem Modul kann die Helligkeit von Farbbildern verndert
werden. Im Dialog "Bearbeiten" knnen Sie dazu zwischen mehreren
vorgegebenen Werten (jeweils 5, 25 oder 33 Prozent aufhellen oder
abdunkeln) whlen. Klicken Sie dagegen den Punkt "Helligkeit
whlen" an, so knnen Sie in einem Dialog den Prozentwert selbst
eingeben (Werte von 1 bis 99, ein Wert "0 Prozent" ist unsinnig
und wird abgelehnt). Klicken Sie dann, je nach gewnschter Funk-
tion, auf einen der Buttons "aufhellen" oder "abdunkeln". Haben
Sie es sich anders berlegt, so knnen Sie den Dialog auch mit
"Abbruch" abbrechen, das Bild wird dann nicht verndert.

Fr technisch interessierte Mitmenschen: Das Modul rechnet die in
RGB-Werten vorliegenden Bildinformationen ins YIQ-Farbmodell um
(wobei Y die Helligkeit und I und Q Farbinformationen sind). Dort
werden dann die Y-Werte um die angegebene Prozentzahl erhht oder
erniedrigt und anschlieend wieder ins RGB-Modell zurck ber-
fhrt.

Das YIQ-Farbmodell wird z.B. vom amerikanischen NTSC-Fernsehstan-
dard verwendet. Nhere Informationen hierzu finden sich
(natrlich :-) in

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


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

Modulname:     COL_FUNC.MDL
Modulkennung:  R_CF
Modultyp:      Bearbeitungsmodul Farbbilder
Autor:         Reiner Rosin
Versionsnr:    00.04
Versionsdatum: Aug  9 1994


Funktion: Soll einmal eine Sammlung elementarer Operationen fr
          Farbbilder werden. Als erstes ist einmal das Verdoppeln
          von Bildern implementiert.


Bild verdoppeln 1: Verdoppelt ein Bild, indem es Zwischenpixel
                   und Zwischenzeilen interpoliert. Das Zielbild
                   wird grundstzlich in True-Color abgelegt, was
                   zum einen einen hohen Speicherbedarf, zum
                   anderen ggfs. weitere Raster- und Ditherungs-
                   schritte ntig macht.
                   Die Interpolation bewirkt ein Aufweichen der
                   Konturen, verhindert aber die
                   Blckchenbildung.

Bild verdoppeln 2: Verdoppelt das Bild, indem jeder Pixel auf
                   seine vierfache Gre (doppelte Hhe und
                   Breite) umgerechnet wird.


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

Modulname:     COL_INFO.MDL
Modulkennung:  R_CI
Modultyp:      Bearbeitungsmodul Farbbilder
Autor:         Reiner Rosin
Versionsnr:    00.04
Versionsdatum: Aug  9 1994


Funktion: COL_INFO wertet Palettenbilder aus und zhlt die
          einzelnen Farben.  Das Ergebnis kann als Infotext
          oder graphisch dargestellt werden.

Modulfunktionen:
          -"Farben zhlen" zhlt die vorkommenden Farben und
            gibt deren Anzahl sowie den untern und oberen Index
            in Textform aus

          -"Histogramm (s/w)" zeichnet ein Histogramm, d.h. eine
           Hufigkeitsverteilung (X-Achse: Farbindizes, Y:
           Hufigkeit)

          -"Histogramm farbig" tut das gleiche, nur sind die
            Sulen in der jeweiligen Farbe eingefrbt

          -"Hufigkeitstabelle" erstellt eine Tabelle in ASCII-
           Form, d.h. zu jedem Farbindex wird die Anzahl der
           Pixel angegeben, mit der diese Farbe im Bild vorkommt

          -"Palette zeichnen" fertigt eine Farbtafel an, die
           alle im Bild vorkommenden Farben enthlt

Einschrnkungen:
          -COL_INFO arbeitet nur in Auflsungen mit 16 oder 256
           Farben (Palettenbilder halt)


                                                          MAULWURF.MDL
----------------------------------------------------------------------

Modulname:     MAULWURF.MDL
Modulkennung:  R_MW
Modultyp:      Bearbeitungsmodul Farbbilder
Autor:         Reiner Rosin
Versionsnr:    00.03
Versionsdatum: Aug  9 1994


Beschreibung

Wer kennt es nicht, da sitzt man gerade am Rechner und betrachtet
sich ein wunderschnes Landschafts-GIF. "Oh, Ahh, schn,
dieser wundervoll blaue Himmel, diese leuchtendgelbe Sonne,
diese saftig grne Wiese, ..." und bumm - wieder eine Randgruppe
diskrimniert. Denn nicht fr jeden ist grn gleich grn und rot
gleich rot, es gibt auch farbenblinde Mitbrger!

"Na und, da kann man nichts machen, was kann GEM-View schon
dafr?" Ha! Erstens geht's hier nicht um GEM-View, sondern um
'Zeig's mir', und zweitens kann 'Zeig's mir' da selbst-
verstndlich was machen. Und zwar Rot und Grn vertauschen, so
da auch farbenblinde Lonsheim-Maulwrfe endlich echte True-
Color-Farben zu sehen bekommen.


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

Modulname:     NOBORDER.MDL
Modulkennung:  NOBO
Modultyp:      Bearbeitungsmodul Farbbilder
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.01
Versionsdatum: Aug 11 1994


Beschreibung

Mit diesem Modul kann man einfarbige Rnder von Farbbildern ent-
fernen lassen (z.Z. nur bei Bildern mit 256 Farben). Dabei kann
man whlen, ob die Rnder an allen vier Seiten abgeschnitten
werden sollen (Funktion "Weg mit dem Rand!"), oder ob nur ein Rand
(oben, unten, links oder rechts) entfernt werden soll.

Wenn das Modul einmal nicht den gewnschten Effekt zeitigt, dann
liegt dies daran, da der Rand wohl doch nicht so einfarbig ist,
wie es den Anschein hat. Ein einzelner Pixel in einer anderen
Farbe oder ein Rand, der aus zwei hnlichen Farbtnen besteht,
hindert das Modul erfolgreich an seiner Arbeit. Solche Flle kann
man aufdecken, indem man mit dem Kontrollfeld einmal probehalber
die Farben verstellt.

Die Funktionen "Rand suchen" suchen von den Bildrndern her nach
durchgehenden einfarbigen Linien und schneiden, sofern sie fndig
geworden sind, dann dort ab. Dabei wird maximal ein Drittel der
Bildbreite bzw. -hhe (vom jeweiligen Rand her) durchsucht.

Durch mehrfaches Anwenden der beiden Mglichkeiten knnen die
meisten Bilder von strenden Rndern (und evtl. "Verzierungen"
wie Mailbox-Logos) befreit werden.


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

Modulname:     PIC2ASC.MDL
Modulkennung:  R_PA
Modultyp:      Bearbeitungsmodul Farbbilder
Autor:         Reiner Rosin
Versionsnr:    00.02
Versionsdatum: Jul  5 1994


Beschreibung

Wandelt ein Farbbild in einen ASCII-Text um. Dazu wird das Bild
in kleine Rechtecke einstellbarer Gre aufgeteilt und fr jedes
dieser Rechtecke die Helligkeit bestimmt. Durch Setzen eines
geeigneten Zeichens entsteht in dem erzeugten Text mit etwas
Phantasie ein Abbild des Originals.


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

Modulname:     TARGAEXP.MDL
Modulkennung:  TGAX
Modultyp:      Bearbeitungsmodul Farbbilder
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.03
Versionsdatum: Aug 13 1994


Beschreibung

Dieses Modul exportiert ein Farbbild als Bild im ungepackten
Targa-Format (TGA). Das Modul wird dazu im Dialog "Bearbeiten"
ber den Popup-Eintrag "Targa-Bild speichern" angewhlt. Es
erscheint ein Fileselector, in dem Sie den Namen des Bildes
angeben knnen.

Hinweise: High-Color-Bilder (16 Bit pro Pixel) werden z.Z. als
True-Color-Bilder (24 Bit pro Pixel) gespeichert. Monochrome
Bilder werden nicht untersttzt.


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

Modulname:     ELIMINAT.MDL
Modulkennung:  R_EL
Modultyp:      Dithermodul
Autor:         Reiner Rosin
Versionsnr:    00.01
Versionsdatum: Jul 28 1994


Funktion:    Der Eliminator reduziert 256-Farbbilder auf 240 oder
             14 Farben, indem er einzelne Farben auslscht. Wie
             jedes hirnlose Muskelpaket vergreift sich auch diese
             Kampfmaschine an den kleinsten und schwchsten, will
             sagen an den Farben, die im Bild am seltensten
             vorkommen.

Algorithmus: Solange die Farbanzahl ber dem Maximum liegt, wird
             die am seltensten vorkommende Farbe bestimmt und
             diese durch die hnlichste, bereits im Bild
             vorkommende ersetzt.

             Die Suche nach der hnlichsten Farbe geschieht ber
             die RGB-Werte, wobei als Abstand zweier Farben das
             Produkt der Differenzen des R-, G-, und B-Wertes
             gebildet wird. Vor der Multiplikation wird auf jede
             Differenz noch ein konstanter Wert aufaddiert (sonst
             wrden Farbpaare, die sich in einem Wert nur gering
             unterscheiden bevorzugt).

             Der Farbwert fr die zugeordnete Farbe wird dann
             noch geringfgig an die eliminierte Farbe angepat.

Ergebnis:    Bei 256 Farben arbeitet das Verfahren im allgemeinen
             recht brauchbar, es mssen im Extremfall auch nur 16
             Farben eliminiert werden (meistens sind es weniger).
             Da nur die am wenigsten vorkommenden Farben raus-
             fliegen, sind die Farbverflschungen im Normalfall
             kaum wahrnehmbar. Es sind aber auch Bilder denkbar,
             bei denen es total daneben geht.

             Unter 16 Farben sieht's da schon ganz anders aus.
             Hier mu der Eliminator meist krftig aufrumen, was
             an den Bildern schon schmerzliche Verluste erkennen
             lt. Die Ergebnisse sind aber auf jeden Fall besser
             als z.B. die mit PALFIX erzeugten. Ich denke mal,
             da sich mit vertretbarem Aufwand und ohne Dithern
             kein sehr viel besseres Resultat erzielen lt.


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

Modulname:     HTDITHER.MDL
Modulkennung:  HDIT
Modultyp:      Dithermodul
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.15
Versionsdatum: Jul 29 1994


Zweck  : Farbbilder nach Monochrom wandeln,
         Algorithmus: Halftone-Dithering


Beschreibung

Dieses Modul wandelt Farbbilder in Monochrombilder. Als Algo-
rithmus kommt dabei das sogenannte Halftone-Dithering zum
Einsatz.

Konkret knnen Sie zwischen zwei Mglichkeiten whlen:

"Halftone 1:1"
   Trotz Verwendung einer 3x3-Matrix wird jeder Pixel des
   Farbbildes auf einen Pixel des Monochrombildes abgebildet. Die
   Gre des Bildes bleibt also unverndert.

"Halftone 1 -> 3x3"
   Hierbei wird jeder Pixel des Originalbildes auf eine 3x3 Pixel
   groe Matrix im Monochrombild abgebildet. Das Bild wird also
   dreimal so hoch und dreimal so breit.

Bilder, die "halftone-gedithert" sind, kennen Sie sicher aus der
Tageszeitung. Eine sinnvolle Anwednung des Algorithmus ist,
Farbbilder so aufzubereiten, da Sie auf einem Ausgabemedium
wiedergegeben werden knnen, das nur die Farben Schwarz und Wei
untersttzt. Dabei ist insbesondere an Gerte mit hoher Auflsung
gedacht, also beispielsweise Drucker. Die zweite Mglichkeit, bei
der je ein Pixel auf eine 3x3-Matrix abgebildet wird, mag zwar
auf dem Monitor nicht sehr beeindruckend erscheinen, liefert aber
auf einem Drucker mit 300 oder 360 dpi recht gute Resultate.

Auf dem Bildschirm liefert Halftone-Dithering meist recht
unansehnliche Ergebnisse. Gerade die 1:1-Abbildung ist eigentlich
nur dann von Interesse, wenn kein anderer Ditheralgorithmus zur
Verfgung steht, da sie recht grob gerasterte Bilder liefert.

Fr nhere Informationen zum Halftone-Dithering sei wieder einmal
verwiesen auf

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


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

Modulname:     IGOR_DIT.MDL
Modulkennung:  TDit
Modultyp:      Dithermodul
Autor:         (C) Toastware
Versionsnr:    00.0C
Versionsdatum: Aug 11 1994


Beschreibung

Dieses Modul enthlt verschiedene, z.T. sehr gute Ergebnisse
liefernde Ditheralgorithmen.

Floyd/Steinberg:
Der Fehler, der durch die Differenz zwischen darstellbarer und
gewollter Farbe/Helligkeit entsteht, wird auf die umliegenden
Pixel verteilt. Dadurch entsteht aus normaler Betrachtungs-
entfernung der Eindruck eines kontinuierlichen Farb-/Helligkeits-
verlaufs.

Mapping:
Die gewollte Farbe wird soweit 'verbogen', bis sie in die
vorgegebene Palette passt. Das geht zwar schnell, sieht aber auch
so aus, es entstehen mitunter eklige Farb-/Helligkeitstreppen.


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

Modulname:     MED_CUT.MDL
Modulkennung:  R_MC
Modultyp:      Dithermodul
Autor:         Reiner Rosin
Versionsnr:    00.03
Versionsdatum: Aug 11 1994


Beschreibung
Mit MED_CUT lassen sich True-Color und High-Color-Bilder nach
16 oder 256 Farben wandeln. Verwendung findet der Algorithmus
Median-Cut, der dem Modul auch gleich den Namen gegeben hat.

Algorithmus
Die im Bild vorkommenden Farben werden zunchst in einem RGB-
Wrfel angeordnet, dessen Seitenlngen anschlieend minimiert
werden, so da er gerade noch alle vorkommenden Farben
umschliet. Der enstehende Quader wird dann an seiner lngsten
Seite so  geschnitten, da in beiden entstehenden Teilquadern
die Punktmengen mglichst gleich gro sind. Beide Quader werden
danach  wieder wie beschrieben minimiert und danach der Quader
mit der grten Seitenlnge weiter geteilt. Dies wird so lange
wiederholt, bis die Anzahl der Quader der Zahl der gewnschten
Farben entspricht. Jedem Quader wird anschlieend eine Farbe
zugeordnet und alle Punkte innerhalb des Quaders werden mit
dieser Farbe dargestellt.

Umsetzung
Das Modul reduziert den Farbraum zunchst auf 32768 Farben, damit
Rechenzeit und Speicherbedarf (zur Laufzeit werden ca. 130 KB
bentigt) in einem vernnftigen Rahmen bleiben. Die Reduktion
der Farbquader erfolgt dann wie oben beschrieben, zur Zuordnung
der Quaderfarbe wird anschlieend der gewichtere Mittelwert der
aus enthaltenen Farben und deren Hufigkeit gebildet.
Im 256-Farbmodus belegt MED-CUT 240 Farbregister, im 16-Farbmodus
deren 14.

Ergebnis
Die Rechengeschwindigkeit ist etwa doppelt so hoch wie bei
Thorstens Floyd-Steinberg-Ditherern. Im 256-Farbmodus sind die
Ergebnisse bei fast allen Bildern ansehnlich bis sehr gut, bei
einigen lt sich aber mit der Floyd-Steinberg-Ditherung noch
etwas mehr herausholen. Im 16-Farbmodus sind dagegen einige
Abstriche mehr zu machen, das Ergebnis ist sowohl in puncto
Geschwindigkeit als auch Qualitt ein Kompromi zwischen Dithern
und der festen Farbzuordnung durch Mapping.
Nachteil des Verfahrens ist mit Sicherheit der groe Speicher-
bedarf.

Literatur
So ein tolles Buch wie Dirk habe ich nicht, die Idee und die
Grundlage fr MED_CUT stammen aus der ST-Computer 7/8-94, S.87ff.


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

Modulname:     PAL_SORT.MDL
Modulkennung:  R_PS
Modultyp:      Dithermodul
Autor:         Reiner Rosin
Versionsnr:    00.01
Versionsdatum: Aug 11 1994


Farbreduktionsmodul "Paletten-Sortierer"


Beschreibung
Dieses Modul sortiert bei Palettenbildern die Farben nach
Helligkeit. Wozu das gut sein soll? Keine Ahnung, aber als
angenehmer Nebeneffekt wird die "Luft" aus den Bildern gelassen,
d.h. nicht verwendete Indizes entfernt und bei Bildern mit
echten 256 Farben bleiben diese erhalten und werden dabei sogar
noch so sortiert, da Farbe 0 die hellste ist und Farbe 255
die dunkelste. Auerdem wird vielleicht die Histogrammfunktion
von COL_INFO etwas aussagekrftiger, wenn man die Farben vorher
mit PAL_SORT sortieren lt.


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

Modulname:     RAMBO.MDL
Modulkennung:  R_RA
Modultyp:      Dithermodul
Autor:         Reiner Rosin
Versionsnr:    00.01
Versionsdatum: Jul 29 1994


Der Eliminator hat einen Bruder bekommen...

Funktion: Rambo reduziert 256-Farbbilder auf 120 oder 14 Farben,
          ist aber eigentlich mehr als Juxmodul gedacht


Algorithmus: Siehe Beschreibung zum Eliminator. Im Gegensatz zum
Eliminator ist Rambo noch um einiges brutaler und legt sich auch
mit den strkeren Kalibern an - die Auswahl der zu eliminierenden
Farben erfolgt nach dem Zufallsprinzip. Da kann's auch schon mal
die eine oder andere Farbe erwischen, die etwas zahlreicher im
Bild vertreten ist.
Damit der gewnschte Effekt, ein mglichst interessantes Ergebnis
zu erzielen, auch unter 256 Farben erzielt wird, reduziert Rambo
hier nicht auf 240, sondern auf 120 Farben.


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

Modulname:     REDUCE.MDL
Modulkennung:  R240
Modultyp:      Dithermodul
Autor:         Dirk Haun @ WI2, Freeware
Versionsnr:    00.12
Versionsdatum: Aug 14 1994


Beschreibung

Dieses Modul reduziert die Farben in Palettenbildern mit 256
Farben auf maximal 240. Dies ist sinnvoll, damit Zeig's mir bei
solchen Bildern die 16 Standard-VDI-Farben nicht zu verstellen
braucht.

Vorgehensweise: Das Modul eliminiert zunchst Farben aus der
Farbpalette, die im Bild gar nicht verwendet werden. Anschlieend
werden identische Farben, d.h. Farben, die in der Palette mehrfach
vorkommen, zusammengelegt.

Bis hierhin war der Vorgang verlustfrei. Sollten nun noch mehr
als 240 Farben vorliegen, so nimmt das Modul nunmehr Verluste in
Kauf. Die Farben der Palette werden zunchst vom RGB- ins HSV-
Farbmodell berfhrt, in dem sich Farbhnlichkeiten leichter
auffinden lassen. Dort wird nun, bei steigender Ungenauigkeit,
versucht, Farben als "hnlich" zusammenzufassen. Der Vorgang wird
sofort abgebrochen, sobald 240 Farben erreicht sind. Nun werden
die verbliebenen Farben zurck ins RGB-Modell berfhrt und an
Zeig's mir weitergereicht.

Fr nhere Informationen ber das HSV-Farbmodell sei verwiesen auf

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


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

Modulname:     TINYDITH.MDL
Modulkennung:  R_TD
Modultyp:      Dithermodul
Autor:         Reiner Rosin
Versionsnr:    00.05
Versionsdatum: Aug  3 1994


Beschreibung

TINYDITH enthlt fnf Dithermethoden, von denen aber keine
besonders gute Ergebnisse liefert. Das Modul ist im wesentlichen
dazu gedacht, potentiellen Modulautoren als Grundlage fr eigene
Entwicklungen zu dienen. Die Algorithmen im einzelnen:

1. Schwellwertalgorithmus (fr monochrome Bildschirme)
Wandelt Farb- (genauer: Graustufen-) Bilder nach monochrom. Alle
Pixel, deren Helligkeit einen gewissen Schwellwert
unterschreiten, werden schwarz gesetzt, alle anderen dagegen
wei. Diese Methode ist dreimal integriert mit unterschiedlichen
 Schwellwerten.

2. Graustufenwandlung (fr Bildschirme mit 16/256 Farben)
Wandelt das Bild (bzw. die Palette) nach Graustufen um. Dabei
werden 16 oder 240 Graustufen benutzt.

3. PALFIX (fr Bildschirme mit 16/256 Farben)
Pret Farbbilder stur mathematisch in eine fest vorgegebene
Palette mit 16 bzw. 216 Farben.  Fehlerkorrektur, Rasterung oder
Ditherung wird nicht vorgenommen.
Je Farbe stehen 6 Abstufungen (0..5) zur Verfgung (bei 256
Farben) bzw. 2 Abstufen (0 und 1) fr Rot und Blau und 4
Abstufungen (0..3) fr Grn (bei 16 Farben).

4. Halbton, 5 Graustufen fr monochrome Auflsungen
Ich wei nicht, ob diese Bezeichnung richtig ist, jedenfalls
werden Bilder damit mit einer 2*2-Matrix umgesetzt nach
monochrom.

5. Spardither fr monochrome Auflsungen
Dies ist eine abgespeckte Version des Algorithmus von Floyd-
Steinberg. Statt die Ditherfehler nach rechts und nach unten zu
verteilen, verteilt der Sparditherer die Fehler nur in
X-Richtung.
Besondere Kennzeichen: schnell (25 Zeilen Assemler), Qualitt:
naja.

----------------------------------------------------------------------
                                                                 -eof-
