The DOCOL subroutine - Elite on the BBC Micro and NES

       Name: DOCOL                                                   [Show more]
       Type: Subroutine
   Category: Text
    Summary: Set the text colour by sending a #SETCOL command to the I/O
             processor
    Context: See this subroutine in context in the source code
 References: This subroutine is called as follows:
             * DEATH calls DOCOL
             * dockEd calls DOCOL
             * ee3 calls DOCOL
             * gnum calls DOCOL
             * HME2 calls DOCOL
             * hyp calls DOCOL
             * LASLI calls DOCOL
             * LL9 (Part 1 of 12) calls DOCOL
             * MESS calls DOCOL
             * NLIN2 calls DOCOL
             * PBFL calls DOCOL
             * PLANET calls DOCOL
             * SIGHT calls DOCOL
             * SLIDE calls DOCOL
             * TITLE calls DOCOL
             * TRADEMODE calls DOCOL
             * TT102 calls DOCOL
             * TT128 calls DOCOL
             * TT14 calls DOCOL
             * TT15 calls DOCOL
             * TT22 calls DOCOL
             * TT23 calls DOCOL
             * TTX66 calls DOCOL
             * WHITETEXT calls DOCOL
             * ZZAAP calls DOCOL


 Arguments:

   A                    The text colour


.DOCOL

 PHA                    \ Store A, the colour number, on the stack

 LDA #SETCOL            \ Set A to #SETCOL, ready to send to the I/O processor

 BNE label              \ Jump to label to send a #SETCOL <colour> command to
                        \ the I/O processor, returning from the subroutine
                        \ using a tail call (this BNE is effectively a JMP as A
                        \ is never zero)
Text: DOCOL

[6502 Second Processor version]
