Markt&fTechnik mierer Datenstrukturen: odula-2-Format. $ auch für Basic- er-Programmierer. Amiga Datenstrukturen-Lexikon Paul Lukowicz Olaf Pfeiffer Das Nachschlagewerk für alle Programmierer Auflistung aller System-Datenstrukturen: Offsets, C-Format, Modula-Format. Wichtige Tips auch für Basic- und Assembler- Programmierer. CIP-Titelaufnahme der Deutschen Bibliothek Lukowicz, Paul: Amiga-Datenstrukturen-Lexikon : das Nachschlagewerk für alle Programmierer ; Auflistung aller System-Datenstrukturen: Offsets, C-Format, Modula-Format ; wichtige Tips auch für Basic- und Assembler-Programmierer / Paul Lukowicz ; Olaf Pfeiffer. — Haar bei München : Markt-u.-Technik-Verl., 1990 ISBN 3-89090-250-2 NE: Pfeiffer, Olaf Die Informationen in diesem Produkt werden ohne Rücksicht auf einen eventuellen Patentschutz veröffentlicht. Warennamen werden ohne Gewährleistung der freien Verwendbarkeit benutzt. Bei der Zusammenstellung von Texten und Abbildungen wurde mit größter Sorgfalt vorgegangen. Trotzdem können Fehler nicht vollständig ausgeschlossen werden. Verlag, Herausgeber und Autoren können für fehlerhafte Angaben und deren Folgen weder eine juristische Verantwortung noch irgendeine Haftung übernehmen. Für Verbesserungsvorschläge und Hinweise auf Fehler sind Verlag und Herausgeber dankbar. Alle Rechte vorbehalten, auch die der fotomechanischen Wiedergabe und der Speicherung in elektronischen Medien. Die gewerbliche Nutzung der in diesem Produkt gezeigten Modelle und Arbeiten ist nicht zulässig. »Commodore-Amiga« ist eine Produktbezeichnung der Commodore Büromaschinen GmbH, Frankfurt, die ebenso wie der Name »Commodore« Schutzrechte genießt. Der Gebrauch bzw. die Verwendung bedarf der Erlaubnis der Schutzrechtsinhaberin Amiga ist eine Produktbezeichnung der Commodore-Amiga Inc., USA Microsoft-C ist ein eingetragenes Warenzeichen der Microsoft Corporation, USA Lattice-C ist ein eingetragenes Warenzeichen der Lattice Corporation, USA Amiga-BASIC ist ein eingetragenes Warenzeichen der Microsoft Inc., USA M2.Amiga ist ein eingetragenes Warenzeichen der Firma Meier-Vogt, CH Modula-2/Amiga ist ein eingetragenes Warenzeichen der TDI Software Inc., Dallas, USA 15 14 3 222171098 765 4 3 2 |] 3 2 9 90 ISBN 3-89090-250-2 © 1990 by Markt& Technik Verlag Aktiengesellschaft, Hans-Pinsel-Straße 2, D-8013 Haar bei München/West-Germany Alle Rechte vorbehalten Einbandgestaltung: Grafikdesign Heinz Rauner Dieses Produkt wurde mit Desktop-Publishing-Programmen erstellt und auf der Linotronic 300 belichtet. Druck: Pustet, Regensburg Printed in Germany Kapitel 1 Kapitel 2 2.1 2.2 2.3 2.4 Kapitel 3 3.1 3.2 Kapitel 4 4.1 4.2 Kapitel 5 5.1 5.2 Kapitel 6 6.1 6.2 6.3 6.4 Kapitel 7 Fl 1-2 1.3 1.4 75 INHALTSVERZEICHNIS Vorwort Einleitung Hinweise zur Benutzung der Datenstrukturen Hinweise für C-Programmierer Hinweise für Modula-2-Programmierer Hinweise für Assembler-Programmierer Hinweise für Basic-Programmierer Die Exec-Library Wichtige Flags der Exec-Library Die Datenstrukturen der Exec-Library Die Intuition-Library Wichtige Flags der Intuition-Library Die Datenstrukturen der Intuition-Library Die Graphics-Library Wichtige Flags der Graphics-Library Die Datenstrukturen der Graphics-Library Die DOS-Library Spezielle Datentypen der DOS-Library Fehlermeldungen der DOS-Library Die DOS-Packets Die Datenstrukturen der DOS-Library Sonstige Libraries Die Diskfont-Library Die Expansion-Library Die Hardware-Library Die Resources-Library Die Workbench-Library 11 13 17 21 25 25 26 61 61 69 131 131 134 191 191 191 193 197 223 223 227 235 268 271 Kapitel 8 8.1 8.2 8.3 ANHANG Die Devices Das Audio-Device Das Clipboard-Device Das Console-Device Das Gameport-Device Das Input-Device Das Keyboard-Device Das Narrator-Device Das Parallel-Device Das Printer-Device Das Serial-Device Das Timer-Device Das TrackDisk-Device Andere Datenstrukturen der Devices Glossar Literaturverzeichnis A B C Abbildungsverzeichnis D Quick-Reference E Alphabetisches Verzeichnis der Datenstrukturen Stichwortverzeichnis 279 279 283 286 289 292 294 295 299 303 310 315 317 323 353 361 363 365 389 391 VORWORT Mit diesem Buch halten Sie kein »Lesebuch« im eigentlichen Sinn in den Händen. Vielmehr möchten wir es als ein Nachschlagewerk verstanden wissen, das immer in greifbarer Nähe zum Amiga stehen muß. Wer viel auf dem Amiga programmiert und dabei seine Möglichkeiten einigermaßen effizient ausnutzen will, Kommt um eine häufige Benutzung der Systemdatenstrukturen nicht herum. Bisher galt es hier Berge von Büchern zu wälzen, um im Endeffekt dann doch auf altbewährte Hackermethoden zurückzugreifen. Insbesondere dabei unterzog das sensitive Multitasking-System des Amiga die drei Reset-Tasten einem Dauerhärtetest! Da der Zuliefermarkt für Reset-Tasten schon seit langem überlastet ist, schrieben wir in weiser Vorraussicht dieses Buch. Uns schwebte von Anfang an ein Werk vor, das geballte und umfassende Informationen zur Anwendung der Systemdatenstrukturen in allen gängigen Programmiersprachen (»C«, Modula-2, Assembler und Basic) enthält. Natürlich gehört dazu mehr als eine reine Auflistung der Datenstrukturen und ihrer Komponenten. Denn die wahre Funktion und Bedeutung einer Datenstruktur wird meist nur anhand ihrer Stellung im Gesamtsystem verständlich. Darüber hinaus existieren noch eine Fülle von Konstanten, Flaggen und Befehlen, die man beim Umgang mit Datenstrukturen kennen muß. Unser Buch läßt hier kaum Fragen offen! Das größte Problem bei der Beschreibung der einzelnen Datenstrukturen bestand darin, Nützliches von Überflüssigem zu trennen. Wir hoffen nun, daß die unserer eigenen Programmiererfahrung entspringen- de Auswahl auch Sie überzeugt und den Guru von Ihnen fernhält. Abschließend danken wir dem »ungenannten Dritten«, der bei der Erstellung dieses Buches »ernsthaft« mitgemischt hat! Paul Lukowicz und Olaf Pfeiffer, im Januar 1990 EINLEITUNG Voraussetzung für das Einsetzen des »Stoffes« auf den folgenden Seiten ist, daß Sie ein Amiga- Programmierer sind, der nicht nur an der »Programmier-Oberfläche« kratzt und sich mit dem Durch- schnittlichen zufrieden gibt. Gehören Sie also zu denjenigen, die bestrebt sind, ihren Amiga auszureizen, dann dürften Ihnen ja auch die verwendeten drei großen »A« (Anglo-Amerikanischen Amigazismen) keine Probleme bereiten. Je weiter man in die Tiefen des Amiga vordringt, desto schwieriger wird es, diese zu umgehen, da sämtliche Definitionen und Kürzel (wie sollte es anders sein?) aus englischen Begriffen abgeleitet sind. Würde man versuchen, alles zu übersetzen, so käme man sehr schnell an den Punkt, wo nur noch Übersetzungen wie »Ursprungsebenen-Insektenvernichtungsmittel« (Source Level Debugger) möglich sind. Auf solche verzichten wir daher lieber gleich und halten uns da, wo wir es für verständlicher halten, an die entsprechenden »AA A«s. Stoßen Sie dennoch auf einen Begriff, der Ihnen nichts sagt, so schlagen Sie im Glossar nach. Rein theoretisch sollten dort alle »AA A«s (abgesehen von Begriffen wie Screen und Window) kurz erläutert sein. Bei der Fülle der Datenstrukturen des Betriebssystems ist es nicht möglich, die Funktion aller Felder einer jeden Datenstruktur durch Ausprobieren »herauszuhacken«. Daher konnten wir uns bei der Beschreibung nicht nur auf unsere Amiga-Programmiererfahrung verlassen, sondern mußten auch anderen Quellen (siehe Literaturverzeichnis) blind vertrauen. Obwohl wir vorwiegend die Original-Commodore-Referen- ce-Manuals sowie dokumentierte Listings verwendet haben, ist nicht auszuschließen, daß wir dabei eventuell vorhandene Fehler übernommen haben. An manchen Stellen, wo weder eine Beschreibung noch ein Kommentar in den Source-Codes aufzutreiben war, waren wir auf Vermutungen angewiesen, die dem Komponentennamen und/oder unserem Systemverständnis entsprangen. Dabei handelt es sich in erster Linie um »extrem« systeminterne Parameter, die für den Programmierer so gut wie bedeutungs- los sind. Stoßen Sie also in diesem Buch auf Begriffe wie »vermutlich«, »könnte« oder »hat wahrschein- lich mit ... zu tun«, dann ist dies nur als ein Hinweis und nicht als Tatsache zu betrachten. Wo nicht einmal Vermutungen möglich waren, haben wir als Zeichen unserer Ratlosigkeit drei Fragezeichen gesetzt. Für lehrreiche Hin- und Beweise sind wir jederzeit dankbar. Nun noch ein paar Worte zum Aufbau dieses Buches: Die Datenstrukturen sind nach Libraries und Devices in Kapitel zusammengefaßt und innerhalb dieser alphabetisch geordnet. Die Beschreibung einer Datenstruktur hat immer den gleichen Aufbau. Zunächst erfolgt jeweils eine komplette Auflistung der Datenstruktur. Von links nach rechts finden Sie dabei hintereinander den hexadezimalen und dezimalen Offset, das C-Format und abschließend das Modula-2-Format einer jeden Komponente der Datenstruk- tur. In der Kopfleiste steht zusätzlich hinter dem »C« das Include-File, in dem diese Datenstruktur definiert ist, und hinter Modula-2 der Name des Moduls, aus dem Modula-2-Programmierer diese Datenstruktur importieren können. Weicht das Assembler-Format der Datenstruktur in irgendeiner Form von der C-Version ab, so stehen diese Abweichungen direkt unter der Datenstruktur näher beschrieben. Vor der Beschreibung folgen noch die Referenzlisten. Aus der Datenstrukturenreferenz können Sie ersehen, welche Datenstrukturen diese Datenstruktur entweder selbst oder zumindest einen Adreßzeiger auf diese enthalten. Aus der Routinenreferenz können Sie erkennen, welche Systemroutinen auf diese zugreifen, wobei diese Listen natürlich keinen Anspruch auf Vollständigkeit erheben. Nach der Beschrei- bung der Datenstruktur als Gesamtes folgt eine nochmalige Auflistung aller Parameter im C-Format mit Angabe der Offsets und einer ausführlichen Beschreibung. Dabei versuchen wir, alle vordefinierten Konstanten und deren Bedeutung anzugeben. Falls die Bedeutung einer Komponente von dem Werteiner anderen abhängt (z.B. bei den Device-Befehlen), haben wir grundsätzlich alle Möglichkeiten angegeben. Nehmen wir in der Beschreibung Bezug auf andere Komponenten, so geschieht dies ebenfalls im »C«- Format. Modula-2-Programmierer können »Ihre« Syntax der Komponente aus der Auflistung der Datenstruktur entnehmen. Maßeinheiten gibt es eigentlich nur zwei, nämlich Pixel (oder Punkte) für Grö- ßenbeschreibungen am Bildschirm und Bytes für Speicherbereichangaben. Da die Datenstrukturen der Hardware-Library sich weitgehend auf Hardwareregister beziehen, haben wir auch diese ausführlich beschrieben. Somit beinhaltet dieses Buch zusätzlich eine recht genaue Hard- warebeschreibung. HINWEISE ZUR BENUTZUNG DER DATENSTRUKTUREN Um auf sprachspezifische Probleme genügend einzugehen, folgen nun vier Abschnitte, in denen auf Besonderheiten der Sprachen C, Modula-2, Assembler und Basic gesondert hingewiesen wird. Um Ihnen einen direkten Vergleich zu ermöglichen, haben wir ein kurzes Beispielprogramm geschrieben und es an alle vier Programmiersprachen angepaßt. Das Programm »HalbHellDemo« soll folgendes tun: 1. Öffnen eines Bildschirms im Extra-Halfbright-Modus (64 Farben). 2. Öffnen eines Fensters auf diesem Bildschirm. Dieses Fenster soll die untere Bildschirmhälfte einnehmen und nur über ein Close-Gadget verfügen (es kann also nicht verkleinert, vergrößert oder verschoben werden). 3. Zeichnen von 62 Rechtecken, wobei 31 Rechtecke im Fenster mit den Farben 1 bis 31 und 31 Rechtecke auf dem Bildschirm mit den Farben 33 bis 63 gezeichnet werden sollen (die Farbregister werden dabei nicht mit Werten belegt, es werden die Default-Farben verwendet). 4. Warten auf das Anklicken des Close-Gadgets. 5. Schließen des Fensters und des Bildschirms. Wie Sie wissen, wird zum Zeichnen die RastPort-Datenstruktur des Displayelementes benötigt, in dem gezeichnet werden soll. Das Programm »HalbHellDemo« ist insofern interessant, als der zum Bildschirm gehörige Rastport in der Screen-Datenstruktur eingebunden, also selbst enthalten ist. Die zum Fenster gehörende Rastport-Datenstruktur ist dagegen nicht in der Window-Datenstruktur eingebunden. In ihr steht nur ein Adreßzeiger auf die beim Zeichnen verwendete RastPort-Datenstruktur. Die verschiedenen Versionen von »HalbHellDemo« finden Sie in den folgenden vier Abschnitten. 2.1 Hinweise für C-Programmierer Da fast das gesamte Amiga-Betriebssystem in C geschrieben ist, bereitet die Anwendung der Systemda- tenstrukturen in dieser Sprache keine Schwierigkeiten. Die hier aufgelisteten Datenstrukturen entstam- men den Include-Files des Aztec-C-Compilers, sie unterscheiden sich aber nicht von den Original- Include-Files von Commodore. Falls Sie einen anderen Compiler benutzen (z.B. Lattice-C oder einen der PD-Compiler), kann es also höchstens vereinzelt Probleme mit dem Aufbau der Include-Directory geben. Sie müssen sich dann der Anleitung Ihrers Compilers bedienen, um die gesuchte Datenstruktur zu finden. Bei den meisten Flags können neben der von uns aufgelisteten Wertkonstanten auch noch die Bitnummer- konstanten verwendet werden. Der Name dieser Bitnummerkonstanten folgt aus dem Namen der entsprechenden Wertkonstanten durch Einsetzen eines »B« am Ende des Präfix (vor dem ersten Underbar »_«). Falls dort schon ein »F« (für Flag) steht, muß dieses gelöscht werden. /* Programm HalbHellDemo */ #include”intuition/intuition.h” #include”graphics/gfxbase.h” #include”graphics/view.h” struct IntuitionBase *IntuitionBase; struct GfxBase *GfxBase; struct Screen *OurScreen; struct Window *OurWindow; struct RastPort ?SerRPort, WinkPort: struct NewScreen OurNewScreen = { Da, 0% 320,256; 6; I EXTRA_HALFBRITE, CUSTOMSCREEN, NULL, “Extra-Halfbrite: Die Farben 32 - 63”, NULL, NULL 1b struct NewWindow OurNewWindow = { 0, 120; 3205230; Os. Al: CLOSEWINDONW, WINDOWCLOSE|SIMPLE_REFRESH, NULL, NULL, “Die Farben 0 - 31 im Fenster”, NULL, NULL, 050, 32052806; CUSTOMSCREEN main () { NE RL. RK VL, 92, farbe; /* Graphies-Library. öffnen */ GfxBase = if (GfxBase == NULL) exit(FALSE); /* Intvition-Library Sfrfnen *%/ IntuitionBase = if (GfxBase == NULL) exit(FALSE); J|* /* /* |* /* /* J*# /* IF /* /* /* IF /* /* /* /I* /* /* [* /* /* Benötigte Include-Files */ Verwendete Datenstrukturen */ NewScreen-Struktur anlegen */ LeftEdge, TopEdge */ Width, Height */ Depth */ DetailPen, BlockPen */ ViewModes */ ScreenFlags */ Font */ Title */ Gadgets, CustomBitmap */ NewWindow-Struktur anlegen */ LeftEdge, TopEdge */ Width, Height */ DetailPen, BlockPen */ IDCMPFlags */ WindowFlags */ FirstGadget, Checkmark*/ Title */ Screen, BitMap */ Min-, MinHeigth, Max-, MaxHeight */ Type */ (struct GfxBase *) OpenLibrary(“graphics.library”,0); (struct IntuitionBase *) OpenLibrary(“intuition.library”,0); /* Screen Öffnen */ QurScreen =. (struct Screen *) OpenScreen(&0urNewScreen); if (OurScreen == NULL) EXTITLFAÄLSEIS OurNewWindow.Screen = QurScreen; /* Adreßzeiger auf Screen holen */ /* Window Öffnen */ OurWindow = (struct Window *) OpenWindow(&0urNewWindow); if (OurWindow == NULL) EXIECFALSE): SerRPort = Aldurscreen->RastPrort); 7* RastPport ist. in Screen-Struktur ein- gebunden, also Adresse berechnen. */ WinRPort = OurWindow->RPort; /* Window-Struktur enthält Zeiger auf RastPort, also Adresse kopieren. */ farbe = 0; xıl= 5; yl= 15; /* Startwerte für Rechtecke festlegen */ x2 = 55; y2 = 55 do /* Zeichenschleife (alle Farben) */ Xbr=7 5 2y14F2,X227 8 252, SetAPen(WinRPort,++tfarbe); /* Zeichenfarbe für Fenster setzen */ RectFill(WinRPort,x1,yl,x2,y2); /* Rechteck im Fenster zeichnen */ SetAPen(ScrRPort,farbet32); /* Zeichenfarbe für Screen setzen */ RectFilllSerRPört,.x1,;41,X2,Y2); /* Rechteck im Screen zeichnen */ } while (farbe < 31); /* alle Farben durch ? */ WaitPort(OurWindow->UserPort); /* Auf Close-Gadget warten */ CloseWindow(OurWindow); /* Fenster schließen */ CloseScreen(OurScreen); /* Screen schließen */ CloseLibrary(GfxBase); /* Libraries schließen */ CloseLibrary(IntuitionBase); 2.2 Hinweise für Modula-2-Programmierer Die in diesem Buch vorhandenen Auflistungen der Datenstrukturen im Modula-2-Format entsprechen dem, das der M2Amiga-Compiler Version 3.3d der AtL AG verwendet. Eine Besonderheit dieses Compilers besteht in der Handhabung der Libraries. Normalerweise ist ein Zugriff auf eine Library, abgesehen von der Exec-Library, nur möglich, wenn diese zuvor durch die Routine OpenLibrary der Exec-Library geöffnet wurde. Nach Beendigung aller Zugriffe erfolgt dann eine Schließung der Library durch die CloseLibrary-Routine. Der M2 Amiga-Compiler nimmt uns diese Arbeit ab, da er durch die IMPORT-Listen nicht nur erkennt, welche Libraries geöffnet werden müssen, sondern das Öffnen und Schließen auch selbst übernimmt. An dieser Stelle sei auch gesagt, daß wir bei dem Adreßzeiger NULL nicht jedesmal das Modula-2-Format (NIL) dazuschreiben. Falls Sie es also noch nicht wissen sollten, merken Sie sich bitte: »C«-NULL = »Modula-2«-NIL. Betreffend der Datenstrukturen gilt grundsätzlich, daß neben dem eigentlichen Datenverbund auch ein Adreßzeiger auf ihn definiert ist. Der Name des Adreßzeigers ist fast der gleiche wie der der zugehörigen Datenstruktur, es wird lediglich die Endung Prr angehängt (z.B.: Window, WindowPtr). Die Definition der Flags ist ebenfalls immer einheitlich: In einer Datenstruktur finden Sie den BITSET- Typ, den Sie daran erkennen, daß er die Endung »Ser« hat. Um einzelne Flags setzen zu können, muß der zugehörige Aufzählungstyp ebenfalls importiert werden. Hat eine bestimmte Kombination von mehreren Bits eine gesonderte Bedeutung, so sind diese als Konstanten definiert. Beachten Sie also bitte besonders beim Setzen von Flags, ob es sich um einzelne Bits (Importieren des zugehörigen Aufzählungstyps genügt) oder Kombinationen von mehreren handelt (entsprechende Konstante muß extra importiert werden). Betrachten Sie als Beispiel dazu die NewWindow-Datenstruktur, in der der Datentyp Window- FlagSet verwendet wird. Wollen Sie einzelne Bits setzen, so reicht es, neben diesem Datentyp den zugehörigen Aufzählungstyp WindowFlags zu importieren. Nun hat aber darüber hinaus das gleichzei- tige Setzen der beiden Flags simpleRefresh und superBitMap eine eigene Bedeutung. Die Kombination dieser beiden Flags wird daher getrennt als die Konstante otherRefresh definiert. Wollen Sie diese verwenden, so muß sie ebenfalls importiert werden. Nun zu der Modula-2-Version des bereits in der Einleitung erwähnten Beispielprogrammes: MODULE HalbHel1Demo; FROM SYSTEM IMPORT ADR; (* Funktion: Berechnet einen Adreßzeiger auf ein Datenelement *) FROM Exec IMPORT WaitPort; (* Routine: Warten auf Ereignis *) FROM Intuition IMPORT OpenScreen, (* Funktion: Öffnet einen Bildschirm *) CloseScreen, (* Routine: Schließt einen Bildschirm *) NewScreen, (* NewScreen-Struktur *) ScreenPtr, (* Zeiger auf Screen-Struktur *) OpenWindow, (* Funktion: Öffnet ein Fenster *) CloseWindow, (* Routine: Schließt ein Fenster *) NewWindow, (* NewWindow-Struktur *) WindowPtr, (* Zeiger auf Window-Struktur *) IDCMPFlags, (* Aufzählungstyp der IDCMP-Flags *) IDCMPFlagSet, (* BITSET-Typ der IDCMP-Flags *) WindowFlags, (* Aufzählungstyp der Window-Flags *) WindowFlagSet, (* BITSET-Typ der Window-Flags *) ScreenFlagSet, (* BITSET-Typ der Screen-Flags *) customScreen; (* Kombination der ersten vier Bits aus ScreenfFlagSet, wird anstelle des Auf- zählungstypen ScreenFlags verwendet.*) FROM Graphics IMPORT ViewModes, (* Aufzählungstyp der View-Modi *) ViewModeSet, (* BITSET-Typ der View-Modi *) RastPortPtr, (* Zeiger auf RastPort-Struktur *) SetAPen, (* Routine: Zeichenfarbe setzen *) RectFill; (* Routine: Rechteck zeichnen *) CONST ScrTitle “Extra-Halfbrite: Die Farben 32 - 63”; WinTitle = “Die Farben 0 - 31 im Fenster”; VAR QurNewScreen : NewScreen; (* NewScreen-Struktur *) OurScreen » ScreenPtr; (* Zeiger auf Screen-Struktur *) OurNewWindow : NewWindow; (* Newwindow-Struktur *) OurWindow : WindowPtr; (* Zeiger auf Window-Struktur *) ScrRPort : RastPortPtr; (* Zeiger auf RastPort des Screens ”) WinRPort : RastPortPtr; (* Zeiger auf RastPort des Windows *) x1,x2 [0,4320]: (* Die obere linke und untere Rechte *) yl,y2 >-605,4.250.]% (* Ecke der zu zeichnenden Rechtecke. *) farbe +0,63 ]% (* Nummer eines Farbregisters *) BEGIN WITH OurNewScreen DO (* NewScreen-Struktur anlegen *) leftEdge := 0; topEdge =D) width = 320; height = 256; depth = 6; detailPen = 0; blockPen =]; viewModes := ViewModeSet{extraHalfbrite}; type = customScreen; font := NIL; defaultTitle := ADR(ScrTitle); gadgets := NIL; customBitMap := NIL; END; (* WITH OurNewScreen DO *) OurScreen := OpenScreen(OurNewScreen); (* Screen Öffnen *) IF OurScreen <> NIL THEN (* War Öffnen erfolgreich? *) (**** Da die RastPort-Struktur in der Screen-Struktur eingebunden ist, AR) (**** muß seine Adresse durch ADR() berechnet werden. EEEN) ScrRPort := ADR(OurScreen‘*.rastPort); (KFAKR “rRrK) WITH OurNewWindow DO (* NewWindow-Struktur anlegen *) leftEdge = 0; topEdge = 126; width ‘= 320% height := 130; detailPen = 0; blockPen := ]; idcempFlags := IDCMPFlagSet{closeWindow}; flags := WindowFlagSet{windowClose,simpleRefresh}; firstGadget := NIL; checkMark := NIL; title := ADR(WinTitle); screen := QurScreen; bitMap := NIL; minWidth is minHeight = 0; maxWidth := 320; maxHeight = 256; type := customScreen; END; (* WITH OQurNewWindow DO *) OurWindow := OpenWindow(OurNewWindow); (* Fenster Öffnen *) IF OurWindow <> NIL THEN (* War das Öffnen erfolgreich? *) (**%* Da die Window-Struktur nur einen Zeiger auf die RastPort-Struktur ER) (**** enthält, muß dieser nur kopiert werden. PN SE) WinRPort := OurWindow*.rPort; (KRAR “RrRrK) farbe := 0; (* Initialisieren der Variablen *) XL se 54. yL ve 1135 2 weiber V2 ve 555 REPEAT (* Schleife für Rechtecke *) INC(farbe); (* Farbregisternummer erhöhen *) LNEEX13733 (* Neue obere linke Ecke und *) LNEXYVEYS (* neue untere rechte Ecke des *) ENGLK2,83; (* aktuellen Rechtecks berechnen. *) ENETY22233 SetAPen(WinRPort,farbe); (* Window-Zeichenfarbe setzen *) RectFill(WinRPort,x1,yl,x2,y2); (* Rechteck im Window zeichnen *) SetAPen(ScrRPort,farbe+t32); (* Screen-Zeichenfarbe setzen *) RestFtiLitsckkPfort XL, y1232 235 (* Rechteck im Screen zeichnen *) UNTIL farbe = 31; (* Alle Farben von 1 - 31 durch? *) WaitPort(OurWindow*.userPort); (* Warten auf Systemnachricht des Fensters *) CloseWindow(OurWindow); (* Fenster schließen *) END; (* IF QurWindow <> NIL *) CloseScreen(OurScreen); (* Bildschirm schließen *) END; (* IF QurScreen <> NIL *) END HalbHellIDemo. Den Modula-2-Programmierern empfehlen wir an dieser Stelle dringend, das mächtige Modul-Konzept von Modula-2 auch auszunutzen und nicht immer wieder erneut Räder zu erfinden. So gibt es bereits einige Amiga-spezifische Modul-Bibliotheken wie die Amiga-Treasures oder File-Treasures, mit denen das aufwendige Hantieren mit den Datenstrukturen (fast) entfällt. Das Erstellen solcher Implementations- Module sollte das Ziel eines jeden Modula-2-Programmierers sein, um später beinochmaligem Gebrauch auf bereits Erarbeitetes sofort zurückgreifen zu Können. 2.3 Hinweise für Assembler-Programmierer In diesem Abschnitt wollen wir nur auf einige typische Beispiele (sowie Tücken und Gefahren) aus dem Leben eines Assembler-Programmierers hinweisen. Er soll einen allgemeinen Überblick über Besonder- heiten liefern, die es im Zusammenhang mit der Assembler-Programmierung auf dem Amiga zu beachten gilt. Wir beziehen uns bei den folgenden Angaben immer auf den Devpac-Assembler von HiSoft. Zunächst einmal zu so allgemeinen Dingen wie dem Öffnen und Schließen der Libraries und Devices. In Assembler sieht die Vorgehensweise wie folgt aus: OpenLib lea LibName,al ;‚ Adreßzeiger auf den Namen der Library. move,] #0,d0 : Versionsnummer der Library (0: No. egal). CALLEXEC OpenLibrary : Öffnen der Library. tst.] dO ; Vergleichen des Adreßzeigers mit 0. beq Exit : d0O = 0 : Das Öffnen war nicht erfolgreich. move.] d0O,_IntuitionBase ; Adreßzeiger auf die geöffnete Library. ;‚ Hier kann das eigentliche Programm stehen. CloseLib move.] IntuizZg,al ; Adreßzeiger auf die zu schließende Library. CALLEXEC CloseLibrary ; Library schließen. Exit rts : Programm verlassen. LibName dc.b *“intuition.library”,O ; Name der Library. “IntuitionBase dc.]! 0 ;‚ Adreßzeiger auf die Library. Um zum eigentlichen Thema dieses Buches zu kommen, nun etwas über den Gebrauch der Datenstruk- turen. In Assembler stimmt die Definition der Datenstrukturen in weiten Teilen mit dem Format der C- Definition überein. Wir haben uns daher entschlossen, das Assembler-Format nicht extra mit abzudruk- ken. Sie finden dafür am Ende einer jeden Datenstruktur Informationen, die Ihnen sagen, ob und, wenn ja, wie sich das Assembler-Format vom C-Format unterscheidet. Normalerweise beschränkt sich dies auf die Angabe eines Präfix. Setzen Sie dieses Präfix vor die Namen der einzelnen Komponenten im C-Format, so erhalten Sie den Namen im Assembler-Format. Nun zu der Vorgehensweise, wie Speicherplatz für eine Datenstruktur bereits im Listing freizuhalten ist: Die Länge einer jeden Datenstruktur (in Bytes) ist jeweils zusätzlich definiert. Um anzugeben, von welcher Datenstruktur Sie die Länge haben möchten, müssen Sie das Präfix der jeweiligen Datenstruktur mit der Endung SIZE versehen. Um Speicherplatz für eine BitMap-Datenstruktur (Präfix: bm_) bereits im Listing zu reservieren, kann man also folgendes einsetzen: OurBitMap ds.b bm_SIZE ; Speicherbereich der Größe einer BitMap-Daten- ; struktur freihalten. Abschließend das bereits in der Einleitung erwähnte Beispielprogramm, das den Umgang mit den einzelnen Komponenten der Datenstrukturen verdeutlichen soll. Das Beispiel ist so gewählt, daß einerseits auf eine in die Screen-Datenstruktur eingebundene RastPort-Datenstruktur zugegriffen wird, andererseits aber auch auf eine RastPort-Datenstruktur, von der in der Window-Datenstruktur lediglich ein Adreßzeiger steht. ; Programm: include exec/exec_lib.i Einbinden der benötigten include intuition/intuition.i Include-Files. include intuition/intuition_]ib.i include graphics/graphics_lib.i OpenIntLib Öffnen der Intuition-Library. ei; ] do Versionsnummer ist egal. lea IntName,al Zeiger auf den Library-Namen. CALLEXEC OpenLibrary ; Aufruf der Systemroutine. tt, dO Öffnen erfolgreich? beq ExitFinalis Nein: Abbrechen. move.] d0O,_IntuitionBase Ja: Zeiger merken. OpenGrafLlib Öffnen der Graphics-Library. ei; do Versionsnummer ist egal. lea GrafName,al Zeiger auf den Library-Namen. CALLEXEC OpenLibrary ; Aufruf der Systemroutine. ste] d0 Öffnen erfolgreich? beq ExitCloselnt Nein: Abbrechen. move.] d0O,_GfxBase Ja: Zeiger merken. OpenScr Öffnen eines Screens. move.] OurNewScreen,a0 Zeiger auf NewScreen-Struktur. CALLINT OpenScreen Aufruf der Systemroutine. Est do Öffnen erfolgreich? beq ExitCloseGraf Nein: Abbrechen. move,] d0,0urScreen Ja: Screen-Zeiger merken. ; *##*%*#* Adreßzeiger auf den RastPort des Screens berechnen: Die RastPort- REN ; *#%% Struktur ist in der Screen-Struktur eingebunden, daher muß zu der SURT ; *%%* Adresse der Screen-Struktur der Offset sc_RastPort (#84) hinzuge- RERE ; *#*%*% gezählt werden. ERRE addi.] #sc_RastPort,dO 4 Aıkrx “KKAX move.] 40, SEerRPort Zeiger auf RastPort merken. OpenWin | Öffnen eines Windows. move.] OurNewWindow,aO Zeiger auf NewWindow-Struktur. move.] OurScreen,nw_Screen(a0) Screen-Zeiger in NewWindow- Struktur auf eigenen Screen CALLINT OpenWindow setzen. tst.] d0 Öffnen erfolgreich? beq ExitCloseScr Nein: Abbrechen. move.] d0,0urWindow Ja: Window-Zeiger merken. move.] d0,a0 Zeiger wird in einem Adreß- HalbHel]Demo incdir”Ass:include/” Pfad zu den Include-Files. register benötigt. “rArr “AKRX KAAAXK AAAXK KAAKK KAARr Rects Den Adreßzeiger auf den RastPort des Window berechnen: Die Window- **%** Struktur enthält selbst nur einen Adreßzeiger auf die RastPort- FAR Struktur, der “nur” kopiert werden muß. Addiert man zu der Adresse **%*%* der Window-Struktur den Offset wd_RPort (#50), so erhält man die RER Adresse, an der der gewünschte Zeiger steht. RER move.] wd_RPort(a0),WinRPort “rıix%K Rechtecke ausgeben. addgq.b #l,farbe Nächste Farbe auswählen. addi.w #7 ,x1 Koordinaten der linken addi.w #1l,yl oberen Ecke setzen. addi.w #8,x2 Koordinaten der rechten addi.w #2,y2 unteren Ecke setzen. move.] WinRPort,al Zeiger auf Window-RastPort. move.b farbe,dO Die nächste Zeichenfarbe CALLGRAF SetAPen setzen. move.w x1,d0 Koordinaten der linken move.w yl,di oberen Ecke holen. move.w x2,d2 Koordinaten der rechten move.w y2,d3 unteren Ecke holen. CALLGRAF RectFill Rechteck auf Window ausgeben. move.] ScrRPort,al Zeiger auf Screen-RastPort. move.b farbe,dO Farbwert erneut holen und addi.b #$20,d0 32 addieren. CALLGRAF SetAPen Farbe setzen. move.w x1,d0 Koordinaten der linken move.w yl,di oberen Ecke holen. move.w x2,.d2 Koordinaten der rechten move.w y2,d3 unteren Ecke holen. CALLGRAF RectFill Rechteck auf Screen ausgeben. cmp.b #31,farbe . Alle’Farben (1-31) durch? bne Rects Nein: Also nochmal. WaitForAction move.] move.] CALLEXEC ExitLegalis move.] CALLINT ExitCloseScr move.] CALLINT ExitCloseGraf move.] CALLEXEC ExitCloselnt move.,] OurWindow,a0 wd_UserPort(a0),a0 WaitPort OurWindow,a0 CloseWindow OQurScreen,a0 CloseScreen _GfxBase,al CloselLibrary _IntuitionßBase,al Wait-State setzen (Warten : mit minimaler Rechenzeit). Zeiger auf Window holen. Zeiger auf UserPort (MsgPort) holen. Warten auf Systemnachricht. Vor Programmbeendigung Fenster, Bildschirm, Graphics-Library und Intuition-Library wieder CALLEXEC CloseLibrary ExitFinalts rts cnop 0,2 OurNewScreen OurNewWindow x1 yl x2 y2 farbe cnopb;2 _IntuitionßBase _GfxBase dc, dc; dc, dc. 0% dc. IC. de, dc IC, de. 00% de:, dc. dc. CH de die:. de, de, CH dc. dc, IC IC; de, a0, de dc. de, dc. GC 90% IC; dc. ae IC ae - — -—— z ıı UT zz z x zmıı zz —- - - --.-.-- To zz zz oxzııı = 320 256 6) 0 1 128 CUSTOMSCREEN 0 Scrlitle 0 0 126 320 130 0 1 CLOSEWINDOW WINDOWCLOSE!SIMPLE_REFRESH 0 0 WinTitle 0 0 0 0 320 256 CUSTOMSCREEN 15 55 33 ordnungsgemäß schließen. Programmende. Nachfolgende Adresse gerade? NewScreen-Datenstruktur: LeftEdge TopEdge Width Height Depth DetailPen BlockPen ViewModes: Type Font EXTRAHALFBRIGHT : Title Gadgets CustomBitMap NewWindow-Datenstruktur: LeftEdge ; TopEdge Width Height DetailPen BlockPen IDCMPFlags ; WindowFlags FirstGadget CheckMark ; Title Screen BitMap MinWidth MinHeight ; MaxWidth MaxHeight -Iype Startwerte für die linke obere und die rechte untere Ecke der zu Zeichnenden Rechtecke,. Startwert für Farbregister. Die nachfolgende Adresse muß gerade sein. Zeiger für Intuition-Library. Zeiger für Graphics-Library. OurScreen de: 7.0 ; Zeiger für Screen-Struktur. OurWindow dcs. 0 ; Zeiger für Window-Struktur. ScrRPort des... 0 ; Zeiger für RastPort-Struktur ; des Screens. WinRPort 0cz1.0 ‚ Zeiger für RastPort-Struktur : des Windows. ScrTitle de.b. *"Extra-Halfbrite: Die Farben 32 -163”,0 cnop 0,2 WinTitle dc.b “Die Farben 0 - 31 im Fenster”,O enoB.052 IntName dc.b *intuition.library”,0 E00. 052 GrafName dc.b “graphics.library”,O Abschließend noch ein paar warnende Worte zur Benutzung der Include-Files. In Assembler bestehen diese fast ausschließlich aus Offset-Tabellen, bei denen einer bestimmten Buchstabenfolge eine Adreß- distanz zugeordnet wird. Leider ist es beim Devpac-Assembler möglich, Systemroutinen aufzurufen, die es gar nicht gibt. Syntaktisch wird beispielsweise der Aufruf »CALLINT WritePixel« ohne Probleme (also ohne Fehlermeldung) geschluckt. Da es sich aber bei »WritePixel« nicht um eine Routine der Intuition-Library (CALLINT), sondern um eine der Graphics-Libraries (CALLGRAF) handelt, hatsoein Aufruf mehr oder weniger schwerwiegende Folgen. Je mehr Libraries geöffnet sind, desto »gefährlicher« wird die Programmierung. 2.4 Hinweise für Amiga-Basic-Programmierer Da in Amiga-Basic heterogene Datenstrukturen (RECORD-Verbunde in Modula-2, struct-Strukturen in C) grundsätzlich unbekannt sind, erweist sich der Datenstrukturzugriff hier als äußerst umständlich: Ausgehend von der Anfangs- bzw. Basisadresse eines Datensatzes, kann auf die einzelnen Komponenten über deren Offset mittels entsprechender PEEKx- und POKEx-Anweisungen zugegriffen werden. In dieser Hinsicht ähnelt die Vorgehensweise der Assemblerprogrammierung. Allerdings gibtees für Amiga- Basic keine Include-Dateien, in denen die Offsets und Flagswerte symbolisch aufbereitet sind. Dem Amiga-Basic-Programmierer bleibt deshalb nichts anderes übrig, als diese jedesmal in numerischer Form anzugeben. Dabei wird das vorliegende Buch sicher schnell zum unentbehrlichen Hilfsmittel werden! Zur Bereitstellung des Speicherplatzes für die von einem Amiga-Basic-Programm selbst benötigten Systemdatenstrukturen bieten sich zwei unterschiedliche Verfahren an: l. Statische Deklaration eines entsprechend großen Zahlenfelds mittels der DIM-Anweisung. 2. Dynamische Speicherbeschaffung durch Aufruf einer Systemroutine wie AllocMem aus »Exec« oder AllocRemember aus »Intuition«. Im weiter unten abgedruckten Amiga-Basic-Programm »HalbHellDemo« findet Methode 1 bei der Benutzung von NewScreen- und NewWindow-Datenstrukturen Verwendung. Natürlich ist in beiden Fällen umständliches POKEn zur Initialisierung der Datenstrukturen nötig. Zu beachten ist darüber hinaus die Tatsache, daß die in Systemdatenstrukturen verwendeten Zeichenketten durchweg mit einem Nullzeichen = CHR$(0) abgeschlossen werden müssen. Wie man die Amiga-Libraries in Amiga-Basic mittels der LIBRARY-Anweisung Öffnet und die einzelnen Systemroutinen danach durch CALL-Aufrufe anspringt, sollte bekannt sein. Weitere Tips und Hinweise zur Systemprogrammierung entnehmen Sie am besten Kapitel 6 des Amiga-Basic-Hand- buchs von Commodore. Viel Spaß also mit dem nachfolgenden Beispielprogramm und dem gesamten Buch! Benoetigte Systembibliotheken oeffnen und alle daraus verwendeten Funktionen mit Ergebnistyp und Parametern deklarieren. LIBRARY “exec.library” DECLARE FUNCTION WaitPort& (Port&) LIBRARY LIBRARY “graphics.library” EIBRARF "rntaition.lıbrary” DECLARE FUNCTION OpenScreend (NewScreend) LIBRARY DECLARE FUNCTION OpenWindow& (NewWindow&) LIBRARY “ “HalbHellDemo” : Amiga-BASIC-Version ScrTitle$ = “Extra-Halfbrite: Die Farben 32 - 63” + CHR$(O) EXTRAHALFBRITE% = 128 “ Flagswert fuer Extra-Halfbrite Modus CUSTOMSCREENA =: 15 ‘“ Typwert fuer Benutzer-definierten Bildschirm DIM OurNewScreen%(15) “ Laenge “NewScreen”-Datenstruktur = 32 Bytes BaaHsserr een "NEnScreen: -Datenstrüktur InItialisleren Fer ö OurNewScreenAdr& = VARPTR(OurNewScreen%(0)) * Basisadresse “NewScreen”-Struktur POKEW OurNewScreenAdr& + 0,0 ‘“ “LeftEdge” POKEW OurNewScreenAdr& + 2,0 “ *TopEdge” POKEW OurNewScreenAdr& + 4A, 320 ‘“ *Width” POKEW OurNewScreenAdr& + 6, 256 “ “Height” POKEW OurNewScreenAdr& + 8,6 “ “Depth” POKE OQurNewScreenAdr& + 10, 0 ‘ *DetailPen” POKE OurNewScreenAdr& + 11, 1 “ *BlockPen” POKEW OurNewScreenAdr& + 12, EXTRAHALFBRITE% “ “ViewModes” POKEW OurNewScreenAdr& + 14, CUSTOMSCREEN% * Type” POKEL OurNewScreenAdr& + 16, O " #FRont” POKEL OurNewScreenAdr& + 20, SADD(ScrTitle$) ‘“ *DefaultTlitle” POKEL OurNewScreenAdr& + 24, 0 “ Gadgets” POKEW OurNewScreenAdr& + 28, 0 “ *“CustomBitMap” OQurScreen& = OpenScreen&(VARPTR(OurNewScreen%(0))) “ Screen oeffnen |! IF OurScreen&=0 THEN END * Fehler beim Deffnen des Bildschirms ? ScrRPort& = QurScreen& + 84 “ Adresse des Screen-Rastports bestimmen WinTitle$ = “Die Farben 0 - 31 im Fenster” + CHR$(O) CLOSEWINDOW& = 512 “ IDEMP-Flagge fuer Meldungen des Close-Gadget Klickens WINDOWCLOSE& = 8 “ Fenster mit Close-Gadget ausstatten SIMPLEREFRESH& = 64 “ Simple-Refresh Methode fuer das Fenster DIM OurNewWindow&(12) ° Laenge “NewWindow”-Datenstruktur = 48 Bytes IS EDER EREeTE "NewScreen” -Datenstruktüur initiealisIeren »+-+- > + ne ; OurNewwWwindowAdr& = VARPTR(OurNewWindow&(0)) “ Basisadresse “NewWindow” POKEW OurNewWindowAdr& + 0,0 “LeftEdge” POKEW OurNewWindowAdr& + 2, 126 “ “TopEdge” POKEW OurNewWindowAdr& + 4, 320 “"AuNTdcn” POKEW OurNewWindowAdr& + 6, 130 “Height” POKE OurNewWindowAdr& + 8,0 “DetailPen” POKE OurNewWindowAdr& + 9, 1 “BlockPen” POKEL OurNewWindowAdr& + 10, CLOSEWINDOW& “ "IDCMPFlags” POKEL OurNewWindowAdr& + 14, WINDOWCLOSE&+SIMPLEREFRESHA APleds” POKEL OurNewWindowAdr& + 18, 0 “ *FirstGadget” POKEL OurNewWindowAdr& + 22, 0 “CheckMark” POKEL OurNewWindowAdr& + 26, SADD(WinTitle$) "Title POKEL OurNewWindowAdr& + 30, OurScreenä “ “Screen” POKEL OurNewWindowAdr& + 34, 0 “BitMap” POKEW OurNewWindowAdr& + 38, 0 “ *MinWidth” POKEW OurNewWindowAdr& + 40, 0 “ “MinHeight” POKEW OurNewWindowAdr& + 42, 320 “ “MaxWidth” POKEW OurNewWindowAdr& + 44, 256 “MaxHeight”POKEW OurNewWindowAdr& + 46, CUSTOMSCREEN% ‘“ “Type” OurWindow& = OpenWindow&(VARPTR(OurNewWindow&(0))) “ Fenster oeffnen |! IF OurWindow&=0 THEN “ Fehler beim Oeffnen des Fensters ? CALL CloseScreen(QOurScreend) : END “ ja -> Bildschirm wieder schliessen END IF WinRPort& = PEEKL(OurWindow&+50) “ Adresse des Window-Rastports bestimmen farbe% = 0 “ Initialisierung der Variablen xıl% = 5 yl% = 15 x2% = 55 : 2% = 55 WHILE farbe%<32 “ Schleife für Rechtecke farbe% = farbe% + 1 “ Farbregisternummer erhoehen x1l% = x1% + 7 “neue obere ]Jinke Ecke und yl% = yl% + 1 “neue untere rechte Ecke des x2% = x2% + 8 “ aktuellen Rechtecks berechnen y2%A = y2% +2 CALL SetAPen(WinRPort&,farbe%) “ Window-Zeichenfarbe setzen CALL RectFill(WinRPort&,x1%,y1%,x2%,y2%) “ Rechteck im Window zeichnen CALL SetAPen(ScrRPort&,farbe%+32) “ Screen-Zeichenfarbe setzen CALL RectFill(ScrRPort&,x1%,y1%,x2%,y2%) “ Rechteck im Screen zeichnen WEND QurWinPort& = PEEKL(OurWindow&+86) “ Zeiger auf Userport bestimmen Msg& = WaitPort&(OurWinPort&) “ auf Klicken des Close-Gadgets warten CALL CloseWindow(OurWindowä) “ Fenster schliessen CALL CloseScreen(OurScreenä) “ Bildschirm schliessen END DIE ExEcC-LiBRARY Die Exec-Library ist die »Basis-Library« des Amiga-Betriebssystems. Sie ist für das Multitasking und die Verwaltung anderer Libraries, Devices und Ressourcen zuständig. Eine Besonderheit dieser Library ist, daß sie immer geöffnet ist (man kann also Exec-Funktionen benutzen, ohne vorher die Library explizit öffnen zu müssen). 3.1 Wichtige Flags der Exec-Library Die Memory-Flags Diese Flags bestimmen die Eigenschaften eines Speicherbereiches. Sie werden an alle Routinen zur Speicherallokierung übergeben und werden in allen Datenstrukturen benutzt, die Speicherbereiche beschreiben (in Modula-2 sind sie in dem Aufzählungstyp MemRegs definiert, benutzt werden sie dann als MemRegset). C Modula-2 Dez Beschreibung MEMF_ PUBLIC public | l _ Der Speicher kann von anderen Tasks benutzt werden. In der aktuellen Version jedoch bedeu- tungslos. MEMF_CHIP chip 2 _ Der Speicherbereich soll im Chip-RAM liegen. MEMF_FAST fast 4 Der Speicherbereich soll im Fast-RAM liegen. MEMF_CLEAR memClear 65536 Der Speicherbereich soll beim Allokieren gelöscht (mit Nullen gefüllt) werden. MEMF _LARGEST _ largest 131072 Es soll der größtmögliche zusammenhängende Speicherblock der angegebenen Art alloziert werden. 3.2 Die Datenstrukturen der Exec-Library Modula-2 (Exec) oe C (exec/devices.h) struct Device Device = { RECORD struct Library dd_Library; library:Library; ; END; Assembler Verwenden Sie die identische Library-Datenstruktur. Datenstrukturenreferenz »Clipboard« : IOClipboard. »Exec« : IORequest, IOStdRegq. »Printer« : lIOPrinter, IODRPRea. Routinenreferenz »Exec« : AddaDevice, RemDevice. 1___> Beschreibung Diese Prozedur beschreibt ein Device. Wie der Definition zu entnehmen ist, ist sie mit einer Library- Datenstruktur identisch. dd Library 0x0000 (0) Eine normale Library-Datenstruktur, die das Device beschreibt. ExecBase om C (exec/exechbase.h) Modula-2 (Exec) Hex Den struct ExecBase ExecBase = RECORD { 0 struct Library LibNode; libNode:Library; 34 UWORD SoftVer; softVer:CARDINAL; 36 - WORD LowMemChkSum; lowMemChkSum:INTEGER,; 38 ULONG ChkBase; chkBase:LONGCARD; 42 APTR ColdCapture; coldCapture: ADDRESS; 46 APTR CoolCapture; coolCapture: ADDRESS; 50 APTR WarmCapture; warmCapture: ADDRESS; 54 APTR SysStkUpper; sysStkUpper: ADDRESS; APTR SysStkLower; sysStkLower: ADDRESS; Offset C (exec/execbase.h) Dez Hex 003E 0042 0046 004A O04E 0052 0054 0114 0118 O1IC 0120 0122 0124 0126 0127 0128 012A 012C 0130 0134 0138 013C 0140 0142 0150 O15E O16C 017A 0188 0196 01A4 01B2 0202 0212 0213 0214 62 276 280 284 288 290 292 294 295 296 298 300 304 308 312 316 320 322 336 350 364 378 392 406 420 434 514 530 531 532 ULONG MaxLocMem; APTR DebugEntry; APTR DebugData; APTR AlertData; APTR MaxExtMem; UWORD ChkSum; struct IntVector IntVects[16]; struct Task *ThisTask; ULONG IdleCount; ULONG DispCount; UWORD Quantum; UWORD Elapsed; UWORD SysFlags; BYTE IDNestCht; BYTE TDNestCnt; UWORD AttnFlags; UWORD AttnResched; APTR ResModules; APTR Task TrapCode; APTR TaskExceptCode; APTR TaskExitCode; ULONG TaskSigAlloc; UWORD TaskKTrapAlloc; struct List MemLbist; struct List ResourceL ist; struct List DeviceList; struct List IntrList; struct List LibList; struct List PortLäist; struct List TaskReady; struct List TaskWait; struct SoftIntList SoftInts[5]; LONG LastAlert[4]; UBYTE VBlankFrequency; UBYTE PowerSupplyFrequency; struct List SemaphorelLbist; Modula-2 (Exec) maxLocMem:LONGCARDB; debugEntry: ADDRESS; debugData: ADDRESS; alertData: ADDRESS; maxExtMem: ADDRESS; chkSum:CARDINAL; intVects:IntFlags IntVector; thisTask:TaskPtr; idleCount: LONGCARD; dispCount:LONGCARD; quantum:CARDINAL; elapsed:CARDINAL; sysFlags:CARDINAL; idNestCnt:Byte; tdNestCnt:Byte; attnFlags:AttnFlagSet; attnResched:CARDINAL; resModules: ADDRESS; task TrapCode:PROC; taskExceptCode:PROC; taskExitCode:PROC; taskSigAlloc:LONGSET, taskTrapAlloc:BITSET,; memlist:List; resourceList:List; deviceList:List; intrList:List; lıbList:List; portList:List; taskReady:List; taskWait:List; softInts: ARRAY [0..4] OF SoftIntList; lastAlert: ARRAY [0..3] OF LONGINT; vBlankFrequency:UByte; powerSupplyFrequency:UByte; semaphoreList:List; Offset C (exec/execbase.h) Modula-2 (Exec) 0222 546 APTR KickMemfPtr; kickMemPtr: ADDRESS; 0226 550 APTR KickTagPir; kick TagPtr: ADDRESS; 022A | 554 APTR KickCheckSum; kickCheckSum:LONGCARD; 022C | 558 UBYTE ExecBaseReserved[10]; execBaseReserved: ARRAY [0..9] OF BYTE; 0238 568 UBYTE ExecBaseNewReserved[20]; | execBaseNewReserved: ARRAY [0..19] OF BYTE; }; END; Assembler Syntax: Der erste Parameter (LibNode) ist nicht definiert. Datenstrukturenreferenz »PrtBase«: PrinterData. Routinenreferenz »Exec«: FindTask. »ExecSupport«: CreateTask, DeleteTask. F7> Beschreibung Die globale Basis-Datenstruktur von »Exec«, die die wichtigsten Sprungvektoren und Zustandsvariablen beinhaltet. Unüberlegte Veränderungen in dieser Datenstruktur haben immer nur ein Ziel: die Zerstörung aller im RAM befindlichen Daten. I LibNode 0x0000 (0) Eine eingebundene Library-Datenstruktur, die die Exec- Library beschreibt. J SoftVer 0x0022 (34) Die Versionsnummer des Kickstarts. 3 LowMemChkSum 0x0024 (36) Zur Zeit noch unbenutzt. I ChkBase 0x0026 (38) Das Komplement der Adresse der ExecBase-Datenstruktur. Es wird zur Prüfung der Position der ExecBase beim Reset benutzt und zur Position addiert. „J ColdCapture 0x002A (42) Hier kann die Adresse einer Routine, die am Anfang eines Resets ausgeführt wird, eingetragen werden. Beim Ein- sprung beinhaltet das Adreßregister A5 die Rücksprung- adresse. Dieser Vektor wird von der Reset-Routine automa- tisch auf NULL gesetzt. I CoolCapture 0x002E (46) Wie ColdCapture, wird allerdings später aufgerufen. Dieser Adreßzeiger wird nicht von der Reset-Routine gelöscht. I WarmCapture 0x0032 (50) Noch nicht benutzt. I SysStkUpper 0x0036 (54) Die untere Adresse des Systemstacks. Ü Nummer SysStkLower 0x003A (58) MaxLocMem 0x003E (62) DebugEntry 0x0042 (66) DebugData 0x0046 (70) AlertData 0x004A (74) MaxExtMem 0x004E (78) ChkSum 0x0052 (82) IntVects 0x0054 (84) ThisTask 0x0114 (276) IdleCount 0x0118 (280) DispCount 0x011C (284) Interrupt Serieller Interrupt Die obere Adresse des Systemstacks. Die obere Grenze des Chip-RAM. Die Einsprungsadresse des Debuggers. Sie können hier die Adresse Ihrer eigenen Debug-Prozedur oder des Debuggers eintragen. Interne Daten für den Debugger. Interne Daten die für Alerts benutzt werden. Die Adresse der oberen Grenze der Speichererweiterung oder NULL falls keine vorhanden ist. Eine Prüfsumme über die Felder SoftVer bis MaxExtMem der ExecBase-Datenstruktur. Bei Veränderung eines dieser Felder muß diese Summe neu berechnet werden. Ein Array von IntVector-Datenstrukturen, die die Handler für die 15 möglichen Prozessorinterrupts beschreiben. Die einzelnen Felder stehen für folgende Interrupts: Ein Adreßzeiger auf die Task-Datenstruktur des momentan aktiven Tasks. Ein interner Zähler. Ein Zähler der nach jeder Taskumschaltung inkrementiert wird. Ende der Übertragung eines Diskblocks Soft-Interrupt Interrupt am CIA A Copper-Interrupt Vertikal Blank Interrupt. Wird ausgelöst, wenn der Rasterstrahl die Zeile O passiert. Über diesen Interrupt wird auch das Task-Switching gesteuert. Wird vom Blitter nach Beendigung eines Jobs ausgelöst. Wird vom Audiokanal 0 ausgelöst. Wird vom Audiokanal 1 ausgelöst. Wird vom Audiokanal 2 ausgelöst. Wird vom Audiokanal 3 ausgelöst. Wird durch serielle Eingabe ausgelöst. Zur Synchronisation der Diskette. Interrupt am CIAB. Kann softwaremäßig ausgelöst werden. NMI Quantum 0x0120 (288) Elapsed 0x0122 (290) SysFlags 0x0124 (292) IDNestCnt 0x0126 (294) TDNestCnt 0x0127 (295) [1 AttnFlags 0x0128 (296) Modula-2 AFF_68010 AFF_68020 AFF_68881 m68010 m68020 m68881 AttnResched 0x012A (298) ResModules 0x012C (300) TaskTrapCode 0x0130 (304) TaskExceptCode 0x0134 (308) TaskExitCode 0x0138 (312) TaskSigAlloc 0x013C (316) TaskTrapAlloc 0x0140 (320) Die Anzahl von »Zeitquanten«, die dem aktiven Task zur Verfügung stehen. Die Anzahl der seit dem Einschalten des Task bereits abge- laufenen Zeitquanten. Diverse Systemflags. Jedesmal, wenn Disable aufgerufen wird, wird dieser Zähler inkrementiert, wenn Enable aufgerufen wird, wird er dekre- mentiert. Ein Interrupt wird nur dann zugelassen, wenn dieser Zähler -1 ist. Jedesmal, wenn Forbid aufgerufen wird, wird dieser Zähler inkrementiert, wenn Permit aufgerufen wird, wird er dekre- mentiert. »Taskswitching« findet nur dann statt, wenn dieser Zähler —1 ist. Gibt an, welche (Co-)Prozessoren verfügbar sind. Beschreibung Der Motorola MC68010. Der Motorola MC68020. Der Coprozessor MC68881. Wörtliche Übersetzung: »Aufmerksamkeit verschoben«. Ein Adreßzeiger auf eine Liste der residenten Module. Sie werden beim Reset aufgerufen. Ein Adreßzeiger auf den Code, der aufgerufen wird, wenn ein Prozessortrap auftritt. Diese Adresse wird von dem gerade aktiven Task dann übernommen, wenn das Task keinen eigenen Trapcode hat. Ein Adreßzeiger auf den Code, der aufgerufen wird, wenn in einem Task eine Exception auftritt. Diese Routine wird von dem gerade aktiven Task nur dann übernommen, falls sie keinen Exceptioncode hat. Ein Adreßzeiger auf den Code, der aufgerufen wird, wenn der Task den Prozessor verliert (durch das Multitasking ausgeschaltet wird). Diese Adresse wird von dem gerade aktiven Task dann übernommen, wenn der Task keinen eige- nen Exitcode hat. Die allokierten Signale des aktuellen Tasks Die allokierten Traps des aktuellen Tasks [ MemList 0x0142 (322) ResourceList 0x0150 (336) DeviceList 0x015E (350) IntrList 0x016C (364) LibList 0x017A (378) PortList 0x0188 (392) LibList 0x0196 (406)TaskReady TaskWait 0x01A4 (420) SoftInts 0x01B2 (434) LastAlert 0x0202 (514) VBlankFrequency 0x0212 (530) VBlankFrequency 0x0213 (531) PowerSuppiyFrequency SemaphoreList 0x0214 (532) KickMemPtr 0x0222 (546) KickTagPtr 0x0226 (550) KickCheckSum 0x022A (554) ExecBaseReserved 0x022C (558) Eine Liste (erzeugt durch eine eingebundene List-Daten- struktur), in der die freien Speicherbereiche verzeichnet sind. Eine Liste (erzeugt durch eine eingebundene List-Daten- struktur) aller Resource-Datenstrukturen, durch List-Daten- strukturen verkettet. Eine Liste (erzeugt durch eine eingebundene List-Daten- struktur) der DeviceList-Datenstrukturen aller offenen Devices. Durch eine eingebundene List-Datenstruktur erzeugte Liste aller Interrupts. Durch eine eingebundene Zist-Datenstruktur erzeugte Liste der Library-Datenstrukturen aller geöffneten Libraries. Durch eine eingebundene List-Datenstruktur erzeugte Liste aller Messageports. Eine Liste (erzeugt durch eine eingebundene List-Daten- struktur) aller Tasks, die im »Ready«-Zustand sind, also auf ihren Anteil der Prozessorzeit warten. Eine Liste (erzeugt durch eine eingebundene List-Daten- struktur) aller Tasks, die im »Wait«-Zustand sind, also kei- nen Anteil der Prozessorzeit beanspruchen, weil sie auf ein Signal warten. In diesem Feld (erzeugt durch eine eingebundene List-Da- tenstruktur) stehen Listen von /nterrupt-Datenstrukturen der Soft-Interrupts nach Priorität geordnet (-32 im Feld 0, —16 im Feld 1, 0 im Feld 2, 16 im Feld 3, 32 im Feld 3). Ein Adreßzeiger auf einen Zwischenspeicher für Alert-Da- ten, die von der Reset-Routine geholt werden. Die Bildwiederholfrequenz (in der PAL-Version 50Hz). Die Frequenz der Netzspannung (in der PAL- Version 50 Hz). Durch eine eingebundene List-Datenstruktur erzeugte Liste aller Semaphore-Datenstrukturen. Ein Adreßzeiger auf eine MemList-Datenstruktur, die den Speicher beschreibt, der beim Reset für Systemzwecke allo- kiert wird. Ein Adreßzeiger auf eine Resident-Tabelle. Die Prüfsumme des Kickstarts. Ein privater Speicherplatz für »Exec«. [J ExecBaseNewReserved 0x0238 (568) Interrupt Assembler Datenstrukturenreferenz Routinenreferenz L___> Beschreibung Noch ein privater Speicherplatz für »Exec«. om C (exec/interrupts.h) Modula-2 (Exec) Hex Dez struct Interrupt Interrupt = [ RECORD 0000 0 struct Node is_Node; node:Node; 000E 14 APTR is_Data; data: ADDRESS; 0012 18 VOID (*is_Code)(); code:PROC, 0016 22 }; END; Syntax: Strukturname = IS. Definition der Parameter in Versalien. »Exec«: ExecBase. »Intuition«: IntuitionBase. »Resources«: DiskResource, DiskResourceUnit. »Exec«: AddIntServer, Cause, RemIntServer, SetIntVector. »Resources«: AddlICRVector, RemICRVector. Diese Datenstruktur wird zur Definition eines Interrupt-Handlers bzw. -Servers benutzt. Für jeden der 16 Hardware-Interrupts kann es nur einen Handler geben. Die Interrupt-Datenstrukturen der Default- Handler finden Sie in der ExecBase-Datenstruktur. „1 is_Node 0x0000 (0) I is Data 0x000E (14) I is Code 0x0012 (18) IntVector Assembler Datenstrukturenreferenz Routinenreferenz Eine Node-Datenstruktur, die zur Einbindung des Servers in eine Liste dient. Pri enthält die Priorität des Servers. Ein Adreßzeiger auf privaten Datenbereich der Interrupt- Routine. Wird beim Interruptaufrufin dem Adreßregister Al an die Routine übergeben. Ein Adreßzeiger auf den auszuführenden Code. Beim Hand- ler muß dieser mit RTE, beim Server mit RTS enden. Syntax: Strukturname = IV. Definition der Parameter in Versalien. Keine. Keine. C (exec/interrupts.h) struct IntVector { Modula-2 (Exec) IntVector = RECORD APTR iv_Data; VOID (*iv_Code)Ü; struct Node *iv_Node; IF data: ADDRESS; code:PROCG; node:NodePtr; END; Beschreibung Diese Datenstruktur wird Exec-intern benutzt, um einen Interrupt-Handler zu definieren. Dieser wird beim Auftreten eines Interrupts zuerst aufgerufen. Er sichert die Register und ruft nacheinander die Server auf. I iv_Data 0x0000 (0) Ein Adreßzeiger auf einen privaten Datenbereich der Be- handlungsroutine. Dieser Adreßzeiger wird beim Auftreten eines Interrupts im Adreßregister Al übergeben. I iv_Code 0x0004 (4) UI iv_Node 0x0008 (8) Ein Adreßzeiger auf die Behandlungsroutine. Ein Adreßzeiger auf die Node-Datenstruktur des ersten Ele- mentes der Liste der Server. |ORequest struct IORequest { struct Message io_Message; struct Device *io_Device; Modula-2 (Exec) IORequest = RECORD message:Message; device:DevicePtr; struct Unit *io_Unit; unit:UnitPtr; UWORD io_Command; command:CARDINAL; UBYTE io_Flags; flags:IOFlagSet; BYTE io_Eıror; error:Byte; }; END; Assembler Strukturname = /O Syntax: Definition der Parameter in Versalien. Datenstrukturenreferenz »Audio«: IOAudio. »Exec«: lIOStdReg (indirekt). »Timer«: lOTimer. Routinenreferenz »Exec«: AbortIO, ChecklO, CloseDevice, DoIO, OpenDevice, SendlO. > Beschreibung Diese Datenstruktur dient zur Befehls- und Informationsübergabe an und von Devices. Die meisten Devices verwenden zur Kommunikation eine erweiterte Version, die /[OStdReg-Datenstruktur, die ihrererseits noch zusätzlich um weitere Device-spezifische Felder erweitert ist. Eine solche Datenstruk- tur wird beim Öffnen eines Device initialisiert. 1 io_Message 0x0000 (0) „1 io_Device 0x0014 (20) „J io_Unit 0x0018 (24) I io_Command 0x001C (28) C CMD_INVALID CMD_RESET CMD_READ CMD_WRITE CMD_UPDATE CMD_CLEAR CMD_STOP CMD_START CMD_FLUSH CMD_NONSTD Modula-2 invalid reset read write update clear stop start flush nonstd Eine eingebundene Message-Datenstruktur, die von den Devices benötigt wird, um nach der Beendigung der Befehls- ausführung eine Antwort zu schicken. Ein Adreßzeiger auf eine Device-Datenstruktur, die das Device beschreibt. Das Feld wird beim Öffnen der Device von »Exec« initialisiert. Dies istein Device-spezifisches Feld, das einen Adreßzeiger auf ein Unit enthält. Das wird normalerweise eine allgemei- ne »Exec«-Unit-Datenstruktur sein. Bei der Console-Device steht hier aber beispielsweise die Adresse einer ConUnit- Datenstruktur. Hier steht der Befehl, der an das Device geschickt wird. Neben den Device-spezifischen Befehlen, die in den ent- sprechenden Kapiteln behandelt werden, gibt es folgende Standardbefehle, die als Konstanten definiert sind. Beschreibung Ein Befehl, der von dem Device nicht beantwortet werden muß. Einen Reset am Device durchführen, es also mit den Defaultwerten initialisieren. Veranlaßt das Device, eine Anzahl von Bytes in den Datenpuffer zu lesen. Veranlaßt das Device, eine Anzahl von Bytes aus dem Datenpuffer zu schreiben. Veranlaßt das Device, den Inhalt aller internen Puffer auf das physikalische Gerät zu schreiben. Löscht alle internen Puffer des Device. Unterbricht alle Aktionen des Device. Setzt die durch CMD_STOP unterbrochene Aktion fort. Veranlaßt das Device, alle IO/Requests zu unterbrechen und Fehlermeldungen zurückzugeben. Alle Device-spezifischen Befehle sind als CMD_NONSTD + x (mit x >= 0) definiert. „1 io_Flags 0x001E (30) 5 - Einige Flags, die den Status des Device bzw. befehlsspezifi- sche Optionen bestimmt. Die unteren vier Bit sind für »Exec« reserviert, während die oberen Device-spezifisch sind. Der einzige vordefinierte Wert ist: C Modula-2 Dez Beschreibung IO_QUICK quick 0 Den Request asynchron ausführen, also nicht auf die Erfolgs- oder Fehlermeldung warten. U io_Error 0x001F (31) Hier steht nach der Befehlsausführung die Fehlermeldung als Long-Zahl. Die Bedeutung der Meldung ist von Device zu Device verschieden. Sie finden die Device-spezifischen Fehlerwerte in den entsprechenden Abschnitten. IOStdReq Hex Dez | struct IOStdReq IOStdReq = { RECORD 0000 0 struct Message io_Message; message:Message; 0014 20 struct Device *io_Device; device:DevicePtr; 0018 24 struct Unit *io_Unit; unit:UnitPtr; 001C 28 UWORD io_Command; command:CARDINAL; O01E 30 UBYTE io_Flags; flags:IOFlagset; O0O1F 31 BYTE io_Error; error:Byte; 0020 32 ULONG i10_Actual; actual: LONGCARD; 0024 36 ULONG io_Length; length/LONGCARD; 0028 40 APTR io_Data; data: ADDRESS; 002€ 44 ULONG ı1o_Offset; offset: LONGCARD; 0030 48 I END; Assembler Syntax: Strukturname = /O Definition der Parameter in Versalien, die Größe der Datenstruktur steht in /[OSTD_SIZE. Datenstrukturenreferenz »Audio«: IOAudio. »Intuition«: IntuitionBase. »Narrator«: lONarrator. »Parallel«: lOParallel. »Serial«: IOSerial. »Trackdisk«: lIOTrackDisk. Routinenreferenz »ExecSupport«: CreateStdlIO, DeleteStalO. Beschreibung Dies ist eine Erweiterung der oben beschriebenen /ORequest-Datenstruktur. Die ersten sechs Felder von IOStdRegq bilden eine /ORequest-Datenstruktur. Eine um weitere Device-spezifische Felder erweiterte IOStdReg-Datenstruktur wird zum Öffnen und Betreiben der meisten Devices benötigt. I io_Message 0x0000 (0) 1 io_Device 0x0014 (20) I io_Unit 0x0018 (24) I io_Command 0x001C (28) U io_Flags 0x001E (30) I io_Error 0x001F (31) „J io_Actual 0x0020 (32) 3 io_Length 0x0024 (36) I io_Data 0x0028 (40) I io_Offset 0x002C (44) Eine eingebundene Message-Datenstruktur, die von den Devices benötigt wird, um nach der Beendigung der Befehls- ausführung eine Antwort zu schicken. Ein Adreßzeiger auf eine Device-Datenstruktur, die das Device beschreibt. Das Feld wird beim Offnen der Devices von Exec ınitialisiert. Dies ist ein Device-spezifisches Feld, das einen Adreßzeiger auf ein Unit enthält. Das wird normalerweise eine allgemei- ne »Exec«-Unit-Datenstruktur sein. Bei dem Console-Devi- ce steht hier aber z.B. die Adresse einer ConUnit-Daten- struktur. Über dieses Feld stehen die aus der JORequest-Datenstruk- tur bekannten Kommandos zur Verfügung. Diese Flags sind mit denen aus der /ORequest-Datenstruktur identisch. Hier steht nach der Befehlsausführung die Fehlermeldung als Long-Zahl. Die Bedeutung der Meldung ist von Device zu Device verschieden. Sie finden die Device-spezifischen Fehlerwerte in den entsprechenden Abschnitten. Nach der Ausführung eines Befehls finden Sie hier die Anzahl der betroffenen (z.B. geschriebenen) Bytes. Hier wird an das Device die Anzahl der Bytes, die von dem Befehl betroffen werden sollen, übergeben. Der Wert —1 bedeutet oft »alles« (was immer das auch im Einzelfall heißen mag). Ein Adreßzeiger auf den Datenpuffer. Dies muß ein vom Benutzer allokierter Speicherbereich der richtigen Größe sein. Gibt einen Device- und befehlsspezifischen Offset (z.B. Anfangsblock bei dem Trackdisk-Device) an. Library om C (exec/libraries.h) Modula-2 (Exec) extern struct Library Library = { RECORD 0000 0 struct Node lib_Node; node:Node; 000E 14 UBYTE lib_Flags; flags:LibFlagsSet; 000F 15 UBYTE lib_pad; pad:BYTE; 0010 16 UWORD lib_NegsSize; negSize:CARDINAL; 0012 18 UWORD lib_PosSize; posSize:CARDINAL; 0014 20 UWORD lib_ Version; version:CARDINAL; 0016 22 UWORD lib_Revision; revision: CARDINAL; 0018 24 APTR lib_IdString; idString: ADDRESS; 001€ 28 ULONG lib_Sum; sum:LONGCARD; 0020 32 UWORD lib_OpenCht; openCnt:CARDINAL; 0022 34 }; END; Assembler Syntax: Strukturname = LIB Definition der Parameter in Versalien, wobei lib_Node nicht definiert ist. Datenstrukturenreferenz »Dos«: DosLibrary. »Exec«: Device, ExecBase. »Graphics« : GfxBase. »Intuition«: IntuitionBase. »PrtBase« : DeviceData. »Resources«: DiskResource, MiscResource. Routinenreferenz »Exec«: AddLibrary, CloseLibrary, MakeLibrary, OldOpenLibrary, OpenLibrary, RemLibrary, SetFunction, SumLibrary. ____> Beschreibung Diese Datenstruktur enthält alle Informationen, die »Exec« zur Verwaltung einer Library braucht. Sie wird beim Erstellen einer neuen Library mit der Routine MakeLibrary automatisch von »Exec« mit den richtigen Werten initialisiert. U lib_Node 0x0000 (0) Eine eingebundene Node-Datenstruktur, die zur Integrie- rung der Library in die Liste der Systemlibraries dient. U lib_Flags 0x000E (14) Diese Flags definieren den Zustand einer Library. Hier ist eine Kombination der folgenden Werte (Bits) möglich: C Modula-2 Beschreibung LIBF_SUMMING summing Es gibt einen Task, der gerade die Checksumme berechnet. LIBF_CHANGED changed Es wurden eine oder mehrere Funk- tionen der Library verändert. LIBF_SUMUSED sumUsed Veranlaßt einen Reset, falls ein Prüfsummenfehler auftritt. LIBF_DELEXP delExp Die Library soll geschlossen werden, I Iib_Pad 0x000F (15) I lib_NegSize 0x0010 (16) 4 lib_PosSize 0x0012 (18) „1 lib_Version 0x0014 (20) „1 lib_Revision 0x0016 (22) „4 Iib_IdString 0x0018 (24) 4 Iib_Sum 0x001C (28) I lib_OpenCnt 0x0020 (32) List struct List sie wird aber von einem anderen Task benutzt. Das Schließen wird ver- schoben. Ein schnuckeliges Füllbyte. Dieses Wort gibt die Größe der Sprungtabelle für die Routi- nen der Library in Bytes an. Dieses Wort gibt die Größe der Daten in Bytes an. Hier steht die Versionsnummer der Library. Sie wird beim Öffnen überprüft. Hier steht die Überarbeitungsnummer der Library. Ein Adreßzeiger auf den Namen (als nullterminierte Zei- chenkette) der Library. Dieser Name wird zum Öffnen benutzt (z.B. »dos.library«). Hier steht die Checksumme der Library, die mit der SumLi- brary-Routine berechnet wird. Dieses Feld gibt an, wie viele Tasks diese Library für sich geöffnet hat. List = C (exec/lists.h) Modula-2 (Exec) | RECORD struct Node *lh_Head; head:NodePtr; 0 4 struct Node *lh_Tail; tail:NodePtr; 8 struct Node *lh_TailPred; tailPred:NodePtr; 12 UBYTE Ih_Type; UBYTE Ih_pad; 14 k type:NodeType; pad:BYTE; END; Assembler Datenstrukturenreferenz Routinenreferenz ____ > Beschreibung Syntax: Strukturname = LH Definition der einzelnen Parameter in Versalien. »Exec«: »Graphics« : »Intuition«: »KeyMap«: »Resources«: »Workbench«: »Exec«: »ExecSupport«: ExecBase, MsgPort, SoftIntList, Task. GfxBase, LayerInfo. IntuitionBase. KeyMapResource. . DiskResource. FreelList. AddHead, AddTail, Enqueue, Insert, ObtainSemaphore, ReleaseSemaphoreList, RemHead. NewList. Diese Datenstruktur dient als Header für Listen, die aus Node-Datenstrukturen aufgebaut sind. Die »Nodes« sind oft in andere Datenstrukturen eingebunden, die die eigentlichen Elemente der Liste sind. Sie dienen lediglich zur Verknüpfung der Elemente (siehe Node-Datenstruktur). Ein Adreßzeiger auf die List-Datenstruktur ist die Kennung einer Liste, die an diverse Listenroutinen übergeben wird. QJ Ih_Head 0x0000 (0) I Ih_Tail 0x0004 (4) I Ih_TailPred 0x0008 (8) 4 Ih_Type 0x000C (12) C NT_UNKNOWN NT_TASK NT_INTERRUPT NT_DEVICE NT_MSGPORT NT_MESSAGE NT_FREEMSG NT_REPLYMSG NT_RESOURCE NT_LIBRARY Ein Adreßzeiger auf die erste Node-Datenstruktur der Liste. Dieses Feld ist immer NULL. Ein Adreßzeiger auf die letzte Node-Datenstruktur der Liste. Dieser Wert enthält Informationen über die Elemente der Liste. Er sollte identisch mit den entsprechenden Werten der Type-Felder aus den Node-Datenstrukturen der Liste sein. Modula-2 Dez unknown task interrupt device msgPort message freeMsg replyMsg resource library Beschreibung Die Liste enthält unbekannte Elemente. Die Liste enthält Task-Datenstrukturen. Die Liste enthält Interrupt-bezogene Datenstrukturen. Die Liste enthält DeviceList- Datenstrukturen. Die Liste enthält MsgPort- Datenstrukturen. Die Liste enthält Messages. Die Liste enthält nur eine Message. Enthält eine Message, die gerade beantwortet wurde und an den Absender zurückgeht. Die Liste enthält Resources. Die Liste enthält Library- Datenstrukturen. C Modula-2 Dez Beschreibung NT_MEMORY memory 10 Dies ist eine Speicherliste. NT_SOFTINT softInt 11 Die Liste enthält die /ntVector- Datenstrukturen der Soft-Interrupts. NT_FONT font 12 Die Liste enthält Font-Daten. NT_PROCESS process 13 Die Liste enthält Process- Datenstrukturen. NT_SEMAPHORE semaphore 14 Die Liste enthält Semaphore- Datenstrukturen. NT_SIGNALSEM | signalSem 15 Liste enthält SignalSemaphore- Datenstrukturen. Wenn Sie die Listen bzw. die Nodes für Ihre eigenen Zwecke benutzen, dann können Sie auf die Initialisierung dieses Feldes verzichten. Falls Sie Exec-Listen bearbeiten, kann eine fehlende Initalisie- rung manchmal zu Problemen führen. 4 Ih_pad 0x000D (13) Ein einsames Füllbyte. MemChunk Offset C (exec/memory.h) Modula-2 (Exec) struct MemChunk MemChunk = { RECORD struct MemChunk *mc_Next; next:MemChunkPtr; ULONG mc_Bytes; bytes: LONGCARD; b END; /* Freier Speicherblock */ Assembler Syntax: Strukturname = MC. Definition der Parameter ın Versalien. Datenstrukturenreferenz »Exec«: MemHeader. Routinenreferenz Keine. L_.__> Beschreibung Eine Reihe solcher Datenstrukturen bilden zusammen mit einer MemHeader-Datenstruktur, die als Kopf dient, eine Liste freier Speicherbereiche. Eine MemChunk-Datenstruktur steht am Anfang eines freien Speicherbereiches und beinhaltet einen Verkettungszeiger auf den nächsten Bereich sowie die Größe des Speicherbereichs. I mc_Next 0x0000 (0) Hier steht ein Adreßzeiger auf die nächste MemChunk- Datenstruktur in der Liste oder NULL. UI mc _Bytes 0x0004 (4) Dieses Feld gibt die Länge des Speicherbereiches an, der direkt hinter diesem Langwort beginnt. MemeEntry Modula-2 (Exec) C (exec/memory.h) struct MemEntry MemEntry = { RECORD union CASE :INTEGER OF { ULONG meu_Reags; APTR meu_Addr; } me_Un; ULONG me_Length; }; | 1:regs:MemRegSet | 2:addr: ADDRESS END; length:;LONGCARD; END; Assembler Syntax: Struktumame = ME meu_Reqs —> ME _REOS meu_Addr —> ME_ADDR me_Length—> ME LENGTH Datenstrukturenreferenz »Exec«: Memliist. Routinenreferenz Keine. > Beschreibung Als Elementeines Arrays beschreibt diese Datenstruktur am Ende einer MemList-Datenstruktur einen der Speicherbereiche, die alloziert werden sollen (siehe MemList-Datenstruktur). Vor dem Aufruf von AllocEntry muß diese Datenstruktur die Anforderungen an den zu allozierenden Speicherbereich ent- halten, nach einer erfolgreichen Allozierung finden Sie dort die Adresse des allozierten Speicher- bereiches. I meu_Reqs 0x0000 (0) Vor dem Aufruf von AllocEntry stehen hier die Flags, die die Anforderungen an den Speicher angeben (siehe »Die Memo- ry-Flags«). I meu_Addr 0x0000 (0) Hier steht nach einer erfolgreichen Allozierung die Adresse des allozierten Speicherbereiches. I me_Length 0x0004 (4) In diesem Feld wird die Länge des zu allokierenden Spei- cherbereiches in Byte angegeben. MemHeader one C (exec/memory.h) Modula-2 (Exec) struct MemHeader MemHeader = { RECORD 0000 0 struct Node mh_Node; node:Node; 000C 14 UWORD mh_Attributes; attributes:MemTypeSet; 0010 16 struct MemChunk *mh_First; first:MemChunkPitr; 0014 | 20 APTR mh_Lower; lower: ADDRESS; 0018 24 APTR mh_Upper; upper: ADDRESS; 001C 28 ULONG mh _Free; free: LONGCARD; 0020 32 I END; Assembler Syntax: Strukturname = MH Definition der Parameter in Versalien, wobei mh_Node nicht definiert ist. Datenstrukturenreferenz Keine. Routinenreferenz »EXec« : Allocate, Deallocate. _____ > Beschreibung Mit Hilfe dieser Datenstruktur und den Allocate- und Deallocate-Routinen können Sie Ihren eigenen Speicherbereich, den Sie einmal mit AllocMem alloziert haben, auch selbst verwalten. Sie ist der Kopf einer Liste von zusammenhängenden, freien Speicherbereichen, von denen jeder von einer MemChunk- Datenstruktur eingeleitet wird. Mit Allocate und Deallocate können Sie Speicherbereiche aus Ihrer Liste allozieren und wieder freigeben. UI mh_Node 0x0000 (0) Eine eingebundene Node-Datenstruktur, mit deren Hilfe Sie mehrere Speicherlisten verketten können. I mh_Attributes 0x000C (14) Einige Flags, die die Eigenschaften des Speicherbereiches beschreiben (siehe »Die MemoryFlags«). 1 mh_MemChunk 0x0010 (16) Hier steht ein Adreßzeiger auf den ersten freien Speicher- bereich (oder genauer auf die MemC'hunk-Datenstruktur, die ihn einleitet). U mh_Lower 0x0014 (20) Dieses Feld beinhaltet die unterste Adresse des gesamten, in der Liste enthaltenen Speicherbereiches. 3 mh_Upper 0x0018 (24) Die oberste Adresse des gesamten, in der Liste enthaltenen Speicherbereiches. U mh_Free 0x001C (28) Die Größe des in der gesamten Liste enthaltenen freien Speicherbereiches (also die Summe über alle MemC'hunks) der Liste. MemtList om C (exec/memory.h) Modula-2 (Exec) Hex Dez struct MemlList Memlist = { RECORD 0000 0 struct Node ml_Node; node:Node; 000E 14 UWORD ml_NumeEntries; numEntries:CARDINAL; 0010 16 struct MemEntry mI_MEI[1]; (*me:ARRAY [O..munEntries-1] OF MemEntry;*) 0018 24 1: END; Assembler Syntax: Strukturname = ML Datenstrukturreferenz Routinenreferenz L__..> Beschreibung Definition der einzelnen Parameter in Versalien, wobei mi_Node nicht definiert ist. Keine. »Exec«: AllocEntry, FreeEntry. Mit Hilfe des dieser Datenstruktur nachfolgenden Arrays von MemEntry-Datenstrukturen, kann man mit einem Aufruf von AllocEntry mehrere verschiedene Speicherbereiche allozieren und später wieder mit FreeEntry freigeben. Die Beschreibung der einzelnen Speicherbereiche steht in den MemEntry-Daten- strukturen (siehe MemEntry-Datenstruktur). Dort stehen nach einer erfolgreichen Allozierung auch die Adressen der allozierten Speicherblöcke. 4 mi_Node 0x0000 (0) u „J mli_NumeEntries 0x000E (14) I mi_ME{[1] 0x0010 (16) Dies ist eine eingebundene Node-Datenstruktur, mit deren Hilfe man mehrere MemList-Datenstrukturen verketten kann. Dieses Feld wird sowohl von AllocEntry als auch von FreeEntry ignoriert. Hier steht die Anzahl der nachfolgenden MemEntry-Daten- strukturen. Das erste Element des Arrays von MemEntry-Datenstruktu- ren (die anderen folgen direkt danach). Message KT C (exec/ports.h) Modula-2 (Exec) Hex Dez struct Message Message = { RECORD struct Node mn_Node; node:Node; struct MsgPort *mn_ReplyPort; replyPort:MsgPortPtr; UWORD mn_Length; length:CARDINAL; }; END; Assembler Syntax: Strukturname = MN Definition der einzelnen Parameter in Versalien, wobei mn_Node nicht extra definiert ist. Datenstrukturenreferenz »Audio«: IOAudio. »Clipboard«: IOClipboard, SatisfyMsg. »Dos«: DosPacket, FileHandle, StandardPacket. »Exec«: IORequest, IOStdReg. »Graphics«: TextFont. »Intuition«: IntuiMessage. »Printer« : IODRPRegq, IOPrinter. »Resources«: DiskResourceUnit. »Workbench«: WBStartup. Routinenreferenz »Exec«: PutMsg, ReplyMsg. _ > Beschreibung Diese Datenstruktur dient zur Übermittlung von Nachrichten zwischen Tasks und Prozessen. Eine Message-Datenstruktur steht normalerweise am Anfang einer anderen Datenstruktur, die die eigentliche Nachricht darstellt. Manchmal wird auch die Adresse der eigentlichen Nachricht in das Name-Feld der Node-Datenstruktur eingetragen. U mn_Node 0x0000 (0) Eine eingebundene Node-Datenstruktur, die das Verketten von mehreren Message-Datenstrukturen (z.B. in der Warte- schleife eines Messageports) ermöglicht. 3 mn_ReplyPort 0x000E (14) Die Adresse des Messageports, an den die Antwort von der Routine ReplyMsg geschickt wird. 4 mn_Length 0x0012 (18) Hier wird die Länge der eigentlichen Nachricht in Bytes eingetragen. MinList Dez struct MinList { b Assembler Datenstrukturenreferenz Routinenreferenz > Beschreibung C (execllists.h) Modula-2 (Exec) struct MinNode *milh_Head; struct MinNode *mlh_Tail; struct MinNode *mlh_TailPred; Minlist = RECORD head:MinNodePtr; tail:MinNodePtr; tailPred:MinNodePtr; END; Syntax: Strukturname = MLH Definition der einzelnen Parameter in Versalien. »Exec«: SignalSemaphore. »Graphics«: LayerlInfo. Keine. Die MinList-Datenstruktur ist eine gekürzte Version der List-Datenstruktur. Sie wird immer dann an Stelle der List-Datenstruktur als Listenheader benutzt, wenn keine Angabe über den Typ der Elemente notwendig ist. Die Elemente der Liste werden dann über MinNode-Datenstrukturen statt über Node- Datenstrukturen verkettet. I mih_Head 0x0000 (0) 3 mih_Tail 0x0004 (4) I mih_TailPred 0x0008 (8) MinNode Ein Adreßzeiger auf die erste MinNode-Datenstruktur der Liste. Dieses Feld ist immer NULL. Ein Adreßzeiger auf die letzte MinNode-Datenstruktur der Liste. C (exec/nodes.h) Modula-2 (Exec) struct MinNode | MinNode = RECORD struct MinNode *mIn_Succ; succ:MinNodePtr; b struct MinNode *mIn_Pred; pred:MinNodePtr; END; Assembler Syntax: Strukturname = MLN Definition der einzelnen Parameter in Versalien. Datenstrukturenreferenz »Exec«: MinList, SemaphoreRequest. Routinenreferenz »Exec«: AddTail, Enque, Insert, Remove. ° Beschreibung Dies ist eine vereinfachte Node-Datenstruktur. Sie kann zusammen mit der MinList-Datenstruktur zur Bildung von Listen benutzt werden. MinList und MinNode können immer dann anstelle von List und Node benutzt werden, wenn die Typen-, Prioritäts- und Namensangaben nicht benötigt werden. 4 miIn_Succ 0x0000 (0) Hier steht ein Adreßzeiger auf die Node-Datenstruktur des nächsten Elements der Liste. 4 min_Pred 0x0004 (4) Hier steht ein Adreßzeiger auf die Node-Datenstruktur des Vorgängerelements. MsgPort Offset Modula-2 (Exec) Hex Dez struct MsgPort MsgPort = { RECORD 0000 0 struct Node mp_Node; node:Node; 000E 14 UBYTE mp_Flags; CASE flags:MsgPortAction OF | signal: 000F 15 UBYTE mp_SigBit; sigBit:UByte; 0010 16 struct Task *mp_SigTask; sıgTask:TaskPtr; | softint: pad0:BYTE,; softInt:InterruptPtr; | ignore: pad1:BYTE; pad2:ADDRESS END; 0014 20 struct Lis mp_Msglbist; msgLbist:List; 0022 34 I; END; Assembler Syntax: Strukturname = MP Definition der einzelnen Parameter in Versalien, wobei mp Node nicht extra definiert ist. Datenstrukturenreferenz »ConUnit«: ConUnit. »Dos«: DosPacket, FileHandle, Process. »Exec«: ExecBase, Message, Semaphore, Unit. »Intuition«: Preferences, Window. »PrtBase«: PrinterData. »Workbench«: WBStartup. Routinenreferenz »Exec«: FindPort, GetMsg, Procure, PutMsg, RemPort, Vacate, WaitPort. »ExecSupport«: CreatePort, DeletePort, CreateExtIO, CreateStdlO. Diese Datenstruktur bildet die Grundlage für die Kommunikation zwischen verschiedenen Elementen des Multitasking. Sie definiert einen »Empfänger« (Messageport), an den Nachrichten in Form von Message-Datenstrukturen geschickt werden können. Ankommende Messages werden in einer Liste an den Port gehängt. Die erste Nachricht in der Liste kann mit der Routine GetMsg geholt und aus der Liste entfernt werden. Bei Ankunft einer Nachricht wird an den inmp_SigTask eingetragenen Task (falls er zu einem Task gehört) ein Signal gesendet. Dieser kann den Task zu verschiedenen Handlungen veranlas- sen. Eine Nachricht an einem Port kann auch einen Softwareinterrupt auslösen. I mp_Node 0x0000 (0) Eine eingebundene Node-Datenstruktur, die zur Verkettung mehrerer MsgPorts in einer Liste benutzt werden kann. Das In_Name-Feld kann dazu benutzt werden, mit der Routine FindPort einen bestimmten Port zu finden. „1 mp_Flags 0x000E (14) Dieses Feld gibt an, zu welcher Handlung der inmp_SigTask eingetragene Task durch die Ankunft einer Nachricht an diesem MsgPort veranlaßt werden soll. Hier können folgen- de Werte stehen: Modula-2 Beschreibung PA_SIGNAL signal Bei Ankunft einer Nachricht soll ein Signal geschickt werden. PA_SOFTINT softint Es soll bei Ankunft einer Nachricht ein Softwareinterrupt ausgelöst werden. PA_IGNORE ignore Bei Ankunft einer Nachricht soll nichts geschehen. I mp_SigBit 0x000F (15) Gibt die Nummer des Signalbits an, das bei Ankunft einer Nachricht am Port an den Task geschickt wird, der durch mp _SigTask bestimmt ist. Dieser kann dann z.B. eine Excep- tion auslösen, also den Wait-Zustand beenden. I mp_SigTask 0x0010 (16) | Falls mp _ Flags den Wert PA_SIGNAL hat, ist dies ein Adreßzeiger auf die Task-Datenstruktur des Tasks, für den die Nachrichten dieses Ports bestimmt sind. Sollte in mp_Flags aber PA_SOFTINT stehen, so befindet sich hier die Adresse einer entsprechenden /nterrupt-Datenstruktur. Hier kann auch NULL stehen, dann muß aber mp_Flags den I mp_MsgList 0x0014 (20) Node Wert PA_IGNORE haben, damit nicht versucht wird, an einen nicht existierenden Task ein Signal zu senden. Hier werden alle angekommenen Nachrichten in einer Liste von Message-Datenstrukturen gespeichert, bis sie durch GetMsg abgeholt werden. C (exec/nodes.h) Modula-2 (Exec) struct Node { UBYTE In_Type; BYTE In_Pri; char *In_Name; b Assembler Datenstrukturenreferenz Node = RECORD struct Node *In_Succ; succ:NodePitr; struct Node *In_Pred; pred:NodePitr; type:NodeT'ype; pri:Byte; name:ADDRESS; END; Syntax: Strukturname = LN Definition der einzelnen Parameter in Versalien. »Clipboard«: ClipboardUnitPartial. »DiskFont«: DiskFontHeader. »Exec«: IntVector, Interrupt, Library, List, Routinenreferenz ___ > Beschreibung MemHeader, MemList, Message, MsgPort, Task. »Expansion«: ConfigDev. »Graphics«: Isrvstr. »KeyMap«: KeyMapNode, KeyMapResource. »Exec«: AddTail, Enque, Insert, Remove. Diese Datenstruktur dient zur Verknüpfung der Elemente einer Liste. Die eigentlichen Elemente stehen normalerweise direkt hinter dem letzten Feld der Node-Datenstruktur. In die meisten Datenstrukturen, die zu Listen verknüpft werden, wird daher meistens als erstes Element ein Node eingebunden. Gelegentlich dient auch das /n_Name-Feld dazu, den Node mit dem Inhalt zu verbinden. Den Header einer Liste bildet immer eine List-Datenstruktur. 4 In_Succ 0x0000 (0) II In_Pred 0x0004 (4) Hier steht ein Adreßzeiger auf die Node-Datenstruktur des nächsten Elements der Liste. Hier steht ein Adreßzeiger auf die Node-Datenstruktur des Vorgängerelements. UI In_Type 0x0008 (8) In dieses Feld schreibt Exec den Typ des Elements. Die "Werte sind mit den bei List beschriebenen identisch. Es ist nur bei Exec-internen Listen von Bedeutung. 4 In_Pri 0x0009 (9) Dieses Feld gibt die Priorität an, die zwischen —-128 und 127 liegen darf. Dieser Wert ist für einige Systemdatenstruktu- ren, die als erstes Feld eine Node-Datenstruktur besitzen, von Bedeutung. So wird z.B. die Priorität eines Tasks durch das In _Pri-Feld der in die Task-Datenstruktur einge- bundenen Node-Datenstruktur bestimmt. UI In_Name 0x000A (10) Hier kann ein Adreßzeiger auf eine Zeichenkette stehen, die den Namen des Elements (z.B. Taskname), enthält. Resident Ku C (exec/resident.h) Modula-2 (Exec) He De struct Resident Resident = { RECORD 0000 0 UWORD rt_MatchWord; matchWord:CARDINAL; 0002 2 struct Resident *rt_MatchTag; matchTag:ResidentPtr; 0006 6 APTR rt_EndSkip; endSkip: ADDRESS; 000A 10 UBYTE rt_Flags; flags:ResidentFlagsSet; 000B 11 UBYTE rt_Version; version:UByte; 000C 12 UBYTE rt_Type; type:NodeType; 000D 13 BYTE rt_Pri; pri:Byte; 000E 14 char *rt_Name; name:ADDRESS; 0012 18 char *rt_IdString; idString: ADDRESS; 0016 22 APTR rt_Init; init: ADDRESS; 001A 26 }; END; Assembler Syntax: Strukturname = RT Definition der einzelnen Parameter in Versalien. Datenstrukturenreferenz »Exec«: ExecBase, Resident. Routinenreferenz »Exec«: FindResident, InitResident. D___> Beschreibung Diese Datenstruktur beschreibt ein Reset-festes Modul. Nach einem Reset wird der Speicher nach solchen Datenstrukturen abgesucht. Sie werden in eine Liste in der ExecBase eingetragen und abgearbei- tet. Dabei wird, je nach Inhalt der Datenstruktur, entweder ein Programm ausgeführt oder eine Library, Device oder Ressource erzeugt und in das System eingefügt. Mit Hilfe der Resident-Datenstruktur ist es möglich, Reset-feste Programme zu schreiben. UI rt_MatchWord 0x0000 (0) Hier muß der Wert 0x4AFC (19196) stehen, damit eine Resident-Datenstruktur als solche erkannt wird. Nach einem Reset wird nach diesem Wert gesucht, um die Resident- Datenstrukturen zu erkennen. I rt_MatchTag 0x0002 (2) Ein Adreßzeiger zurück auf den Anfang der Datenstruktur. Dieser Adreßzeiger wird bei der Suche nach Resident- Datenstrukturen überprüft, wenn das richtige MatchWord gefunden wurde. Erst wenn der MatchTag stimmt, glaubt das System, daß es auch tatsächlich eine Resident-Datenstruktur | gefunden hat. 4 rt_EndSkip 0x0006 (6) Hier steht ein Adreßzeiger auf das Ende der Datenstruktur, inklusiv der eventuell dahinter stehenden Daten. 4 rt_Flags 0x000A (10) Die hier stehenden Flags bestimmen, was bei der Abarbei- tung der Resident-Datenstruktur passieren soll. Modula-2 Dez Bedeutung RTF_COLDSTART coldstart Es soll der in rt_/nit angegebene Befehl ausgeführt werden. RTF_AUTOINIT autoinit Es soll der in rt_Type angegebene Befehl ausgeführt werden. I rt_Version 0x000B (11) Die Version der Datenstruktur. „1 rt_Type 0x000C (12) Dieses Feld enthält, falls das RTF_AUTOINIT-Flag in rt Flags gesetzt ist, den auszuführenden Befehl. Es kann sich dabei um einen der drei folgenden Werte handeln: Bedeutung Eine Device mit AddDevice hinzufügen Eine Resource mit AddResource hinzufügen Eine Library mit AddLibrary hinzufügen J rt_Pri 0x000D (13) Gibt die Priorität der Resident-Datenstruktur an. „1 rt_Name 0x000E (14) Hier kann ein Adreßzeiger auf den Namen der Resident- Datenstruktur stehen. I rt_IdString 0x0012 (18) Hier kann die Adresse eines Strings, der weitere Informatio- nen zu dieser Datenstruktur beinhaltet, stehen. I rt _Init 0x0016 (22) Entweder ein Adreßzeiger auf das auszuführende Programm oder, falls MakeLib aufgerufen wird, die Sprungtabelle der Library. | Semaphore om C (exec/semaphores.h) Modula-2 (Exec) struct Semaphore Semaphore = { RECORD struct MsgPort sm_MsgPort; msgPort:MsgPort; WORD sm_Bids; bids:INTEGER; }; END; Assembler Syntax: Strukturname = SM. Es ist nur SM_BIDS definiert. Datenstrukturenreferenz Keine. Routinenreferenz »Exec«: Procure, Vacate. I____> Beschreibung Diese Datenstruktur dient zur Koordinierung des Zugriffs mehrerer Tasks auf ein beliebiges Objekt (ähnlich wie die SignalSemaphore-Datenstruktur). Vor dem Zugriff muß jedes Task durch einen Procure-Aufruf auf einen entsprechenden Semaphore prüfen, ob schon jemand anderes auf das Objekt zugreift. Ist dies der Fall, so gibt Procure FALSE zurück. Jede Anfrage wird in Form der an Procure übergebenen Message am Ende der Messageliste in sm_MsgPort gespeichert. Wenn der Task, der gerade an der Reihe ist, seinen Zugriff beendet, und dies durch Vacate signalisiert, wird die erste in der Liste stehende Message mit Reply beantwortet. Dadurch wird dem Urheber dieser Message die Zugriffsberech- tigung mitgeteilt. Der Urheber wird durch den in der Message-Datenstruktur eingetragenen MsgPort (in mn_ReplyPort) identifiziert. 4 sm_MsgPort 0x0000 (0) Eine eingebundene MsgPort-Datenstruktur, die zur sequen- tiellen Speicherung der Message-Datenstrukturen Zugriffs- anfragen dient. J sm_Bids 0x0022 (34) Jedesmal, wenn der Benutzer, der gerade das Zugriffsrecht hat Procure aufruft, wird dieser Zähler inkrementiert. Wird dagegen Vacate aufgerufen, so wird er dekrementiert. Das Objekt wird erst dann für andere freigegeben, wenn sm_Bids 0 ist. SemaphoreRequest C (exec/semaphores.h) Modula-2 (Exec) struct SemaphoreRequest SemaphoreRequest = { RECORD struct MinNode sr_Link; link:MinNode; struct Task *sr_Waiter; waiter:TaskPtr; }; END; Assembler Datenstrukturenreferenz Routinenreferenz Beschreibung Syntax: Strukturname = SSR Es ist nur SSR_WAITER definiert. »Exec«: SignalSemaphore. Keine. Die SemaphoreRegquest-Datenstruktur wird von Exec benutzt, um eine Zugriffsanforderung an einen SignalSemaphore zu speichern. Alle Anfragen, die an einen SignalSemaphore gerichtet werden und noch nicht erledigt wurden, werden in einer verketteten Liste solcher Datenstrukturen gespeichert. Sie werden über das sr_Link-Feld zu einer MinList-Liste verbunden. 4 sr_Link 0x0000 (0) 4 sr_Waiter 0x0008 (8) SignalSemaphore Dient zur Verkettung der einzelnen Datenstrukturen. Ein Adreßzeiger auf die Task-Datenstruktur des Task, der die Anforderung geschickt hat. C (exec/semaphores.h) Modula-2 (Exec) struct SignalSemaphore SignalSemaphore = { RECORD struct Node ss_Link; link:Node; SHORT ss_NestCount; nestCount:INTEGER; struct MinList ss_WaitQueue; waitQueue:MinlList; struct SemaphoreRequest multipleLink: ss_MultipleLink; SemaphoreRequest; struct Task *ss_Owner; owner:TaskPtr; b Assembler Datenstrukturenreferenz Routinenreferenz ___ > Beschreibung SHORT ss_QueueCount; queueCount:INTEGER; END; Syntax: Strukturname = SS Definition der Parameter in Versalien, wobei ss_Link nicht definiert ist. »Graphics«: Layer, LayerlInfo. »Intuition«: IntuitionBase. »Exec«: AddSemaphore, AttemptSemaphore, FindSemaphore, InitSemaphore, ObtainSemaphore, ReleaseSemaphore, RemSemaphore. Diese Datenstruktur dient zur Koordinierung des Zugriffs mehrerer Tasks auf ein beliebiges Objekt (ähnlich wie die Semaphore-Datenstruktur). Ein solcher SignalSemaphore kann mit der Routine /nit$e- maphore eingerichtet werden. Ein Task, der auf das von der SignalSemaphore-Datenstruktur beschützte Objekt zugreifen will, siganlisiert dies mit ObtainSemaphore bzw. AttemptSemaphore. Nach beendetem Zugriff wird dann ReleaseSemaphore aufgerufen, damit das Objekt für andere Benutzer zugänglich wird. Dieser Mechanismus wird von Intuition genutzt, um die Layers (Bestandteile der Videoanzeige) zu verwalten. 1 ss Link 0x0000 (0) Mit Hilfe dieser eingebundenen Node-Datenstruktur kön- nen mehrere SignalSemaphore-Datenstrukturen zu einer Liste verkettet werden. „4 ss_NestCount 0x000E (14) Falls ein Benutzer, der bereits das Zugriffsrecht hat, weitere Anforderungen schickt, wird dieser Zähler inkrementiert. I ss _WaitQueue 0x0010 (16) In dieser Liste werden die SemaphoreRequest-Datenstruk- turen abgelegt, in denen sich die vorliegenden Anfragen befinden. 4 ss _MultipleLink 0x001C (28) Wörtlich übersetzt: »Mehrfache Verbindung« ??? UI ss _Owner 0x0028 (40) Ein Adreßzeiger auf die Task-Datenstruktur, des Tasks, der diesen SignalSemaphore eingerichtet hat. I ss _ QueueCount 0x002C (44) Die Anzahl der in WaitQueue vorliegenden Anfragen. SoftintList struct SoftIntList SoftIntList = { RECORD C (exec/interrupts.h) Modula-2 (Exec) struct List sh_List; list:List; UWORD sh_Pad; pad: WORD; H END; Assembler Syntax: Strukturname = SH Der Parameter sh_List ist nicht extra definiert. Datenstrukturenreferenz »Exec«: ExecBase. Routinenreferenz Keine. ___> Beschreibung Eine Exec-interne Datenstruktur, die als Listenheader einer Liste der Software-Interrupts benutzt wird. Eine solche Datenstruktur befindet sich in der ExecBase. 4 sh_List 0x0000 (0) Eine eingebundene List-Datenstruktur, die als Listenheader benutzt wird. „1 sh_Pad 0x000E (14) Ein Füllbytechen. Task Offset C (exec/tasks.h) Modula-2 (Exec) extern struct Task Task = { RECORD 0000 0 struct Node tc_Node; node:Node; 000E 14 UBYTE tc_Flags; flags:TaskFlagSet; 000F 15 UBYTE tc_State; state:TaskState; 0010 16 BYTE tc_IDNestCnt; idNestCnt:Byte; 0011 17 BYTE tc_TDNestCnt; tdNestCnt:Byte; 0012 18 ULONG tc_SigAlloc; sigAlloc:LONGSET; 0016 22 ULONG tc_SigWait; sigWait:LONGSET,; 001A 26 ULONG tc_SigRecvd; sigRecvd:LONGSET; 001E 30 ULONG tc_SigExcept; sigExcept:LONGSET; 0022 34 UWORD tc_TrapAlloc; trapAlloc:BITSET,; 0024 36 UWORD tc_TrapAble; trapAble:BITSET; 0026 38 APTR tc_ExceptData; exceptData: ADDRESS; 002A 42 APTR tc_ExceptCode; exceptCode:PROC; 002E 46 APTR tc_TrapData; trapData: ADDRESS; 0032 50 APTR tc_TrapCode; trapCode:PROC; 0036 54 APTR tc_SPReg; spReg: ADDRESS; 003A 58 APTR tc_SPLower; spLower: ADDRESS; 003E 62 APTR tc_SPUpper; spUpper: ADDRESS; 0042 66 VOID (*tce_Switch)(); switch:PROC; 0046 70 VOID (*tc_Launch)(); launch:PROC; 004A 74 struct List tc_MemEntry; memEntry:List; 0058 88 APTR tc_UserData; userData: ADDRESS; 005C 92 }; END; Strukturname = TC Assembler Syntax: Definition der einzelnen Parameter in Versalien (bis auf TC_UserData), wobei tc_Node nicht extra definiert ist. Datenstrukturenreferenz »Dos«: Process. »Exec«: ExecBase, MsgPort, SignalSemaphore. »Graphics«: GfxBase. »PrtBase«: PrinterData. Routinenreferenz »Exec«: AddTask, FindTask, RemTask, SetTaskPri, Signal. »ExecSupoort«: CreateTask, DeleteTask. ___> Beschreibung Diese Datenstruktur beschreibt einen Task. Sie enthält alle Informationen, die das Multitasking für das Ein- und Ausschalten sowie die Behandlung der Traps und Exceptions braucht. U tc_Node 0x0000 (0) 1 tc_Flags 0x000E (14) TF_PROCTIME TF_STACKCHK TF_EXCEPT TF_SWITCH TF_LAUNCH tc_State 0x000F (15) C TS_INVALID TS_ADDED TS_RUN TS_READY TS_WAIT TS_EXCEPT TS_REMOVED I te_IDNestCnt 0x0010 (16) I te_TDNestCnt 0x0011 (17) Eine gewöhnliche Node-Datenstruktur, die zur Verkettung mehrerer Tasks zu einer Liste (z.B. in der ExecBase-Daten- struktur) dient. Dies sind Flags, die den momentanen Zustand des Task beschreiben. Es ist jede Kombination der folgenden Bits zugelassen: Modula-2 Hex Dez Beschreibung procTime ?7? stackChk Der Taskstack wird überprüft. exception Es ist eine Exception aufgetreten. switch Der Task verliert den Prozessor. launch Der Task wird gerade einge- schaltet. Diese Flags beschreiben den Task näher. Es sind Kombina- tionen folgender Werte zugelassen: Modula-2 Dez Beschreibung invalid 0 Der Task ist ungültig. added 1 Der Task wurde dem System gerade hinzugefügt. run 2 Der Task läuft gerade. ready 3 Der Task ist bereit, wartet auf den Prozessor. wait 4 Der Task wartet auf ein Signal. Er braucht also bei der Vergabe der Prozessorzeit nicht berücksichtigt zu werden. except 5 Der Task behandelt gerade eine Exception. removed 6 Der Task wurde vom System entfernt. Ein Zähler für die Anzahl der Disable-(wird inkrementiert) und Znable-(wird dekrementiert)Aufrufe. Erst wenn ID_NestCnt O ist, wird ein Interrupt zugelassen. Ein Zähler für die Anzahl der Forbid-(wird inkrementiert) und Permit-(wird dekrementiert)Aufrufe. Erst wenn TD_NestCnt ist, wird das Multitasking wieder eingeschal- tet, der Task kann also den Prozessor verlieren. tc_SigAlloc 0x0012 (18) tc_SigWait 0x0016 (22) tc_SigRecvd 0x001A (26) tc_SigExcept 0x001E (30) tc_TrapAlloc 0x0022 (34) tc_TrapAble 0x0024 (36) tc_ExceptData 0x0026 (38) tc_ExceptCode 0x002A (42) tc_TrapData 0x002E (46) tc_TrapCode 0x0032 (50) tc_SPReg 0x0036 (54) tc_SPLower 0x003A (58) tc_SPUpper 0x003E (62) tc_Switch 0x0042 (66) tc_Launch 0x0046 (70) tc_MemEntry 0x004A (74) tc_UserData 0x0058 (88) Jedes gesetzte Bit dieses Feldes bedeutet, daß das Signal mit der gleichen Nummer allokiert wurde. Jedes gesetzte Bit in diesem Feld entspricht einem Signal, auf dessen Ankunft der Task wartet. Sobald nur eines dieser Signale emfangen wird, wird der Wait-Zustand beendet. Die Nummern der hier gesetzten Bits entsprechen den Nummern der Signale, die empfangen wurden. Die Nummern der hier gesetzten Bits entsprechen den Nummern der Signale, die eine Exception auslösen. Die Nummern der hier gesetzten Bits entsprechen den Nummern der Traps, die allokiert wurden. Dies heißt, daß beim Auftreten des entsprechenden Prozessortraps die in Trapcode angegebene Funktion aufgerufen wird. Die Nummern der hier gesetzten Bits entsprechen den Nummern aktiver Traps. Ein Adreßzeiger auf den Datenbereich der Exceptionroutine. Diese Adresse wird an den Exceptionhandler in Al überge- ben. Ein Adreßzeiger auf die Routine, die beim Auftreten einer Exception aufgerufen wird. Sie bekommt in DO die Nummer des für die Exception verantwortlichen Signals. Dieser Wert muß vor dem Verlassen des Handlers mit RTS wieder in DO geladen werden. Ein Adreßzeiger auf den Datenbereich der Trap-Routine. Ein Adreßzeiger auf den Code des Trap-Handlers. Er muß in dem Supervisormodus laufen können. Dies ist der Stackpointer des Task. Dies ist die Adresse der unteren Grenze des Task-eigenen Stacks. Dies ist die Adresse der oberen Grenze des Task-eigenen Stacks. Ein Adreßzeiger auf die Routine, die aufgerufen wird, wenn ein Task ausgeschaltet wird. Ein Adreßzeiger auf eine Routine, die beim Einschalten des Tasks aufgerufen wird. Die Liste der für den Task allokierten Speicherbereiche. Beim Entfernen des Task werden alle diese Bereiche freige- geben. Dieser Adreßzeiger steht dem Programmierer für eigene Zwecke zur Verfügung. Unit Ki C (exec/devices.h) Modula-2 (Exec) struct Unit Unit = [ RECORD struct MsgPort *unit_MsgPort; msgPort:MsgPortPtr; UBYTE unit_flags; flags:UnitFlagSet; UBYTE unit_pad; pad:BYTE,; UWORD unit_OpenCht; openCnt:CARDINAL; }; END; Assembler Syntax: Strukturname = UNIT. Definition der einzelnen Parameter in Versalien, wobei unit_MsgPort nicht definiert ist. Datenstrukturenreferenz »Clipboard«: IOClipboard. »Exec«: IORequest, IOStdReg. »Trackdisk«: TDU_PublicUnit. Routinenreferenz Keine. Beschreibung Diese Datenstruktur wird bei der Verwaltung der Devices und Resources benutzt, um ein bestimmtes Gerät zu identifizieren. Dies kann ein echtes Hardwaregerät wie z.B. ein konkretes Laufwerk, oder einfach eine abstrakte Einheit sein (z.B. bei dem Clipboard-Device). 1 unit_MsgPort 0x0000 (0) Ein MsgPort, an dem Anfragen (Messages) an dieses Gerät gerichtet und in der Messageliste bis zur Bearbeitung gespei- chert werden. J unit_Flags 0x0004 (4) Dies sind geräteinterne Flags. Zwei Flags sind für dieses Feld vordefiniert: Modula-2 Dez Beschreibung UNITTF_ACTIVE active Das Gerät ist aktiv. UNITTF_INTASK inTask Das Gerät ist gerade beschäftigt ? J unit_pad 0x0005 (5) Noch ein letztes Füllbyte. 4 unit_ÖpenCnt 0x0006 (6) Dieses Feld gibt an, wie oft dieses Unit schon göffnet wurde (z.B. wie oft schon eine Trackdisk-Device auf ein konkretes Laufwerk geöffnet wurde). wen AN N eat . tet, ee ee = £ LALLL. Abb. 3.1: Die ExecBase-Datenstruktur Eine eingebundene Library-Datenstruktur Eine eingebundene Node-Datenstruktur zur Verkettung der geöffneten Libraries Ein Adreßzeiger auf die nächste geöffnete Library Ein Adreßzeiger auf die vorher geöffnete Library Ein Adreßzeiger auf die Task- Datenstruktur des momentan aktiven Tasks Eine eingebundene List-Datenstruktur zur Verwaltung des Speichers Eine eingebundene List-Datenstruktur zur Verwaltung der Resources Eine eingebundene List-Datenstruktur zur Verwaltung der geöffneten Devices Eine eingebundene List-Datenstruktur zur Verknüpfung der Interrupts Eine eingebundene List-Datenstruktur zur Verwaltung der geöffneten Libraries Eine eingebundene List-Datenstruktur zur Verwaltung der aktiven Ports Eine eingebundene List-Datenstruktur zur Verkettung der Tasks, die sich im Ready-Zustand befinden Eine eingebundene List-Datenstruktur zur Verkettung der Tasks, die sich im Wait-Zustand befinden Die ExecBase-Datenstruktur [/ a U U U / Der typische Aufbau einer Liste, bestehend aus einer N List Y List- und mehreren Node-Datenstrukturen VLILLLLLLE j 11h_Head VEIZEEIZEIR Un AB Tail ee PIISFFFFFFZ Node Node Node Node > DE > > An succ_ Succ Y A Succ Y rn Succ = ‚en _Succ y din_Pred| ia) dIn_Pred | u m— zn m I we ea] me rt en) rt Abb. 3.2: Der Aufbau einer Liste Wurde die Intuition- und Graphics-Library geöffnet, so können die zugehörigen xxxBase-Datenstrukturen wie abgebildet verknüpft sein N ExecBase VRR N er ee ehe Den ernennen We Tossene } mu) X > 7 EL nn Kr EEE Node SSNNN = SETTETTTTETERN :N Node I NSS In_Succ TITLE, B T: u SIT ; NR ERISSSSSSTTTSTEESEUNS N N N lib_Node EIIIDININSN IIIIIIIN In_succ WAL & Fi LE, 2 17:3 ESECHEETETTTETTTTETTE ee 2 7 D FIT TIEF? CL G 2A m 110 rg Y ® n. VA N Zen aa E77 ehe Oel A PIE? een, rennen nepreteen erregt Abb. 3.3: Die Verknüpfung der Libraries Eine Beliebige Struktur, die die Nachricht beinhaltet r ELLE EL LL Nachricht Empfängertask f LLLLLLLLLN c ( rask Y VAN i LG Zielport en nn ne nn en 7 77 I ann 7 7 A mp MsgList RER Ä Message 77 ZIZELTEIL,) DALE LET % ee 7% HERE: G ._ VEEEIDEREELEIEEEIEEE I — > WEEZE 0, Sendertask EEE Eingebundene nt 7 7 Message VEIILEZ. / fe sigreva Y Message wird mit PutNsd// ZU, Name oder weitere Port für Antwort Daten VELLLLLLLLT 4 als Antwort an den sender Imp sigrask F zurückgeschickt VZRRZZerIIN, , VTLFZLLFTLL =” PGRRRRERGG, A EEE WE 7 = age 78 VILLELELTELLT N III SIT ISDN Abb. 3.4: Die Nachrichtenübermittlung zwischen Tasks DIE INTUITION-LIBRARY In dieser Library sind alle die Systemroutinen und Datenstrukturen zusammengefaßt, die mit der Benutzeroberfläche zu tun haben. In ihr sind nicht nur die Screens (von manchen auch Bildschirme genannt), Windows (Fenster kann man auch mal dazu sagen), Requester und Gadgets definiert (Commo- dores »Sales Support Information« betreffend der Übersetzungsrichtlinien von Amiga-Begriffen sagt dazu übrigens Kommunikationsfenster und Symbolfeld), sondern auch einige einfache Routinen zur Ausgabe von Texten und Grafiken. 4.1 Wichtige Flags der Intuition-Library In diesem Abschnitt werden alle die Flags der Intuition-Library genauer beschrieben, die in mehreren Datenstrukturen verwendet werden. Die IDCMP-Flags (intuition/intuition.h) (Intuition) C Modula-2 Hex SIZEVERIFY sizeVerify 00000001 Eine Meldung über das Verändern der Größe des Fensters, jedoch wartet »Intuition« mit der Ausführung, bis auf die Message durch die Routine ReplyMsg geantwortet wurde. NEWSIZE newSize 00000002 Eine Meldung darüber, daß die Größe des Fensters bereits verändert wurde. REFRESHWINDOW refreshWindow 00000004 Eine Meldung über die Notwendigkeit, einen Refresh durchzuführen. MOUSEBUTTONS mouseButtons 00000008 Eine Meldung über das Betätigen der Maustasten. MOUSEMOVE mouseMove 00000010 Eine Meldung über das Bewegen der Maus. Modula-2 GADGETDOWN gadgetDown 00000020 Eine Meldung über ein momentan angeklicktes Gadget. GADGETUP gadgetUp 00000040 Eine Meldung über ein wieder losgelassenes Gadget. REOSET regSet 00000080 Eine Meldung über die Öffnung eines Requesters. MENUPICK menuPick 00000100 Eine Meldung über das Drücken der rechten Maustaste. CLOSEWINDOW closeWindow 00000200 Eine Meldung über das Anklicken des Close-Gadgets. RAWKEY rawKey 00000400 Eine Tastaturmeldung im Raw-Code. In der /ntuiMessage-Datenstruktur steht bei einer Systemnachricht der Raw-Code der gedrückten Taste in dem Feld Code. REOVERIFY req Verify 00000800 Eine Meldung über das Öffnen eines Requesters, jedoch wartet »Intuition« mit der Ausführung, bis auf die Message durch die Routine ReplyMsg geantwortet wurde. REOCLEAR reqClear 00001000 Eine Meldung über das Schließen des letzten Requesters. MENUVERIFY menuVerify 00002000 Eine Meldung über das Zeichnen eines Pull-down-Menüs, jedoch wartet »Intuition« mit der Darstellung des Menüs, bis auf die Message durch die Routine ReplyMsg geantwortet wurde. Modula-2 NEWPREFS newPrefs 00004000 Eine Meldung über den Versuch des Benutzers, die Preferences-Einstellungen zu verändern. DISKINSERTED diskInserted 00008000 Eine Meldung über das Einlegen einer Diskette in ein Laufwerk. DISKREMOVED diskRemoved 00010000 Eine Meldung über das Entfernen einer Diskette aus einem Laufwerk. WBENCHMESSAGE wbenchMessage 00020000 Eine Meldung der Workbench. ACTIVEWINDOW activeWindow 00040000 Eine Meldung über das Aktivieren dieses Fensters. INACTIVEWINDOW inactiveWindow 00080000 Eine Meldung über das Inaktivieren dieses Fensters. DELTAMOVE deltaMove 00100000 Die Mausbewegungen werden relativ zu der letzten Mausposition angegeben. Dies geschieht auch, wenn sich der Zeiger nicht mehr über dem Fenster befindet. VANILLAKEY vanillaKey 00200000 Eine Tastaturmeldung im ASCH-Code. In der /ntuiMessage-Datenstruktur steht bei einer Systemnach- richt der ASCII-Code der gedrückten Taste gemäß der momentanen Keymap in dem Feld Code. INTUITICKS intuiTicks 00400000 Eine ständige aktuelle Systemnachricht. »Intuition« hält dabei bis zu zehnmal pro Sekunde eine IntuiMessage-Datenstruktur bereit, die jedoch nicht gepuffert wird. Eine neue Nachricht gibt es nur, wenn auf die vorherige durch die Routine ReplyMsg geantwortet wurde. Modula-2 LONELYMESSAGE lonelyMessage 80000000 Ein einsames Systeminternes Bit. Datenstrukturenreferenz »Intuition«: IntuiMessage, NewWindon. ° Beschreibung Die IDCMP-Flags gehören zu dem »Intuition Direct Comunication Message Port«, einem besonderen Messageport, über den Informationen über die Windows gesendet werden. In der NewWindow-Daten- struktur definieren diese Flags, bei welchen Ereignissen eine Message losgeschickt wird. In der /ntui- Message-Datenstruktur dagegen definieren diese Flags, welches Ereignis eingetreten ist. Wird zum Beispiel beim Öffnen eines Windows SIZEVERIFY gesetzt, so wird jedesmal, wenn der Benutzer die Größe dieses Fensters verändert, eine /ntuiMessage-Datenstruktur bereitgestellt, bei der in Class SIZEVERIFY gesetzt ist. Die Screen-Flags (intuition/intuition.h) (Intuition) Definierte Konstanten: Modula-2 SCREENTYPE Das untere Nibbel enthält die Informationen über die Art des Screens. CUSTOMSCREEN customScreen 000F Der zugehörige Bildschirm ist kein Workbench-Screen. STDSCREENHEIGHT stdScreenHeight FFFF Der zugehörige Bildschirm hat die Standardhöhe von 256 Zeilen. Definierte Bits Modula-2 WBENCHSCREEN wbenchScreen Der zugehörige Bildschirm ist ein Workbench-Screen. SHOWTITLE showTitle 0010 Die Titelleiste des zugehörigen Bildschirms wird mitausgegeben. BEEPING beeping 0020 Der zugehörige Bildschirm kann blinken bzw. blinkt gerade. CUSTOMBITMAP customitMap 0040 Der zugehörige Bildschirm hat eine eigene Bitmap. SCREENBEHIND screenBehind 0080 Beim Öffnen ist der Bildschirm im Hintergrund. SCREENQUIET screenQuiet 0100 Zu diesem Bildschirm gehören keine Gadgets. Datenstrukturenreferenz »Intuition«: NewScreen, NewWindow, Screen. ___> Beschreibung Die Screen-Flags enthalten Informationen über die Eigenschaften eines Bildschirms. Die Window-Flags (intuition/intuition.h) (Intuition) Definierte Konstanten Modula-2 SMART REFRESH 00000000 Ein Refresh wird nur notwendig, wenn das Fenster vom Benutzer verkleinert und anschließend wieder vergrößert wurde. REFRESHBITS 000000C0 Die Bits, die den Refresh-Modus für dieses Fenster festlegen. OTHER_REFRESH otherRefresh 000000C0 Refresh für SUPER_BITMAP-Windows, also Fenster mit eigenen Bitmaps. SUPER UNUSED superUnused FCFCO0000 Eine Kombination aller unbenutzten Bits der Window-Flags ergibt die »Super-Unbenutzten-Flags«. Definierte Bits Modula-2 WINDOWSIZING windowSizing 00000001 Das Sizing-Gadget erscheint in der unteren rechten Ecke (die Fenstergröße kann verändert werden). WINDOWDRAG windowDrag 00000002 Die Titelleiste wird zu einem Drag-Gadget (das Fenster ist verschiebbar). WINDOWDEPTH windowDepth 00000004 Die Depth-Gadgets erscheinen in der rechten, oberen Ecke (das Fenster kann in den Vorder- oder Hintergrund geschaltet werden). WINDOWCLOSE windowClose 00000008 Das Close-Gadget erscheint in der linken oberen Ecke. Wird es durch den Mauspfeil aktiviert, schließt sich das Fenster jedoch nicht automatisch. Es wird lediglich eine entsprechende Systemnachricht bereitgestellt. Modula-2 SIZEBRIGHT sizeBRight 00000010 Das Sizing-Gadget gehört zum rechten Fensterrand (voreingestellt). SIZEBBOTTOM sıizeBBottom 00000020 Das Sizing-Gadget gehört zum unteren Fensterrand. SIMPLE REFRESH simpleRefresh 00000040 Es wird kein zusätzlicher Speicher für den Refresh bereitgehalten. Dadurch muß der Inhalt des Fensters nach Überlappungen mit anderen Fenstern oder nach einer Vergrößerung jedesmal neu aufgebaut werden. SUPER _BITMAP superBitMap 00000080 Es existiert eine eigene Bitmap, die groß genug ist, den gesamten Fenster-Inhalt aufzunehmen. Bei UÜberlappungen mit anderen Fenstern oder bei Veränderungen der Größe ist somit kein Refresh notwen- dig. BACKDROP backDrop 00000100 Das Fenster bleibt immer ım Hintergrund. REPORTMOUSE reportMouse 00000200 Es werden Systemnachrichten über die Mausbewegungen innerhalb dieses Fensters bereitgestellt. GIMMEZEROZERO gimmeZeroZero 00000400 Dieses Fenster ist ein GimmeZeroZero-Window (Koordinatenursprung liegt in der inneren linken, oberen Ecke, von den Höhen- und Breitenwerten des Fensters werden also die Rahmen abgezogen). BORDERLESS borderless 00000800 Das Fenster erhält keinen Rahmen. ACHTUNG: Sind System-Gadgets aktiviert, so werden zugehörige Ränder trotzdem ausgegeben. Modula-2 ACTIVATE activate 00001000 Das Fenster wird sofort nach dem Öffnen aktiviert. ACHTUNG: Macht der Benutzer gerade eine Eingabe, so wird diese auf das neue Fenster umgeleitet. WINDOWACTIVE window Active 00002000 Das Fenster ist momentan aktiv. INREQUEST inRequest 00004000 Das Fenster ist durch mindestens einen Requester gesperrt. MENUSTATE menusState 00008000 Ein Menüpunkt wird gerade ausgewählt. RMBTRAP rmbTrap 00010000 Über das Drücken der rechten Maustaste wird eine Message erstellt, eine Menüauswahl ist daher nicht möglich. NOCAREREFRESH noCareRefresh 00020000 Es werden keine Systemnachrichten über die Notwendigkeit eines Refreshs bereitgestellt. WINDOWREFRESH windowRefresh 01000000 An dem Fenster wird momentan ein Refresh durchgeführt. WBENCHWINDOW wbenchWindow 02000000 Das Fenster ist auf der Workbench geöffnet. WINDOWTICKED windowTicked 04000000 Systeminternes Bit. Datenstrukturenreferenz »Intuition«: NewWindow, NewScreen. Die Window-Flags enthalten Informationen über die Eigenschaften eines Fensters. 4.2 Die Datenstrukturen der Intuition-Library Boolinfo Offset C (intuition/intuition.h) Modula-2 (Intuition) Hex Dez struct Boollnfo BoollInfo = { RECORD USHORT Flags; flags:BITSET,; UWORD *Mask; mask: ADDRESS; ULONG Reserved; reserved:LONGCARD; }; END; Assembler Präfix: bi Datenstrukturenreferenz »Intuition«: Gadget. Routinenreferenz Keine. Beschreibung Dies ist eine zusätzliche Datenstruktur für Boolean-Gadgets (für ja/nein Entscheidungen wie »OK« oder »Cancel«) und sogenannten Boolean-Toggle-Gadgets (Ein- und Ausschalten von bestimmten Funktio- nen). I Flags 0x0000 (0) Es ist nur folgende Konstante vereinbart: C Modula-2 Hex Beschreibung BOOLMASK boolMask 0001 Ist immer gesetzt, da bis jetzt dies die einzige Definition ist. I] Mask 0x0002 (2) Ein Adreßzeiger auf eine /mage-Datenstruktur, die das Gra- fiksymbol beschreibt, das bei der Auswahl dieses Gadgets auf dem Display erscheint. 1 Reserved 0x0006 (6) Reservierter Adreßzeiger für zukünftige Erweiterungen. In den vorliegenden Versionen immer auf NULL setzen. C (intuition/intuition.h) Modula-2 (Intuition) struct Border Border = { RECORD 0 SHORT LeftEdge; leftEdge:INTEGER; 2 SHORT TopEdge; topEdge:INTEGER; 4 UBYTE FrontPen; frontPen:UByte; 5 UBYTE BackPen; backPen:UByte; 6 UBYTE DrawMode; drawMode:DrawModeSet; 7 BYTE Count; count:UByte; 8 SHORT *XY; xy:ADDRESS; 12 struct Border *NextBorder; nextBorder:BorderPtr; 16 I: END; Assembler Präfix: bad Datenstrukturenreferenz »Intuition«: Border, Requester. Routinenreferenz »Intuition«: DrawBorder. L___> Beschreibung In dieser Datenstruktur werden die Informationen über einen zu zeichnenden Rahmen für die DrawBor- der-Routine bereitgehalten. Dabei handeltes sich eigentlich um einen beliebigen Linienzug, mitdem man natürlich auch einen rechteckigen Rahmen zeichnen kann. I LeftEdge 0x0000 (0) Die zu der x-Koordinate, die beim Aufruf in der DrawBor- der-Routine angegeben wird, relative x-Koordinate des Basispunktes, der für das Zeichnen dieses Linienzuges als Ursprung dient. I TopEdge 0x0002 (2) Die zu der y-Koordinate, die beim Aufruf in der DrawBor- der-Routine angegeben wird, relative y-Koordinate des Basispunktes, der für das Zeichnen dieses Linienzuges als Ursprung dient. 1 FrontPen 0x0004 (4) Die Nummer des Farbregisters, dessen Inhalt als Vorder- grundfarbe verwendet wird. I BackPen 0x0005 (5) Die Nummer des Farbregisters, dessen Inhalt als Hinter- grundfarbe verwendet wird. 1 DrawMode 0x0006 (6) Der Zeichenmodus, mit dem der Rahmen gezeichnet werden soll. Zur Verfügung stehen JAMI (Zeichnen mit der Vorder- grundfarbe) und XOR (Zeichnen durch D invertieren). SJ Count 0x0007 (7) Anzahl der Koordinatenpaare, die in XY gespeichert sind. I XY 0x0008 (8) Dies ist ein Adreßzeiger auf eine Liste mit x- und y-Koordi- | natenpaaren. Jedes Koordinatenpaar definiert einen Eck- punkt des Linienzuges, und zwar relativ zu dem durch LeftEdge und TopEdge definierten Basispunkt. 1 NextBorder 0x000C (12) Sollen mit dem gleichen Aufruf noch mehr Linienzüge gezeichnet werden, so können über diesen Adreßzeiger mehrere Border-Datenstrukturen miteinander verknüpft werden. Steht hier NULL, so ist das Ende der Liste erreicht. FatiIntuiMessage om C (intuition/intuitionbase.h) Modula-2 (Intuition) struct FatIntuiMessage FatIntuiMessage = m RECORD struct IntuiMessage; intuiMessage:IntuiMessage; ULONG PrevKeys; prevKeys:LONGCARD; } END; Assembler Diese systeminterne Datenstruktur ist in Assembler nicht definiert. Datenstrukturenreferenz Keine. Routinenreferenz Keine. ...> Beschreibung Bei dieser systeminternen Datenstruktur handelt es sich um eine /ntuiMessage-Datenstruktur, die um einen Parameter erweitert wurde. I IntuiMessage 0x0000 (0) Einbindung einer vollständigen /ntuiMessage-Datenstruk- tur. I PrevKeys 0x0034 (52) Interner Systemparameter um den die /ntuiMessage-Daten- struktur erweitert wurde — aber was für einer? Gadget Offset C (intuition/intuition.h) Modula-2 (Intuition) Hex Den | struct Gadget Gadget = { RECORD struct Gadget *NextGadget; nextGadget:GadgetPtr; SHORT LeftEdge; leftEdge:INTEGER; C (intuition/intuition.h) Modula-2 (Intuition) SHORT TopEdge; topEdge:INTEGER; SHORT Width; width:INTEGER; SHORT Height; height:INTEGER; USHORT Flags; flags:GadgetFlagSet; USHORT Activation; activation:ActivationFlagSet; USHORT GadgetType; gadgetType:CARDINAL; APTR GadgetRender; gadgetRender: ADDRESS; APTR SelectRender; selectRender: ADDRESS; struct IntuiText *GadgetText; gadgetText:IntuiTextPtr; LONG MutualExclude; mutualExclude:LONGSET; APTR Speciallnfo; speciallnfo: ADDRESS; USHORT GadgetlD; gadgetID:INTEGER; APTR UserData; userData: ADDRESS; }; END; Assembler Präfix: 88_ Datenstrukturenreferenz »Intuition«: DiskObjekt, Gadget, GadgetInfo, IntuitionBase, NewScreen, NewWindow, Requester, Screen, Window. RoutinenReferenz »Intuition«: ActivateGadget, AddGadget, AddGList, ModifyProp, NewModifyProp, OffGadget, OnGadget, RefreshGadgets, RefreshGList, RemoveGadget, RemoveGList. 2? Beschreibung Die Gadgets sind einem Window zugeordnete Felder, die durch Anklicken mit der Maus eine Aktion auslösen können. Neben den bekannten System-Gadgets, wie Close-, Depth- und Sizing-Gadget, können zu jedem Displayelement beliebige Gadgets über diese Datenstruktur definiert werden. Dabei gibtes drei verschiedene Arten: Boolean-, Proportional- und String-Gadgets (siehe auch: BoolInfo-, PropInfo- und StringInfo-Datenstruktur. I NextGadget 0x0000 (0) Gehören mehrere Gadget-Datenstrukturen zu diesem Dis- playelement, so werden sie über diesen Adreßzeiger mitein- ander zu einer linearen Liste verknüpft. Das letzte Glied dieser Kette muß an dieser Stelle den Wert NULL haben. I LeftEdge 0x0004 (4) Der Abstand des Gadgets vom linken Rand des zugehörigen Displayelements. Die Bedeutung dieses Wertes hängt von dem Bit GRELRIGHT aus Flags ab. II TopEdge 0x0006 (6) Der Abstand des Gadgets vom oberen Rand des zugehörigen Displayelements. Die Bedeutung dieses Wertes hängt von dem Bit GRELBOTTOM aus Flags ab. | II Width 0x0008 (8) Die Breite des Gadgets. Die Bedeutung dieses Wertes hängt von dem Bit GRELWIDTH aus Flags ab. I] Height 0x000A (10) Die Höhe des Gadgets. Die Bedeutung dieses Wertes hängt Ä von dem Bit GRELHEIGHT aus Flags ab. U Flags 0x000C (12) Gesetzte Flags haben folgende Bedeutung: C Modula-2 Hex Beschreibung GADGHIGHBITS gadgHighbits 0003 Für diese zwei Bits sind folgende 4 | Möglichkeiten des Highlightnings definiert: GADGHCOMP gadgetHComp 0000 00: Invertieren aller Bits in diesem Gadget. GADGHBOX gadgHBox 0001 01: Gadget mit einem Auswahlkasten umranden. GADGHIMAGE gadgHlmage 0002 10: Ausgabe einer anderen Image- oder Border-Datenstruktur. GADGHNONE gadgHNone 0003 11: Wird dieses Gadget ausgewählt, so wird sein Erscheinungsbild nicht verändert. GADGIMAGE gadglmage l: Gadget wird als »Image« ausgegeben. 0: Gadget wird als »Border« ausgegeben. Beachte auch: GadgetRender und SelectRender. GRELBOTTOM gRelBottom TopEdge ist relativ zum unteren Rand dieses Displayelements und nicht zum oberen. GRELRIGHT gRelRight LeftEdge ist relativ zum rechten Rand dieses Displayelements und nicht zum linken. GRELWIDTH gRelWidth Width ist kein absoluter Wert, sondern wird von Width des Display- elements abgezogen. GRELHEIGHT gRelHeight Height ist kein absoluter Wert, sondern wird von Height des Display- elements abgezogen. SELECTED selected Handelt es sich um ein »Boolean- Gadget«, so ist es zur Zeit ein- geschaltet. C GADGDISABLED Modula-2 Hex gadgDisabled 0100 Beschreibung Dieses Gadget ist inaktiviert und kann vom Benutzer nicht wieder akti- viert werden. ACHTUNG: In Modula-2 sind gadgHighbits, gadgHNone und gadgHComp als Konstanten definiert. } Activation 0x000E (14) RELVERIFY GADGIMMEDIATE ENDGADGET FOLLOWMOUSE RIGHTBORDER LEFTBORDER TOPBORDER BOTTOMBORDER TOGGLESELECT STRINGCENTER STRINGRIGHT LONGINT Gesetzte Flags haben folgende Bedeutung: Modula-2 Hex relVerify gadgImmediate 0002 endGadget 0004 followMouse 0008 rightBorder 0010 leftBorder 0020 topBorder 0040 bottomBorder 0080 toggleSelect 0100 stringCenter 0200 stringRight 0400 longint Beschreibung Gadget wird nur aktiv, wenn sich der Mauszeiger beim Drücken und Loslassen der linken Maustaste über dem Gadget befindet. Gadget wird bereits beim ersten »Anklicken« aktiv. Ist das Displayelement ein Requester, so kann es nur geschlossen werden, wenn dieses Bit gesetzt ist. Auch nach dem »Anklicken« eines Gadgets wird das Programm laufend über die Position des Mauszeigers informiert. Ist das Displayelement ein Window, so kann das Gadget durch Setzen eines dieser Bits in den rechten, linken, oberen oder unteren Rand eingebun- den werden, wobei die Breite des Fensterrands der Größe des Gadgets angeglichen wird. Es handelt sich um ein Boolean-Toggle-Gadget, das ein- und ausgeschaltet werden kann. Ist dies ein String-Gadget, so wird der Text zentriert ein- und ausgegeben. Ist dies ein String-Gadget, so wird der Text rechtsbündig ein- und ausgegeben. Die Eingabe wird als Zahl vom Typ Long interpretiert. Modula-2 Hex Beschreibung ALTKEYMAP altKeyMap 1000 Zur Eingabe eines Textes wird eine eigene Keymap verwendet. BOOLEXTEND boolExtend 2000 Zu diesem Boolean-Gadget gehört eine BoolInfo-Datenstruktur. I GadgetType 0x0010 (16) Folgende Konstanten definieren in dieser 2-Byte-Marke, um welche Art von Gadget es sich handelt: C Modula-2 Hex Beschreibung Definition der Anwender-Gadgets: BOOLGADGET boolGadget 0001 Ein Boolean-Gadget. GADGET0002 gadget0002 0002 Lückenfüllendes Bit. PROPGADGET propGadget 0003 Ein Proportional-Gadget. STRGADGET strGadget 0004 Ein String-Gadget. Definition der System-Gadgets: SIZING sizing 0010 Ein Sizing-Gadget; zum Verändern der Größe eines Fensters. WDRAGGING wDragging 0020 Ein Drag-Gadget; zum Verschieben von Fenstern. SDRAGGING sDragging 0030 Ein Drag-Gadget; zum Verschieben von Bildschirmen. WUPFRONT wUÜpFront 0040 Ein Depth-Gadget; um ein Fenster in den Vordergrund zu holen. SUPFRONT sUpFront 0050 Ein Depth-Gadget; um einen Bild- schirm in den Vordergrund zu holen. WDOWNBACK wDownBack 0060 Ein Depth-Gadget; um ein Fenster in den Hintergrund zu bringen. SDOWNBACK sDownBack 0070 Ein Depth-Gadget; um einen Bildschirm in den Hintergrund zu bringen. CLOSE close 0080 Ein Close-Gadget; zum Schließen von Fenstern. Definition der Zuge- hörigkeit des Gadgets: REQGADGET regqGadget 1000 Das Gadget gehört zu einem Requester. GZZGADGET gzzGadget 2000 Das Gadget ist in einem GZZ-Border integriert. SCRGADGET scrGadget 4000 Das Gadget gehört zu einem Bild- schirm. SYSGADGET sysGadget 8000 Das Gadget ist ein System-Gadget. GADGETTYPE gadgetType FCO0O0 Kombination aller Flaggs, die in GadgetType gesetzt werden können. I GadgetRender 0x0012 (18) II SelectRender 0x0016 (22) I GadgetText 0x001A (26) I] MutualExclude 0x001E (30) I] Speciallnfo 0x0022 (34) I GadgetID 0x0026 (38) I] UserData 0x0028 (40) Gadgetinfo Ein Adreßzeiger aufeine /mage- oder Border-Datenstruktur, die zur grafischen Darstellung dieses Gadgets benutzt wird. Um welche Datenstruktur es sich hierbei letztlich handelt, wird durch das GADGIMAGE-Bit in Flags angegeben. Steht hier NULL, so erfolgt keine sichtbare Markierung des Gad- gets. Ein Adreßzeiger auf eine /mage- oder Border-Datenstruktur, die zur grafischen Darstellung bei Auswahl dieses Gadgets benutzt wird. Diese Datenstruktur muß vom gleichen Typ sein, wie die durch GadgetRender definierte. Um bei der Auswahl des Gadgets aktiv zu werden, muß das GADGHI- MAGE-Bit in Flags gesetzt sein. Soll ein Text in diesem Gadget ausgegeben werden, so muß hier ein Adreßzeiger auf eine /ntuiText-Datenstruktur ste- hen. Die relativen Koordinaten der linken oberen Ecke des Textes beziehen sich dann auf die LeftEdge- und TopEdge- Werte dieses Gadgets. Steht hier NULL, so wird kein Text ausgegeben. Dieser Parameter wird in den vorliegenden Versionen von »Intuition« noch nicht unterstüzt. Ein Adreßzeiger auf die zugehörige Boollnfo-, PropInfo- oder StringInfo-Datenstruktur. Von welcher Art das Gadget nun wirklich ist, wird durch die Flags in GadgerType fest- gelegt. Fortlaufende Nummer dieses Gadgets in der linearen Liste aller zu diesem Window miteinander verknüpften Gadgets. Möchten Sie einem Gadget eigene Zusatzdaten zuordnen, so können Sie hier einen Adreßzeiger auf diese Daten eintra- gen. Offset C (intuition/intuitionbase.h) Modula-2 (Intuition) struct GadgetInfo GadgetlInfo = RECORD struct GListEnv *gi_Environ; environ:GListEnvPitr; struct Gadget *gi_Gadget; gadget:GadgetPtr; struct IBox gi_Box; box:IBox; struct IBox gi_Container; container:IBox; struct Layer *gi_Layer; layer:LayerPtr; struct IBox gi_NewKnob; newKnob:IBox; b END; Assembler Datenstrukturenreferenz Routinenreferenz > Beschreibung Diese systeminterne Datenstruktur ist in Assembler nicht definiert. »Intuition«: IntuitionBase. »Workbench«: DiskObject. Keine. In dieser Datenstruktur werden zu einem Gadget Informationen über seine Umgebung abgelegt. 4 4 gi_Environ 0x0000 (0) gi Gadget 0x0004 (4) gi Box 0x0008 (8) gi Container 0x0010 (16) gi Layer 0x0018 (24) gi NewKnob 0x001C (28) GListEnv Offset C (intuition/intuitionbase.h) Modula-2 (Intuition) L Ein Adreßzeiger auf eine GListEnv-Datenstruktur, die die Umgebung des Gadgets noch näher beschreibt. Ein Adreßzeiger auf die Gadget-Datenstruktur, auf die sich diese Informationen beziehen. Einbindung einer /Box-Datenstruktur, in der die Dimensio- nen des Gadgets gespeichert sind. Einbindung einer /Box-Datenstruktur, in der die Dimensio- nen des Containers gespeichert sind. Ein Adreßzeiger auf die zu diesem Gadget gehörige Layer- Datenstruktur. Einbindung einer /Box-Datenstruktur, in der bei einem Pro- portional-Gadget die Dimensionen des Knopfes gespeichert sind. Hex Dez struct GListEnv GListEnv = { RECORD 0000 0 struct Screen *ge_Screen; screen:ScreenPtr; 0004 4 struct Window *ge_Window; window:WindowPir; 0008 8 struct Requester *ge_Requester; requester:RequesterPtr; 000C 12 struct RastPort *ge_RastPort; rastPort:RastPortPir; 0010 16 struct Layer *ge_Layer; layer:LayerPtr; 0014 20 struct Layer *ge_GZZLayer; gzzLayer:LayerPir; 0018 24 struct PenPair ge_Pens; pens:PenPair; 001A 26 struct IBox ge_Domain; domain:IBox; 0022 34 struct IBox ge_GZZdims; gzzDims:IBox; 002A 42 r END; Assembler Datenstrukturenreferenz Routinenreferenz Beschreibung Diese systeminterne Datenstruktur ist in Assembler nicht . definiert. »Intuition«: GadgetInfo, IntuitionBase. Keine. In dieser Datenstruktur werden zu einer Liste von mehreren Gadgets weitere Informationen über ihre Umgebung abgelegt. J 4 ge_Screen 0x0000 (0) se Window 0x0004 (4) ge Requester 0x0008 (8) ge RastPort 0x000C (12) ge Layer 0x0010 (16) ge GZZLayer 0x0014 (20) ge_Pens 0x0018 (24) ge Domain 0x001A (26) ge_GZZdims 0x0022 (34) Ein Adreßzeiger auf die Screen-Datenstruktur, zu dem die Gadgets gehören. Gehören die Gadgets zu einem Window, so steht hier ein Adreßzeiger auf die entsprechende Window-Datenstruktur. Gehören die Gadgets zu einem Requester, so steht hier ein Adreßzeiger auf die entsprechende Requester-Datenstruk- tur. Ein Adreßzeiger auf die RastPort-Datenstruktur, deren Para- meter bei der Darstellung der Gadgets verwendet werden. Ein Adreßzeiger auf die zu den Gadgets gehörende Layer- Datenstruktur. Gehören die Gadgets zu einem GimmeZeroZero-Window, so steht hier der zweite Adreßzeiger auf die entsprechende Layer-Datenstruktur. Einbindung einer PenPair-Datenstruktur, in der die Num- mern der Farbregister stehen, deren Farbwerte bei der Dar- stellung der Gadgets verwendet werden. Einbindung einer /Box-Datenstruktur, in der die Position und Dimension des Bereiches angegeben sind, in dem sich alle diese Gadgets befinden. Die Positionsangaben dieses Rechtecks sind relativ zum zugehörigen Displayelement. Ist das zugehörige Displayelement ein GimmeZeroZero- Window, so stehen in dieser eingebundenen /Box-Daten- struktur die entsprechend veränderten Werte aus ge _ Domain. IBox ee C (intuition/intuitionbase.h) Modula-2 (Intuition) struct IBox IBox = { RECORD SHORT Left; left:INTEGER; SHORT Top; top:INTEGER; SHORT Width; width:INTEGER; SHORT Height; height:INTEGER; I: END; Assembler Diese systeminterne Datenstruktur ist in Assembler nicht definiert. Datenstrukturenreferenz »Intuition«: GadgetInfo, GListEnv, IntuitionBase. Routinenreferenz Keine. ____> Beschreibung Diese systeminterne Datenstruktur wird benutzt, um die Dimensionen eines Rechtecks in andere Datenstrukturen einzubinden. I Left 0x0000 (0) Der Abstand des Rechtecks vom linken Rand des zugehöri- gen Displayelements. I Top 0x0000 (0) Der Abstand des Rechtecks vom oberen Rand des zugehöri- gen Displayelements. „1 Width 0x0004 (4) Die Breite des Rechtecks. 4 Height 0x0004 (4) Die Höhe des Rechtecks. Image Offset C (intuition/intuition.h) Modula-2 (Intuition) Hex Dez struct Image Image = { RECORD 0000 0 SHORT LeftEdge; leftEdge:INTEGER; 0002 2 SHORT TopEdge; topEdge:INTEGER; 0004 4 SHORT Width; width:INTEGER; 0006 6 SHORT Height; height:INTEGER; 0008 8 SHORT Depth; depth:INTEGER; 000A 10 USHORT *ImageData; imageData: ADDRESS; OOOE 14 UBYTE PlanePick; planePick:UByte; C (intuition/intuition.h) Modula-2 (Intuition) UBYTE PlaneOnOff; planeOnOff:UByte; b Assembler Datenstrukturenreferenz Routinenreferenz ___> Beschreibung struct Image *NextlImage; nextImage:ImagePtr; Präfix: ig_ »Intuition«: Image, IntuitionBase, NewWindow, Window »Intuition«: Drawlmage. In dieser Datenstruktur werden die Daten gespeichert, die für die Ausgabe eines beliebigen Grafiksym- bols mit der Routine Drawlmage nötig sind. I LeftEdge 0x0000 (0) I TopEdge 0x0000 (2) I Width 0x0004 (4) Height 0x0006 (6) I Depth 0x0008 (8) Ü I ImageData 0x000A (10) „I PlanePick 0x000E (14) 1 PlaneOnOff 0x000F (15) Die zu der x-Koordinate, die beim Aufruf in der Draw/mage- Routine angegeben wird, relative x-Koordinate der oberen linken Ecke des Grafiksymbols. Die zu der y-Koordinate, die beim Aufruf in der Draw/mage- Routine angegeben wird, relative y-Koordinate der oberen linken Ecke des Grafiksymbols. Die Breite des Grafiksymbols. Die Höhe des Grafiksymbols. Die Tiefe des Grafiksymbols (also die Anzahl der Bitplanes), von der die Anzahl der Farben abhängt. Dies ist ein Adreßzeiger auf die Grafikdaten, die sich im Chip-RAM befinden müssen. Die einzelnen Bitplanes werden dabei hintereinander abgespeichert. Die Bits dieser 1-Byte-Maske geben an, in welche Bitplanes des Ziel-Rastports die Grafikdaten geschrieben werden. Ist ein Bit gesetzt, so bedeutet dies, daß die korrespondierende Bitplane beschrieben wird. Die einzelnen Bits dieser 1-Byte-Maske sind nur von Inter- esse, wenn das korrespondierende Bit in PlanePick gelöscht ist. In diesem Fall wird die zugehörige Bitplane in dem Bereich des Grafiksymbols mit 0 oder 1 gefüllt (ist also z.B. das dritte Bit in PlanePick gelöscht und in PlaneOnOff gesetzt, so wird die dritte Bitplane des Ziel-Rastports in dem Bereich des Grafiksymbols mit 1 gefüllt). 3 NextImage 0x0010 (16) IntuiMessage Über diesen Adreßzeiger können mehrere /mage-Daten- strukturen miteinander verknüpft werden, um so durch einen einzigen Aufruf der DrawImage-Routine mehrere Grafik- symbole in dem entsprechenden RastPort zu zeichnen. Das letzte Element der Liste muß an dieser Stelle wie immer den Wert NULL haben. Offset C (intuition/intuition.h) Modula-2 (Intuition) struct IntuiMessage { IntuiMessage = RECORD struct Message ExecMessage; ULONG Class; USHORT Code; USHORT Qualifier; APTR IAddress; SHORT MouseX; SHORT MouseY; ULONG Seconds; ULONG Micros; struct Window *IDCMPWindow; struct IntuiMessage } execMessage:Message; class: IDCMPFlagsSet; code:CARDINAL; qualifier:QualifierSet; Address: ADDRESS; mouseX:INTEGER; mouseY:INTEGER; seconds: LONGCARD; micros:LONGCARD; idempWindow:WindowPir; specialLink:IntuiMessagePtr; *SpecialLink Assembler Präfix: in Datenstrukturenreferenz »Intuition«: FatIntuiMessage, IntuitionBase, IntuiMessage, Window. Routinenreferenz »Exec«: GetMsg, ReplyMsg. > Beschreibung Die I/ntuiMessage-Datenstruktur ist eine Erweiterung einer ExecMessege-Datenstruktur. Sie ist eine vollständige Systemnachricht zur Meldung von Ereignissen, die im Zusammenhang mit der »intuition.library« passieren, wie beispielsweise die Aktivierung eines Gadgets. I ExecMessage 0x0000 (0) I Class 0x0014 (20) Hier ist eine ExecMessage-Datenstruktur eingebunden. Hier stehen die /DCMP-Flags des nächsten eingetragenen Ereignisses zur Abfrage bereit. Eine genaue Beschreibung der/DCMP-Flags finden Sie im Abschnitt »Wichtige Flaggs der Intuition-Library«. Code 0x0018 (24) Qualifier 0x001A (26) IAddress 0x001C (28) MouseX 0x0020 (32) MouseY 0x0022 (34) Seconds 0x0024 (36) Micros 0x0028 (40) IDCMPWindow 0x002C (44) SpecialLink 0x0030 (48) IntuiText Offset C (intuition/intuition.h) Hex Dez struct IntuiText Hier können Zusatzdaten, wie beispielsweise ASCII- oder Raw-Code einer gedrückten Taste stehen. Um welchen Para- meter es sich dabei handelt, wird durch die IDCMP-Flags in Class bestimmt. Handelt es sich um eine Tastatureingabe, so kann diesem Wert entnommen werden, welche zusätzlichen Kontrollta- sten (<Shift>, <Alt>, <Ctrl>, etc.) zur gleichen Zeit gedrückt waren. Die genauen Werte der einzelnen Kontrolltasten finden Sie in der Beschreibung der /nputEvent-Datenstruk- tur. Ein Adreßzeiger auf die Datenstruktur des zugehörigen Dis- playelements. Wurde beispielsweise ein Gadget aktiviert, so steht hier der Adreßzeiger auf die entsprechende Gadget- Datenstruktur. Die x-Koordinate des Mauszeigers, relativ zur linken oberen Ecke des zugehörigen Windows, zum Zeitpunkt des Ereig- nisses. Die y-Koordinate des Mauszeigers, relativ zur linken oberen Ecke des zugehörigen Windows, zum Zeitpunkt des Ereig- nisses. Sekundenanteil der Systemzeit zum Zeitpunkt des Ereignis- ses. Mikrosekundenanteil (zwischen 0 und 999) der Systemzeit zum Zeitpunkt des Ereignisses. Ein Adreßzeiger auf die Window-Datenstruktur des Win- dows, zu dem diese Nachricht gehört. Systeminterner Adreßzeiger auf weitere vorliegende /ntui- Message-Datenstrukturen in der Message-Liste. Modula-2 (Intuition) IntuiText = { RECORD 0000 0 UBYTE FrontPen; frontPen:UByte; 0001 1 UBYTE BackPen; backPen:UByte; 0002 2 UBYTE DrawMode; drawMode:DrawModeSet; 0004 4 SHORT LeftEdge; leftEdge:INTEGER; 0006 6 SHORT TopEdge; topEdge:INTEGER; 0008 8 struct TextAttr *ITextFont; iTextFont:TextAttrPtr; 000C 12 UBYTE *IText; iText: ADDRESS; Offset C (intuition/intuition.h) Modula-2 (Intuition) }; Assembler Datenstrukturenreferenz struct IntuiText *NextText; nextText:IntuiTextPtr; END; Präfix: it_ »Intuition«: Gadget, IntuiText, Requester. »Intuition«: AutoRequest, BuildSysRequest, Routinenreferenz ___ > Beschreibung PrintIText. Die /ntuiText-Datenstruktur definiert einen Text (samt seiner Eigenschaften wie Schriftart und -stil), der durch die PrintIText-Routine ausgegeben werden kann. 4 m FrontPen 0x0000 (0) BackPen 0x0001 (1) DrawMode 0x0002 (2) LeftEdge 0x0004 (4) TopEdge 0x0006 (6) ITextFont 0x0008 (8) IText 0x000C (12) NextText 0x0010 (16) Die Nummer des Farbregisters, dessen Inhalt beim Schrei- ben des Textes als Vordergrundfarbe verwendet wird. Die Nummer des Farbregisters, dessen Inhalt beim Schrei- ben des Textes als Hintergrundfarbe verwendet wird. Der Zeichenmodus, mit dem der Text geschrieben wird. Zur Verfügung stehen JAMI/ (Schreiben des Textes mit der Vor- dergrundfarbe FrontPen), JAM2 (zusätzliches Beschreiben der Umgebung der Buchstaben mit der Hintergrundfarbe BackPen) und XOR (Invertieren des Textes). Die zu der x-Koordinate, die beim Aufruf in der Print/Text- Routine angegeben wird, relative x-Koordinate der oberen linken Ecke der Zeichenkette. Die zu der y-Koordinate, die beim Aufruf in der PrintIText- Routine angegeben wird, relative y-Koordinate der oberen linken Ecke der Zeichenkette. Ein Adreßzeiger auf eine TextAttr-Datenstruktur, die die Informationen über den zu verwendenden Zeichensatz ent- hält. Ist dieser Wert NULL, so wird der Default-Zeichensatz verwendet. Ein Adreßzeiger auf die auszugebende, Null-terminierte Zeichenkette. Ein Adreßzeiger auf weitere /ntuiText-Datenstrukturen, die mit dem gleichen Aufruf auch noch ausgegeben werden sollen. Steht hier NULL, so war dies die letzte /IntuiText- Datenstruktur. IntuitionBase C (intuition/intuitionbase.h) Modula-2 (Intuition) struct IntuitionBase Offset Hex Dez 0000 0 0022 34 0034 52 0038 56 003C 60 0040 64 0044 68 0046 70 0048 72 004C 16 0050 80 0052 82 0054 84 0056 86 0058 88 005C 92 0060 96 0064 100 0068 104 006C 108 0070 112 0074 116 0075 117 0076 118 0077 119 0078 120 007A 122 007C 124 007E 126 00E2 226 00EA | 234 0112 274 013A | 314 0162 354 018A | 394 01BA | 442 01C0 | 464 01C4 | 468 01C8 | 472 struct Library LibNode; struct View ViewLord; struct Window *ActiveWindow; struct Screen *ActiveScreen; struct Screen *FirstScreen; ULONG Flags; WORD MouseY; WORD MouseX; ULONG Seconds; ULONG Micros; WORD MinXMouse; WORD MaxXMouse; WORD MinYMouse; WORD MaxYMouse; ULONG StartSecs; ULONG StartMicros; APTR SysBase; struct GfxBase *GfxBase; APTR LayersBase; APTR ConsoleDevice; USHORT *APointer; BYTE APtrHeight; BYTE APtrWidth; BYTE AXOffset; BYTE AYOftset; USHORT MenuDrawn; USHORT MenusSelected; USHORT OptionLbist; struct RastPort MenuRPort; struct TmpRas MenuTmpRas; struct ClipRect ItemCRect; struct ClipRect SubCRect; struct BitMap IBitMap; struct BitMap SBitMap; struct IOStdReq InputRequest; struct Interrupt InputInterrupt; struct Remember *EventKey; struct InputEvent *IEvents; SHORT EventCount; IntuitionBase = RECORD libNode:Library; viewLord: View; activeWindow:WindowPitr; activeScreen:ScreenPtr; firstScreen:ScreenPitr; flags:LONGSET, mouseY:INTEGER; mouseX:INTEGER; seconds:LONGCARD; micros: LONGCARD; minXMouse:INTEGER; maxXMouse:INTEGER; minYMouse:INTEGER; maxYMouse:INTEGER; startSecs: LONGCARD; startMicros:- LONGCARD; sysBase: ADDRESS; gfxBase:GfxBasePtr; layersBase: ADDRESS; consoleDevice: ADDRESS; aPointer- ADDRESS; aPtrHeight:UByte; aPtrWidth:[0..16]; aXOffset:UByte; aYOffset:UByte; menuDrawn:CARDINAL; menuSelected:CARDINAL; optionList:CARDINAL; menuRPort:RastPort; menuTmpRas:TmpRas; itemCRect:ClipRect; subCRect:ClipRect; iBitMap:BitMap; sBitMap:BitMap; inputRequest:IOStdReg; inputlInterrupt:Interrupt; eventKey:RememberPir; iEvents: ADDRESS; eventCount:INTEGER; struct InputEvent IEBuffer[4]; struct Gadget *ActiveGadget; struct PropInfo *ActivePInfo; struct Image *Activelmage; struct GListEnv GadgetEnv; struct GadgetInfo GadgetInfo; struct Point KnobOffset; struct Window *getOK Window; struct IntuiMessage *getOK Message; USHORT setWExcept; USHORT GadgetReturn; USHORT StateReturn; struct RastPort *RP; struct TmpRas ITmpRas; struct Region *OldClipRegion; struct Point OldScroll; struct IBox IFrame; SHORT hthick; SHORT vthick; VOID (*frameChange)(); VOID (*sizeDrag)(); struct Point FirstPt; struct Point OldPt; struct Gadget *SysGadgets[16]; struct Image *ChecklImagel[2]; struct Image *Amigalcon/2]; USHORT apattern[38]; USHORT bpattern[4]; USHORT *IPointer; BYTE IPtrHeight; BYTE IPtrWidth; BYTE IXOffset; BYTE IYOffset; LONG DoubleSeconds; LONG DoubleMicros; on C (intuition/intuitionbase.h) Modula-2 (Intuition) ieBuffer: ARRAY [0..3] OF InputEvent; activeGadget:GadgetPtr; activePInfo:PropInfoPtr; activelmage:ImagePtr; gadgetEnv:GListEnv; gadgetInfo:GadgetInfo; knobOffset:Point; getOKWindow:WindowPtr; getOKMessage: IntuiMessagePtr; setWExcept:CARDINAL; gadgetReturm:CARDINAL; stateReturn:CARDINAL; ıp:RastPortPtr; iTmpRas:TmpRas; oldClipRegion:RegionPtr; oldScroll:Point; iFrame:IBox; hthick:INTEGER; vthick:INTEGER; frameChange:PROC; sızeDrag:PROC; firstPt:Point; oldPt:Point; sysGadgets: ARRAY [0..15] OF GadgetPtr; checkImage: ARRAY [0..1] OF ImagePtr; amigalcon: ARRAY [0..1] OF ImagePtr; aPattern: ARRAY [0..7] OF CARDINAL; bPattern: ARRAY [0..3] OF CARDINAL; iPointer- ADDRESS; iPtrHeight:UByte; iPtrWidth:[0..16]; iXOffset:UByte; iY Offset:UByte; doubleSeconds:LONGINT,; doubleMicros:LONGINT,; Offset C (intuition/intuitionbase.h) 0346 0348 034A 034C 034E 0350 0352 0354 0356 0358 035A 035C 035E 0360 0362 0364 036C 0370 0374 0376 0378 037A 037C 0380 0382 0384 0386 O3AE 03B0 03B4 03B8 O3EC 03F0 03F4 03F8 03FA 0408 BYTE WBorLeft[2]; BYTE WBorTop[2]; BYTE WBorkightf2]; BYTE WBorBottom[2]; BYTE BarVBorder[2]; BYTE BarHBorder/2]; BYTE MenuVBorder/2]; BYTE MenuHbBorderl2]; USHORT colord; USHORT color]; USHORT color2; USHORT color3; USHORT color17; USHORT color18; USHORT color19; struct TextAttr SysFont; struct Preferences *Preferences; struct DistantEcho *Echoes; WORD ViewlnitX; WORD ViewlnitY; SHORT CursorDX; SHORT CursorDY,; struct KeyMap *KeyMap; SHORT MouseY Minimum; SHORT ErrorX; SHORT ErrorY; struct timerequest IOExcess; SHORT HoldMinYMouse; struct MsgPort *WBPort; struct MsgPort *jqd_FNKUHDPOort; struct IntuiMessage WBMessage; struct Screen *HitScreen; struct SimpleSprite *SimpleSprite; struct SimpleSprite * AttachedSSprite; BOOL GotSpritel; struct List SemaphorelLb6ist; struct SignalSemaphore Modula-2 (Intuition) wBorlLeft, wBorTop, wBorRight, wBorBottom, barV Border, barHBorder, menuVBorder, menuHBorder: ARRAY [0..1] OF Byte; color0:CARDINAL; colorl:CARDINAL; color2:CARDINAL; color3:CARDINAL; color17:CARDINAL; color18:CARDINAL; color19:CARDINAL; sysFont:TextAttr; preferences:PreferencesPtr; echoes: ADDRESS; viewlnitX:INTEGER; viewlnitY:INTEGER; cursotDX:INTEGER; cursorDY:INTEGER; keyMap:KeyMapfPtr; mouseY Minimum:INTEGER; errorX:INTEGER; errorY:INTEGER; 1oExcess:IOTimer; holdMinYMouse:INTEGER; wbPort:MsgPortPtr; fnkuhdPort:MsgPortPtr; wbMessage:IntuiMessage; hitScreen:ScreenPir; simpleSprite: SimpleSpritePtr; attachedSSprite: SimpleSpritePtr; gotSpritel:BOOLEAN; semaphorelList:List; iSemaphore: ARRAY [0..6] OF Offset C (intuition/intuitionbase.h) Modula-2 (Intuition) ISemaphore[7]; SignalSemaphore; WORD MaxDisplayHeight; maxDisplayHeight:INTEGER; WORD MaxDisplayRow; maxDisplayRow:INTEGER; WORD MaxDisplayWidth; reserved: ARRAY [0..7] OF ULONG Reserved[7]; LONGCARDB; b Assembler Präfix: ib_ In Assembler sind nur die ersten fünf Komponenten dieser systeminternen Datenstruktur definiert. Datenstrukturenreferenz Keine. Routinenreferenz »Intuition«: LocklBase, OpenIntuition, UnLocklBase. "= T> Beschreibung Diese systeminterne Datenstruktur enthält einige Daten, die bei der Fehlersuche helfen können. Um zu verhindern, daß Werte verändert werden, während Sie sich diese ansehen, rufen Sie bitte vorher die LocklIBase-Routine auf. (Den Adreßzeiger auf diese Datenstruktur erhalten Modula-2-Programmierer durch die Routine OpenIntuition.) Haben Sie genug gesehen, können Sie durch UnLocklBase die IntuitionBase-Datenstruktur wieder freigeben. Da es nicht gewährleistet ist, daß sich diese Parameter in zukünftigen Versionen nicht verändern, sollten sie von Programmen nicht benutzt, auf gar keinen Fall aber verändert werden. I LibNode 0x0000 (0) Ein Adreßzeiger auf die Library-Datenstruktur, die für die Einbindung der »intuition.library« in das System zuständig ist. Eine genaue Beschreibung dieser Datenstruktur finden Sıe im Kapitel über »Exec«. 1 ViewLord 0x0022 (34) Einbindung einer View-Datenstruktur, die die Definition des Gesamtdisplays übernimmt. I ActiveWindow 0x0034 (52) Ein Adreßzeiger auf die Window-Datenstruktur des momen- tan aktiven Fensters. 4 ActiveScreen 0x0038 (56) Ein Adreßzeiger auf die Screen-Datenstruktur des momen- tan aktiven Bildschirms. 1 FirstScreen 0x003C (60) Ein Adreßzeiger auf die Screen-Datenstruktur des in Vorder- grund stehenden Bildschirms. I Flags 0x0040 (64) Eine systeminterne Kombination von verschiedenen Flags der »intuition.library«. 1 MouseY 0x0044 (68) Die absolute y-Koordinate der augenblicklichen Position des Mauszeigers. 4 u 4 MouseX 0x0046 (70) Seconds 0x0048 (72) Micros 0x004C (76) Die absolute y-Koordinate der augenblicklichen Position des Mauszeigers. Der Sekundenanteil der Systemzeit zum Zeitpunkt des aktu- ellsten Ereignisses (Inputevent). Der Mikrosekundenanteil der Systemzeit zum Zeitpunkt des aktuellsten Ereignisses (Inputevent). ACHTUNG: Alle folgenden Parameter dienen nur zur Fehlersuche! Ein Verändern der folgenden Werte kann nach einer ungewissen Anzahl von Taktzyklen einen nicht wünschenswerten Systemzustand her- aufbeschwören. 4 u 2 Die WE 0 oo MinXMouse 0x0050 (80) MaxXMouse 0x0052 (82) MinYMouse 0x0054 (84) MaxYMouse 0x0056 (86) StartSecs 0x0058 (88) StartMicros 0x005C (92) SysBase 0x0060 (96) GfxBase 0x0064 (100) LayersBase 0x0068 (104) ConsoleDevice 0x006C (108) APointer 0x0070 (112) APtrHeight 0x0074 (116) APtrWidth 0x0075 (117) AXOffset 0x0076 (118) AYOffset 0x0077 (119) Linker Begrenzungswert für den Bereich, in dem der Benut- zer den Mauszeiger bewegen kann. Rechter Begrenzungswert für den Bereich, in dem der Be- nutzer den Mauszeiger bewegen kann. Oberer Begrenzungswert für den Bereich, in dem der Benut- zer den Mauszeiger bewegen kann. Unterer Begrenzungswert für den Bereich, in dem der Benut- zer den Mauszeiger bewegen kann. Der Sekundenanteil der Zeitdauer, die zwischen zwei »Maus-Klicks« liegen darf, damit dieser Vorgang als »Doppel-Klick« erkannt wird. Der Mikrosekundenanteil der Zeitdauer, die zwischen zwei »Maus-Klicks« liegen darf, damit dieser Vorgang als »Doppel-Klick« erkannt wird. Ein Adreßzeiger auf die Basisadresse des Systems, also auf die entsprechende Exec-Datenstruktur. Ein Adreßzeiger auf die aktuelle GfxBase-Datenstruktur. Ein Adreßzeiger auf die aktuelle LayersBase-Datenstruktur. Ein Adreßzeiger auf das aktuelle Console-Device. Ein Adreßzeiger auf die Grafikdaten des momentan aktiven Mauszeigers. Die Höhe des momentan aktiven Mauszeigers. Die Breite des momentan aktiven Mauszeigers. Der Abstand des Hot-Spot vom linken Rand des momentan aktiven Mauszeigers. Der Abstand des Hot-Spot vom oberen Rand des momentan aktiven Mauszeigers. 4 I 4 MenuDrawn 0x0078 (120) Menuselected 0x007A (122) OptionList 0x007C (124) Die Menünummer des momentan gezeichneten Pull-down- Menüs. Wird zur Zeit kein Pull-down-Menü ausgegeben, so steht hier OxFFFF. Die Menünummer des momentan ausgewählten Menüpunk- tes. Ist zur Zeit kein Menüpunkt ausgewählt, so steht hier OxFFFF. Zusatzwert für die Options-Liste der Pull-down-Menüs. BEACHTE: Die folgenden sechs Parameter beinhalten Informationen über den Rastport, der zur Darstellung der momentanen Menüs benutzt wird. Dabei handelt es sich im Normalfall um Kopien der entsprechenden Werte des augenblicklich aktiven Screens. 4 4 MenuRPort 0x007E (126) MenuTmpRas 0x00E2 (226) ItemCRect 0x00EA (234) SubCRect 0x0112 (274) IBitMap 0x013A (314) SBitMap 0x0162 (354) InputRequest 0x018A (394) InputInterrupt 0x01BA (442) EventKey 0x01C0 (464) IEvents 0x01C4 (468) EventCount 0x01C8 (472) IEBuffer 0x01CA (474) ActiveGadget 0x0232 (562) ActivePInfo 0x0236 (566) Eine eingebundene RastPort-Datenstruktur, die beim Zeich- nen der Menüs benutzt wird. Eine eingebundene TmpRas-Datenstruktur, die zu MenuR- Port gehört. Eine eingebundene ClipRect-Datenstruktur, die bei der Ausgabe von Pull-down-Menüs (Menuitems) verwendet wird. Eine eingebundene ClipRect-Datenstruktur, die bei der Ausgabe von Untermenüs (Menusubitems) verwendet wird. Eine eingebundene BitMap-Datenstruktur, die bei der Aus- gabe von Pull-down-Menüs (Menuitems) verwendet wird. Eine eingebundene BitMap-Datenstruktur, die bei der Aus- gabe von Untermenüs (Menusubitems) verwendet wird. Eine eingebundene /OStdReg-Datenstruktur, die für das aktuelle Input-Device gültig ist. Eine eingebundene /nterrupt-Datenstruktur, die für das aktuelle Input-Device gültig ist. Ein Adreßzeiger auf eine Remember-Datenstruktur, die für dynamisch angelegte Input-Events verwendet wird. Ein Adreßzeiger auf die zu EventKey gehörende /InputEvent- Datenstruktur. Ein Zähler für fest angelegte Input-Events. Eine Einbindung von vier InputEvent-Datenstrukturen, die für fest angelegte Input-Events verwendet werden. Ein Adreßzeiger auf die Gadget-Datenstruktur des momen- tan aktivierten Gadgets. Handelt es sich bei dem momentan aktivierten Gadget um ein Proportional-Gadget, so steht hier ein Adreßzeiger auf die zugehörige PropInfo-Datenstruktur. Ü Activelmage 0x023A (570) GadgetEnv 0x023E (574) GadgetInfo 0x0268 (616) KnobOffset 0x028C (652) GetOKWindow 0x0290 (656) GetOKMessage 0x0294 (660) SetWExcept 0x0298 (664) GadgetReturn 0x029A (666) StateReturn 0x029C (668) RP 0x029E (670) ITmpRas 0x02A2 (674) OldClipRegion 0x02AA (682) OldScroll 0x02AE (686) IFrame 0x02B2 (690) HtHick 0x02BA (698) VtHick 0x02BC (700) Wird zu dem momentan aktivierten Gadget gerade ein Image ausgegeben, so steht hier ein Adreßzeiger auf die zugehörige Image-Datenstruktur. Eine eingebundene GListEnv-Datenstruktur, in der nähere Informationen über die Umgebung des momentan aktiven Gadgets abgelegt werden. Eine eingebundene GadgetInfo-Datenstruktur, in der wei- tere Informationen über momentan aktive Gadgets abgelegt werden. Wurde ein Proportional-Gadget aktiviert, so steht in dieser eingebundenen Point-Datenstruktur die Position des Maus- zeigers (zum Zeitpunkt der Aktivierung) innerhalb des Knopfes. Laut [KRA] gehören die GerOkxxx-Komponenten zu den »verify functions«. Eine durchaus zulässige Interpretation ist, daß damit die Intuition-Funktionen gemeint sind, die zu den IDCMP-Flags SIZEVERIFY und REOVERIFY oder zu dem Gadget-Flag RELVERIFY gehören. Ein Adreßzeiger auf eine /ntuiMessage-Datenstruktur (siehe auch GetOkWindow). Die einzige auftreibbare Dokumentation [KRA] zu den nächsten drei Komponenten besagt, daß sie sich auf »State Machine« beziehen. Was damit gemeint sein Könnte, über- lassen wir Ihrer persönlichen Intuition. (siehe SerWExept) (siehe SerWExept) Ein Adreßzeiger auf die RastPort-Datenstruktur, die bei der Ausgabe von Gadgets, Titelleisten, etc. verwendet wird. Einbindung einer zu RP gehörenden TmpRas-Datenstruktur. Ein Adreßzeiger auf eine zu RP gehörenden Region-Daten- struktur. Eine eingebundene Point-Datenstruktur, in der bei Verschie- bungen die alte Position zwischengespeichert wird. Eine eingebundene /Box-Datenstruktur, in der beim Ver- schieben, Verkleinern oder Vergrößern von Fenstern die vorherige Position und Größe des Fensters zwischengespei- chert wird. Die Höhe der horizontalen Fensterränder. Die Breite der vertikalen Fensterränder. FrameChange 0x02BE (702) SizeDrag 0x02C2 (706) FirstPt 0x02C6 (710) OldPt 0x02CA (714) SysGadgets 0x02CE (718) CheckImage 0x030E (782) Amigalcon 0x0316 (790) APattern 0x031E (798) BPattern 0x032E (814) IPointer 0x0336 (822) IPtrHeight 0x033A (826) IPtrWidth 0x033B (827) IXOffset 0x033C (828) IYOffset 0x033D (829) Ein Adreßzeiger auf eine systeminterne Routine, die /Frame verändern kann. Ein Adreßzeiger auf eine von zwei ssysteminternen Routinen, je nachdem, ob die Größe des Fensters verändert oder es verschoben wird. Eine eingebundene Point-Datenstruktur, in der bei Größen- veränderungen von Fenstern die ursprüngliche Position der unteren rechten Ecke, bei Verschiebungen die der oberen linken Ecke zwischengespeichert wird. Eine eingebundene Point-Datenstruktur, in der bei Größen- veränderungen von Fenstern die zuletzt angezeigte Position der unteren rechten Ecke, bei Verschiebungen die der oberen linken Ecke zwischengespeichert wird. An dieser Stelle stehen 16 Adreßzeiger auf verschiedene Gadget-Datenstrukturen, die die acht verschiedenen Systemgadgets für den HiRes- und LoRes- Modus definie- ren. Die Reihenfolge der Systemgadgets ist dabei: WUPFRONT, WDOWNBACK, SIZING, CLOSE, WDRAGGING, SUPFRONT, SDOWNBACK und SDRAG- GING. Eine genauere Beschreibung finden Sie bei der Be- schreibung von GadgerT'ype der Gadget-Datenstruktur. Zwei Adreßzeiger auf die Image-Datenstrukturen, die für die Modi HiRes und LoRes die Checkmark-Grafiksymbole defi- nieren. Zwei Adreßzeiger auf die /mage-Datenstrukturen, die für die Modi HiRes und LoRes die Grafiksymbole für die Amiga- taste (zur Darstellung in den Menüs) definieren. Hier stehen acht Muster (die etwas mit dem Verschieben von Fenstern zu tun haben könnten ???). Hier stehen vier Muster (die auch etwas mit dem Verschie- ben von Fenstern zu tun haben könnten ??). Ein Adreßzeiger auf die Grafikdaten des Default-Mauszei- gers. Die Höhe des Default-Mauszeigers. Die Breite des Default-Mauszeigers (muß kleiner oder gleich 16 sein). Der Abstand des Hot-Spot vom linken Rand des Default- Mauszeigers. Der Abstand des Hot-Spot vom oberen Rand des Default- Mauszeigers. 1] DoubleSeconds 0x033E (830) m DoubleMicros 0x0342 (834) Der Sekundenanteil der Zeitdauer, die beim Default-Maus- zeiger zwischen zwei »Maus-Klicks« liegen darf, damit dieser Vorgang als »Doppel-Klick« erkannt wird. Der Mikrosekundenanteil der Zeitdauer, die beim Default- Mauszeiger zwischen zwei »Maus-Klicks« liegen darf, damit dieser Vorgang als »Doppel-Klick« erkannt wird. ACHTUNG: Die folgenden acht Werte sind jeweils doppelt vorhanden. Der erste gilt für den HiRes-, der zweite für den LoRes-Modus. u u ce co co co 0 Ü WBorLeft 0x0346 (838) WBorTop 0x0348 (840) WBorRight 0x034A (842) WBorBottom 0x034C (844) BarVBorder 0x034E (846) BarHBorder 0x0350 (848) MenuVBorder 0x0352 (850) MenuHBorder 0x0354 (852) Color0 0x0356 (854) Color1 0x0358 (856) Color2 0x035A (858) Color3 0x035C (860) Color17 0x035E (862) Color18 0x0360 (864) Color19 0x0362 (866) SysFont 0x0364 (868) Preferences 0x036C (876) Die Breite der linken Fensterränder. Dieser Wert gilt für alle Fenster, die auf dem Workbench-Screen geöffnet werden. Die Höhe der oberen Fensterränder. Dieser Wert gilt für alle Fenster, die auf dem Workbench-Screen geöffnet werden. Die Breite der rechten Fensterränder. Dieser Wert gilt für alle Fenster, die auf dem Workbench-Screen geöffnet wer- den. Die Höhe der unteren Fensterränder. Dieser Wert gilt für alle Fenster, die auf dem Workbench-Screen geöffnet werden. Die Höhe der vertikalen Bildschirmränder. Die Breite der horizontalen Bildschirmränder. Die Höhe der vertikalen Ränder der Pull-down-Menüs. Die Breite der horizontalen Ränder der Pull-down-Menüs. Der Farbwert, der als Hintergrundfarbe verwendet wird. Der Farbwert, der als Vordergrundfarbe (z.B. Text und Windows) verwendet wird. Der Farbwert, der als dritte Farbe (z.B. in den Depth-Gad- gets) verwendet wird. Der Farbwert, der als vierte Farbe (z.B. für den Textcursor) verwendet wird. Der Farbwert, der als erste Farbe für die Darstellung des Mauszeigers verwendet wird. Der Farbwert, der als zweite Farbe für die Darstellung des Mauszeigers verwendet wird. Der Farbwert, der als dritte Farbe für die Darstellung des Mauszeigers verwendet wird. Einbindung einer TextAttr-Datenstruktur, die den System- zeichensatz definiert. Ein Adreßzeiger auf die momentan gültige Preferences- Datenstruktur. [ Echoes 0x0370 (880) ViewInitX 0x0374 (884) ViewInitY 0x0376 (886) CursorDX 0x0378 (888) CursorDY 0x037A (890) KeyMap 0x037C =) MouseY Minimum 0x0380 (896) ErrorX 0x0382 (898) ErrorY 0x0384 (900) IOExcess 0x0386 (902) HoldMinYMouse 0x0386 (902) WBPort 0x03B0 (944) iqd_ FNKUHDPort 0x03B4 (948) WBMessage 0x03B8 (952) HitScreen 0x03EC (1004) SimpleSprite 0x03F0 (1008) AttachedSSprite 0x03F4 (1012) GotSpritel 0x03F8 (1016) SemaphoreList 0x03FA (1018) Ein Adreßzeiger auf eine sehr systeminterne Datenstruktur (wir haben sie noch nicht gefunden). Der x-Initialisierungswert für alle Views. Der y-Initialisierungswert für alle Views. Dieser Wert gibt den Übersetzungsfaktor der Mausbewe- gungen in x-Richtung an. Siehe auch unter PointerTicks der Preferences-Datenstruktur. | Dieser Wert gibt den Übersetzungsfaktor der Mausbewe- gungen in y-Richtung an. Siehe auch unter PointerTicks der Preferences-Datenstruktur. Ein Adreßzeiger auf die KeyMap-Datenstruktur, die bei Tastatureingaben in String-Gadgets verwendet wird. Die einzige auftreibbare Dokumentation [KRA] zu diesem Wert lautet »magic«. Also lieber die Finger davon lassen ... Wird zur Verfolgung der Mausbewegung in x-Richtung benutzt — aber wie? Wird zur Verfolgung der Mausbewegung in y-Richtung benutzt — aber wie? Eine eingebundene TimeRequest-Datenstruktur, mit deren Hilfe »Intuition« auf den Timer-Device zugreifen kann. Im Moment spricht nichts dagegen, daß dieser Wert zu MouseYMinimum gehören könnte. Ein Adreßzeiger auf den Messageport der Workbench. Ein Adreßzeiger auf den Messageport des »Final Nuclear Knockout Unit Handling Device« (zumindest so lange, bis uns jemand etwas anderes beweist) ??? Eine eingebundene /ntuiMessage-Datenstruktur, für die Nachrichten von und zum Workbench-Fenster. Ein Adreßzeiger auf eine Screen-Datenstruktur. Dieser wird verwendet, wenn ein Screen in den Vordergrund geholt wird. Ein Adreßzeiger auf eine SimpleSprite-Datenstruktur, deren Bedeutung hier nicht ganz klar ist. (Siehe SimpleSprite) Ein Boolescher Ausdruck, der wahrscheinlich in einem be- stimmten Zusammenhang mit SimpleSprite und Attached- Sprite steht. Eine eingebundene List-Datenstruktur, die zu /Semaphore einen Header bildet. ISemaphore 0x0408 (1032) MaxDisplayHeight 0x054A (1354) MaxDisplayRow 0x054C (1356) MaxDisplayWidth 0x054E (1358) Reserved 0x0550 (1360) Ein Vorrat von sieben SignalSemaphore-Datenstrukturen, die für interne Zwecke bereitgehalten werden. Hier steht im Interlace-Modus die Anzahl der Bildzeilen, die dem System zur Verfügung stehen (400 oder 512). Hier steht der Wert aus MaxDisplayHeight, um eins dekre- mentiert. Hier steht eine Kopie des Wertes NormalDisplayCol aus der GFXBase-Datenstruktur. Reservierter Bereich für zukünftige Erweiterungen. Menu Offset C (intuition/intuition.h) Modula-2 (Intuition) Hex Dez struct Menu Menu = { RECORD 0000 0 struct Menu *NextMenu; nextMenu:MenuPtr; 0004 4 SHORT LeftEdge; leftEdge:INTEGER; 0006 6 SHORT TopEdge; topEdge:INTEGER; 0008 8 SHORT Width; width:INTEGER; 000A 10 SHORT Height; height:INTEGER; 000C 12 USHORT Flags; flags:BITSET, 000E 14 BYTE *MenuName; menuName: ADDRESS; 0012 18 struct Menultem *Firstltem; firstItem:MenultemPtr; 0016 22 SHORT JazzX; jazzX:INTEGER; 0018 24 SHORT JazzY; jazzY:INTEGER; 001A 26 SHORT BeatX; beatX:INTEGER; VO1C 28 SHORT BeatY; beatY:INTEGER; 001E 30 | }; END; Assembler Präfix: mu_ Datenstrukturenreferenz »Intuition«: Menu, Window. Routinenreferenz »Intuition«: ClearMenustrip, ItemAdress, OffMenu, L_._> Beschreibung OnMenu, SetMenustrip. In einer linearen Liste, bestehend aus miteinander verketteten Menu-Datenstrukturen, werden die einzelnen Menüpunkte der Menütitelleiste zu einem Window definiert (wie zum Beispiel die Menüpunk- te »Workbench«, »Disk« und »Special« der Workbench). Die dazugehörigen Pull-down-Menüs werden jedoch durch Menultem-Datenstrukturen definiert. 1 NextMenu 0x0000 (0) Ein Adreßzeiger auf die nächste Menu-Datenstruktur in der linearen Liste von angelegten Menüpunkten. Ist der Wert NULL, so ist dies das Ende der Liste. I LeftEdge 0x0004 (4) Die zum linken Bildschirmrand relative x-Koordinate der linken, oberen Ecke des zu diesem Menütitel gehörigen Auswahlkastens in der Menütitelleiste. I TopEdge 0x0006 (6) Die zum oberen Bildschirmrand relative y-Koordinate der linken, oberen Ecke des zu diesem Menütitel gehörigen Auswahlkastens in der Menüititelleiste. In den vorliegenden Versionen wird dieser Parameter von der »intuition.library« noch nicht beachtet. Es wird statt dessen die y-Koordinate des oberen Bildschirmrandes als aktueller Wert benutzt. I Width 0x0008 (8) Die Breite des zu diesem Menütitel gehörigen Auswahl- kastens in der Menüititelleiste. I Height 0x000A (10) Die Breite und die Höhe des zu diesem Menüititel gehörigen Auswahlkastens in der Menütitelleiste. In den vorliegenden Versionen wird der Parameter Height von »Intuition« noch nicht beachtet. Es wird statt dessen die Höhe der Bildschirm- titelleiste als aktueller Wert benutzt. I Flags 0x000C (12) Eine 2-Byte-Marke, bei der folgende gesetzte Bits eine Bedeutung haben: C Modula-2 Hex Beschreibung MENUENABLED menuEnabled 0001 Dieses Pull-down-Menü ist aktiviert. MIDRAWN miDrawn 0100 Dieses Pull-down-Menü wird mo- mentan auf der Titelleiste dargestellt. _] MenuName 0x000E (14) Ein Adreßzeiger auf eine Null-terminierte Zeichenkette, die den Titel dieses Menüpunktes enthält. 1 FirstItem 0x0012 (18) Ein Adreßzeiger auf die erste von mehreren miteinander linear verketteten Menultem-Datenstrukturen, die zu diesem Menüpunkt gehören. „1 JazzX 0x0016 (22) Von »Intuition« intern verwendeter Systemparameter. I JazzY 0x0018 (24) Von »Intuition« intern verwendeter Systemparameter. II BeatX 0x001A (26) Von »Intuition« intern verwendeter Systemparameter. 4 BeatY 0x001C (28) Von »Intuition« intern verwendeter Systemparameter. Menultem struct Menultem Menultem = Offset C (intuition/intuition.h) Modula-2 (Intuition) { RECORD struct Menultem *Nextltem; nextltem:MenultemPitr; 0 4 SHORT LeftEdge; 6 SHORT TopEdge; 8 SHORT Width; 10 SHORT Height; 12 USHORT Flags; 14 LONG MutualExclude; mutualExclude:LONGSET; APTR ItemFill; 22 APTR SelectFill; 26 BYTE Command; leftEdge:INTEGER; topEdge:INTEGER; width:INTEGER; height: INTEGER; flags:MenultemFlagsSet; itemFill: ADDRESS; selectFill: ADDRESS; command:CHAR; 28 struct Menultem *Subltem; subltem:MenultemPtr; USHORT NextsSelect; nextSelect:CARDINAL; 34 }; Assembler Datenstrukturenreferenz Routinenreferenz > Beschreibung END; Präfix: mi_ »Intuition«: Menu, Menultem. »Intuition«: ItemAddress, OffMenu, OnMenu. In einer linearen Liste, bestehend aus verketteten Menultem-Datenstrukturen, werden alle Menüpunkte eines einzelnen Pull-down-Menüs definiert (wie zum Beispiel die Menüpunkte »Empty Trash« und »Initialize« im Pull-down-Menü »Disk« der Workbench). Dabei gibt es Action-Menüpunkte, bei denen einmalig etwas ausgeführt wird (z.B. Laden einer Datei) und Artribute-Menüpunkte, bei denen Zustände ein- und ausgeschaltet werden können (z.B. eine besondere Schriftart). Die zu dieser Datenstruktur gehörigen Basismenüpunkte der Menütitelleiste werden durch Menu-Datenstrukturen definiert. 1 Nextltem 0x0000 (0) I LeftEdge 0x0004 (4) I TopEdge 0x0006 (6) U Width 0x0008 (8) Ein Adreßzeiger auf die nächste Menultem-Datenstruktur in der linearen Liste von angelegten Menüpunkten. Ist der Wert NULL, so ist dies das Ende der Liste. Die y-Koordinate der linken, oberen Ecke des Auswahl- kastens zu diesem Menüpunkt, relativ zu dem LeftEdge- Wert in der zugehörigen Menu-Datenstruktur. Die x-Koordinate der linken, oberen Ecke des Auswahl- kastens zu diesem Menüpunkt, relativ zu dem TopEdge- Wert in der zugehörigen Menu-Datenstruktur. Die Breite des zu diesem Menütitel gehörigen Auswahl- kastens in der Menüititelleiste. I Height 0x000A (10) I Flags 0x000C (12) C CHECKIT ITEMTEXT COMMSEQ MENUTOGGLE ITEMENABLED HIGHCOMP HIGHBOX CHECKED ISDRAWN HIGHITEM MENUTOGGLED II MutualExclude 0x000E (14) J ItemFill 0x0012 (18) Die Höhe des zu diesem Menütitel gehörigen Auswahl- kastens in der Menütitelleiste. Eine 2-Byte-Marke mit Informationen über die Art und den Auswahlzustand dieses Menüpunktes. Ein gesetztes Bit hat jeweils die folgende Bedeutung: Modula-2 Hex Beschreibung checklt 0001 Bei gesetztem Bit ist dies ein Attri- bute-, sonst ein Action-Menüpunkt. itemText 0002 Bei gesetztem Bit wird dieser Menü- punkt mit einem Text, sonst mit einem grafischen Symbol dargestellt. commsSeq Dieser Menüpunkt kann auch abge- kürzt über die Tastatur aktiviert werden. menuToggle 0008 Dies ist ein Attribute-Menüpunkt. itemEnabled 0010 Dieser Menüpunkt kann ausgewählt werden. highComp 0040 Bei Auswahl wird dieser Menüpunkt invertiert. highBox 0080 Bei Auswahl wird dieser Menüpunkt umrandet. checked 0100 Ist dies ein Attribute-Menüpunkt, so kann er bei gelöschtem Bit noch ausgewählt werden. isDrawn 1000 Es wird gerade ein Untermenü angezeigt. highltem 2000 Dieser Menüpunkt ist gerade ausgewählt. menuToggled 4000 Dieser Attribute-Menüpunkt ist eingeschaltet. Bei Artribute-Menüpunkten gibt das Bitmuster dieser 4-Byte-Maske an, ob andere Artribute-Menüpunkte dieses Untermenüs noch zugänglich sind, wenn dieser Menüpunkt bereits aktiviert ist. In einem Pull-down-Menü zur Wahl einer Schriftart ist es damit möglich, eine Kombination von bestimmten Schriftarten (wie hoch- und tiefgestellt) zu ver- bieten. Ein gelöschtes Bit bedeutet, daß der korrespondieren- de Menüpunkt dieses Pull-down-Menüs nicht mehr einge- schaltet werden kann. Entsprechend wird bei diesen Menü- punkten das CHECKED-Bit beeinflußt. Dies ist ein Adreßzeiger auf eine /mage- oder IntuiText- Datenstruktur, je nachdem, ob in dem Auswahlkasten eine Grafik oder ein Text ausgegeben wird. Bestimmt wird dies durch das /TEMTEXT-Bit. I SelectFill 0x0016 (22) Dieser Adreßzeiger wird nur benötigt, wenn das AIGH- ITEM-Bit in Flags gesetzt ist. In diesem Fall zeigt dieser Adreßzeiger auf die alternative /mage- oder IntuiText-Da- tenstruktur, die angeben, welche Grafik oder welcher Text bei der Auswahl dieses Menüpunktes ausgegeben wird. I} Command 0x001A (26) Hier steht das alphanumerisches Zeichen, mit dem dieser | Menüpunkt auch über die Tastatur (in Kombination mit der rechten Amiga-Taste) ausgewählt werden kann. Dieses Abkürzen funktioniert jedoch nur, wenn das COMMSEO- Bit in Flags gesetzt ist. ] Subltem 0x001C (28) Dies ist ein Adreßzeiger auf eine weitere Kette von Menu- Item-Datenstruktur, durch die ein weiteres Untermenü defi- niert werden kann. Ist kein solches Untermenü vorhanden, so steht hier Null. 1 NextSelect 0x0020 (32) In dieses Feld wird durch »Intuition« automatisch die Menü- nummer des nächsten, ausgewählten Menüpunktes eingetra- gen. Ist dieser Wert OxFFFF (—-1), so bedeutet dies, daß kein weiterer Menüpunkt ausgewählt ist. NewScreen C (intuition/intuition.h) Modula-2 (Intuition) Hex Dez struct NewScreen NewScreen = { RECORD 0000 0 SHORT LeftEdge; leftEdge:INTEGER; 0002 2 SHORT TopEdge; topEdge:INTEGER; 0004 4 SHORT Width; width:INTEGER; 0006 6 SHORT Height; height:INTEGER; 0008 8 SHORT Depth; depth:INTEGER; 000A 10 UBYTE DetailPen; detailPen:Byte; 000B 11 UBYTE BlockPen; blockPen:Byte; 000€ 12 USHORT ViewModes; viewModes:ViewModeSet; 000E 14 USHORT Type; type:ScreenFlagsSet; 0010 16 struct TextAttr *Font; font: TextAttrPtr; 0014 20 UBYTE *DefaultTitle; defaultTitle- ADDRESS; 0018 24 struct Gadget *Gadgets; gadgets:GadgetPtr; 001C 28 struct BitMap *CustomBitMap; customBitMap:BitMapPtr; 0020 32 }; END; | Assembler Datenstrukturenreferenz Routinenreferenz > Beschreibung Präfix: nS_ Keine. »Intuition«: OpensScreen. Die NewScreen-Datenstruktur wird verwendet, um die Eigenschaften des Screens zu bestimmen, der durch die Routine OpenScreen geöffnet wird. Nach dem Öffnen gehört zu jedem Bildschirm eine Screen- Datenstruktur, die die jeweils aktuellen Parameter beinhaltet. I LeftEdge 0x0000 (0) I TopEdge 0x0002 I Width 0x0004 (4) I Height 0x0006 (6) I Depth 0x0008 (8) I DetailPen 0x000A (10) J BlockPen 0x000B (11) I ViewModes 0x000C (12) 1 Type 0x000E (14) J Font 0x0010 (16) Die x-Koordinate der linken obere Ecke des Bildschirms. Stellen Sie bitte sicher, daß dieser Wert immer Null ist, daein horizontales Verschieben in den vorliegenden Versionen noch nicht implementiert ist. Die y-Koordinate der linken oberen Ecke des Bildschirms. Die Breite des Bildschirms, wobei dieser Wert nur 320 oder 640 sein darf, je nachdem, ob der Darstellungsmodus LoRes oder HiRes ist. Die Höhe des Bildschirms, wobei die Summe aus diesem Wert und TopEdge im Interlace-Modus 512, sonst 256 erge- ben muß. Die Anzahl der BitPlanes, die zu diesem Bildschirm gehö- ren. Also je nach Darstellungsmodus zwischen 1 und 6. Die Nummer des Farbregisters, dessen Inhalt als Farbe für die »Details« verwendet wird, also z.B. für die Einzelheiten in den »Gadgets« und der Schrift in der Titelleiste. Die Nummer des Farbregisters, dessen Inhalt als Farbe für »gröbere« Elemente verwendet wird, also z.B. für das Füllen der Titelleiste. Diese 2-Byte-Marke enthält die ViewMode-Flags, die unter anderem die Auflösung bestimmen. Eine genaue Beschrei- bung dieser Flags finden Sie im Kapitel über »Graphics«. Diese 2-Byte-Marke enthält die Screen-Flags. Eine genaue Beschreibung dieser Flags finden Sie in dem Abschnitt »Wichtige Flags der Intuition-Library«. Ein Adreßzeiger auf eine TextAttr-Datenstruktur. Die in ihr eingestellten Parameter definieren für diesen Bildschirm einen Default-Font (wird in allen Displayelementen, wie z.B. Fenster, als voreingestellte Schriftart verwendet). Steht hier NULL, so wird der in der /IntuitionBase-Datenstruktur voreingestellte Zeichensatz benutzt. I DefaultTitle 0x0014 (20) Adreßzeiger auf eine Null-terminierte Zeichenkette, die als Überschrift in der Titelleiste des Bildschirms erscheint. Steht hier der Wert NULL, so wird kein Text ausgegeben. I Gadgets 0x0018 (24) Dieses Feld muß NULL sein, da es in den vorliegenden Versionen noch keine Verwendung hat. I] CustomBitMap 0x001C (28) Wollen Sie den Displayspeicher zu diesem Bildschirm selbst bestimmen, so setzen Sie an diese Stelle einen Adreßzeiger auf eine von Ihnen vorbereitete BitMap-Datenstruktur. Zusätzlich muß dann das CUSTOMBITMAP-Bit in Types gesetzt werden. NewWindow Offset C (intuition/intuition.h) Modula-2 (Intuition) Hex Dez struct NewWindow NewWindow = { RECORD 0000 0 SHORT LeftEdge; leftEdge:INTEGER; 0002 2 SHORT TopEdge; topEdge:INTEGER; 0004 4 SHORT Width; width:INTEGER; 0006 6 SHORT Height; height:INTEGER; 0008 8 UBYTE DetailPen; detailPen:Byte; 0009 9 UBYTE BlockPen; blockPen:Byte; 000A 10 ULONG IDCMPHlags; idempFlags:IDCMPFlagsSet; 000E 14 ULONG Flags; flags:WindowFlagsSet; 0012 18 struct Gadget *FirstGadget; firstGadget:GadgetPtr; 0016 22 struct Image *CheckMark; checkMark:ImagePitr; 001A 26 UBYTE *Title; title ADDRESS; O01E 30 struct Screen *Screen; screen:ScreenPtr; 0022 34 struct BitMap *BitMap; bitMap:BitMapPtr; 0026 38 SHORT MinW idth; minWidth:INTEGER; 0028 40 SHORT MinHeight; minHeight:INTEGER; 002A 42 USHORT MaxWidth; maxWidth:INTEGER; 002C 44 USHORT MaxHeisht; maxHeight:INTEGER; 002E 46 USHORT Type; type:ScreenFlagset; 0030 48 }; END; Assembler Präfix: nw_ Datenstrukturenreferenz »Workbench«: DrawerData. Routinenreferenz »Intuition«: OpenWindow. Die NewWindow-Datenstruktur wird verwendet, um die Eigenschaften des Fensters festzulegen, das durch die Routine OpenWindow geöffnet wird. Nach dem Öffnen gehört zu jedem Fenster eine Window- Datenstruktur, die die jeweils aktuellen Parameter enthält. I J [ LeftEdge 0x0000 (0) TopEdge 0x0002 (2) Width 0x0004 (4) Height 0x0006 (6) DetailPen 0x0008 (8) BlockPen 0x0009 (9) IDCMPFlags 0x000A (10) Flags 0x000E (14) FirstGadget 0x0012 (18) CheckMark 0x0016 (22) Title 0x001A (26) Screen 0x001E (30) Der Abstand des Fensters vom linken Rand des zugehörigen Bildschirms. Der Abstand des Fensters vom oberen Rand des zugehörigen Bildschirms. Die Breite des Fensters. Die Höhe des Fensters. Die Nummer des Farbregisters, dessen Inhalt als Farbe für die »Details« verwendet wird, also z.B. für die Einzelheiten in den »Gadgets« und der Schrift in der Titelleiste. Die Nummer des Farbregisters, dessen Inhalt als Farbe für »gröbere« Elemente verwendet wird, also z.B. für das Füllen der Titelleiste. Diese 2-Byte-Marke enthält die /IDCMP-Flags, mit denen das zugehörige Window initialisiert wird. Eine genaue Be- schreibung dieser Flags finden Sie indem Abschnitt »Wich- tige Flags der Intuition-Library«. Diese 2-Byte-Marke enthält die Window-Flags, mit denen das zugehörige Window initialisiert wird. Eine genaue Be- schreibung der Window-Flags finden Sie in dem Abschnitt »Wichtige Flags der Intuition-Library«. Ein Adreßzeiger auf eine lineare Liste von verketteten Gad- get-Datenstrukturen, die die Gadgets zu diesem Window de- finieren. Sind keine Gadgets definiert, so steht hier NULL. BEACHTE: Systemgadgets werden über die Window- Flags definiert. Ein Adreßzeiger auf eine /mage-Datenstruktur, die das Checkmark zu dem Menü dieses Windows definiert. Steht hierNULL, so wird das Default-Checkmark (ein Häkchen) in den Pull-down-Menüs verwendet. Ein Adreßzeiger auf eine Null-terminierte Zeichenkette, die in der Titelleiste des Windows ausgegeben wird. Als Zei- chensatz wird der Font des zugehörigen Bildschirms ver- wendet. Ist in Types das Bit CUSTOMSCREEN gesetzt, so steht hier ein Adreßzeiger auf die zugehörige Screen-Datenstruktur. I BitMap 0x0022 (34) 1 MinWidth 0x0026 (38) I MinHeight 0x0028 (40) 1 MaxWidth 0x002A (42) 1 MaxHeight 0x002C (44) O Type 0x002E (46) PenPair Ist in Flags das Refresh-Bit SUPERBITMAP gesetzt, so muß hier ein Adreßzeiger auf eine BitMap-Datenstruktur stehen, die die Grafikdaten des Windows aufnehmen kann. Hat das Fenster ein Sizing-Gadget, so kann es der Benutzer mit dem Sizing-Gadget bis auf diese minimale Breite ver- kleinern. Hat das Fenster ein Sizing-Gadget, so kann es der Benutzer mit dem Sizing-Gadget bis auf diese minimale Höhe verklei- nern. Hat das Fenster ein Sizing-Gadget, so kann es der Benutzer mit dem Sizing-Gadget bis auf diese maximale Breite ver- breitern. Hat das Fenster ein Sizing-Gadget, so kann es der Benutzer mit dem Sizing-Gadget bis auf diese maximale Höhe vergrö- Bern. In dieser 2-Byte-Marke stehen die Screen-Flags zu diesem Window. Eine genaue Beschreibung dieser Flags finden Sie in dem Abschnitt »Wichtige Flags der Intuition-Library«. C (intuition/intuitionbase.h) Modula-2 (Intuition) struct PenPair { PenPair = RECORD UBYTE DetailPen; detailPen:UByte; b Assembler Datenstrukturenreferenz Routinenreferenz ___> Beschreibung UBYTE BlockPen; blockPen:UByte; END; Diese systeminterne Datenstruktur ist in Assembler nicht definiert. »Intuition«: GListEnv. Keine. Diese systeminterne Datenstruktur wird in die GListEnv-Datenstruktur eingebunden und beinhaltet zwei Nummern von Farbregistern. I DetailPen 0x0000 (0) Die Nummer des Farbregisters, dessen Inhalt als Farbe für die »Details« verwendet wird, also z.B. für die Einzelheiten in den Gadgets und die Schrift in der Titelleiste. I BlockPen 0x0001 (1) Die Nummer des Farbregisters, dessen Inhalt als Farbe für »gröbere« Elemente verwendet wird, also z.B. für das Füllen der Titelleiste. Point Offset C (intuition/intuitionbase.h) Modula-2 (Intuition) Hex Dez struct Point Point = { RECORD 0000 0 SHORT X; x:INTEGER; 0002 2 SHORT Y; y:INTEGER; 0004 4 }; END; Assembler Diese systeminterne Datenstruktur ist in Assembler nicht definiert. Datenstrukturenreferenz »Intuition«: IntuitionBase. Routinenreferenz Keine. 0. Beschreibung Diese Datenstruktur wird in die /IntuitionBase-Datenstruktur eingebunden und dient zur Speicherung der Koordinaten eines Punktes. I X 0x0000 (0) Die x-Koordinate des Punktes. I 0x0002 (2) Die y-Koordinate des Punktes. Preferences om C (intuition/intuition.h) Modula-2 (Intuition) Hex Dez struct Preferences Preferences = ( RECORD 0000 0 BYTE FontHeight; fontHeight:UByte; 0001 1 UBYTE PrinterPort; printerPort:PrinterPort; 0002 2 USHORT BaudRate; baudRate:CARDINAL; 0004 4 struct timeval KeyRptSpeed; keyRptSpeed:TimeVal; 0V0O0OC 12 struct timeval KeyRptDelay; keyRptDelay:TimeVal; 0014 20 struct timeval DoubleClick; doubleClick:TimeVal; 001C 28 USHORT PointerMatrix[36]; pointerMatrix:ARRAY[0..35] OF CARDINAL; 0064 100 BYTE XOffset; xOffset:Byte; 0065 101 BYTE YOffset; yOffset:Byte; Offset C (intuition/intuition.h) Modula-2 (Intuition) Hex 0066 0068 006A 006C 0O06E 0070 0072 0074 0076 0077 0078 007A 007C 0O07E 0080 009E 00AO 00A2 00A4 00A6 00A8 00AA VOAC VODAE 00BO 00B2 00B4 00B6 00B7 00B8 00B9 00BA 00D8 00D9 00DA 00DC 00DE 00EO O0E1 00E2 00E4 Dez 102 104 106 108 110 112 114 116 118 119 120 122 124 126 128 158 160 162 164 166 168 170 172 174 176 178 180 182 183 184 185 186 216 214 218 220 222 224 223 226 228 USHORT color17; USHORT color18; USHORT color19; USHORT PointerTicks; USHORT color0; USHORT color]; USHORT color2; USHORT color; BYTE ViewXOffset; BYTE ViewYOffset; WORD ViewlnitX; WORD ViewlnitY; BOOL EnableCLI; USHORT PrinterType; UBYTE PrinterFilename[30]; USHORT PrintPitch; USHORT PrintQuality; USHORT PrintSpacing; UWORD PrintLeftMargin; UWORD PrintRightMargin; USHORT Printlmage; USHORT PrintAspect; USHORT PrintShade; WORD PrintThreshold; USHORT PapersSize; UWORD PaperLength; USHORT PaperType; UBYTE SerRWBits; UBYTE SerStopBuf; UBYTE SerParShk; UBYTE LaceWB; UBYTE WorkName[30]; BYTE RowSizeChange; BYTE ColumnSizeChange; UWORD PrintFlags; UWORD PrintMaxWidth; UWORD PrintMaxHeigth; UBYTE PrintDensity; UBYTE PrintXOffset; UWORD wb _Width; UWORD wb_Heigth; color17:CARDINAL; color18:CARDINAL; color19:CARDINAL; pointerTicks:CARDINAL; colorO:CARDINAL; colorl:CARDINAL; color2:CARDINAL; color3:CARDINAL; viewXOffset:Byte; view YOffset:Byte; viewlnitX:INTEGER; viewlnitY:INTEGER; enableCLI:CARDINALIT;, printerType:CARDINALI; printerFilename: ARRAY [0..29] OF CHAR; printPitch:;CARDINAL; printQuality:CARDINAL; printSpacing:CARDINAL; printLeftMargin:CARDINAL; printRightMargin:CARDINAL; printlmage:CARDINAL; printAspect:CARDINAL; printShade:CARDINAL; printThreshold:INTEGER; paperSize:CARDINAL; paperLength:CARDINAL; paperType:CARDINAL; serRWBits:UByte; serStopBuf:UByte; serParShk:SerParShkSet; laceWB:BOOLEAN; workName:ARRAY[0..29] OF CHAR; padding: ARRAY [0..15] OF BYTE; oe C (intuition/intuition.h) UBYTE wb_Depth; UBYTE ext_Size; }: Assembler | Präfix: Datenstrukturenreferenz »Intuition«: »PrtBase«: Routinenreferenz »Intuition«: L__> Beschreibung Modula-2 (Intuition) pf_ IntuitionBase. PrinterData. GetDefPrefs, GetPrefs, SetPrefs. In der Preferences-Datenstruktur werden die von dem Programm »Preferences« bekannten Voreinstel- lungen abgelegt. I FontHeight 0x0000 (0) Folgende zwei Konstanten geben die Schriftbreite des Systemzeichensatzes an: Modula-2 Hex TOPAZ_EIGHTY topazEighty 0008 TOPAZ_SIXTY topazSixty 0009 Beschreibung Einstellen des Systemzeichensatzes auf 80 Zeichen pro Zeile. Einstellen des Systemzeichensatzes auf 60 Zeichen pro Zeile. 1 PrinterPort 0x0001 (1) Folgende Bits sind für dieses Feld definiert: Modula-2 Hex PARALLEL_PRINTER parallelPrinter 0000 SERIAL_PRINTER serialPrinter 0001 Beschreibung Drucker befindet sich am Parallel-Port. Drucker befindet sich am Serial-Port. II BaudRate 0x0002 (2) Folgende Konstanten definieren die verschiedenen Baud- raten (Baud = übertragende Bits pro Sekunde) der seriellen Schnittstelle: Modula-2 Beschreibung BAUD_110 baud110 0000 Setzt die Baudrate auf 110 Bits/s. BAUD_300 baud300 0001 Setzt die Baudrate auf 300 Bits/s. BAUD_1200 baud1200 0002 Setzt die Baudrate auf 1200 Bits/s. BAUD_2400 baud2400 0003 Setzt die Baudrate auf 2400 Bits/s. BAUD_4800 baud4800 0004 Setzt die Baudrate auf 4800 Bits/s. BAUD_9600 baud9600 0005 Setzt die Baudrate auf 9600 Bits/s. BAUD_19200 baud19200 0006 Setzt die Baudrate auf 19200 Bits/s. BAUD_MIDI baudMidi 0007 Setzt die Baudrate auf die Midi-Norm. I KeyRptSpeed 0x0004 (4) I KeyRptDelay 0x000C (12) 1 DoubleClick 0x0014 (20) J PointerMatrix 0x001C (28) 41 XOffset 0x0064 (100) U YOffset 0x0065 (101) I color17 0x0066 (102) 4 color18 0x0068 (104) I color19 0x006A (106) II PointerTicks 0x006C (108) I color0 0x006E (110) „I colori 0x0070 (112) Diese eingebundene TimeVal-Datenstruktur definiert die Zeitspanne, die bei der Tastenwiederholung (Gedrückthal- ten einer Taste) zwischen der Ausgabe der einzelnen Zei- chen liegt. Diese eingebundene TimeVal-Datenstruktur definiert die Zeitspanne, die das System beim Drücken einer Taste wartet, bevor sie ständig wiederholt wird. Diese eingebundene TimeVal-Datenstruktur definiert die Zeitspanne, die zwischen zwei »Maus-Klicks« liegen darf, damit dies als »Doppel-Klick« erkannt wird. Hier sind die Grafikdaten eingebunden, die den Standard- Mauszeiger als Sprite definieren. Der x-Offset des Hot-Spots in dem Mauszeiger. Der y-Offset des Hot-Spots in dem Mauszeiger. Der Farbwert, der als erste Farbe für die Darstellung des Mauszeigers verwendet wird. Der Farbwert, der als zweite Farbe für die Darstellung des Mauszeigers verwendet wird. Der Farbwert, der als dritte Farbe für die Darstellung des Mauszeigers verwendet wird. Dieser Wert beschreibt den Übersetzungsfaktor der Mausbe- wegungen. Die sinnvollen Werte sind die Zweierpotenzen 1, 2, oder 4. Für größere Werte fordert die Maus viel Bewe- gungsfreiheit, für 64 bereits eine Fläche von der Größe einer Tischtennisplatte. Der Farbwert, der als Default-Hintergrundfarbe verwendet wird. Der Farbwert, der als Default-Vordergrundfarbe (Farbe der Windows und des Textes) verwendet wird. U io DD .ı.oo0 I] PrinterFilename 0x0080 (128) color2 0x0072 (114) color3 0x0074 (116) ViewXOffset 0x0076 (118) ViewYOffset 0x0077 (119) ViewInitX 0x0078 (120) ViewlnitY 0x007A (122) EnableCLI 0x007C (124) PrinterType 0x007E (126) C CUSTOM_NAME ALPHA_P_101 BROTHER_15XL CBM_MPS1000 DIAB_630 DIAB_ADV_D25 DIAB_C_150 EPSON EPSON_JX_80 OKIMATE_20 QUME_LP_20 HP_LASERJET HP_LASERJET _PLUS Der Farbwert, der als dritte Default-Farbe (z.B. in den Close- und Depth-Gadgets) verwendet wird. Der Farbwert, der als vierte Default-Farbe (z.B. für den Standard-Textcursor) verwendet wird. Der x-Offset des Gesamtdisplays. Der y-Offset des Gesamtdisplays. Der x-Initialisierungswert für alle Views. Der y-Initialisierungswert für alle Views. Ein Boolescher Ausdruck, der angibt, ob das »CLI-Icon« auf dem Display erscheinen soll (TRUE) oder nicht (FALSE). In den neueren Versionen wird dieser Wert jedoch nicht mehr beachtet, das Icon erscheint immer. Folgende Konstanten definieren die verschiedenen Drucker- typen, die von den Preferences unterstützt werden: Modula-2 Hex Beschreibung customName 0000 Ein Drucker, der nicht mit einem der unten aufgeführten kompatibel ist. alphaP 101 0001 Ein Alphacom oder Alphaprp-101- Typenraddrucker. brotherlSXL 0002 Ein Brother-HR-15XL- Typenraddrucker. cbmMps1000 0003 Ein Commodore-MPS-1000- Matrixdrucker. diab630 0004 Ein Diablo-630-Typenraddrucker. diabAdvD25 0005 Ein Diablo Advantage-D251- Typenraddrucker. diabC150 0006 Ein Diablo-C-150-Farbdrucker. epson 0007 Ein Epson-Drucker der RX/FX-Reihe. epsonJX80 0008 Ein Epson-JX-80-Farbdrucker okimate20 0009 Ein Okimate-20-Farbdrucker. QumeLP20 000A Ein Qume-LetterPro-20- Typenraddrucker. hpLaserjet 000B Ein Hewlett-Packard-LaserJet- Laserdrucker. hpLaserjet 000C Ein Hewlett-Packard-LaserJet-Plus- Plus Laserdrucker. Der Name des Druckertreibers, falls in PrinterType CU- STOM eingestellt ist. Der Druckertreiber muß sich in dem Unterverzeichnis »devs/printers« befinden. I PrintPitch 0x009E (158) I PrintQuality 0x00A0 (160) Modula-2 DRAFT draft LETTER U PrintSpacing 0x00A2 (162) letter Die momentan eingestellte Zeichendichte. Dieses Feld kann die Werte 10, 12 oder 15 annehmen. Das entspricht den Schriftarten Pica, Elite oder Fine und auf DIN A4 80, 96 oder 120 Zeichen pro Zeile. Die folgenden Konstanten definieren die Druckbildqualität. Beschreibung Draft-Schrift (Ausdruck mit der Stan- dard-Schriftart) NLQ-Schrift (Ausdruck mit der »Near Letter Quality«-Schriftart) Die folgenden Konstanten definieren den Zeilenabstand. C Modula-2 Hex Beschreibung SIX_LPI sıxLPI 0000 Setzt den Zeilenabstand auf 6 LPI (Lines per Inch). EIGHT_LPI eightLPI 0200 Setzt den Zeilenabstand auf 8 LPI (Lines per Inch). U PrintLeftMargin 0x00A4 (164) 4 PrintRightMarging 0x00A6 (166) I PrintImage 0x00A8 (168) Modula-2 IMAGE_POSITIVE IMAGE_NEGATIVE imagePositive 0000 imageNegative 0001 Der momentan eingestellte linke Rand, also ab der wieviel- ten Spalte bei der Ausgabe auf den Drucker der Text ge- druckt wird. Der momentan eingestellte rechte Rand, also bis zur wieviel- ten Spalte bei der Ausgabe auf den Drucker der Text ge- druckt wird. Die folgenden Werte definieren bei einem Grafikausdruck das Druckbild. Hex Beschreibung Nur die gelöschten Bits werden ausgedruckt. Nur die gesetzten Bits werden ausgedruckt. I PrintAspect 0x00AA (170) Die folgenden Werte definieren bei einem Grafikausdruck die Lage des Druckbildes. Modula-2 Hex Beschreibung ASPECT_HORIZ aspectHoriz 0000 Die Grafik wird horizontal (normal) | ausgedruckt. ASPECT_VERT aspectVert 0001 Die Grafik wird vertikal (um 90 Grad gedreht) ausgedruckt. J PrintShade 0x00AC (172) Die folgenden Werte definieren bei einem Grafikausdruck die Schattierung. C Modula-2 Hex Beschreibung SHADE_BW shadeBW 0000 In Abhängigkeit von PrintImage werden gelöschte, bzw. gesetzte Bits, schwarz auf weiß ausgedruckt. SHADE_GREYSCALE shade Greyscale 0001 Erstreckt sich die Grafik über mehrere Bitplanes, so werden die Farben in verschiedene Grautöne umgerechnet. SHADE_COLOR shadeColor 0002 Istein Farbdrucker angeschlossen, so wird die Grafik in Farbe ausgedruckt. 1 PrintThreshold 0x00AE (174) Dieser Wer bestimmt im _PrintShade-Modus SHADE_GREYSCALE die allgemeine Graustufe. Sinnvol- le Werte liegen zwischen 1 und 15. I PaperSize 0x00B0 (176) Die folgenden Werte definieren das Format des verwendeten Druckerpapiers. C Modula-2 Hex Beschreibung US_LETTER usLetter 0000 Amerikanische Brief-Norm. US_LEGAL usLegal 0010 Amerikanische Amts-Norm. N_TRACTOR nTractor 0020 Papierbreite maximal ca. 25 cm. W_TRACTOR wTractor 0030 Papierbreite maximal ca. 35 cm. CUSTOM custom 0040 Keine der oben genannten. 4 PaperLength 0x00B2 (178) Ist in PaperSize das Flag CUSTOM gesetzt, so muß hier die Seitenlänge des Druckerpapiers in Zeilen stehen. II PaperType 0x00B4 (180) Die folgenden Werte definieren die Art des Druckerpapiers. FANFOLD SINGLE _J SerRWBits 0x00B6 (182) SWRITE_BITS SREAD_BITS Modula-2 Hex Beschreibung fanfold 0000 Es wird Endlospapier verwendet. single 0080 Es wird Einzelblattpapier verwendet. Die folgenden Werte definieren in dieser 1-Byte-Marke für die serielle Schnittstelle die Anzahl der Read- und Write- Bits. Modula-2 Hex Beschreibung writeBits 000F Das untere Nibbel enthält die Anzahl der zu schreibenden Bits. readBits 00FO Das obere Nibbel enthält die Anzahl der zu lesenden Bits. I SerStopBuf 0x00B7 (183) SBUFSIZE_BITS SSTOP_BITS I SerParShk 0x00B8 (184) Die folgenden Werte definieren in dieser 1-Byte-Marke für die serielle Schnittstelle die Anzahl der Stop-Bits. Modula-2 Hex Beschreibung bufSizeBits O000F Das untere Nibbel enthält die Größe des Datenpuffers. stopBits 00FO Das obere Nibbel enthält die Anzahl der Stop-Bits. Das untere Nibbel dieses Werts enthält den Handshake- Modus, das obere die Parität. Folgende Flags können gesetzt werden: Modula-2 Beschreibung SHSHAKE_XON SHSHAKE_RTS SHSHAKE_NONE SPARITY_BITS SPARITY_NONE SPARITY_EVEN SPARITY_ODD shakeXon 0000 Handshake-Modus xOn/xOff. shakeRts 0001 Handshake-Modus RTS/CTS. shakeNone 0002 Kein Handshake Modus. 00F0 Das obere Nibbel für die Parität. parityNone 0000 Keine Parität. parityEven 0001 Gerade Parität. parityOdd 0002 Ungerade Parität. I. 4 4 4 J J LaceWB 0x00B9 (185) WorkName 0x00BA (186) RowSizeChange 0x00D8 (216) ColumnSizeChange 0x00D9 (217) PrintFlags 0x00DA (218) PrintMaxWidth 0x00DC (220) PrintMaxHeigth 0x00DE (222) PrintDensity 0x00E0 (224) PrintXOffset 0x00E1 (225) wb_Width 0x00E2 (226) wb_Heigth 0x00E4 (228) wb_Depth 0x00E6 (230) Size 0x00E7 (231) Wird die Workbench im Interlace-Modus dargestellt, so steht hier 1, sonst 0. Ein 30-Byte langer Zwischenspeicher für den Drucker- namen. ' Größenveränderungsfaktor für die Zeilen. Größenveränderungsfaktor für die Spalten. In dieser 2-Byte-Marke können durch den Benutzer eigene Druckerflags eingeführt werden. Die maximale Breite eines Grafikausdrucks in zehntel Inch. Die maximale Höhe eines Grafikausdrucks in zehntel Inch. Die Zeichendichte, mit der die Grafik ausgedruckt werden soll. Der linke Rand bei einem Grafikausdruck in zehntel Inch. Die Breite des Workbench-Screens (nicht veränderbar). Die Höhe des Workbench-Screens. Die Tiefe (Anzahl der Bitplanes) des Workbench-Screens. Interner Systemparameter, der nicht verändert werden darf. Propinfo Offset C (intuition/intuition.h) Modula-2 (Intuition) Hex Dez struct PropInfo PropInfo = RECORD 0000 0 USHORT Flags; flags:PropInfoFlagSet; 0002 2 USHORT HorizPot; horizPot:CARDINAL; 0004 4 USHORT VertPot; vertPot:CARDINAL; 0006 6 USHORT HorizBody; horizBody:CARDINAL; 0008 8 USHORT VertBody; vertBody:CARDINAL; 000A 10 USHORT CWidth; cWidth:CARDINAL; 000C 12 USHORT CHeight; cHeight:CARDINAL; O00E 14 USHORT HPotRes; hPotRes:CARDINAL; 0010 16 USHORT VPotRes; vPotRes:CARDINAL; USHORT LeftBorder; leftBorder:CARDINAL; topBorder:CARDINAL; h USHORT TopBorder; END; Assembler Datenstrukturenreferenz Routinenreferenz nn Beschreibung Präfix: pi_ »Intuition«: Gadget, IntuitionBase. Keine. Dies ist eine zusätzliche Datenstruktur für Proportional-Gadgets. Bei dieser Art von Gadgets kann ein zugehöriger Wert über einen verstellbaren »Knopf«, ähnlich wie bei einem Schieberegler (oder -Potentiometer), eingestellt werden. Der Bereich, in dem der Knopf bewegt werden kann, ist die innere Fläche des Gadgets und heißt »Container«. Typische Anwendungen der Proportional-Gadgets sind Farbauswahl oder Positionseinstellungen in langen Texten. I Flags 0x0000 (0) C AUTOKNOB FREEHORIZ FREEVERT PROPBORDERLESS KNOBHIT J HorizPot 0x0002 (2) 1 VertPot 0x0004 (4) I HorizBody 0x0006 (6) Folgende Bits dieser 2-Byte-Marke sind definiert: Modula-2 Beschreibung autoKnob Der Knopf ist ein Rechteck, dessen Größe ebenfalls einen Para- meter proportional darstellt. freeHoriz 0002 Der Knopf kann horiz. bewegt werden. freeVert 0004 Der Knopf kann vertikal bewegt werden. propBorderless 0008 Es wird kein Rahmen um den Bereich gezeichnet, in dem der Knopf bewegt werden kann. knobHit 0100 Der Knopf wird gerade bewegt. Momentan eingestellter Wert in horizontaler Richtung. Dabei ist der kleinste Wert Null und der größte OxFFFF (65535), es müssen also gegebenenfalls Anpassungen vor- genommen werden, um Werte in den gewünschten Berei- chen (z.B. zwischen O0 und 15 bei Farbeinstellungen) zu erhalten. Inwiefern dieser Wert veränderbar ist, wird durch FREEHORIZ in Flags definiert. Momentan eingestellter Wert in vertikaler Richtung. Dabei ist der kleinste Wert Null und der größte OxFFFF (65535), es müssen also gegebenenfalls Anpassungen vorgenommen werden, um Werte in den gewünschten Bereichen zu erhal- ten. Inwiefern dieser Wert veränderbar ist, wird durch FREEVERT in Flags definiert. Der hier eingestellte Wert bestimmt die Schrittweite von HorizPot. Ist das Flag AUTOKNOB in Flags gesetzt, so bestimmt dieser Wert auch die Breite des Knopfes. 1 VertBody 0x0008 (8) Der hier eingestellte Wert bestimmt die Schrittweite von VertPot. Ist das Flag AUTOKNOB in Flags gesetzt, so bestimmt dieser Wert auch die Höhe des Knopfes. II CWidth 0x000A (10) Hier trägt »Intuition« die aktuelle Breite des Containers ein. U CHeight 0x000C (12) Hier trägt »Intuition« die aktuelle Höhe des Containers ein. „1 HPotRes 0x000E (14) Hier trägt »Intuition« die Anzahl der in horizontaler Rich- tung zu erhaltenden Werte ein. I VPotRes 0x0010 (16) Hier trägt »Intuition« die Anzahl der in vertikaler Richtung zu erhaltenden Werte ein. U LeftBorder 0x0012 (18) Abstand des Containers vom linken Rand des zugehörigen Proportional-Gadgets. 3 TopBorder 0x0014 (20) Abstand des Containers vom oberen Rand des zugehörigen Proportional-Gadgets. Remember Modula-2 (Intuition) Remember = ( RECORD struct Remember *NextRemember; nextRemember:RememberfPtr; ULONG RememberSize; rememberSize:LONGCARD; UBYTE *Memory; memory: ADDRESS; }; END; Assembler Präfix: rm_. Datenstrukturenreferenz »Intuition«: IntuitionBase, Remember. Routinenreferenz »Intuition«: AllocRemember, FreeRemember. 1... Beschreibung Mit Hilfe der Remember-Datenstruktur werden Speicherbereiche für die verschiedensten Anwendungen reserviert. Dabei wird eine Liste von mehreren miteinander verketteten Remember-Datenstrukturen gebildet, die mit einem einzigen Aufruf der Routine FreeRemember wieder freigegeben werden kann. I NextRemember 0x0000 (0) Über diesen Adreßzeiger können mehrere Remember-Da- | tenstrukturen zu einer linearen Liste verknüpft werden. Folgt keine weitere Remember-Datenstruktur, so steht hier NULL. DJ RememberSize 0x0004 (4) Die Größe des Speicherbereichs. 3 Memory 0x0008 (8) Der Adreßzeiger auf den Speicherbereich. Requester Of C (intuition/intuition.h) Modula-2 (Intuition) struct Requester Requester = RECORD struct Requester olderRequest:RequesterPtr; *OlderRequest; SHORT LeftEdge; leftEdge:INTEGER; SHORT TopEdge; topEdge:INTEGER; SHORT Width; width:INTEGER; SHORT Height; height:INTEGER; SHORT Relleft; relLeft:INTEGER; SHORT RelTop; relTop:INTEGER; struct Gadget *RegGadget; reqGadget:GadgetPtr; struct Border *RegBorder; regBorder:BorderPtr; struct IntuiText *RegqText; reqText:IntuiTextPtr; USHORT Flags; flags:RequesterFlagSet; UBYTE BackfFill; backFill:UByte; struct Layer *ReqLayer; reqLayer:LayerPtr; UBYTE RegqPad1[32]; regqPad1:ARRAY [0..31] OF BYTE; struct BitMap *ImageBMap; imageBMap:BitMapPir; struct Window *RWindow; rWindow:WindowPtr; UBYTE RegqPad2[36]; reqPad2: ARRAY [0..35] OF BYTE; }; END; Assembler Präfix: rq_ Datenstrukturenreferenz »Intuition«: GListEnv, Requester, Window. Routinenreferenz »Intuition«: ActivateGadget, AddGList, EndRequest, InitRequester, ModifyProp, NewModifyProp, OffGadget, OnGadget, RefreshGadgets, RefreshGList, Request, SetDMRequest. > Beschreibung Wird ein Requester geöffnet, so stehen in der zugehörigen Requester-Datenstruktur die entsprechenden Informationen über die Darstellung des Requesters. UI OlderRequest 0x0000 (0) Ist bereits ein Requester geöffnet, so trägt »Intuition« hier einen Adreßzeiger auf den zuletzt geöffneten ein. I LeftEdge 0x0004 (4) Ist das POINTREL-Bit in Flags gelöscht, so definiert dieser Wert den Abstand des Requesters vom linken Rand des zugehörigen Windows. TopEdge 0x0006 (6) Width 0x0008 (8) Height 0x000A (10) RelLeft 0x000C (12) RelTop 0x000E (14) RegGadget 0x0010 (16) RegBorder 0x0014 (20) ReqText 0x0018 (24) Flags 0x001C (28) C POINTREL PREDRAWN NOISYREQ REQOFFWINDOW REQACTIVE SYSREQUEST DEFERREFRESH Ist das POINTREL-Bit in Flags gelöscht, so definiert dieser Wert den Abstand des Requesters vom oberen Rand des zugehörigen Windows. Die Breite des gesamten Requesters, also einschließlich der dazugehörigen Texte und Gadgets. Die Höhe des gesamten Requesters, also einschließlich der dazugehörigen Texte und Gadgets. Ist das POINTREL-Bit in Flags gesetzt, so ist dies der horizontale Abstand des Requesters, relativ zur Position des Mauszeigers zum Zeitpunkt der Auslösung. Ist das POINTREL-Bit in Flags gesetzt, so ist dies der vertikale Abstand des Requesters, relativ zur Position des Mauszeigers zum Zeitpunkt der Auslösung. Ein Adreßzeiger auf die lineare Liste von Gadget-Daten- strukturen, die zu diesem Requester definiert sind. ACHTUNG: Hier darf nicht NULL stehen. In der letzten Gadget-Datenstruktur muß in Flags das ENDGADGET-Bit gesetzt sein, damit sich das Requester wieder schließen kann. Ein optionaler Adreßzeiger auf eine Border-Datenstruktur, die dieses Requester umrandet. Ein optionaler Adreßzeiger aufeine /ntuiText-Datenstruktur, die den in diesem Requester auszugebenden Text definiert. Folgende Flags sind für diese 2-Byte-Marke definiert: Modula-2 Hex Beschreibung pointRel 0001 Die Position des Requesters ist relativ zur Position des Mauszeigers. preDrawn 0002 Zu diesem Requester existiert eine eigene Bitmap. noisyReq 0004 Durch Setzen dieses Bits wird ermöglicht, daß weiterhin Tastatur- und Maus-Events auftreten können. reqOffWindow 1000 Dieses Bit wird von »Intuition« gesetzt, wenn sich mindestens ein Requester außerhalb des zugehörigen Fensters befindet. regActive 2000 Das Requester ist aktiv. sysRequest 4000 Ein System-Requester ist aktiv. deferRefresh 8000 Ein Refresh wurde unterbrochen. I BackFill 0x001E (30) II ReqLayer 0x0020 (32) I ReqPadi 0x0024 (36) U ImageBMap 0x0044 (68) I RWindow 0x0048 (72) U ReqPad2 0x004C (76) Screen Hex Dez | 0000 0 0004 4 0008 8 000A 10 000C 12 000E 14 0010 16 0012 18 0014 20 0016 22 001A 26 O0O1E 30 O01F 31 0020 32 0021 33 0022 34 0023 35 0024 36 0025 31 0026 38 0028 40 002C 44 0054 84 00B8 184 00EO 224 Mit der hier stehenden Pen-Nummer können Sie die Hinter- grundfarbe des Requesters wählen. Ein Adreßzeiger auf die Layer-Datenstruktur, die bei der Ausgabe dieses Requesters verwendet wird. Von »Intuition« intern verwendeter Zwischenspeicher. Ist das Bit PREDRAWN in Flags gesetzt, so muß hier ein Adreßzeiger auf eine eigene BitMap-Datenstruktur stehen. C (intuition/intuition.h) struct Screen struct Screen *NextScreen; struct Window *FirstWindow; SHORT LeftEdge; SHORT TopEdge; SHORT Width; SHORT Height; SHORT MouseY,; SHORT MouseX; USHORT Flags; UBYTE *Title; UBYTE *DefaultTitle; BYTE BarHeight; BYTE BarVBorder; BYTE BarHBorder; BYTE MenuVBorder; BYTE MenuHBorder; BYTE WBorTop; BYTE WBorleft; BYTE WBorRight; BYTE WBorBottom; struct TextÄttr *Font; struct ViewPort ViewPort; struct RastPort RastPort; struct BitMap BitMap; struct Layer_Info LayerlInfo; Modula-2 (Intuition) Von »Intuition« intern verwendeter Systemparameter. Von »Intuition« intern verwendeter Zwischenspeicher. Screen = RECORD nextScreen:ScreenPtr; firstWindow:WindowPitr; leftEdge:INTEGER; topEdge:INTEGER; width:INTEGER; height:INTEGER; mouseY:INTEGER; mouseX:INTEGER; flags:ScreenFlagsSet; title ADDRESS; defaultTitle ADDRESS; barHeight:Byte; barV Border:Byte; barHBorder:Byte; menuV Border:Byte; menuHBorder:Byte; wBorTop:Byite; wBorLeft:Byte; wBorRight:Byte; wBorBottom:Byte; font:TextAttrPtr; viewPort: ViewPort; rastPort:RastPort; bitMap:BitMap; layerInfo:Layerlnfo; Offset C (intuition/intuition.h) Modula-2 (Intuition) b Assembler struct Gadget *FirstGadget; firstGadget:GadgetPtr; UBYTE DetailPen; detailPen:UByte; UBYTE BlockPen; blockPen:UByte; USHORT SaveColord; saveColor0:CARDINAL; struct Layer *BarLayer; barLayer:LayerPtr; UBYTE *ExtData; extData: ADDRESS; UBYTE *UserData; userData: ADDRESS; j END; Präfix: sc_ »Intuition«: GListEnv, IntuitionBase, NewWindow, Datenstrukturenreferenz Routinenreferenz | > Beschreibung Screen, Window. »Intuition«: CloseScreen, DisplayBeep, GetScreenData, MakeScreen, ModifyProp, MoveScreen, OpenScreen, ScreenToBack, ScreenToFront, Show Title. Wird durch die OpenScreen-Routine ein Screen geöffnet, so gibt sie einen Zeiger auf die zugehörige Screen-Datenstruktur zurück. In dieser finden sie die wichtigsten Informationen über den Screen. 1 NextScreen 0x0000 (0) 1 FirstWindow 0x0004 (4) I LeftEdge 0x0008 (8) I TopEdge 0x000A (10) I Width 0x000C (12) I Height 0x000E (14) Sind mehrere Screens geöffnet, so werden die dazu- gehörigen Screen-Datenstrukturen über diesen Adreßzeiger linear miteinander verknüpft. Dabei gibt die Position des Screens in dieser Liste seine Tiefe an. Der Screen, der momentan hinter allen anderen liegt, steht also am Ende der Liste und hat an dieser Stelle den Wert NULL. Einen Adreß- zeiger auf den vorderen, ersten Screen der Liste steht in der IntuitionBase-Datenstruktur. Ist dieser Wert ungleich NULL, so ist dies ein Adreßzeiger auf die Window-Datenstruktur auf das erste Fenster, das auf diesem Screen geöffnet ist. Die x-Position der linken oberen Ecke des Screens muß in den vorliegenden Versionen immer auf Null gesetzt werden. Die y-Position der linken oberen Ecke des Screens. Die Breite des Screens muß, jenach Auflösung, 320 oder 640 sein. Die Höhe des Screens. [ E EcE U) MouseY 0x0010 (16) MouseX 0x0012 (18) Flags 0x0014 (20) Title 0x0016 (22) DefaultTitle 0x001A (26) BarHeight 0x001E (30) BarVBorder 0x001F (31) BarHBorder 0x0020 (32) MenuVBorder 0x0021 (33) MenuHBorder 0x0022 (34) WBorTop 0x0023 (35) WBorLeft 0x0024 (36) WBorRight 0x0025 (36) WBorBottom 0x0026 (37) Font 0x0028 (40) ViewPort 0x002C (44) RastPort 0x0054 (84) Die augenblickliche y-Koordinate der Position des Mauszei- gers auf diesem Screen, relativ zu seiner linken oberen Ecke. Die augenblickliche x-K.oordinate der Position des Mauszei- gers auf diesem Screen, relativ zu seiner linken oberen Ecke. In dieser 2-Byte-Marke stehen die Screen-Flags. Eine genaue Beschreibung dieser Flags finden Sie in dem Ab- schnitt »Wichtige Flags der Intuition-Library«. Ein Adreßzeiger auf eine Null-terminierte Zeichenkette, deren Inhalt auf der Titelleiste ausgegeben wird. Ein Adreßzeiger auf eine Null-terminierte Zeichenkette, deren Inhalt als Default-Titel erhalten bleibt. Die Höhe der Titelleiste. Die Breite des vertikalen Bildschirmrandes. Die Höhe des horizontalen Bildschirmrandes. Die Breite der vertikalen Ränder der zu diesem Screen definierten Pull-down-Menüs. Dieser Wert gilt auch für die Pull-down-Menüs, die zu den Windows auf diesem Screen gehören. Die Höhe der horizontalen Ränder der zu diesem Screen definierten Pull-down-Menüs. Dieser Wert gilt auch für die Pull-down-Menüs, die zu den Windows auf diesem Screen gehören. Dieser Wert definiert für alle Fenster, die auf diesem Screen geöffnet werden, die Höhe des oberen Fensterrandes. Dieser Wert definiert für alle Fenster, die auf diesem Screen geöffnet werden, die Breite des linken Fensterrandes. Dieser Wert definiert für alle Fenster, die auf diesem Screen geöffnet werden, die Breite des rechten Fensterrandes. Dieser Wert definiert für alle Fenster, die auf diesem Screen geöffnet werden, die Höhe des unteren Fensterrandes. Ein Adreßzeiger auf die TextAttr-Datenstruktur des Default- Fonts, den für diesen Screen voreingestellten Zeichensatz. Dieser steht dann auch den Displayelementen (z.B. Win- dow) als solcher zur Verfügung. Einbindung einer ViewPort-Datenstruktur, die bei der Dar- stellung dieses Screens benutzt wird. Einbindung einer RastPort-Datenstruktur, die den »Zei- chenstift« definiert, der für diesen Screen bereitgehalten wird. BitMap 0x00B8 (184) LayerInfo 0x00E0 (224) FirstGadget 0x0146 (326) DetailPen 0x014A (330) BlockPen 0x014B (331) SaveColor0 0x014C (332) BarLayer 0x014E (334) ExtData 0x0152 (338) UserData 0x0156 (342) StringInfo Einbindung einer BitMap-Datenstruktur zur Bestimmung des Displayspeichers für diesen Screen. Einbindung einer LayerInfo-Datenstruktur. Dieser Parameter wird von den vorliegenden Versionen noch nicht unterstützt. Die Nummer des Farbregisters, dessen Inhalt als Farbe für die »Details« verwendet wird, also z.B. für die Einzelheiten in den Gadgets und die Schrift in der Titelleiste. Die Nummer des Farbregisters, dessen Inhalt als Farbe für »gröbere« Elemente verwendet wird, also z.B. die Titel- leiste. Ein Zwischenspeicher für die Nummer eines Farbregisters. Dieser wird beim Blinken des Screens verwendet. Ein Adreßzeiger auf eine Layer-Datenstruktur, die zur Darstellung der Menüleisten gebraucht wird. Ein unbenutzter Adreßzeiger für spätere Erweiterungen. Dieser Adreßzeiger steht dem Benutzer zur Verfügung. Über ihn können jedem Screen beliebige Zusatzdaten zugeordnet werden. Modula-2 (Intuition) StringInfo = RECORD b UBYTE *Buffer; UBYTE *UndoBuffer; SHORT BufferPos; SHORT MaxChars; SHORT DispPos; SHORT UndoPos; SHORT NumChars; SHORT DispCount; SHORT CLett; SHORT CTop; struct Layer *LayerPtr; LONG Longlnt; struct KeyMap *AltKeyMap; buffer: ADDRESS; undoBuffer: ADDRESS; bufferPos:INTEGER; maxChars:INTEGER; dispPos:INTEGER; undoPos:INTEGER; numChars:INTEGER; dispCount:INTEGER; cLeft:INTEGER; cTop:INTEGER; layerPtr:LayerPtr; longInt: LONGINT,; altKeyMap:KeyMapfPtr; END; Assembler - Datenstrukturenreferenz Routinenreferenz >> Beschreibung Präfix: si_ »Intuition«: Gadget, IntuitionBase. Keine. Dies ist eine zusätzliche Datenstruktur für »String-Gadgets«. Bei dieser Art von Gadgets kann dem Benutzer eine Zeichenkette angegeben werden, die er beliebig verändern kann. Eine Sonderform ist das Integer-String-Gadget, bei dem Zahlenwerte vom Typ LONG abgefragt werden können. Der Bereich, in dem die Eingabe innerhalb des Gadgets vorgenommen wird, heißt »Container«. II Buffer 0x0000 (0) I} UndoBuffer 0x0004 (4) I BufferPos 0x0008 (8) II MaxChars 0x000A (10) I DispPos 0x000C (12) „1 UndoPos 0x000E (14) II NumcChars 0x0010 (16) UI DispCount 0x0012 (18) I CLeft 0x0014 (20) GO CTop 0x0016 (22) „3 LayerPtr 0x0018 (24) J Longlnt 0x001C (28) Ein Adreßzeiger auf einen Puffer mit einer Null-terminierten Zeichenkette, die dem Benutzer zur Veränderung angeboten wird. Nachdem der Benutzer die <Return>-Taste gedückt hat, steht hier seine modifizierte Eingabe, der Puffer muß daher groß genug gewählt werden. Ein optionaler Adreßzeiger auf einen zweiten Puffer, der eine Kopie der Initialisierungszeichenkette enthält. Die Position innerhalb des Puffers, an der der Cursor beim Aktivieren dieses Gadgets erscheint. Die Größe der Puffer in Bytes. ACHTUNG: Da die Zeichen- kette Null-terminiert ist, muß der Puffer ein Zeichen mehr beinhalten können als maximal eingegeben werden. Die Position innerhalb des Puffers, an der das erste Zeichen der Zeichenkette ausgegeben wird. Hier trägt »Intuition« die aktuelle Position des Cursors in UndoBuffer ein. Die augenblickliche Anzahl der Zeichen, die sich in der Zeichenkette befinden. Die momentane Anzahl der im Container sichtbaren Zeichen der Zeichenkette. Hier trägt »Intuition« den Abstand des Containers vom linken Rand des zugehörigen String-Gadgets ein. Hier trägt »Intuition« den Abstand des Containers vom oberen Rand des zugehörigen String-Gadgets ein. Hier trägt »Intuition« einen Adreßzeiger auf die zugehörige Layer-Datenstruktur ein. Handelt es sich um ein Integer-String-Gadget, so wird nach dem Drücken der <Return>-Taste durch den Benutzer hier der eingegebene Wert eingetragen. Q AltKeyMap 0x0020 (32) Window Offset C (intuition/intuition.h) Modula-2 (Intuition) 0000 0004 0006 0008 000A D00C 000E 0010 0012 0014 0016 0018 00IC 0020 0024 0028 002C 002E 0032 0036 0037 0038 0039 003A 003E 0042 0046 004A 004E 004F 0050 0051 0052 0056 005A a» Oo 10 14 16 18 20 22 24 28 32 36 40 44 46 50 54 55 56 57 58 62 66 70 74 78 79 80 81 82 86 90 Ist in ActivationFlags die Flagge ALTKEYMAP gesetzt, so steht hier ein Adreßzeiger auf die eigene Keymap, die bei der Eingabe verwendet werden soll. struct Window struct Window *NextWindow; SHORT LeftEdge; SHORT TopEdge; SHORT Width; SHORT Height; SHORT MouseY; SHORT MouseX; SHORT MinWidth; SHORT MinHeight; USHORT MaxW idth; USHORT MaxHeight; ULONG Flags; struct Menu *Menustrip; UBYTE *Title; struct Requester *FirstRequest; struct Requester *DMRequest; SHORT RegCount; struct Screen *W Screen; struct RastPort *RPort; BYTE BorderLeft; BYTE BorderTop; BYTE BorderRight; BYTE BorderBottom; struct RastPort *BorderRPort; struct Gadget *FirstGadget; struct Window *Parent; struct Window *Descendant; USHORT *Pointer; BYTE PitrHeight; BYTE PtrWidth; BYTE XOffset; BYTE YOffset; ULONG IDCMPFlags; struct MsgPort *UserPort; struct MsgPort *WindowPort; Window = RECORD nextWindow:WindowPitr; leftEdge:INTEGER; topEdge:INTEGER; width:INTEGER; height:INTEGER; mouseY:INTEGER; mouseX:INTEGER; minWidth:INTEGER; minHeight:INTEGER; maxWidth:INTEGER; maxHeight:INTEGER; flags:WindowFlagset; menusStrip:MenuPtr; title ADDRESS; firstRequest:RequesterPtr; dmRequest:RequesterPtr; regqCount:INTEGER; wScreen:ScreenPtr; rPort:RastPortPtr; borderLeft:Byte; borderTop:Byte; borderRight:Byte; borderBottom:Byte; borderRPort:RastPortPtr; firstGadget:GadgetPir; parent:WindowPtr; descendant:WindowPitr; pointer ADDRESS; ptrHeight:Byte; ptrWidth:[0..16]; xOffset:Byte; yOffset:Byte; idempFlags:IDCMPFlagsSet; userPort:MsgPortPtr; windowPort:MsgPortPtr; Offset Assembler Datenstrukturenreferenz Routinenreferenz [___> Beschreibung C (intuition/intuition.h) struct IntuiMessage *MessageKey; UBYTE DetailPen; UBYTE BlockPen; struct Image *CheckMark; UBYTE *ScreenTitle; SHORT GZZMouseX; SHORT GZZMouseY; SHORT GZZW idth; SHORT GZZHeight; UBYTE *ExtData; BYTE *UserData; struct Layer *WLayer; struct TextFont *IFont; E Präfix: »Intuition«: »ConUnit«: »Intuition«: Modula-2 (Intuition) messageKey:IntuiMessagePtr; detailPen:UByte; blockPen:UByte; checkMark:ImagePitr; screenTitle ADDRESS; gzzMouseX:INTEGER; gzzMouseY:INTEGER; gzzWidth:INTEGER; gzzHeight:INTEGER; extData: ADDRESS; userData: ADDRESS; wLayer:LayerPtr; iFont:TextFontPtr; END; wd ConUnit. GListEnv, IntuiMessage, IntuitionBase, Requester, Screen, Window. ActivateGadget, ActivateWindow, AddGadget, AddGList, AutoRequest, BeginRefresh, BuildSysRequest, ClearDMReguest, ClearMenustrip, ClearPointer, CloseWindow, EndRefresh, EndRequest, FreeSysRequest, ModifyIDCMP, ModifyProp, MoveWindow, NewModifyProp, OffGadget, OffMenu, OnGadget, OnMenu, RefreshGadgets, RefreshGList, RefreshWindowFrame, RemoveGadget, RemoveGList, ReportMouse, Request, SetDMRequest, SetMenustrip, SetPointer, SetWindowTitles, SizeWindow, ViewPortAddress, WindowLimits, WindowToBack, WindowToFront. Zu jedem geöffneten Fenster gehört eine Window-Datenstruktur. In ihr stehen sämtliche Informationen über die Eigenschaften des Fensters. [ NextWindow 0x0000 (0) LeftEdge 0x0004 (4) TopEdge 0x0006 (6) Width 0x0008 (8) Height 0x000A (10) MouseY 0x000C (12) MouseX 0x000E (14) MinWidth 0x0010 (16) MinHeight 0x0012 (18) MaxWidth 0x0014 (20) MaxHeight 0x0016 (22) Flags 0x0018 (24) MenusStrip 0x001C (28) Title 0x0020 (32) FirstRequest 0x0024 (36) Sind mehrere Fenster geöffnet, so werden die dazugehörigen Window-Datenstrukturen über diesen Adreßzeiger linear verknüpft. Das letzte Element der Liste hat an dieser Stelle den Wert NULL. Der Abstand des Fensters vom linken Rand des zugehörigen Screens. Der Abstand des Fensters vom oberen Rand des zugehörigen Screens. Die Breite des Fensters. Die Höhe des Fensters. Ist der Mauszeiger innerhalb dieses Fensters positioniert, so steht hier seine zur linken oberen Ecke relative y-Koor- dinate. Ist der Mauszeiger innerhalb dieses Fensters positioniert, so steht hier seine zur linken oberen Ecke relative x-Koor- dinate. Dieser Wert definiert die minimale Breite dieses Fensters. Der Benutzer kann es mit dem Sizing-Gadget minimal bis auf diesen Wert verkleinern. Dieser Wert definiert die minimale Höhe dieses Fensters. Der Benutzer kann es mit dem Sizing-Gadget minimal bis auf diesen Wert verkleinern. Dieser Wert definiert die maximale Breite dieses Fensters. Der Benutzer kann es mit dem Sizing-Gadget maximal bis auf diesen Wert verbreitern. Dieser Wert definiert die maximale Höhe dieses Fensters. Der Benutzer kann es mit dem Sizing-Gadget maximal bis auf diesen Wert vergrößern. In dieser 4-Byte-Marke stehen die aktuellen WindowFlags. Eine genaue Beschreibung dieser Flags finden Sie in dem Abschnitt »Wichtige Flags der Intuition-Library«. Ist zu diesem Window eine Menüleiste definiert, so ist dies ein Adreßzeiger auf die erste Menu-Datenstruktur. Ein Adreßzeiger auf eine Null-terminierte Zeichenkette, deren Inhalt auf der Titelleiste dieses Fensters ausgegeben wird. Sind in diesem Fenster Requester aktiv, so ist dies ein Adreßzeiger auf die Requester-Datenstruktur des zuletzt geöffneten. Ü CC co LE DUO) Ü DMRequest 0x0028 (40) RegCount 0x002C (44) WScreen 0x002E (46) RPort 0x0032 (50) BorderLeft 0x0036 (54) BorderTop 0x0037 (55) BorderRight 0x0038 (56) BorderBottom 0x0039 (57) BorderRPort 0x003A (58) FirstGadget 0x003E (62) Parent 0x0042 (66) Descendant 0x0046 (70) Pointer 0x004A (74) PtrHeight 0x004E (78) PtrWidth 0x004E (78) XOffset 0x0050 (80) YOffset 0x0051 (81) IDCMPFlags 0x0052 (82) Sind in diesem Fenster »Doppel-Klick-Requester« aktiv, so ist dies ein Adreßzeiger auf die Requester-Datenstruktur des zuletzt geöffneten. Hier steht die Anzahl der Requester, die im Moment dieses Window sperren. Ein Adreßzeiger auf die zu dem Screen, auf dem dieses Window geöffnet wurde, gehörende Screen-Datenstruktur. Ein Adreßzeiger auf die zu diesem Window gehörende RastPort-Datenstruktur. Die Breite des linken Fensterrandes. Die Höhe des oberen Fensterrandes. Die Breite des rechten Fensterrandes. Die Höhe des unteren Fensterrandes. Ein Adreßzeiger auf eine RastPort-Datenstruktur, deren Parameter für das Zeichnen des Fensterrahmens verwendet werden. Ein Adreßzeiger auf die zu dem ersten Gadget in diesem Fenster gehörende Gadget-Datenstruktur. Sind mehrere Fenster geöffnet (egal, auf welchem Screen), so sind alle zugehörigen Window-Datenstrukturen über den Adreßzeiger Parent rückwärts miteinander verknüpft. Sind mehrere Fenster geöffnet (egal, auf welchem Screen), so sind die zugehörigen Window-Datenstrukturen über den Adreßzeiger Descendant vorwärts miteinander verknüpft. Ein Adreßzeiger auf die Grafikdaten des zu diesem Window gehörenden Mauszeigers. Die Höhe des Mauszeigers, also die Anzahl der Zeilen, aus der sich die zugehörige Grafik zusammensetzt. Die Breite des Mauszeigers, also die Anzahl der Spalten, aus der sich die zugehörige Grafik zusammensetzt. Diese muß kleiner oder gleich 16 sein. Der x-Offset des Hot-Spots in diesem Mauszeiger. Der y-Offset des Hot-Spots in diesem Mauszeiger. In dieser 4-Byte-Marke stehen die IDCMP-Flags, die fest- legen, über welche Events Systemnachrichten geschickt werden. Eine genaue Beschreibung dieser Flags finden Sie in dem Abschnitt »Wichtige Flags der Intuition-Library«. 1 UserPort 0x0056 (86) WindowPort 0x005A (90) MessageKey 0x005E (94) DetailPen 0x0062 (98) BlockPen 0x0063 (99) CheckMark 0x0064 (100) ScreenTitle 0x0068 (104) GZZMouseX 0x006C (108) GZZMouseY 0x006E (110) GZZWidth 0x0070 (112) GZZHeight 0x0072 (114) ExtData 0x0074 (116) UserData 0x0078 (120) WLayer 0x007C (124) IFont 0x0080 (128) Beim Öffnen des Fenters setzt »Intuition« an diese Stelle einen Adreßzeiger auf eine MsgPort-Datenstruktur eines Message-Ports, mit dem Nachrichten empfangen werden können. Beim Öffnen des Fensters setzt »Intuition« an diese Stelle einen Adreßzeiger auf eine MsgPort-Datenstruktur eines Message-Ports, mit dem Nachrichten gesendet werden kön- nen. Ein Adreßzeiger auf die zu diesem Window gehörende /ntui- Message-Datenstruktur. Die Nummer des Farbregisters, dessen Inhalt als Farbe für die »Details« verwendet wird, also für die Einzelheiten in den Gadgets und die Schrift in der Titelleiste. Die Nummer des Farbregisters, dessen Inhalt als Farbe für »gröbere« Elemente verwendet wird, also für das Füllen der Titelleiste. Ein Adreßzeiger auf die /mage-Datenstruktur, die den »CheckMark« zu diesem Window definiert. Ein Adreßzeiger auf eine Null-terminierte Zeichenkette, deren Inhalt auf der Titelleiste des Screens erscheint. Ist dies ein GimmeZeroZero-Window und befindet sich der Mauszeiger innerhalb dieses Fensters, so steht hier die momentane x-Koordinate des Mauszeigers relativ zur inne- ren linken oberen Ecke. Ist dies ein GimmeZeroZero-Window und befindet sich der Mauszeiger innerhalb dieses Fensters, so steht hier die momentane y-Koordinate des Mauszeigers relativ zur inne- ren linken oberen Ecke. Ist dies ein GimmeZeroZero-Window, so steht hier die innere Breite des Fensters, also die Breite ohne den rechten und linken Rand. Ist dieses Window ein GimmeZeroZero-Window, so steht hier die innere Höhe des Fensters, also die Höhe ohne den oberen und unteren Rand. Ein Adreßzeiger für zukünftige Erweiterungen. Ein frei verwendbarer Adreßzeiger für Zusatzdaten. Damit können Sie jedes Window mit eigenen Daten verknüpfen. Ein Adreßzeiger auf die Layer-Datenstruktur, die bei der Darstellung dieses Fensters benutzt wird. Ein Adreßzeiger auf eine TextF'ont-Datenstruktur, die den in diesem Window verwendeten Zeichensatz spezifiziert. „ - 5 ’ K A: g J g 3 / / N NEE N NE N 5 N: N 2 N iE N, 2 Nr ActiveWindow LITT TTS N N N ActiveScreen EEE! Neirstsoreen \/ TETK / Die /IntuitionBase-Datenstruktur Eine eingebundene Library-Datenstruktur Eine eingebundene Node-Datenstruktur zur Verkettung der geöffneten Libraries Ein Adreßzeiger auf die nächste geöffnete Library Ein Adreßzeiger auf die vorher geöffnete Library Eine eingebundene View-Datenstruktur zur Beschreibung des Displays Ein Adreßzeiger auf die Window- Datenstruktur des aktivierten Fensters Ein Adreßzeiger auf die Screen- Datenstruktur des aktiven Bildschirms Ein Adreßzeiger auf die Screen- Datenstruktur des vordersten Bildschirms Abb. 4.1: der Aufbau der Intuition-Base-Datenstruktur. K Seren Y K soreen \ D senpart G vi , SIZLILIER X A [ mer e 5 Meise = TE CT I ee | RPort { RastPort), Z zz Layer / y VRR / A j [, ke a A j # p z 7 in Layer in‘ EL Abb. 4.2: Die Einbindung der Intuition in das Grafiksystem. EEE, Eine typische Verkettung von mehreren A IntuitionBase / Screen- und Window-Datenstrukturen VELLLLLLLLLLEZ / activeWindow SEREZLIFRTZERZE, „ activeScreen H 7 KL LE L//L/L/ A firstScreen VZILLLL Le. eo Momentan aktivesFenster ea 2 zz Y r U Next = MU Next next | 2 ae / |Descen. | Bu |Descen. | Ab, Hat —— Im Hintergrund stehender Screen IT Anmerkung: Die hier dargestellten Adreßzeiger zeigen jeweils auf den Anfang einer Screen- oder Window-Datenstruktur. Adreßzeiger ohne Pfeile sind NULL. Abb. 4.3: Die Verknüpfung der Screens und Windows. m er I Veen ER RIO Ein Adre ßzeiger RSS SEEN en ee, ST NTESEN: N N Ein Adreßzeiger N RI zurück zum Screen. OS Nee \ N W EEE TEEL | => a zn IR = N a&Ü SEEN N Je nach Typ des Gadgets zeigt Speciallnfo auf eine Bool-, Prop- Sasse ae oder StringInfo- Datenstruktur = N Ns Abb. 4.4.B: ... wie die der Gadgets ... N Jeuieelsunbunhemehuem Hindow N} = Re QIIUN NSS N D ET N b SS D an KERLE Item IN N, 5 5 N N N 5 N = ee), xtMen r FirstItem KT ET. re eensiten. (MenuItem ) em wa) SIUSN | en \u AETLTTL—T Te rg 0% > m NlIten i= Kg SS, N RN RN tes: Ion R EN sen ED (Menuitem } es SSIISS | Pextrtem er N SublItem P ————— N I MenuL z SS N Ns ee r N Abb. 4.4.C: ... und des Menü-Strips. (olRCuenurzen) Be Km N Meonuttem \ RN = a („SS TR u FERN Menul ( MenuItem ) em NIIITTTITT gen SubItem mn nennen — > ı SSSTSTCCEN N N IS N AN IS Ss le OP Es NextlItem IN BEE Np Item N ERTL N \ EN N a N sn — >- .ıuo DIN N N ENG Ta TS Di Sr RN N 1 \ DIE GRAPHICS-LIBRARY In dieser Library sind alle die Datenstrukturen und Routinen definiert, die zur »grafischen Gestaltung« notwendig sind. Dazu gehören nicht nur diverse Zeichenbefehle, sondern auch Routinen und Datenstruk- turen, die die grafische Animation ermöglichen. 5.1 Wichtige Flags der Graphics-Library DrawModes (graphics/rastport.h) (Graphics) C Modula-2 Hex Dez Bedeutung JAMI jaml 0000 0 Nur mit der Vordergrund- farbe zeichnen. JAM2 jam2 0001 1 Mit beiden Farben gleich- zeitig zeichnen. COMPLEMENT complement 0002 2 Zeichnen durch XOR- Operation der Pixel. INVERSVIF inversvid 0004 4 Zeichnen mit Farbinvertie- rung der Pixel. Assembler Präfix: RP_. Datenstrukturenreferenz »Graphics«: RastPort. »Intuition«: Border, IntuiText. Routinenreferenz »Graphics«: SetDrMa. ...- Beschreibung Die einzelnen DrawModes-Werte sind für die Festlegung des aktuellen Zeichenmodus innerhalb eines Rastports zuständig. Wichtig: Unter Modula-2 sind die Zeichenmodi als Aufzählungstyp »DrawModes = (dmO, complement, inversvid)« und die eigentliche Bitmaske als Mengentyp DrawModeset definiert. Hier gilt weiterhin: »jaml=DrawModesSet{}« und »jam2=DrawModeSet{dmO}«! FontFlags (graphics/text.h) (Graphics) C Modula-2 Hex Dez Bedeutung FPF_LROMFONT romFont 0001 1 Ist der Font im (Pseudo-) ROM? FPF_DISKFONT diskFont 0002 2 Ist der Font von Diskette geladen? FPF_REVPATH revPath 0004 4 Gilt umgekehrte Schreibrichtung? FPF_TALLDOT tallDot 0008 8 Für HIRES & NON- INTERLACE gedacht? FPF_WIDEDOT wideDot 0010 16 ° FürLORES& INTERLACE gedacht? FPF_PRPORTIONAL proportional 0020 32 Ist dies ein proportionaler Font? FPF_DESIGNED designed 0040 64 Wurde Fontgröße echt geschaffen? FPF_REMOVED removed 0080 128 Wurde der Font bereits entfernt? Datenstrukturenreferenz »Graphics«: RastPort, TextAttr, TextFont. Routinenreferenz Keine. [___> Beschreibung Die einzelnen FontFlags-Werte dienen zur Angabe wichtiger Design- und Laufzeit-Charakteristika eines Textfonts. Wichtig: Unter Modula-2 sind die FontFlags als Aufzählungstyp »FontFlags = (romFont, diskFont, revPath, tallDot, wideDot, proportional, designed, removed)« und die eigentliche Bitmaske als Mengentyp FontFlagSet definiert. FontStyles (graphics/text.h) (Graphics) Modula-2 Hex Bedeutung FS_NORMAL normalFont 0000 © Normaler Text, d.h. nichts gesetzt? FSF_UNDERLINED underlined 0001 1 Unterstrichene Zeichenausgabe? Modula-2 Bedeutung FSF_BOLD bold Fette Zeichenausgabe? FSF_ITALIC italic Kursive Zeichenausgabe? FSF_EXTENDED extended Breitere Zeichen als normal? Datenstrukturenreferenz »Graphics«: RastPort, TextAttr, TextFont. Routinenreferenz »Graphics«: AskSoftStyle, SetSoftStyle. > Beschreibung Die einzelnen FontStyles-Werte dienen zur Auswahl und Angabe des (eventuell algorithmisch zu erzeugenden) Schrifttyps der Zeichen eines Textfonts. Wichtig: Unter Modula-2 sind die Schrifttypen als Aufzählungstyp »FoniStyles = (underlined, bold, italic, extended)« und die eigentliche Bitmaske als Mengentyp FontStyleSet definiert. Hier gilt weiterhin: »normalFont=FontStyleset{}«! ViewModes (graphics/view.h) (Graphics) C Modula-2 Hex Dez Bedeutung GENLOCK_VIDEO genloc Video 0002 2 Video-Genlock vorhanden? LACE lace 0004 4 Interlace-Modus ausgewählt? PFBA pfba 0040 64 Playfield 2 vor Playfield 1? EXTRA_HALFBRITE extraHalfbrite 0080 128 Extra-Halfbrite- Modus gewählt? GENLOCK_AUDIO genlocAudio 0100 256 Audio-Genlock vorhanden? DUALPF dualpf 0400 1024 Dwual-Playfield-Modus gewählt? HAM ham 0800 2048 Hold-And-Modify-Modus gewählt? VP_HIDE vpHide 2000 8192 Viewport vollkommen verdeckt? SPRITES sprites 4000 16384 Werden hier Sprites benutzt? HIRES hires 8000 32768 High-Resolution-Modus gewählt? Datenstrukturenreferenz »Graphics«: View, ViewPort. »Intuition«: NewScreen, (Screen). Routinenreferenz Keine. => Beschreibung Die einzelnen ViewModes-Werte dienen der Beschreibung des tatsächlichen Darstellungsmodus und anderer Charakteristika des Gesamtdisplays oder eines Viewports. Wichtig: Unter Modula-2 sind die ViewModes als Aufzählungstyp »ViewModes = (vmO, genlocVideo, lace, vm3, vm5, pfba, extraHalfbrite, genlcAudio, vm9, dualpf, ham, vm12, vpHide, sprites, hires)« und die eigentliche Bitmaske als Mengentyp ViewModeset definiert. 5.2 Die Datenstrukturen der Graphics-Library AnimComp Offset C (graphics/gels.h) Modula-2 (Graphics) Hex Dez struct AnimComp AnimComp = { RECORD 0000 0 WORD Flags; flags: INTEGER; 0002 2 WORD Timer; timer:INTEGER; 0004 4 WORD TimesSet; timeSet:INTEGER; 0006 6 struct AnimComp *NextComp; nextComp:AnimCompPitr; 000A 10 struct AnimComp *PrevComp; prevComp: AnimCompPitr; O0O0E 14 struct AnimComp *NextSeg; nextSegq:AnimCompPitr; 0012 18 struct AnimComp *PrevSeg; prevSeq:AnimCompPtr; 0016 22 WORD (*AnimCRoutine)(); animCRoutine: ADDRESS; 001A 26 WORD YTrans; yTrans:INTEGER; 001C 28 WORD XTrans; xTrans:INTEGER; O01E 30 struct AnimOb *HeadOb; headOb:AnimObPitr; 0022 34 struct Bob *AnıimBob; animBob:BobPitr; 0026 38 1: END; Assembler Präfix: ac_ Syntax: Strukturname = AC Datenstrukturenreferenz »Graphics«: AnimComp, AnimOb, Bob. Routinenreferenz Keine. __..> Beschreibung Die AnimComp-Datenstruktur wird vom Animationssystem zur Verwaltung der unterschiedlichen Einzelkomponenten eines ganzen Animationsobjekts verwendet (siehe AnimOb-Datenstruktur). Jeder AnimComp-Datenstruktur ist dabei genau ein Bob zugeordnet, das sowohl eine Einzelkomponente insgesamt als auch nur eine Momentaufnahme der Bewegungssequenz einer Einzelkomponente dar- stellen kann. U Flags 0x0000 (0) RINGTRIGGER ANIMHALF 1 Timer 0x0002 (2) I] TimeSet 0x0004 (4) I NextComp 0x0006 (6) 1 PrevComp 0x000A (10) U NextSeq 0x000E (14) J PrevSeq 0x0012 (18) Eine 2-Byte-Marke, deren niederwertigstes Bit gesetzt ist, falls diese Einzelkomponente nur eine Momentaufnahme einer Bewegungssequenz ist. Zur Benutzung sind hier folgende Konstanten vordefiniert: Modula-2 Hex Dez Bedeutung ringTrigger 0001 Handelt es sich um Momentaufnahme? anımHalf 0020 32 Reserviert für internen Systemgebrauch. Eine positive Ganzzahl, deren Wert angibt, wie lange diese Einzelkomponente (z.B. als Teil einer Bewegungssequenz) noch aktiv bleiben soll. Gemessen wird hierbei in Aufrufen der »Graphics«-Systemroutine Animate. Ist dieser Wert permanent gleich null, so bleibt diese Einzelkomponente dauernd aktiv! Eine positive Ganzzahl, deren Wert bei jeder Aktivierung der Einzelkomponente in die Timer-Variable ihrer Anim- Comp-Datenstruktur eingetragen wird. Ein Adreßzeiger auf die AnimComp-Datenstruktur, die der nächsten Einzelkomponente des betreffenden Animations- objekts zugeordnet ist. Über die NextComp-Zeiger werden sämtliche Einzelkomponenten eines Animationsobjekts vorwärts verkettet. Ein Adreßzeiger auf die AnimComp-Datenstruktur, die der vorangehenden Einzelkomponente des betreffenden Anima- tionsobjekts zugeordnet ist. Über die NextComp-Zeiger werden sämtliche Einzelkomponenten eines Animations- objekts rückwärts verkettet. Ein Adreßzeiger auf die AnimComp-Datenstruktur der näch- sten Momentaufnahme innerhalb der Bewegungssequenz, zu der diese Einzelkomponente gehört. Über die NextSeq- Zeiger werden sämtliche Momentaufnahmen einer Bewe- gungssequenz vorwärts verkettet. Ein Adreßzeiger auf die AnimComp-Datenstruktur der näch- sten Momentaufnahme innerhalb der Bewegungssequenz, zu der diese Einzelkomponente gehört. Über die PrevSeg- Zeiger werden sämtliche Momentaufnahmen einer Bewe- gungssequenz vorwärts verkettet. I AnimCRoutine 0x0016 (22) 1 YTrans 0x001A (26) 4 XTrans 0x001C (28) I HeadOb 0x001E (30) 4 AnimBob 0x0022 (34) Die Adresse des Codebereichs einer Routine, die nach jedem Animationsschritt zur weiteren Bearbeitung dieser Einzel- komponente aufgerufen wird. Eine Ganzzahl, deren Wert die y-Koordinate der linken oberen Ecke dieser Einzelkomponente relativ zum Registra- tionspunkt des übergeordneten Animationsobjekts angibt. Eine Ganzzahl, deren Wert die x-Koordinate der linken oberen Ecke dieser Einzelkomponente relativ zum Registra- tionspunkt des übergeordneten Animationsobjekts angibt. Ein Adreßzeiger auf die AnimOb-Datenstruktur des Anima- tionsobjekts, dem diese Einzelkomponente zugeordnet ist. Ein Adreßzeiger auf die Bob-Datenstruktur des Bobs, das speziell dieser Einzelkomponente zugeordnet ist. AnimOb Offset C (graphics/gels.h) Modula-2 (Graphics) Hex Dez struct AnimOb AnimOb = Pe RECORD 0000 0 struct AnimOb *NextOb; nextOb:AnimObPtr; 0004 4 struct AnimOb *PrevOb; prevOb:AnimObPrtr; 0008 8 LONG Clock; clock:LONGINT; 000C 12 WORD AnOldY,; anOldY:INTEGER; O00E 14 WORD AnOldX; anOldX:INTEGER; 0010 16 WORD AnY; anY:INTEGER; 0012 18 WORD AnX; anX:INTEGER; 0014 20 WORD YVel; yVel:INTEGER; 0016 22 WORD XVel; xVel:INTEGER; 0018 24 WORD Y Aceel; yAccel:INTEGER; 001A 26 WORD X Acceel; xAccel:INTEGER; 001C 28 WORD RingYTrans; ringY Trans: INTEGER; 001E 30 WORD RingXTrans; ringXTrans:INTEGER; 0020 32 WORD (*AnimORoutine)(); animORoutine: ADDRESS; 0024 36 struct AnimComp *HeadComp; headComp: AnimCompPtr; 0028 40 AUserStuff AUserExt; \ 002A 42 }; END; Assembler Präfix: ao Syntax: Strukturname = AO Datenstrukturenreferenz »Graphics«: AnimComp, AnimOb. Routinenreferenz »Graphics«: AddAnimOb, FreeGBuffers, GetGBuffers, InitGMasks. Beschreibung Die AnimOb-Datenstruktur dient der Systemsoftware zur Verwaltung ganzer Animationsobjekte. Insge- samt kennt das Animationssystem des Amigas folgende Animationselemente: Hardwaresprites, virtuelle Sprites, Bobs, AnimComp-Einzelkomponenten und AnimOb-Animationsobjekte. Dabei erweisen sich die Hardwaresprites in dieser Aufstellung als Ausnahme, da sie im Gegensatz zu den übrigen Animations- elementen direkt von der Hardware gesteuert werden. Die von der Systemsoftware gesteuerten Anima- tionselemente bauen in der angegebenen Reihenfolge aufeinander auf: Ein Bob etwa besteht zur Hälfte aus einem virtuellen Sprite, eine AnimComp-Einzelkomponente enthält ein oder mehrere Bobs und ein Animationsobjekt setzt sich aus mehreren Einzelkomponenten zusammen! Alles in allem sieht der hierarchische Aufbau eines Animationsobjekts also folgendermaßen aus: VSprite I NextOb 0x0000 (0) I PrevOb 0x0004 (4) I Clock 0x0008 (8) 1 AnOldY 0x000C (12) AnimOb AnimComp Bob VSprite Ein Adreßzeiger auf die AnimOb-Datenstruktur des näch- sten Animationsobjekts, das in der betreffenden Anima- tionsliste zu bewegen ist. Über die NextOb-Zeiger werden sämtliche Animationsobjekte einer Animationsliste vor- wärts verkettet. Ein Adreßzeiger auf die AnimOb-Datenstruktur des vor- angehenden Animationsobjekts, das in der betreffenden Animationsliste zu bewegen ist. Über die PrevOb-Zeiger werden sämtliche Animationsobjekte einer Animationsliste rückwärts verkettet. Eine lange Ganzzahl, deren Wert angibt, wie oft das Anima- tionsobjekt schon mittels Aufrufen der »Graphics«- Systemroutine Animate bewegt wurde. Eine Ganzzahl, deren Wert die y-Koordinate der letzten Position des Registrationspunkts dieses Animationsobjekts angibt. AnOldX 0x000E (14) AnY 0x0010 (16) AnX 0x0012 (18) YVel 0x0014 (20) XVel 0x0016 (22) YAccel 0x0018 (24) XAccel 0x001A (26) RingYTrans 0x001C (28) RingXTrans 0x001E (30) AnimORoutine 0x0020 (32) HeadComp 0x0024 (36) Eine Ganzzahl, deren Wert die x-Koordinate der letzten Position des Registrationspunkts dieses Animationsobjekts angibt. Eine Ganzzahl, deren Wert die y-Koordinate der aktuellen Position des Registrationspunkts dieses Animationsobjekts festlegt. Eine Ganzzahl, deren Wert die x-Koordinate der aktuellen Position des Registrationspunkts dieses Animationsobjekts festlegt. Eine Ganzzahl, deren Wert die vertikale Geschwindigkeit des gesamten Animationsobjekts in 1/64 Pixeln pro Bewe- gungsschritt angibt. Eine Ganzzahl, deren Wert die horizontale Geschwindigkeit des gesamten Animationsobjekts in 1/64 Pixeln pro Be- wegungsschritt angibt. Eine Ganzzahl, deren Wert die vertikale Beschleunigung des gesamten Animationsobjekts in 1/64 Pixeln pro Bewegungs- schritt angibt. Eine Ganzzahl, deren Wert die horizontale Beschleunigung des gesamten Animationsobjekts in 1/64 Pixeln pro Bewe- gungsschritt angibt. Eine Ganzzahl, deren Wert den vertikalen Versatz des Regi- strationspunkts dieses Animationsobjekts angibt, der zu seiner aktuellen Position hinzuaddiert wird, falls ein ganzer Ablauf der Bewegungssequenz einer Teilkomponente durchgeführt wurde. Die Addition findet selbstverständlich nur bei gesetztem RINGTRIGGER-Bit der entsprechenden Einzelkomponente statt. Eine Ganzzahl, deren Wert den vertikalen Versatz des Regi- strationspunkts dieses Animationsobjekts angibt, der zu seiner aktuellen Position hinzuaddiert wird, falls ein ganzer Ablauf der Bewegungssequenz einer Teilkomponente durchgeführt wurde. Die Addition findet selbstverständlich nur bei gesetztem RINGTRIGGER-Bit der entsprechenden Einzelkomponente statt. Die Adresse des Codebereichs einer Routine, die nach jedem Animationsschritt zur weiteren Bearbeitung dieses Anima- tionsobjekts aufgerufen wird. Ein Adreßzeiger auf die AnimComp-Datenstruktur der Ein- zelkomponente, die den Anfang der Liste von Einzelkom- ponenten des Animationsobjekts darstellt. I AUserExt 0x0028 (40) Eine vom Benutzer völlig frei definierbare Erweiterung der AnimOb-Datenstruktur zur Aufnahme weiterer Statusinfor- mationen. Zu diesem Zweck ist der Typ AUserStuff im Benutzerprogramm entsprechend zu deklarieren. (Wichtig: Diese Erweiterung ist nur unter C, nicht jedoch unter Modu- la-2 verfügbar!) Arealnfo Offset C (graphics/rastport.h) Modula-2 (Graphics) Hex Dez struct Arealnfo Arealnfo = { RECORD SHORT *VctrTbl; vctrTbl:ADDRESS; SHORT *VctrPtr; vctrPtr- ADDRESS; BYTE *FlagTbl; flagTbl: ADDRESS; BYTE *FlagPrir; flagPtr- ADDRESS; SHORT Count; count:INTEGER; SHORT MaxCount; maxCount:INTEGER; SHORT FirstX; firstX:INTEGER; SHORT First\Y; firstY:INTEGER; & END; Assembler Präfix: ai Datenstrukturenreferenz »Graphics«: RastPort. Routinenreferenz »Graphics«: InitArea. I... > Beschreibung Die Arealnfo-Datenstruktur wird zur Speicherung und Verwaltung eines (zu füllenden) Polygons benutzt und von den verschiedenen Areaxxx-Routinen benötigt. 4 VetrTbl 0x0000 (0) Ein Adreßzeiger auf den Anfang der Tabelle der Poly- goneckpunkte, die punktweise organisiert ist. Für jeden Eckpunkt werden dort seine x- und y-Koordinaten direkt aufeinanderfolgend abgelegt. Insgesamt werden pro Punkt 5 Byte Speicherplatz in der Tabelle benötigt, da neben den eigentlichen Koordinaten am Ende der Tabelle noch diverse Flaggen gespeichert sind. I VetrPtr 0x0004 (4) Ein Adreßzeiger auf das Koordinatenpaar des aktuellen Eckpunkts in der VertrTbl-Tabelle. I FiagTbl 0x0008 (8) Ein Adreßzeiger auf den Anfang der punktweise organisier- ten Tabelle von Vektorflags für das Polygon. U FlagPtr 0x000C (12) Ein Adreßzeiger auf den Anfang der punktweise organisier- ten Tabelle von Füllflags für das Polygon. Diese Füllflags dienen der Speicherung von Clipping-Informationen. JJ Count 0x0010 (16) Eine positive Ganzzahl, deren Wert die momentan in der VetrTbl-Tabelle gespeicherte Anzahl von Eckpunkten des Polygons angibt. I MaxCount 0x0012 (18) Eine positive Ganzzahl, deren Wert die maximal mögliche Anzahl von Eckpunkten festlegt, die in der VctrTbl-Tabelle Platz finden. J FirstX 0x0014 (20) Eine Ganzzahl, deren Wert der x-Koordinate des ersten Eckpunkts des Polygons entspricht. 1 FirstY 0x0016 (22) Eine Ganzzahl, deren Wert der y-Koordinate des ersten Eckpunkts des Polygons entspricht. BitMap Offset C (graphics/gfx.h) Modula-2 (Graphics) struct BitMap BitMap = { RECORD UWORD BytesPerRow; bytesPerRow:CARDINAL; UWORD Rows; rows:CARDINAL; UBYTE Flags; flags:UByfte; UBYTE Depth; depth:UByte; UWORD pad; pad:CARDINAL, PLANEPTR Planes[8]; planes: ARRAY [0..7] OF ADDRESS; }; END; Assembler Präfix: bm_ Syntax: pad —> bm_Pad Datenstrukturenreferenz »Graphics«: ClipRect, Layer, RasInfo, RastPort. »Intuition«: IntuitionBase, NewScreen, NewWin- dow, Requester, Screen. Routinenreferenz »Graphics«: BltBitMap, BltBitMapRastPort, BltMaskBitMapRastPort, InitBitMap. »Layers«!< CreateBehindLayer, CreateUpfront Layer. [> Beschreibung Die BitMap-Datenstruktur dient zur Speicherung der grundlegenden Statusinformationen für den bzw. die Displayspeicherbereiche eines beliebigen Displayelements. Neben der Höhe, Breite und Tiefe sind hier ebenfalls die Zeiger auf die einzelnen Bitplanes vorhanden. I BytesPerRow 0x0000 (0) Eine positive Ganzzahl, deren Wert die Anzahl von Spei- cherbytes je Rasterzeile für die einzelnen Bitplanes angibt. I Rows 0x0002 (2) Eine positive Ganzzahl, deren Wert die Anzahl von Raster- zeilen und damit die Höhe der einzelnen Bitplanes angibt. 3 Flags 0x0004 (4) Eine nur für den Systemgebrauch bestimmte Marke. I Depth 0x0005 (5) Eine positive Ganzzahl, deren Wert die Tiefe der Bitmap angibt. Diese Tiefe entspricht der Anzahl vorhandener Bit- planes. I pad 0x0006 (6) Eine nur für den Systemgebrauch bzw. spätere Erweiterun- gen bestimmte Füllkomponente. II Planes 0x0008 (8) Ein Feld von acht Adreßzeigern auf die Anfänge der einzel- nen Bitplanes. Bob Offset C (graphics/gels.h) Modula-2 (Graphics) Hex Dez struct Bob Bob = { RECORD 0000 0 WORD Flags; flags:BobFlagSet; 0002 2 WORD *SaveBuffer; saveBuffer:- ADDRESS; 0006 6 WORD *ImageShadow; imageShadow: ADDRESS; 000A 10 struct Bob *Before; before:BobPtr; 000C 14 struct Bob * After; after:BobPtr; 0012 18 struct VSprite *BobVSprite; bobV Sprite: VSpritePtr; 0016 22 struct AnimComp *BobComp; bobComp: AnimCompfPtr; 001A 26 struct DBufPacket *DBuffer; dBuffer:DBufPacketPtr; OO1E 30 BUserStuff BUserExt; 0020 32 b END; Assembler Präfix: bob _ Syntax: Strukturname = BOB Flags —> bob_BobFlags Datenstrukturenreferenz »Graphics«: AnimComp, Bob, VSprite. Routinenreferenz »GfxMacros«: RemBob. »Graphics«: AddBob, RemIBob. I___> Beschreibung Die Bob-Datenstruktur wird von den Animationsroutinen zur Speicherung der Daten verwendet, die neben der ohnehin benutzten VSprite-Datenstruktur zur Verwaltung eines Bobs = »blitter object« noch zusätzlich benötigt werden. Die Notwendigkeiteiner eigenen (Zusatz-)Datenstruktur für Bobs ergibt sich daraus, daß sich Bobs und Sprites im Hinblick auf die Erzeugung ihres Ausgabebilds auf dem Monitor grundlegend unterscheiden: Sprites sind echte Hardwareobjekte, die völlig unabhängig von den Bitpla- nes der aktuellen Playfields sichtbar gemacht werden. Für das Ausgabebild eines Sprites ist somit die spezielle Spritehardware zuständig. Bobs dagegen sind Playfield-Objekte. Zur Erzeugung des Ausgabe- bilds eines Bobs muß dessen Image in die Bitplanes des entsprechenden Playfields gezeichnet werden. Bei der Bewegung eines Bobs ist deshalb der Playfield-Hintergrund ständigen Speicher- und Restaurie- rungsaktionen zu unterziehen. Im Falle eines Sprites sind solche Maßnahmen nicht vonnöten, weil das Sprite den Zustand der Playfields überhaupt nicht verändert. I Flags 0x0000 (0) Eine 2-Byte-Marke, deren einzelne Bits Statusinformatio- nen über den aktuellen Zustand und Darstellungsmodus des Bobs enthalten. Zur Benutzung sind hier folgende Konstan- ten vordefiniert, von denen allerdings nur die beiden ersten und das fünfte solche Bits beschreiben, die vom Benutzer verändert werden können. Die restlichen Bits dürfen einzig und allein gelesen werden. C Modula-2 Hex Dez Bedeutung SAVEBOB saveBob 0001 1 Altes Bobimage nicht löschen? BOBISCOMP boblsComp 0002 2 Ist das Bob Teil eines AnimComp? BWAITING bWaiting 0100 256 Wartet das Bob auf seine Darstellung? BDRAWN bDrawn 0200 512 Istdas Bob bereits gezeichnet? BOBSAWAY bobsAway 0400 1024 Soll das Bob entfernt werden? BOBNIX bobNix 0800 2048 Ist das Bob schon ganz entfernt? SAVEPRESERVE savePreserve 1000 4096 Ist der Hintergrund zu speichern? OUTSTEP outStep 2000 8192 Ist der Hintergrund zu löschen? Die letzten beiden Bits SAVEPRESERVE und OUTSTEP werden von den Animationsroutinen im doppelt gepufferten Darstellungsmodus benötigt. Das SAVEBOB-Bit gibt an, ob das an der alten Position gezeichnete Bobimage bei der Bewegung gelöscht werden soll oder nicht: Ist das SAVEBOB-Bit gesetzt, so wird das alte Bobimage nicht gelöscht. Auf diese Art und Weise kann man ein Bob sehr einfach und elegant als Zeichenpinsel benutzen. U SaveBuffer 0x0002 (2) Ein Adreßzeiger auf einen Speicherbereich im Chip-RAM, in dem die bei der Darstellung des Bobs überschriebenen Hintergrunddaten des Playfields gespeichert werden. Die Größe dieses Speicherbereichs muß mindestens Height*Width*Depth/8 Byte betragen, wobei Dimensions- werte aus der VSprite-Datenstruktur des Bobs stammen. U) ImageShadow 0x0006 (6) Ein Adreßzeiger auf einen Speicherbereich im Chip-RAM, der die Größe einer Bitplane des Bobs haben muß und somit mindestens Height*Width/8 Byte umfassen muß. Die Di- mensionswerte entstammen dabei der VSprite-Datenstruk- tur des Bobs. Der Imageshadow wird beim Zeichnen des Bobs im Rahmen der Bitplane-Maskierung des Playfields benötigt (siehe PlanePick- und PlaneOnOff-Masken der VSprite-Datenstruktur). I Before 0x000A (10) Ein Adreßzeiger auf die Bob-Datenstruktur des Bobs in der GEL-Liste, das direkt vor diesem Bob gezeichnet werden soll. I After 0x000C (14) Ein Adreßzeiger auf die Bob-Datenstruktur des Bobs in der GEL-Liste, nach dem dieses Bob gezeichnet werden soll. I BobVSprite 0x0012 (18) Ein Adreßzeiger auf die zu diesem Bob gehörige VSprite- Datenstruktur, in der die restlichen Statusdaten des Bobs gespeichert sind. I BobComp 0x0016 (22) Ein Adreßzeiger auf die AnimComp-Datenstruktur des Ver- bunds von Animationsobjekten, zu dem dieses Bob gehört. Der Wert dieses Adreßzeigers wird von den Animationsrou- tinen nur dann beachtet, wenn das BOBISCOMP-Bit der Flags-Marke in der Bob-Datenstruktur des Bobs gesetzt ist. I DBuffer 0x001A (26) Ein Adreßzeiger auf eine DBufPacket-Datenstruktur, die im doppelt gepufferten Darstellungsmodus benötigt wird. Der doppelt gepufferte Darstellungsmodus wird durch einen Wert dieses Adreßzeigers ungleich NULL bzw. NIL ausge- wählt. Falls normaler Darstellungsmodus erwünscht ist, muß der DBuffer-Zeiger somit mit dem Wert NULL bzw. NIL initialisiert werden. Wichtig: Falls ein Bob einer GEL-Liste doppelt gepuffert werden soll, dann sind auch alle übrigen Bobs der GEL-Liste doppelt zu puffern! UI BUserkExt 0x001E (30) Eine vom Benutzer völlig frei definierbare Erweiterung der Bob-Datenstruktur zur Aufnahme weiterer Statusinforma- tionen. Zu diesem Zweck ist der Typ BUserS$tuff im Benut- zerprogramm entsprechend zu deklarieren. (Wichtig: Diese Erweiterung ist nur unter C, nicht jedoch unter Modula-2 verfügbar!) ClipRect C (graphics/clip.h) struct ClipRect { LONG reserved; Assembler Datenstrukturenreferenz LONG Flags; b ClipRect = RECORD struct ClipRect *Next; next:ClipRectPtr; struct ClipRect *prev; prev:ClipRectPtr; struct Layer *lobs; lobs:LayerPitr; struct BitMap *BitMap; bitMap:BitMapPir; struct Rectangle bounds; bounds:Rectangle; struct ClipRect *_pl; p1:ClipRectPtr; struct ClipRect *_p2; p2:ClipRectPtr; reserved: LONGINT; flags:LONGINT,; END; Präfix: cr Syntax: struct Rectangle bounds —> WORD cr MinX, cr _MinY,cr_MaxX,cr MaxY »Graphics«: ClipRect, Layer. »Intuition«: IntuitionBase. »Layers«: SwapBitsRastPortClipRect. Routinenreferenz > Beschreibung Die ClipRect-Datenstruktur dient der internen Repräsentation eines rechteckigen Clipping-Bereichs, der den Grafikroutinen beim Zugriff auf einen Layer angibt, in welche Bitmap gezeichnet werden soll. Mehrere Listen von ClipRect-Datenstrukturen werden vom System zur Kennzeichnung und Verwaltung sämtlicher Clipping-und Damage-Bereiche eines Layers verwendet. I Next 0x0000 (0) I prev 0x0004 (4) U lobs 0x0008 (8) 4 BitMap 0x000C (12) Ein Adreßzeiger auf die ClipRect-Datenstruktur des nach- folgenden Clipping-Bereichs in der Clipping-Bereichsliste. Über die NextZeiger werden sämtliche Clipping-Bereiche einer Clipping-Bereichsliste vorwärts verkettet. Ein Adreßzeiger auf die ClipRect-Datenstruktur des voran- gehenden Clipping-Bereichs in der Clipping-Bereichsliste. Über die prevZeiger werden sämtliche Clipping-Bereiche einer Clipping-Bereichsliste rückwärts verkettet. Ein Adreßzeiger auf die Layer-Datenstruktur des Layers, dem dieser Clipping-Bereich zugeordnet ist. Ein Adreßzeiger auf die BitMap-Datenstruktur der Bitmap, in die die Grafikroutinen beim Zugriff auf diesen Clipping- Bereich zeichnen sollen. I bounds 0x0010 (16) Eine Rectangle-Datenstruktur, deren einzelne Komponen- ten die Lage und Ausmaße des Clipping-Bereichs innerhalb des übergeordneten Layers angeben. 43 _pl 0x0018 (24) Ein von den Systemroutinen intern für Verwaltungszwecke benötigter Adreßzeiger auf eine ClipRect-Datenstruktur. 43 _p2 0x001C (28) Siehe _pI]. I reserved 0x0020 (32) Ein für den Systemgebrauch reserviertes Langwort. I Flags 0x0024 (36) Eine 4-Byte-Marke, deren Bit 0 einen für interne System- zwecke benötigten Status des Clipping-Bereichs anzeigt. Zur Benutzung ist folgende Konstante vordefiniert: C Modula-2 Hex Dez CR_NEEDS_NO_CONCEALED_RASTERS NeedsNoConcealedRasters 0001 1 CollTable Omen C (graphics/gels.h) Modula-2 (Graphics) Hex Dez struct CollTable CollTable = { RECORD 0000 0 int (*collPtrs[16])O; collPtrs: ARRAY[0..15] OF AD DRESS 0040 64 ie END; Assembler Die Datenstruktur ist hier in »graphics/view.i« definiert. Präfix: cp_ Datenstrukturenreferenz »Graphics«: GelsInfo. Routinenreferenz Keine. U... Beschreibung Diese Tabelle dient der Aufnahme der Adressen von sechzehn benutzerdefinierten Routinen zur Kollisionsbehandlung. Diese Routinen finden beim Umgang mit dem Animationssystem mannigfaltige Verwendung. I collPtrs 0x0000 (0) Ein Feld von sechzehn Adreßzeigern auf die Codebereiche der Kollisionsroutinen. ColorMap Offset C (graphics/view.h) Modula-2 (Graphics) Hex Dez struct ColorMap ColorMap = { RECORD 0000 0 UBYTE Flags; flags:UByte; 0001 1 UBYTE Type; type:UByte; 0002 2 UWORD Count; count:CARDINAL; 0004 4 APTR ColorTable; colorTable: ADDRESS; 0008 8 8 END; Assembler Präfix: cm_ Datenstrukturenreferenz »Graphics«: IODRPRegq, ViewPort. Routinenreferenz »Graphics«: FreeColorMap, GetColorMap, GetRGB4, SetRGB4CM. ___.> Beschreibung Jeder Viewport besitzt seine eigene Farbpalette, in der die RGB-Zusammensetzung der einzelnen Farben gespeichert ist. Die ColorMap-Datenstruktur dient der Verwaltung einer solchen Farbpalette. I Flags 0x0000 (0) Eine 1-Byte-Marke, die momentan noch nicht bzw. (intern) nur zwischenzeitlich benutzt wird. I Type 0x0001 (1) Eine 1-Byte-Marke, deren Wert den Typ der Farbeinträge dieser Farbpalette festlegt. Bisher ist hierfür lediglich der Wert Null zulässig, wodurch Farbeinträge der Art »xRGB« gekennzeichnet werden. Für die einzelnen Nibble »R«, »G«, »B« (mit Definitionsbereich O bis 15) gilt dabei, daß »R« den Rotanteil, »G« den Grünanteil und »B« den Blauanteil der Farbe angibt. Der endgültige Farbwert berechnet sich dann aus B+/6*G+256*R. I Count 0x0002 (2) Eine positive Ganzzahl, deren Wert die Anzahl der gültigen Farbeinträge der Farbpalette angibt. I ColorTable 0x0004 (4) Ein Adreßzeiger auf den Anfang einer Tabelle von Farb- werten, die gerade soviel Einträge aufweist, wie der Wert von Count angibt. copinit Offset C (graphics/copper.h) Modula-2 (Graphics) Hex struct copinit Copinit = { RECORD UWORD diagstrt[4]; diagstrt: ARRAY [0..3] OF CARDINAL; UWORD sprstrtup[40]; sprstrtup ARRAY [0..39] OF CARDINAL; UWORD sprstop[ 2]; sprstop: ARRAY [0..1] OF CARDINAL; 5 END; Assembler Präfix: copinit_ Datenstrukturenreferenz »Graphics«: GfxBase. Routinenreferenz Keine. ....> Beschreibung Die copinit-Datenstruktur enthält die bereits fertig codierten Datenworte von Copper-Befehlssequenzen, die zur Initialisierung des Displays in Hardware-Copperlisten benötigt werden. I diagstrt 0x0000 (0) Eine codierte Copper-Befehlssequenz für die erste Bitplane. I sprstrtup 0x0008 (8) Eine codierte Copper-Befehlssequenz zur Initialisierung der Sprite-Animation. J sprstop 0x0058 (88) Eine codierte Copper-Befehlssequenz zum Stoppen der Sprite-Animation. Copins Offset C (graphics/copper.h) Modula-2 (Graphics) struct CopIns CoplIns = ( RECORD short OpCode; CASEopCode:CARDINAL OF union { I next: struct CopList *nxtlist; nxtlist:CopListPtr; struct | union | | wait: om C (graphics/copper.h) Modula-2 (Graphics) Hex Dez 0002 9 SHORT VWaitPos; vWaitPos:INTEGER; 0002 2 SHORT DestAddr; hWaitPos:INTEGER; } ul; union { | move: 0004 4 SHORT HWaitPos; destAddr:INTEGER; 0004 4 SHORT DestData; destData:INTEGER; } u2; } ud; }u3; END; 0006 6 }; END; Assembler Präfix: ci Datenstrukturenreferenz »Graphics«: CopList. Routinenreferenz Keine. [___> Beschreibung Die CopIns-Datenstruktur dient sowohl der Aufnahme eines codierten Copper-Befehls als auch dem Verweis auf das nächste Teilstück einer Zwischen-Copperliste. ZI OpCode 0x0000 (0) Die Tag-Marke der Varianten der Cop/ns-Datenstruktur, für die folgende Werte gültig sind: Modula-2 Hex Bedeutung COPPER_MOVE move 0000 Copperbefehl MOVE COPPER_WAIT wait 0001 Copperbefehl WAIT CPRNXTBUF next 0002 Verkettungszeiger I nxtlist 0x0002 (2) Falls die Tag-Marke OpCoae gleich CPRNXTBUF ist, steht hier ein Adreßzeiger auf den nächsten Abschnitt der Zwi- schen-Copperliste. I VWaitPos 0x0000 (2) Falls die Tag-Marke OpCode gleich COPPER_WAIT ist, steht hier die vertikale Position des zugehörigen Copper- Befehls WAIT. 1 DestAddr 0x0002 (2) Falls die Tag-Marke OpCode gleich COPPER_MOVE ist, steht hier die Zieladresse des zugehörigen Copper-Befehls MOVE. 3 HWaitPos 0x0004 (4) Falls die Tag-Marke OpCode gleich COPPER_WAIT ist, steht hier die horizontale Position des zugehörigen Copper- Befehls WAIT. [] DestData 0x0004 (4) Falls die Tag-Marke OpCode gleich COPPER_MOVE ist, steht hier das Datenwort des zugehörigen Copper-Befehls MOVE. CopList C (graphics/copper.h) Modula-2 (Graphics) struct CopList CopList = ( RECORD struct CopList *Next; next:CopListPtr; struct CopList *_CopList; copList:CopListPtr; struct ViewPort *_ViewPort; viewPort:ViewPortPtr; struct CoplIns *Coplns; copIns:CoplInsPtr; struct CopIns *CopPitr; copPtr:CoplInsPtr; UWORD *CopL Start; copLStart:ADDRESS; UWORD *CopSStart; copSStart: ADDRESS; SHORT Count; count:INTEGER; SHORT MaxCount; maxCount:INTEGER; SHORT DyOffset; dyOffset:INTEGER; b END; Assembler Präfix: cl_ Datenstrukturenreferenz »Graphics«: CoplIns, CopList, UCopList, ViewPort. Routinenreferenz »Graphics«: FreeCopList. ._ > Beschreibung Die CopList-Datenstruktur dient zur Verwaltung der Zwischen-Copperlisten, aus denen die »Graphics«- Systemroutine MrgCop die Hardware-Copperlisten berechnet, die zur Erzeugung des Monitorausgabe- bildes benötigt werden. Ein Viewport besitzt mehrere Zwischen-Copperlisten und auch noch eine Benutzer-Copperliste. Alle diese Copperlisten enthalten natürlich eigene Copper-Befehlssequenzen, deren Reihenfolge noch nicht aufeinander abgestimmt ist. Innerhalb der Hardware-Copperlisten eines Views muß dagegen die Reihenfolge stimmen, weil sonst das Ausgabebild nicht korrekt erzeugt werden kann. Daher werden die diversen Copperlisten eines Viewports in Form von Zwischen-Copperlisten verwaltet, weil aus diesen die endgültige Hardware-Copperliste des Views schnell und einfach in der richtigen Reihenfolge zusammengebaut werden kann. DJ Next 0x0000 (0) Ein Adreßzeiger auf die nächste CopList-Datenstruktur der Zwischen-Copperliste, die einen neuen Abschnitt repräsen- tiert. Über die Next-Zeiger werden sämtliche Abschnitte einer Zwischen-Copperliste vorwärts verkettet. U _CopList 0x0004 (4) 1 _ViewPort 0x0008 (8) I CopIns 0x000C (12) 4 CopPtr 0x0010 (16) I CopLStart 0x0014 (20) I CopsSStart 0x0018 (24) I Count 0x001C (28) J MaxCount 0x001E (30) I DyOffset 0x0020 (32) Ein vom System während des Zusammenbaus der Hard- ware-Copperliste aus den diversen Zwischen-Copperlisten intern benötigter Adreßzeiger auf eine CopList-Datenstruk- tur. Ein vom System während des Zusammenbaus der Hard- ware-Copperliste aus den diversen Zwischen-Copperlisten intern benötigter Adreßzeiger auf eine ViewPort-Daten- struktur. Ein Adreßzeiger auf den ersten Cop/ns-Eintrag in der Cop- per-Befehlsliste dieser Zwischen-Copperliste. Ein Adreßzeiger auf den gerade bearbeiteten Cop/ns-Eintrag der Copper-Befehlsliste dieser Zwischen-Copperliste. Ein von der »Graphics«-Systemroutine MrgCop einzutra- gender Adreßzeiger auf die codierte Copper-Befehlssequenz für den »long frame« (siehe ViewPort). Ein von der »Graphics«-Systemroutine MrgCop einzutra- gender Adreßzeiger auf die codierte Copper-Befehlssequenz für den »short frame« (siehe ViewPort). Eine positive Ganzzahl, deren Wert die Anzahl der bisher in diese Zwischen-Copperliste eingetragenen Copper-Befehle angibt. Eine positive Ganzzahl, deren Wert die maximale Anzahl von Copper-Befehlen festlegt, die in dieser Zwischen-Cop- perliste Platz finden. Eine Ganzzahl, deren Wert den vertikalen Offset der in dieser Zwischen-Copperliste enthaltenen WAI/T-Befehle angibt. cprlist —- = 5 Lemsasgan ne enlurnn, I Offset C (graphics/copper.h) Modula-2 (Graphics) Hex Dez struct cprlist Cprlist = { RECORD struct cprlist *Next; next:CprlistPtr; UWORD *start; start: ADDRESS; SHORT MaxCount; maxCount:INTEGER; b END; Assembler Präfix: crl_ Datenstrukturenreferenz »Graphics«: CprList, View. Routinenreferenz »Graphics«: FreeCprlist. > Beschreibung Mit Hilfe der cprlist-Datenstruktur werden von der Systemsoftware die Hardware-Copperlisten ver- waltet. I Next 0x0000 (0) Ein Adreßzeiger auf die nächste cprlist-Datenstruktur in dieser Liste von Hardware-Copperlisten. Über die Next- Zeiger werden sämtliche (Einzel-)Hardware-Copperlisten einer cprlist-Datenstruktur vorwärts verkettet. I start 0x0004 (4) Ein Adreßzeiger auf den Anfang einer tatsächlichen Hard- ware-Copperliste, in der die codierte Copper-Befehls- sequenz zu finden ist. I MaxCount 0x0008 (8) Eine positive Ganzzahl, deren Wert der Anzahl von Copper- Befehlen (das sind jeweils Langworte) in der zugehörigen Hardware-Copperliste entspricht. DBufPacket Offset C (graphics/gels.h) Modula-2 (Graphics) Hex Dez struct DBufPacket DBufPacket = I { RECORD WORD BufY; bufY:INTEGER; 0002 WORD BufX; bufX:INTEGER; 0004 struct VSprite *BufPath; bufPath:VSpritePtr; 0008 WORD *BufBuffer; bufBuffer: ADDRESS; | 000C 5 END; Assembler Präfix: dbp_ Syntax: Strukturname = DBP Datenstrukturenreferenz »Graphics«: Bob. Routinenreferenz Keine. > Beschreibung Bei der Animation von Bobs besteht die Möglichkeit, diese von den Animationsroutinen mit doppelter Pufferung bewegen zu lassen. Dabei nimmt die DBufPacket-Datenstruktur dann die für das Bob neben der Bob-Datenstruktur noch zusätzlich nötigen Informationen auf. Die spezielle DBufPacket-Daten- struktur eines Bobs wird mit diesem über den Adreßzeiger DBuffer seiner Bob-Datenstruktur verknüpft. „1 BufY 0x0000 (0) J BufX 0x0002 (2) 4 BufPath 0x0004 (4) „1 BufBuffer 0x0008 (8) Gelsinfo 38 E Offset C (graphics/rastport.h) Modula-2 (Graphics) struct GelsInfo GelsInfo = [ RECORD 0 BYTE sprRsrvd; sprRsrvd:Byte; 1 UBYTE Flags; flags:Byte; 2 struct VSprite *gelHead; gelHead:VSpritePtr; 6 struct VSprite *gelTail; gelTail:V SpritePtr; 10 WORD *nextLine; nextLine: ADDRESS; 14 WORD **JlastColor; lastColor- ADDRESS; 18 struct collTable *collHandler; collHandler:CollTablePtr; 22 short leftmost; leftmost:INTEGER; 24 short rightmost; rightmost:INTEGER; 26 short topmost; topmost:INTEGER; 28 short bottommost; bottommost:INTEGER,; 30 APTR firstBlissObj; firstBlissObj: ADDRESS; lastBlissObj: ADDRESS; 34 APTR lastBlissObj; Eine Ganzzahl, deren Wert die y-Koordinate der letzten Position des Bobs angibt, an der der Hintergrund im normalen Savebuffer des Bobs (siehe Bob-Datenstruktur) gespeichert wurde. Eine Ganzzahl, deren Wert die x-Koordinate der letzten Position des Bobs angibt, an der der Hintergrund im normalen Savebuffer des Bobs gespeichert wurde. Ein Adreßzeiger auf eine VSprite-Datenstruktur, der vonden Animationsroutinen zur korrekten Einhaltung der Darstel- lungsreihenfolge aller Bobs der GEL-Liste benötigt wird. Der Wert dieses Zeigers hängt eng mit den Adreßzeigern ClearPath und DrawPath aus der VSprite-Datenstruktur des Bobs zusammen. Ein Adreßzeiger auf einen Speicherbereich im Chip-RAM, der mindestens so groß sein muß wie der normale Savebuffer des Bobs (siehe Bob-Datenstruktur). Dieser Speicherbereich dient wie der SaveBuffer zur Aufnahme der Playfield-Hin- tergrunddaten, die bei der Darstellung eines Bobs über- schrieben werden. Im doppelt gepufferten Darstellungsmo- dus werden also zwei verschiedene Pufferspeicher zur Auf- nahme der Hintergrunddaten verwendet. END; Assembler Datenstrukturenreferenz Routinenreferenz Beschreibung Präfix: gi_ »Graphics«: RastPort. »Graphics«: InitGels, SetCollision. Mit Hilfe der Gels/nfo-Datenstruktur verwaltet das Animationssystem eine Liste von GELs = <g>raphic <el>ements, die zusammen im gleichen Displaybereich dargestellt werden sollen. Der gemeinsame Displaybereich für GELs muß auf jeden Fall ein Rastport sein! Die spezielle Gels/Info-Datenstruktureines Rastports wird mit diesem über den Adreßzeiger GelsI/nfo seiner RastPort-Datenstruktur verknüpft. Aus den in der GelsInfo-Datenstruktur enthaltenen Informationen berechnet insbesondere die Spritemaschi- ne die tatsächlichen Zuordnungen der aktivierten virtuellen Sprites. I sprRsrvd 0x0000 (0) Q Flags 0x0001 (1) I gelHead 0x0002 (2) I gelTail 0x0006 (6) 1 nextLine 0x000A (10) I lastColor 0x000E (14) 1 collHandler 0x0012 (18) Eine 1-Byte-Marke, deren einzelne Bits festlegen, welche der Hardwaresprites O bis 7 von der Spritemaschine für die Zuweisung an virtuelle Sprites nicht benutzt werden dürfen. Eine intern für den Systemgebrauch der Animationsroutinen bestimmte 1-Byte-Marke. Ein Adreßzeiger auf die VSprite-Datenstruktur des ersten Elements der GEL-Liste dieses Gelsinfos. Beachten Sie bitte, daß dieses Anfangselement lediglich als Dummy-GEL fungiert und nicht gezeichnet wird. Ein Adreßzeiger auf die VSprite-Datenstruktur des letzten Elements der GEL-Liste dieses Gelsinfos. Beachten Sie bitte, daß dieses Endelement lediglich als Dummy-GEL fungiert und nicht gezeichnet wird. Ein Adreßzeiger auf ein Feld von acht Ganzzahlen, deren Werte die Zeilennummern angeben, bei denen das entspre- chende Hardwaresprite wieder für eine Neuzuordnung ver- fügbar ist. Dabei beschreibt das Feldelement O die nächste freie Zeile für Hardwaresprite O usw. bis hin zu Feldelement 7, das für Hardwaresprite 7 zuständig ist. Diese Angaben bzgl. der nächsten freien Zeilen benötigt die Spritemaschine zur flexiblen und gleichzeitig korrekten Zuordnung aller virtuellen Sprites dieser GEL-Liste. Ein Adreßzeiger auf ein Feld von weiteren acht Adreßzei- gern, die auf die für die entsprechenden Hardwaresprites zuletzt benutzten (Mini-)Farbtabellen verweisen. Für die Zuordnung der Feldelemente zu den einzelnen Hardware- sprites siehe Erläuterungen zum Adreßzeiger nextLine. Ein Adreßzeiger auf eine collTable-Datenstruktur, in der die Adressen der sechzehn benutzerdefinierten Kollisionsrouti- nen gespeichert sind, die für Kollisionsbehandlung sämt- licher GELs dieser GEL-Liste zuständig sind. I leftmost 0x0016 (22) Eine Ganzzahl, deren Wert die x-Koordinate des linken Rands des Clipping-Bereichs dieser GEL-Liste festlegt. Dieser Wert wird von den Animationsroutinen benötigt, um die Kollision eines GELs mit den Randbegrenzungen des Clipping-Bereichs feststellen zu können. I rightmost 0x0018 (24) Eine Ganzzahl, deren Wert die x-Koordinate des rechten Rands des Clipping-Bereichs dieser GEL-Liste festlegt. Dieser Wert wird von den Animationsroutinen benötigt, um die Kollision eines GELs mit den Randbegrenzungen des Clipping-Bereichs feststellen zu können. I topmost 0x001A (26) Eine Ganzzahl, deren Wert die y-Koordinate des oberen Rands des Clipping-Bereichs dieser GEL-Liste festlegt. Dieser Wert wird von den Animationsroutinen benötigt, um die Kollision eines GELs mit den Randbegrenzungen des Clipping-Bereichs feststellen zu können. I bottommost 0x001C (28) Eine Ganzzahl, deren Wert die y-Koordinate des unteren Rands des Clipping-Bereichs dieser GEL-Liste festlegt. Dieser Wert wird von den Animationsroutinen benötigt, um die Kollision eines GELs mit den Randbegrenzungen des Clipping-Bereichs feststellen zu können. I firstBlissObj 0x001E (30) Ein für den Gebrauch durch die Animationsroutinen be- stimmter Adreßzeiger, der normalerweise auf das erste Bob dieser GEL-Liste verweist. I lastBlissObj 0x0022 (34) Ein für den Gebrauch durch die Animationsroutinen be- stimmter Adreßzeiger, der normalerweise auf das letzte Bob dieser GEL-Liste verweist. GfxBase 7 eb Offset | C (graphics/gfxbase.h) Modula-2 (Graphics) Hex Dez struct GfxBase GfxBase = ee RECORD 0000 0 struct Library LibNode; libNode:Library; 0022 34 struct View *ActiView; actiView:ViewPtr; 0026 38 struct copinit *copinit; copinit:CopinitPtr; 002A 42 long *cia; ciıa: ADDRESS; 002E 46 long *blitter; blitter- ADDRESS; 0032 50 UWORD *LOFlist:; loFlist: ADDRESS; 0036 54 UWORD *SHRhlist; shFlist: ADDRESS; 003A 58 struct bltnode *blthd; blthd:BltnodePtr; 003E 62 struct bltnode *blitt]; blttl:BltnodePtr; Offset ns C (graphics/gfxbase.h) — Assembler 118 140 154 158 160 161 162 164 166 167 168 170 172 174 188 192 206 208 212 struct bltnode *bsbithd; struct bltnode *bsbilttl; struct Interrupt vbsrv; struct Interrupt timsrv; struct Interrupt bltsrv; struct List TextFonts; struct TextFont *DefaultFont; UWORD Modes; BYTE VBlank; BYTE Debug; SHORT BeamsSync; SHORT system_bplconO; UBYTE SpriteReserved; UBYTE bytereserved; USHORT Flags; SHORT BlitLock; short BlitNest; struct List BlitWaitQ; struct Task *BlitOwner; struct List TOF_WaitQ; UWORD DisplayFlags; struct SimpleSprite **SimpleSprites; UWORD MaxDisplayRow; UWORD MaxDisplayColumn; UWORD NormalDisplayRows; UWORD NormalDisplayColumns UWORD NormalDPMX; UWORD NormalDPMY,; struct SignalSemaphore *LastChanceMemory; UWORD *LCMptr; UWORD MiicrosPerLine; UWORD MinDisplayColumn; ULONG reserved[23]; Präfix: Syntax: Datenstrukturenreferenz Routinenreferenz »Intuition«: »Exec«: ’ Modula-2 (Graphics) bsblthd:BltnodePtr; bsblttl:BltnodePtr; vbsrv:Interrupt; timsrv:Interrupt; bltsrv:Interrupt; textFonts:List; defaultFont: TextFontPtr; modes:BITSET; vBlank:UByte; debug:BYTE,; beamSync:INTEGER; bplconO0:BITSET; spriteReserved:UByte; bytereserved:UByte; flags:BITSET,; blitLock:INTEGER; blitNest:INTEGER; blitWaitQ:List; blitOwner:TaskPtr; waitQ:List; displayFlags:DisplayFlagSet; simpleSprites: ADDRESS; maxDisplayRow:CARDINAL; maxDisplayColumn:CARDINAL; normalDisplayRows:CARDINAL, normalDisplayColumns:CARDINAL; normalDPMX:CARDINAL; normalDPMY:CARDINAL; lastChanceMemory: SignalSemaphorePtr; IcMptr- ADDRESS; microsPerLine:CARDINAL; reserved: ARRAY [0..1] OF LONGCARD; END; 8b_ Komponente LibNode ist nicht definiert! IntuitionBase. OldOpenLibrary, OpenLibrary. Beschreibung Die GfxBase-Datenstruktur stellt die Basisdatenstruktur der »graphics.library« dar, die beim ersten Öffnen dieser Bibliothek erzeugt wird. In der GfxBase-Datenstruktur sind der momentan aktive View, die Display-Copperlisten, die Systemfontliste, die diversen Job-Listen des Blitters, die drei (Standard-) Interrupt-Server, die den Hardwaresprites zugeordneten SimpleSprite-Datenstrukturen, eine Liste auf den Blitter wartender Tasks sowie eine Liste auf das »vertical blanking« Intervall wartender Tasks verankert. Darüber hinaus finden sich hier eine Vielzahl weiterer Statusinformationen bezüglich der verfügbaren Displayhardware und des aktuellen Displays. I LibNode 0x0000 (0) I ActiView 0x0022 (34) I copinit 0x0026 (38) I cia 0x002A (42) I blitter 0x002E (46) U LOFlist 0x0032 (50) J SHFlist 0x0036 (54) 4 bithd 0x003A (58) U bittl 0x003E (62) J bsblthd 0x0042 (66) I bsbittl 0x0046 (70) Eine Library-Datenstruktur (siehe »Exec«), die den Eintrag der »graphics.library« in der globalen (Library-)Liste der Systembibliotheken darstellt. Ein Adreßzeiger auf die View-Datenstruktur des gerade geladenen und damit sichtbaren Views. Ein Adreßzeiger auf die copinit-Datenstruktur, deren Hard- ware-Copperlisten momentan für den Copper-Startup verwendet werden. Ein Adreßzeiger auf einen Speicherbereich im Chip-RAM, der als Resource für den CIA-Baustein 8520 dient. Ein bisher nicht benutzter Adreßzeiger auf einen Speicher- bereich im Chip-RAM, der dem Blitter zukünftig als Re- source dienen soll. Ein Adreßzeiger auf die codierten Daten der Hardware- Copperliste zur Darstellung des »long frame« (siehe View- port). Ein Adreßzeiger auf die codierten Daten der Hardware- Copperliste zur Darstellung des »short frame« (siehe View- port). Ein Adreßzeiger auf die bltnode-Datenstruktur des Anfangs- elements der FIFO-Schlange von unerledigten Blitterjobs, die durch Aufrufe der »Graphics«-Routine OBlir in Auftrag gegeben wurden. Ein Adreßzeiger auf die bltnode-Datenstruktur des letzten Elements der FIFO-Schlange von unerledigten Blitterjobs, die durch Aufrufe der »Graphics«-Routine OBlit in Auftrag gegeben wurden. Ein Adreßzeiger auf die bltnode-Datenstruktur des Anfangs- elements der FIFO-Schlange von unerledigten BS-Blitter- jobs, die durch Aufrufe der »Graphics«-Routine OBSBlit in Auftrag gegeben wurden. Die Abkürzung »QBS« steht dabei für »queue beam synchronized«. Ein Adreßzeiger auf die bltnode-Datenstruktur des letzten Elements der FIFO-Schlange von unerledigten BS-Blitter- vbsrv 0x004A (74) timsrv 0x0060 (96) bltsrv 0x0076 (118) TextFonts 0x008C (140) DefaultFont 0x009A (154) Modes 0x009E (158) VBlank 0x00A0 (160) Debug 0x00A1 (161) BeamSync 0x00A2 (162) system_bplconO 0x00A4 (164) SpriteReserved 0x00A6 (166) bytereserved 0x00A7 (167) Flags 0x00A8 (168) BlitLock 0x00AA (170) BlitNest 0x00AC (172) jobs, die durch Aufrufe der »Graphics«-Routine OBSBlit in Auftrag gegeben wurden. Die Abkürzung »QBS« steht dabei für »queue beam synchronized«. Eine /Interrupt-Datenstruktur (siehe »Exec«), die den für »vertical blanking«-Unterbrechungen zuständigen Inter- rupt-Server identifiziert. Eine Interrupt-Datenstruktur (siehe »Exec«), die den für Timer-Unterbrechungen zuständigen Interrupt-Server iden- tifiziert. Eine /Interrupt-Datenstruktur (siehe »Exec«), die den für Blitter-Unterbrechungen zuständigen Interrupt-Server identifiziert. Eine List-Datenstruktur (siehe »Exec«), die der Verwaltung der Systemfontliste dient. In diese Liste werden alle momen- tan verfügbaren Textfonts über die Komponente mn_Node der tf Message ihrer TextFont-Datenstruktur eingereiht. Ein Adreßzeiger auf die TextFont-Datenstruktur des Text- fonts, der von den »Graphics«-Routinen standardmäßig verwendet wird. Laut [RKA] findet sich hier eine Kopie des aktuellen Werts des BPLCONO-Registers (siehe Datenstruktur Custom in »Hardware«). 277? (Hat offensichtlich etwas mit dem »vertical blanking« Intervall zu tun!) 27? (Habe meinen Wellensittich befragt... Er meint das geht in Richtung »Debugger Wack«.) ??? (Vermutung: Entsprechender beamsync-Wert des nächsten blitnode-Blitterjobs.) Laut [RKA] wird dieser Wert für jedes Display ins BPLCONDO-Register geODERt. Eine 1-Byte Marke, deren einzelne Bits angeben, welche der Hardwaresprites O0 bis 7 momentan für den exklusiven Ge- brauch durch irgendwelche Tasks reserviert sind. Eine für den Systemgebrauch reservierte 1-Byte-Marke. ??7? (Unser Vorschlag an Commodore: Ein wenig Glasnost könnte hier nicht schaden!) Eine Ganzzahl, deren Wert als Sperrmarkierung bei der exklusiven Benutzung des Blitters durch einen Task fun- giert. Eine Ganzzahl, die als Zähler für verschachtelte Anforde- rungen exklusiver Blitter-Benutzung benötigt wird. win Q BlitWaitQ 0x00AE (174) I BlitOwner 0x00BC (188) 1 TOF_WaitQ 0x00C0 (192) „I DisplayFlags 0x00CE (206) Eine List-Datenstruktur (siehe »Exec»), die der Verwaltung der Liste von Tasks dient, die momentan auf die Benutzung des Blitters warten. Ein Adreßzeiger auf die Task-Datenstruktur (siehe »Exec«) der Task, die den Blitter gerade exklusiv für sich bean- sprucht. Angemeldet werden entsprechende Blitter-Anfor- derungen durch einen Aufruf der »Graphics«-Routine Own- Blit. Eine List-Datenstruktur (siehe »Exec«), die der Verwaltung der Liste von Tasks dient, die im Moment auf das nächste »vertical blanking«-Intervall warten. In diese Liste werden die Tasks bei einem Aufruf der »Graphics«-Routine Wait- TOF eingereiht. Dabei steht die Abkürzung »TOF« für »top of frame«. Eine 2-Byte-Marke, deren einzelne Bits Informationen über die angeschlossene Display-Hardware enthalten. Diese Bits werden beim Einschalten des Amigas bestimmt. Für die Benutzung sind dabei folgende Konstanten vordefiniert: _ C Modula-2 Hex Dez Bedeutung NTSC ntsc 0001 1 Ist ein NTSC-Monitor angeschlossen? GENLOC genloc 0002 2 Ist ein GENLOC-Interface verfügbar? PAL pal 0004 4 Ist ein PAL-Monitor ange- schlossen? Wichtig: In Modula-2 ist hier der Mengentyp DisplayFlagSet zu benutzen. I SimpleSprites 0x00D0 (208) I MaxDisplayRow 0x00D4 (212) WI MaxDisplayColumn 0x00D6 (214) I NormalDisplayRows 0x00D8 (216) I NormalDisplayColumns 0x00DA (216) Ein Adreßzeiger auf ein Feld von acht Adreßzeigern, die auf die SimpleSprite-Datenstrukturen verweisen, die den Hard- waresprites 0 bis 7 momentan zugeordnet sind. Eine positive Ganzzahl, deren Wert die Höhe des größtmög- lichen Low-Resolution-Non-Interlace-Displays inkl. Over- scan-Zeilen angibt. Eine positive Ganzzahl, deren Wert die Breite des größtmög- lichen Low-Resolution-Non-Interlace-Displays inkl. Over- scan-Zeilen angibt. Eine positive Ganzzahl, deren Wert die Höhe des aktuellen Standarddisplays in Pixeln festlegt. Eine positive Ganzzahl, deren Wert die Breite des aktuellen Standarddisplays in Pixeln festlegt. DiE GrRAaPHIcs-LBRARY OO I NormalDPMX 0x00DC (220) 4 NormalDPMY 0x00DE (222) I LastChanceMemory 0x00E0 (224) I LCMptr 0x00E4 (228) „1 MicrosPerLine 0x00E8 (232) 3 MinDisplayColumn 0x00EA (234) 1 reserved 0x00EC (236) Eine positive Ganzzahl, deren Wert die Breite eines Pixels für ein Low-Resolution-Non-Interlace-Display definiert, indem er angibt, wie viele Pixel pro Meter benötigt werden. Die Abkürzung »DPM« bedeutet »dots per meter«. Eine positive Ganzzahl, deren Wert die Höhe eines Pixels für ein Low-Resolution-Non-Interlace-Display definiert, indem er angibt, wie viele Pixel pro Meter benötigt werden. Die Abkürzung »DPM« bedeutet »dots per meter«. Eine SignalSemaphore-Datenstruktur (siehe »Exec«), die den Zugriff mehrerer Tasks auf das »last chance memory« synchronisiert. ?7? (Bedeutet die Abkürzung »LCM« etwa »last chance memory«, dann könnte dies ein Adreßzeiger auf einen Spei- cherbereich für den äußersten Notfall sein.) Eine positive Ganzzahl, deren Wert die Anzahl von Mikro- sekunden angibt, die zum Aufbau eines Videobilds benötigt werden. 7??? (Wen interessieren solche Displaydetails?) Laut [RKA] sind diese Datenbytes für zukünftige Erweite- rungen reserviert. Isrvstr Offset C (graphics/graphint.h) Modula-2 (Graphics) struct Isrvstr Isrvstr = { RECORD struct Node is_Node; node:Node; struct Isrvstr *Iptr; iptr:IsrvstrPtr; int (*code)(); code: ADDRESS; int (*ccode)(); ccode: ADDRESS; int Carg; carg:INTEGER; 1: Assembler Datenstrukturenreferenz Routinenreferenz END; Diese systeminterne Datenstruktur ist in Assembler nicht definiert. »Graphics«: Isrvstr. Keine. — Beschreibung Wird von privater »Graphics«-Systemroutine AddTOFTask dazu benutzt, um Tasks nach Aufruf von WaitTOF an den Vertical-Blank-Interrupt-Server anzuhängen! 1 is_Node 0x0000 (0) I Iptr 0x000E (14) code 0x0012 (18) I ccode 0x0016 (22) U Carg 0x001A (26) Layer a Offset | Hex Dez 0000 0 0004 4 0008 8 000C 12 0010 16 0018 24 001C 28 001E 30 0020 32 0022 34 0026 38 002A 42 002C 44 0030 48 0034 52 0038 56 003C 60 0040 64 0044 68 0048 12 0076 118 007E 126 0082 130 0086 134 009C 156 00AO 160 Eine eingebundene Node-Datenstruktur zur Verknüpfung mehrerer solcher Datenstrukturen. Ein Adreßzeiger auf weitere /srvstr-Datenstrukturen. Ein Adreßzeiger auf eine systeminterne Routine. Ein Adreßzeiger auf eine weitere systeminterne Routine. BER C (graphics/clip.h) struct Layer { struct Layer *front; struct Layer *back; struct ClipRect *ClipRect; struct RastPort *rp; struct Rectangle bounds; UBYTE reserved[4]; UWORD priority; UWORD Flags; struct BitMap *SuperBitMap; struct ClipRect *SuperClipRect; APTR Window; SHORT Scroll_X; SHORT Scroll_Y; struct ClipRect *cr; struct ClipRect *cr2; struct ClipRect *crnew; struct ClipRect *SuperSaveClipRects; struct ClipRect *_cliprects; struct Layer_Info *Layerlnfo; struct SignalSemaphore Lock; UBYTE reserved3[8]; struct Region *ClipRegion; struct Region *saveClipRects; UBYTE reserved2[22]; struct Region *Damagelbist; b Modula-2 (Graphics) Layer = RECORD front:LayerPtr; back:LayerPitr; clipRect:ClipRectPtr; rp:RastPortPtr; bounds:Rectangle; reserved: ARRAY [0..3] OF BYTE; priority:CARDINAL; flags:CARDINAL; superBitMap:BitMapPtr; superClipRect:ClipRectPir; window:ADDRESS; scrollX:INTEGER; scrollY:INTEGER; cr:ClipRectPtr; cr2:ClipRectPtr; crnew:ClipRectPtr; superSaveClipRects:ClipRectPtr; cliprects:ClipRectPtr; layerInfo:LayerlInfoPtr; lock:SignalSemaphore; reserved3: ARRAY [0..7J) OFBYTE; clipRegion:RegionPtr; saveClipRects:RegionPtr; reserved2: ARRAY [0..21] OFBYTE; damageList:RegionPtr; END; ERENSNREREN. Assembler Präfix: Ir_ Syntax: struct Rectangle bounds —> UWORD Ir MinX, Ir_MinY, Ir MaxX, Ir MaxY Datenstrukturenreferenz »Graphics«: Layer, LayerInfo, RastPort. »Intuition«: GadgetInfo, GListEnv, Requester, Screen, StringInfo, Window. Routinenreferenz »Graphics«: AttemptLockLayerRom, CopySBitMap, LockLayerRom, SyncSBitMap, Unlock- LayerRom. »Layers«: BeginUpdate, BehindLayer, Create- BehindLayer, CreateUpfrontLayer, DeleteLayer, EndUpdate, InstallClip- Region, Locklayer, MoveLayer, Move- LayerInFrontOf, ScrollLayer, Size- Layer, UnlockLayer, UpfrontLayer, WhichLayer. [> Beschreibung Die Layer-Datenstruktur dient dazu, innerhalb eines Viewports bzw. einer Bitmap einen rechteckigen Arbeitsbereich festzulegen. Diese Arbeitsbereiche sind insofern stapelbar, als daß sie sich mit anderen überlappen dürfen. Dabei sind insbesondere beliebige Überlappungen sowohl in horizontaler als auch in vertikaler Richtung erlaubt. Der Zweck der Layerbildung liegt darin, daß die Grafikroutinen mit ihnen in dem Sinn zusammenarbeiten, daß sie auch in verdeckte Teile des Layers zeichnen. Daher stellen die Layer zusammen mit der »layers.library« die eigentliche Basis des Fenstersystems von Intuition dar. Um eine korrekte Behandlung der Überlappungsbereiche zu gewährleisten, besteht ein Layer vornehm- lich aus einer Menge (Liste!) von Clipping-Bereichen. Diese enthalten in Form von ClipRect-Datenstruk- turen die Informationen darüber, in welche Speicherbereiche die Grafikroutinen zeichnen sollen. Weiterhin werden innerhalb eines Layers noch Damagelisten verwaltet. Dort sind sämtliche Bereiche des Layers eingetragen, die zwischenzeitlich einmal verdeckt waren und daher eventuell einer Auffrischung bedürfen. „I front 0x0000 (0) Ein Adreßzeiger auf die Layer-Datenstruktur des Layers, der momentan unmittelbar über diesem Layer liegt. Über die front-Zeiger werden sämtliche Layer eines Layerinfos in der Reihenfolge ihrer augenblicklichen Lage vorwärts verkettet. I back 0x0004 (4) Ein Adreßzeiger auf die Layer-Datenstruktur des Layers, der momentan unmittelbar unter diesem Layer liegt. Über die back-Zeiger werden sämtliche Layer eines Layerinfos in der Reihenfolge ihrer augenblicklichen Lage rückwärts ver- kettet. I ClipRect 0x0008 (8) Ein Adreßzeiger auf die ClipRect-Datenstruktur des ersten Clipping-Bereichs in der Clipping-Bereichsliste dieses Layers. I rp 0x000C (12) Ein Adreßzeiger auf die RastPort-Datenstruktur des zu diesem Layer gehörigen Rastports. I bounds 0x0010 (16) „J reserved 0x0018 (24) J priority 0x001C (28) 1 Flags 0x001E (30) 6 LAYERSIMPLE LAYERSMART LAYERSUPER Eine Rectangle-Datenstruktur, deren Komponenten die Ausmaße und Lage dieses Layers innerhalb des Viewports bzw. der Bitmap angeben. Ein für den Systemgebrauch reserviertes Feld von vier Bytes. Eine positive Ganzzahl, deren Werteine von den Systemrou- tinen intern benötigte Prioritätskennung des Layers festlegt. Eine 2-Byte-Marke, deren einzelne Bits gemäß der folgen- den Aufstellung Auskunft über den Zustand und die Art des Layers geben. Modula-2 Bedeutung layerSimple Simple-Refresh Layer layerSmart Smart-Refresh Layer layerSuper Superbitmap-Layer LAYERUPDATING layerUpdating Ist gerade ein Update LAYERREFRESH in Gang? LAYERBACKDROP layerBackdrop Backdrop-Layer layerRefresh Läuft gerade ein Refresh? LAYER_CLIPRECTS_LOST Verlust von Clipping-Bereichen durch layerClipRectsLost Speicherprobleme bei vormaliger Layer-Operation Wichtig: In Modula-2 ist hier der Mengentyp LayerFlagSet zu benutzen. I SuperBitMap 0x0020 (32) J SuperClipRect 0x0022 (34) 1 Window 0x0026 (38) I Scroll_X 0x002A (42) Im Falle eines Superbitmap-Layers steht hier ein Adreß- zeiger auf die BitMap-Datenstruktur der benötigten Zusatz- bitmap. Ein Adreßzeiger auf eine ClipRect-Datenstruktur, der im Falle eines Superbitmap-Layers auf den ersten Clipping- Bereich in der Clipping-Bereichsliste der Superbitmap ver- weist. Anderenfalls ist er als Zeiger auf das Anfangselement der Damage-Clippingliste zu deuten, die beim automa- tischen Refresh vom System benötigt wird. Ein Adreßzeiger auf die Datenstruktur, die dem zu diesem Layer gehörigen Fenster zugeordnet ist. Bei der Arbeit mit der Intuition-Oberfläche finden Sie hier demnach einen Adreßzeiger auf die Window-Datenstruktur des Intuition- Fensters. Eine Ganzzahl, deren Wert dem horizontalen Verschiebe- satz in Pixeln entspricht, der diesem Layer mittels des letzten Aufrufs von ScrollLayer zugeordnet wurde. „] Scroll_Y 0x002C (44) I cr 0x0030 (48) 1 cr2 0x0034 (52) I ernew 0x0038 (56) I SuperSaveClipRects 0x003C (60) J _cliprects 0x0040 (64) II LayerInfo 0x0044 (68) I Lock 0x0048 (72) „1 reserved3 0x0076 (118) QO ClipRegion 0x007E (126) „3 saveClipRects 0x0082 (130) I reserved2 0x0086 (134) I DamageList 0x009C (156) Eine Ganzzahl, deren Wert dem vertikalen Verschiebesatz in Pixeln entspricht, der diesem Layer mittels des letzten Auf- rufs von ScrollLayer zugeordnet wurde. Ein Adreßzeiger auf eine ClipRect-Datenstruktur, der von der privaten Systemroutine dedice zur Verwaltung und Analyse der diversen Überlappungsbereiche verwendet wird. Wie Komponente cr. Wie Komponente cr, allerdings dient dieser Zeiger vor- nehmlich der Aufnahme neu erzeugter Clipping-Bereiche. Ein Adreßzeiger auf die erste ClipRect-Datenstruktur einer Liste von Clipping-Bereichen, die im voraus für später als Vorrat allokiert wurden. Ein Adreßzeiger auf eine ClipRect-Datenstruktur, der intern von den Systemroutinen während des Refreshs benötigt wird. Ein Adreßzeiger auf die LayerInfo-Datenstruktur des Layer- infos, das diesen Layer enthält. Eine SignalSemaphore-Datenstruktur (siehe »Exec«), die zum Sperren des Layers benötigt wird und dabei als Syn- chronisationselement für die betroffenen Tasks dient. Ein für den Systemgebrauch reserviertes Feld von acht Bytes. Ein Adreßzeiger auf eine Region-Datenstruktur, die die Ausmaße und Lager der einzelnen rechteckigen Clipping- Bereiche beschreibt. Ein Adreßzeiger auf eine Region-Datenstruktur, die im Falle von schwerwiegenden (Speicher-)Problemen beim Ausstieg durch die Hintertür von den Systemroutinen verwendet wird, um zu retten, was zu retten ist. Ein nicht mehr benutztes Feld von 22 Byte, das aus system- internen Gründen nicht wegfallen darf. Ein Adreßzeiger aufeine Region-Datenstruktur, über die die eigentliche Damageliste des Layers verwaltet wird. Diese enthält genaue Auskünfte darüber, welche Teile des Layers beim Refresh überhaupt einer Auffrischung bedürfen. Insbe- sondere im SimpleRefresh-Modus kann man diesen Zeiger zur Erzeugung interessanter grafischer Effekte einsetzen. Layerlnfo Offset C (graphics/layers.h) Modula-2 (Graphics) Assembler Datenstrukturenreferenz Routinenreferenz D___> Beschreibung struct Layer_Info struct Layer *top_layer; struct Layer *check_Ip; struct Layer *obs; struct MinList FreeClipRects; struct SignalSemaphore Lock; struct List gs_Head; LONG longreserved; UWORD Flags; BYTE fatten_count; BYTE LockLayersCount; UWORD Layerlnfo_extra_size; WORD *blitbuff; struct LayerInfo_extra *LayerInfo_extra; ; Präfix: Syntax: »Graphics«: »Intuition«: »Layers«: Layerlnfo = RECORD layer:LayerPtr; Ip:LayerPtr; obs:LayerPtr; freeClipRects:Minlbist; lock:SignalSemaphore; head:List; longreserved:LONGINT, flags:LayerFlagsSet; count:UByte; lockLayersCount:ÜByte; layerInfoExtraSize:CARDINAL; blitbuff: ADDRESS; layerInfoExtra: ADDRESS; END; li Strukturname = Layer_Info longreserved —> li_long_reserved Layer. Screen. CreateBehindLayer, CreateUpfront- Layer, DisposeLayerInfo, FattenLayer- Info, InitLayers, LockLayerInfo, LockLayers, NewLayerlInfo, ThinLayer- Info, UnlockLayerInfo, UnlockLayers, WhichLayer. Die LayerInfo-Datenstruktur wird von den Systemroutinen der »layers.library« benötigt, um ein rei- bungsloses Zusammenspiel der verschiedenen Layer eines Viewports bzw. einer Bitmap garantieren zu können. „1 top_layer 0x0000 (0) 4 check_Ip 0x0004 (4) I obs 0x0008 (8) I FreeClipRects 0x000C (12) Ein Adreßzeiger auf die Layer-Datenstruktur des obersten Layers der zu diesem Layerinfo gehörigen Layerliste. Ein von den Systemroutinen zu Identifikationzwecken in- tern verwendeter Adreßzeiger auf eine Layer-Datenstruktur. Ein von den Systemroutinen zu Markierungszwecken intern verwendeter Adreßzeiger auf eine Layer-Datenstruktur. Eine MinList-Datenstruktur (siehe »Exec«), über die Adreß- zeiger auf freie Clipping-Rechtecke verwaltet werden. 1 Lock 0x0018 (24) Eine SignalSemaphore-Datenstruktur (siehe »Exec«), die zum Sperren des Layerinfos benötigt wird und dabei als Synchronisationselement für die betroffenen Tasks dient. 3 gs Head 0x0046 (70) Eine für den Systemgebrauch reservierte List-Datenstruktur (siehe »Exec«). [I longreserved 0x0054 (84) Ein für den Systemgebrauch reserviertes Langwort. I Flags 0x0058 (88) C Eine 2-Byte-Marke, deren Bit 0 anzeigt, ob diesem Layer- info bereits ein LayerInfo_extra-Datenbereich zugeordnet wurde. In diesem Fall ist der Wert von Flags dann ungerade. Zur Benutzung sind folgende Konstanten vordefiniert (die Modula-2-Definition als LayerFlagset ist falsch!): Modula-2 Hex Dez NEWLAYERINFO_CALLED newLayerlnfoCalled 0001 1 I fatten_count 0x005A (90) Ein 1-Byte-Zähler, dessen Wert die Anzahl der Anforderun- gen wiedergibt, die bisher für die Zuordnung eines LayerInfo_extra-Datenbereichs zu diesem Layerinfo ge- stellt wurden. UI LockLayersCount 0x005B (91) Ein 1-Byte-Zähler, dessen Wert gleich der Anzahl der momentan gesperrten Layer ist, die zur Layerliste dieses Layerinfos gehören. DO LayerInfo_extra_size 0x005C (92) Eine positive Ganzzahl, deren Wert die Größe des LayerInfo_extra-Datenbereichs dieses Layerinfos in Bytes angibt. I blitbuff 0x005E (94) Ein Adreßzeiger aufeinen Pufferspeicherbereich, der bei der Durchführung von Blitteroperationen innerhalb der Layer des Layerinfos benötigt wird. 4 LayerInfo_extra 0x0062 (98) Ein Adreßzeiger auf den LayerInfo_extra-Datenbereich Rasinfo Hex 0000 - 0004 Dez 0 4 dieses Layerinfos, der aus Geschwindigkeitsgründen vom System für diverse Verwaltungszwecke benutzt wird. C (graphics/view.h) Modula-2 (Graphics) struct RasInfo RasInfo = ( RECORD struct RasInfo *Next; next:RasInfoPtr; struct BitMap *BitMap; bitMap:BitMapPir; om C (graphics/view.h) Modula-2 (Graphics) SHORT RxOffset; rxOÖffset:INTEGER; SHORT RyOffset; ryOffset:INTEGER; EB END; Assembler | Präfix: ri_ Datenstrukturenreferenz »Graphics«: RasInfo, ViewPort. Routinenreferenz Keine. DH Beschreibung In der RasInfo-Datenstruktur werden die Statusinformationen für den Displayspeicher eines Viewport- Playfields untergebracht. 1 Next 0x0000 (0) Ein Adreßzeiger auf eine weitere RasInfo-Datenstruktur, die dem zweiten Playfield eines Viewports im Dual-Playfield- Modus zugeordnet ist. Ansonsten enthält diese Komponente immer den Wert NULL. I BitMap 0x0004 (4) Ein Adreßzeiger auf die der Bitmap des Playfields zugeordnete BitMap-Datenstruktur. I RxOffset 0x0008 (8) Eine Ganzzahl, deren Wert den horizontalen Versatz des Playfields relativ zu den Grenzen seiner Bitmap in Pixeln angibt. I RyOffset 0x000A (10) Eine Ganzzahl, deren Wert den vertikalen Versatz des Play- fields relativ zu den Grenzen seiner Bitmap in Pixeln angibt. RastPort Offset Modula-2 (Graphics) C (graphics/rastport.h) struct RastPort RastPort = { RECORD struct Layer *Layer; layer:LayerPtr; struct BitMap *BitMap; bitMap:BitMapPir; 8 USHORT *AreaPtrn; areaPtrn: ADDRESS; 12 struct TmpRas *TmpRas; tmpRas:TmpRasPtr; 16 struct Arealnfo * Arealnfo; arealnfo:ArealnfoPtr; 20 struct GelsInfo *GelsInfo; gelsInfo:GelsInfoPtr; UBYTE Mask; mask:UByte; Offset C (graphics/rastport.h) Modula-2 (Graphics) Hex Dez 0019 25 001A 26 001B 27 001C 28 001D 29 O01E 30 O01F 31 0020 32 0022 34 0024 36 0026 38 0028 40 0030 48 0032 50 0034 52 0038 56 0039 57 003A 58 003C 60 0O3E 62 0040 64 0042 66 0046 70 O04E 78 005C 92 0064 100 Assembler Datenstrukturenreferenz Routinenreferenz h BYTE FgPen; BYTE BgPen; BYTE AOlPen; BYTE DrawMode; BYTE AreaPtSz; BYTE linpatcnt; BYTEdummy; USHORT Flags; USHORT LinePtrn; SHORT cpx; SHORT cp_y; UBYTE minterms[8]; SHORT PenWidth; SHORT PenHeight; struct TextFont *Font; UBYTE Algostyle; UBYTE TxFlags; UWORD TkHeight; UWORD TxWidth; UWORD TxBaseline; WORD TkxSpacing; APTR *RP_User; ULONG longreserved[2]; UWORD wordreserved[7]; UBYTE reserved[8]; Präfix: Syntax: »Graphics«: »Intuition«: »GfxMacros«: »Graphics«: fgPen:UByte; bgPen:UByte; aQOlPen:UByte; drawMode:DrawModeSet; areaPtSz:UByte; linPatCnt:UByte; dummy:BYTE; flags:RastPortFlagSet; linePtrn:CARDINAL; x:INTEGER; y:INTEGER; minterms: ARRAY [0..7] OF Byte; penWidth:INTEGER; penHeight:INTEGER; font:TextFontPtr; algoStyle:FontStyleSet; txFlags:FontFlagsSet; txHeight:CARDINAL; txWidth:CARDINAL; txBaseline:CARDINAL, txSpacing:INTEGER; user: ADDRESS; longreserved: ARRAY [0..1] OFLONGINT,; wordreserved: ARRAY [0..6] OF WORD; reserved: ARRAY [0..7] OF BYTE; END; rp_ dummy —> rp_Dummy IODRPRegq, Layer. GListEnv, IntuitionBase, Screen, Win- dow. AreaCircle, BNDRYOFF, DrawCircle, SetAfPen, SetDrPt, SetOPen, SetWrMsk. AddAnimOb, AddBob, AddVSprite, Animate, AreaDraw, Areakllipse, AreaEnd, AreaMove, AskFont, AskSoft- Style, BltBitMapRastPort, BltMask- > Beschreibung BitMapRastPort, BltPattern, BltTem- plate, ClearEOL,ClearScreen, ClipBlit, DoCollision, Draw, DrawEllipse, DrawGList, Flood, FreeGBuffers, GetGBuffers, InitRastPort, Move, PolyDraw, ReadPixel, RectFill, RemIBob, ScrollRaster, SetAPen, SetBPen, SetDrMd, SetFont, SetRast, SetSoftStyle, SortGList,SwapBitsRast- PortClipRect, Text, TextLength, Write- Pixel. »Intuition«: DrawBorder, Drawlmage, PrintIText. »Layers«: SwapBitsRastPortClipRect. Die RastPort-Datenstruktur dient der Steuerung der grafischen Zeichen- und Animationsroutinen sowie deren Koordination mit dem eigentlichen Displayspeicher der Bitplanes. Deshalb ist jeder Rastport immer einer ganz bestimmten Bitmap zugeordnet, in deren Bitplanes die rufenden Grafikroutinen zeichnen. Alle höheren Displayelemente besitzen auf dem Amiga ihren eigenen RastPort-Datensatz. Die überragende Bedeutung dieser Datenstruktur für den reibungslosen Ablauf des Augabegeschehens er- kennen Sie nicht zuletzt daran, wie viele Systemroutinen auf einen Rastport direkt zugreifen. Der Umfang der RastPort-Datenstruktur spiegelt die Tatsache wider, daß hier sämtliche Statuswerte des Ausgabezustands eines Displayelements wie z.B. Zeichenmodus oder Füllmuster gespeichert werden. Jo oJ Layer 0x0000 (0) BitMap 0x0004 (4) AreaPtrn 0x0008 (8) TmpRas 0x000C (12) Arealnfo 0x0010 (16) GelsInfo 0x0014 (20) Mask 0x0018 (24) Ein Adreßzeiger auf die diesem Rastport zugeordnete Layer- Datenstruktur. Ein Adreßzeiger auf die BitMap-Datenstruktur, der dieser Rastport zugeordnet ist. Ein Adreßzeiger auf eine Tabelle von Datenworten, die das aktuelle Füllmuster des Rastports darstellen. Die Länge der Tabelle entspricht dem Wert der AreaPt$z-Komponente des Rastports. Ein Adreßzeiger auf die dem Rastport momentan zugeordnete TmpRas-Datenstruktur, die von den grafischen Füllroutinen benötigt wird. Ein Adreßzeiger auf die aktuelle Area/nfo-Datenstruktur des Rastports, die von den Areaxxx-Routinen zum Füllen von Polygonen verwendet wird. Ein Adreßzeiger auf die GelsInfo-Datenstruktur, die dem Rastport gerade zugeordnet ist. Über diese Datenstruktur werden sämtliche Animationsobjekte des Rastports ver- waltet. Eine 1-Byte-Maske, deren einzelne Bits festlegen, welche Bitplanes des Rastports durch die Grafikroutinen tatsächlich verändert werden. Ein Wert von %00000101 = $05 = 5 für diese Schreibmaske wählt die Bitplanes 0 und 2 aus, wobei alle übrigen desaktiviert werden. I FgPen 0x0019 (25) Eine positive Ganzzahl, deren Wert die Nummer der beim Zeichnen in diesem Rastport verwendeten Vordergrund- farbe angibt. I BgPen 0x001A (26) Eine positive Ganzzahl, deren Wert die Nummer der beim Zeichnen in diesem Rastport verwendeten Hintergrundfarbe angibt. I AOlPen 0x001B (27) Eine Ganzzahl, deren Wert die Farbnummer des »area outline pen« angibt. Diese Farbe wird zum Zeichnen der Umrandung einer gefüllten Fläche benutzt, falls das AREA- OUTLINE-Bit in der Flags-Komponente des Rastports ge- setzt ist. „1 DrawMode 0x001C (28) Eine 1-Byte-Marke, deren einzelne Bits den aktuellen Zei- chenmodus des Rastports festlegen (siehe DrawModes). II AreaPtSz 0x001D (29) Eine Ganzzahl, deren Wert die Höhe des aktuellen Füllmu- sters des Rastports angibt. Dieser Wert sollte einer echten Zweierpotenz entsprechen. I linPatCnt 0x001E (30) Eine von den Zeichenroutinen verwendete positive Ganz- zahl, die den aktuellen »Preshift« für das Linienmuster des Rastports festlegt. I dummy 0x001F (31) Ein bisher unbenutztes Füllbyte. I Flags 0x0020 (32) Eine 2-Byte-Marke, deren einzelne Bits das Verhalten der Zeichenroutinen in diesem Rastport steuern. Zur Benutzung sind dabei die folgenden Werte vordefiniert: Modula-2 Hex Dez Bedeutung firstDot 0001 l Ersten Punkt der Linie zeichnen? ONE_DOT oneDot 0002 2 Linien im Ein-Punkt-Modus zeichnen? DBUFFER dBuffer 0004 4 Ist der Rastport doppelt gepuffert? AREAOUTLINE areaQutline 0008 8 Umrandung beim Füllen ‚hervorheben? NOCROSSFILL noCrossFill 0020 32 Keine Überschneidungen beim Füllen? FRST_DOT Wichtig: In Modula ist hier der Mengentyp RastPortFlagSet zu benutzen. LinePtrn 0x0022 (34) cp_x 0x0024 (36) cp_y 0x0026 (38) minTerms 0x0028 (40) PenWidth 0x0030 (48) PenHeight 0x0032 (50) Font 0x0034 (52) AlgoStyle 0x0038 (56) TxFlags 0x0039 (57) TxHeight 0x003A (58) TxWidth 0x003C (60) TxBaseline 0x003E (62) TxSpacing 0x0040 (64) Ein Datenwort, das von den Zeichenroutinen als aktuelles Linienmuster des Rastports verwendet wird. Eine postive Ganzzahl, deren Wert die x-Koordinate der aktuellen Position des Grafikcursors innerhalb des Rastports festlegt. Eine positive Ganzzahl, deren Wert die y-Koordinate der aktuellen Position des Grafikcursors innerhalb des Rastports festlegt. Ein Feld von acht 1-Byte-Marken, die den mit Rastports arbeitenden Blitterroutinen als Minterme der einzelnen Bitplanes des Rastports dienen. Eine positive Ganzzahl, deren Wert die Breite des von den Grafikroutinen verwendeten Zeichenstifts in Pixeln angibt. (Wichtig: Wird bisher nicht verwendet!) Eine positive Ganzzahl, deren Wert die Höhe des von den Grafikroutinen verwendeten Zeichenstifts in Pixeln angibt. (Wichtig: Wird bisher nicht verwendet!) Ein Adreßzeiger auf die dem Rastport momentan zugeordnete TextFont-Datenstruktur, die den für Textaus- gaben innerhalb des Rastports verwendeten Textfont auswählt. Eine 1-Byte-Marke, deren einzelne Bits den algorithmisch zu generierenden Stiltyp für Textausgaben innerhalb des Rastports angeben (siehe FontStyles). Eine 1-Byte-Marke, deren Wert Statusinformationen bezüg- lich des innerhalb des Rastports momentan verwendeten Textfonts enthält. Eine positive Ganzzahl, deren Wert die Höhe der Zeichen des momentan innerhalb des Rastports verwendeten Text- fonts in Pixeln angibt. Eine positive Ganzzahl, deren Wert die nominelle Durch- schnittsbreite der Zeichen des momentan innerhalb des Rastports verwendeten Textfonts in Pixeln angibt. Eine Ganzzahl, deren Wert den Abstand (in Pixeln) der Basislinie der Zeichen des momentan innerhalb des Rast- ports verwendeten Textfonts festlegt. Dieser Abstand wird relativ zum obersten Pixel der Punktmatrix eines jeden Zeichens gemessen. Eine positive Ganzzahl, deren Wert die Breite der im Rast- port auszugebenden Zeichen in Pixeln festlegt. Dieser Wert muß keineswegs dem Wert der TxWidth-Komponente ent- sprechen! I RP _User 0x0042 (66) I longReserved 0x0046 (70) 1 wordReserved 0x004E (78) I reserved 0x005C (92) Rectangle C (graphics/gfx.h) Ein Adreßzeiger auf einen beliebigen Datenbereich, der diesem Rastport vom Benutzer zur freien Verfügung zuge- ordnet wurde. Ein für den internen Systemgebrauch reserviertes Feld von zwei Langworten. Ein nicht mehr benötigtes Feld von sieben Datenworten, das unter früheren Systemversionen eine Node-Datenstruktur von »Exec« beinhaltete. Unter früheren Systemversionen für zukünftige Erweite- rungen reserviertes Feld von acht Bytes. Modula-2 (Graphics) Hex Dez struct Rectangle Rectangle = { RECORD 0000 0 SHORT MinX; minX:INTEGER; 0002 2 SHORT MinY,; minY:INTEGER; 0004 4 SHORT MaxX; maxX:INTEGER; 0006 6 SHORT MaxY; maxY:INTEGER; 0008 8 K END; Assembler Präfix: ra_ Datenstrukturenreferenz »Graphics«: ClipRect, Layer, Region, RegionRec- tangle. Routinenreferenz »Graphics«: AndRectRegion, ClearRectRegion, Or- [__> Beschreibung RectRegion, XorRectRegion. Die Rectangle-Datenstruktur dient der Beschreibung beliebiger rechteckiger Displayausschnitte. 4 MinX 0x0000 (0) U MinY 0x0002 (2) „1 MaxX 0x0004 (4) 1 MaxY 0x0006 (6) Eine Ganzzahl, deren Wert die x-Koordinate des linken oberen Eckpunkts des Rechtecks angibt. Eine Ganzzahl, deren Wert die y-Koordinate des linken oberen Eckpunkts des Rechtecks angibt. Eine Ganzzahl, deren Wert die x-Koordinate des rechten unteren Eckpunkts des Rechtecks angibt. Eine Ganzzahl, deren Wert die y-Koordinate des rechten unteren Eckpunkts des Rechtecks angibt. Region DEE C (graphics/regions.h) struct Region { struct Rectangle bounds; struct RegionRectangle *RegionRectangle; }: Assembler Datenstrukturenreferenz Routinenreferenz [__ > Beschreibung Präfix: »Graphics«: »Intuition«: »Graphics«: »Layers«: Modula-2 (Graphics) Region = RECORD bounds:Rectangle; regionRectangle: RegionRectanglePtr; END; rg_ Layer. IntuitionBase. AndRectRegion, AndRegionRegion, ClearRectRegion, ClearRegion, DisposeRegion, NewRegion, OrRectRegion, OrRegionRegion, XorRectRegion, XorRegionRegion. InstallClipRegion. Die Region-Datenstruktur dient in erster Linie dem Aufbau der Damageliste eines Layers. Zu diesem Zweck ist jeder Region-Datenstruktur als Hauptkomponente eine Liste von RegionRectangle-Recht- ecken zugeordnet. Die Vereinigungsmenge dieser Rechtecke stellt nun genau den von der Region beschriebenen (heterogenen!) Displaybereich dar. Im Falle der Damageliste eines Layers entspricht dieser Bereich gerade den aufzufrischenden Rechteckteilen des Layers. I} bounds 0x0000 (0) U RegionRectangle 0x0004 (4) Eine Rectangle-Datenstruktur, die den kleinsten rechtecki- gen Displayausschnitt beschreibt, in dem sämtliche Recht- ecke der Rechteckliste dieser Region vorhanden sind. Ein Adreßzeiger auf eine RegionRectangle-Datenstruktur, die das Anfangselement der Rechteckliste dieser Region darstellt. RegionRectangle Offset C (graphics/regions.h) Modula-2 (Graphics) Assembler Datenstrukturenreferenz Routinenreferenz 7_-> Beschreibung struct RegionRectangle { struct RegionRectangle *Next; struct RegionRectangle *Prev; struct Rectangle bounds; b RegionRectangle = RECORD next:RegionRectanglePtr; prev:RegionRectanglePtr; bounds:Rectangle; END; Präfix: rr »Graphics«: Region, Rectangle. Keine. Die RegionRectangle-Datenstruktur dient dem Aufbau der Rechteckliste einer Region-Datenstruktur. „1 Next 0x0000 (0) „I Prev 0x0004 (4) 1 bounds 0x0008 (8) SimpleSprite Offset Hex Dez Ein Adreßzeiger auf die RegionRectangle-Datenstruktur des nachfolgenden Elements in der Rechteckliste. Über die Next-Zeiger werden sämtliche Rechtecke einer Region vor- wärts verkettet. Ein Adreßzeiger auf die RegionRectangle-Datenstruktur des vorangehenden Elements in der Rechteckliste. Über die Prev-Zeiger werden sämtliche Rechtecke einer Region rück- wärts verkettet. Eine Rectangle-Datenstruktur, deren einzelne Komponen- ten die Lage und Ausmaße des durch diese RegionRec- tangle-Datenstruktur beschriebenen Rechtecks angeben. C (graphics/sprite.h) Modula-2 (Graphics) struct SimpleSprite SimpleSprite = { RECORD UWORD *posctldata; posctldata: ADDRESS; UWORD height; height:CARDINAL; UWORD x; x:CARDINAL; . UWORD y; y:CARDINAL; num:INTEGER; UWORD num; ; END; Assembler Präfix: ss_ Datenstrukturenreferenz »Intuition«: IntuitionBase. Routinenreferenz »Graphics«: ChangesSprite, GetSprite, MoveSprite. Beschreibung Die SimpleSprite-Datenstruktur wird von den Animationsroutinen zur Darstellung und Verwaltung eines einfachen Hardwaresprites verwendet. Ein einfaches Hardwaresprite ist genau 16 Pixel breit, wohinge- gen seine Höhe frei wählbar ist. Sämtliche Sprites werden immer im normalen Low-Resolution-Modus dargestellt. Gegenüber virtuellen Sprites und Bobs sind die Möglichkeiten der Animation mit einfachen Hardwaresprites stark eingeschränkt. I posctidata 0x0000 (0) Ein Adreßzeiger auf die eigentlichen Displaydaten des ein- fachen Sprites, die man auch SpriteData nennt. Insgesamt umfassen die Spritedaten genau 2*height+4 Datenworte, die im Speicher folgendermaßen anzuordnen sind: BOSCL data. 2 Kontro]lworte ea } Displaydaten Wort Z2*height+l Wort 2*height+t2 Wort 2*height+3 Die ersten beiden werden von der Spritehardware für die Positions- und Statuskontrolle des Sprites benötigt. Deshalb sollten Sie diese am Anfang stets mit Nullen initialisieren. Die nachfolgenden 2*height-Datenworte enthalten dagegen die eigentlichen Displaydaten. Für jede Zeile des Sprites sind hier zwei aufeinanderfolgende Datenworte nötig, deren korrespondierende Bits die Farbe des entspre- chenden Pixels festlegen. Neben der Farbe »Transparent« mit Farbcode $0 = %00 = 0 sind drei weitere Farben auswählbar. Die letzten beiden Datenworte müssen mit Nullen initialisiert werden, da sie der Hardware als Endemarkierung der Spritedaten dienen. Endemarkierungen I height 0x0004 (4) Eine positive Ganzzahl, deren Wert die Höhe des einfachen Sprites, gemessen in normalen Low-Resolution-Pixeln fest- legt. „I x 0x0006 (6) Eine positive Ganzzahl, deren Wert die x-Koordinate der aktuellen Position des einfachen Sprites, gemessen in nor- malen Low-Resolution-Pixel angibt. Dieser Wert ist relativ zum Viewport oder View zu interpretieren, dem das einfache Sprite bei seiner Erzeugung zugeordnet wurde. 4 y 0x0008 (8) Eine positive Ganzzahl, deren Wert die y-Koordinate der aktuellen Position des einfachen Sprites, gemessen in nor- malen Low-Resolution-Pixeln, angibt. Dieser Wert ist rela- tiv zum Viewport oder View zu interpretieren, dem das einfache Sprite bei seiner Erzeugung zugeordnet wurde. U num 0x000A (10) Eine positive Ganzzahl, deren Wert gleich der Nummer des Hardwaresprites ist, dem das einfache Sprite bei seiner Erzeugung zugeordnet wurde. TextAttr C (graphics/text.h) Modula-2 (Graphics) struct TextAttr TextAttr = { RECORD STRPTR ta_Name; name:ADDRESS; UWORD ta_YSize; ySize:CARDINAL; UBYTE ta_Style; style:FontStyleSet; UBYTE ta_Flags; flags:FontFlagSet; IE END; Datenstrukturenreferenz | »DiskFont«: AvailFont. »Intuition«: IntuiText, IntuitionBase, NewScreen, Window. Routinenreferenz »DiskFonte«: OpenDiskFont. »Graphics«: AskFont, OpenFont. [__ > Beschreibung Die TextAttr-Datenstruktur dient zur Aufnahme der Attribute Name, Höhe und Schrifttyp, die einen Textfont eindeutig charakterisieren. J ta_Name 0x0000 (0) Ein Adreßzeiger auf eine Null-terminierte Zeichenkette, die den Namen des Textfonts (ohne Höhenangabe!) angibt. J ta_YSize 0x0004 (4) Eine positive Ganzzahl, deren Wert die Höhe des Textfonts in Pixeln festlegt. _J ta_Style 0x0006 (6) Eine 2-Byte-Marke, deren einzelne FontStyles-Bits dem voreingestellten Darstellungsmodus der Zeichen des Text- fonts entsprechen (siehe FontStyles). 1 ta_Flags 0x0007 (7) Eine 2-Byte-Marke, deren einzelne FontFlags-Bits Aus- kunft über voreingestellte Charakteristika und Statuswerte des Textfonts geben (siehe FontFlags). TextFont Offset C (graphics/text.h) Modula-2 (Graphics) Hex Dez struct TextFont TextFont = ! RECORD 0000 0 struct Message tf_Message; message:Message; 0014 20 UWORD tf_YSıze; ySize:CARDINAL; 0016 22 UBYTE tf_Style; style:FontStyleSet; 0017 23 UBYTE tf_Flags; flags:FontFlagsSet; 0018 24 UWORD tf_ XSize; xSize:CARDINAL; 001A 26 UWORD tf_Baseline; baseline:CARDINAL; v001C 28 UWORD tf_BoldSmear; boldSmear:CARDINAL; 001E 30 UWORD tf_Accessors; accessors:CARDINAL; 0020 32 UBYTE tf_LoChar; loChar:CHAR; 0021 33 UBYTE tf_HiChar; hiChar:CHAR; 0022 34 APTR tf_CharData; charData: ADDRESS; 0026 38 UWORD tf_Modulo; modulo:CARDINAL; 0028 40 APTR tf_CharLoc; charLoc: ADDRESS; 002C 44 APTR tf_CharSpace; charSpace: ADDRESS; 0030 48 APTR tf_CharKem; charKern: ADDRESS; 0034 52 }: END; Datenstrukturenreferenz »Console«: ConUnit. | »DiskFont«: DiskFontHeader. »Graphics«: GfxBase, RastPort. »Intuition«: Window. Routinenreferenz »DiskFont«: OpenDiskFont. »Graphics«: AddFont, CloseFont, OpenFont, RemFont, SetFont. __> Beschreibung In der TextFont-Datenstruktur werden alle Informationen und Statusdaten eines Textfonts (Zeichensat- zes) gespeichert und verwaltet. Neben den eigentlichen Pixelmatrizen, die in einer speziell gepackten Form vorliegen, finden sich hier diverse Größen-, Positionier- und Offsetangaben für die Textfonts. Die TextFont-Datenstruktur ist dabei so konzipiert, daß sämtliche verfügbaren Textfonts bequem in die Systemfontliste integriert und in dieser schnell selektiert werden können. I tf_ Message 0x0000 (0) Eine Message-Datenstruktur (siehe »Exec«), die beim Ent- fernen des Zeichensatzes aus der Systemfontliste als »reply tf_YSize 0x0014 (20) tf_Style 0x0016 (22) tf_ Flags 0x0017 (23) tf_XSize 0x0018 (24) tf_Baseline 0x001A (26) tf_BoldSmear 0x001C (28) tf_Accessors 0x001E (30) tf_LoChar 0x0020 (32) tf HiChar 0x0021 (33) tf CharData 0x0022 (34) tf_Modulo 0x0026 (38) message« dient. Über die mn _node-Komponente dieser Message-Datenstruktur ist der Textfont in die Systemfont- liste eingereiht (siehe GfxBase). Der In_name-Zeiger der mn_node-Komponente verweist auf den Namen des Text- fonts in Form einer normalen C-Zeichenkette. Eine positive Ganzzahl, deren Wert die Höhe der Zeichen des Textfonts in Pixeln angibt. Eine 1-Byte-Marke, deren einzelne FontStyles-Bits den Dar- stellungstyp des Textfonts beschreiben. Eine 1-Byte Marke, deren einzelne FontFlags-Bits Status- informationen bezüglich des Design-Typs des Textfonts beinhalten. Eine positive Ganzzahl, deren Wert die nominale (Durch- schnitts-)Breite der Zeichen des Textfonts in Pixeln angibt. Eine positive Ganzzahl, deren Wert die Entfernung (in Pixeln) der Basiszeile vom oberen Zeichenrand für jedes Zeichen des Textfonts festlegt. Eine positive Ganzzahl, deren Wert die für die (algorithmi- sche) Erzeugung von fetten Zeichen zu verwendende »Verschmierbreite« in Pixeln angibt. Eine positive Ganzzahl, die als Zähler für die diesen Textfont momentan benutzenden Tasks dient. Erst wenn dieser Zähler gleich Null ist, kann der Textfont nach einem entsprechen- den Aufruf der »Graphics«-Routine RemFont endgültig aus der Systemfontliste entfernt werden. Eine positive Ganzzahl, deren Wert den ASCII-Code des kleinsten Zeichens angibt, das in diesem Textfont verfügbar ist (für das der Textfont also eine Punktmatrix enthält). Eine positive Ganzzahl, deren Wert den ASCII-Code des größten Zeichens angibt, das in diesem Textfont verfügbar ist (für das der Textfont also eine Punktmatrix enthält). Ein Adreßzeiger auf einen Speicherbereich im Chip-RAM, der die Daten der Pixelmatrizen aller Zeichen des Textfonts enthält. Die Pixelmatrizen liegen dabei zeilenweise in Bit- form gepackt vor. Allerdings liegen hier nicht etwa die vollständigen Pixelmatrizen nacheinander in Form einer Tabelle vor. Vielmehr werden die korrespondierenden Zei- len sämtlicher Zeichen hintereinander gepackt, angefangen mit der obersten bis hin zu untersten! Eine positive Ganzzahl, deren Wert den Abstand (in Bytes) der Pixeldaten zweier aufeinanderfolgender Zeilen eines Zeichens im tf CharData-Bereich angibt. I tf_CharLoc 0x0028 (40) „I tf_CharSpace 0x002C (44) I tf_CharKern 0x0030 (48) struct TmpRas { BYTE *RasPtr; LONG Size; }; Assembler Datenstrukturenreferenz Routinenreferenz Ein Adreßzeiger auf ein Feld von Ganzzahlpaaren, die den genauen Bitoffset und die Bitbreite sämtlicher Zeichen des Textfonts im ff CharData-Bereich beschreiben. Ein Adreßzeiger auf ein Feld von Ganzzahlen, deren Werte die tatsächliche Breite der korrespondierenden Zeichen des Textfonts in Pixeln festlegen. Diese Informationen werden nur für einen proportionalen Zeichensatz benötigt. Bei nicht- proportionalen Zeichensätzen ist der Wert dieses Adreßzei- gers gleich NULL, und für alle Zeichen gilt die nominale Breite aus ff XSize. Ein Adreßzeiger auf ein Feld von Ganzzahlen, deren Werte für jedes Zeichen des Textfonts den Abstand zwischen erster Spalte des ausgegebenen Zeichenrasters und dem Beginn der eigentlichen Pixelinformationen festlegen. Ist der Wert die- ses Adreßzeigers gleich NULZ, so gilt für sämtliche Zeichen des Textfonts ein einheitlicher Abstand von null. TmpRas = RECORD rasPtr- ADDRESS; size: LONGINT; END; Präfix: ir »Graphics«: RastPort. »Intuition«: IntuitionBase. »Graphics«: InitTmpRas. Die TmpRas-Datenstruktur dient zur Aufnahme einer einzigen, von den »Graphics«-Füllroutinen (wie z.B. AreaCircle) temporär benötigten Bitplane. 1 RasPtr 0x0000 (0) I Size 0x0004 (4) Ein Adreßzeiger auf das erste Datenbyte der temporären Bitplane, die aus einem zusammenhängenden Speicher- bereich im Chip-RAM bestehen muß. Eine positive lange Ganzzahl, deren Wert die Größe der temporären Bitplane in Bytes angibt. UCopList C (graphics/copper.h) Modula-2 (Graphics) struct UCopList UCoplist = { RECORD struct UCopList *Next; next:UCopListPtr; struct CopList *FirstCopList; firstCopList:CopListPtr; struct CopList *CopLbist; copList:CopListPtr; b END; Assembler Präfix: uch Datenstrukturenreferenz »Graphics«: UCopList, ViewPort. Routinenreferenz »GfxMacros«: CEND, CINIT, CMOVE, CWAIT. »Graphics«: CBump, CMove, CWait, UCopper- ListlInit. __> Beschreibung Die UCopList-Datenstruktur wird zur Verwaltung von Benutzer-Copperlisten verwendet, die intern aus mehreren Zwischen-Copperlisten bestehen. „1 Next 0x0000 (0) Ein Adreßzeiger auf die nächste UCopList-Datenstruktur der Benutzer-Copperliste. Über die Next-Zeiger werden sämtliche (Unter-)Abschnitte einer Benutzer-Copperliste vorwärts verkettet. 4 FirstCopList 0x0004 (4) Ein Adreßzeiger auf den ersten Eintrag in der zu dieser Benutzer-Copperliste gehörigen Zwischen-Copgperliste. I CopList 0x0008 (8) Ein Adreßzeiger auf den gerade bearbeiteten Eintrag in der zu dieser Benutzer-Copperliste gehörigen Zwischen- Copperliste. View Offset C (graphics/view.h) struct View { RECORD struct ViewPort *ViewPort; viewPort: ViewPortPtr; struct cprlist *LOFCprLbäist; lofCprList:CprlistPtr; struct cprlist *SHFCprLsist; shfCprList:CprlistPtr; short DyOffset; dyOffset:INTEGER; om C (graphics/view.h) Modula-2 (Graphics) short DxOffset; dxOffset:INTEGER; UWORD Modes; modes:ViewModeSet; b Assembler Präfix: v_ Datenstrukturenreferenz »Graphics«: RastPort. »Intuition«: IntuitionBase. Routinenreferenz »Graphics«: InitView, LoadView, MakeVPort, MrgCop. »Intuition«: ViewAddress. D—T> Beschreibung In der View-Datenstruktur sind sämtliche Informationen gespeichert, die zur Erzeugung des Monitoraus- gabebilds eines Gesamtdisplays (View) und dessen sonstiger Verwaltung notwendig sind. Ein Umschal- ten zwischen zwei völlig unterschiedlichen Gesamtdisplays ist auf dem Amiga deshalb so leicht realisierbar, indem man für jedes Display eine eigene View-Datenstruktur mitsamt den zugehörigen Viewports und Copperlisten entsprechend initialisieren kann. „1 ViewPort 0x0000 (0) Ein Adreßzeiger auf die zum ersten Viewport des Gesamt- displays gehörige ViewPort-Datenstruktur. Dieser Zeiger ist der Startzeiger einer einfach verketteten Liste von ViewPort- Datensätzen aller zum Gesamtdisplay gehörigen Viewports. J LOFCprList 0x0004 (4) Ein Adreßzeiger auf eine Copperliste für die Erzeugung des Monitorausgabebildes des Gesamtdisplays. Diese Copper- liste wird sowohl im Non-Interlace als auch im Interlace- Modus benutzt. Im Interlace-Modus erzeugt sie das Aus- gabebild der ungeraden Zeilen. die Abkürzung »LOF« am Anfang des Bezeichners steht für »long frame«. J SHFCprList 0x0008 (8) Ein Adreßzeiger auf eine Copperliste, die der Erzeugung des Monitorausgabebildes der geraden Zeilen des Gesamtdis- plays im Interlace-Modus dient. Im Non-Interlace-Modus wird diese Copperliste nicht benutzt! Die Abkürzung »SHF« am Anfang des Bezeichners steht für »short frame«. I DyOffset 0x000C (12) Eine Ganzzahl, deren Wert den vertikalen Versatz des Ge- samtdisplays relativ zum Standardnullpunkt angibt. II DxOffset 0x000E (14) Eine Ganzzahl, deren Wert den horizontalen Versatz des Gesamtdisplays relativ zum Standardnullpunkt angibt. [3 Modes 0x0010 (16) Eine 2-Byte-Marke, deren einzelne ViewModes-Bits den aktuellen Darstellungsmodus des Views festlegen. ViewPort one C (graphics/view.h) Modula-2 (Graphics) Hex Dez 0000 0 0004 4 0008 8 000C 12 0010 16 0014 20 0018 24 001A 26 001C 28 001E 30 0020 32 0022 34 0023 35 0024 36 0028 40 Assembler Datenstrukturenreferenz Routinenreferenz struct ViewPort { struct ViewPort *Next; struct ColorMap *ColorMap; struct CopList *DsplIns; struct CopList *SpriIns; struct CopList *CIrIns; struct UCopList *UCoplns; SHORT DWidth; SHORT DHeight; SHORT DxOffset; SHORT DyOffset; UWORD Modes; UBYTE SpritePriorities; UBYTE reserved; struct RasInfo *Raslnfo; Ri Präfix: vp_ »Graphics«: »Intuition«: »Graphics«: »Intuition«: ViewPort = RECORD next:ViewPortPtr; colorMap:ColorMapPtr; dspIns:CopListPtr; sprIns:CopListPtr; clrIns:CopListPtr; uCopIns:UCopListPtr; dWidth:INTEGER; dHeight:INTEGER; dxOffset:INTEGER; dyOffset:INTEGER; modes:ViewModesSet; spritePriorities: UByte; reserved: UByte; rasInfo:RasInfoPtr; END; CopList, View, ViewPort. Screen. ChangesSprite, DrawGList, FreeVPort- CopLists, InitVPort, LoadRGB4, MakeVPort, MoveSprite, RemiBob, ScrollVPort, SetRGB4d, WaitBOVP. ViewPortAddress. Innerhalb eines Gesamtdisplays, das mittels einer View-Datenstruktur verwaltet wird, können beliebige rechteckige Unterdisplayeinheiten eingerichtet werden. Diese ViewPorts werden von der Systemsoft- ware wie eigenständige Minidisplays verwaltet. Die ViewPort-Datenstruktur dient dabei zur Aufnahme der nötigen Statusinformationen wie z.B. Abmessung, Offsets, Farbauswahl, Displaymodus usw.! Wichtig ist in diesem Zusammenhang noch, daß sich zwei Viewports niemals überlappen dürfen. Weiterhin können Viewports nicht horizontal, sondern immer nur vertikal nebeneinander angeordnet werden, wobei mindestens eine Zeile zwischen ihnen liegen muß. 4 Next 0x0000 (0) Ein Adreßzeiger auf die ViewPort-Datenstruktur, die dem nächsten Viewport in der Viewport-Liste des Gesamtdis- plays zugeordnet ist. Der Startzeiger dieser Viewport-Liste steht in der ViewPort-Komponente der entsprechenden View-Datenstruktur. Über die Next-Zeiger werden sämtliche Viewports eines Gesamtdisplays vorwärts verkettet. ColorMap 0x0004 (4) DspIns 0x0008 (8) SprIns 0x000C (12) CirIns 0x0010 (16) UCopIns 0x0014 (20) DWidth 0x0018 (24) DHeight 0x001A (26) DxOffset 0x001C (28) DyOffset 0x001E (30) Modes 0x0020 (32) SpritePriorities 0x0022 (34) reserved 0x0023 (35) RasInfo 0x0024 (36) Ein Adreßzeiger auf den ColorMap-Datensatz der diesem Viewport zugeordneten Farbtabelle. Ein Adreßzeiger auf die Copperliste mit den Anweisungen zur Erstellung des Monitorausgabebildes dieses Viewports. Ein Adreßzeiger auf die Copperliste mit den Anweisungen zur Erstellung des Monitorausgabebildes der diesem View- port zugeordneten Sprites. Ein Adreßzeiger auf eine Copperliste, die vom System ver- waltet und zur Steuerung der Farbregister dieses Viewports benötigt wird. Ein Adreßzeiger auf eine Benutzer-Copperliste, die Sie nach Belieben zur Erledigung Ihrer ganz persönlichen Aufgaben verwenden können. Eine positive Ganzzahl, deren Wert die Höhe des Viewports in Pixeln angibt. Eine positive Ganzzahl, deren Wert die Breite des Viewports in Pixeln angibt. Der vertikale Versatz der linken, oberen Ecke des Viewports relativ zur linken, oberen Ecke des übergeordneten Gesamt- displays, wobei in Pixeln gemessen wird. Der horizontale Versatz der linken, oberen Ecke des View- ports relativ zur linken, oberen Ecke des übergeordneten Gesamtdisplays, wobei in Pixeln gemessen wird. Eine 2-Byte-Marke, deren einzelne ViewModes-Bits den aktuellen Darstellungsmodus des Viewports festlegen. Eine 1-Byte-Marke, deren einzelne Bits die Prioritätszu- stände der diesem Viewport zugeordneten Sprites wider- spiegeln. Ein für den Systemgebrauch bzw. spätere Erweiterungen reserviertes Datenbyte. Ein Adreßzeiger auf die zu diesem Viewport gehörige RasInfo-Datenstruktur. VSprite Offset C (graphics/gels.h) 0000 0 struct VSprite *NextV Sprite; 0004 4 struct VSprite *PrevVSprite; 0008 8 struct VSprite *DrawPath; 000C 12 struct VSprite *ClearPath; 0010 16 WORD OldY; 0012 18 WORD OldX; 0014 20 WORD Flags; 0016 22 WORD Y; 0018 24 WORDX; 001A 26 WORD Height; 001C 28 WORD Width; 001E 30 WORD Depth; 0020 32 WORD MeMask; 0022 34 WORD HitMask; 0024 36 WORD *lImageData; 0028 40 WORD *BorderLine; 002C 44 WORD *CollMask; 0030 48 WORD *SprColors; 0034 52 struct Bob *VSBob; 0038 56 BYTE PlanePick; 0039 57 BYTE PlaneOnOff; 003A 58 VUÜserStuff VUserExt; 003C 60 }; Assembler Präfix: Syntax: Datenstrukturenreferenz »Graphics«: Routinenreferenz »Graphics«: { Modula-2 (Graphics) VSprite = RECORD nextV Sprite:VSpritePtr; prevVSprite:V SpritePtr; drawPath:V SpritePtr; clearPath:V SpritePtr; oldY:INTEGER; oldX:INTEGER; flags: VSpriteFlagSet; y:INTEGER; x:INTEGER; height:INTEGER; width:INTEGER; depth:INTEGER; meMask:BITSET; hitMask:BITSET,; imageData: ADDRESS; borderLine: ADDRESS; collMask: ADDRESS; sprColors: ADDRESS; vsBob:BobPtr; planePick:UByte; planeOnOff:UByte; END; vS_ Strukturname = VS VUserExt —> vs_SUserExt Bob, DBufPacket, GelsInfo, VSprite. AddVSprite, InitGels, InitMasks, RemV Sprite. Die VSprite-Datenstruktur stellt die Basis des gesamten Animationssystems der Amiga-Systemsoftware dar. Die VSprite-Datenstruktur ist der Grundbaustein aller verfügbaren Datenstrukturen zur Beschrei- bung von Animationselementen. Dies geht besonders deutlich aus der Beschreibung zur AnimOb- Datenstruktur hervor! Wie das gesamte Animationssystem hat auch die VSprite-Datenstruktur ein geteiltes Wesen, das sich sowohl aus speziellen Sprite- und Bob-Anteilen als auch aus diesen beiden Arten von GELs gemein- samen Anteilen zusammensetzt. Isoliert betrachtet dient die VSprite-Datenstruktur zunächst nur der Repräsentation virtueller Sprites. Diese sind eine Erweiterung der Hardwaresprites auf Software-Basis. Die virtuelle Spritemaschine kann beliebig viele virtuelle Sprites gleichzeitig verwalten und auf dem Bildschirm bewegen. Darüber hinaus bestehen die zusätzlichen Eigenschaften virtueller Sprites in eigenen Farbpaletten sowie diversen Möglichkeiten der (Software-)Kollisionserkennung und -behand- lung. Zusammen mit einer Bob-Datenstruktur dient die VSprite-Datenstruktur der Repräsentation eines Bobs. Ein Bob kann ohne VSprite-Datenstruktur nicht existieren! I NextVSprite 0x0000 (0) Ein Adreßzeiger auf die VSprite-Datenstruktur des nächsten GELs in der GEL-Liste des Rastports. Über die NextVSprite- Zeiger werden sämtliche GELs der GEL-Liste eines Rast- ports vorwärts verkettet. 3 PrevVSprite 0x0004 (4) Ein Adreßzeiger auf die VSprite-Datenstruktur des voran- gehenden GELs in der GEL-Liste des Rastports. Über die PrevVSprite-Zeiger werden sämtliche GELs der GEL-Liste eines Rastports rückwärts verkettet. II DrawPath 0x0008 (8) Ein Adreßzeiger auf die VSprite-Datenstruktur des Bobs, das vom Animationssystem nach diesem gezeichnet wird. Über die DrawPath-Zeiger werden die VSprite-Datenstrukturen sämtlicher Bobs einer GEL-Liste in Form einer linearen Liste vorwärts verkettet. Diese Liste dient dem System als Pfad beim tatsächlichen Zeichnen der Bobs. Die Anordnung der Bobs in der DrawPath-Liste wird vom Animationssy- stem beim Aufruf der »Graphics«-Routine DrawGList an- hand der After- und Before-Zeichenprioritäten der einzelnen Bobs bestimmt. I ClearPath 0x000C (12) Ähnlich wie DrawPath, allerdings beschreibt diese Liste den Löschpfad zum Löschen von Bob-Überlagerungen. II OldY 0x0010 (16) Eine Ganzzahl, deren Wert die y-Koordinate der letzten Position des GELs relativ zum umgebenden Rastport angibt. I OldX 0x0012 (18) Eine Ganzzahl, deren Wert die x-Koordinate der letzten Position des GELs relativ zum umgebenden Rastport angibt. I Flags 0x0014 (20) Eine 2-Byte-Marke, deren einzelne Bits Statusinformatio- nen bezüglich der aktuellen Darstellungsform des GEL ss ent- halten. Zur Benutzung sind dabei die folgenden Konstanten vordefiniert: C Modula-2 Hex Dez Bedeutung VSPRITE vsprite 0001 gesetzt=virt. Sprite, gelöscht=Bob SAVEBACK saveBack 0002 2 Soll Hintergrund gespeichert werden? C OVERLAY MUSTDRAW BACKSAVED BOBUPDATE GELGONE VSOVERFLOW Modula-2 Hex Dez Bedeutung overlay 0004 4 Soll Bob-Image Hintergrund überdecken? mustDraw 0008 8 Virtuelles Sprite unbedingt zeichnen? backSaved 0100 256 Ist Hintergrund des Bobs gespeichert? bobUpdate 0200 512 Ist der Bob-Update gerade in Gang? gelGone 0400 1024 Ist GEL außerhalb des Clip- Bereichs? vsOverflow 0800 2048 Istein VSprite-Überlauf aufgetreten? Wichtig: In Modula-2 ist hier der Mengentyp VSpriteFlagSet zu verwenden. Die Maske SUSERFLAGS = (x00FF = 255 aller benutzermanipulierbaren Bits der Flags-Maske ist unter C bereits verfügbar. Für Modula-2 ist sie folgendermaßen zu definieren: »SUserFlags = VSpriteFlagSet{vsprite, saveBack, overlay, mustDraw, vf4, vP, vf6, vf7)«! I Y 0x0016 (22) 4 X 0x0018 (24) Ü Height 0x001A (26) I Width 0x001C (28) I Depth 0x001E (30) J MeMask 0x0020 (32) Eine Ganzzahl, deren Wert die y-Koordinate der augenblick- lichen Position des GEL s relativ zum umgebenden Rastport angibt. Eine Ganzzahl, deren Wert die x-Koordinate der augenblick- lichen Position des GELs relativ zum umgebenden Rastport angibt. Eine Ganzzahl, deren Wert der Höhe des GEL-Images in Pixeln entspricht. Eine Ganzzahl, deren Wert der Breite des GEL-Images entspricht. Für echte virtuelle Sprites sollte hier immer der Wert 16 eingetragen sein. Im Falle der VSprite-Datenstruk- tur eines Bobs, gibt dieser Wert die Breite seiner Image- Bitplanes in Datenworten an (siehe /mageData-Kompo- nente). Eine Ganzzahl, deren Wert die Tiefe des GEL-Images in Bitebenen angibt. Diese Komponente ist lediglich für die VSprite-Datenstruktur eines Bobs nicht jedoch für echte virtuelle Sprites von Bedeutung. Eine 2-Byte-Maske, deren einzelne Bits angeben, mit wel- chen GELs dieses GEL eine Kollision erzeugt, falls es von diesen gerammt wird. In diesem Fall wird bei einem Aufruf der »Graphics«-Routine DoCollision die HitMask des ram- menden und am weitesten links oben liegenden GELs mit der MeMask des gerammten und sich rechts unten befindlichen J HitMask 0x0022 (34) I ImageData 0x0024 (36) [I BorderLine 0x0028 (40) I CollMask 0x002C (44) GELs durch eine logische UND-Operation verknüpft. Die so erhaltene Bitmaske gibt anhand der gesetzten Bits Auskunft darüber, welche Art von Kollision (wenn überhaupt) stattge- funden hat. Zur Kollisionsbehandlung ruft das Animations- system danach automatisch die entsprechende Kollisions- routine aus der GelsInfo-Datenstruktur der GEL-Liste auf. Sind gleich mehrere Kollisionen auf einmal aufgetreten, so wird lediglich die niederwertigste Kollisionsroutine akti- viert. Wichtig bei der Benutzung dieser beiden Stoßmasken ist, daß außer dem für Randkollisionen reservierten Bit O alle anderen Bits für den Benutzer frei verfügbar sind. Eine 2-Byte-Maske, deren einzelne Bits angeben, mit wel- chen GELs dieses GEL eine Kollision erzeugt, falls es sie rammt (siehe auch MeMask-Komponente). Ein Adreßzeiger auf einen Speicherbereich im Chip-RAM, der die eigentlichen Displaydaten des GEL-Images enthält. a) Im Falle eines echten virtuellen Sprites umfaßt dieser Bereich genau 2*Height Datenworte. Der /mage-Daten- bereich eines virtuellen Sprites entspricht im Aufbau den Displaydaten eines Hardwaresprites (siehe Simple- Sprite). Allerdings entfallen hier die beiden einleitenden und abschließenden Kontrollworte. b) Das Image eines Bobs wird im ganz normalen Playfield- Format gespeichert: Der /mage-Datenbereich umfaßt hier genau Height*Width*Depth/16 Datenworte und setzt sich aus Depth aufeinanderfolgenden Bitplanes der Größe Height*Width/16 (in Datenworten!) zusammen. Ein Adreßzeiger auf einen Speicherbereich im Chip-RAM, der für ein echtes virtuelles Sprite nur ein Datenwort, im Fall einer VSprite-Datenstruktur eines Bobs dagegen genau Width Datenworte enthält. Diese Datenworte benutzt das Animationssystem zur schnellen Erkennung von GEL-Kol- lisionen mit der rechten oder linken Randbegrenzung des Clipping-Bereichs. Der Wert der Datenworte ergibt sich aus einer kumulierten logischen ODER-Verknüpfung sämt- licher Zeilen der Kollisionsmaske des GELs. Dadurch wird erreicht, daß in der BorderLine-Maske das der äußersten rechten und der äußersten linken, kollisionssensitiven Stelle des GELs entsprechende Bit gesetzt ist. Ein Adreßzeiger auf einen Speicherbereich im Chip-RAM, der genauso groß wie das ganze Image des virtuellen Sprites bzw. wieeine Bitplane des Bob-Images sein muß (im Fall der VSprite-Datenstruktur eines Bobs). Die gesetzten Bits dieser Kollisionsmaske geben die Pixel bzw. Stellen des GEL s an, I SprColors 0x0030 (48) I VSBob 0x0034 (52) 1 PlanePick 0x0038 (56) 4 PlaneOnOff 0x0039 (57) „1 VUserExt 0x003A (58) die sensitiv für Kollisionen mit anderen GELs oder den Randbegrenzungen des Clipping-Bereichs sind. Ein Adreßzeiger auf einen mindestens 6 Byte großen Spei- cherbereich im Chip-RAM, dessen erste drei Datenworte die Farbtabelle dieses virtuellen Sprites darstellen. Ist der Wert des Zeigers gleich NULL, so werden zur Darstellung des Sprites keine neuen Farben verwendet. Für die VSprite- Datenstruktur eines Bobs ist dieser Zeiger bedeutungslos. Ein Adreßzeiger auf die Bob-Datenstruktur des dieser VSpri- te-Datenstruktur übergeordneten Bobs (falls es sich um ein solches handelt). Handelt es sich dagegen um ein echtes virtuelles Sprite, so ist dieser Zeiger bedeutungslos, weswe- gen man ihn am besten mit dem Wert NULL initialisiert. Eine 1-Byte-Maske, deren einzelne Bits festlegen, in welche Bitplanes des Rastports das Bob-Image des zu dieser VSpri- te-Datenstruktur gehörigen Bobs gezeichnet werden soll. Die Nummern der gesetzten Bits entsprechen dabei den Bitplanes, in die gezeichnet werden soll. Ein PlanePick- Wert von %00011001 = 0x0019 = 25 wählt beispielsweise die Bitplanes 0, 3 und 4 zum Zeichnen aus. Für echte virtuelle Sprites ıst diese Maske ohne Bedeutung. Eine 1-Byte-Maske, deren einzelne Bits festlegen, was in die Bitplanes des Rastports gezeichnet werden soll, die nicht durch die PlanePick-Maske zum Zeichnen des Bob-Images ausgewählt werden. Die Bit-nach-Bitplane Zuordnung ent- spricht bei der PlaneOnOff-Maske derjenigen der Plane- Pick-Maske. Überall dort, wo im /mageshadow (siehe Bob- Datenstruktur) des Bobs ein Bit gesetzt ist, wird in die nicht durch PlanePick ausgewählten Bitplanes der Wert des entsprechenden PlaneOnOff-Bits geschrieben. Wie die Pla- nePick-Maske ist auch diese Maske für echte virtuelle Spri- tes ohne Bedeutung. Eine vom Benutzer völlig frei definierbare Erweiterung der VSprite-Datenstruktur zur Aufnahme weiterer Statusinfor- mationen. Zu diesem Zweck ist der Typ VUsersStuff im Benutzerprogramm entsprechend zu deklarieren. (Wichtig: Diese Erweiterung ist nur unter C, nicht jedoch unter Modu- la-2 verfügbar!) KSSSSEESSS Hd: RD en N N III N ColorMap N Ncoiorrabie orTable S AIIITIIIIIIIN N HT Lt, IK// iA 777 | N N 272 ra EEE NEN N Farbtabelle N NER Register RG B III N N EEE, Ai ZERE | en RGB II N NN NN Na, ın N N RasInfo N ei BitMap Se el Nur bei Dual-Pla DR ION tete, "rl ee Lehe te « . ° tt tet at, . ee s . rl le lee “te. ee er rt, . Abb. 5.1: Der Aufbau eines View L/ CA LASLLLHLLLHLT 7 T EEG 0 ClipRect 9 DE EEREERLLLLT? ‘ ——— m z G G Kai ipRect AZELZEE 1 EN [7 N II NSS NR IS EN N aN IR N RN N 4 f Pi fi % f NN gi N N NS N Sn N N NN NY Q) Sy Sy aNdR NN d} SS INN BER mNiN OH FAHLLLLLLLLLG N N Region L ILLLLLLLLLLL 7, Regionrectangte U | | r I f|DemageList Fi r 7 „7 ARM SEA HU ARMS A REBEL GL VIII _ VregionreetangıS fr OLELLLLLLLLLLLEELLELGTT, gionRectanglef EL | a ÄRegionRectangle VILRRRLELE, zu . Ü SSSS Q, N ANNN! a f} 7 I 4 . S ns U Nir N N N fi Ne Ni Abb. 5.2: Rastport und Layers GelsInfo-Adreßzeiger aus der RastPort-Datenstruktur Dummy am Ende Zu jedem Bob gehört ein Sprite, aber nicht der Liste unbedingt zu jedem Sprite auch ein Bob (onrsinzo)] OK verzise af Wraesiee , pP DL 2 VIIITEIZ, 7 VEZZITEZELL, Aa 02 / AK vsprite Y es Nextvsprite AN p Y) h 1 [1 zz) fr Meet N / ws Van < t ei GIEE Dummy am Anfang der Liste. [} - = Loy EL ZZZZZER et nn nn FL 1 ] Js 7 Bern HB av | FIT Y =. v Przzezech f] BobVSprite r \ SSH L a? „ Ze Y_=, / zz IHnexscom 5 ‚ en un ne ec ee ee [4 Pr Arzevcomp | [| HeadComp [| ey > (ey AV Ä f / HPrevon 1 Ipninorout ind} k Nncnasm VOITEEZEEL: PRZZZZIZL, ] NextComp = r Ss revComp Sn SIFATRISSSSNND N NN rd ® N IN en Abb. 5.3: Das Animations-System DiE DOS-LiBRARY Die DOS-Library ist für die gesamte Ein- und Ausgabe (insbesondere betreffend der Laufwerke) verantwortlich. 6.1 Spezielle Datentypen der DOS-Library BPTR Dies ist eine spezielle Art von Adreßzeigern, die nur von DOS verwendet wird. Ein BPTR, der auf ein Objekt zeigt, hat den Wert Adresse durch 4. Falls also das referenzierte Objekt bei 4000 im Speicher liegt, dann hatein BPTR auf dieses Objekt den Wert 1000. Daraus folgt, daß ein Objekt, auf das ein BPTR zeigt, immer an einer durch 4 teilbaren Adresse liegen muß. Die Adressen fast aller DOS-Datenstrukturen werden als solche BPTR-Adreßzeiger verwaltet. BSTR Diese besondere Art der Speicherung von Zeichenketten wird von Amiga-DOS verwendet. Ein BSTR ist ein BPTR auf einen Speicherbereich, in dem im ersten Byte die Länge der Zeichenkette und nachfolgend die Zeichenkette selbst steht. In Modula-2 ist BSTR als BPOINTER TO ARRAY[0..255] OF CHAR vereinbart. Die Segment-Liste Die im Speicher verstreuten Codestücke eines Programms werden mit Hilfe einer Segment-Liste verknüpft. Die Liste hat die folgende Datenstruktur: LONG SegLength; BPTR NextsSeg; CODE Wie Sie sehen, wird der eigentliche Code von der Längenangabe in SegLength und dem BPTR auf das nächste Segment (oder NULL) in NextSeg eingeleitet. 6.2 Fehlermeldungen der DOS-Library Fehlermeldungen können nach allen Zugriffen auf Dateien oder auf Teile des »Filesystems« mit Hilfe der loErr-Routine geholt werden. Dabei ist zu beachten, daß das Ergebnis eines /oErr-Aufrufes normaler- weise nur dann eine gültige Fehlermeldung ist, wenn tatsächlich ein Fehler aufgetreten ist. Folgende Fehlermeldungen können auftreten (zu den Definitionen in C und Assembler gehört jeweils noch das Präfix ERROR _): C NO_FREE_STORE TASK_TABLE_FULL LINE_TOO_LONG FILE_NOT_OBJECT INVALID_RESIDENT _LIBRARY NO_DEFAULT_DIR OBJECT_IN_USE OBJECT_EXISTS DIR_NOT_FOUND OBJECT_NOT_FOUND BAD_STREAM_NAME OBJECT_TOO_LARGE ACTION_NOT_KNOWN INVALID_COMPONENT NAME INVALID_LOCK OBJECT_WRONG_TYPE DISK_NOT_VALIDATED DISK_WRITE_PROTECTED RENAME_ACROSS_ DEVICES DIRECTORY_NOT_EMPTY TOO_MANY_LEVELS DEVICE_NOT_MOUNTED SEEK_ERROR COMMENT_TOO_BIG Modula-2 noFreeStore taskTableFull lineTooLong fileNotObject invalidResident Library noDefaultDir objectInUse objectExists dirNotFound objectNotFound badStreamName objectTooLarge actionNotKnown invalidComponent Name invalidLock objectWrongType diskNotValidated diskWriteProtected renameÄcross Devices directoryNotEmpty tooManyLevels deviceNotMounted seekError commentToBig Dez 103 105 120 121 122 201 202 203 204 205 206 207 209 210 211 213 214 215 217 218 219 220 Beschreibung Nicht genug Speicherplatz frei. Kein Platz mehr in der Task- Tasktabelle von RootNode. Die Eingabezeile ist zu lang. Das File ist kein Objektmodul. Ungültige Resident- Bibliothek beim Laden. Es ist kein Verzeichnis voreingestellt. Ein anderer Task greift bereits auf den Eintrag zu. Der Eintrag existiert bereits. Verzeichnis nicht gefunden. Eintrag nicht gefunden. Ein/Ausgabestromname ungültig. Der Eintrag ist zu groß. Der Befehl ist ungültig. Im Namen befindet sich ein ungültiges Zeichen. Die Lock-Angabe ist ungültig. Falscher Objekttyp (z.B. Directory statt File). Diskette ist ungültig. Diskette ist schreibgeschützt. Bei RENAME wurde ein falscher Gerätename angegeben. Verzeichnis ist nicht leer. ?7? Gerät ist nicht angemeldet. Fehler beim Suchzugriff auf eine Datei. Der Kommentar ist zu lang. Modula-2 Dez Beschreibung DISK_FULL diskFull Die Diskette ist voll. DELETE_PROTECTED deleteProtected Löschen der Datei verboten. WRITE_PROTECTED writeProtected Datei ist schreibgechützt. READ_PROTECTED readProtected Datei ist lesegeschützt. NOT_A_DOS_DISK notADosDisk Dies ist keine DOS-Diskette. NO_DISK noDisk Es ist keine Diskette eingelegt. NO_MORE ENTRIES noMoreEntries Es sind keine weiteren Einträge vorhanden. 6.3 Die DOS-Packets Der nachfolgenden Auflistung können Sie die Bedeutung einiger dp_Type-Werte der DosPacket- Datenstruktur und der dazugehörigen Argumente für die DOS-Handler entnehmen. Die DOS-Packets werden zusammen mit einer Nachricht (Message-Datenstruktur, siehe »Exec«) an den Port des Handler- prozesses geschickt. Da einige Packets nirgends richtig dokumentiert sind, war bei manchen Parametern auch mit gezielten »Herumhacken« nicht viel herauszufinden... C Modula-2 Dez Beschreibung ACTION_NIL nil 0 Tue gar nichts. ACTION_GET_BLOCK getBlock 2 Einen Block einlesen. ACTION_SET_MAP setMap 4 Setzt eine neue Keymap. ACTION_DIE die 5 Für verzweifelte Benutzer oder um Prozeß zu killen ?'?? ACTION_EVENT event 6 Irgendwas wird wohl passieren ??? ACTION_CURRENT_ currentVolume 1 VOLUME ACTION_LOCATE_OBJEKT locateObject 8 Implementiert die Lock-Funktion dp Argl: Ein BPTR auf die FileLock-Datenstruktur des Verzeichnisses, zu dem der Eintrag gehört. dp Arg2: Ein BSTR auf den Eintragsnamen. dp_Arg3: Der Zugriffmodus (siehe FileLock-Datenstruktur). Modula-2 Dez Beschreibung ACTION_RENAME DISK renameDisk Das aktuelle Volume umbenennen. dp Argl: Ein BSTR-Adreßzeiger auf den neuen Namen. ACTION_FREE_LOCK freeLock Implementiert die Unlock-Funktion. dp Argl: Ein BPTR-Adreßzeiger auf die FileLock-Datenstruktur. ACTION_DELETE_OBJEKT deleteObject 16 _Implementiert die Delete-Funktion. dp_Argl: Ein BPTR-Adreßzeiger auf die FileLock-Datenstruktur des Verzeichnisses, zu dem der Eintrag gehört. dp Arg2: Der Eintragname als BSTR. ACTION_RENAME_OBJEKT renameObject 17 Implementiert die Rename-Funktion. dp_Argl: Ein BPTR-Adreßzeiger auf die FileLock-Datenstruktur des Verzeichnisses, zu dem der Eintrag gehört. dp_Arg2: Der Eintragname als BSTR-Adreßzeiger. dp_Arg3: Ein BPTR auf die FileLock-Datenstruktur des Verzeichnisses, zu dem der umbenannte Eintrag gehören soll. dp_Arg4: Der neue Eintragname als BSTR. ACTION_COPY_DIR copyDir 19 Implementiert die DupLock-Funktion. dp Argl: Ein BPTR-Adreßzeiger auf die zu duplizierende FileLock-Datenstruktur. dp _Resl: Hier steht hinterher ein BPTR-Adreßzeiger auf die neuen FileLock-Datenstruktur. ACTION_WAIT_CHAR waitChar 20 Implementiert die WaitForChar-Funktion dp _Argl: Die Zeitspanne, die abgewartet werden soll. Modula-2 Beschreibung ACTION_SET_PROTECT setProtect Implementiert die SetProtection-Funktion. dp Argl: Nicht benutzt. dp Arg2: Ein BPTR-Adreßzeiger auf die FileLock-Datenstruktur des Verzeichnisses, zu dem der Eintrag gehört. dp _Arg3: Name des Eintrags als BSTR. dp_Arg3: Die »Protectionbits«. ACTION_CREATE createDir 22 Implementiert die CreateDir-Funktion. dp Argl: Ein BPTR-Adreßzeiger auf die FileLock-Datenstruktur des Verzeichnisses, zu dem der Eintrag gehört. dp _Arg2: Der Eintragname als BSTR. dp Resl: Ein BPTR auf die FileLock-Datenstruktur des neuen Verzeichnisses. ACTION_EXAMINE_OBJEKT examineOÖbject 23 _ Implementiert die Examine-Funktion. dp Argl: Ein BPTR-Adreßzeiger auf die FileLock-Datenstruktur des Eintrags. dp_Arg2: Ein BPTR-Adreßzeiger auf eine allokierte File/nfoBlock-Datenstruktur. ACTION_EXAMINE_NEXT examineNext 24 Implementiert die ExamineNext-Funktion dp Argl: Ein BPTR-Adreßzeiger auf die FileLock-Datenstruktur des Eintrags. dp _Arg2: Ein BPTR-Adreßzeiger auf eine File/nfoBlock-Datenstruktur. ACTION_DISK_INFO diskInfo 25 _ Implementiert die DOS-Info-Funktion. dp _Argl: Ein BPTR auf eine allokierte /nfoData-Datenstruktur. C ACTION_INFO ACTION_FLUSH ACTION_SET_COMMENT dp Argl: Nicht benutzt. dp_Arg2: dp_Arg3: dp_Arg3: ACTION_PARENT Modula-2 info flush setComment parent Dez 26 21 28 29 Beschreibung Implementiert den CLI-Befehl INFO. Flush-Befehl der Device ausführen. Implementiert die SetComment-Funktion. Ein BPTR auf die FileLock-Datenstruktur des Verzeichnisses, zu dem der Eintrag gehört. Der Name des Eintrags als BSTR. Zu setzender Kommentar als BSTR. Implementiert die ParentDir-Funktion. dp Argl: Ein BPTR-Adreßzeiger auf die FileLock-Datenstruktur des Eintrages. dp _Res]: Hinterher ein BPTR auf die FileLock-Datenstruktur des »Parent-Directory«. ACTION_TIMER ACTION_INHIBIT timer inhibit 2 Die in das Laufwerk des Handlers eingelegte Diskette wird (nicht) geprüft. dp Argl: 1 = Diskette wieder prüfen; 0 = Diskette nicht prüfen. ACTION_DISK_TYPE ACTION_DISK_CHANGE ACTION_SET_DATE dp_Argl: dp_Arg2: dp_Arg3: dp_Arg3: Nicht benutzt. disk Type diskChange setDate 32 33 34 Trackdisk-Device- Befehl DISKTYPE ??? CLI-Befehl DISKCHANGE ??? Das Datum eines Eintrags setzen. Ein BPTR auf die FileLock-Datenstruktur des Verzeichnisses, zu dem der Eintrag gehört. Der Name des Eintrags als BSTR-Adreßzeiger. Ein BPTR auf eine DateStamp-Datenstruktur, die das neue Datum enthält. C Modula-2 Dez Beschreibung ACTION_WRITE write 52 _ Implementiert die Write-Funktion. dp_Argl: Argl-Feld der zugehörigen FileHandle-Datenstruktur. dp_Arg2: Ein Adreßzeiger auf den Schreibpuffer. dp_Arg3: Die Anzahl der zu schreibenden Zeichen. dp Resl: Enthält hinterher die Anzahl der geschriebenen Zeichen oder bei einem Fehler -1. ACTION_READ read 57 Implementiert die Read-Funktion. dp Argl: Argl-Feld der zugehörigen FileHandle-Datenstruktur. dp_Arg2: Ein Adreßzeiger auf den Lesepuffer. dp _Arg3: Die Länge des Lesepuffers. dp Resl: Enthält hinterher die Anzahl der gelesenen Zeichen oder -1 für einen aufgetretenen Lesefehler. 6.4 Die Datenstrukturen der DOS-Library Commandlinelnterface C (libraries/dosextens.h) Modula-2 (Dos) Hex Dez struct CommandLinelnterface CommandlLinelnterface { RECORD 0000 0 LONG cli_Result2; result2:LONGINT, 0004 4 BSTR cli_SetName; setName:BSTR; 0008 8 BPTR cli_CommandDir; commandDir:PathInfoPtr; O00C 12 LONG cli_ReturnCode; returnCode:LONGINT; 0010 16 BSTR cli_CommandName; commandName:BSTR; 0014 20 LONG cli_FailLevel; failLevel:LONGINT,; 0018 24 BSTR cli_Prompt; prompt:BSTR; 001B 28 BPTR cli_StandardInput; standardInput:FileHandlePtr; 0020 32 BPTR cli_CurrentInput; currentInput:FileHandlePtr; 0024 36 BSTR cli_CommandRile; commandFile:BSTR; 0028 40 LONG cli_Interactive; interactive: LONGINT; 002B 44 LONG clı_Background; background: LONGINT; 0030 48 BPTR cli_CurrentOutput; currentOutput:FileHandlePtr; 0034 32 LONG cli_DefaultStack; defaultStack:LONGINT,; 0038 56 BPTR cli_StandardOutput; standardOutput:FileHandlePir; 002B 60 BPTR clı_Module; module:BPTR; 0030 64 }; END; Datenstrukturenreferenz Routinenreferenz Beschreibung »Dos«: Process. Keine. Wenn ein Prozeß ein CLI-Prozeß ist, dann steht die Adresse dieser Datenstruktur in dem CLIStruct-Feld der Process-Datenstruktur. Sie enhält einige für das CLI wichtige Informationen wie beispielsweise das aktuelle Verzeichnis oder den letzte Fehlercode. „I cli_Result2 0x0000 (0) I cli SetName 0x0004 (4) 4 cli CommandDir 0x0008 (8) I cli_ReturnCode 0x000C (12) Hier steht die DOS-Fehlernummer des letzten Befehls. Sie wird von der /oErr-Routine geliefert. Ein BSTR auf den Namen der aktuellen Directories. Ein BPTR auf eine Liste der FileLock-Datenstrukturen,aus denen die CLI-Befehle gelesen werden. Jedes Element der Liste besteht aus einem BPTR auf das nächste Element und einem BPTR auf die FileLock-Datenstruktur eines Direc- torys (die mit dem CLI-Befehl PATH angegeben wurde). Das vom letzten Befehl zurückgegebene Ergebnis. Je nach Schwere des Fehlers kann hier einer der folgenden Werte stehen. C Modula-2 Hex Beschreibung RETURN_OK ok 00 Es ist kein Fehler aufgetreten. RETURN_WARN warn 05 Der augenblickliche Status ist unsicher. RETURN_ERROR error 0A Ein »normaler« Fehler ist aufgetreten. RETURN_FAIL fail 14 Ein schwerwiegender Fehler ist aufgetreten. 4 cli_ CommandName 0x0010 (16) UI cli_FailLevel 0x0014 (20) 4 cli Prompt 0x0018 (24) U cli_ StandardInput 0x001B (28) I cli_CurrentInput 0x0020 (32) Ein BSTR auf den Namen des aktuellen Befehls. Hier steht der mit dem CLI-Befehl FA/LAT gesetzte Fehler- level. Er bestimmt, ab welchen cli_ReturnCode die Kom- mandofolge unterbrochen wird. Ein BSTR auf die Zeichenkette, mit der sich das CLI zur Befehlseingabe meldet (der »Prompt«). Er wird mit dem CLI-Befehl PROMPT gesetzt. Ein BPTR-Adreßzeiger auf die FileHandle-Datenstruktur des voreingestellten Eingabegeräts (In Modula-2 ein File- HandlePtr). Ein BPTR auf die Adresse der FileHandle-Datenstruktur des aktuellen Eingabegeräts. I cli CommandFile 0x0024 (36) I cli Interactive 0x0028 (40) I cli_Background 0x002B (44) I cli_CurrentOutput 0x0030 (48) 1 cli_DefaultStack 0x0034 (52) I cli_StandardOutput 0x0038 (56) 1 cli_ Module 0x002B (60) DateStamp Offset C (libraries/dos.h) struct DateStamp | LONG ds_Days; Ein BSTR auf den Namen der aktuellen EXECUTE-Datei. Ein Boolescher Ausdruck, der wahr ist, wenn das CLI inter- aktiv ist (Eingaben über das CLI-Fenster möglich sind). Ein Boolescher Ausdruck, der wahr ist, wenn das CLI mit dem Amiga-DOS-Befehl RUN gestartet wurde. Ein BPTR auf die FileHandle-Datenstruktur des vorein- gestellten Eingabegeräts (In Modula-2 ein FileHandlePtr). Die Größe des beim Starten des CLI-Prozesses vorein- gestellten Stacks in Worten. Ein BPTR auf die FileHandle-Datenstruktur des vorein- gestellten Ausgabegeräts (In Modula-2 ein FileHandlePtr). Ein BPTR auf die Segmentliste des aktuellen CLI-Befehls. Dort befindet sich im Speicher der ausführbare Code des Befehls. Modula-2 (Dos) Date RECORD days:LONGINT,; LONG ds_Minute; minute:LONGINT; LONG ds_Tick; F Datenstrukturenreferenz Routinenreferenz U... Beschreibung tick:LONGINT; END; »DOS«: DeviceList, FilelnfoBlock, RootNode. »DOS«: DateStamp. In dieser Datenstruktur wird ein Datum gespeichert. Es liegt vor als die Anzahl von Tagen, Minuten und 1/50 Sekunden, die seit dem 01.01.1978 um 00:00:00 (Uhr) vergangen sind. DateStamp ist in der FilelnfoBlock-Datenstruktur enthalten und einer Datei. 1 ds _Days0x0000 (0) 1 ds Minute 0x0004 (4) „1 ds Tick 0x0008 (8) beinhaltet das Erstellungsdatum und die Erstellungsuhrzeit Die Anzahl der Tage seit dem 1. Januar 1978. Die Tagesuhrzeit in Minuten. Die 50stel Sekunden. DeviceList Offset C (libraries/dos.h) Modula-2 (Dos) Hex Dez struct DeviceList DeviceList = { RECORD 0000 0 BPTR dlI_Next; next:DeviceListPtr; padl,pad2,pad3:BYTE; 0004 4 LONG di_Type; type:DeviceListType; 0008 8 struct MsgPort * dl_Task; task:Processld; 000C 12 BPTR dl_Lock; lock:FileLockPtr; CASE :DeviceListType OF | device,directory: handler:BSTR; stackSize:LONGINT; priority:LONGINT,; startup: LONGINT, segList:BPTR; globVec:BPTR; | volume: 0010 16 struct DateStamp dl_VolumeDate; volumeDate:Date; VO1C 28 BPTR dl_LockList; lockList:FileLockPitr; 0020 32 LONG dlI_DiskType; diskType:LONGINT, 0024 36 LONG dl_unused; unused:LONGINT END; 0028 40 BSTR * dl_Name; name:BSTR; 002C 44 B END; Assembler Syntax: Strukturname = DevList Datenstrukturenreferenz »DOS«: DeviceList, DosInfo, InfoData. Routinenreferenz Keine. > Beschreibung Diese Datenstruktur beschreibt ein Volume (z.B. Diskette oder Festplatte). Je nach Wert von dl_Type werden die Felder dl _VolumeDate bis dl_unsused verschieden interpretiert. In »C« wird dann, wenn dl Type den Wert DLT DEVICE bzw. DLT DIRECTORY hat, die Datenstruktur zu der unten beschriebenen DeviceNode-Datenstruktur. Sie beschreibt dann ein Device bzw. ein Directory. Da beide Datenstrukturen baugleich sind, ist die Modula-2-Version als varianter RECORD definiert. Alle Devices, Verzeichnisse und Volumes werden in einer über d/I_Next-verketteten Liste gespeichert. „1 di_Next 0x0000 (0) Ein BPTR auf die nächste DeviceList-Datenstruktur (bzw. DeviceNode-Datenstruktur) in der Liste. A di_Type 0x0004 (4) C DLT_DEVICE DLT_DIRECTORY DLT_VOLUME „1 di_Task 0x0008 (8) 41 di Lock 0x000C (12) „1 di_VolumeDate 0x0010 (16) „J di_LockList 0x001C (28) 4 di_DiskType 0x0020 (32) 1 di_unsused 0x0024 (36) „1 di_Name 0x0028 (40) Gibt an, ob die Datenstruktur ein Device oder ein Directory beschreibt. Mögliche Werte sind (in Modula-2 sind diese Werte als Aufzählungstyp DeviceListType definiert): Modula-2 Beschreibung device Die Datenstruktur beschreibt ein Device. In C und Assembler ist es also eine DeviceNode-Datenstruktur. directory Die Datenstruktur bechreibt ein Directory. In C und Assembler ist es also eine DeviceNode-Datenstruktur. volume Die Datenstruktur beschreibt ein Volume. Falls das Volume im Laufwerk ist, steht hier die Prozeßken- nung des Handlerprozesses (ein BPTR auf das MsgPort-Feld der Process-Datenstruktur), sonst NULL. Bei residenten Devices steht hier NULL, sonst ein BPTR- Adreßzeiger auf die FileLock-Datenstruktur des Root-Ver- zeichnisses des Filesystems. Eine eingebundene DateStamp-Datenstruktur, die das Er- stellungsdatum des Volumes beinhaltet und zur Unterschei- dung von Volumes mit gleichen Namen dient. Hier wird die Liste der aktiven »FileLocks« des Volumes gespeichert, falls das Volume entfernt wird (Diskette aus dem Laufwerk genommen wird). Dieser Parameter gibt an, um welchen Diskettentyp es sich handelt. Da es sich immer um eine Amiga-DOS-Diskette handeln muß, steht hier auch immer »DOS\n«. Ein nur quasi unbenutzter Parameter, denn dieses Feld wird benötigt, wenn dies eine DeviceNode-Datenstruktur ist. Ein BSTR auf den Namen des Volumes. DeviceNode oe C (libraries/dos.h) Modula-2 (Dos) Hex Dez struct DeviceNode DeviceList { RECORD 0000 0 BPTR dn_Next; next:DeviceL6istPtr; padl,pad2,pad3:BYTE,; 0004 4 LONG dn_Type; type:DeviceListType; 0008 8 struct MsgPort * dl_Task; task:Processld; 000C 12 BPTR dn_Lock; lock:FileLockPtr; CASE :DeviceListType OF | device,directory: 0010 16 BSTR *dn_Handler; handler:BSTR; 0014 20 LONG dn_StackSize; stackSize: LONGINT, 0018 24 LONG dn_Priority; priority:LONGINT,; 001C 28 BPTR dn_Startup; startup:FileSysStartupMsgPrir; 0020 32 BPTR dn_SegList ; segList:BPTR; 0024 36 BPTR dn_ GlobVec globVec:BPTR; | volume: volumeDate:Date; lockList:FileLockPtr; disk Type:LONGINT,; unused:LONGINT END; 0028 40 BSTR * dn_Name name:BSTR; 002C 44 }; END; Datenstrukturenreferenz »Dos«: DeviceList, DosInfo, InfoData. Routinenreferenz Keine. ___> Beschreibung Diese Datenstruktur beschreibt ein Device, ein Volume oder ein Directory. Je nach Wert von dl_Type werden die Felder dl_ VolumeDate bis dl_unsused verschieden interpretiert. In C und Assembler wird dann, wenn dl Type den Wert DLT_ VOLUME hat, die Datenstruktur zu der oben beschriebenen DeviceNode-Datenstruktur. Da beide Datenstrukturen baugleich sind, ist die Modula-2-Version als varianter RECORD definiert. Alle Devices, Verzeichnisse und Volumes werden in einer über dl_Next- verketteten Liste gespeichert. „1 dn_Next 0x0000 (0) Ein BPTR auf die nächste DeviceNode-Datenstruktur (bzw. DeviceList) in der Liste. DLT_DEVICE DLT_DIRECTORY DLT_VOLUME dn_Type 0x0004 (4) dn_Task 0x0008 (8) dn Lock 0x000C (12) dn_Handler 0x0010 (16) dn_StackSize 0x0014 (20) dn_Priority 0x0018 (24) dn_ Startup 0x001C (28) dn_SegList 0x0020 (32) dn_GlobVec 0x0024 (36) dn_Name 0x0028 (40) Modula-2 Dez Beschreibung device 0 Die Datenstruktur beschreibt ein Device. directory 1 Die Datenstruktur beschreibt ein Directory. volume 2 Die Datenstruktur beschreibt ein Volume. In C und Assembler ist es also eine DeviceNode-Datenstruktur. Die Bits dieser 2-Byte-Marke geben an, ob die Datenstruktur ein Device oder ein Directory beschreibt (in Modula-2 sind diese Werte als Aufzählungstyp DeviceListType definiert): Bei einem residenten Device steht hier die Prozeßkennung des Handlerprozesses (BPTR auf das MsgPort-Feld der Process-Datenstruktur), ansonsten NULL. Bei residenten Devices steht hier NULL, sonst ein BPTR auf die FileLock-Datenstruktur des Root-Verzeichnisses des Filesystems. Falls der »Handler« nicht im Speicher ist, muß in diesem Feld ein BSTR-Adreßzeiger stehen. Dieser zeigt auf den Namen (incl. Pfadangabe) des »Handlers« auf der Diskette. Dieser kann dann mittels der LoadSeg-Routine geladen werden. Ist der »Handler« geladen, so steht hier die Größe des zugehörigen Stacks. Die Priorität des »Handlers«. Ein Adreßzeiger auf eine »FileSystemStartupMessage«, die dem Handlerprozeß beim Start übergeben wird. Ein BPTR-Adreßzeiger auf die Segmentliste des »Hand- lers«. Er ist NULL, falls der »Handler« nicht im Speicher ist. Ein BPTR auf eine private Sprungtabelle des Handlerpro- zesses. Ein BSTR auf den Namen des Device bzw. des Verzeichnis- ses. 6 DosEnvec KT C (libraries/filehandler.h) Modula-2 (Dos) Hex Dez struct InfoData DosEnvec = { RECORD 0000 0 ULONG de_TableSize; tableSize:LONGCARD; 0004 4 ULONG de_SizeBlock; sizeBlock:LONGCARD; 0008 8 ULONG de_SecOrg; secOrg:LONGCARD; 000C 12 ULONG de_Surfaces; surfaces: LONGCARD; 0010 16 ULONG de_SectorPerBlock; sectorPerBlock:LONGCARD; 0014 20 ULONG de_BlocksPerTrack; blocksPerTrack:LONGCARD; 0018 24 ULONG de_Reserved; reserved:LONGCARD; 001C 28 ULONG de_PreAlloc; preAlloc:LONGCARD; 0020 32 ULONG de_Interleave; interleave: LONGCARD; 0024 36 ULONG de_LowCyl; lowCyl:LONGCARD; 0028 40 ULONG de_HighCyl; higshCyl:LONGCARD; 002C 44 ULONG de_NumBuffers; numBuffers: LONGCARD:; 0030 48 ULONG de_BuffMemType: buffMemType:LONGCARD; 0034 52 ULONG de_MaxTransfer; maxTransfers: LONGCARD; 0038 56 ULONG de_Mask; mask:LONGSET; LONGCARD; 003C 60 LONG de_BootPri; bootPri:LONGINT; LONGCARD; 0040 64 ULONG de_DosType; dosType: ARRAY [0..3] OF CHAR; 0044 68 } END; Datenstrukturenreferenz »Dos«: FileSystemStartupMsg. Routinenreferenz Keine. > Beschreibung Diese Datenstruktur gibt dem Devicehandler Auskunft über ein beliebiges Device. Ihre Adresse muß in dem fssm_Environ-Feld der FileSystemStartupMsg-Datenstruktur eingetragen werden. Wie Sie sehen, entsprechen die Felder dieser Datenstruktur den Einträgen der Mountlist. Der CLI-Befehl MOUNT erzeugt auch aus dem Mountlisteintrag eine solche Datenstruktur. Da die Mountlist je nach Device verschiedene Formen annehmen kann, ist die DosEnvec-Datenstruktur eigentlich ein Array von ULONG- Werten, die erst vom Handler ausgewertet werden. Die hier abgedruckte Version wird für alle Devices benötigt, die das Trackdisk-Device emulieren und als Handler das Filesystem (bzw. FastFileSystem) benutzen (wie beispielsweise ein Harddisktreiber). I de _TableSize 0x0000 (0) 1 de_SizeBlock 0x0004 (4) Hier steht die Größe der gesamten Datenstruktur. Dieses Feld ist immer dann wichtig, wenn diese Datenstruktur als Array behandelt wird, weil sie dann von der hier beschriebe- nen Form abweicht. Die Größe eines Datenblocks in Langwörtern (normaler- weise 128). de_SecOrg 0x0008 (8) de. Surfaces 0x000C (12) de_SectorPerBlock 0x0010 (16) de_BlocksPerTrack 0x0014 (20) de Reserved 0x0018 (24) de _PreAlloc 0x001C (28) desikiäsiese 0x0020 (32) de_LowCyl 0x0024 (36) de _HighCyl 0x0028 (40) de_NumBuffers 0x002C (44) de_BuffMemType 0x0030 (48) de_MaxTransfer 0x0034 (52) de_Mask 0x0038 (56) de _BootPri 0x003C (60) de_DosType 0x0040 (64) In der aktuellen Version unbenutzt. Sollte trotzdem immer auf O gesetzt werden. Die Anzahl der Schreib-Lese-Köpfe des Gerätes (beim Dis- kettenlaufwerk 2). In der aktuellen Version unbenutzt. Sollte immer auf 0 gesetzt werden. Die Anzahl der Blöcke pro Track. Beim normalen Disketten- laufwerk sind es 11, bei Festplatten 17 (MFM) oder 26 (RLL). Die Anzahl der für DOS reservierten Blöcke am Anfang der Partition (normalerweise 2). Die Anzahl der für DOS reservierten Blöcke am Ende der Partition. Der Sektorversatz (Interleave). Für Diskettenlaufwerke 0, für Festplatten zwischen O und 26. Die Nummer des ersten Tracks der Partition (bei Disketten- laufwerken, immer 0). Die Nummer des letzten Tracks der Partition (bei Disketten- laufwerken 39 oder 79). Die Anzahl von 512-Byte langen Puffern, die für das Device angelegt werden sollen. Mehr Puffer bedeuten normalerwei- se einen schnelleren Zugriff. Spezielle Anforderungen an den Pufferspeicher. Wie in der Mountlist gilt hier 3 = Chip-RAM, 1 = Fast-RAM Die maximale Anzahl der Bytes, die auf einmal übergeben werden können (normalerweise 13). Laut [KRA] eine Maske, um bestimmte Speicherbereiche auszublenden (Klingt gut, oder?). Die Priorität für »bootende« Devices (15 für Autoboot). Eine Zeichenkette, die die Version des Filesystems angibt. Dabei bedeuten als Langwort codiert 0x444F5300 das alte Filesystem, 0x444f5301 das neue Fast-Filesystem. DosiInfo Offset C (libraries/dosextens.h) Modula-2 (Dos) Hex Dez struct DosInfo DosInfo = { RECORD 0000 0 BPTR di_McName; mcName:BSTR; 0004 4 BPTR di_DevInfo; devInfo:DeviceListPtr; 0008 8 BPTR di_Devices; devices:BPTR; 000C 12 BPTR di_Handlers; handlers:BPTR; 0010 16 APTR di_NetHand; netHand:ResidentSegmentPtr; 0014 20 }; END; Datenstrukturenreferenz »Dos«: RootNode. Routinenreferenz Keine. L____> Beschreibung Diese Datenstruktur ist für Erweiterungen vorgesehen, die den Amiga netzwerkfähig machen. „1 di_McName 0x0000 (0) Ein BPTR-Adreßzeiger aufden Namen dieses Computers im Netzwerk. 1 di_DevInfo 0x0004 (4) Ein BPTR-Adreßzeiger auf die Liste der Devices. I di_Devices 0x0008 (8) Dieser BPTR-Adreßzeiger ist immer NULL. 4 di _Handlers 0x000C (12) Dieser BPTR-Adreßzeiger ist immer NULL. „1 di _NetHand 0x0010 (16) Dieser Adreßzeiger ist vorgesehen für die Prozeßkennung des Netzwerkhandlers. DosLibrary C (libraries/dosextens.h) Modula-2 (Dos) Hex Dez . struct DosLibrary DosLibrary = { RECORD 0000 0 struct Library di_lib; lib:Library; 0022 34 APTR dlI_Root; root:RootNodePtr; 0026 38 APTR dI_GV; gv:ADDRESS; 002A 42 LONG di_A2; a2:LONGINT, 002E 46 LONG dI_AS; a5:LONGINT; 0032 50 LONG dl_A6; a6:LONGINT,; 0036 54 F; END; Datenstrukturenreferenz Routinenreferenz > Beschreibung Keine. Keine. Dies ist eine globale Datenstruktur, deren Adresse von der Routine OpenLibrary zurückgegeben wird, wenn Sie die Dos-Library öffnen. J di_Library 0x0000 (0) I di_Root 0x0022 (34) I di_GV 0x0026 (38) 4 di_A2 0x002A (42) I di_A5 0x002E (46) 4 di_A6 0x0032 (50) DosPacket om C (libraries/dosextens.h) Modula-2 (Dos) 0000 0004 0008 D0O0OC 0010 0014 0018 0OIC 0020 0024 0028 002C 0030 LONG dp_Type; LONG dp_Resl; LONG dp_Res2; LONG dp_Argl; LONG dp_Arg2; LONG dp_Arg3; LONG dp_Arg4; LONG dp_Arg5; LONG dp_Ars6; LONG dp_Arg7; F Eine eingebundene Library-Datenstruktur wie im Kapitel über »Exec« behandelt. Sie beschreibt die Dos-Library und bindet sie in das System ein. Ein Adreßzeiger auf die RootNode-Datenstruktur, die wei- tere wichtige globale Informationen enthält. Ein Adreßzeiger auf eine globale Sprungtabelle von Amiga- DOS. Ein systeminternes Register zur Zwischenspeicherung des gleichnamigen Prozessorregisters. Ein systeminternes Register zur Zwischenspeicherung des gleichnamigen Prozessorregisters. Ein systeminternes Register zur Zwischenspeicherung des gleichnamigen Prozessorregisters. struct DosPacket DosPacket = { RECORD struct Message *dp_Link; link:MessagePtr; struct MsgPort *dp_Port; port:MsgPortPtr; type: LONGINT,; res1:LONGINT; res2:LONGINT,; argl:LONGINT,; arg2:LONGINT,; arg3:LONGINT; arg4:LONGINT, argS:LONGINT,; arg6:LONGINT,; arg7:LONGINT,; END; Datenstrukturenreferenz Routinenreferenz N Beschreibung »Dos«: StandardPacket. Keine. Diese Datenstruktur dient zur Kommunikation zwischen verschiedenen Prozessen. Die Adresse einer solchen Datenstruktur wird im Name-Feld einer Message-Datenstruktur gespeichert. Solche »Packets« werden von DOS zur Übermittlung von Befehlen an Device-Handler (z.B. Laufwerkshandler) verwen- det. Die Datenstruktur muß an einer durch 4 teilbaren Adresse liegen. 4 u dp Link 0x0000 (0) dp_Port 0x0004 (4) dp_Type 0x0008 (8) dp_Resl 0x000C (12) dp_Res2 0x0010 (16) dp_Argl 0x0014 (20) dp_Arg2 0x0018 (24) dp_Arg3 0x001C (28) dp_Arg4 0x0020 (32) dp_Arg5 0x0024 (36) Ein Adreßzeiger zurück auf die Message-Datenstruktur, die benutzt wird, um dieses »Packet« zu senden. Ein Adreßzeiger auf eine MsgPort-Datenstruktur, zu der die Antwort von dem Empfänger geschickt werden soll. Dies soll normalerweise nicht die MsgPort-Datenstruktur sein, die als ID des Prozesses dient (also in der Process-Daten- struktur enthalten ist). In diesem Feld steht der Typ dieses »Packets«. Bei Nachrich- ten, die an den DOS-Handler geschickt werden, also der Befehl, der ausgeführt werden soll. Der Inhalt dieses Feldes bestimmt die Bedeutung der nachfolgenden. Die verfügba- ren Befehle und die zugehörige Bedeutung der restlichen Felder können Sie der Auflistung im Abschnitt (»Die DOS- Packets«) entnehmen. In diesem Feld gibt der Empfänger der Nachricht bei der Antwort Daten zurück. Bei dem »File-System« Aufruf Write wird beispielsweise die Länge der geschriebenen Daten zurückgegeben. In diesem Feld gibt der Empfänger der Nachricht bei der Antwort Daten zurück. Bei »File-System« Aufrufen bei- spielsweise die Antwort der /oErr-Routine. Das erste Argument, das dem Empfänger als Information übergeben wird (werden kann). Das zweite Argument, das dem Empfänger als Information übergeben wird (werden kann). Das dritte Argument, das dem Empfänger als Information übergeben wird (werden kann). Das vierte Argument, das dem Empfänger als Information übergeben wird (werden kann). Das fünfte Argument, das dem Empfänger als Information übergeben wird (werden kann). I dp_Arg6 0x0028 (40) Das sechste Argument, das dem Empfänger als Information übergeben wird (werden kann). 1 dp_Arg7 0x002C (44) Das siebte Argument, das dem Empfänger als Information übergeben wird (werden kann). FileHandle Her Der struct FileHandle FileHandle = RECORD struct Message *fh_Link; link:MessagePtr; struct MsgPort *fh_Port; port:MsgPortPtr; struct MsgPort *fh_Type; type:Processld; LONG fh_Buf; buf:LONGINT,; LONG fh_Pos; pos:LONGINT,; LONG fh_End; end:LONGINT,; LONG fh_Funcs; func1:LONGINT,; LONG fh_Func?; func2:LONGINT,; LONG fh_Func3; func3:LONGINT,; LONG fh_Arss; argl:LONGINT, LONG fh_Arg?; arg2:LONGINT, h END; Datenstrukturenreferenz »Dos«: CommandlLinelnterface, Process. Routinenreferenz »Dos«: Close, Execute, Input, IsInteractive, Open, Output, Read, Seek, WaitForChar, Write. ___> Beschreibung Die Datenstruktur identifiziert eine Datei. Wenn Sie eine Datei mit Hilfe der Open-Routine öffnen, bekommen Sie einen Adreßzeiger auf die zugehörige FileHandle-Datenstruktur zurück. Sie brauchen diesen, um diese Datei bearbeiten zu können. 4 fh_Link 0x0000 (0) Nicht benutzt. „1 fh_Port 0x0004 (4) Dieser Wert ist null, falls die Datei interaktiv ist. „1 fh_Type 0x0008 (8) Prozeßkennung des Handlerprozesses (ein Adreßzeiger auf das MsgPort-Feld der entsprechenden Process-Datenstruk- tur). Dort werden die DOS-Packets abgeschickt. 4 fh_Buf 0x000C (12) Ein Adreßzeiger auf einen internen Puffer, der bei der Arbeit mit der Datei verwendet wird. „1 fh_Pos 0x0010 (16) Die aktuelle Zeichenposition innerhalb des Puffers. I fh_End 0x0014 (20) Die Endposition innerhalb des Puffers. „1 fh_Funcs 0x0018 (24) Die Adresse der Funktion, die zum Auslesen des Puffers benutzt wird. 4 fh_Func2 0x001c (28) Die Adresse der Funktion, die zum Beschreiben des Puffers verwendet wird. „1 fh_Func3 0x0020 (32) Die Adresse der Funktion, die zum Schließen der Datei verwendet wird. „1 fh_Args 0x0024 (36) Ein Argument zur internen Verwendung. Seine genaue Funktion hängt von der Art des »FileHandlers« ab. „1 fh_Arg2 0x0028 (40) Ein Argument zur internen Verwendung. Seine genaue Funktion hängt von der Art des »FileHandlers« ab. FilelnfoBlock Offset C (libraries/dos.h) Modula-2 (Dos) er Dez struct FileInfoBlock FileInfoBlock = { RECORD 0000 0 LONG fib_DiskKey; diskKey:LONGINT,; 0004 4 LONG fib_DirEntryType; dirEntryType:LONGINT; 0008 8 char fib_FileName[ 108]; fileName:ARRAY[0..107] OF CHAR; 0074 116 LONG fib_Protection; protection:ProtectionFlagSet; 0078 120 LONG fib_EntryType; entryType:LONGINT,; 007C 124 LONG fib_Size; size: LONGINT,; 0080 128 LONG fib_NumBlocks; numBlocks:LONGINT; 0084 132 struct DateStamp fib_Date; date:Date; 0090 144 char fib_Comment[80]; comment:ARRAY [0..79] OF CHAR; O0OEO 224 char fib_Reserved[36]; reserved: ARRAY [0..35] OF CHAR; 0104 260 }; END; Datenstrukturenreferenz Keine. Routinenreferenz »DOS«: Examine, ExNext, Info. ——? Beschreibung In dieser Datenstruktur speichert »Dos« die wichtigsten Informationen über eine Datei. Falls Sie eine Datei untersuchen wollen, können Sie sich die zugehörige FilelnfoBlock-Datenstruktur mit Hilfe des Examine- bzw. ExNext-Befehls besorgen. Dieser Datensatz enthält im wesentlichen die gleichen Daten wie der FileHeader-Block eines Files auf Diskette. Wird eine FilelnfoBlock-Datenstruktur an DOS- Routinen übergeben, dann muß diese an einer durch 4 teilbaren Adresse liegen. Dazu allokieren Sie sie am besten mit der AllocMem-Routine aus »Exec«. I fib_DiskKey 0x0000 (0) Die Nummer des ersten Blocks des Eintrags auf Diskette. I fib_DirEntryType 0x0004 (4) Ist dieses Feld größer als null, dann handelt es sich bei dem Eintrag um ein Verzeichnis, sonst um eine Datei. „4 fib_FileName 0x0008 (8) Eine eingebundene Zeichenkette, die den Namen des Ein- trags beinhaltet. I fib_Protection 0x0074 (116) Die »Protection-Bits« des Eintrags. J fib_EntryType 0x0078 (120) Eine Systeminterne Kennung. „I fib_Size 0x007C (124) Die Länge des Eintrags in Bytes. I fib_NumBlocks 0x0080 (128) Die Anzahl der Blocks, die der Eintrag belegt. „1 fib_Date 0x0084 (132) Eine DateStamp-Datenstruktur, die das Erstellungsdatum des Eintrags beinhaltet. I fib_Comment 0x0090 (144) Der zu dem Eintrag gehörende Kommentar als Zeichenkette. „4 fib_Padding 0x00E0 (224) Ein Zwischenspeicher für diverse Systemzwecke. FileLock Offset C (libraries/dosextens.h) Modula-2 (Dos) struct FileLock FileLock = [ RECORD BPTR fl_Link; link:FileLockPtr; LONG fl_Key; key:LONGINT; LONG fl_Access; access: LONGINT,; struct MsgPort * fl_Task; task:Processld; BPTR fl_Volume; volume:DeviceListPtr; h END; Datenstrukturenreferenz »DOS«: DeviceList. Routinenreferenz »DOS«: CreateDir, CurrentDir, DupLock, Examine, ExNext, Info, Lock, ParentDir, Unlock. > Beschreibung Diese Datenstruktur dient zur Identifizierung eines Eintrags innerhalb des »Filesystems«. Sie wird benötigt, um die Zugriffe auf ein File zu koordinieren. Anders als die FileHandle-Datenstruktur dient diese Datenstruktur zur Koordination der Zugriffe verschiedener Tasks auf eine Datei und nicht deren Verwaltung. Daher kann eine FileLock-Datenstruktur auch für ein Verzeichnis geholt werden. Ein Adreßzeiger auf eine FileLock-Datenstruktur muß an fast alle DOS-Routinen übergeben werden, die auf Einträge im »Filesystem« zugreifen. Es können gleichzeitig mehrere »Locks« auf die gleiche Datei von verschiedenen Prozessen angefordert werden. Dabei muß es sich allerdings um »FileLocks« des Typs SHARED LOCK (ACCESS _READ) handeln. „1 fl_Link 0x0000 (0) Mit Hilfe dieses Feldes verkettet Amiga-DOS die »Locks«. „1 fl_Key 0x0004 (4) Hier steht die Nummer des ersten Blocks (FileHeader) oder des Verzeichnisses auf Diskette. UI fl_Access 0x0008 (8) Gibt die Art des Zugriffs an, der über dieses »Lock« zugelas- sen ist. Modula-2 Dez Beschreibung SHARED_LOCK sharedLock Nur Lesezugriff ist möglich. ACCESS_READ accessRead Nur Lesezugriff ist möglich. EXCLUSIVE_LOCK exclusiveLock Nur Schreibzugriff ist möglich. ACCESS_WRITE accessWrite Nur Schreibzugriff ist möglich. U fl_ Task 0x000C (12) Ein Adreßzeiger auf die MsgPort-Datenstruktur des Hand- lerprozesses des Device, zu dem dieses File gehört. „4 fi_Volume 0x0010 (16) Ein BPTR-Adreßzeiger auf eine DeviceList-Datenstruktur, die nähere Informationen über das Device enthält, zu dem das File gehört. FileSystemStartupMsg oe C (libraries/filehandler.h) Modula-2 (DOS) Hex Dez struct InfoData FileSysStartupMsg = { RECORD 0000 0 ULONG fssm_Unit; unit: LONGCARD; 0004 4 BSTR fssm_Device; device:BSTR; 0008 8 BPTR fssm_Environ; environ: DosEnvecPitr; DOOC 12 ULONG fssm_Flags flags:LONGSET,; 0010 16 L: END; Datenstrukturenreferenz »Dos«: DeviceNode. Routinenreferenz Keine. > Beschreibung Bei Devices, die neu geöffnet werden, steht indem dn_ Startup-Feld, der DeviceNode-Datenstruktur, ein BPTR auf eine FileSystemStartupMsg-Datenstruktur. Sie sagt dem System, was bei der Initialisierung des Devices (mit der OpenDevice-Routine) zu tun ist und wie das Device physikalisch aufgebaut ist. „4 fssm_Unit 0x0000 (0) Hier steht die Exec-Unitnummer (z.B. die Laufwerksnum- mer). „1 fssm_Device 0x0004 (4) 1 fssm_Environ 0x0008 (8) Den fssm_Flags 0x000C (12) Ein BSTR-Adreßzeiger auf eine nullterminierte Zeichenket- te, die den Namen des Devices enthält. Sie wird mit dem bei OpenDevice angegebenen Namen verglichen. Ein Adreßzeiger auf eine DosEnvec-Datenstruktur oder ein beliebiges ULONG-Array, in dem weitere Informationen zum Device enthalten sind. Einige Flags, die für die Routine OpenDevice benötigt werden. InfoData Offset C (libraries/dos.h) Modula-2 (Dos) Hex Dez struct InfoData InfoData = { RECORD 0000 0 LONG id_NumsSoftErrors; numsSoftErrors:LONGINT,; 0004 4 LONG id_UnitNumber; unitNumber:LONGINT; 0008 8 LONG id_DiskState; diskState: LONGINT,; 000C 12 LONG id_NumßBlocks; numBlocks:LONGINT; 0010 16 LONG id_NumBlocksUsed; numBlocksUsed:LONGINT,; 0014 20 LONG id_BytesPerBlock; bytesPerBlock:LONGINT,; 0018 24 LONG id_DiskType; diskType:LONGINT,; 001C 28 BPTR id_VolumeNode; volumeNode:DeviceListPtr; 0020 32 LONG id_InUse; inUse:LONGINT,; 0024 36 }; END; Datenstrukturenreferenz Keine. Routinenreferenz »DOS«: Info. \_.... Beschreibung In dieser Datenstruktur werden diverse Informationen über ein Volume (also z.B. eine Diskette oder eine »RAM DISK«) gespeichert. Mit Hilfe der /nfo-Routine können Sie eine solche Datenstruktur mit den Daten eines Volumes initialisieren lassen. Zu beachten ist, daß die /nfoData-Datenstruktur an einer durch vier teilbaren Adresse liegen muß. 4 id_NumsoftErrors 0x0000 (0) Falls es sich bei dem Volume um eine Diskette/Festplatte handelt, finden Sie hier die Anzahl der fehlerhaften Blocks/ Tracks. 4 id_UnitNumber 0x0004 (4) Die Nummer des Laufwerks (-1 für die »RAM DISK«). I id_DiskState 0x0008 (8) Momentaner Zustand der Diskette. Hier können folgende Werte stehen: C Modula-2 Dez ID_WRITE_PROTECTED ID_VALIDATING ID_VALIDATED writeProtected 80 validating 81 validated 82 I id_NumBlocks 0x000C (12) I id_NumbBlocksUsed 0x0010 (16) J id_BytesPerBlock 0x0014 (20) I id_DiskType 0x0018 (24) Beschreibung Die Diskette ist schreibgeschützt. Die Diskette wird überprüft. Die Diskette ist OK. Die Anzahl der Blocks, die das Volume hat. Anzahl der bereits belegten Blocks des Volumes. Die Größe eines einzelnen Blocks in Bytes. Hier steht Näheres über eine eingelegte Diskette. Folgende Werte sind möglich (in Modula-2 werden die Zeichenketten mit Hilfe von CAST in LONGINT-Werte umgewandelt). C Modula-2 Wert Beschreibung ID_NO_DISK_PRESENT noDiskPresent 71IL Es ist keine Diskette im Laufwerk. ID_UNREADABLE_DISK unreadableDisk ‘BADW’ Die Diskette ist nicht lesbar. ID_DOS_DISK dosDisk ‘DOSW’ Die Diskette ist OK (Amiga-DOS). ID_NOT_REALLY_DOS notReallyDos ‘NDOS’ Es ist keine Amiga-DOS- Diskette. ID_KICKSTART_DISK kickstartDisk KICK’ Es ist eine Kickstart-Diskette. „4 id_VolumeNode 0x001C (28) I id_InUse 0x0020 (32) Ein BPTR auf die zugehörige DeviceList-Datenstruktur. Falls auf die Datei gerade zugegriffen wird, steht hier ein Wert ungleich null. Process Offset C (libraries/dosextens.h) Modula-2 (Dos) MM Hex Dez struct Process Process = H T ! RECORD 0000 0 struct Task pr_Task; task:Task; 005C 92 struct MsgPort pr_MsgPort; msgPort:MsgPort; 007E 126 WORD pr_Pad; pad:WORD;, 0080 128 BPTR pr_SeglLbist; segList:BPTR; 0084 132 LONG pr_StackSize; stackSize:LONGINT, 0088 136 APTR pr_GlobVec; globVec:ADDRESS; 008C 140 LONG pr_TaskNum; taskNum:LONGINT, Offset C (libraries/dosextens.h) Hex Dez 0090 144 BPTR pr_StackBase; 0094 148 LONG pr_Result2; 0098 152 BPTR pr_CurrentDir; 009C 156 BPTR pr_CIS; 00AO 160 BPTR pr_COS; 00A4 164 APTR pr_ConsoleTask; 00A8 168 APTR pr_FileSystemTask; 00AC | 172 BPTR pr_CLI,; 00B0 176 APTR pr_ReturnAddr; 00B4 180 APTR pr_PktWait; 00B8 184 APTR pr_WindowPtr; 00BC | 188 }; Datenstrukturenreferenz Keine. Routinenreferenz »Dos«: »Exec«: > Beschreibung Diese Datenstruktur identifiziert einen Prozeß. Sie wird bei der Erzeugung des Prozesses mit der CreateProcess-Routine initialisiert und enthält Informationen über die Art des Prozesses, die zugehöri- gen Handler, die zugehörigen Tasks etc. Sie ist eigentlich nur eine erweiterte Task-Datenstruktur. Der Unterschied zwischen einem einfachen und einem in einen Prozeß eingebundenen Task besteht darin, daß der zweite uneingeschränkt auf »Dos«-Routinen, Datenstrukturen und Handler zugreifen kann. Jedem Programm, das vom CLI oder von der Workbench gestartet wird, wird eine solche Datenstruktur zugeordnet. Sie können die Anfangsadresse einer solchen Datenstruktur mit der FindTask-Routine aus »Exec« ermitteln (für den eigenen Prozeß dabei NULL als Namen angeben). Alle Routinen und Datenstrukturen benutzen allerdings zur Identifikation eines Prozesses nicht die Anfangsadresse, sondern einen BPTR auf das MsgPort-Feld. I pr_Task 0x0000 (0) 4 pr_MsgPort 0x005C (92) J pr_Pad 0x007E (126) Modula-2 (Dos) stackBase:BPTR; result2:LONGINT,; currentDir:FileLockPtr; cis:FileHandlePtr; cos:FileHandlePtr; consoleTask:Processld; fileSystemTask:Processld; cli:CommandLinelnterfacePtr; retumAddr: ADDRESS; pktWait:ADDRESS; windowPtr: ADDRESS; END; CreateProcess. FindTask. Eine vollständig eingebundene Task-Datenstruktur wie im Kapitel über die Exec-Library beschrieben. Sie sorgt dafür, daß »Dos« Prozesse in das Multitasking des Amiga ein- gebunden werden. Ihre Adresse wird von der FindTask- Routine geliefert. Eine eingebundene MsgPort-Datenstruktur wie im Kapitel über die Exec-Library beschrieben. Dieser Port dient als Kennung des Prozesses. An ihn werden auch alle an diesen Prozeß gerichteten Nachrichten geschickt. Ein Füllbyte ohne weitere Bedeutung. I pr_SegList 0x0080 (128) J pr_StackSize 0x0084 (132) I pr_GlobVec 0x0088 (136) J pr_TaskNum 0x008C (140) I pr_StackBase 0x0090 (144) I pr_Result2 0x0094 (148) J pr_CurrentDir 0x0098 (152) 4 pr_CIS 0x009C (156) I pr_COS 0x00A0 (160) I pr_ConsoleTask 0x00A4 (164) I pr_FileSystemTask 0x00A8 (168) I pr_CLI 0x00AC (172) I pr_ReturnAddr 0x00B0 (176) J pr_PktWait 0x00B4 (180) 4 pr_WindowPtr 0x00B8 (184) Ein BPTR auf die Segmentliste des Programms. Er zeigt auf ein Feld von Adreßzeigern, von denen der vierte auf das erste Segment zeigt. Die Segmente sind über BPTR-Adreßzeiger verkettet. Dabei gibt das erste Element die Größe des Feldes an. Die Größe des Stack-Prozesses in Bytes, die ihm beim Auf- ruf von der Routine CreateProcess zugewiesen wird. Die Größe des Prozeßstacks ist nicht mit der der CLI-Befehle identisch. Ein Adreßzeiger auf die globale Sprungtabelle von Amiga- DOS. Ist dies ein CLI-Prozeß, so steht hier die Nummer dieses Pro- zesses in TaskTable der RootNode-Datenstruktur, sonst null. Ein BPTR auf das Ende des Prozeßstacks. Hier steht die Nummer der Fehlermeldung, die von der Routine /oErr geliefert wird. Ein BPTR auf die FileLock-Stuktur des aktuellen Verzeich- nisses. Dieser wird von der Routine CurrentDir geliefert. Ein BPTR auf die FileHandle-Datenstruktur des CLI-Ein- gabestromes. Ein BPTR auf die FileHandle-Datenstruktur des CLI-Aus- gabestromes. Ein BPTR auf das MsgPort-Feld der Process-Datenstruktur des zugehörigen Console-Handlers des aktuellen Fensters. Ein BPTR auf das MsgPort-Feld der Process-Datenstruktur des zugehörigen Handlers des aktuellen Laufwerks. Falls dies kein CLI-Prozeß ist, so steht hier NULL, sonst ein BPTR auf eine CommandLinelnterface-Datenstruktur. Ein Adreßzeiger auf die auf dem Stack abgelegte Rück- sprungadresse, die beim Verlassen des Programms mit der EXIT-Funktion angesprungen wird. Ein Adreßzeiger auf eine Funktion, die aufgerufen wird, wenn der Prozeß anhält, um auf eine Nachricht zu warten. Normalerweise steht hier jedoch NULL. Ein Adreßzeiger auf das Fenster, in dem die »Dos«-Reque- ster mit Fehlermeldungen bzw. Anforderungen an den Be- nutzer erscheinen. Steht hierNULZ, dann wird der Requester im Fenster der Workbench erzeugt. Wenn Sie wollen, daß die Fehlermeldung mittels Write ausgegeben wird, geben Sie hier -1 an. RootNode Offset C (libraries/dosextens.h) Modula-2 (Dos) struct RootNode RootNode = { RECORD 0000 0 BPTR rn_TaskArray; taskArray:TaskArrayPir; 0004 4 BPTR rn_ConsoleSegment; consoleSegment:BPTR; 0008 8 struct DateStamp rn_Time; time:Date; 0032 20 LONG rn_RestartSeg; restartSeg:BPTR; 0036 24 BPTR rn_Info; info:DosInfoPtr; 003A 28 BPTR rn_FileHandlerSegment; filleHandlerSegment:BPTR; ; END; Datenstrukturenreferenz »Dos«: DosLibrary. Routinenreferenz Keine. ___> Beschreibung Eine globale Datenstruktur für »Dos«, die wichtige Daten über den momentanen Zustand des Systems speichert. 1 rn_TaskArray 0x0000 (0) Ein BPTR auf eine Tabelle, in der die BPTR auf die MsgPort-Datenstrukturen aller aktiven CLI-Prozesse ge- speichert sind. Das nullte Feld beinhaltet die Länge der Tabelle. J rn_ConsoleSegment 0x0004 (4) Ein BPTR auf die Segmentliste des CLI-Codes, der von | NEWCLI zur Erzeugung eines neuen CLIs benutzt wird. J rn_Time 0x0008 (8) Die aktuelle Zeit in Form einer eingebundenen DateStamp- Datenstruktur. I rn_RestartSeg 0x0032 (20) Ein BPTR auf die Segmentliste des Codes, der immer dann aufgerufen wird, wenn eine neue Diskette ins Laufwerk eingelegt wird. I rn_Info 0x0036 (24) Ein BPTR auf die globale /nfo-Datenstruktur. „1 rn_FileHandlerSegment 0x003A (28) Ein Adreßzeiger auf die Segmentliste des Filehandlers. StandardPacket Offset C (libraries/dosextens.h) Modula-2 (Dos) struct StandardPacket StandardPacket = [ RECORD struct Message sp_Msg; msg:Message; struct DosPacket sp_Pkt; pkt:DosPacket; Ir END; Datenstrukturenreferenz Keine. Routinenreferenz Keine. Beschreibung In dieser Datenstruktur sind eine Message- und eine DosPacket-Datenstruktur zusammengefaßt. Sie werden benötigt, um ein »Packet« zu senden. sp_Msg 0x0000 (0) Eine Message-Datenstruktur wie im Kapitel über die Exec- Library beschrieben. Ihre Adresse wird zum Senden des Packets an die Routine PutMsg übergeben. Das Name-Feld muß dabei auf sp_Pkt zeigen. sp_Pkt 0x0014 (20) Eine DosPacket-Datenstruktur, die den Befehl und die Argumente beinhaltet. Die DOS-LiBrARY . nn nn 219 ER (GmEem; EZZZFTT MmaxcLı (n) | ÜFFEREEEEEEZG Be q HL 4 es German ON ZEIT FFTFZ L/ GALLE) NextSe NDevicenode RootNode Di a f A IPEPLERZELEZTR 7 ee), N Lehen 7 EA ( Ri Segment RER = ILILELL 4 AResidentListY Mnextseg | ke ISEE, di DevInfo # F7 FEEREEEEZEEEGG ) extseg B An n FEREZEEZEEZTUR (a EZ, OREEREZEREZ Y VICE A segment (9 TERITZELZZLGS | | |rl_SegList p Seen AD nl Pi 7 u 0, VICE Abb. 6.1: Die DOS-Library VRREHEN eis zen | SÜSS Ndn_Tas sk N SS TS NN T 7 i NEIN rn im Handler-Filename N oevieenede } Be N N = Startup N N N NN a StartupMscq 2 ISS 77 RR N Non None ___R Bee DosEnvec X Dosenvee IS Devicename / Filerock | N ST NT N Sr Is SI3 II 33 3, I, T x N N rtisioer \ 8 WerÜbez ER Peer: N SEEN N N, DEE, 07 x el —_ N £1_Volume III Abb. 6.2: Die DOS-Device-Liste nn een enN N Process Ä NISSSS ee zB & Priorität des Tasks und En ae N somit des Prozesses _Nin Name 3“ Taskname IIIIIIIIQTS Zn ZZ ern ahnen hen een MsgPort Hier werden für den Prozess bestimmte Nachrichten geschickt ER, 7 L ee Die Messageliste X Dr a des Prozesses r WELZEZEEEE ZILLLLL Ans Node | CL n mp _SigTask Ss pr_SegList I ee UN AA {Lt N Dane Segmentlisten A Segment Y dieses Tengmane Prozesses SIER ZEIT, I VIILLEIL ZA er Nr SEN II" _ ’ pr_currentDir NÜRIIIICKSS TI IS Prozess der N Aktuelles i ee es .. N CL N Verzeichnis Vu nn 4 > PIEIZIIILT ET a _ pr_ConsoleTask TI Z ID, en VO TG Prozess der Filehandlers N pr_FileSystemTask FZZZ ) Emmen D IFEReIeeEEEIIIeIIIZ Npr_cli esmanaLinernterrase } LG: (AIIIN RR] Abb. 6.3: Der Aufbau eines Prozesses T- il 7.1 Die Diskfont-Library Die Aufgabe dieser Library ist es, das Laden, Speichern und Verwalten verschiedener Zeichensätze zu übernehmen. Beim Öffnen dieser Bibliothek wird die Adresse, die die Routine OpenLibrary zurückgibt, der Variablen DiskfontBase zugewiesen. AvailFonts Offset C (libraries/diskfont.h) struct AvailFonts | UWORD af_Type; struct TextAttr af_Attr; Ki Assembler Datenstrukturenreferenz Routinenreferenz - .. ” Beschreibung Syntax: SONSTIGE LIBRARIES »DiskFont«: »DiskFont«: Modula-2 (DiskFont) AvailFont = RECORD type: AvailFontTypeSet; attr: TextAttr; END; Strukturname = AF AvailFontsHeader. AvailFonts. Nach dem Aufruf der Routine AvailFonts wird in einer Reihe von AvailFonts-Datenstrukturen, die von einer AvailFontsHeader-Datenstruktur eingeleitet werden, die Informationen über die verfügbaren Zeichensätze gespeichert. A af_Type 0x0000 (0) Diese 2-Byte-Marke gibt an, ob sich dieser Font im Speicher oder auf Diskette befindet. C Modula-2 Hex AFF_MEMORY memory 0001 AFF_DISK disk 0002 Beschreibung Der Zeichensatz befindet sich im Speicher. Der Zeichensatz befindet sich auf Diskette. 4 af_Attr 0x0002 (2) Dies ist eine normale TextAttr-Datenstruktur aus »Gra- phics«. Sie beschreibt alle Eigenschaften der Zeichensätze. Offset C (libraries/diskfont.h) Modula-2 (DiskFont) struct AvailFontsHeader AvailFontHeader = [ RECORD UWORD afh_NumfEntries; numEntries: CARDINAL; /* struct AvailFonts (* af: ARRAY[O..numEntries-1] OF afh_AFT]; */ AvailFont; *) }; END; AvailFontsHeader Assembler Syntax: Strukturname = AFH Datenstrukturenreferenz Keine. Routinenreferenz »DiskFont«: AvailFonts. Beschreibung Diese Datenstruktur leitet nach Aufruf der AvailFonts-Routine die Liste der oben beschriebenen AvailFonts-Datenstrukturen ein. 1 afh_NumEntries 0x0000 (0) Gibt an, wie viele AvailFonts-Datenstrukturen in afh_AF zusammengefaßt sind. 4 afh_AF 0x0002 (2) Hier befinden sich so viele AvailFonts-Datenstrukturen, wie in afh_NumEntries angegeben. C (libraries/diskfont.h) Modula-2 (DiskFont) Hex Dez struct DiskFontHeader DiskFontHeader = { RECORD 0000 0 struct Node dfh_DF; df: Node; 000E 14 UWORD dfh_FilelD; filleld: CARDINAL; 0010 16 UWORD dfh_Revision; revision: CARDINAL; 0012 18 LONG dfh_Segment; segment: BPTR; 0016 22 char dfh_Name[32]; name: ARRAY [0..31] OF CHAR; 0036 54 struct TextFont dfh_TF; tf: TextFont 006A 106 }; END; DiskFontHeader Datenstrukturenreferenz Keine. Routinenreferenz Keine. Beschreibung Wird ein Diskfont mit Hilfe der Routine LoadSeg geladen, dann steht eine DiskFontHeader-Datenstruk- tur an der Adresse, die LoadSeg zurückgiibt. I dfh_DF 0x0000 (0) Einbindung einer vollständigen Node-Datenstruktur aus der Exec-Library. Über solche Nodes sind alle Diskfonts verket- tet. I dfh_FileID 0x000E (14) Hier steht immer der Wert: Ox0f80 (3968). 4 dfh_Revision 0x0010 (16) Gibt die Versionsnummer des Zeichensatzes an. I dfh_Segment 0x0012 (18) Ein Adreßzeiger auf das Segment nach dem Laden. I dfh_Name 0x0016 (22) Eine Zeichenkette bis 32 Zeichen Länge, die den Namen des Zeichensatzes enthält. Ü dfh_TF 0x0036 (54) Einbindung einer vollständigen TextFont-Datenstruktur aus der der Graphics-Library, die die genauen Daten des Zei- chensatzes enthält. C (libraries/diskfont.h) Modula-2 (DiskFont) FontContents = RECORD fileName: ARRAY [0..255] OF CHAR; ySize: CARDINAL; style: FontStyleSet; flags: FontFlagsSet; END; struct FontContents | char fc_FileName[256]; UWORD fc_ YSize; UBYTE fc_Style; UBYTE fc_Flags; H FontContens Assembler Syntax: Strukturname = FH Datenstrukturenreferenz »DiskFont« : FontContensHeader. Routinenreferenz Keine. ____> Beschreibung Diese Datenstruktur beschreibt einige Eigenschaften eines sich auf Diskette befindenden Zeichensatzes und gibt an, unter welchen Namen dieser auf Diskette zu finden ist. Es werden mehrere solcher Datenstrukturen an eine FontContentsHeader-Datenstruktur angehängt. 4 fc_FileName 0x0000 (0) „1 fc_YSize 0x0100 (256) „4 fc_Style 0x0102 (258) J fe_Flags 0x0103 (259) fch_FC]]; */ L. i FontContentsHeader Assembler Datenstrukturenreferenz Routinenreferenz Der Name (wenn nötig, mit Laufwerksnummer und Direc- tory), unter dem die eigentlichen Daten dieses Zeichensatzes auf Diskette zu finden sind. Wird nur der Filename angege- ben, so wird dieser in der FONTS: Directory gesucht. Dieses Feld entspricht dem ta_YSize-Parameter der Text- Attr-Datenstruktur. Dieses Feld entspricht dem ta_Style-Parameter der TextArttr- Datenstruktur. Dieses Feld entspricht dem ta_Flags-Parameter der Text- Attr-Datenstruktur. Offset C (libraries/diskfont.h) Modula-2 (DiskFont) Hex Dez struct FontContentsHeader FontContentsHeader = RECORD UWORD fch _FilelID; fileld: CARDINAL; UWORD fch_NumeEntries; numEntries: CARDINAL; /* struct FontContens (*fe: ARRAY[O..numEntries-1] OF FontContents*) END; Syntax: Strukturname = FCH Keine. »DiskFont« : DisposeFontContens, NewFontContents. Diese Datenstruktur leitet eine Liste von FontContents-Datenstrukturen ein, die eine Familie ähnlicher Zeichensätze (die sich z.B. nur in der Größe unterscheiden) beschreiben. Diese Datenstruktur ist in dem File <FONTNAME>.FONT jedes Zeichensatzes enthalten (z.B. in SAPHIRE.FONT). J fch_FileID 0x0000 (0) J fch_NumEntries 0x0002 (2) I fch_FC 0x0004 (4) Dieser Wert identifiziert die Art des Files und muß immer 0x0f00 (3840) sein. Anzahl der in FC folgenden FontContents-Datenstrukturen. Hier stehen so viele FontContents-Datenstrukturen, wie in fceh_NumEntries angegeben. Sosmaleranuıs oo 7.2 Die Expansion-Library Die Expansion-Library dient dazu, Erweiterungen in Form von Steckkarten in das Amiga-System einzubinden. Diese Library ist sehr Hardware-orientiert und daher besonders systemintern. Sie wirft auch für uns noch einige ungeklärte Fragen auf und ist in diesem Buch nur der Vollständigkeit halber mit eingeschlossen. ConfigDev Hex Dez struct ConfigDev ConfigDev = { RECORD 0000 0 struct Node cd_Node; node:Node; 000E 14 UBYTE cd_Flags; flags:UByte; 000F 15 UBYTE cd_Pad; pad:UByte; 0010 16 struct ExpansionRom cd_Rom; rom:ExpansionRom; 0020 32 APTR cd_BoardAddr; boardAddr: ADDRESS; 0024 36 APTR cd_BoardSize; boardSize: ADDRESS; 0028 40 UWORD cd_SlotAddr; slotAddr:CARDINAL; 002A 42 UWORD cd_SlotSize; slotSize:CARDINAL; 002C 44 APTR cd_Driver; driver ADDRESS; 0030 48 struct ConfigDev * cd_NextCD; nextCD:ConfigDevPtr; 0034 52 ULONG cd_Unused[4]; unused: ARRAY [0..3] OF LONGINT; 0044 68 h END; Datenstrukturenreferenz »Expansion«: ExpansionBase, CurrentBinding. Routinenreferenz »Expansion«: AllocConfigDev, ConfigBoard, FindConfigDev, FreeConfigDev, ReadExpansionRom, RemConfigDev. Diese Datenstruktur beschreibt eine externe Erweiterung und dient dazu, sie in das Amiga-System einzubinden. Zu diesem Zweck wird sie an die ConfigBoard-Routine übergeben, die sie in die entspre- chende Liste der ExpansionBase-Datenstruktur einträgt. I cd_Node 0x0000 (0) Über diese eingebundene Node-Datenstruktur werden mehrere ConfigDev-Datenstrukturen miteinander zu einer Liste verkettet. „1 cd _Flags 0x000E (14) Diese Flags geben nähere Auskunft über den Zustand der Erweiterung. Folgende zwei Werte sind zugelassen: C Modula-2 Beschreibung CDF_SHUTUP shutup Die Erweiterung ist ausgeschaltet. CDF_CONFIGME configMe Die Erweiterung benötigt einen eigenenTreiber. I cd Pad 0x000F (15) Ein Füllbyte. 1 cd_Rom 0x0010 (16) Eine eingebundene ExpansionRom-Datenstruktur zum Zu- griff auf die Hardware der Erweiterung. I cd_BoardAddr 0x0020 (32) Die Speicheradresse, an der sich die Erweiterung befindet. „4 cd _BoardSize 0x0024 (36) Die Größe der Erweiterung (natürlich nicht in Quadratzenti- metern, sondern in Bytes). 1 cd_SlotAddr 0x0028 (40) Die Nummer des Slots, in dem sich die Erweiterung befindet. I cd _SlotSize 0x002A (42) Die Anzahl der Slots, die durch diese Erweiterung belegt werden. U cd_Driver 0x002C (44) Ein Adreßzeiger auf die Node-Datenstruktur des zugehöri- gen Treibers. „I cd_NextCD 0x0030 (48) Ein Adreßzeiger auf die zu konfigurierenden Treiber dieser Erweiterung. „J cd _Unused 0x0034 (52) Speicherplatz für zukünftige Erweiterungen dieser Daten- struktur. Offset C (libraries/configvars.h) Modula-2 (Expansion) He De struct CurrentBinding CurrentBinding = [ RECORD 0000 0 struct ConfigDev * cb_ConfigDev; configDev:ConfigDevPtr; 0004 4 UBYTE * cb_FileName; fileName: ADDRESS; 0008 8 UBYTE * cb_ProductString; productString: ADDRESS; V00C 12 UBYTE ** cb_ToolTypes; toolTypes: ADDRESS; 0010 16 }; END; CurrentBinding Datenstrukturenreferenz Keine. Routinenreferenz »Expansion«: GetCurrentBinding, SetCurrentBinding. ___> Beschreibung Diese Datenstruktur beschreibt die aktuelle Konfiguration einer Erweiterung. M SonsTi ; IBR ARIES n _ A . | 2 I cb_ConfigDev 0x0000 (0) Ein Adreßzeiger auf die Liste der zugehörigen ConfigDev- Datenstrukturen. „1 cb_FileName 0x0004 (4) Ein Adreßzeiger auf den Namen des Treibers. I cb_ProductString 0x0008 (8) Ein Adreßzeiger auf den Namen (oder sonstige ID) der Erweiterung. UI cb_ToolTypes 0x000C (12) Ein Adreßzeiger auf die in einer DiskObjekt-Datenstruktur enthaltenen Startup-Informationen des Treibers (siehe »Workbench«). DiagArea Offset C (libraries/configregs.h) Modula-2 (Expansion) He De struct DiagArea DiagArea = ! RECORD 0000 0 UBYTE da_Config; config:UByte; 0001 1 UBYTE da_Flags; flags:UByfte; 0002 2 UWORD da_ Size; size: CARDINAL; 0004 4 UWORD da_DiagPoint; diagPoint:CARDINAL; 0006 6 UWORD da_BootPoint; bootPoint:CARDINAL; 0008 8 UWORD da_Name; name:CARDINAL; 000A 10 UWORD da_ReservedOl; reservedOl:CARDINAL; 000€ 12 UWORD da_ReservedO2; reserved02:CARDINAL 000E 14 }; END; Datenstrukturenreferenz »Expansion«: ExpansionRom. Routinenreferenz Keine. [___> Beschreibung Falls das ERTB_DIAGVALID-Bit des er_Type-Parameters der ExpansionRom-Datenstruktur gesetzt ist, zeigtdaser_InitDiagVec-Feld aufeine solche, im ROM der Erweiterung enthaltene Datenstruktur. Dabei handelt es sich um einen Offset von der Basis der Erweiterung. Sie gibt weiterhin an, was bei einem Bootvorgang oder einem Fehler mit der Erweiterung getan werden soll. I da_Config 0x0000 (0) Dieses Byte gibt an, mit welcher Wortbreite diese Daten- struktur im ROM der Erweiterung vorhanden ist: Modula-2 Hex Beschreibung DAC_NIBBLEWIDE nibbleWide Die Wortbreite beträgt 4 Bit. DAC_BYTEWIDE byteWide Die Wortbreite beträgt 8 Bit. DAC_WORDWIDE wordWide Die Wortbreite beträgt 16 Bit. DAC_BUSWIDTH busWidth Die Wortbreite beträgt 32 Bit. 1 da_Flags 0x0001 (1) 6 DAC_NEVER DAC_CONFIGTIME DAC_BINDTIME DAC_BOOTTIME „1 da_Size 0x0002 (2) [ da_DiagPoint 0x0004 (4) IM da_BootPoint 0x0006 (6) „1 da_Name 0x0008 (8) „1 da_Reserved01 0x000A (10) „1 da_Reserved02 0x000C (12) Folgende Flags geben die Funktion der Datenstruktur an (wann sie benutzt wird): Modula-2 Hex Beschreibung never 00 Sie wird nie benutzt. configTime 10 Sie wird beim Konfigurieren benutzt. bindTime 20 Sie wird beim »Binding« benutzt. bootTime 20 Sie wird beim Booten benutzt. Die Größe, die diese Datenstruktur im ROM der Erweiterung einnimmt. Ein Adreßzeiger auf eine eventuell vorhandene Fehler- behandlungsroutine der Erweiterung oder null. Ein Adreßzeiger auf eine eventuell vorhandene Boot-Rou- tine der Erweiterung oder null. Ein Adreßzeiger auf einen evtl. im ROM der Erweiterung vorhandenen Namen, aber was für einen? Reserviertes Wort für internen Gebrauch, auf null setzen. Reserviertes Wort für internen Gebrauch, auf null setzen. ExpansionBase Offset C (libraries/expansionbase.h) Hex Dez struct ExpansionBase "7 { 0000 0 struct Library LibNode; 0022 34 UBYTE Flags; 0023 35 UBYTE pad; 0024 36 APTR ExecBase; 0028 40 APTR Seglist; 002C 44 struct CurrentBinding CurrentBinding; 003C 60 struct List BoardList; 004A 74 struct List MountLäist; 0058 88 UBYTE AllocRTable[256]; 0158 344 struct SignalSemaphore BindSemaphore; 0186 390 struct Interrupt Int2Lbist; O19C 412 struct Interrupt Int6Lbist; 01B2 434 struct Interrupt Int7List; 01C8 | 456 }: Assembler Datenstrukturenreferenz Routinenreferenz DZ» Beschreibung Präfix: eb_ Syntax: Der Parameter LibNode ist nicht defi- niert. Keine. Keine. Dies ist eine erweiterte Library-Datenstruktur, die die Expansion-Library beschreibt. Diese system- interne Datenstruktur ist nur in neueren Versionen der verschiedenen Compiler implementiert. a Eee E Ü LibNode 0x0000 (0) Flags 0x0022 (34) pad 0x0023 (35) ExecBase 0x0024 (36) SegList 0x0028 (40) CurrentBinding 0x002C (44) BoardList 0x003C (60) MountList 0x004A (74) AllocRTable 0x0058 (88) BindSemaphore 0x0158 (344) Int2List 0x0186 (390) Int6List 0x019C (412) Int7List 0x01B2 (434) Eine eingebundene Library-Datenstruktur zur Einbindung der Expansion-Library in das System. Systeminterne Flags. Ein Füllbyte ohne weitere Bedeutung. Ein Adreßzeiger auf die ExecBase-Datenstruktur. Eine Segmentliste, wer weiß wovon? Ein Adreßzeiger aufeine CurrentBinding-Datenstruktur, die wohl die momentan aktiven Erweiterungen spezifiziert. Der Kopf der Liste aller Erweiterungen. Eine Vermutung: Der Kopf der Liste all der Erweiterungen, die »gemountet« werden müssen. Offensichtlich eine Tabelle... Anscheinend eine für alle Slots (256 benötigten allerdings einen neuartigen 2,50 m breiten Amiga’). Eine eingebundene Semaphore-Datenstruktur, die anschei- nend den Zugriff auf den CurrentBinding-Parameter koor- dinieren soll. 2 22: 204 ExpansionControl Offset C (libraries/configregs.h) Modula-2 (Expansion) Hex Dez struct ExpansionControl ExpansionControl = { RECORD 0 UBYTE ec_Interrupt; interrupt:UByte; l UBYTE ec_Reservedll; reserved11:UByte; 2 UBYTE ec_BaseAddress; baseAddress:UByte; 3 UBYTE ec_Shutup; shutup:UByfte; 4 UBYTE ec_Reserved14; reserved14:UByte; 5 UBYTE ec_Reserved15; reserved15:UByte; 6 UBYTE ec_Reserved16; reserved16:UByfte; 7 UBYTE ec_Reserved17; reserved17:UByte; 8 UBYTE ec_Reserved1B8; reserved18:UByte; 9 UBYTE ec_Reserved19; reserved19:UByte; 10 UBYTE ec_Reservedla; reservedla:UByte; 11 UBYTE ec_Reservedlb; reserved1b:UByte; 12 UBYTE ec_Reservedlc; reservedlc:UByte; 13 UBYTE ec_Reservedld; reserved1d:UByfte; 14 UBYTE ec_Reservedle; reservedle:UByte; 15 UBYTE ec_Reservedlf; reserved 1f:UByte; 16 I ; END; Datenstrukturenreferenz Keine. Routinenreferenz Keine. ___> Beschreibung Laut [KRA] dient diese Datenstruktur zur logischen Beschreibung des Kontrollregister-Bereiches einer Erweiterung. Sie kann den physikalischen Aufbau nur näherungsweise wiedergeben. Die genaue Bedeutung der einzelnen Felder wird wohl von Erweiterung zu Erweiterung variieren? J ec_Interrupt 0x0000 (0) Dieser Wert entspricht dem Interrupt-Register der Erweite- rung. 1 ec_Reservedi1 0x0001 (1) Ein für den internen Gebrauch reserviertes Byte. 3 ec_BaseAddress 0x0002 (2) Hängt mit der Veränderung der Basisadresse innerhalb der Erweiterung des Systems zusammen ??? I ec_Shutup 0x0003 (3) Soll vielleicht zum Ein- und Ausschalten der Erweiterung benutzt werden? „1 ec_Reserved14 0x0004 (4) Ein für den internen Gebrauch reserviertes Byte. 1 ec_Reserved15 0x0005 (5) Ein für den internen Gebrauch reserviertes Byte. I ec_Reserved16 0x0006 (6) Ein für den internen Gebrauch reserviertes Byte. 3 ec_Reserved17 0x0007 (7) Ein für den internen Gebrauch reserviertes Byte. I ec_Reserved18 0x0008 (8) Ein für den internen Gebrauch reserviertes Byte. II ec_Reserved19 0x0009 (9) Ein für den internen Gebrauch reserviertes Byte. I ec_Reservedla 0x000A (10) Ein für den internen Gebrauch reserviertes Byte. I ec_Reservedib 0x000B (11) Ein für den internen Gebrauch reserviertes Byte. I ec_Reservedic 0x000C (12) Ein für den internen Gebrauch reserviertes Byte. I ec_Reservedid 0x000D (13) Ein für den internen Gebrauch reserviertes Byte. 4 ec_Reservedle 0x000E (14) Ein für den internen Gebrauch reserviertes Byte. I ec_Reservedif 0x000F (15) Ein für den internen Gebrauch reserviertes Byte. ExpansionRom Offset C (libraries/configregs.h) Modula-2 (Expansion) Hex Dez struct ExpansionRom ExpansionRom = [ RECORD UBYTE er_Type; type:UByte; UBYTE er_Product; product:UByte; UBYTE er_Flags; flags:UByte; UBYTE er_Reserved03; reserved03:UByte; UWORD er_Manufacturer; manufacturer: CARDINAL; ULONG er_SerialNumber; serialNumber:LONGCARD; UWORD er_InitDiagVec; initDiagVec:CARDINAL; UBYTE er_ReservedOc; reservedOc:UByte; UBYTE er_ReservedOd; reservedOd:UByte; UBYTE er_ReservedOe; reserved0e:UByte; UBYTE er_ReservedOf; reservedOf:UByte b END; Datenstrukturenreferenz »Expansion«: ConfigDev. Routinenreferenz Keine. L___> Beschreibung Laut [KRA] dient diese Datenstruktur zur logischen Beschreibung des ROM-Bereiches einer Erweite- rung. Sie kann den physikalischen Aufbau nur näherungsweise wiedergeben. Die genaue Bedeutung der einzelnen Felder wird wohl von Erweiterung zu Erweiterung variieren. I er_Type 0x0000 (0) Folgende Bits sind für dieses Feld definiert: Modula-2 Dez Beschreibung ERT_DIAGVALID diagValid Wenn dieses Bit gesetzt ist, muß in er InitDiagVec ein Adreßzeiger auf eine korrekt initialisierte DiagArea-Datenstruktur stehen. J er Product 0x0001 (1) Nähere Angaben zu dem Produkt, also der Erweiterung selbst. C Modula-2 Bit Beschreibung ERFB_MEMSPACE memSpace 7 Die Erweiterung muß innerhalb der unteren acht Mbyte des Adreßbe- reichs angesiedelt sein. Ist in diesem Bereich jedoch beliebig verschiebbar. ERFB_NOSHUTUP noShutup 6 Die Erweiterung ist nicht abschaltbar. er_Flags 0x0002 (2) Folgende Bits sind für dieses Feld definiert: er_Reserved03 0x0003 (3) Ein für den internen Gebrauch reserviertes Byte. er_Manufacturer 0x0004 (4) Nähere Angaben über den Hersteller der Erweiterung. er_SerialNumber 0x0006 (6) Die Seriennummer der Erweiterung. er_InitDiagVec 0x000A (10) Falls iner_Types das ERT_DIAGVALID-Bit gesetzt ist, ist dies ein Offset, der die Lage einer DiagArea-Datenstruktur innerhalb des Erweiterungs-ROMs angibt. So können Rou- tinen der Erweiterung in das System eingebunden werden. 4 er_Reserved0c 0x000C (12) Ein für den internen Gebrauch reserviertes Byte. „} er_Reserved0d 0x000D (13) Ein für den internen Gebrauch reserviertes Byte. 4 er_Reserved0e 0x000E (14) Ein für den internen Gebrauch reserviertes Byte. „J er_ReservedOf 0x000F (15) Ein für den internen Gebrauch reserviertes Byte. 7.3 Die Hardware-Library Die Datenstrukturen dieser Library dienen dazu, den Zugriff auf die Hardware zu erleichtern. Die Komponenten der Datenstrukturen entsprechen den Registern der verschiedenen Chips des Amiga. Daher ist dieses Kapitel eigentlich eine Hardware-Beschreibung. bitnode 0000 0004 0008 000A 000C 000E 0012 Assembler 0 4 8 10 12 14 18 C (hardwarel/blit.h) Modula-2 (Hardware) struct bltnode { struct bltnode *n; int (*function)(); char stat; short blitsize; short beamsync; int (*cleanup)(); b Datenstrukturenreferenz Routinenreferenz l.... Beschreibung Bltnode = RECORD n:BltnodePtr; function: ADDRESS; stat: CHAR; blitsize:INTEGER; beamsync:INTEGER; cleanup: ADDRESS; END; Präfix: bn_ »Graphics« : bltnode. »Hardware« : GfxBase. »Graphics« : OBlit, OBSBlit. Die bltnode-Datenstruktur wird zur Beschreibung von eigenständigen Blitter-Jobs verwendet, die in die zuständigen Job-Listen der GraphicsBase-Datenstruktur (siehe »Graphics«) eingetragen werden. 1 n0x0000 (0) I function 0x0004 (4) Ein Adreßzeiger auf die bltnode-Datenstruktur des nächsten Blitter-Jobs in dieser Liste. Über die n-Zeiger werden sämt- liche Blitter-Jobs einer Job-Liste vorwärts verkettet. Ein Adreßzeiger auf den Codebereich eines Unterpro- gramms, das ausgeführt wird, sobald dieser Blitter-Job an der Reihe ist. Das Unterprogramm muß mit einer RTS- Instruktion verlassen werden, wobei in Register DO ein ganzzahliges Funktionsergebnis zurückgegeben wird. Ist der Ergebniswert ungleich null, so wird das Unterprogramm ein weiteres Mal aufgerufen (und zwar so lange, bis es eine Null als Ergebnis liefert!). In Assembler geschriebene Un- terroutinen können folgende Registerkonventionen ausnut- zen: Beim Aufruf befindet sich in Register AO ein Adreßzei- ger auf den Hardware-Registerbereich (Zugriff durch Offset via AO!) und in Register Al ein Adreßzeiger auf die bltnode- Datenstruktur des aktuellen Blitter-Jobs. 3 stat 0x0008 (8) Ein Zeichen, dessen Wert angibt, ob die cleanup-Routine dieses Blitter-Jobs am Ende ausgeführt werden soll oder nicht. Das ist der Fall, wenn der ASCII-Code des Zeichens 0x40 = 64 entspricht. Anderenfalls wird die cleanup-Routine nicht ausgeführt, so daß sie mit NULL initialisiert werden kann. I blitSize 0x000A (10) Eine positive Ganzzahl, deren Wert die Ausmaße des durch diesen Blitter-Job zu bearbeitenden Datenbereichs im For- mat des bitsize Registers (siehe Custom) angibt. I beamsSync 0x000C (12) Eine positive Ganzzahl, deren Wert angibt, bei welcher Position des Elektronenstrahls die function-Routine eines elektronenstrahlsynchronisierten Blitter-Jobs aufgerufen werden soll. I cleanup 0x000E (14) Die Adresse eines Unterprogramms, das wahlweise nach Erledigung des eigentlichen Blitter-Jobs aufgerufen wird, um spezielle Status- und Aufräumarbeiten zu erledigen. CIA Offset C (hardwarel/cia.h) Modula-2 (Hardware) RECORD RECORD 0000 UBYTE ciapra; pra:CiaaPraFlagset; pra:CiabPraFlagsSet; 0001 UBYTE padO[Oxff]; padO:Pad; padO:Pad; 0100 UBYTE ciaprb; prb:CiaaPrbFlagSet; prb:CiabPrbFlagsSet; 0101 UBYTE padl[Oxff]; pad1:Pad; pad1:Pad; 0200 UBYTE ciaddra; ddra:CiaaPraFlagSet; ddra:CiabPraFlagsSet; 0201 UBYTE pad2[0xff]; pad2:Pad; pad2:Pad; 0300 UBYTE ciaddrb; ddrb:CiaaPrbFlagset; ddrb:CiabPrbFlagset; 0301 UBYTE pad3[0xff]; pad3:Pad; pad3:Pad; 0400 UBYTE caatalo; talo:UByte; talo:UByte; 0401 UBYTE pad4[0Oxff]; pad4:Pad; pad4:Pad; 0500 UBYTE ciatahi; tahı:UByte; tahi:UByfte; 0501 UBYTE padS5[Oxff]; pad5:Pad; padS:Pad; 0600 UBYTE ciatblo; tblo:UByfte; tblo:UByfte; 0601 UBYTE pad6[Oxff]; pad6:Pad; pad6:Pad; 0700 UBYTE ciatbhi; tbhi:UByte; tbhi:UByte; 0701 UBYTE pad7[Oxff]; pad7:Pad; pad7:Pad; 0800 UBYTE ciatodlow; todlow:UByte; todlow:UByte; 0801 UBYTE padß8[Oxff]; pad8:Pad; pad8:Pad; 0900 UBYTE ciatodmid; todmid:UByte; todmid:UByte; 0901 UBYTE pad9[0Oxff]; pad9:Pad; pad9:Pad; 0A00 UBYTE ciatodhi; todhi:UByfte; todhı:UByte; Oo C (hardware/cia.h) Modula-2 (Hardware) Dez UBYTE pad10[0xff]; pad10:Pad; pad10:Pad; UBYTE unusedreg; unusedreg:ShortSet; unusedreg:ShortSet; UBYTE pad11[0xff]; pad11:Pad; pad11:Pad; UBYTE ciasdr; sdr:ShortSet; sdr:ShortSet; UBYTE pad12[0Oxff]; pad12:Pad; pad12:Pad; UBYTE ciajcr; icr:CialcrFlagSet; icr:CialcrFlagSet; UBYTE pad13[0xff]; pad13:Pad; pad13:Pad; UBYTE ciacra; cra:CiaCraFlagSet; cra:CiaCraFlagSet; UBYTE pad14[0xff]; pad14:Pad; pad14:Pad; UBYTE ciacrb; crb:CiaCrbFlagsSet; crb:CiaCrbFlagsSet; }; END; END; Assembler Es sind nur die ciaxxx-Offsets definiert. Datenstrukturenreferenz Keine. Routinenreferenz Keine. L___> Beschreibung Die CIA -Datenstruktur stellt nichts anderes als eine Beschreibung der Hardware-Register des im Amiga für die Kommunikation mit der Peripherie verwendeten CIA-Bausteins 8520 dar. Die Abkürzung »CIA« steht dabei für »complex interface adapter«, was man sinngemäß mit »vielseitiger Schnittstellenbau- stein« übersetzen kann. Der CIA 8520 ist dem im C64 verwendeten CIA 6526 zum Verwechseln ähnlich, lediglich die TODxx-Register wurden beim 8520 geringfügig verändert: Sie fungieren hier als reine 24- Bit-Zähler, wohingegen im 6526 an dieser Stelle eine Echtzeituhr »time of day« vorhanden war. Den CIA-Baustein 8520 und seine Register in ihrer allgemeinen Funktion präsentiert Ihnen die nachfolgende Auflistung: Register Bedeutung Datenregister für Port A Datenregister für Port B Datenrichtungsregister für Port A Datenrichtungsregister für Port B Niederwertiges Byte (Bits O bis 7) für Timer A Höherwertiges Byte (Bits 8 bis 15) für Timer A Niederwertiges Byte (Bits 0 bis 7) für Timer B Höherwertiges Byte (Bits 8 bis 15) für Timer B Niederwertiges Byte (Bits O bis 7) des Event-Zählers Mittleres Byte (Bits 8 bis 15) des Event-Zählers Höherwertiges Byte (Bits 16 bis 23) des Event-Zählers | Register Name Bedeutung 12 0x0C SDR Datenregister des seriellen Ports 13 0x0D ICR Interrupt-Kontrollregister 14 O0x0E CRA Kontrollregister für Timer A 15 0x0F CRB Kontrollregister für Timer B Im Amiga verrichten zwei 8520-CIA-Bausteine ihre Arbeit: der CIA-A mit Basisadresse Ox0O0BFEO0O1 = 12574721 und der CIA-B mit Basisadresse Ox00BFD000 = 12570624. Aus speichertechnischen Gründen liegen die Register eines CIA-Bausteins im Amiga jeweils 256 Byte voneinander entfernt. Deshalb erhält man die tatsächliche Adresse eines CIA-Registers durch Addition von 0x0100*R =256*R zur Basisadresse des CIA-Bausteins (dabei steht R für die Nummer des gewünschten Registers). In Modula-2 sind solche Umrechnungen allerdings überflüssig, weil hier im Modul Hardware bereits zwei Variablen ciaa und ciab der Typen CIAA bzw. CIAB ab den absoluten Adressen Ox00BFEO01 sowie 0x00BFD000 deklariert sind. In »C« umgeht man die Rechnerei durch eine kleine Zeigermanipulation: STrUCL GIA- 7CT1a%8;: *elab; OD ii on je] | = (CIA)* OxOOBFEOOL; E® Zeiger auf Registersatz richten ”7 = (CIA)* Ox0O0BFDO00; = 060, Q — Do oO | Aufgrund der unterschiedlichen Belegung und Benutzung der einzelnen Register der beiden CIA- Bausteine werden für diese unter Modula-2 im Modul Hardware zwei unterschiedliche Typen namens CIAA und CIAB vereinbart. In »C« existieren solche Strukturen leider nicht. Wie die zwei CIA- Bausteine im einzelnen in das Gesamtsystem des Amiga eingebunden sind, erfahren Sie im folgenden. CIA-A _ Adresse Name D7 D6 DS D4 D3 D2 D1 DO (Bedeutung) 0Ox00BFE001 PRA /FIRI /FIRO /RDY /TKO /WPRO /CHNG /LED /OVL 0Ox00BFE101 PRB 8-Bit YO-Register für den Parallelport (Centronics) 0x00BFE201 DDRA 0 0 0 0 0 0 1 1 0x00BFE301 DDRB Hiermit können die einzelnen Leitungen des Parallelports als Ein- oder Ausgänge betrieben werden. Ox00BFE401 TALO Timer A des CIA-A wird nur für den Datentransfer per Ox00BFE501 TAHI _serieller Schnittstelle benötigt. Ansonsten ist er frei. 0Ox00BFE601 TBLO Timer B des CIA-A dient der Synchronisation des Blitters 0x00BFE701 TBHI mit dem Elektronenstrahl. Daher wird Timer B nur für QBS Blitter-Jobs (siehe GfxBase-Datenstruktur aus »Graphics«) benötigt. Ansonsten ist er frei verfügbar. 0x00BFE801 TODLO Der Event-Zähler des CIA-A registriert die Frequenz-Impulse Ox00BFE901 TODMI (»Ticks«) des Netzteils. Die in Deutschland übliche 50 Hz 0x00BFEA01 TODHI Versorgungsspannung ergibt ein Inkrement von 50 je Sekunde. 0x00BFEBOI -/- i Adresse Name Bedeutung 0x00BFECO1 SDR Datenregister für den Empfang der Tastaturcodes 0x00BFEDO1 ICR Interrupt-Kontrollregister des CIA-A Ox00BFEEOl CRA Kontrollregister für Timer A des CIA-A 0x00BFEF0Ol CRB Kontrollregister für Timer B des CIA-A Wichtig für die Systemsteuerung ist, daß der CIA-A einen INT2*Interrupt erzeugen kann. Die einzelnen Bits im Portregister A des CIA-A haben folgende Bedeutung: Bedeutung Eingabebit: Wird der Feuerknopf des Mouse-Ports I gerade gedrückt? Eingabebit: Wird der Feuerknopf des Mouse-Ports 0 gerade gedrückt? Eingabebit: Ist das ausgewählte Laufwerk bereit? Eingabebit: Ist der Kopf des Laufwerks gerade über Spur 0? Eingabebit: Ist die Diskette im Laufwerk schreibgeschützt? Eingabebit: Hat ein Diskettenwechsel im Laufwerk stattgefunden? Ausgabebit: Steuerung der Power-LED (O=hell, 1=dunkel) Ausgabebit: Speicherüberlaufsbit „memory overlay« (nicht ändern!) CIA-B Adresse Name D7 D6s6 D35 D4 D3 D2 Di DO (Bedeutung) 0x00BFD000 PRA /DIR /RTS /CD /CTS /DSR /SEL J/POUT /BUSY 0x00BFD100 PRB /MTR /SEL3 /SEL2 /SEL1 /SELO /SIDE /DIR /STEP 0x00BFD200 DDRA 1 1 0 0 0 0 0 0 0x00BFD300 DDRB 1 l l l 1 l 1 1 0x00BFD400 TALO Timer A des CIA-B wird vom Betriebssystem zur Kommunikation 0x00BFD500 TAHI mit der Tastatur benutzt. 0x00BFD600 TBLO Timer B des CIA-B dient dem Betriebssystem als virtuelles 0x00BFD700 TBHI »timer device«, das für Interrupts und die Task-Umschaltung benötigt wird. 0x00BFD800 TODLO Der Event-Zähler des CIA-B registriert die horizontalen 0x00BFD900 TODMI Synchronisationsimpulse. Im PAL-Betrieb sind das normaler- 0x00BFDA00 TODHI weise genau 15625 pro Sekunde (PAL-Zeilenfrequenz!). 0x00BFDBO00 -/- 0x00BFDC00 SDR _ (bisher nicht benutzt) 0x00BFDD00 ICR Interrupt-Kontrollregister des CIA-B 0Ox00BFDE0O0O CRA Kontrollregister für Timer A des CIA-B 0x00BFDF00 CRB Kontrollregister für Timer B des CIA-B Wichtig für die Systemsteuerung ist, daß der CIA-B einen INT6*Interrupt erzeugen kann. Die einzelnen Bits im Portregister A des CIA-B haben folgende Bedeutung: Bit 07 06 05 04 03 02 01 00 Name DTR RTS CD CTS DSR SEL POUT BUSY Bedeutung Ausgabebit: DTR-Steuersignal der seriellen Schnittstelle Ausgabebit: RTS-Steuersignal der seriellen Schnittstelle Eingabebit: CD-Signal der seriellen Schnittstelle Eingabebit: CTS-Signal der seriellen Schnittstelle Eingabebit: DSR-Signal der seriellen Schnittstelle Eingabebit: SELECT-Signal der parallelen Schnittstelle Eingabebit: PAPER OUT-Signal der parallelen Schnittstelle Eingabebit: BUSY-Signal der parallelen Schnittstelle Die Bedeutung der einzelnen Bits im Portregister B des CIA-B entnehmen Sie bitte der nachfolgenden Aufstellung: Bedeutung Ausgabebit: MOTOR-Steuersignal für das Diskettenlaufwerk Ausgabebit: Auswahlsignal »drive select« für Laufwerk 3 Ausgabebit: Auswahlsignal »drive select« für Laufwerk 2 Ausgabebit: Auswahlsignal »drive select« für Laufwerk 1 Ausgabebit: Auswahlsignal »drive select« für Laufwerk O Ausgabebit: Auswahlsignal »side select« ans Diskettenlaufwerk Ausgabebit: DIRECTION-Steuersignal für das Diskettenlaufwerk Ausgabebit: STEP-Signal für das Diskettenlaufwerk U ciapra 0x0000 (0) Adresse: Funktion: 1 pad0 0x0001 (1) 0x00BFEO001 = 12574721 für CIA-A, 0x00BFD000 = 12570624 für CIA-B PRA-Register Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. I ciaprb 0x0100 (256) Adresse: Funktion: 4 padi 0x0101 (257) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. 0x00BFE101 = 12574977 für CIA-A, 0x00BFD100 = 12570880 für CIA-B PRB-Register ciaddra 0x0200 (512) | Adresse: 0x00BFE201 = 12575233 für CIA-A, 0x00BFD200 = 12571136 für CIA-B Funktion: DDRA-Register pad2 0x0201 (513) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciaddrb 0x0300 (768) Adresse: 0x00BFE301 = 12575489 für CIA-A, 0x00BFD300 = 12571392 für CIA-B Funktion: DDRB-Register pad3 0x0301 (769) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciatalo 0x0400 (1024) Adresse: 0x00BFE401 = 12575745 für CIA-A, 0x00BFD400 = 12571648 für CIA-B Funktion: TALO-Register pad4 0x0401 (1025) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciatahi 0x0500 (1280) Adresse: 0x00BFES501 = 12576001 für CIA-A, 0x00BFD500 = 12571904 für CIA-B Funktion: TAHI-Register pad5 0x0501 (1281) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciatblo 0x0600 (1536) Adresse: 0x00BFE601 = 12576257 für CIA-A, 0x00BFD600 = 12572160 für CIA-B Funktion: TBLO-Register pad6 0x0601 (1537) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciatbhi 0x0700 (1792) Adresse: 0x00BFE701 = 12576513 für CIA-A, 0x00BFD700 = 12572416 für CIA-B Funktion: TBHI-Register pad7 0x0701 (1793) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciatodlow 0x0800 (2048) Adresse: 0x00BFE801 = 12576769 für CIA-A, 0x00BFD800 = 12572672 für CIA-B Funktion: TODLO-Register pad8 0x0801 (2049) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciatodmid 0x0900 (2304) Adresse: 0x00BFE901 = 12577025 für CIA-A, 0x00BFD900 = 12572928 für CIA-B Funktion: TODMI-Register pad9 0x0901 (2305) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciatodhi 0x0A00 (2560) Adresse: 0x00BFEA01 = 12577281 für CIA-A, 0x00BFDA00 = 12573184 für CIA-B Funktion: TODHI-Register pad10 0x0A01 (2561) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. unusedreg 0x0B00 (2816) (unbenutztes CIA-Register) padi1 0x0B01 (2817) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciasdr 0x0C00 (3072) Adresse: 0Ox00BFECO1 = 12577793 für CIA-A, 0x00BFDC00 = 12573696 für CIA-B Funktion: SDR-Register pad12 0x0C01 (3073) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciaicr 0x0D00 (3328) Adresse: Ox00BFEDO1 = 12578049 für CIA-A, 0x00BFDD00 = 12573952 für CIA-B Funktion: ICR-Register pad13 0x0D01 (3329) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciacra 0x0E00 (3584) Adresse: 0x00BFEEO1 = 12578305 für CIA-A, 0x00BFDE00 = 12574208 für CIA-B Funktion: CRA-Register pad14 0x0E01 (3585) Dummy-Komponente zur Adreßfüllung zwischen den CIA-Registern. ciacrb 0x0F00 (3840) Adresse: Ox00BFEFOIl = 12578561 für CIA-A, 0x00BFDF00 = 12574464 für CIA-B Funktion: CRB-Register Custom om C (hardware/custom.h) Modula-2 (Hardware) 0000 0002 0004 0006 0008 000A 000C 000E 0010 0012 0014 0016 0018 001A 001C OO1E 0020 0024 0026 0028 002A 002C 002E 0030 0032 0034 0036 0038 003A 003C 003E 0040 0042 0044 0046 0048 004B 0050 0054 0058 a\$nND © 12 14 16 18 20 22 24 26 28 30 32 36 38 40 42 44 46 48 50 52 54 56 58 60 62 64 66 68 70 72 76 80 84 88 struct Custom { UWORD bitddat; UWORD dmaconr; UWORD vposr; UWORD vhposr; UWORD dskdatr; UWORD joyOdat; UWORD joyldat; UWORD ckxdat; UWORD adkconr; UWORD potOdat; UWORD potldat; UWORD potinp; UWORD serdatr; UWORD dskbytr; UWORD intenar; UWORD intregr; APTR dskpt; UWORD dsklen; UWORD dskdat; UWORD refptr; UWORD vposw; UWORD vhposw; UWORD copcon; UWORD serdat; UWORD serper; UWORD potgo; UWORD joytest; UWORD strequ; UWORD strvbl; UWORD strhor; UWORD strlong; UWORD bltcon0; UWORD bltcon]; UWORD bltafwm; UWORD bltalwm; APTR bltcpt; APTR bltbpt; APTR bltapt; APTR bltdpt; UWORD bltsize; Custom = RECORD bitddat:CARDINAL; dmaconr:DmafFlagsSet; vposr:-LONGCARD; dskdatr:CARDINAL; joyOdat:Coord; joyldat:Coord; clxdat:Collison Flag Set; adkconr:Adk Flag Set; potOdat:Coord; potldat:Coord; potinp:Pot Flag Set; serdatr:Serial Info; _ dskbytr:Disk Info; intenar:IntFlagSet; intregr:IntFlagSet; dskpt: ADDRESS; dsklen:CARDINAL; dskdat:CARDINAL; refptr:CARDINAL; vposw:LONGCARD; copcon:BITSET,; serdat:Serial Info; serper:-CARDINAL; potgo:Pot Flag Set; joytest:Coord; strequ:CARDINAL; strvbl:CARDINAL; strhor:CARDINAL, strlong:CARDINAL; bltcon0:BC® Flag Set; bltcon1:BC1 Flag Set; bltafwm:BITSET; bltalwm:BITSET,; bltcpt: ADDRESS; bltbpt: ADDRESS; bltapt: ADDRESS; bltdpt: ADDRESS; bltsize:CARDINAL; Offset C (hardware/custom.h) Modula-2 (Hardware) Hex Dez 005A 90 UWORD pad2d[J3]; pad2d: ARRAY [0..2] OF CARDINAL; 0060 96 UWORD bltcmod; bltcemod:CARDINAL; 0062 98 UWORD bltbmod; bltbmod:CARDINAL; 0064 100 UWORD bltamod; bltamod:CARDINAL; 0066 102 UWORD bltdmod; bltdmod:CARDINAL; 0068 104 UWORD pad34[4]; pad34:ARRAY [0..3] OF CARDINAL; 0070 112 UWORD bltcdat; bltcdat:CARDINAL; 0072 114 UWORD bltbdat; bitbdat:CARDINAL; 0074 116 UWORD bltadat; bltadat:CARDINAL; 0076 118 UWORD pad3b[4]; pad3b:ARRAY [0..3] OF CARDINAL; 007E 126 UWORD dsksync; dsksync:CARDINAL; 0080 128 ULONG coplic; copllc: ADDRESS; 0084 132 ULONG cop2lc; cop2lc: ADDRESS; 0088 136 UWORD copjmpl; copjmp1:CARDINAL; 008A | 138 UWORD copjmp2; copjmp2:CARDINAL; 008C | 140 UWORD copins; copins:CARDINAL; 008E 142 UWORD diwstrt; diwstrt:Coord; 0090 144 UWORD diwstop; diwstop:Coord; 0092 146 UWORD ddfstrt; ddfstrt:Coord; 0094 148 UWORD ddfstop; ddfstop:Coord; 0096 150 UWORD dmacon; dmacon:DmafFlagsSet; 0098 152 UWORD ckxcon; clxcon:Collision Control Flag Set; 009A | 154 UWORD intena; intena:IntFlagSet; 009C 156 UWORD intreg; intreq:IntFlagSet; 009E 158 UWORD adkcon; adkcon: AdkFlagsSet; 00AO 160 struct AudChannel aud:Audio Channels { (* RECORD 0000 0 UWORD *ac_ptr; acptr- ADDRESS; 0004 4 UWORD ac_len; aclen:CARDINAL; 0006 6 UWORD ac_per; acper:CARDINAL; 0008 8 UWORD ac_vol; acvol:CARDINAL; 000A 10 UWORD ac_dat; acdat:CARDINAL; D0O0OC 12 UWORD ac_pad/2]; acpad: ARRAY [0..1] _ OFCARDINAL; 0010 16 } aud[4]; END; *) 00EO 224 APTR bplpt[6]; bplpt: ARRAY [0..5] OF ADDRESS; 00F8 248 UWORD pad7c[4]; pad7c:ARRAY [0..3] OF CARDINAL; 0100 256 UWORD bplconO; bplcon0:BPLC® Flag Set; | OMMe C (hardware/custom.h) Modula-2 (Hardware) UWORD bplcon]; bplcon1:CARDINAL; UWORD bplcon2; bplcon2:CARDINAL; UWORD padß83; pad83:CARDINAL; UWORD bplimod; bplimod:CARDINAL; UWORD bpl2mod; bpl2mod:CARDINAL; UWORD pad86[2]; pad86:ARRAY [0..1] OF CARDINAL; UWORD bpldat[6]; bpldat:ARRAY [0..5] OF CARDINAL; UWORD padßel2]; pad8e: ARRAY [0..1] OF CARDINAL; APTR sprpt[B8]; sprpt: ARRAY [0..7] OF ADDRESS; struct SpriteDef spr:Sprites { (* RECORD UWORD pos; pos:CARDINAL, UWORDB ct]; ctl:CARDINAL; UWORD dataa; data: LONGCARD; UWORD datab; datab:CARDINAL; } spr[8]; END; *) UWORD color[32]; color: ARRAY [0..31] OF CARDINAL; b END; Assembler Es sind nur die einzelnen Offsets definiert. Datenstrukturenreferenz Keine. Routinenreferenz Keine. Die Custom-Datenstruktur stellt nichts anderes als eine Aufzählung der Amiga-Hardware-Register auf den drei Spezialchips » Agnus«, »Denise« und »Paula« dar. Die Basisadresse des Registersatzes ist gleich 0x00DFF000 = 14675968. Die tatsächliche Registeradresse erhält man dementsprechend durch Addition des jeweiligen Offsets zur Basisadresse Ox0O0ODFFO00. In Modula-2 sind solche Umrechnungen aller- dings überflüssig, da hier im Modul Hardware bereits eine Variable custom vom Typ Custom ab der absoluten Adresse Ox00DFF00 deklariert ist. In »C« umgeht man die Rechnerei durch eine kleine Zeigermanipulation: struct Custom *custonm; custom = (Custom)* Ox0OODFFOOO; /* Zeiger auf Registersatz richten */ Die nachfolgenden Erläuterungen zu den einzelnen Hardware-Registern sind alle einheitlich aufgebaut. Zuerst wird der (englische) Originalname des Registers angegeben. Danach finden Sie Informationen bezüglich Lage und Zugriffsmodus des Registers, gefolgt von der eigentlichen Funktionserklärung. Die Bedeutungen der zur Lage- und Zugriffsmodus-Beschreibung verwendeten Abkürzungen sind leicht verständlich: A: »Agnus« D: »Denise« P: »Paula« ER: »early read« (DMA -Datentransfer ins RAM, der vor dem Lesezyklus des Prozessors stattfindet) R: »read access« (Lesezugriff) SW: _»strobe write« (Schreibzugriff auf eine Strobe-Adresse ohne echte Registerbits) W: »write access« (Schreibzugriff): Registerinhalt kann vom Copper nicht manipuliert werden. ” Registerinhalt kann vom Copper nur dann verändert werden, wenn das CDANG-Bit = Bit 1 von copcon gesetzt ist. Zwei allgemeine Hinweise bezüglich der Hardware-Register sind an dieser Stelle noch angebracht: (1) Der Amiga besitzt viele durch Namen der Form xxx bzw. xxxw und xxxr gekennzeichnete Registerpaare. Beide Register betreffen die gleiche Hardware-Funktion, wobei die xxxr-Register reine Statusregister mit ausschließlichem Lesezugriff und die xxxRegister die eigentlichen Setzregi- ster mit ausschließlichem Schreibzugriff sind. Im Rahmen der Funktionsbeschreibung solcher Registerpaare wird deshalb häufig auf das korrespondierende Schwesterregister verwiesen. (2) Die in Custom definierten DMA-Adreßzeiger haben momentan lediglich eine Adreßbreite von 19 Bit, was gerade den 512K = 2'°-Bit-Chip-RAM entspricht. Da von diesen 19 Bit das niederwertig- ste unveränderbar gleich null gesetzt ist, arbeiten die DMA-Operationen alle nur auf Wortgrenzen. Lediglich die Bits 1 bis 18 der DMA-Adreßzeiger sind somit überhaupt von Bedeutung und manipulierbar. 4 bitdDat 0x0000 (0) Name: »blitter destination data« Chip: A, Zugriff: ER - Funktion: Zwischenspeicherung der Zieldaten einer Blitter-Operation, bis sie tatsächlich ins RAM geschrieben werden. Auf die angegebene Dummy-Adresse kann der Prozessor nicht zugreifen. 1] dmaconr 0x0002 (2) Name: »DMA control (and blitter status) read« Chip: AP, Zugriff: R - Funktion: Statusregister zur Kontrolle sämtlicher DMA-Kanäle des Amiga und der DMA- Statusbits des Blitters. Für die einzelnen Bits des Registers gelten folgende Zuordnungen: Bedeutung SET/CLR _»set/clear control« (R/W) legt fest, ob das Schreiben einer 1 in ein Bit des Registers dieses löscht oder setzt. BBUSY »blitter busy« (R): Ist der Blitter gerade in Aktion? BZERO »blitter zero« (R): Ergab letzte Blitter-Operation eine Null? -/-11 =) BLTPRI »blitter DMA priority« (R/W): Hat Blitter Priorität vor CPU? DMAEN »DMA enable« (R/W): Ist überhaupt DMA eingeschaltet? BPLEN »bitplane enable« (R/W): Ist die Bitplane-DMA eingeschaltet? COPEN »copper enable« (R/W): Ist die Copper-DMA eingeschaltet? BLTEN »blitter enable« (R/W): Ist die Blitter--DMA eingeschaltet? SPREN »sprite enable« (R/W): Ist die Sprite-DMA eingeschaltet? DSKEN »disk enable« (R/W): Ist die Disk-DMA eingeschaltet? AUD3EN _»audio 3 enable« (R/W): Ist Audio-DMA Kanal 3 eingeschaltet? AUD2EN _»audio 2 enable« (R/W): Ist Audio-DMA Kanal ?2 eingeschaltet? AUDIEN »audio 1 enable« (R/W): Ist Audio-DMA Kanal 1 eingeschaltet? AUDOEN »audio O enable« (R/W): Ist Audio-DMA Kanal 0 eingeschaltet? vposr 0x0004 (4) Name: »vertical position (most significant bit & frame flop) read« Chip: A, Zugriff: R - Funktion: Statusregister für die vertikale Position des Elektronenstrahls oder eines Light- pens. Das Bit 0 dieses Registers stellt das Bit 8 (also V8) des Werts der vertikalen Position des Elektronenstrahls dar (siehe vhposr). Weiterhin ist dem Wert des Bits 15 LOF zu entnehmen, ob gerade ein »long frame« (LOF gesetzt) oder ein »short frame« (LOF gelöscht) dargestellt wird. vhposr 0x0006 (6) Name: »vertical and horizontal position read« Chip: A, Zugriff: R - Funktion: Statusregister für vertikale und horizontale Position des Beams oder eines Lightpens. Die Bits 0 bis 7 stellen die niederwertigen Bits HO-H7 der horizonta- len Position dar, die Bits 8 bis 15 entsprechend die niederwertigen Bits VO-V7 der vertikalen Position. Die Auflösung beträgt dabei 280 ns oder 1/160 der Monitor- breite. dskdatr 0x0008 (8) Name: »disk DMA data read« Chip: P, Zugriff: ER - Funktion: Dies ist der 2 Byte große Disk-DMA-Datenpuffer für gelesene oder noch zu schreibende Daten. joy0dat 0x000A (10) Name: »joystick/mouse O data« Chip: D, Zugriff: R - Funktion: Statusregister für die gesampelten Positionswerte des linken Maus- bzw. Joy- stick-Ports. I joyldat 0x000C (12) Name: »joystick/mouse 1 data« Chip: D, Zugriff: R - Funktion: Statusregister für die gesampelten Positionswerte des rechten Maus- bzw. Joy- stick-Ports. II clixdat 0x000E (14) Name: »collision data« Chip: D, Zugriff: R - Funktion: Statusregister der von der Hardware erkannten Kollisionen, dessen Inhalt bei jedem Lesezugriff automatisch auf null zurückgesetzt wird. Für die einzelnen Bits des Registers gelten folgende Zuordnungen (siehe auch cIxcon): Bedeutung n: Sprite 4 (oder 5) mit Sprite 6 (oder 7) kollidiert? Sprite 2 (oder 3) mit Sprite 6 (oder 7) kollidiert? Sprite 2 (oder 3) mit Sprite 4 (oder 5) kollidiert? Sprite 0 (oder 1) mit Sprite 6 (oder 7) kollidiert? Sprite 0 (oder 1) mit Sprite 4 (oder 5) kollidiert? Sprite 0 (oder 1) mit Sprite 2 (oder 3) kollidiert? Playfield 2 und Sprite 6 (oder 7) kollidiert? Playfield 2 und Sprite 4 (oder 5) kollidiert? Playfield 2 und Sprite 2 (oder 3) kollidiert? Playfield 2 und Sprite O (oder 1) kollidiert? Playfield 1 und Sprite 6 (oder 7) kollidiert? Playfield 1 und Sprite 4 (oder 5) kollidiert? Playfield 1 und Sprite 2 (oder 3) kollidiert? Playfield 1 und Sprite 1 (oder 0) kollidiert? Playfield 1 mit Playfield 2 kollidiert? I adkconr 0x0010 (16) Name: »audio and disk control read« Chip: P, Zugriff: R * Funktion: Statusregister zur Steuerung der Funktionsweise des Disk-Controllers und der vier Audio-Kanäle. Für die einzelnen Bits des Registers gelten folgende Zuord- nungen: Name Bedeutung SET/CLR _»set/clear control« (R/W) legt fest, ob das Schreiben einer 1 in ein Bit des Registers dieses löscht oder setzt. PRECOMPI Der binäre Wert der beiden PRECOMPx-Bits legt die Schreib- PRECOMPO vorkompensation für den Disk I/O fest: 00 = keine, Ol = 140 ns, 10 = 280 ns, 11=560 ns Bedeutung 12 MFMPREC _ gesetzt = MFM Schreibvorkompensation, gelöscht = GCR Schreibvorkom- pensation 1l UARTBRK Das Setzen dieses Bits löst einen UART-Interrupt aus. WORDSYNC Ist die Disketten-Lesesynchronisation mit dem disksync-Wert eingeschaltet? MSBSYNC _ Ist die Disketten-Lesesynchronisation für das Apple GCR- Format (höchst- wertiges Bit 7 immer gesetzt!) eingeschaltet? FAST gesetzt = 2 us Taktzeit für Bit-Zellen auf Diskette (MFM), gelöscht = 4 us Taktzeit für Bit-Zellen auf Diskette (GCR) USE3PN Audio-Kanal 3 zur Frequenzmodulation von nichts? USE2P3 Audio-Kanal 2 zur Frequenzmodulation von Audio-Kanal 3? USEIP2 Audio-Kanal 1 zur Frequenzmodulation von Audio-Kanal 2? USEOPI1 Audio-Kanal 0 zur Frequenzmodulation von Audio-Kanal 1? USE3VN Wie USE3PN, aber für Lautstärkenodulation. USE2V3 Wie USE?2P3, aber für Lautstärkenodulation. USE1V2 Wie USEI1P2, aber für Lautstärkenodulation. USEOVI1 Wie USEOPI, aber für Lautstärkenodulation. I pot0dat 0x0012 (18) Name: »potentiometer counter data left pair« Chip: P, Zugriff: R * Funktion: Dieses Zählregister enthält die aktuellen Potentiometerwerte des linken Maus- bzw. Joystick-Ports. Das niederwertige Byte stellt dabei die x-Koordinate, das höherwertige dagegen die y-Koordinate dar. Gestoppt wird der Horizontalzähler durch ein Signal an Pin 32 (POTOX) von Paula und der Vertikalzähler durch ein Signal an Pin 33 (POTOY). 1 potlidat 0x0014 (20) Name: »potentiometer counter data right pair« Chip: P, Zugriff: R* Funktion: Dieses Zählregister enthält die aktuellen Potentiometerwerte des rechten Maus- bzw. Joystick-Ports. Das niederwertige Byte stellt dabei die x-Koordinate, das höherwertige dagegen die y-Koordinate dar. Gestoppt wird der Horizontalzähler durch ein Signal an Pin 35 (POTI1X) von Paula und der Vertikalzähler durch ein Signal an Pin 36 (POTIY). U potinp 0x0016 (22) Name: »potentiometer port data read« (POTGOR) Chip: P, Zugriff: R * Funktion: Statusregister zur Kontrolle eines 4 Bit breiten bidirektionalen I/O-Ports, der die gleichen vier Pins von Paula benutzt wie die Potentiometerzähler potOdat und potldat. Für die einzelnen Bits des Registers gelten folgende Zuordnungen: Bedeutung gesetzt = Ausgabe an Pin 36, gelöscht = Eingabe an Pin 36 Das gelesene bzw. auszugebende Datenbit für Pin 36. gesetzt = Ausgabe an Pin 35, gelöscht = Eingabe an Pin 35 Das gelesene bzw. auszugebende Datenbit für Pin 35. gesetzt = Ausgabe an Pin 33, gelöscht = Eingabe an Pin 33 Das gelesene bzw. auszugebende Datenbit für Pin 33. gesetzt = Ausgabe an Pin 32, gelöscht = Eingabe an Pin 32 Das gelesene bzw. auszugebende Datenbit für Pin 32. Ein Identifikationscode des Chips, der momentan gleich 0 ist. Initialisiere und starte die Potentiometerzähler. I serdatr 0x0018 (24) Name: Chip: Funktion: »serial port data and status read« P, Zugriff: R * Aus diesem Register liest man die Datenbits vom Empfangspuffer der seriellen Schnittstelle sowie deren aktuellen Status ein. Für die einzelnen Bits des Regi- sters gelten folgende Zuordnungen: Bedeutung Ist serielle Schnittstelle beim Empfang nicht mehr mitgekommen? Ist der Empfangspuffer der seriellen Schnittstelle voll? Ist der Sendepuffer der seriellen Schnittstelle leer? Ist das Sende-Schieberegister der seriellen Schnittstelle leer? Empfängt der RXD-Pin serielle UART-Daten, die vom Prozessor direkt getestet werden müssen? Stopbit Datenbit oder Stopbit (falls lang) Insgesamt acht Datenbits DB7 bis DBO. I dskbytr 0x001A (26) Name: Chip: Funktion: »disk data byte and status read« P, Zugriff: R * Datenpuffer und Statusregister für den Datentransfer zwischen Diskette und RAM durch den Disketten-Controller. Der Datentransfer erfolgt dabei byte- orientiert, immer schön ein Byte nach dem anderen. Das »ready«-Statusbit 15 wird nach jedem Lesezugriff auf das Register automatisch zurückgesetzt. Für die einzelnen Bits des Registers gelten folgende Zuordnungen: Name DSKBYT DMAON DISKWRITE Bedeutung Kann das nächste übertragene Datenbyte gelesen werden? Logische UND-Verknüpfung des DMAEN-Bits = Bit 15 von dsklen mit dem DMAEN-Bit = Bit 9 von dmacon. Kopie des WRITE-Bits = Bit 14 von dsklen. WORDEQUAL Solange das von Diskette gelesene Datenbyte gleich dem Wert von dsksync ist, bleibt dieses Bit gesetzt. Insgesamt 8 Bits für das eigentliche Datenbyte. II intenar 0x001C (28) Name: Chip: Funktion: »interrupt enable bits read« P, Zugriff: R * Statusregister zur Verwaltung erlaubter und verbotener Interrupts. Erst das Setzen der entsprechenden Bits in dem zu diesem Statusregister gehörigen Setzregisters intena macht Interrupts der angegebenen Art möglich. Für die einzelnen Bits des Registers gelten folgende Zuordnungen: Bedeutung Bit Name SET/CLR INTEN 13 EXTER 12 DSKSYN 11 RBF 10 AUD3 09 AUD2 08 AUDI 07 AUDO 06 BLIT 05 VERTB 04 COPER 03 PORTS 02 SOFT 01 DSKBLK 00 TBE »set/clear control« (R/W) legt fest, ob das Schreiben einer 1 in ein Bit des Registers dieses löscht oder setzt. »master interrupt«: Sind Interrupts überhaupt erlaubt? Das Löschen dieses Bits desaktiviert sämtliche Interrupts. Externer Interrupt an Systempin INT6* liegt an. Wert in dsksyn ist gleich dskbytr-Datenbyte: DSKSYN-Interrupt. Empfangspuffer der seriellen Schnittstelle voll: RBF-Interrupt Audio-Kanal 3 ist fertig: Audio-Interrupt Nr.3 Audio-Kanal 2 ist fertig: Audio-Interrupt Nr.2 Audio-Kanal 1 ist fertig: Audio-Interrupt Nr. | Audio-Kanal 0 ist fertig: Audio-Interrupt Nr.O Der Blitter ist fertig: Blitter-Interrupt. Beginn des »vertical blanking«-Intervalls: VERTB-Interrupt. Ein vom Copper explizit ausgelöster Copper-Interrupt. Externer Interrupt von Ports oder Timer an Systempin INT2*. Ein von einem Programm ausgelöster Software-Interrupt. Die letzte Disk-DMA-Anfrage ist fertig: DSKBLK-Interrupt. Sendepuffer der seriellen Schnittstelle leer: TBE-Interrupt. intreqr 0x001E (30) Name: »interrupt request bits read« Chip: P, Zugriff: R* Funktion: Statusregister für Interrupt-Anforderungen, die von der CPU abgefragt werden (können). Nur wenn im intenar-Register die entsprechenden Interrupts aktiviert sind, ist die Auslösung des angeforderten Interrupts möglich. Für die einzelnen Bits des Registers gelten dieselben Zuordnungen wie beim »intenar«-Register. dskpt 0x0020 (32) Name: »disk pointer« Chip: A, Zugriff: W Funktion: DMA-Adreßzeiger für die Disk-DMA, der vom Copper oder der CPU vor der DMA-Aktivierung korrekt initialisiert werden muß. dskLen 0x0024 (36) Name: »disk length« Chip: P, Zugriff: W Funktion: Der Wert dieses Registers gibt die Länge des durch die Disk-DMA zu übertra- genden Datenblocks in Datenworten an und enthält darüber hinaus noch zwei DMA-Kontrollbits. Bei der tatsächlichen Durchführung des DMA-Auftrags wird der Längenwert so lange dekrementiert, bis er gleich null ist. Daraufhin erfolgt dann ein DSKBLK-Interrupt (siehe intenar). Für die einzelnen Bits des Registers gelten folgende Zuordnungen: Bedeutung 15 DMAEN »disk DMA enable«: Ist Disk-DMA überhaupt zu aktivieren? 14 WRITE gesetzt = Schreibmodus (Datentransfer vom RAM auf Diskette) gelöscht = Lesemodus (Datentransfer von Diskette ins RAM) 13 LENGTH Die Länge des durch Disk-DMA zu übertragenden Datenblocks 00 in Datenworten. dskdat 0x0026 (38) Name: »disk DMA data write« Chip: P, Zugriff: W Funktion: Siehe dskdatar. refptr 0x0028 (40) Name: »refresh pointer« Chip: A, Zugriff: (W) Funktion: Adreßgenerator (in Form eines Zählers) für die dynamische RAM-Auffrischung (engl. »refresh«). Das Register ist nur aus Testgründen beschreibbar, es sollte jedoch niemals von der CPU beschrieben werden! vposw 0x002A (42) Name: »vertical position (most significant bit&frame flop) write« Chip: A, Zugriff: W Funktion: Siehe vposr. I vhposw 0x002C (44) Name: . »vertical and horizontal position write« Chip: A, Zugriff: W Funktion: Siehe vhposr. II copcon 0x002E (46) Name: »copper control register« Chip: A, Zugriff: W Funktion: Der Wert dieses 1-Bit-Registers entscheidet darüber, ob der Copper auf die mit * gekennzeichneten Blitter-Register zugreifen kann oder nicht. Für das einzige Bit des Registers gilt folgende Zuordnung: Bedeutung »copper danger mode«: Nur wenn dieses Bit gesetzt ist, kann der Copper die Blitter-Hardware direkt manipulieren. serdat 0x0030 (48) Ä Name: »serial port data and stop bits write« Chip: P, Zugriff: W Funktion: Ausgaberegister für Datenbytes via serieller Schnittstelle (siehe auch serdatr). Die höherwertigen Bits 10 bis 15 des geschriebenen Werts sollten immer gleich null sein. Das explizit anzugebende Stopbit an Bitposition 9 oder 8 legt die tatsächliche Länge des (überlangen) Ausgabebytes fest. Die eigentlichen Daten- bits befinden sich in den Bits O bis 7 (oder 8). serper 0x0032 (50) Name: »serial port period and control« Chip: P, Zugriff: W Funktion: Kontrollregister für die Sende- und Empfangs-Baudrate sowie die Länge der empfangenen Datenbytes der seriellen Schnittstelle. Für die einzelnen Bits des Registers gelten folgende Zuordnungen: Bit Name Bedeutung 15 LONG gesetzt = Empfang überlanger 9-Bit-Datenbyte gelöscht = Empfang normaler 8-Bit-Datenbyte 14 e RATE Diese 15 Bit lange Ganzzahl gibt die Baudrate der Übertragung an: 00 Baudrate = (RATE+1)*0.0002794 [Baud] I potgo 0x0034 (52) Name: »potentiometer port data write and start« Chip: P, Zugriff: W Funktion: Kontrollregister für die 4 Bit breiten bidirektionalen /O-Ports von Paula. Die Bedeutung der einzelnen Bits des Registers sind unter potinp erklärt. joytest 0x0036 (54) Name: _ »mouse/joystick port counters test« Chip: D, Zugriff: W Funktion: Nach dem Schreibzugriff auf das Register werden alle vier Maus- bzw. Joystick- Positionszähler der Register potOdat und potldat gleichzeitig mit dem hier ein- getragenen Wert initialisiert. strequ 0x0038 (56) Name: »strobe for horizontal synchronization with VB and EQU« Chip: D, Zugriff: SW Funktion: Aktivierung der horizontalen Synchronisation der Zieladresse mit »vertical blanking« und EQU(???). strvbl 0x003A (58) Name: »strobe for horizontal synchronization with vertical blank« Chip: D, Zugriff: SW Funktion: Aktivierung der horizontalen Synchronisation der Zieladresse mit »vertical blanking«. strhor 0x003C (60) Name: »strobe for horizontal synchronization« Chip: DP, Zugriff: SW Funktion: Aktivierung der horizontalen Synchronisation Zieladresse. strlong 0x003E (62) Name: »strobe for identification of long horizontal line« Chip: D, Zugriff: SW Funktion: Identifikation langer Zeilen. bltconO 0x0040 (64) Name: »blitter control register O«Chip: A, Zugriff: W Funktion: Zusammenmitbltconl dient dieses Kontrollregister der vollständigen Steuerung des Blitters. Das LINE-Bit (Bit 0) von bltcon1 legt den grundsätzlichen Arbeits- modus fest (Flächen oder Linien). Für die einzelnen Bits des Registers gelten folgende Zuordnungen: Bedeutung im »Flächenmodus« (LINE-Bit = 0) Versatz für Quelle A (ASHO in Bit 12, ASH3 in Bit 15) Soll Quelle A überhaupt benutzt werden? Soll Quelle B überhaupt benutzt werden? Soll Quelle C überhaupt benutzt werden? Soll Zielbereich D überhaupt benutzt werden? Der Mintermwert zur Auswahl der während der Blitter-Operation vorzunehmenden logischen Verknüpfung der Quelldatenbits. Bedeutung im »Linienmodus« (LINE-Bit = 1) Horizontalversatz des Startpunkts der Linie (STARTI in Bit 12, START? in Bit 15) Der Mintermwert sollte mit Ox4A = 74 zur Auswahl der logischen Verknüpfung D := AC+ABC initialisiert werden. bltcon1 0x0042 (66) Name: Chip: Funktion: Bit Name 15 ” BSH 11 -/- ” -/- 05° -/- 04 EFE 03 IFE 02 FCI 01 DESC 00 0 »blitter control register 1« A, Zugriff: W Zusammen mit bltconO dient dieses Kontrollregister der vollständigen Steuerung des Blitters. Das LINE-Bit (Bit 0) von bltcon1 legt den grundsätzlichen Arbeits- modus fest (Flächen oder Linien). Für die einzelnen Bits des Registers gelten folgende Zuordnungen: Bedeutung im »Flächenmodus« (LINE-Bit = 0) Versatz für Quelle B (BSHO in Bit 12, BSH3 in Bit 15)12 Ist im exklusiven Füllmodus zu arbeiten? Ist im inklusiven (normalen!) Füllmodus zu arbeiten? Dieses Füllbit wird bei jeder 1 im Quellbereich getoggelt. gesetzt = absteigender Adreßmodus (bitxpt werden dekrementiert) gelöscht = zunehmender' Adreßmodus (bltxpt werden inkrementiert) Flächenmodus eingeschaltet TEXTURE Bedeutung im »Linienmodus« (LINE-Bit = 1) Versatz für Musterung der Linie, gemessen ab Startbit (TEXTUREO in Bit 12, TEXTURES in Bit 15) Bedeutung im »Linienmodus« (LINE-Bit = 1) TEXTURE Versatz für Musterung der Linie, gemessen ab Startbit (TEXTUREIO in Bit 12, TEXTURB3 in Bit 15) Vorzeichenflags »sometimes up or down« »sometimes up or left« »always up or left« »single bit line«: Ein besonderer Zeichenmodus für Linien, die für das automatische Flächenfüllen durch den Blitter benötigt werden. Diese Linien sind überall genau einen Pixel breit. Linienmodus eingeschaltet Zusatzbemerkung: Die 3 Bits AUL, SUL und SUD legen den Oktanten fürs Zeichnen im Linienmodus gemäß der folgenden Zuordnungstabelle fest: a ED ee ID SION PP wDnD oO oO ee DD oO OO km m m Der Linienmodus des Blitters: Im Linienmodus ändert sich die Bedeutung mehrerer Blitter-Register gemäß der folgenden Belegungstabelle: Register Bits Bitname Wert Bedeutung im Linienmodus (LINE-Bit = 1) bltconO 15-12 START Horizontalversatz für Linienstartpunkt 11-08 USE 1011 (fürs Zeichnen von Linien vorgegeben!) bltconl 15-12 BSH Versatz des Linienmusters 5 Reserviert für den Systemgebrauch! 04-02 Codewert zur Auswahl des Oktanten (s.o.) 1 Kontrollbit für den 1-Pixel-Linienmodus Register Bitname Wert Bedeutung im Linienmodus (LINE-Bit = 1) LINE 1 Aktivierungsbit für Linienmodus bltadat 0x8000 Fürs Linienzeichnen benötigter Indexwert bitbdat Linienmuster fürs Zeichnen bitsize Länge der Linie in Pixeln (max. 1024) (fürs Zeichnen von Linien vorgegeben!) bltamod (dto.) bltbmod (dto.) bltbmod Breite des Basis-Displayelements bltbmod Breite des Basis-Displayelements bltapt (fürs Zeichnen von Linien vorgegeben!) bltapt Adresse des Startpunkts der Linie bltapt Adresse des Startpunkts der Linie (Hierbei stellt X die Breite und Y die Höhe des kleinsten Rechtecks dar, das die Linie gerade noch umfaßt!) I bitafwm 0x0044 (68) Name: »blitter first word mask for source A« Chip: A, Zugriff: