TileDisplay - Revision history

Duck Mim: Added value column and divided into 3 categories

2025-03-28T10:27:41Z

Added value column and divided into 3 categories

JoeStrout: add new cellTransform methods

2025-02-22T15:09:39Z

add new cellTransform methods

SebNozzi: Changed explanation

2021-11-25T22:43:20Z

Changed explanation

SebNozzi: formatting

2021-11-25T22:39:26Z

formatting

SebNozzi: Added explanation about tile layout in tileset image

2021-11-25T22:37:18Z

Added explanation about tile layout in tileset image

JoeStrout: added a decent TileDisplay example

2021-09-14T23:00:23Z

added a decent TileDisplay example

JoeStrout: added category tag

2020-12-04T00:13:28Z

added category tag

JoeStrout: Initial creation

2020-12-04T00:02:29Z

Initial creation

New page

The <c>TileDisplay</c> class in [[Mini Micro]] is a display type that holds and draws a grid of tiles, small images taken from a larger image called a ''tile set''.

No display is configured as a tile display by default. But you can make any display layer a tile display by setting its [[Display.mode|mode]] to <c>displayMode.tile</c>.

== Methods and Properties ==

{| class="wikitable"
|-
! Method or Property !! Purpose
|-
|-
| [[TileDisplay.extent]] ''[columns, rows]'' || display size
|-
| [[TileDisplay.tileSet]] || [[Image]] containing tiles to draw from
|-
| [[TileDisplay.tileSetTileSize]] || size of tiles in `tileSet`
|-
| [[TileDisplay.cellSize]] || size of tiles on screen
|-
| [[TileDisplay.overlap]] || cell overlap, in pixels
|-
| [[TileDisplay.oddRowOffset]] || amount to shift odd rows horizontally; use 0.5 for hex rows
|-
| [[TileDisplay.oddColOffset]] || amount to shift odd columns vertically; use 0.5 for hex columns
|-
| [[TileDisplay.scrollX]] || horizontal scroll amount, in pixels
|-
| [[TileDisplay.scrollY]] || vertical scroll amount, in pixels
|-
| [[TileDisplay.clear]] ''toIndex'' || set all tiles to null (the default) or the given index
|-
| [[TileDisplay.cell]](''x'', ''y'') || get the tile index of cell ''x'', ''y''
|-
| [[TileDisplay.setCell]] ''x'', ''y'', ''idx'' || set the tile index of cell ''x'', ''y'' to ''idx''
|-
| [[TileDisplay.cellTint]](''x'', ''y'') || get the tint color of cell ''x'', ''y''
|-
| [[TileDisplay.setCellTint]] ''x'', ''y'', ''c'' || set the tint of cell ''x'', ''y'' to color ''c''
|}

@@ Line 3: / Line 3: @@
 No display is configured as a tile display by default.  But you can make any display layer a tile display by setting its [[Display.mode|mode]] to <c>displayMode.tile</c>.
-== Indexing ==
+== Tile Indexing ==
-The tiles within the tile set are referred to by index. They are ordered from top-left to bottom-right.
+The tiles within the tile-set are referred to by index.
 The tile with index 0 will refer to the leftmost image in the first row, index 1 to the one to its right, and so on, until the last image in the row. The next index number will refer to the first / leftmost image in the second row, and so on. The last image in the tile set will be the rightmost of the last row.

@@ Line 5: / Line 5: @@
 == Indexing ==
-The tiles within the [[''tile set'' image | TileDisplay.tileSet]] are referred to by index. They are ordered from top-left to bottom-right.
+The tiles within the tile set are referred to by index. They are ordered from top-left to bottom-right.
-The tile with index 0 will refer to the leftmost image in the first row, index 1 to the one to its right, and so on, until the last image in the row. The next index number will refer to the first / leftmost image in the second row, and so on. The last image in the ''tile set'' will be the rightmost of the last row.
+The tile with index 0 will refer to the leftmost image in the first row, index 1 to the one to its right, and so on, until the last image in the row. The next index number will refer to the first / leftmost image in the second row, and so on. The last image in the tile set will be the rightmost of the last row.
 == Methods and Properties ==

← Older revision		Revision as of 22:37, 25 November 2021
Line 2:		Line 2:

	No display is configured as a tile display by default. But you can make any display layer a tile display by setting its [[Display.mode\|mode]] to <c>displayMode.tile</c>.		No display is configured as a tile display by default. But you can make any display layer a tile display by setting its [[Display.mode\|mode]] to <c>displayMode.tile</c>.
		+
		+	== Indexing ==
		+
		+	The tiles within the [[''tile set'' image \| TileDisplay.tileSet]] are referred to by index. They are ordered from top-left to bottom-right.
		+
		+	The tile with index 0 will refer to the leftmost image in the first row, index 1 to the one to its right, and so on, until the last image in the row. The next index number will refer to the first / leftmost image in the second row, and so on. The last image in the ''tile set'' will be the rightmost of the last row.

	== Methods and Properties ==		== Methods and Properties ==

@@ Line 38: / Line 38: @@
 | [[TileDisplay.setCellTint]] ''x'', ''y'', ''c'' || set the tint of cell ''x'', ''y'' to color ''c''
 |}
 [[Category:Mini Micro]]

← Older revision		Revision as of 00:13, 4 December 2020
Line 38:		Line 38:
	\| [[TileDisplay.setCellTint]] ''x'', ''y'', ''c'' \|\| set the tint of cell ''x'', ''y'' to color ''c''		\| [[TileDisplay.setCellTint]] ''x'', ''y'', ''c'' \|\| set the tint of cell ''x'', ''y'' to color ''c''
	\|}		\|}
		+
		+	[[Category:Mini Micro]]

@@ Line 14: / Line 14: @@
 {| class="wikitable"
 |-
-! Method or Property !! Purpose
+|-|
 |-
 |-
-| [[TileDisplay.extent]] ''[columns, rows]'' || display size
+| [[TileDisplay.cellTint]](''x'', ''y'') || get the tint color of cell ''x'', ''y'' || string (color)
 |-
-| [[TileDisplay.tileSet]]  || [[Image]] containing tiles to draw from
+| [[TileDisplay.cellTransform]](''x'', ''y'') || get the transform (0-7) of cell at ''x'', ''y'' || number
 |-
-| [[TileDisplay.tileSetTileSize]] || size of tiles in `tileSet`
 |-
 |-
-| [[TileDisplay.overlap]] || cell overlap, in pixels
+| [[TileDisplay.extent]] ''[columns, rows]'' || display size || pair of numbers
 |-
-| [[TileDisplay.oddRowOffset]] || amount to shift odd rows horizontally; use 0.5 for hex rows
+| [[TileDisplay.tileSet]]  || [[Image]] containing tiles to draw from || [[Image]]
 |-
-| [[TileDisplay.oddColOffset]] || amount to shift odd columns vertically; use 0.5 for hex columns
+| [[TileDisplay.tileSetTileSize]] || size of tiles in `tileSet` || number
 |-
-| [[TileDisplay.scrollX]] || horizontal scroll amount, in pixels
+| [[TileDisplay.cellSize]] || size of tiles on screen || number
 |-
 |-
 | [[TileDisplay.clear]] ''toIndex'' || set all tiles to null (the default) or the given index
 |-
 |-
 | [[TileDisplay.setCell]] ''x'', ''y'', ''idx'' || set the tile index of cell ''x'', ''y'' to ''idx''
 |-
 |-
 | [[TileDisplay.setCellTint]] ''x'', ''y'', ''c'' || set the tint of cell ''x'', ''y'' to color ''c''
 |-
 | [[TileDisplay.setCellTransform]] ''x'', ''y'', ''t'' || set the transform of cell ''x'', ''y'' to value ''t''