Sherlock: annotated disassembly

Routines

Prev: F1A8 Up: Map Next: F1D6
F1C1: Set a thing's state word and state bits
Thing A's +9/+10 = DE (a dictionary word shown with it, such as SLEEPING, or 0) and the high nibble of +8 = B.
Input
A A thing number
DE The state word (0 for none)
B The high nibble for +8
Output
IX The thing's record
F NZ
F1C1 CALL $D237 IX = thing A's record
F1C4 LD (IX+$09),E Store E in byte +9 of the record at IX - Its state word (+9/+10) = DE
F1C7 LD (IX+$0A),D Store D in byte +10 of the record at IX
F1CA LD A,(IX+$08) Read byte +8 of the record at IX into A - +8: keep the low nibble, replace the high nibble with B
F1CD AND $0F Keep only bits 0, 1, 2, 3 of A (mask $0F)
F1CF OR B Set in A the bits that are set in B
F1D0 LD (IX+$08),A Store A in byte +8 of the record at IX
F1D3 OR $01 Make A non-zero, which clears the zero flag, and hand that back to the caller - Succeed
F1D5 RET Return to the caller
Prev: F1A8 Up: Map Next: F1D6