Vorbemerkung
------------

Diese Anleitung kann auch vom Programm aus gelesen werden... dort etwas
bequemer als hier im Desktop.



'Get it' - was'n das?
---------------------

'Get it' ist zunchst ein Programm, das nur fr GFA-Basic-Programmierer
(oder die die es werden wollen) interessant ist.

Mit diesem Programm lassen sich aus Bilder in verschiedenen Formaten (DOO,
PAC, PI3) einzelne Blcke herausschneiden, die man dann spter in eigene
GFA-Programme einbinden kann. Diese Ausschnitte oder Blcke (Get's genannt)
kann man darberhinaus in einer Art Bibliothek sammeln bzw. verwalten.
Auch diese Blcke-Bibliothek (Bib genannt) kann in GFA-Prg. eingebunden
werden.

Die Idee zu 'Get it' kam mir, als ich in einem Programm nur einen bestimm-
ten Ausschnitt eines Bildes verwenden wollte. Um das durchzufhren gab es
eigentlich nur zwei Mglichkeiten: Entweder man ldt das Bild ein und
schaltet dann den Bildschirm schwarz (ltere Monitore geben dann dabei
unter Umstnden den Geist auf, Overscan-Monis sowieso) und schneidet dann
mit dem Befehl GET den gewnschten Ausschnitt aus (fr den Benutzer un-
sichtbar), oder aber man ldt das Bild in ein Grafik-Programm ein, 'ra-
diert' alles bis auf den gewnschten Ausschnitt weg und ldt dann dieses
Bild ins ein Programm ein. Probleme: In beiden Fllen hat man ein 32000
Byte-Bild (macht einen schlechten Eindruck) und die Umstndlichkeit der
zweiten Mglichkeit liegt auf der Hand.

Auf dem PD-Markt gab es einmal ein Programm Namens Seco. Mit diesem Pro-
gramm konnte man exakt das gleiche tun, wie mit 'Get it' - nur: Seco
lief nicht mit TOS 1.2, TOS 1.4 oder gar Kaos-TOS. Wenigstens lag dem
Ordner eine Routine bei, in der erklrt wurde, wie man die mit Seco er-
stellten Ausschnitte in ein GFA-Programm einbindet.

Das ntzte mir zwar nicht viel, aber wenigstens konnte ich so 'Get it'
bzw. die von 'Get it' erstellen Ausschnitte kompatibel zu denen von
Seco machen (was notwendig war, da ich zusammen mit der Seco-Diskette
eine Sammlung von 50 fertigen Ausschnitten bekam).

Seco habe ich nie gesehen, so da ich nicht beurteilen kann, inwiefern
'Get it' mit Seco vergleichbar ist. Sicher ist nur, da die Ausschnitte
vollkommen kompatibel sind (zumindest Seco-Files zu Get-it-Files).
Sollte jemand TOS 1.0 und Seco haben, wre ich ber ein paar Infos dankbar.



Der Ordner 'Get_it' und die Rechnerkonfiguration
------------------------------------------------

In dem Ordner GET_IT sollten sich folgende Files befinden:

- GET_IT.PRG  =  Das Programm
- GET_IT.RSC  =  Das RSC-File zum Programm
- BSP_01.GET  =  Beispiel-Get zum 1.
- BSP_02.GET  =  Beispiel-Get zum 2.
- BSP_03.GET  =  Beispiel-Get zum 3.
- BSP   .BIB  =  Eine Beispiel-Bibliothek
- LOADER.LST  =  GFA-Routine zum Einladen von Get's und Bib's
- ANLEIT.TXT  =  Dieses Textfile

Die Files GET_IT.PRG und GET_IT.RSC _mssen_ immer zusammen auf einer
Ebene und im gleichen Ordner liegen. Der Ordnername ist egal, ebenso
auch die Partition. Allerdings wre es sinnvoll, das Programm im
kompletten Ordner GET_IT weiterzugeben.

'Get it' luft auf allen ST's mit Monochrom-Monitor. Die Lauffhigkeit
auf einem TT konnte nicht getestet werden (mangels TT). Overscan drfte
wegen der verwendeteten Befehle SGET und SPUT nicht fuktionieren. 



Der Aufbau des Screens
----------------------

Nach erfolgreichem Starten sieht man auf dem Bildschirm ein Pulldown-Menue
und zwei geffnete Windows. Das linke, grere Fenster ist leer. Darin
werden spter die ausgeschnittenen Blcke (Get's) dargestellt. Im Fenster
auf der rechten Seite stehen zum einen die Adresse des Autors und die
Programmversion und darunter die sog. Statusangaben. D.h. man sieht auf
einen Blick, in welchem Zustand sich das Programm bzw. der Rechner befin-
det). Besonders Leute mit kleinem RAM-Speicher sollten die RAM-Angabe
im Auge behalten. 'Get it' luft auch mit 512 KB RAM, aber bei Erstellung
von Get-Bibliotheken kann es leicht zu Speicherplatzmangel kommen. Gleiches
gilt auch fr Leute mit einem MB und einer 500 KB RAM-Disk.



Das Pulldownmenue
-----------------

Menuepunkt Desk
---------------

Unter diesem Menuepunkt befindet sich auf jeden Fall der Untermenuepunkt
'Info'. Hier erfhrt man einige Angaben ber das Programm und die Adresse
des Autors (schon wieder...).

Ggf. findet man hier auch Accesorys. Allerdings mu ich zugeben, da es
besser ist, diese Accesorys nicht aufzurufen. Sie hinterlassen einen
zerstrten Screen (peinlich... aber bis zur nchste Version msste dieser
Bug drauen sein).



Menuepunkt File
---------------

Get-Datei laden
Eine Ausschnitt-Datei (Get-Datei) kann eingeladen werden. Das gerade
aktuelle Get wird ohne Rckfrage gelscht!

Get speichern
Der aktuelle Ausschnitt (Get) wird auf Diskette/Festplatte gespeichert.
Das aktuelle Get ist jeweils der Ausschnitt, den man in dem groen
Fenster sieht (ist da nichts, kann man auch nichts speichern...)

Bib-Datei laden
Eine Get-Bibliothek (d.h. eine Sammlung von mehrern Get's kann geladen
werden. Die aktuelle Bib (so nennen sich diese Get-Bibliotheken) wird
ohne Rckfrage gelscht.

Bib speichern
Die gerade aktuelle Bib wird auf Diskette/Festplatte gespeichert. Bei
groen Bib's und Disketten kann das einige Sekunden dauern.

Ordner anlegen
Es wird ein Ordner auf der aktuellen Partition angelegt.

Datei lschen
Es lt sich durch eine Fileselect-Box eine beliebige Datei lschen.

Programmende
Verlassen des Programms und Rckkehr zum Desktop.



Menuepunkt Work
---------------

Ausschnitt getten
Das geladene Bild wird dargestellt und man kann mit einem 'Lasso' einen
beliebigen Bildschirmausschnitt aus dem Bild schneiden (getten). Mit
dem ersten Mausklick wird die x/y Koordinaten festgelegt und man kann
dann durch bewegen der Maus das 'Lasso' (Quadrat) auseinanderziehen.
Durch einen weiteren Mausklick wird  die Gre des 'Lassos' festgelegt.
Das 'Lasso' lsst sich nun nur noch in seiner Gesamtgre verschieben.
Hat man den gewnschten Ausschnitt eingerahmt, dann einfach nur noch auf
die linke Maustaste drcken. Man kehrt dann zum Hauptbildschirm zurck und
sieht das neue Get in dem groen Fenster. Ein eventuelles vorheriges Get
wird ohne Rckfrage gelscht! 
Achtung: Ein Get darf maximal 400 Pixelpunkte breit und 340 Pixelpunkte
hoch sein! Anderenfalls kommt direkt nach dem Ausschneiden eine ent-
sprechende Meldung, die darauf hinweist, da das Get zu gro ist.

Get in Bib ablegen
Das aktuelle Get (sichtbar im linken Fenster) wird in die Bibliothek
abgelegt. Ist eine Bibliothek schon vorhanden, wird das aktuelle Get
angehngt. Ist noch keine Bibliothek (Bib) vorhanden, wird sie automatisch
angelegt. Ob eine Bib angelegt ist, ist im Status-Fenster ersichtlich.

Akt. Get drucken
Das aktuelle Get wird auf den Drucker ausgegeben. Dazu wird der Bildschirm
gelscht und das Get in die linke obere Ecke gesetzt und eine Hardcopy
durchgefhrt. Danach erscheint wieder der Hauptbildschirm. Eine eigene
Druck-Routine erschien mir nicht notwendig, da ich die Qualitt der TOS-
Hardcopy fr ausreichend halte.

Akt. Bib ansehen
Es werden die Get's (also die Objekte), die sich in der akt. Bibliothek
befinden, in dem linken Fenster dargestellt. Auf der rechten Seite er-
scheint ein kleines zustzliches Fenster, in dem die Objektnummer steht.
Mit Druck auf die rechte Maustaste wird das nchste Get in der Bib dar-
gestellt, mit der linken Maustaste das vorhergehende. Durch drcken der
beiden Maustatsten gleichzeitig wird diese Funktion wieder verlassen.

Akt. Bib lschen
Alle Objekte in der Bibliothek werden gescht.

Obj. als Get speichern
Es lt sich ein Objekt aus der akt. Bibliothek als Get-Datei abspeichern.
Fr das Programm ist die Nummer des Objektes interessant, die das Objekt
in der Bibliothek hat. Vor dem Speichern mu man also mit 'Akt. Bib an-
sehen' erst die Nummer des Objektes auskundschaften.



Menuepunkt Pictures
-------------------

Bild laden
Es erscheint eine Fileselect-Box in der man eine Bild-Datei seiner Wahl
einladen kann. Nach dem Laden wird das Bild auf dem Bildschirm dar-
gestellt. Mit Maus- oder Tastendruck kommt man wieder zum Hauptscreen.

Bild anzeigen
Das Bild wird auf dem Bildschirm ausgegeben. Durch Maus- oder Tastendruck
kommt man wieder zum Hauptscreen zurck.

Bildformat bestimmen
Hier kann eingestellt werden, in welchem Format das einzuladende Bild
vorliegt. In der derzeitigen Version kann man zwischen DOO, PAC und PI3
whlen. 'DOO' steht fr Doodle-Format - das ist das normale Screenformat,
also Bilder mit einer Gre von 32000 Bytes. 'PAC' ist das von STad ver-
wendete Format. Diese Bilder haben den Vorteil, da sie bereits kompri-
miert sind. 'PI3' schlielich sind Degas-Bilder (hohe Auflsung!).
Degas-Bilder haben eine Lnge von 32034 Bytes.



Menuepunkt Anleitung
--------------------

Anleitung lesen
Man wechselt in den Programmteil Anleitung. Die Steuerung der Anleitung
ist sowohl durch Tasten, als auch durch die Maus mglich.

Anleitung drucken
Die Anleitung wird ausgedruckt.



Das Status-Fenster
------------------

'Bild geladen: ' - Bild vorhanden=ja, kein Bild vorhanden=nein
'Bildformat:   ' - das eingestellte Bildformat (DOO,PAC,PI3)
'Auflsung:    ' - aktuelle Bildschirmauflsung (derzeit nur Hires)
'Bib angelegt: ' - Bibliothek vorhanden=ja, keine Bib=nein
'Gets in Bib   ' - Anzahl der Gets in der akt. Bib
'RAM-Speicher: ' - freier RAM-Speicher (in Bytes)
'D/F (KB):     ' - freier Speicher auf Diskette oder Festplatte (in KB)
'Drucker:      ' - Drucker online=ja, Drucker offline=nein



Einbinden der Get's und Bib's in eigene Programme
-------------------------------------------------

Die mit 'Get it' erstellen Get's bzw. die Get-Bibliotheken (Bib's) knnen
durch zwei Routinen in eigene Programme eingebunden werden. Die beiden
dokumentierten Routinen sind die gleichen, die Seco beilagen. Durch
die Kompatibilitt der Get_it-Files und Seco-Files konnte ich diese
Routinen bernehmen. Die Routinen solltem diesem Ordner beiliegen. Sie
knnen einfach mit MERGE in eigene Programme bernommen werden.

Falls es beim Einladen Probleme gibt (sehr unwahrscheinlich), dann soll
man sich am Besten an mich wenden. Ich helfe gerne weiter.



Fertige Get's
-------------

Da das Programm ohne Bilder nichts ntzt, mchte ich darauf aufmerksam
machen, da bei mir ca. 50 MB an Bildern (Format grtenteils PAC) herum-
liegen und da man diese Bilder ohne weiteres haben kann. NEIN, jetzt
kommt nicht die Sache mit '...und das alles fr xy DM'. Falls jemand
Interesse an dem einen oder anderen Bild (oder allen) hat, kann er sie
kostenlos bekommen - lediglich die Unkosten fr Diskette und Porto fallen
an (ungefhr 1.90 DM pro Disc). Also, falls in diese Richtung Interesse
besteht, einfach schreiben oder anrufen.

Als Beispiele liegen dem Ordner zwei Beispiel Get's und eine Beispiel
Bibliothek bei - zumindest taten sie das beim Verschicken des Programms.



Die 10-DM-Frage
---------------

Die bliche Anfrage wegen eines 10-DM-Scheines schenke ich mir hier, da
es zum einen sowieso nicht funktioniert, zum anderen aber in dem Pro-
gramm nicht soviel Arbeit steckt, als da man dafr bezahlen msste
(was nicht heien soll, da ich keine Arbeit hatte).

Wenn aber jemand mit Hilfe von 'Get it' eigene Programme gestaltet, so
wrde es mich freuen, wenn derjenige mir eine Version des Programms
zuschicken wrde.



Fragen, Vorschlge, Kritik
--------------------------

Falls es Fragen zum Programm gibt, jemand Verbesserungsvorschlge hat oder
man mich mit Kritik zuschtten mchte, dann wende man sich bitte an die
im Programm angegebene Adresse oder rufe an - die Adresse sicherheitshalber
hier nochmal:

Michael Vondung
Haardtstrae 8a
6717 Heheim

Tel.: 06233-70135


(Diese Anleitung wird vom Programm nicht bentigt, sie kann also, um
Speicherplatz zu sparen, gelscht werden. Eine Anleitung ist auch im
Programm selbst eingebaut.




