User Tools

Site Tools


base:reference_for_hes_graphics_basic_1.07

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

base:reference_for_hes_graphics_basic_1.07 [2015-04-17 04:33] (current)
Line 1: Line 1:
 +Reference for HES GRAPHICS BASIC 1.07\\
 +Initial document by Kurious\\
 +*This document currently is incomplete*\\
  
 +Colors: There are identifiers for the 16 colors
 +   BLACK
 +   WHITE
 +   RED
 +   CYAN
 +   PURPLE
 +   GREEN
 +   BLUE
 +   YELLOW
 +   PEACH
 +   BROWN
 +   PINK
 +   GRAY1
 +   GRAY2
 +   LGREEN
 +   SKY
 +   GRAY3
 +
 +Parameters:
 +   <color> - numeric value/variable or one of the color identifiers above
 +   <sprite> - sprite number from 1 to 8
 +   <voice> - an audio voice number from 1 to 3
 +   <device> - default device is 8
 +   [] - optional parameter
 +   {<etc>|<etc>|<etc>} - a choice of parameters
 +   [,<etc>...] - can repeat many times
 +
 +Graphics commands:
 +   HIRES and MULTI modes display the same graphics buffer in different ways
 +   The origin (0,0) lies at the lower left corner; coordinates are used as in typical math
 +   TEXT - Switch to text mode
 +   HIRES - Switch to HIRES mode
 +   MULTI - Switch to MULTI mode
 +   BACKGROUND <color> - Choose background color
 +   BORDER <color> - Choose border color
 +   HIRES COLOR <color> ON <color> - Choose foreground and background hires colors
 +   MULTI COLOR <color>,<color>,<color> - Choose multicolor colors
 +   CLEAR [<pattern>] - Clear the graphics buffer using pattern (0-255), default 0
 +   FILL <x>,<y> - Fill at the specified coordinate
 +   DOT <x>,<y> - Draw a dot at the specified coordinate
 +   LINE <x1>,<y1> TO <x2>,<y2> - Draw a line
 +   BOX <x1>,<y1> TO <x2>,<y2> - Draw the outline of a box
 +   GPRINT <string> - Print the string within the graphics buffer
 +   SETORIGIN <x>,<y> - Change the location of the origin
 +   WINDOW <x1>,<y1>,<x2>,<y2> - Clip graphics commands to occur within this window
 +   WINDOW - Issue without parameters to remove the window
 +   SCALE <x>,<y> - Choose a different scale (NOTE: Command is accepted but doesn't seem to work)
 +
 +Sprite commands:
 +   The following commands can be combined, i.e., SPRITE 1 ON AT 10,10 COLOR BLUE
 +   SPRITE <sprite> {ON|OFF} - Turn sprite on or off
 +   SPRITE <sprite> SHAPE <value> - The value is from 0 to 255
 +   SPRITE <sprite> COLOR <color> - Choose sprite color
 +   SPRITE <sprite> XYSIZE <xsize>,<ysize> - Sizes are 1 for single or 2 for double
 +   SPRITE <sprite> UNDER {ON|OFF} - Choose the plane of the sprite
 +   SPRITE <sprite> AT <x>,<y> - Choose the sprite position
 +   SPRITE <sprite> ANIMATE {ON|OFF} - Turns sprite animation on or off
 +   SPRITE <sprite> SPEED <number>,<number> - Accepts non-integer values
 +   XPOS(<sprite>) - Returns X sprite position (this array is read-only)
 +   YPOS(<sprite>) - Returns Y sprite position (this array is read-only)
 +
 +Sound commands:
 +   Commands are accepted but don't seem to work
 +   The following commands can be combined, i.e., VOICE 1 ON WAVE SAW
 +   SOUND {ON|OFF} - Turn sound on or off
 +   VOLUME <volume> - Choose the volume from 0 to 15
 +   VOICE <voice> {ON|OFF} - Turn voice on or off
 +   VOICE <voice> WAVE {SAW|TRIANGLE|PULSE|NOISE} - Choose the waveform
 +   VOICE <voice> ADSR <attack>,<decay>,<sustain>,<release> - Select voice envelope
 +   VOICE <voice> PLAY <value>[,<value>...] - Values are from 0 to 65535
 +
 +Disk commands:
 +   DIR [<device>] - Display directory
 +   DISK <command>,[<device>] - Execute disk command, for example: DISK "R:NEWNAME=OLDNAME"
 +   DISK [,<device>] - Specify no command to retrieve status
 +   SPRITE {LOAD|SAVE} <filename> - Load or save sprites from/to disk
 +
 +Keyboard commands:
 +   KEY LIST - List function key assignments
 +   KEY {ON|OFF} - Activate of deactivate function key assignments
 +   KEY(<function-key-number>)=<string> - Perform assignment to the indicated function key
 +
 +Flow control:
 +   ON ERROR GOTO <line-number> - Choose a non-existing line number to disable error control
 +   PROCEDURE <procedure-name>[(<parameter>[,<parameter>...])] - Must be in code, only a marker
 +   DO <procedure-name>[(<argument>[,<argument>...])] - Calls the given procedure and pass values
 +   ELSE <statement> - Must be in a line by itself, matches last IF
 +   RESET - The same as pressing [RUN/STOP]+[RESTORE]
 +
 +Convenience commands:
 +   FIND <string> - Shows lines of code containing strings that contain the given string
 +   CHANGE <string> TO <string> - Changes substrings within strings within the code
 +   REN [<increment>[,<first-line-number>] - Renumber lines of code
 +   EDIT - Enter sprite editor, to exit press Q (NOTE: Keyboard commands currently unknown-TO DO)
 +
 +Other commands:
 +   JOY(<port>) - Returns the value at the joystick port, 1 or 2
 +
 +Existing keywords with usage currently unknown:
 +   CIRCLE
 +   COPY
 +   EZE
 +   FROM
 +   HIT - Likely to be sprite related
 +   MOVE
 +   NE
 +   ROLL
 +   SCROLL
base/reference_for_hes_graphics_basic_1.07.txt ยท Last modified: 2015-04-17 04:33 (external edit)