Skip to content

Pinned Palette Rows

github-actions[bot] edited this page Sep 22, 2026 · 5 revisions

Pinned Palette Rows

The tiles in one sheet often use different palette rows. Palette Row sets one row for the whole view. A pin shows selected tiles in a fixed row.

Pins change only the display. They do not change the file. They are saved in the project.

Start from the project you made in Getting Started.

1. Pin by hand

GFX14 has pipes, ?-blocks and ground. In row 0, they all show in the background's colours.

GFX14

  1. Select GFX14.
  2. Set Selection to Rectangle.
  3. Set Palette Row to 5.
  4. Select tiles $10 to $15: the green pipe.

Row 5, and a selection

  1. Click Pin. Also in Palette ▸ Pin Selection to Palette Row and the canvas right-click menu.

The canvas menu

  1. Set Palette Row back to 0. The pipe stays in row 5.

Pinned

  1. Pin tiles $16 to $19, the ?-block, to row 6.

A white ring shows the row of the view. A blue ring shows the row of the selection.

Two pins

To remove pins:

  • Unpin removes the pins in the selection.
  • Palette ▸ Unpin All removes all pins.

You can undo both.

2. Show and hide pins

The Palette menu

With Show Pinned Palette Colors (Shift+P) off, all tiles use one row:

One row

Show Palette Rows shows the row number on each pinned tile:

Rows, numbered

These two settings apply to the app. They are not saved in the project.

3. The base row

Pins are relative to Base Palette Row. If you change the base row, all pins move with it.

Base Palette Row 1

4. On a tilemap

Each tilemap cell stores its own palette row. On a tilemap, the Pin button is Set Row. It writes the row into the selected cells.

The stamp table

  1. Select Background stamps.
  2. Set Palette Row to 1.
  3. Select the first four cells: the first stamp.
  4. Click Set Row.

The cells, written

This changes the file data. To save it to the ROM: File ▸ Write.

In the project file

Each pin is [first pixel, count, row]. Pixels are counted in tile order, 64 pixels per tile:

"palette_regions": [[1024, 384, 5], [1408, 256, 6]]

Clone this wiki locally