• Clipping
• Definieren eines Füllmuster
• variable Zeichengröße
• weitere Mausroutinen

Clipping

Bei intensiver Nutzung der GEM-Routinen kann es schon manchmal zu unangenehmen Begleiterscheinungen kommen, einfach gesagt, zu einem Programmabsturz. Sei es durch nicht initialisierte AES-Befehle oder durch falsche Parameter bei der Bildschirmausgabe. Gegen die zweite Ursache, die auftritt, wenn Ausgabebefehle einen Bereich weit außerhalb des Bildschirms ansprechen, existiert eine Routine, die die ßildschirmausgabe auf einen bestimmten Bereich beschränkt. Dadurch werden alle illegalen Bildschirmkoordinaten eliminiert. Natürlich kann auch ein kleiner Ausschnitt gewählt werden. Die darauffolgenden GEM-Grafikbefehle finden dann nur innerhalb des definierten Bereiches statt. Die Größe des Ausschnittes wird in diesem Unterprogramm in den Variablen ’XPOSl; YPOS1; XPOS2; YPOS2’ angegeben. Diese Routine arbeitet nur mit den GEM-Routinen zusammen, bei Basic-Ausgabebefehlen wird das Clipping nicht beachtet, bzw. sogar ausgeschaltet, so daß nachfolgende GEM-Ausgaberoutinen den gesamten Bildschirm ansprechen. Das angegebene Beispiel demonstriert die Funktionsweise dieses Befehls. Prinzipieller Aufruf:

Diese Routine erspart beispielsweise bei Kurvendiskussionen die ständige Abfrage, ob die errechneten Werte außerhalb des erlaubten Bereiches liegen, und erleichtern bzw. beschleunigen die Berechnung.

Routine CLIPPING

Definieren des Füllmusters

Trotz der vielen vorgegebenen Füllmuster soll dennoch auf die Möglichkeit zum freien Definieren des Musters hingewiesen werden. Bei dem Füllmuster handelt es sich um ein 16^ 16 Bit großes Muster, das bei allen ausfüllenden Grafikoperationen zur Geltung kommt. Dazu gehören neben den Basic-Befehlen ’PCIRCLE; PELLIPSE; FILL’ auch die schon zuvor besprochenen GEM-Routinen ’RECHTECK’, ’RECHTECKRUND’ und 'POLYGON’.

Die Werte des Füllmusters, bestehend aus 16 Worten (2 Byte), werden hierbei in Data-Zeilen abgelegt und mit dem dazugehörenden Namen versehen. Die Definition des neuen Musters geschieht durch:

Die Aktivierung dieses Musters wird durch ’COLOR 1,1,1,1,4 vorgenommen.

Routine FÜLLMUSTER

Listing 2: Definition eines Füllmusters

Zeichenhöhe

Zwei der interessantesten GEM-Routinen sind laut Leserzuschriften — die zum Verändern der Schriftart und der Schriftgröße, welche schon im ersten Teil des Kurses besprochen wurden. Eine weitere Routine erlaubt auf dem Monochrommonitor die Größendefinition des Zeichensatzes in 24 Stufen (siehe Bild). Die Routine arbeitet mit allen Schriftarten zusammen (kursiv, ...). Alle Schriftarten, die von der Normalgröße abweichen, können nicht per ’PRINT’ ausgegeben werden, da dieser Befehl nur auf Standardgröße ausgelegt ist. Hierzu dient die GEM-Ausgaberoutine.

Der Aufruf erfolgt durch:

Bei monochromem Monitor beträgt der Parameter der normalen Schrifthöhe ’12’, bei einem Farbmonitor hingegen, auf Grund der niedrigeren Vertikalauflösung, ’6’. Die unterschiedlichen Auflösungsstufen eines Farbmonitors sind auch dafür verantwortlich, daß die entstehenden Schriftgrößen nicht denen eines Monochrommonitors entsprechen, sondern grundsätzlich größer sind.

Listing 3: Einstellen der Zeichenhöhe

Routine ZEICHENHÖHE

Entsprechendes gilt für die Routine 'Schriftgröße’ die schon im ersten Teil erwähnt wurde. Der Unterschied zwischen diesen zwei Routinen besteht in der Schrittweite, in der die verschiedenen Größen angegeben werden können.

'Schriftgroesse' läßt nur sechs Größenstufen zu, während ’Schrifthöhe’ durch Bildung von Zwischenstufen eine fast kontinuierliche Größe ermöglicht, bei denen einige allerdings etwas unsauber abgebildet werden. Für bestimmte Anwendungen ist es aber sicher von Vorteil, eine passende Schrift auszuwählen. Bei mittlerer oder niedriger Auflösungsstufe (Farbe) stehen die kleinsten Größen nicht zur Verfügung.

Rahmung

Normalerweise werden alle Grafikoperationen, die ein Füllmuster beinhalten, mit einer Linie umrahmt. Mit der folgenden Routine kann dieser Effekt ausgeschaltet werden.

Bei Aneinanderreihung von Füllkörpern entsteht so eine geschlossene Fläche.

Die Funktion arbeitet mit folgenden Basic- bzw. GEM-Befehlen zusammen:

• pcircle

• pellipse

• rechteck

• rechteckrund

• polygon

  64250 UMRAHMUNG: 64252 '--> RAHMEN (0,1) 64254 POKE contrl,104 64256 poke intin,rahmen 64258 vdisys 64260 return 64262 ’---------------

Routine UMRAHMUNG

Listing 4: Umrahmung ein/aus

Mausbefehle

Das AES bietet auch einige interessante Befehle, die von der Maus unterstützt werden. Neben der auch im VDI enthaltenen 'Position & Tastenabfrage’, existiert eine Routine, die kontrolliert, ob sich die Maus in einem bestimmten Rechteck befindet, und eine weitere, die das Markieren von Bildschirmbereichen ermöglicht.

Dabei ist zu beachten, das AES-Routinen einer Initialisierung durch ’INIT’ bedürfen.

MOUSE

Diese Routine enthält die gleichen Funktionen wie die VDI-Routine zur Mausabfrage. Mit ihr kann die Position der Maus und die Information über die Maustasten ermittelt werden. Zusätzlich gibt sie noch den Status der 'CONTROL, ALTERNATE’ und den beiden 'SHIFT’-Tasten zurück.

Der Aufruf erfolgt durch:

Die Informationen über Mausposition, Maustasten und der Tastatur sind anschließend in den Variablen MAUSX, MAUSY, TASTE und KEY enthalten. Die erhaltenen Werte sind folgendermaßen zu interpretieren.

TASTE:

KEY:

Listing 5: Abfrage der Mausposition

Mausereignis

Diese Routine kontrolliert die Anwesenheit des Maussymbols in einem bestimmten, vordefinierten Rechteck. Der Anfangspunkt wird in XPOS und YPOS übergeben und legt die linke obere Ecke fest, die Variablen BREIT und HOCH bestimmen die horizontale und vertikale Ausdehnung des Bildschirmausschnittes, auf den die Routine reagiert. Dazu existieren zwei verschiedene Modi. Entweder wartet die Routine, bis die Maus den Bildschirmausschnitt betritt oder, bis sie ihn verläßt. Dies wird in Speicherzelle ’GINTIN’ festgelegt, wobei eine Null bewirkt, daß die Routine wartet, bis die Maus in den Bereich eintritt, eine Eins entsprechend das Gegenteil. Der Aufruf erfolgt durch:

Routine EVENTMAUS

Listing 6: Warten auf Mausereignis

Routine RECHTECK Routinen SHOWMAUS / HIDEMAUS

Definieren eines Rechteckes

Routine RUBBERBOX

Listing 7: Rechteckdefinition mit Maus

Rubberbox

Zwei weitere, nützliche Routinen dienen zum Festlegen eines Rechtecks mit der Maus. Die erste erzeugt ein Rechteck, dessen eine Ecke fixiert ist, wobei die andere, bei gedrückter Maustaste, der Mausbewegung folgt.

Die linke obere Ecke wird durch Anklicken mit der Maus bestimmt. Daraufhin entsteht ein gestricheltes Rechteck, das den Bewegungen der Maus folgt. Dabei muß die linke Maustaste gedrückt bleiben.

Sobald sie losgelassen wird, gibt die Routine die Breite und Höhe des momentan markierten Rechtecks zurück.

Der Aufruf erfolgt durch:

Bevor diese Routine angesprochen wird, sollte mit Hilfe des ’MOUSE’-Unterprogrammes abgefragt werden, ob die linke Maustaste gedrückt wurde, um den Startpunkt des Rechtecks an die betreffende Stelle zu legen. ’RUBBERBOX’ entnimmt dann den Startpunkt aus den von der MOUSE-Routine stammenden Variablen MAUSX und MAUSY.

Drag box

Diese Routine dient zum Verschieben eines Rechtecks. Die Größe des zu verschiebenden Rechtecks wird dabei vorgegeben (BREIT,HOCH). Es ist zweckmäßig, die Anfangskoordinaten mittels der MOUSE-Routine festzulegen, damit der Anfangspunkt des Rechtecks auch der Mausposition entspricht. Die Routine ist deshalb darauf ausgelegt, daß sie den Anfangspunkt den Variablen MAUSX und MAUSY entnimmt. Weiterhin ist diese Routine in der Lage, einen Bereich zu kennzeichnen, den dieses Rechteck nicht verlassen kann. Definiert wird er in X.MIN, Y.MIN und X.MAX, YMAX.

Aufruf durch

Die Routine gibt in den Variablen XPOS1 und YPOS1 die neue Lage des Rechtecks an das Hauptprogramm zurück.

Bei dem Beispielprogramm hierzu kommen neben der Rechteckroutine zwei weitere VDI-Routinen zur Geltung. Sie sorgen dafür, daß die Maus bei gegebener Zeit sichtbar bzw. unsichtbar wird, da sonst das Rechteck an dem Punkt, wo es mit der Maus überlappt, gelöscht würde. Um das zu verhindern, wird vor Aufruf einer GEM-Ausgaberoutine, die Maus mittels ’Gosub HIDEMAUS’ aus- und anschließend durch ’Gosub SHOWMAUS’ wieder eingeschaltet.

Aus diesem Beispiel wird ersichtlich, daß gerade durch Kombination der einzelnen GEM-Routinen die besten Ergebnisse erzielt werden. Auch die hier angeführten Demoprogramme demonstrieren lediglich die prinzipielle Arbeitsweise der einzelnen Routinen, die sicherlich in fast allen Programmen ihre Anwendung finden und Ihnen helfen, den ATARI ST ein wenig mehr auszureizen.

Zur umfangreichen GEM Nutzung ist aber trotzdem die Verwendung einer anderen Programmiersprache (C, Pascal) sehr empfehlenswert bzw. unbedingt anzuraten, da einerseits nicht alle Routinen im Basic ansprechbar sind und andererseits die Handhabung wesentlich bequemer ist, nicht zuletzt auch wegen des Geschwindigkeitsgewinns einer Compilersprache. So mag sich mancher C-Programmierer sicher gewundert haben, wieso man die GEM-Routinen, die in C ohne Kompromisse aufrufbar sind, in einer Sprache anwendet, die für solche Anwendungen weniger geeignet ist. Den Basic-Pro-grammierern aber hoffen wir, eine Hilfe für die ausgedehntere Nutzung ihres Rechners gegeben zu haben, und nicht zuletzt einen Anreiz auf die GEM-Programmierung in C oder Pascal.

★ Ende des Kurses ★

Routine DRAGBOX

Listing 8: Rechteckverschieben mit Maus