summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/GameExec.doc158
-rw-r--r--Documentation/README70
2 files changed, 228 insertions, 0 deletions
diff --git a/Documentation/GameExec.doc b/Documentation/GameExec.doc
new file mode 100644
index 0000000..e9818bf
--- /dev/null
+++ b/Documentation/GameExec.doc
@@ -0,0 +1,158 @@
+GAME EXEC - The ultimate Amiga operating system for game development
+---------
+
+Version 4.4, 16-Apr-92
+
+© 1987-92 Christian A. Weber, Christian B. Haller, René Straub, Roman Werner
+
+
+
+ *** Erlaubte Einträge in MyExecBase:
+
+ APTR meb_SuperStackUpper ; SuperStack am Anfang (READ ONLY!)
+ WORD meb_AttnFlags ; Kopie von ExecBase->AttnFlags
+ WORD meb_SystemBplcon0 ; Kopie von gfxbase->system_bplcon0
+ BYTE meb_VBlankFrequency ; Kopie von ExecBase->VBlankFrequency
+ BYTE meb_expad2
+
+ BYTE meb_ActualKey ; RawKeyCode
+ BYTE meb_ActualQualifiers ; Qualifier-Bits, (BitNr=KeyCode-$60)
+ BYTE meb_ActualASCIIKey ; ASCII-Code
+ BYTE meb_CheatFlag ; >0 falls Cheat mode on
+
+ STRUCT meb_BobList,lh_SIZEOF ; für die Bobroutine
+ APTR meb_TripleScreen ; für die Bobroutine
+ WORD meb_SignalSet ; für die Bobroutine
+
+ LONG meb_UserData1 ; Frei für den User, am Anfang 0
+ LONG meb_UserData2 ; Frei für den User, am Anfang 0
+
+ STRUCT meb_exreserved,6 ; + pad auf LONG, NICHT benutzen!
+
+ *** Level 3 Interrupt-Vektoren, zum Patchen oder 0 reinschreiben
+
+ UWORD meb_VBLIntPad
+ UWORD meb_VBLIntJump
+ APTR meb_VBLIntVector
+
+ UWORD meb_CopperIntPad
+ UWORD meb_CopperIntJump
+ APTR meb_CopperIntVector
+
+ *** Cia-Interrupt-Vektoren, zum Patchen oder 0 reinschreiben
+
+ APTR meb_CiaATimerAVector
+ APTR meb_CiaATimerBVector
+ APTR meb_CiaAAlarmVector
+ APTR meb_CiaASerialVector
+ APTR meb_CiaAFlagVector
+
+ APTR meb_CiaBTimerAVector
+ APTR meb_CiaBTimerBVector
+ APTR meb_CiaBAlarmVector
+ APTR meb_CiaBSerialVector
+ APTR meb_CiaBFlagVector
+
+
+ *** System-Funktionen (use at your own risk!)
+
+ ULONG meb_SecretMagic ; PRIVAT
+ FUNCTION InitExec ; (ExecEvent) (CRP)
+ FUNCTION ColdReboot ; () ()
+ FUNCTION InitChipMem ; (Address,Size) (A0/D0)
+ FUNCTION InitFastMem ; (Address,Size) (A0/D0)
+ FUNCTION InitDisk ; (Product) (D0)
+ FUNCTION InitKey ; () ()
+ FUNCTION SetCache ; (NewCacheBits) (D0)
+
+ *** Debug-Funktionen
+
+ FUNCTION Debug ; () ()
+
+ *** Speicherverwaltung
+
+ FUNCTION AllocMem ; (Amount) (D0)
+ FUNCTION AllocClearMem ; (Amount) (D0)
+ FUNCTION AllocFastMem ; (Amount) (D0)
+ FUNCTION AllocFastClearMem ;(Amount) (D0)
+ FUNCTION FreeMem ; (Address) (A1)
+ FUNCTION AvailMem ; () ()
+ FUNCTION AvailFastMem ; () ()
+ FUNCTION CheckMem ; () ()
+ FUNCTION CopyMem ; (Src,Dest,Len) (A0/A1/D0)
+ FUNCTION CopyMemQuick ; (Src,Dest,Len) (A0/A1/D0)
+ FUNCTION ClearMem ; (Address,Len) (A0/D0)
+
+ *** Semaphoren
+
+ FUNCTION Disable ; () ()
+ FUNCTION Enable ; () ()
+ FUNCTION OwnBlitter ; () ()
+ FUNCTION DisownBlitter ; () ()
+
+ *** Listenverwaltung
+
+ FUNCTION NewList ; (List) (A0)
+ FUNCTION Enqueue ; (List,Node) (A0/A1)
+ FUNCTION Remove ; (Node) (A1)
+ FUNCTION AddHead ; (List,Node) (A0/A1)
+ FUNCTION AddTail ; (List,Node) (A0/A1)
+ FUNCTION RemHead ; (List) (A0)
+
+ *** Tastatur
+
+ FUNCTION GetKey ; () ()
+ FUNCTION WaitKey ; () ()
+ FUNCTION FlushKeyBuf ; () ()
+ FUNCTION SetMap ; (KeyMap oder 0) (A0)
+ FUNCTION SetResetHandler ; (Handler) (A0)
+ FUNCTION SetCheatText ; (RawKeyCodes) (A0)
+
+ *** Ausgabe
+
+ FUNCTION RawDoFmt ; (wie normal :-)) (...)
+ FUNCTION RawPrintf ; (Stack) (...)
+ FUNCTION PlayCDTrack ; (TrackNumber) (D0)
+ FUNCTION WaitCDTrack ; (nüt) ()
+
+ *** Zufall
+
+ FUNCTION Randomize ; (Value1,Value2) (D0/D1)
+ FUNCTION Random ; (Limit) (D0)
+
+ *** Disk-Routinen
+
+ FUNCTION SetNoDiskHandler ;(Routine) (A0)
+ FUNCTION ReadFile ; (Name,Address) (D0/A0)
+ FUNCTION WriteFile ; (Name,Address) (D0/A0)
+ FUNCTION LoadFile ; (Name) (D0)
+ FUNCTION LoadFastFile ; (Name) (D0)
+ FUNCTION LoadSeg ; (Name) (D0)
+ FUNCTION UnLoadSeg ; (Segment) (A1)
+ FUNCTION BufReadFile ; (Name,Address (D0/A0)
+ FUNCTION BufLoadFile ; (Name) (D0)
+ FUNCTION DeleteFileNode ; (Name) (D0)
+ FUNCTION DeleteFileList ; () ()
+ FUNCTION SendPacket ; (Packet) (A0)
+
+ *** Bob-Routinen
+
+ FUNCTION WaitBlit ; (Custom) (A5)
+ FUNCTION InitDrawBob ; (BitMap) (A0)
+ FUNCTION AddBob ; (NewBob) (A1)
+ FUNCTION RemBob ; (Bob) (A0)
+ FUNCTION RemAllBobs ; () ()
+ FUNCTION RestoreBobList ; (BitMap) (A1)
+ FUNCTION DrawBobList ; (BitMap) (A1)
+ FUNCTION RestoreOneBob ; (Bob,BitMap) (A0/A1)
+ FUNCTION DrawOneBob ; (Bob,BitMap) (A0/A1)
+ FUNCTION AnimateOneBob ; (Bob) (A0)
+ FUNCTION MoveOneBob ; (Bob) (A0)
+ FUNCTION TestPoint ; (X,Y) (D0/D1)
+ FUNCTION SetMovePrg ; (Bob,MPrg,Speed,Step) (A0/A1/D0/D1)
+ FUNCTION SetAnimPrg ; (Bob,APrg,Speed) (A0/A1/D0)
+ FUNCTION SetGlobalClip ; (X,Y) (D0/D1)
+ FUNCTION HandleCollision ; () ()
+ FUNCTION CollOneBob ; (Bob) (A0)
+ FUNCTION FlashBob ; (Bob,Time,Color) (A0/D0/D1)
+ FUNCTION GetBobData ; (Bob) (A0)->A2
diff --git a/Documentation/README b/Documentation/README
new file mode 100644
index 0000000..264a52b
--- /dev/null
+++ b/Documentation/README
@@ -0,0 +1,70 @@
+GAME EXEC - The ultimate Amiga operating system for game development
+---------
+
+Version 4.4, 16-Apr-92
+
+© 1987-92 Christian A. Weber, Christian B. Haller, René Straub, Roman Werner
+
+
+Features
+--------
+
+- Powerful debugging function, such as debug output to serial port or calling
+ ROMCrack, the ultimate Kickstart-based monitor/disassembler by SCA
+
+- Memory managment (Allocate, clear, copy Chip + Fast mem)
+
+- Semaphores (Disable/Enable interrupts, Own/Disown blitter in System mode)
+
+- Linked List management
+
+- Keyboard handler including support for custom keymaps
+
+- Output formatting (printf-style)
+
+- Optional CDTV functions: play audio tracks
+
+- Random number generator
+
+- Powerful interrupt-driven floppy disk routines supporting up to 4 dives
+ supporting PowerPacker-compressed files and loading in the background
+
+- BOBOL® the ultimate Bob Animation System: Bob rendering, double/triple
+ buffering, Animation, collision testing, clipping etc. using a powerful
+ control languange
+
+
+Versions
+--------
+
+There are 3 versions of Game Exec:
+
+- Standard version: Runs completely without Amiga OS
+
+- System version (SysStart): runs within Amiga OS (used for development)
+ this version optionally supports the CDTV
+
+- Ram version (runs without Amiga OS, but uses a FFS ram disk instead of floppy)
+
+
+Modification History
+--------------------
+
+18-May-89 CHW Recreated this file!
+20-Jun-89 CHW Supports 1MB CHIP RAM
+29-Jun-89 CHW Auf Genim2 umgeschrieben
+22-Aug-89 CHW AddHead() added
+27-Aug-89 CHW AddHead() rettet nun die Register (!^%#$@)
+13-Sep-89 CHW CopyMem() rettet nun D0 (grmbl!)
+06-Nov-89 CHW SetCache() added
+27-Nov-89 CHW FastMem support routines added
+04-Feb-90 CHW Zero-Handler & other Guru handlers added
+11-Feb-90 CHW Supervisor-Stack ist jetzt im FAST-RAM
+28-Mar-90 CHW ColdReboot() implementiert, ABORT springt dahin
+18-Sep-90 CHW CheckMem() implementiert und so
+20-Oct-90 CHW Config-File entfernt, MainPrg muss am Anfang sein
+30-Dec-90 CHW Gecrunchte Files werden automatisch entcruncht
+06-Jan-91 CHH BufLoadFile testet ob genug RAM vorhanden ist
+11-Feb-91 CHH BufReadFile eingebaut
+18-Feb-91 CHW Multitasking-fähige Version
+06-May-91 CHW Diskroutine kann jetzt schreiben