Apple-2-SW/a2d
1
0
Fork 0
mirror of https://github.com/mi57730/a2d.git synced 2025-02-20 02:29:11 +00:00
Code Issues Projects Releases Wiki Activity

docs

Browse Source
This commit is contained in:
Joshua Bell 2018-02-19 19:21:10 -08:00
parent 1b2738a48b
commit 194034239d
2 changed files with 61 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
APIs.md
View File

@ -93,23 +93,23 @@ absolute path (e.g. `/HD/GAMES`)
Icon record: 27-byte structure optimized for rendering the file/volume icon. Icon record: 27-byte structure optimized for rendering the file/volume icon.
``` ```
.byte icon icon index .byte icon icon index
.byte ?? .byte ??
.byte type/window_id .byte type/window_id
(bits 0-3 window_id) (bits 0-3 window_id)
(bits 4,5,6) (bits 4,5,6)
000 = directory 000 = directory
001 = system 001 = system
010 = binary 010 = binary
011 = basic 011 = basic
100 = (unused) 100 = (unused)
101 = text/generic 101 = text/generic
110 = (unused) 110 = (unused)
111 = trash 111 = trash
(bit 7 = open flag) (bit 7 = open flag)
.word iconx (pixels) .word iconx (pixels)
.word icony (pixels) .word icony (pixels)
.addr iconbits (addr of {mapbits, mapwidth, reserved, maprect}) .addr iconbits (addr of {mapbits, mapwidth, reserved, maprect})
.byte len (name length + 2) .byte len (name length + 2)
.res 17 name (name, with a space before and after) .res 17 name (name, with a space before and after)
``` ```

54
MGTK.md
View File

@ -129,6 +129,19 @@ otherwise:
.word mousey .word mousey
``` ```
```
event_kind_no_event := 0 ; No mouse or keypress
event_kind_button_down := 1 ; Mouse button was depressed
event_kind_button_up := 2 ; Mouse button was released
event_kind_key_down := 3 ; Key was pressed
event_kind_drag := 4 ; Mouse button still down
event_kind_apple_key := 5 ; Mouse button was depressed, modifier key down
event_kind_update := 6 ; Window update needed
event_modifier_open_apple := 1 << 0
event_modifier_solid_apple := 1 << 1
```
### Menu ### Menu
Menu Bar record: Menu Bar record:
@ -181,7 +194,17 @@ Windows have a _content area_ which has the requested dimensions. Above this is
_title bar_ which in turn has an optional _close box_. Within the content area are an _title bar_ which in turn has an optional _close box_. Within the content area are an
optional _resize box_ and optional _scroll bars_. optional _resize box_ and optional _scroll bars_.
```
option_dialog_box := 1 << 0
option_go_away_box := 1 << 1
option_grow_box := 1 << 2
scroll_option_none := 0
scroll_option_present := 1 << 7
scroll_option_thumb := 1 << 6
scroll_option_active := 1 << 0
scroll_option_normal := scroll_option_present | scroll_option_thumb | scroll_option_active
```
## Commands ## Commands
Includes: Includes:
@ -195,14 +218,15 @@ Includes:
## More ## More
> NOTE: Movable windows must maintain an _offscreen_flag_. If a window is moved so that the > NOTE: Movable windows must maintain an _offscreen_flag_. If a window is moved so that the
> content area is entirely offscreen then various operations should be skipped because > content area is entirely offscreen then various operations should be skipped because
> the window's box coordinates will not be set correctly. > the window's box coordinates will not be set correctly.
### Use by DAs
#### Input Loop #### Input Loop
* Call GetEvent. * Call `GetEvent`.
* If a key, then check modifiers (Open/Solid Apple) and key code, ignore or take action. * If a key, then check modifiers (Open/Solid Apple) and key code, ignore or take action.
* If a click, call FindWindow. * If a click, call FindWindow.
* If target id not the window id, ignore. * If target id not the window id, ignore.
@ -210,29 +234,35 @@ Includes:
* If target element is close box then initiate [window close](#window-close). * If target element is close box then initiate [window close](#window-close).
* If target element is title bar then initiate [window drag](#window-drag). * If target element is title bar then initiate [window drag](#window-drag).
* If target element is resize box then initiate [window resize](#window-resize). * If target element is resize box then initiate [window resize](#window-resize).
* Otherwise, it is content area; call FindControl. * Otherwise, it is content area; call `FindControl`.
* If content part is a scrollbar then initiate a [scroll](#window-scroll). * If content part is a scrollbar then initiate a [scroll](#window-scroll).
* Otherwise, handle a content click using custom logic (e.g. hit testing buttons, etc) * Otherwise, handle a content click using custom logic (e.g. hit testing buttons, etc)
#### Window Close #### Window Close
* Call TrackGoAway, which enters a modal loop to handle the mouse moving out/in the box. * Call `TrackGoAway`, which enters a modal loop to handle the mouse moving out/in the box.
* Result indicates clicked or canceled * Result indicates clicked or canceled. If canceled, return to input loop.
* Call `CloseWindow`
#### Window Drag #### Window Drag
* Call DragWindow. * Call `DragWindow`, which enters a modal loop to handle the mouse moving out/in the box.
* Call JUMP_TABLE_REDRAW_ALL. * Result indicates moved or canceled. If canceled, return to input loop.
* If _offscreen flag_ was not set, redraw desktop icons (DESKTOP_REDRAW_ICONS). * Call `JUMP_TABLE_REDRAW_ALL`.
* If _offscreen flag_ was not set, redraw desktop icons (`DESKTOP_REDRAW_ICONS`).
* Set _offscreen flag_ if window's `top` is greater than or equal to the screen bottom (191), clear otherwise. * Set _offscreen flag_ if window's `top` is greater than or equal to the screen bottom (191), clear otherwise.
* If _offscreen flag_ is not set, redraw window. * If _offscreen flag_ is not set, redraw window.
#### Window Resize #### Window Resize
* Call GrowWindow. * Call `GrowWindow`, which enters a modal loop to handle resizing.
* Call JUMP_TABLE_REDRAW_ALL. * Result indicates changed or canceled. If canceled, return to input loop.
* Call DESKTOP_REDRAW_ICONS. * Call `JUMP_TABLE_REDRAW_ALL`.
* Call UpdateThumb if needed to adjust scroll bar settings. (Details TBD). * Call `DESKTOP_REDRAW_ICONS`.
* Call `UpdateThumb` if needed to adjust scroll bar settings.
* Redraw window. * Redraw window.
#### Window Scroll #### Window Scroll
* Call `TrackThumb`, which enters a modal loop to handle dragging.
* Redraw window.