MegaZeux Akwende VERSION 1.0 Documentation

 

Versions:

        MZXAK1.0

 

File Specifications:

      Uses MZXs3.1 format

 

Version Support:

      Full MZX 2.51 support

      Full MZX Spider 1-3.2 support

      *Possible SMZX support*

 

MZXAKVERSION

        Initializes Akwende Counters

      Set MZXAKVERSION to 1 Initialize Modifications

      Set MZXAKVERSION to 0 Remove Modifications

 

Read Only:

 

TIME_HOURS

      Returns the current time in hours 1 - 24

TIME_MINUTES

        Returns the current time in minutes 0-59

TIME_SECONDS

        Returns the current time in seconds 0-59

DATE_YEAR

        Returns the current year

DATE_MONTH

        Returns the current month 1-12

DATE_DATE

        Returns the current date 1-31

DATE_DAY

      Returns the current day in the week 1 to 7

ROBOT_ID

      Returns the internal ID of a ROBOT

GAME_SPEED

        Returns the current game speed from 1-9

 

Return Functions:

 

ABSVALUE

      Used to determine absolute value of a counter

      set ABS_VALUE to 'x' where 'x' = # or counter

        VALUE is set to absolute value of 'x'

 

SQRTVALUE

      Used to determine the square root of a counter

      set SQRT_VALUE to 'x' where 'x' = # or counter

        VALUE is set to the nearest squareroot of 'x'

 

OVERLAY_CHAR

      Used to determine the character index of the overlay.

      set OVERLAY_X to x coordinate

      set OVERLAY_Y to y coordinate

        OVERLAY_CHAR = the character (0-255) of the overlay at that location

 

OVERLAY_COLOR

      Used to determine the color of the overlay.

      set OVERLAY_X to x coordinate

      set OVERLAY_Y to y coordinate

        OVERLAY_COLOR = the color (0-255) of the overlay at that location

 

BOARD_CHAR

      Used to determine the character index of the Board.

      set BOARD_X to x coordinate

      set OVERLAY_Y to y coordinate

        OVERLAY_CHAR = the character (0-255) of the Board at that location

 

BOARD_COLOR

      Used to determine the color of the Board.

      set BOARD_X to x coordinate

      set BOARD_Y to y coordinate

        OVERLAY_COLOR = the color (0-255) of the Board at that location

 

RED_VALUE

      Used to determine the red value of a color

      set CURRENT_COLOR to 0 to 15

        RED_VALUE = the red value of CURRENT_COLOR (0-63)

 

BLUE_VALUE

      Used to determine the blue value of a color

      set CURRENT_COLOR to 0 to 15

        BLUE_VALUE = the red value of CURRENT_COLOR (0-63)

 

GREEN_VALUE

      Used to determine the green value of a color

      set CURRENT_COLOR to 0 to 15

        GREEN_VALUE = the red value of CURRENT_COLOR (0-63)

 

GET_TARGET_ID

        Used to get the internal id of a robot

      set TARGET_X to x location of robot

      set TARGET_Y to y location of robot

      GET_TARGET_ID is the internal ROBOT_ID of target

 

TARGET_X

        Used to get the x location of a robot

      set TARGET_ID to id of a robot

      TARGET_X is the x location of a robot

 

TARGET_Y

        Used to get the y location of a robot

      set TARGET_ID to id of a robot

      TARGET_Y is the y location of a robot

 

 

TARGET_DIST

        Used to get the distance of the target

      set TARGET_ID to id of a robot

      TARGET_DIST returns x distance + y distance

 

TARGET_XDIR

        Used to get x direction of a target

      set TARGET_ID to id of a robot

      TARGET_XDIR returns the direction in 1,0,or –1

 

TARGET_YDIR

        Used to get y direction of a target

      set TARGET_ID to id of a robot

      TARGET_YDIR returns the direction in 1,0,or –1

 

Set Functions:

 

Set

NONE YET

 

 

INDEX OF RESERVED COUNTERS

* - uses counter space Total so far: 9

ABS_VALUE

BLUE_VALUE

BOARD_CHAR

BOARD_COLOR

BOARD_X   *

CURRENT_COLOR *

DATE_DATE

DATE_DAY

DATE_MONTH

DATE_YEAR

GAME_SPEED

GET_TARGET_ID

GREEN_VALUE

MZXAKVERSION *

OVERLAY_CHAR

OVERLAY_COLOR

OVERLAY_X *

OVERLAY_Y *

RED_VALUE

ROBOT_ID

SQRT_VALUE

TARGET_ID *

TARGET_DIST

TARGET_X *

TARGET_XDIR

TARGET_Y *

TARGET_YDIR

TIME_HOURS

TIME_MINUTES

TIME_SECONDS

VALUE *