zakarya/puzzles
1
0
Fork 0
mirror of git://git.tartarus.org/simon/puzzles.git synced 2025-04-21 08:01:30 -07:00
Code Issues Packages Projects Releases Wiki Activity

Devel docs: explain the specialness of colour 0

Browse Source 
It's used to fill the drawing area and also by some front-ends (at
least GTK and JavaScript) to fill areas around the drawing area.
This commit is contained in:
Ben Harris
2022-12-06 13:25:47 +00:00
parent 3e072dff91
commit 202b7467d8
1 changed files with 7 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
devel.but
View File

@ -33,7 +33,7 @@ for use by anyone attempting to implement a new puzzle or port to a
new platform. new platform.
This guide is believed correct as of \cw{git} commit This guide is believed correct as of \cw{git} commit
\cw{b967a3ea86d6285457abc2a89e455c8f62d2c22a}. Hopefully it will be \cw{9afdd4cca4823fa3b27ad2ca2fec33e04d7ab103}. Hopefully it will be
updated along with the code in future, but if not, I've at least left updated along with the code in future, but if not, I've at least left
this version number in here so you can figure out what's changed by this version number in here so you can figure out what's changed by
tracking commit comments from there onwards. tracking commit comments from there onwards.
@ -1221,6 +1221,12 @@ end's default colour as their background, apart from a few which
depend on drawing relief highlights so they adjust the background depend on drawing relief highlights so they adjust the background
colour if it's too light for highlights to show up against it. colour if it's too light for highlights to show up against it.
The first colour in the list is slightly special. The mid-end fills
the drawing area with it before the first call to \cw{redraw()} (see
\k{backend-redraw}). Some front ends also use it fill the part of the
puzzle window outside the puzzle. This means that it is usually
sensible to make colour 0 the background colour for the puzzle.
Note that the colours returned from this function are for Note that the colours returned from this function are for
\e{drawing}, not for printing. Printing has an entirely different \e{drawing}, not for printing. Printing has an entirely different
colour allocation policy. colour allocation policy.