mapeditor / mapeditor/tiled

Patterned document background option

Open
#3,936 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C++
Stars
12.9k
Forks
2k
Avg merge
4h 27m
Merged PRs (30d)
8

Description

For maps and especially tilesets, it is often useful to be able to see transparent areas of the document. However, currently Tiled supports only solid colours as backgrounds - there is the background colour option, and the default map editor and panel background colour that's theme-dependent and shown on documents with no background colour set. These do not make it clear which pixels are transparent. While a lot can be done with them, I think that a zoom-independent chequered or otherwise patterned background (displayed in place of the current solid default) would make transparent areas read more clearly than any one solid colour could (at least without also blinding the user xP).

A comparison of such background patterns from a few image editors, with an image zoomed to 500% for reference:
PyxelEdit: Diagonal lines, zoom-independent, fixed size, fixed colours
image

Photoshop: Checkerboard, zoom-independent, three size presets, customisable colours with several presets
image

Aseprite: Checkerboard, zoom-dependent (hurts clarity, but makes it useful as a size guide, something Tiled does not need), customisable size with several presets, customisable colours
image

Krita: Checkerboard, zoom-independent AND position-independent (cache-wrecker!), customisable size, customisable colours
image

I feel PyxelEdit's diagonal lines would be the best option, as they run little risk of resembling the content of tiles at any zoom level, whereas checker board patterns and squares are fairly common in tilemaps. However, it would be nice to be able to customise the size and colour of the lines - if not fully, then perhaps with small/medium/large size options (or perhaps a fixed size scaled by monitor DPI?), and light/midtone/dark colour options with the exact colours chosen based on the theme.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing how the map editor currently displays its solid default and configured background colours. Review the requested pattern examples and existing background options before deciding the scope; done should mean transparent areas are visibly distinguished with a zoom-independent pattern and the intended size and colour customization is available.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
desktop
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.