BASIC PUT TILEMAP Statement - fvdhoef/aquarius-plus GitHub Wiki

PUT TILEMAP

TYPE: plusBASIC graphics statement


FORMAT: PUT TILEMAP ( column , row ) , *arrayname

Action: Copies a rectangle of tilemap data from a numeric array to the screen.

  • column and row specifies the screen position of the upper-left corner of the rectangle.
  • arrayname is the name of the array to copy the screen data from.
  • The width and height of the rectangle is defined when the array is populated with a GET TILEMAP statement.
  • Illegal Quantity results from any of the following conditions:
    • column is not in the range 0 through 63.
    • row is not in the range 0 through 31.

Examples:

10 DIM A(13)
20 GET TILEMAP (2,3)-(7,8),*A
30 PUT TILEMAP (10,5),*A

Copies tilemap contents from column 2, line 3 through column 7, line 8 to column 10, line 5 through column 15, line 10.


FORMAT: PUT TILEMAP ( column , row ) , ^stringvar

Action: As above but copies the tilemap cells to string variable.

  • column and row specifies the screen position of the upper-left corner of the rectangle.
  • stringvar is the name of the array to copy the tilemap data into.

Examples:

10 DIM A(13)
20 GET TILEMAP (2,3)-(7,8),^A$(1)
30 PUT TILEMAP (10,5),^A$(1)

Copies text tilemap contents from column 2, line 3 to column 7, line 8 into string variable A$(1) to column 10, line 5 through column 15, line 10.