The Graphics VDU

&BBBA GRA INITIALISE
Action Initialises the graphics VDU to its default set-up (ie its set-up when the computer is switched on)
Entry No entry conditions
Exit AF, BC, DE and HL are corrupt, and all other registers are preserved
Notes Sets the graphics indirections to their defaults, sets the graphic paper to text pen 0 and the graphic pen to text pen 1, reset the graphics origin and move the graphics cursor to the bottom left of the screen, reset the graphics window and write mode to their defaults
&BBBD GRA RESET
Action Resets the graphics VDU
Entry No entry conditions
Exit AF, BC, DE and HL are corrupt, and all others are preserved
Notes Resets the graphics indirections and the graphics write mode to their defaults
&BBC0 GRA MOVE ABSOLUTE
Action Moves the graphics cursor to an absolute screen position
Entry DE contains the user X-coordinate and HL holds the user Y-coordinate
Exit AF, BC, DE and HL are corrupt, and all other registers are preserved
&BBC3 GRA MOVE RELATIVE
Action Moves the graphics cursor to a point relative to its present screen position
Entry DE contains the X-distance to move and HL holds the Y-distance
Exit AF, BC, DE and HL are corrupt, and all others are preserved
&BBC6 GRA ASK CURSOR
Action Gets the graphics cursor's current position
Entry No entry conditions
Exit DE holds the user X-coordirlate, HL holds the user Y-coordinate, AF is corrupt, and all others nre preserved
&BBC9 GRA SET ORIGIN
Action Sets the graphics user origin's screen position
Entry DE contains the standard X-coordinate and HL holds the standard Y-coordinate
Exit AF, BC, DE and HL are corrupt, and all other registers are preserved
&BBCC GRA GET ORIGIN
Action Gets the graphics user origin's screen position
Entry No entry conditions
Exit DE contains the standard X-coordinate and HL holds the standard Y-coordinate, and all others are preserved
&BBCF GRA WIN WIDTH
Action Sets the left and right edges of the graphics window
Entry DE contains the standard X-coordinate of one edge and HL holds the standard X-coordinate of the other side
Exit AF, BC, DE and HL are corrupt, and all the other registers are preserved
Notes The default window covers the entire screen and is restored to its default when the mode is changed; used in conjunction with GRA WIN HEIGHT
&BBD2 GRA WIN HEIGHT
Action Sets the top and bottom edges of the graphics window
Entry DE contains the standard Y-coordinate of one side and HL holds the standard Y-coordinate of the other side
Exit AF, BC, DE and HL are corrupt, and all others are preserved
Notes See GRA WIN WIDTH for further details
&BBD5 GRA GET W WIDTH
Action Gets the left and right edges of the graphics window
Entry No entry conditions
Exit DE contains the standard X-coordinate of the left edge and HL contains the standard Y-coordinate of the right edge, AF is corrupt, and all other registers are preserved
&BBD8 GRA GET W HEIGHT
Action Gets the top and bottom edges of the graphics window
Entry No entry conditions
Exit DE contains the standard Y-coordinate of the top edge and HL contains the standard Y-coordinate of the bottom edge, AF is corrupt, and all other registers are preserved
&BBDB GRA CLEAR WINDOW
Action Clears the graphics window to the graphics paper colour and moves the cursor back to the user origin
Entry No entry conditions
Exit AF, BC, DE and HL are corrupt, and all other registers are preserved
&BBDE GRA SET PEN
Action Sets the graphics PEN
Entry A contains the required text PEN number
Exit AF is corrupt, and all other registers are preserved
&BBE1 GRA GET PEN
Action Gets the graphics PEN
Entry No entry conditions
Exit A contains the text PEN number, the flags are corrupt, and all other registers are preserved
&BBE4 GRA SET PAPER
Action Sets the graphics PAPER
Entry A contains the required text PEN number
Exit AF corrupt, and all others are preserved
&BBE7 GRA GET PAPER
Action Gets the graphics PAPER
Entry No entry conditions
Exit A contains the text PEN number, the flags are corrupt, and all others are preserved
&BBEA GRA PLOT ABSOLUTE
Action Plots a point at an absolute user coordinate, using the GRA PLOT indirection
Entry DE contains the user X-coordinate and HL holds the user Y-coordinate
Exit AF, BC, DE and HL are corrupt, and all others are preserved
&BBED GRA PLOT RELATIVE
Action Plots a point at a position relative to the current graphics cursor, using the GRA PLOT indirection
Entry DE contains the relative X-coordinate and HL contains the relative Y-coordinate
Exit AF, BC, DE and HL are corrupt, and all other registers are preserved
&BBF0 GRA TEST ABSOLUTE
Action Moves to an absolute position, and tests the point there using the GRA TEST indirection
Entry DE contains the user X-coordinate and HL holds the user Y-coordinate for the point you wish to test
Exit A contains the pen at the point, and BC, DE, HL and flags are corrupt, and all others are preserved
&BBF3 GRA TEST RELATIVE
Action Moves to a position relative to the current position, and tests the point there using the GRA TEST indirection
Entry DE contains the relative X-coordinate and HL contains the relative Y-coordinate
Exit A contains the pen at the point, and BC, DE, HL and flags are corrupt, and all others are preserved
&BBF6 GRA LlNE ABSOLUTE
Action Draws a line from the current graphics position to an absolute position, using GRA LINE
Entry DE contains the user X-coordinate and HL holds the user Y-coordinate of the end point
Exit AF, BC, DE and HL are corrupt, and all others are preserved
Notes The line will be plotted in the current graphics pen colour (may be masked to produce a dotted line on a 6128)
&BBF9 GRA LINE RELATIVE
Action Draws a line from the current graphics position to a relative screen position, using GRA LINE
Entry DE contains the relative X-coordinate and HL contains the relative Y-coordinate
Exit AF, BC, DE and HL are corrupt, and all other registers are preserved
Notes See GRA LINE ABSOLUTE above for details of how the line is plotted
&BBFC GRA WR CHAR
Action Writes a character onto the screen at the current graphics position
Entry A contains the character to be put onto the screen
Exit AF, BC, DE and HL are corrupt, and all the other registers are preserved
Notes As in BASIC, all characters including control codes are printed; the character is printed with its top left corner at the current graphics position; the graphics position is moved one character width to the right so that it is ready for another character to be printed