
===== SNAPPER.UPL 351B.: =======

Snapper v1.70, ein Snapshot-PRG/ACC: Speichern von whlbarer Flche,
ganzen Bildschirm oder oberstes/bestimmbares Fenster mit/ohne Rahmen,
mit/ohne Farbpalette; weien Rand abschneiden und/oder hinzufgen;
Kontrolle; zeitversetzt Snappen; wahlweise direkt ins Clipboard; alle
Auflsungen von Mono bis TrueColor; neues TIMG-Format (s. ATARI.NEWS)

===== SNAPPER.TXT 10173B.: =====

Snapper
=======

Ein Programm von                    und (ab v1.60) von

Udo Steinbach                       Jens Brggemann
Bloherfelder Strae 153             Reuterdamm 122
26129 Oldenburg                     30853 Langenhagen

MausNet: Udo Steinbach @ OL2        MausNet: Jens Brggemann @ H


Snapper ist ein Programm, mit dem man beliebige Bildschirmausschnitte in
Image-Dateien speichern kann.

Snapper wurde unter Verwendung der Mydial-Library von Olaf Meisiek und NKCC
von Harald Siegmund geschrieben.


Installation

  Snapper luft als Programm und als Accessory. Es gibt folgende
  Mglichkeiten:
    Sie knnen es als Accessory beim nchsten Booten mitladen. Dazu
      kopieren Sie das Programm einfach auf das Bootlaufwerk (meist C: oder
      A:) und benennen es in SNAPPER.ACC um. Wenn Sie jetzt resetten, kann
      Snapper jederzeit in Aktion treten.
    Sie knnen es auch jederzeit mit Chameleon laden, und auch wieder
      entfernen.
    Sie benennen es in SNAPPER.APP oder SNAPPER.PRG um und starten es. Das
      drfte nur unter Multitasking von Interesse sein, da aber wohl auch
      als bevorzugte Methode.


Bedienung

  Wird Snapper aufgerufen, erscheint folgender Dialog:

  "Koordinaten"   Hier wird bestimmt, wie die Koordinaten des zu sichernden
    Bildschirmausschnitts gewhlt werden sollen.
    <Whlbare Flche>   Man kann mit der Maus ein "Gummiband" aufziehen.
    <Ganzer Bildschirm>   Es wird der ganze Bildschirm gespeichert.
    <Fenster>   Die Koordinaten werden durch ein Fenster bestimmt. Auch der
      Desktop zhlt als Fenster.
      <oberstes>   In diesem Fall durch das oberste (aktive) Fenster. Unter
        MultiTOS oder MagiC besteht diese Wahlmglichkeit nicht.
      <whlbares>   Das Fenster wird durch Anklicken mit der Maus bestimmt,
        wenn der Dialog mit <Los gehts> verlassen wird.
      <mit Rahmen>   Ist dieser Button angewhlt, werden die Mae des
        Fensters inklusive der Titelzeile, der Slider, usw. gewhlt.
        Ansonsten nur die Arbeitsflche.
        Beim Desktop ist die Arbeitsflche der Bildschirm ohne Menzeile,
        der Rahmen die Menzeile.
    <Kontrolle>   Vor dem Speichern wird der gewhlte Ausschnitt invertiert
      und es erscheint ein Alert. So kann man sehen, ob auch tatschlich das
      Gewnschte gespeichert wird, und ggf. noch abbrechen.
    <x Sekunden warten>   Zwischen Dateiabfrage und Speichern des Bildes
      wird x Sekunden gewartet. Vor und nach der Aktion ertnt ein "Ping".
      Wird eine Wartezeit angegeben, findet keine Kontrolle statt!
      Sollen so modale Dialoge gespeichert werden, ist es von Vorteil, wenn
      diese auf weier Flche erscheinen, da man dann "Wei abschneiden"
      whlen kann und den Bereich nicht 100%ig genau angeben mu, um
      Nachbearbeitung zu verhindern.
  "Rand"
    <Wei abschneiden>   Eventuell vorhandene weie Rnder der bestimmten
      Flche werden abgeschnitten. Die Funktion kann bei viel weier Flche
      schon etliche Sekunden dauern!
    <x Punkte zugeben>   Um den Ausschnitt wird ein weier Rand mit x
      Punkten gelegt. Und zwar, nachdem das Wei abgeschnitten wurde, falls
      berhaupt gewhlt.
  "IMG"
    <ins Clipboard>   Die Image-Datei wird direkt unter dem Namen SCRAP.IMG
      ins GEM-Clipboard gespeichert. Ein Fileselector erscheint nicht.
    <Palette sichern>   Ist dieser Punkt angewhlt, wird die aktuelle
      Farbpalette mit abgespeichert. Ansonsten wird sie weggelassen, was
      verstndlicherweise bei Farbe nicht empfehlenswert ist.
      Da bei High- und TrueColor keine Palette vorhanden ist, kann sie in
      diesen Modi auch nicht mit abgespeichert werden.
  "Auflsung"
    <horizontal> x <vertikal> dpi.   dpi = dots per inch, Punkte pro Zoll.
      1 Zoll = 25,4 mm.
      Daraus ergibt sich die effektive Bildgre. Wenn berhaupt, werden
      diese Werte nur beim Drucken verwendet (z.B. TeX).
      Beim Start werden die Werte der aktuellen Bildschirmauflsung
      eingesetzt (keuch, aber pi mal Daumen kommt es schon hin).
  "Einstellungen"
    <Laden>   Die Einstellungen werden aus Snapper geladen. Snapper darf
      nicht gepackt sein! Kann es sich nicht selber finden, erscheint der
      Fileselector.
    <Sichern>   Die Einstellungen werden in Snapper gesichert. Stehen die
      Werte fr die Auflsung auf Null, werden sie beim nchsten Laden
      wieder auf die Bildschirmauflsung gesetzt.
      Snapper darf nicht gepackt sein! Kann es sich nicht selber finden,
      erscheint der Fileselector.
  <Los gehts>   Die zu speichernden Koordinaten werden ermittelt. Danach
    erscheint der Fileselector (auer <ins Clipboard> ist angewhlt). Man
    gibt wie in jedem anderen Programm einen Namen ein, und die gewhlte
    Flche wird gespeichert. Der Pfad und der Name werden fr den nchsten
    Aufruf gemerkt, wenn Snapper als Accessory luft.
    Ist nichts zu speichern, weil "Wei abschneiden" gewhlt wurde und die
    Flche nur aus Wei besteht, erscheint der Fileselector nicht, sondern
    eine entsprechende Meldung.
  <Abbruch>   Es passiert nichts weiter.


Rechtliches

  Snapper ist FreeWare. Snapper darf zu nicht kommerziellen Zwecken frei
  kopiert werden. Der Verkauf von Snapper, der Vertrieb ber PD-Versender
  und der Vertrieb mit anderer nicht kostenloser Software ist ohne meine
  schriftliche Genehmigung (mglicherweise gegen Gebhr) nicht gestattet.
  Die Verbreitung ber Mailboxen und BBSe ist gestattet, wenn fr den
  Download keine gesonderte Gebhr erhoben wird.
  Snapper mu immer komplett und unverndert weitergegeben werden. Dazu
  gehren die Dateien:
    SNAPPER.TXT  Diese Anleitung
    SNAPPER.UPL  Kurzbeschreibung fr den Programmteil der Maus-Boxen.
    SNAPPER.APP  oder
    SNAPPER.ACC  Das Programm.
  Es wrde mich freuen, wenn ich von den Benutzern eine kleine Nachricht
  (eMail oder Postkarte oder so) erhalten wrde.

  Ich, Jens Brggemann (Udo sowieso nicht mehr), bernehme keine Haftung fr
  irgendwelche direkten oder indirekten Schden - einschlielich, aber nicht
  beschrnkt auf - materielle oder finanzielle Schden, die durch die Benut-
  zung von Snapper, oder die Untauglichkeit von Snapper fr einen bestimmten
  Zweck, entstehen.


Und nun viel Spa damit!

  Ein Lob fr die Idee, die Existenz usw. knnt ihr gerne noch an Udos
  Adresse schicken (siehe oben). Kommentare, Flche, Fragen und Vorschlge
  zur aktuellen Version bitte an meine Adresse:

  MausNet:   Jens Brggemann @ H
  Internet:  Jens_Brueggemann@h.maus.de
      oder:  Jens_Brueggemann@maush.han.de


nderungen

  10.01.96  v1.70
    - Neues TIMG-Format fr High- und TrueColor-Auflsungen, vorgeschlagen
      von Guido Vollbeding (guivol@esc.de). Sein 1stGuide untersttzt dieses
      Format (ab Version 01/96), mit dem erweiterten XIMGTOOL stehen auch
      Sourcen zur Verfgung. Mein Dank geht an Guido sowie an Ulrich Kaiser
      fr's Testen des Snappers.
    - Genderte TrueColor- und Paletten-Erkennung (nur mit NVDI relevant).
    - Auch in High- und TrueColor wird beim "Punkte zugeben" nun ein weier
      Rand hinzugefgt (war bisher schwarz).

  31.01.95  v1.60
    - Fehlerhafte Erkennung von TrueColor und Paletten-Auflsungen gefixt;
      'Palette speichern' geht; wei wird nicht mehr zu blau verstellt.
    - Der Dialog sieht auch in kleinen Auflsungen und mit genderten AES-
      Zeichenstzen immer vernnftig aus. In ST-Low und Falcon-TrueColor
      zwar immer noch nicht ganz auf dem Bildschirm, aber voll bedienbar.
    - Mover-Fehler bei Alerts behoben.
    - 'Oberstes Fenster' ist zustzlich zu MultiTOS nun auch unter MagiC
      gesperrt, da es auch dort nicht analog zu Single-TOS funktioniert.
    - Keine doppelten '\' mehr im Fileselector im Wurzelverzeichnis.
    - Neue Option: 'ins Clipboard'.
    - Neue Version der Mydials, die jetzt mit genderten AES-Fonts klar-
      kommt, aber leider auch viel mehr Speicher verbrt. :-(
    - Als Accessory reagiert Snapper auf VA_START.
    - Komprimieren und Speichern jetzt gut doppelt so schnell.
    - Bei TrueColor werden nur noch echte Farbplanes gespeichert, Overlay-
      Bits werden - wie auch beim Randabschneiden - ignoriert.
    - Auch bei nach oben und/oder links aufgezogenem Gummiband stimmen jetzt
      die Koordinaten genau.
    - Beim 'Laden' und 'Speichern' der Einstellungen wird der Dialog nicht
      mehr verlassen. 'Laden' geht auch als Programm.
    - Die Wartezeit ist nun auch als Programm erlaubt.
    - Der Kontroll-Alert enthlt zustzlich einen Abbruch-Button, wichtig
      beim Snappen ins Clipboard.
    - Angabe der Auflsung in der IMG-Datei korrigiert.
    - Und viele andere Dinge. :-)
  --------
  16.10.93  v1.51, Reihenfolge der Farben kann nicht mehr gewhlt werden,
            denn BitIndex ist Standard.
  13.07.93  Bei der Kontrolle erscheint ein Alert.
  12.07.93  v1.5, Auf High und True Color erweitert. Nicht getestet!
  26.06.93  Bei whlbarer Flche erscheint das Gummiband jetzt auch in der
            Menzeile.
  25.06.93  Bei mehr als 256 Farben erscheint ein Alert.
  22.06.93  v1.41, Jetzt luft es auch mit MultiTOS und Memory protection.
  21.06.93  Nachdem der Fileselector verschwunden ist, wird noch eine halbe
            Sekunde fr Redraw gewartet.
  19.06.93  v1.4, Man kann die Einstellungen speichern.
  14.06.93  Die meisten Bilder werden jetzt krzer.
  10.06.93  v1.3, Zeitverzgertes Snappen eingebaut.
  30.05.93  v1.2, Reihenfolge der Farben wahlweise nach VDI oder Bitplanes.
  28.05.93  v1.1, Auflsung ist einstellbar; Kontrolle eingebaut.
  30.04.93  v1.03, Bei manchen Bildern Speichern ohne Ende.
  28.04.93  v1.02, Es funktioniert unter MultiTOS.
            Bestimmung des Fensters mit der Maus mglich.
  17.04.93  Packen der Grafik optimiert. Die Dateien werden jetzt etwas
            krzer.
  13.04.93  v1.01, jetzt geht auch Farbe. Speichern mit/ohne Palette.
  10.04.93  v1.0, erste ffentliche Version.
