mirror of https://github.com/alfishe/amiga-bootcamp.git synced 2026-06-13 00:26:28 +00:00

Ilia Sharin 21751c0025 docs(amiga): complete AmigaOS 3.1/3.2 developer reference — 172 files across 17 sections

Comprehensive technical documentation covering:
- Hardware: OCS/ECS/AGA custom chip registers, Copper & Blitter deep dives
- Boot sequence: cold boot through startup-sequence
- Binary format: HUNK executable spec, relocation, debug info
- Linking & ABI: .fd files, LVO tables, register calling conventions
- Exec kernel: tasks, interrupts, memory, signals, semaphores
- AmigaDOS: file I/O, FFS/OFS layout, CLI/Shell scripting
- Graphics: planar bitmaps, Copper programming, HAM/EHB modes
- Intuition: screens, windows, IDCMP, BOOPSI
- Devices: trackdisk, SCSI, serial, timer, audio, keyboard
- Libraries: utility, expansion, IFFParse, locale, ARexx
- Networking: bsdsocket API, SANA-II, TCP/IP stack comparison
- Toolchain: GCC, vasm/vlink, SAS/C, NDK, debugging
- Reverse engineering: IDA/Ghidra setup, compiler fingerprints, case studies
- CPU & MMU: 68040/060 emulation libs, PMMU, cache management
- Driver development: SANA-II, Picasso96/RTG, AHI audio

All files include breadcrumb navigation. No local paths or proprietary content.

2026-04-23 12:17:35 -04:00

3.2 KiB

Raw Blame History

← Home · Intuition

Input Events — InputEvent, input.device, Commodities

Overview

All user input (keyboard, mouse, joystick) flows through input.device as InputEvent structures. Commodities Exchange provides a high-level API for hotkeys and input filtering.

struct InputEvent

/* devices/inputevent.h — NDK39 */
struct InputEvent {
    struct InputEvent *ie_NextEvent;
    UBYTE   ie_Class;       /* IECLASS_* */
    UBYTE   ie_SubClass;
    UWORD   ie_Code;        /* keycode or button code */
    UWORD   ie_Qualifier;   /* IEQUALIFIER_* flags */
    union {
        struct { WORD ie_x, ie_y; } ie_xy;
        APTR   ie_addr;
        struct { UBYTE ie_prev1DownCode, ie_prev1DownQual;
                 UBYTE ie_prev2DownCode, ie_prev2DownQual; } ie_dead;
    } ie_position;
    struct timeval ie_TimeStamp;
};

Event Classes

Class	Constant	Description
`IECLASS_RAWKEY`	`$01`	Raw keyboard event
`IECLASS_RAWMOUSE`	`$02`	Raw mouse button/movement
`IECLASS_EVENT`	`$03`	Cooked event from Intuition
`IECLASS_POINTERPOS`	`$04`	Absolute pointer position
`IECLASS_TIMER`	`$06`	Timer event
`IECLASS_GADGETDOWN`	`$07`	Gadget pressed
`IECLASS_GADGETUP`	`$08`	Gadget released
`IECLASS_DISKINSERTED`	`$09`	Disk inserted
`IECLASS_DISKREMOVED`	`$0A`	Disk removed
`IECLASS_NEWPREFS`	`$0C`	Preferences changed

Commodities Exchange

struct Library *CxBase = OpenLibrary("commodities.library", 37);

/* Create a hotkey filter: */
CxObj *broker = CxBroker(&nb, NULL);
CxObj *filter = CxFilter("ctrl alt d");        /* hotkey string */
CxObj *sender = CxSender(port, CX_HOTKEY_ID);  /* send msg to port */
AttachCxObj(filter, sender);
AttachCxObj(broker, filter);
ActivateCxObj(broker, TRUE);

/* In event loop: */
CxMsg *msg;
while ((msg = (CxMsg *)GetMsg(port))) {
    ULONG type = CxMsgType(msg);
    ULONG id   = CxMsgID(msg);
    ReplyMsg((struct Message *)msg);
    if (type == CXM_COMMAND && id == CXCMD_KILL) running = FALSE;
    if (type == CXM_IEVENT && id == CX_HOTKEY_ID) /* hotkey pressed */;
}

DeleteCxObjAll(broker);
CloseLibrary(CxBase);

Input Handler Installation

/* Add a custom input handler (runs in input.device context): */
struct Interrupt handler;
handler.is_Code = (APTR)myInputHandler;
handler.is_Data = myData;
handler.is_Node.ln_Pri = 51;  /* priority (above Intuition=50) */
handler.is_Node.ln_Name = "MyHandler";

struct IOStdReq *inputReq;
/* ... open input.device ... */
inputReq->io_Command = IND_ADDHANDLER;
inputReq->io_Data = &handler;
DoIO((struct IORequest *)inputReq);

/* Handler function: */
struct InputEvent * __saveds myInputHandler(
    struct InputEvent *events __asm("a0"),
    APTR data __asm("a1"))
{
    struct InputEvent *ev;
    for (ev = events; ev; ev = ev->ie_NextEvent) {
        if (ev->ie_Class == IECLASS_RAWKEY && ev->ie_Code == 0x45) {
            ev->ie_Class = IECLASS_NULL;  /* swallow ESC key */
        }
    }
    return events;
}

References

NDK39: devices/inputevent.h, libraries/commodities.h
ADCD 2.1: CxBroker, CxFilter, CxSender, input.device

3.2 KiB Raw Blame History