@DATABASE XOpa.guide @NODE main @TITLE XOpa-documentation @{b}XOpa 1.94-documentation @{ub} This is the XOpa-documentation for Version 1.94 (22.7.1998) It consists of the following chapters: I. @{" Introduction " LINK Einführung} II. @{" Shareware & Copyright " LINK share} III. @{" Installation " LINK Install} IV. @{" Menus " LINK Menus} V. @{" Display bar " LINK Anzeige} (partly German) VI. @{" Function gadgets " LINK Funks} (still German) VII. @{" ToolTypes " LINK ToolTypes} (still German) VIII. @{" Structure mode " LINK Struktur} (still German) IX. @{" Short summary " LINK kurz} (still German) X. @{" About the program " LINK Über} (still German) XI. @{" Known bugs " LINK bugs} (still German) XII. @{" The Authors " LINK authors} Latest change of this document: 22.7.98 ©1994-1998 by Axel Dörfler and Alexander Bartz. If you are interested in a completed english version, please contact Alexander Bartz as he is responsible for this. @ENDNODE @NODE Einführung @TITLE "XOpa-documentation: introduction" @{b}I. Introduction of XOpa@{ub} XOpa can be seen as a system monitor. It makes the intern information of the Amiga visible for the user. It is furthermore possible to manipulate this informations. This manipulation can be dangerous because it may cause a software failure if you delete objects which are still used by other programs. XOpa is very necessary if you need to close screens or windows which are left open by (self-written?) programs. It is also possible to terminate programs with XOpa. The program needs at least AmigaOS 2.0 and supports lots of features of the latest OS versions (white menu backgrounds, ASL-screenmode-requester, ...). XOpa is font-sensitive which means that it is using the system font without problems. XOpa has got nearly all functions of similar programs. With the user friendly interface and the mighty structure mode it provides at least two huge features that other programs don`t have. With the structure mode it is possible to surf throug the intern structures. The available number of structures can be increased with the help of an extern file called "XOpa.structs". This file should be placed in the same drawer as the main program. I should explain one word that is used more than once in this text. By the word "object" normally an entry of the list is ment. This can be a screen, a task or something like that. This guide should also be placed in the same directory as XOpa. @ENDNODE @NODE Share @TITLE "XOpa-documentation: shareware and copyright" @{b}II. shareware and copyright@{ub} XOpa is shareware. If you use it and like it and you would like to have a fully functionally version please send us a shareware fee of 20 DM. The unregistered version of XOpa is unable to read the file "XOpa.structs" so that the @{"structur mode" LINK Struktur} only knows the implemented structures. This version of XOpa is freely distributable on condition that · the following files are included: - XOpa and its icon - XOpa.guide - XOpa-Installation · the price of XOpa is not higher than 5 DM or an equal amount in a different currency. If you want to get the registered Version of the program and you`re a lucky owner of a printer please use the program "XOpa-Registration". There you get all further information. If you don`t have a printer you can find our addresses in the registration-program. Only a few days after we received your letter we`ll send you the latest and unrestricted Version of the program, the source code (Pascal) and the file "XOpa.structs". If you want XOpa to be expanded just tell us and if it isn`t too extensive we`ll send you an expanded version. After you became a registered user of XOpa you can get two free updates. To get an update to a later version of XOpa just send us a self-addressed envelop with lots of stamps on it. These updates will be free. You`re not allowed to give your registered version to anyone else! The included indentiy-library is copyrighted by Richard Körber. Please address your letters to: Alexander Bartz Axel Dörfler Langenkamp 57 Heerstraße 53 49082 Osnabrück 49492 Westerkappeln Germany Germany EMail: 0541572992-1@T-Online.de axeld@ax.Wetfalen.de @ENDNODE @NODE Install @TITLE "XOpa-documentation: installation" @{b}III. Installation of XOpa@{ub} Installing XOpa on your hard-disk is very simple: just doubleclick on "XOpa-Intallation". The Commodore-Installer will be started and will do the rest for you. If you don`t want to use the "Installer" just copy the following files in one directory: · XOpa · XOpa.guide · XOpa.structs The "amigaguide.library" must be placed either in "LIBS:" or in the Kickstart-ROM if you want to use the online help of XOpa. The identify.library (by Richard Körber) has to be in LIBS: or in the same drawer as XOpa. @ENDNODE @NODE Menus @TITLE "XOpa-documentation: menus" @{b}IV. Menus@{ub} Here`s an general view over the XOpa menus: @{b}Project-Menu@{ub} @{"Iconify (I)" LINK Men00} @{"About (?)" LINK Men01} @{"Quit (Q)" LINK Men02} @{b}Options-Menu@{ub} @{"Flush memory " LINK Men10} @{"Print current list " LINK Men11} @{"Save list... " LINK Men12} @{"Speed-test... " LINK Men13} ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @{"Task&Window-Relations " LINK Men15} @{"Security check " LINK Men16} @{"Sort list " LINK Men17} @{b}Structure-Menu@{ub} @{"Other structure (O)" LINK Men20} @{"Node-structure " LINK Men21} ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @{"Rescan (R)" LINK Men23} @{"Back (B)" LINK Men24} @{b}Display-Menu@{ub} You find informations about the items in the @{"display-modes" link anzeige} chapter. @{b}Help-Menu@{ub} This menu only appears if the "amigaguide.library" is correctly installed. @{"Genaral (H)" LINK Men40} @{"Quick overview (K)" LINK Men41} @{"Current list (Help)" LINK Men42} @ENDNODE @NODE Men00 @TITLE "XOpa-documentation: project-menu" @{b}Iconify@{ub} This function closes the main-window and displays an icon on the workbench-screen. If you doubleklick on this icon the XOpa window will appear immediatly. If you want XOpa to be started iconified you can do that with the help of the @{"ToolTypes" LINK ToolTypes}. @ENDNODE @NODE Men01 @TITLE "XOpa-documentation: project-menu" @{b}About@{ub} This displays a very very informative text in the XOpa window. It`s about the same text you see everytime you start the program. @ENDNODE @NODE Men02 @TITLE "XOpa-documentation: project-menu" @{b}Quit@{ub} This is the worst function of XOpa: it quits the program. (what else?!?) There`s no nasty requester that asks you if you really want to quit the program, because we think it is absolutely senceless. @ENDNODE @NODE Men10 @TITLE "XOpa-documentation: options-menu" @{b}Flush memory@{ub} This function forces the operating system to remove unused objects that are still in memory. Theese objects can be libraries, fonts or things like that. @ENDNODE @NODE Men11 @TITLE "XOpa-documentation: options-menu" @{b}Print current list@{ub} If you have a printer connected to your Amiga you can print the curent list with the help of this function. @ENDNODE @NODE Men12 @TITLE "XOpa-documentation: options-menu" @{b}Save list...@{ub} This function gives you the possibility to save the display in a file you have chosen. @ENDNODE @NODE Men13 @TITLE "XOpa-documentation: options-menu" @{b}Speed-test...@{ub} The results of the XOpa speed-tests are not comparable with the results of other programs. After you have selected this menu-item, a requester will appear on your screen. Now you have the possibility to select all tests that should be made. Comparison with other computers and the.........................................................................pentium-pc Amiga 4000/030 Amiga 2000C Amiga 4000/030 Pentium-PC* (DBLPal) (Pal) (Cybervision64) ---------------------------------------------------------------------- Pixel: 25842.7 2765.7 57163.3 19.5 Kreise: 123.9 13.0 4251.5 1.4 OpenWindow: 33.4 7.9 37.6 0.1 Fast-Ram: 17.705 3.053 17.804 0.031 @ENDNODE @NODE Men15 @TITLE "XOpa-documentation: optiones-menu" @{b}Task&Window-Relations@{ub} If this function is activated (see also: @{"ToolTypes" LINK ToolTypes}), the program tries to close all windows of a task if you remove a task. @ENDNODE @NODE Men16 @TITLE "XOpa-documentation: options-menu" @{b}Security check@{ub} This function allows you to turn the nasty(?) security checks on and off. See also: @{"ToolTypes" LINK ToolTypes}. @ENDNODE @NODE Men17 @TITLE "XOpa-documentation: options-menu" @{b}sort list@{ub} After selecting this option some lists will be sorted in alphabetical order. See also: @{"ToolTypes" LINK ToolTypes}. @ENDNODE @NODE Men20 @TITLE "XOpa-documentation: structure-menu" @{b}Other structure@{ub} After selecting this item you can select an different structure for the current address. In this window you also have the possibility to change the current address. In the listview-gadget you can choose the structure to be displayed. If don`t select an entry the memory will be shown in the form of the XOpa- memory-viewer. @ENDNODE @NODE Men21 @TITLE "XOpa-documentation: Structure-menu" @{b}Node-Structure@{ub} If, in @{"structuremode" LINK Struktur}, you select an Entry called Node it is not clear what structure XOpa has to show. So, in this window you can select what structure should be shown for the different Node-Types. @ENDNODE @NODE Men23 @TITLE "XOpa-documentation: Structure-Menu" @{b}Rescan{ub} This menuitem can only be used in @{"structuremode" LINK Struktur}. The displayed structure will be read out again (rescanned). @ENDNODE @NODE Men24 @TITLE "XOpa-documentation: Structure-Menu" @{b}Back@{ub} This menuitem can only be used in @{"structuremode" LINK Struktur}. If possible, the previous shown structure will be shown. It`s the same function as @{"Back" LINK Funk8} of the function bar in the main window. @ENDNODE @NODE Men40 @TITLE "XOpa-documentation: Help-Menu" @{b}General@{ub} After selection of this item this AmigaGuide will be opened at @{"mainmenu" LINK Main}. @ENDNODE @NODE Men41 @TITLE "XOpa-documentation: Help-Menu" @{b}Quick overview@{ub} This item displays the chapter @{"Quick overview" LINK kurz} of this AmigaGuide. @ENDNODE @NODE Men42 @TITLE "XOpa-documentation: Help-Menu" @{b}Current List@{ub} When you choose this item, XOpa atempts to show a chapter of the documentation that has something to do with the current @{"displaymode" LINK Anzeige}. The same happens if you press the help-key. @ENDNODE @NODE Anzeige @TITLE "XOpa-documentation: Displaybar" @{b}V. Displaybar@{ub} Here you will find explanations about all display-modes that can be activated by the use of gadgets or the menu. You should find all informations shown in these modes. Currently, there are the following modes: (Sorry, most of them are still in German) @{"Tasks" LINK Anz1} @{"Screens" LINK Anz2} @{"Ports" LINK Anz3} @{"Libraries" LINK Anz4} @{"Resources" LINK Anz5} @{"Devices" LINK Anz6} @{"System" LINK Anz7} @{"Interrupts" LINK Anz8} @{"Assigns" LINK Anz9} @{"Residents" LINK Anz10} @{"Fonts" LINK Anz11} @{"Struktur" LINK Anz12} -- @{"Locks" LINK Anz16} @{"Volumes" LINK Anz17} @{"Monitors" LINK Anz18} @{"Classes" LINK Anz19} @{"Catalogs" LINK Anz20} @ENDNODE @NODE Anz1 @TITLE "XOpa-documentation: Display Modes" @{b}Tasks@{ub} In this mode all running tasks and processes (Programs) will be displayed. Every Program running in the system consists at least of one task or process. The following informations will be displayed: · Address - The address of the task · Pri - The priority. See also @{"«priority»" LINK Funk4} · Stack - The tasks memory used for variables · Signals - Signals used by the task · State - Shows the current state of the task. For example run, wait, frozen (See also @{"Freeze" LINK Funk6}), ... · Code - Some attributes of the task · Type - Task or Process. A process is a program runnig from DOS · Name - Name of the Task. If the task was run from the shell also the process-number will be shown After a doubleclick on the entry further information will appear. This mode supports the following functions: @{"Remove" LINK Funk2}, @{"Signal" LINK Funk3}, @{"Priority" LINK Funk4}, @{"Freeze" LINK Funk6} und @{"Window" LINK Anz14} @ENDNODE @NODE Anz2 @TITLE "XOpa-documentation: Display Modes" @{b}Screens@{ub} In this mode all opened screens will be listed. The following informations will be listed: · Address - Address of the screen · Pos(x,y) - Shows the monitor-relative position of the screen · Size(x,y) - Width and height of the screen · Dep - Screen`s color-depth (for example 2 for 4 colors) · Mode - Shows the ModeID (exists since OS2.0). Further information will come with a doubleclick · Type - At the moment there are three different types of screens: - "wbench" stands for the workbench-screen - "public" this is a screen where any program can open a window - "custom" is the private Screen of one program · Titel - Hmmm... I think it`s the screen`s current title After a doubleclick on the entry further information will appear. This mode supports the following functions: @{"Add" LINK Funk1}, @{"Close" LINK Funk5} und @{"Window" LINK Anz14} @ENDNODE @NODE Anz3 @TITLE "XOpa-documentation: Display Modes" @{b}Ports@{ub} In this mode the system`s list of ports will be displayed. The following information will be listed: · Address - Address of the port · Pri - Priority of the port. See also @{"«Priority»" LINK Funk4} · Flags - Some attributes of the port will be displayed here, normally the of message to be received. · SBit - The signalbit set for the Wait() function · Type - Not really needful. It is always "mgport" · Portname - This is the real name of the port · Taskname - The name of the task to which the port belongs After a doubleclick on an entry the @{"Strukturemode" LINK Struktur} will be activated. A MsgPort-Structure with the address of the port will be shown. This mode supports the following functions: @{"Remove" LINK Funk2} und @{"Priority" LINK Funk4} @ENDNODE @NODE Anz4 @TITLE "XOpa-documentation: Display Modes" @{b}Libraries@{ub} In this mode you can see all opened libraries The following informations will be listed: · Address - Address of the library · Pri - Priority of the library. See also @{"«Priority»" LINK Funk4} · Version - The library`s version - what else? · OpenC - This value shows how often programs have opened the library. If it`s 0 the library can be removed from the system. · Neg - The size of the libraries offset range · Pos - Amount of bytes after the library structure · Typ - In this case maybe "library" ?!? · Name - The libraries name After a doubleclick on an entry the @{"Strukturemode" LINK Struktur} will be activated. A Library-Structure with the address of the Library will be shown. This mode supports the following functions: @{"Remove" LINK Funk2} und @{"Priority" LINK Funk4} @ENDNODE @NODE Anz5 @TITLE "XOpa-documentation: Display Modes" @{b}Resources@{ub} In this mode the system`s recource will be listed. Theese regulate the low level access to parts of the amiga hardware. The following informations will be listed. · Address - Address of the resources · Pri - Priority of the resources. See also @{"«Priority»" LINK Funk4} · Version - The Version of the resources. What else? · OpenC - This value shows how often programs have opened the resource. If it`s 0 the resource can be removed from the system. · Neg - The size of the resources offset range · Pos - Amount of bytes after the resource structure · Typ - In this case maybe "resource" ?!? · Name - The resources name After a doubleclick on an entry the @{"Strukturemode" LINK Struktur} will be activated and the structure chosen in @{"«Node-Structures»" LINK Men21} will be shown. The following functions are supported: @{"Remove" LINK Funk2} und @{"Priority" LINK Funk4} @ENDNODE @NODE Anz6 @TITLE "XOpa-Documentation: Display Modes" @{b}Devices@{ub} Bei diesem Modus wird eine Liste aller Devices im System dargestellt. Devices regeln den High-Level-Zugriff auf Teile der Amiga-Hardware. Dabei werden die folgenden Informationen dargestellt: · Adresse - Adresse des Devices im System · Pri - Priorität des Devices. Siehe auch @{"«Priorität»" LINK Funk4} · Version - Die Version des Devices. Was auch sonst? · OpenC - Dieser Wert besagt, wie oft das Device von Programmen aus geöffnet wurde. Wenn dieser Wert 0 ist, heißt das, das das Device aus dem System entfernt werden kann. · Neg - die Größe des Offset-Bereichs des Devices mit den Sprungadressen für die internen Befehle · Pos - Anzahl der Bytes nach der Library-Struktur · Typ - In diesem Fall wohl "device" · Name - Der Name des Devices Bei einem Doppelklick auf einen Eintrag wird in den Strukturmodus ge- schaltet und eine Device-Struktur mit der Adresse Eintrages angezeigt. Dieser Modus unterstützt die folgenden Funktionen: @{"Remove" LINK Funk2} und @{"Priority" LINK Funk4} @ENDNODE @NODE Anz7 @TITLE "XOpa-Documentation: Display Modes" @{b}System@{ub} In diesem Modus werden verschiedene Daten dargestellt. Hier steht welchen Prozessor Ihr Computer eingebaut hat, ob Sie einen mathe- matischen Co-Prozessor besitzen, welches Chipset Sie haben, die ver- schiedenen Versionen Ihres Betribssystems, welche Prozessorcaches aktiviert sind und, falls der Rechner bereits eine Guru-Meldung zeigen mußte (Absturz), steht hier die zuletzt angezeigte. Ein einfacher MMU-Test zeigt, ob das System mit einem solchen Prozessor ausgerüstet ist. Falls die MMU des Prozessors deaktiviert ist (z.B. beim MC68EC030), könnte es trotzdem sein, daß das Vorhanden- sein einer solchen festgestellt wird. Ist das der Fall, ist die MMU zumindest eingeschränkt funktionsfähig. Außerdem finden Sie hier eine Liste der Speicherblöcke und eine Liste der Systemerweiterungen. Eine Systemerweiterung ist z.B. eine Turbokarte oder ein SCSI-Host- Adapter, solange die Karte in einem der ZORRO-Erweiterungsschächte steckt. Ein Speicherblock ist z.B. bei einem Standard-A4000 2MB-Chip-RAM. In dieser Liste werden die folgenden Informationen dargestellt: · Adresse - Die Adresse des Speicherblock-Eintrages im Speicher · Pri - Priorität des Speichers. Siehe auch @{"«Priorität»" LINK Funk4} · Lower - Untere Adresse des Speicherblockes · Upper - Die obere Adresse · Größe - Die Größe des Speicherblockes (Upper-Lower) · Frei - freier Speicher des Speicherblockes · Name - Name des Speichers, z.B. "chip memory" In der Liste der Systemerweiterungen werden folgende Informationen angezeigt: · Adresse - Adresse der Erweiterungskarte (Board) · Größe - Auf der Karte vorhandener Speicher · Bus - der unterstützte Bustyp (Zorro-Slots) · Produkt - hier wird eine Angabe gemacht, um was für eine Karte es sich handeln könnte (z.B. RAM) bzw. mittels der Herstellerdefinitionsdatei "XOpa.boards" um welches Produkt es sich handelt (z.B. Nexus SCSI-Hostadpt.) · Typ - jede Karte bekommt eine Typ-Kennung vom Hersteller · Flags - Eigenschaften der Karte · Hersteller- jeder Hersteller bekommt von Commodore ein bestimmte Nummer, diese wird, wenn möglich mit dem Namen des Herstellers ausgegeben Bei der Liste der Speicherblöcke (und nur da) ist es möglich die Priorität eines Eintrages zu ändern, nachdem Sie ihn in der Liste durch einfaches anklicken angewählt haben. Dieser Modus unterstützt die folgende Funktion, die allerdings nur auf die Speicherblock-Liste angewandt funktioniert: @{"Priority" LINK Funk4} @ENDNODE @NODE Anz8 @TITLE "XOpa-Documentation: Display Modes" @{b}Interrupts@{ub} In diesem Modus werden die im System vorhandenen Interrupts in der Liste angezeigt. Ein Interrupt ist eine Art Programm das unter bestimmten Gegebenheiten aufgerufen wird, z.B. wenn der Rasterstrahl des Monitors eine bestimmte Position erreicht hat. Dabei werden die folgenden Informationen dargestellt: · Adresse - Adresse des Interrupts im System · Pri - Priorität des Interrupts. Siehe auch @{"«Priorität»" LINK Funk4} · Data - Zeiger auf den Datenteil · Code - Zeiger auf den Programmteil · Nr - Interruptnummer (gibt an welcher Interruptkanal benutzt wird) · Interrupt - Verständliche Bezeichnung für die Int.-Nummer · Ctrl - Art des Interrupts (Control: handler/server) · Typ - Entweder "interrupt" oder "unknown" · Name - Name des Interruptes. Dieser Modus unterstützt die folgenden Funktionen: @{"Remove" LINK Funk2} und @{"Priority" LINK Funk4} @ENDNODE @NODE Anz9 @TITLE "XOpa-Documentation: Display Modes" @{b}Assigns@{ub} In diesem Modus wird eine Liste der Verzeichnis-Zuweisungen (Assigns) dargestellt. Dabei werden die folgenden Informationen dargestellt: · Adresse - Adresse der Zuweisung im System · Assign-Name - Name des Assigns, z.B. LIBS · Pfad - der komplette Pfad für den assign Dieser Modus unterstützt die folgenden Funktionen: @{"Add" LINK Funk1} und @{"Remove" LINK Funk2} @ENDNODE @NODE Anz10 @TITLE "XOpa-Documentation: Display Modes" @{b}Residents@{ub} In der angezeigten Liste finden Sie alle sich im Kickstart-ROM befindlichen Teile des Betriebssystems. Dabei werden die folgenden Informationen dargestellt: · Adresse - Adresse des Objektes im ROM · Pri - Priorität. Siehe auch @{"«Priorität»" LINK Funk4} · Version - Version des Objektes · Flags - Flags in der Resident-Struktur · Typ - Der Typ des Objektes (z.B. "library") · Name - Der Name des Objektes In diesem Modus stehen keine Funktionen zur Verfügung, da die Daten im ROM stehen und somit nicht veränderbar sind. @ENDNODE @NODE Anz11 @TITLE "XOpa-Documentation: Display Modes" @{b}Fonts@{ub} In diesem Modus wird eine Liste der geöffneten Zeichen- sätze (Fonts) angezeigt. Dabei werden die folgenden Informationen dargestellt: · Adresse - Adresse des Zeichensatzes im System · Breite - normale Breite des Fonts in Pixeln · Höhe - Höhe des Fonts · BaseLine - Die Grundlinie des Fonts · LoChar - Zeichen mit der kleinsten ASCII-Nummer in der BitMap des Zeichensatzes · HiChar - Zeichen mit der höchsten ASCII-Nummer des Fonts · OpenC - Wie oft der Font geöffnet wurde (OpenCount) · CharData - Wo die BitMap des Fonts im Speicher liegen · Name - Der Name des Zeichensatzes Bei einem Doppelklick auf einen Eintrag der Liste wird ein Fenster geöffnet, in dem der Zeichensatz dargestellt wird. Dieser Modus unterstützt die folgenden Funktionen: @{"Add" LINK Funk1} und @{"Close" LINK Funk5} @ENDNODE @NODE Anz12 @TITLE "XOpa-Documentation: Display Modes" @{b}Struktur@{ub} In diesem Modus können Sie sich die Systeminterna direkt in den dafür vorgesehenen Strukturen anzeigen lassen. Dazu gibt es viele Möglichkeiten (Siehe @{"Strukturmodus" LINK Struktur}). Aus Sicherheitsgründen ist es aber hier nicht möglich, die vorliegenden Daten zu manipulieren. Dieser Modus unterstützt, wenn möglich, die folgende Funktion: @{"Back" LINK Funk8} @ENDNODE @NODE Anz16 @TITLE "XOpa-Documentation: Display Modes" @{b}Locks@{ub} In dieser Liste sind alle offenen Locks, d.h. bestehende Zugriffe auf Dateien; diese können z.B. verhindern, daß eine bestimmte Datei gelöscht wird, oder überhaupt auf sie zugegriffen wird. Dabei werden die folgenden Informationen dargestellt: · Adresse - Adresse des Locks · Modus - Zugriffsart (lesend/schreibend) · Name - voller Pfad und Name Dieser Modus unterstützt die folgende Funktion: @{"Entfernen" LINK Funk2} @ENDNODE @NODE Anz17 @TITLE "XOpa-Documentation: Display Modes" @{b}Volumes@{ub} Die Liste enthält die im System angemeldeten Geräte, diese können z.B. in der Shell angesprochen werden. Dabei werden die folgenden Informationen dargestellt: · Adresse - Adresse des Objektes im RAM · Pri - Priorität. Siehe auch @{"«Priorität»" LINK Funk4} · Name - Der Name des Objektes · Unit - Nummer des Gerätes · Handler - Name des zugehörigen Handlers · Device - Name des dazugehörenden Devices In diesem Modus stehen keine weiteren Funktionen zur Verfügung. @ENDNODE @NODE Anz18 @TITLE "XOpa-Documentation: Display Modes" @{b}Monitors@{ub} Diese Liste enthält die im System vorhandenen Monitore, eine Art Treiber für bestimmte Auflösungen und Frequenzen. Dabei werden die folgenden Informationen dargestellt: · Adresse - Adresse der MonitorSpec-Struktur · totrows - (Maximale) Zeilenanzahl · totclks - Colorclocks · Name - Der Name des Monitors In diesem Modus stehen keine weiteren Funktionen zur Verfügung. @ENDNODE @NODE Anz19 @TITLE "XOpa-Documentation: Display Modes" @{b}Classes@{ub} Diese Liste enthält alle öffentlichen Klassen des Systems, die BOOPSI als Ursprung haben. Dabei werden die folgenden Informationen dargestellt: · Adresse - Adresse der Klassenstruktur · Superklasse - die Super-Klasse (Ursprungsklasse) · Obj. - die Anzahl der Objektinstanzen · Sub. - die Anzahl der abgeleiteten Klassen · Name - der Name der Klasse In diesem Modus stehen keine weiteren Funktionen zur Verfügung. @ENDNODE @NODE Anz20 @TITLE "XOpa-Documentation: Display Modes" @{b}Catalogs@{ub} Diese Liste enthält alle offenen Kataloge, die von verschiedenen Programmen genutzt werden. Dabei werden die folgenden Informationen dargestellt: · Adresse - Adresse der Catalog-Struktur · Version - die Version des Kataloges · Sprache - Sprache · Name - Der Name des Kataloges In diesem Modus steht folgende Funktion zur Verfügung: @{"Entfernen" LINK Funk2} Dabei ist zu beachten, daß der Katalog lediglich aus der Liste entfernt wird, er also im Speicher weiterhin vorhanden ist und er weiterhin genutzt werden kann. Wird er allerdings nochmal angefordert, wird er erneut von Disk geladen. @ENDNODE @NODE Funks @TITLE "XOpa-Documentation: Function gadgets" @{b}VI. Function gadgets@{ub} Hier sind die Erklärungen zu der Funktionsleiste. Dazu ist zu beachten, daß nicht jede Funktion von jedem Anzeigemodus aus aufrufbar ist (siehe @{"Anzeige" LINK Anzeige}) und sich viele Funktionen erst nach Anwahl eines Eintrages auswählen lassen. Insgesamt sind die folgenden Funktionen implementiert: @{"Add" LINK Funk1} @{"Remove" LINK Funk2} @{"Signal" LINK Funk3} @{"Priority" LINK Funk4} @{"Close" LINK Funk5} @{"Freeze" LINK Funk6} @{"Windows" LINK Anz14} @{"Back" LINK Funk8} @ENDNODE @NODE Funk1 @TITLE "XOpa-Documentation: Funktionsleiste" @{b}Neu@{ub} Diese Funktion ist nur in den Modi @{"Screens" LINK Anz2}, @{"Assigns" LINK Anz9} und @{"Fonts" LINK Anz11} anwählbar. Das neu hinzuzufügende Objekt ist abhängig davon, in welchem Anzeigemodus Sie sich befinden. Je nachdem aus welchem Modus Sie sie benutzen, öffnet sich ein bestimmtes Fesnter: - im @{"Screens-Modus" LINK Anz2} öffnet sich ein Requester, in dem man Einstellungen zum Öffnen eines Public-Screens trifft. (Siehe Requester @{"«Bildschirm öffnen»" LINK Req1}) - im @{"Assigns-Modus" LINK Anz9} wird ein Requester mit zwei Texteingabefeldern ge- öffnet. Im ersten geben Sie den Namen der Zuweisung ohne Doppelpunkt ein (z.B. so etwas wie "Fonts"). Im zweiten Eingabefeld geben Sie den Pfadnamen an, auf den die Zuweisung zeigen soll (z.B. "SYS:Fonts" für die Zuweisung "Fonts:"). Um die Eingabe zu bestätigen drücken Sie "Ok". Wenn Sie die Zuweisung nicht übernehmen wollen, drücken Sie entweder "Abbrechen" oder klicken Sie auf den Schließknopf in der Fensterleiste. (Siehe auch Requester @{"«Assign für Verzeichnis»" LINK Req2}) - im @{"Fonts-Modus" LINK Anz11} öffnet sich das übliche Zeichensatzauswahlfenster (ein ASL-Requester, zur Bedienung verweise ich auf die zu Ihrem Computer beiliegende Literatur). Dabei wird nicht nur der zuletzt angewählte Zeichensatz geöffnet, sondern auch alle, die das Auswahlfenster bei der Auswahl öffnet! Die Funktion benötigt keinen vorher angewählten Eintrag. @ENDNODE @NODE Funk2 @TITLE "XOpa-Documentation: Funktionsleiste" @{b}Entfernen@{ub} Diese Funktion ist von sehr vielen @{"Anzeigemodi" LINK Anzeige} aus aufrufbar. Sie ist dazu da, Objekte aus den Systemlisten und dem Speicher zu entfernen. Bei aktivierten @{"Sicherheitsabfragen" LINK Men16} werden Sie gefragt, ob Sie das jeweilige Objekt wirklich entfernen wollen. Bei einigen Modi gibt es noch ein paar zusätzliche Optionen (siehe z.B. für Tasks @{"Task-Fenster-Relationen" LINK Men15}). Vor der Anwahl dieser Funktion muß der zu entfernende Eintrag in der Liste ausgewählt worden sein. !! Diese Funktion ist mit Vorsicht zu geniessen, da das System !! !! die geschlossenen Objekte noch brauchen kann. !! !! Wundern Sie sich also nicht, wenn der Rechner danach abstürzt. !! @ENDNODE @NODE Funk3 @TITLE "XOpa-Documentation: Funktionsleiste" @{b}Signal@{ub} Nach drücken der Taste «Signal» im @{"Tasks-Anzeigemodus" LINK Anz1} erscheint, sofern Sie einen Eintrag angewählt haben, der Requester «Signal senden» Im oberen Feld können Sie eine Zahl im Hexadezimalsystem eingeben, die nun an den internen Port des Tasks gesendet wird. Durch die sogenannten Radio-Buttons (die runden Knöpfe am linken Fenster- rand) haben Sie die Wahl zwischen der Möglichkeit dem Programm die ein- gegebene Hexadezimalzahl zu senden und der Möglichkeit ihm Abbruchsignale zu schicken. Im Anfangszustand (direkt nach dem Öffnen des Requesters) ist es egal, für welche der beiden Möglichkeiten Sie sich entscheiden, da beide ver- suchen, das Programm abzubrechen. @ENDNODE @NODE Funk4 @TITLE "XOpa-Documentation: Funktionsleiste" @{b}Priorität@{ub} Mit dieser Funktion können Sie die Priorität eines Eintrags ändern, nach- dem Sie ihn mit der Maus angewählt haben. Nach dem Klick auf den Knopf (Gadget) öffnet sich der Requester «Priorität ändern». In dem Eingabefeld des Requesters ist eine Priorität zwischen -128 und +127 einzugeben. Falls Sie eine Zahl ausserhalb dieses Bereiches eingeben, setzt XOpa die jeweilige Ober- oder Untergrenze ein. Die Priorität eines Objektes hat verschiedene Auswirkungen auf bestimmte Dinge, die Typabhängig sind. Wenn Sie z.B. die Priorität eines @{"Tasks" LINK Anz1} erhöhen, bewirkt dies, daß er mehr und öfter Rechenzeit vom Prozessor zur Verfügung gestellt kriegt. Bei einer Erniedrigung geschieht das Gegenteil und der Task bekommt weniger Rechenzeit. Bei Prioritätenänderung von Speicherblöcken (z.B. Fast- & Chip-RAM) bewirkt dies, das ein bestimmter Speicher vorgezogen oder vernachlässigt wird, wenn ein Programm Speicher anfordert. So sollten Sie langsamen RAM-Erweiterungen eine niedrige Priorität geben, um zu verhindern, daß Ihr Computer langsamer wird auch wenn noch schnelles RAM frei wäre. @ENDNODE @NODE Funk5 @TITLE "XOpa-Documentation: Funktionsleiste" @{b}Schliessen@{ub} Dieser Knopf (Gadget) hat im Prinzip die gleiche Funktion wie @{"Entfernen" LINK Funk2}. Es gibt ihn auch nur aus "Geschmacksgründen". (Man entfernt (remove) keinen Bildschirm, man schließt (close) ihn!? Wenn der Text zu breit fuer das Gadget ist, wird er durch "Close" ersetzt, was zum Beispiel beim Topaz-Zeichensatz geschieht. @ENDNODE @NODE Funk6 @TITLE "XOpa-Documentation: Funktionsleiste" @{b}Freeze@{ub} Diese Funktion kann nur vom @{"Tasks-Modus" LINK Anz1} aus aufgerufen werden. Die Exec-Library liest ständig die Taskliste ein und ruft die darin enthaltenen Einträge auf. Diese Funktion entfernt den angewählten Task von dieser Liste und hängt ihn an eine spezielle Warteliste an, woraufhin dieser Task von Exec "übergangen" wird; er ist eingefroren. Ist bei Anwahl dieser Funktion ein bereits eingefrorener Task angewählt, wird dieser wieder in die aktive Liste verschoben und setzt seine Aus- führung fort. @ENDNODE @NODE Anz14 @TITLE "XOpa-Documentation: Funktionsleiste" @{b}Windows@{ub} Diese Funktion ist in den Anzeigemodi @{"Tasks" LINK Anz1} und @{"Screens" LINK Anz2} vor- handen. Nach dem Drücken dieses Knopfes (Gadgets) werden alle offenen Fenster des angewählten Screens oder Tasks angezeigt. Wenn Sie das Gadget dann nochmals drücken, wird die angezeigte Liste neu erstellt, um Änderungen (ein neues Fenster wurde geöffnet) schnell sichtbar zu machen. Dabei werden folgende Informationen angezeigt: · Adresse - Die Adresse des Fensters im System · Pos(x,y) - Die Position des Fensters auf dem Screen · Maße(x,y) - Breite und Höhe des Fensters · IDCMP - Die IDCMP-Flags spezifizieren die Art der Nachrichten, die das Fenster von Intuition bekommt. Nach dem Doppel- klick auf einen Eintrag werden diese Flags nocheinmal lesbar dargestellt · Flags - Diese Flags bestimmen die Eigenschaften des Fensters. Auch sie werden nochmal übersichtlich angezeigt, wenn man auf einen Eintrag doppellt klickt · Titel - Der aktuelle Fenstertitel Durch einen Doppelklick auf einen Eintrag kann man weitere Informationen über das Fenster bekommen. In diesem Modus ist dann das Zurück-Gadget an- wählbar, das die eigentliche Fensterliste wieder anzeigt. Falls Sie sich wundern, warum auf diesem Gadget nicht "Fenster" steht, dann versuchen Sie doch mal, geeignete Tastaturkürzel dafür zu finden... @ENDNODE @NODE Funk8 @TITLE "XOpa-Documentation: Funktionsleiste" @{b}Zurück@{ub} Diese Funktion ist eigentlich eine spezielle Funktion des @{"Strukturmodus" LINK Struktur}, wird allerdings auch bei der Fensterliste verwendet. (Siehe @{"Fenster" LINK Anz14}) Der Strukturmodus merkt sich immer die zuletzt angezeigten Strukturen. Drücken Sie nun auf dieses Gadget zeigt er die letzte Struktur wieder an. Wiederholen Sie dieses wird Struktur davor angezeigt usw. bis die erste angezeigte Struktur angezeigt wird. In diesem Fall wird das Gadget auch vor einer Anwahl sichtbar gesperrt. Dieser Knopf hat die gleiche Funktion wie der Menüpunkt @{"Zurück" LINK Men24} im @{"Struktur-Menü" LINK Menus}. @ENDNODE @NODE Req1 @TITLE "XOpa-Documentation: Requester" @{b}Bildschirm öffnen@{ub} Der Requester erscheint, wenn Sie im @{"Screens-Anzeigemodus" LINK Anz2} die Taste @{"Neu" LINK Funk1} drücken. In diesem Requester werden die Einstellungen für einen neuen Bildschirm gemacht. Dieser ist in jedem Fall ein öffentlicher, d.h. von anderen Programmen aus benutzbarer Bilschirm. In dem Eingabefeld (Stringgadget) geben Sie bitte den Namen des zu öffnenden Bildschirmes ein. Wenn Sie dort keine Angabe machen wird ein Standardname benutzt. Wenn Sie OS2.1 oder höher besitzen, können Sie nun noch einen Bildschirmmodus einstellen (Modus-Gadget). Unter Kickstart 2.0 ist dies nicht möglich, hier werden die Werte des Workbench-Screens benutzt. Wenn Sie auf das "Ok"-Gadget drücken wird der Bildschirm ge- öffnet, ein Klick auf das "Abbrechen"-Gadget schließt das Fenster ohne einen neuen Bildschirm zu öffnen. @ENDNODE @NODE Req2 @TITLE "XOpa-Documentation: Requester" @{b}Assign für ein Verzeichnis@{ub} Diesen Requester rufen Sie auf, indem Sie die Taste @{"Neu" LINK Funk1} im Modus @{"Assigns" LINK Anz9} drücken. Ein Assign für ein Verzeichnis ist eine Zuweisung mittels derer Sie schnell auf ein bestimmtes Verzeichnis zugreifen können ("FONTS:" z.B. ist normalerweise eine Zuweisung auf das Verzeichnis "SYS:Fonts"). Im oberen Eingabefeld geben Sie bitte den Namen der Zuweisung an (z.B. "Fonts"). Ein Doppelpunkt ist hier nicht notwendig. Im unteren Verzeichnis geben Sie bitte den Pfad für das Verzeichnis auf das die Zuweisung zeigen soll (z.B. "SYS:Fonts"). Ein Klick auf das "Wählen..."-Gadget und ein Dateirequester er- scheint, in dem Sie ein Verzeichnis wählen können. Wenn Sie auf das "Ok"-Gadget drücken wird die Zuweisung generiert, ein Klick auf das "Abbrechen"-Gadget schließt den Requester ohne eine Zuweisung zu machen. @ENDNODE @NODE ToolTypes @TITLE "XOpa-Documentation: ToolTypes" @{b}VII. Tool-Types@{ub} Das Programm unterstützt mehrere ToolTypes, um bestimmte Einstellungen nicht immer wieder treffen zu müssen. Die folgenden Tools-Types werden unterstützt: · STRUCTS - als Parameter Pfad und Dateiname für die externen Strukturdefinitionen des @{"Strukturmodus" LINK Struktur}. · TASKWINDOWS - Wählt standardmäßig den Menüpunkt @{"«Task&Fenster-Relationen»" LINK Men15} an. · SECURITYCHECK - Wählt standardmäßig den Menüpunkt @{"«Sicherheitsabfragen»" LINK Men16} an. · SORTLIST - Wählt den Menüpunkt @{"«Anzeigeliste sortieren»" LINK Men17} standardmäßig an. · DISPLAY - dieser ToolType unterstützt die folgenden Parameter: TASKS, SCREENS, PORTS, LIBRARIES, RESOURCES, DEVICES, SYSTEM, INTERRUPTS, ABOUT, ASSIGNS, FONTS, RESIDENTS, LOCKS, VOLUMES, MONITORS Je nach Parameter wird ein @{"Anzeigemodus" LINK Anzeige} beim Start automatisch eingestellt, standardmäßig wird ABOUT (Informationen über XOpa) angezeigt. · WINDOW - dieser ToolType benötigt vier Angaben für die Fenstergröße: die X- und Y-Position, die Breite und die Höhe des Fensters. Die Angaben werden durch Schrägstriche getrennt, wobei immer 3 Schrägstriche vorkommen müssen. Es besteht die Möglichkeit, einzelne Angaben wegzulassen. (z.B. WINDOW=0//600/) · ICONIFY - veranlaßt XOpa gleich im iconifizierten Zustand, ohne ein Fenster zu öffnen, zu starten Außerdem wird XOpa, wenn man das Fenster schließt, nicht beendet, sondern wieder nur iconifiziert. · ICONXY - legt die Position des Iconify-Icons fest. Angegeben werden müssen sowohl X- als auch Y-Koordinate. (z.B. ICONXY=42/42) Die ToolTypes werden natürlich nur gelesen, wenn das Programm von der Workbench aus gestartet wird. Durch Einklammern eines ToolTypes mit «()» wird dieses überlesen. @ENDNODE @NODE Struktur @TITLE "XOpa-Documentation: Strukturmodus" @{b}VIII. Strukturmodus von XOpa@{ub} Der Strukturmodus gibt Ihnen einen Einblick in die Struktur-Interna des Betriebssystems. Nachdem Sie den Modus ausgewählt haben wird eine Liste der Libraries angezeigt, von denen eine Strukturdefinition existiert. Mit einem Doppelklick auf eine dieser Libraries wird die interne Struktur dieser angezeigt. Bei einem Doppelklick auf einen Zeiger oder auf einen Zeiger auf eine Struktur (dargestellt durch "^Strukturname") wird entweder in die je- weilige Strukturdarstellung oder in eine Speicherdarstellung umgeschaltet. Mit der Taste @{"Zurück" LINK Funk8} können Sie nun die vorher angezeigte Struktur wieder anzeigen lassen. Weiterhin haben Sie die Möglichkeit sich beliebige Speicheradressen in einer Struktur- oder Speicherdarstellung darzustellen (mittels @{"Andere Struktur" LINK Men20} im Struktur-Menü). Die Strukturanzeige ist wie folgt aufgebaut: In der ersten Zeile steht die aktuelle Adresse und die aktuell dargestellte Struktur. Dann steht links der Name des Eintrages und rechts der Inhalt und Typ. Wenn eine Struktur in eine andere eingebettet wird das durch einen waagerechten Strich gefolgt von dem Namen der Struktur deutlich gemacht. Zusätzlich werden die folgenden Einträge eingerückt. Im Speichermonitor steht links die Adresse, dann folgen die dort liegenden Daten einmal in der Hexadezimaldarstellung und dann in einer ASCII-Darstellung. Durch einen Doppelklick auf die letzte Zeile im Speichermonitor ("-> die nächsten 1024 Bytes") werden eben diese dargestellt. Die Strukturdefinitionen für diesen Modus sind teilweise im Programm enthalten, sie befinden sich aber größtenteils in einer externen Datei, normalerweise in der Datei "XOpa.structs", durch die @{"ToolTypes" LINK toolTypes} kann man allerdings auch eine andere Datei auswählen. Durch die externe Strukturdefinitionsdatei hat man die Möglichkeit, seine eigenen Strukturen, die innerhalb seiner Programme verwendet werden mit XOpa auf deren Richtigkeit zu überprüfen und die Strukturdefinitionen nahezu beliebig (Speichergrenze) zu erweitern. Diese Datei kann jedoch nur gelesen werden, wenn Sie eine registrierte Version von XOpa besitzen. (siehe @{"Registrierung" LINK Share}) @{b}Der Aufbau der Strukturdefinitionsdatei@{ub} Damit XOpa die eingestellte Datei als Strukturdefinitionsdatei erkennt, muß sie mit folgendem Eintrag beginnen: # --==**> XOpa-Strukturdefinition Für die Definitionen gibt es die folgenden Befehle: #libraries - Danach folgt eine Liste der Libraries mit Struktur- definition. Als erstes muß der Name der Library ange- geben werden, dann folgt ein "=" und der Name der Struktur, die für diese Library benutzt werden soll. Achten Sie darauf, daß Sie keinen Schreibfehler machen, da die Strukturen sonst nicht benutzt werden können! #structs - Danach folgt eine Liste der Strukturdefinitionen. #end - Beendet einen Teil (z.B. #structs), ist aber nicht notwendig @struct -Innerhalb der Strukturdefinitionen leitet dieser Befehl eine neue Struktur ein. Der Name ist mit einem "=" anzuschliessen. In den dann folgenden Definitionen ist erst der Name und dann der Typ mit einem Doppelpunkt davor anzugeben. Kurzes Beispiel: # --==**> XOpa-Strukturdefinition #libraries intuition.library=IntuitionBase #structs @struct=IntuitionBase LibNode :Library ... Mit ";" am Anfang einer Zeile leitet man einen Kommentar ein. Für die Definitionen stehen folgende Typen zur Auswahl: · BYTE,UBYTE,FLGBYTE - je 1 Byte lang · WORD,UWORD,FLGWORD - je 2 Bytes lang · LONG,ULONG,FLGLONG - je 4 Bytes lang · PTR,"^Struktur" - auch 4 Bytes lang, beim Doppelklick springt man an den Inhalt dieses Eintrages! · BPTR - ähnlich "PTR", nur beschreibt dieser Typ einen BCPL-Zeiger; d.h. die Adresse wird vor dem Sprung mal 4 genommen. · STR - Zeiger auf einen String (4 Bytes) · STRING[x] - dieser für Programmierer (Ansehen eigener Strukturen) eingeführte Typ entspricht einem String von x Byte(s) Länge. · "Struktur" - richtet sich nach der Länge der angegebenen Struktur. Diese Struktur muß bereits vorher definiert worden sein! "Struktur" ist durch den Namen der jeweiligen Struktur zu ersetzen. Das Prefix "U" bedeutet "unsigned", also eine vorzeichenlose Zahl. Die Vorsilbe "FLG" bewirkt, das die Zahl im Hexadezimalsystem angegeben wird (dadurch werden die "Flags" deutlicher). Alle Typen (Ausnahme: STRING) können als Array geschrieben werden, z.B. erzeugt WORD[42] ein Array von 0 bis 41 des Typs WORD. Falls noch irgendwelche Unklarheiten bestehen, schauen Sie sich bitte die beiliegende Strukturdefinitionsdatei @{"«XOpa.structs»" LINK XOpa.structs/main} an. Bereits im Programm sind derzeit die folgenden zehn Strukturen integriert: · SysBase, MinNode, Node, MinList, List, Library, IntVector, SoftIntList, MsgPort, Device Für Erweiterungswünsche wenden Sie sich bitte an mich. Viel Spaß beim ausprobieren des Strukturmodus`. @ENDNODE @NODE Kurz @TITLE "XOpa-Documentation: Kurzübersicht" @{b}IX. Kurzübersicht@{ub} _______________________________________________________________________________________ 1.Menüs: @{"Projekt" LINK Menus} @{"Optionen" LINK Menus} @{"Struktur" LINK Menus} @{"Hilfe" LINK Menus} @{"Iconifizieren" LINK Men00} @{"Speicher aufräumen " LINK Men10} @{"Andere Struktur " LINK Men20} @{"Allgemein " LINK Men40} @{"Über... " LINK Men01} @{"Aktuelle Anzeige drucken " LINK Men11} @{"Node-Strukturen " LINK Men21} @{"Kurzübersicht " LINK Men41} @{"Ende " LINK Men02} @{"Anzeige speichern... " LINK Men12} ~~~~~~~~~~~~~~~~~ @{"Aktuelle Anzeige" LINK Men42} @{"Geschwindigkeitstest " LINK Men13} @{"Neu einlesen " LINK Men23} ~~~~~~~~~~~~~~~~~~~~~~~~~~ @{"Zurück " LINK Men24} @{"Task&Fenster-Relationen " LINK Men15} @{"Sicherheitsabfragen " LINK Men16} @{"Anzeigeliste sortieren " LINK Men17} @{b}Hinweis:@{ub} Das @{"Anzeige-Menü" link anzeige} fehlt in der Kurzübersicht. _______________________________________________________________________________________ 2.Funktionsleiste: @{" Neu " LINK Funk1}@{"Entfernen" LINK Funk2}@{" Signal " LINK Funk3}@{" Priorität " LINK Funk4}@{"Schliessen" LINK Funk5}@{" Freeze " LINK Funk6}@{" Windows " LINK Anz14}@{" Zurück " LINK Funk8} _______________________________________________________________________________________ 3.Anzeigeauswahl: @{" Tasks " LINK Anz1}@{" Screens " LINK Anz2}@{" Ports " LINK Anz3}@{" Libraries " LINK Anz4}@{" Resources " LINK Anz5}@{" Devices " LINK Anz6} @{" System " LINK Anz7}@{" Interrupts " LINK Anz8}@{" Assigns " LINK Anz9}@{" Residents " LINK Anz10}@{" Fonts " LINK Anz11}@{" Struktur " LINK Anz12} @ENDNODE @NODE about @TITLE "XOpa-Documentation: Über das Programm" @{b}X. Über das Programm@{ub} __ __ __ ______________________________ ___\\ \\ / / ____\\ \\ / / ©©© ©©©© ©©© Version 1.94 _____\\ \\/ / © © © © © © ________ ______\\ / © © ©©©© ©©©©© _________ _____ / \\ © © © © © __________ ____ / /\\ \\ ©©© © © © ____________________ ___ / / \\ \\ ____________________________________________ __ /_/ \\_\\ _______________________________________ XOpa ist größtenteils mit Kick-Pascal 2.12 der Maxon-Computer GmbH programmiert worden. Einige Teile wurden jedoch mit dem MaxonAssembler verwirklicht, wenn auch nur 4 Mini-Routinen. Es läuft ab OS2.0 einwandfrei und wurde auf verschiedenen Hardware-Plattformen erfolgreich getestet, empfohlen wird aber ein Amiga mit OS3.0 oder höher. Der meistens gut gegliederte Quellcode kann dadurch, daß er auch für OS3.0 geschrieben wurde, als Beispiel für die Programmierung der neuen Funktionen benutzt werden. Seit der Version 1.0 wurden folgende Änderungen durchgeführt: ---------------- Version 1.01 vom 24.5.1994 ------------------- · eine Hilfefunktion mittels AmigaGuide wurde integriert ---------------- Version 1.02 vom 9.6.1994 -------------------- · der Add-Assign-Requester wurde erweitert (neues Gadget) · interne Programm- und Requesteraufräumarbeiten ---------------- Version 1.02 vom 10.6.1994 ------------------- · kleiner Fehler in der Laderoutine (Kommentare) beseitigt · der Strukturmodus wurde um den "BPTR"-Typ erweitert ---------------- Version 1.02 vom 11.6.1994 ------------------- · der Standard-Version-String wurde berichtigt · ein paar Tippfehler beseitigt · eine Menü-Hilfefunktion wurde hinzugefügt · nach dem Iconifizieren wird der Strukturmodus nicht mehr neu initialisiert (aktuelle Struktur wird beibehalten) ---------------- Version 1.02 vom 5.7.1994 -------------------- · kleine Umstrukturierung im Quellcode · das Programm aktualisiert nun auch den Default-Font nach dem Iconifizieren (Listenfont wird geändert) ---------------- Version 1.03 vom 10.9.1994 ------------------- · das Iconify-Icon wurde durch ein anderes ausgewechselt · dieses Icon ist in einem eigenen Chip-Data-Hunk mittels Assembler-Unterstützung untergebracht · "Zurück" im Strukturmodus merkt sich jetzt auch die Position der letzten Liste im ListView-Gadget ---------------- Version 1.03 vom 3.10.1994 ------------------- · der ToolType "WINDOW" wurde hinzugefügt · Änderungen an Fehlertexten (Ciao Mädels...) ---------------- Version 1.03 vom 19.10.1994 ------------------ · der Fenstertitel im Zeichensatzanzeigefenster änderte sich nach erneuter Aktivierung des Fensters ---------------- Version 1.04 vom 28.11.1994 ------------------ · Infotext geändert · die Anzeigeliste wird nun auf Wunsch sortiert ausgegeben · kleine Aufräumarbeiten im Quellcode ---------------- Version 1.04 vom 30.11.1994 ------------------ · Sortierroutine benutzt nun Locale (ab OS2.1) bzw. berück- sichtigt nun kleine/große Zeichen (OS 2.0) · AmigaGuide-Library wurde nicht geschlossen · Geschwindigkeitstests (nicht fertig) ---------------- Version 1.04 vom 6.1.1995 -------------------- · Weiterführung der Geschwindigkeitstests (Grafik) · der Infotext wurde erweitert und Schreibfehler entfernt · Fehler in der internen SysBase-Struktur · Tastaturbedienung fertiggestellt ---------------- Version 1.06 vom 7.1.1995 -------------------- · Anzeige der Prozessor-Caches im Systemmodus · der MC68060 wird ab sofort erkannt · der ToolType "ICONIFY" läßt XOpa iconifiziert starten · das Vorhandensein einer MMU wird überprüft ---------------- Version 1.07 vom 10.1.1995 ------------------- · der Speichertest wurde integriert · Assembler-Source in eine Datei zusammengefaßt (2390 Bytes) · Grafiktest-Linien: die Schleifenlaufzeit wird abgezogen ---------------- Version 1.07 vom 13.1.1995 ------------------- · Fontanzeige nun auch über Tastatur bedienbar · kleiner Fehler im Fonts-Modus mit sortierten Listen... ---------------- Version 1.08 vom 14.1.1995 ------------------- · Herstellerdatei eingeführt, wird allerdings nicht genutzt · neuer ToolType "BOARDS" (für Herstellerdatei) · alle Anzeigemodi auf RawDoFmt umgestellt, wodurch XOpa nicht nur kürzer wird, sondern auch schneller · Quellcode-Aufräumarbeiten · Help-Taste seit Tastaturbedienbarkeit funktionslos · beim Start von der Shell waren Variablen falsch gesetzt ---------------- Version 1.08 vom 16.1.1995 ------------------- · durch die Tastaturbedienbarkeit Fehler im Aufbau der Ober- fläche unter OS2.0, da die Listview-Gadgets ab OS3.0 anders aufgebaut sind. Tastaturbedienung der Liste unter OS2.0 ist nicht möglich. · vergessene Debug-Anweisung entfernt... · Guide völlig anders aufgeteilt (einfachere Handhabung), XOpa auf diese Änderungen angepaßt · wenn XOpa iconifiziert gestartet wurde, wird es bei Druck aufs Close-Gadget nun wieder iconifiziert, nicht beendet · kleine Quellcode Optimierungen und Aufräumarbeiten · Herstellerdatei ist jetzt funktionsfähig ---------------- Version 1.08 vom 17.1.1995 ------------------- · Doppelklick-Test überarbeitet, funktioniert jetzt problem- los und ist kürzer als vorher · sehr sehr kleine Schönheitsoperation (Hochkommata) · Zurück-Gadget war beim Wechsel in den Strukturmodus nicht deaktiviert, wenn es dort vorher aktiviert war · weitere Optimierungen ---------------- Version 1.09 vom 18.1.1995 ------------------- · Geschwindigkeitstests vervollständigt (Intuition,Integer, Floating-Point) ---------------- Version 1.10 vom 19.1.1995 ------------------- · Integer- und Floating-Point-Test liefern jetzt genauere Ergebnisse · Floating-Point um zusätzliche Tests erweitert (sin,Wurzel) · ewig lang vorhander Fehler beim Entfernen von Libraries behoben · ein paar Texte verschönert ---------------- Version 1.10 vom 22.1.1995 ------------------- · Nach dem Iconifizieren wurde die Anzeigeliste bei den Geschwindikeitstests gelöscht · XOpa auf eine Registrierung vorbereitet (Deaktivierung der Strukturdefinition-Laderoutine, Anpassung Infotext) ---------------- Version 1.12 vom 12.3.1995 ------------------- · Die Requester "Signal" & "Priorität" sind nun ebenfalls mit der Tastatur komplett bedienbar · kleine @{"Aufräumarbeiten" LINK SehrDumm} im Quellcode ---------------- Version 1.12 vom 24.3.1995 ------------------- · Systemlaufzeit wird im Systemmodus angegeben · ein paar kleine Fehler im Guide beseitigt ---------------- Version 1.12 vom 3.4.1995 -------------------- · das Guide wird nun auch bei den Geschwindigkeitstests nach Drücken der Help-Taste an der richtigen Stelle geöffnet · seit @{"Version 1.12" LINK SehrDumm} wurde beim Geschwindigkeitstest-Fenster die falsche IntuiMessage ausgewertet... ---------------- Version 1.13 vom 4.4.1995 -------------------- · die aktuelle Anzeige kann man nun auch speichern ---------------- Version 1.13 vom 11.4.1995 ------------------- · die ASCII-Darstellung der Speicherdarstellung des Struktur- modus fing immer ein Byte zu früh an... ---------------- Version 1.13 vom 16.4.1995 ------------------- · seit der ersten @{"Version 1.12" LINK SehrDumm} trat folgender Fehler auf: IDCMP_SIZEVERIFY wurde nicht mehr abgefragt, daher war das Fenster nicht mehr korrekt größenveränderbar... · so nebenbei: die Iconify-Funktion wollte auch nicht mehr! ---------------- Version 1.14 vom 18.4.1995 ------------------- · umfangreiche Programmoptimierungen · Strukturmodus um Arrays und Strings erweitert ---------------- Version 1.14 vom 8.5.1995 -------------------- · Minimalfehler bei der System-Anzeige beseitigt · bis Gestern stürtzte XOpa beim ändern der Chip-RAM-Priorität ab... ---------------- Version 1.16 vom 18.6.1995 ------------------- · Strukturleseroutine beschleunigt · Die BPTRs im Strukturmodus hatten nicht mehr funktioniert · Kleinen Fehler im Struktur-Modus behoben · Beim Zurück-gehen im Struktur-Modus wird nun der vorher angewählte Eintrag hervorgehoben · Erweiterung der XOpa.boards-Datei · Kleine Änderungen im Registrierungsprogramm · Die Einträge der Listviewgadgets "Andere Struktur" und "Node Struktur" sind jetzt per Doppelklick anwählbar (Änderungsvorschläge größtenteils von Swen K. Stullich) ---------------- Version 1.42 vom 24.7.1995 ------------------- · Mehrfachmenüauswahl ist nun möglich · Versionssprung-Strategie geändert: Sie werden ab dieser Version größer ausfallen. ---------------- Version 1.42 vom 31.8.1995 ------------------- · Fehler im Iconify beseitigt (bestand seit der Juli-Version 1.42) · neues (in C geschriebenes) Registrierungsprogramm ---------------- Version 1.42 vom 5.9.1995 -------------------- · kleinere Layoutfehler der Oberfläche behoben · größere Programmoptimierungen · Bei "Signal" verhindert das MX-Gadget nicht mehr, daß das String-Gadget überall angeklickt werden kann · Asl-Requesterhöhe etwas erniedrigt ---------------- Version 1.42 vom 13.9.1995 ------------------- · das XOpa-Verzeichnis wird nun auch von der Shell aus gefunden · Bei einer Änderung der Fenstergröße bleibt die aktuelle Scroller- position und der selektierte Eintrag erhalten (Vorschläge von Edwin Bielawski) · nutzt jetzt NameFromLock-Funktion statt eigene · weitere Optimierungen ---------------- Version 1.45 vom 18.9.1995 ------------------- · neuer ToolType "ICONXY" mit dem man die Position des Iconify- Icons festlegen kann ---------------- Version 1.45 vom 26.9.1995 ------------------- · mehrere Fehlermeldungen geändert · Programmoptimierungen · Funktionsgadgets beim Geschwindigkeitstest deaktiviert ---------------- Version 1.842 vom 2.11.1995 ------------------ · LOCALE-FÄHIGKEIT!! (endlich dazu durchgerungen) · Fenstertooltype WINDOW funktionierte nicht (vergessene Debuganweisung) · Speicheranzeige in der Systeminfoliste rundet jetzt (richtig) · Die unterschiedlichen Fensterrandhöhen (z.B. durch sysihack) werden nun berücksichtigt · Die Gadgets der Funktionsleiste werden jetzt erst anwählbar, wenn man ein Objekt aus der Liste angeklickt hat ---------------- Version 1.842 vom 6.11.1995 ------------------ · die Tastaturbedienung ist nun ebenfalls für locale fertig · die Task-Pri wird nun anders ausgelesen (fängt mögliche Probleme mit falschen Stackzeigern ab) · die Gadgets der Funktionsleiste sind nun auch lokalisiert ---------------- Version 1.842 vom 8.11.1995 ------------------ · einige Gadgettexte werden jetzt automatisch abgekürzt, wenn der Text zu lang ist (z.B. Interrupts, Entfernen) · es gibt jetzt nur noch ein Catalog-File für die registrierte und unregistrierte Version · die Gadgets für die Funktionen und die Anzeigemodi waren zu niedrig (Fonthöhe+2/+3) · die Höhe des "Ok"-Gadgets der Fontanzeige war auch zu niedrig · Programmoptimierungen · die Funktionsgadgetes blieben nach einer ausgeführten Aktion weiter anwählbar · Im Neuer-Assign-Requester war das Verzeichnis-Gadget seit der Lokalisierung zu breit · aus allen Requestern läßt sich jetzt mit der "Help"-Taste das Guide aufrufen ---------------- Version 1.842 vom 13.11.1995 ----------------- · XOpa fängt nicht in Library-Strukturen eingebettete Resources nun ab · erkennt den DraCo nach der offiziellen Methode ---------------- Version 1.842 vom 11.12.1995 ----------------- · bei der Fensteranzeige blieb "Windows" deaktiviert · der Speicherbereich des Speichertestes liegt nun nicht mehr komplett im Cache des 68060 :) · kleine Widerlichkeit in der Screenliste: bei Grafikkarten wurden die ganzen 4 Bytes dargestellt... · bei den Task-Fenster-Relationen wurde vom Vorhandensein des UserPorts ausgegangen · Geschwindigkeitstest nun mit Screenmodeauswahl · Wegen Clippingproblemen der RetinaEmu, sind die Geraden nun nicht mehr schräg · Multi-Assigns werden jetzt auch angezeigt ---------------- Version 1.842 vom 13.12.1995 ----------------- · beim Grafiktest wurde bei RectFill() bei bestimmten Auf- loesungen ueber den Screen hinaus geschrieben, was zum Absturz fuehren konnte · beim Speichertest wird wieder Forbid()/Permit() benutzt ---------------- Version 1.842 vom 15.12.1995 ----------------- · ein mit der Version 1.842 neu eingeführter Fehler beim Doppelklick wurde entfernt (Variablenmißbrauch) · möglicher Enforcer-Hit bei manchen Tasks (Taskinfos) beseitigt ---------------- Version 1.842 vom 19.12.1995 ----------------- · Fehler im "Node-Struktur" Requester beseitigt: die Anwahl des "Abbrechen" Gadgets bewirkte das gleiche wie die des "Weiter" Gadgets. ---------------- Version 1.86 vom 10.1.1996 ------------------- · Workaround fuer einen Bug in der dos.library