mirror of
https://github.com/mi57730/a2d.git
synced 2024-08-14 06:29:10 +00:00
1.1 KiB
1.1 KiB
Desk Accessory API
Desk Accessories for DeskTop have general access to the Mouse Graphics Tool Kit MLI, ProDOS MLI, and DeskTop APIs. Special considerations for DAs are documented here.
Desk Accessory Lifecycle
- Loaded/invoked at $800 MAIN (have through $1FFF available)
- Save stack pointer
- Copy DA code from MAIN to AUX (e.g. using
AUXMOVE
) at same address. - Transfer control to the AUX copy
- This allows direct access to MGTK/DeskTop MLI
- Retaining a copy in MAIN allows easy access to ProDOS MLI
- Turn on ALTZP and LCBANK1
- Create window (
OpenWindow
) - Draw everything
- Flush event queue (
FlushEvents
) - Run an event Loop (
GetEvent
, and subsequent processing, per MGTK)- Normal event processing per MGTK
- In addition, following a window drag/resize, DeskTop calls must be made:
JUMP_TABLE_REDRAW_ALL
DESKTOP_REDRAW_ICONS
- ...
- Destroy window (
CloseWindow
) - Tell DeskTop to redraw desktop icons (
DESKTOP_REDRAW_ICONS
) - Switch control back to MAIN (
RAMRDOFF
/RAMWRTOFF
) - Ensure ALTZP and LCBANK1 are on
- Restore stack pointer
rts