From 0f417109db229bad286f3b117c9534ac71012136 Mon Sep 17 00:00:00 2001 From: Eduardo Quezada Date: Fri, 3 Jan 2025 13:33:05 -0300 Subject: [PATCH] Moved .pla file documentation --- docs/SUMMARY.md | 1 + docs/tutorials/dns.md | 16 ++++++++++++++++ src/data/tilesets/headers.h | 2 +- 3 files changed, 18 insertions(+), 1 deletion(-) create mode 100644 docs/tutorials/dns.md diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 21584f3ad7..6ef80644e6 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -18,6 +18,7 @@ - [v1.7.x](tutorials/how_to_new_pokemon_1_7_0.md) - [v1.6.x](tutorials/how_to_new_pokemon_1_6_0.md) - [How to use the Testing System](tutorials/how_to_testing_system.md) + - [Day/Night System FAQ](tutorials/dns.md) - [Changelog](./CHANGELOG.md) - [1.10.x]() - [Version 1.10.0](changelogs/1.10.x/1.10.0.md) diff --git a/docs/tutorials/dns.md b/docs/tutorials/dns.md new file mode 100644 index 0000000000..860fa94371 --- /dev/null +++ b/docs/tutorials/dns.md @@ -0,0 +1,16 @@ +## Day/Night system FAQ + +### Q: How do I mark certain colors in a palette as light-blended? +A: Create a `.pla` file in the same folder as the `.pal` with the same name. + +In this file you can enter color indices [0,15] +on separate lines to mark those colors as being light-blended, i.e: + +`06.pla:` +``` +# A comment +0 # if color 0 is listed, uses it to blend with instead of the default! +1 +9 +10 +``` \ No newline at end of file diff --git a/src/data/tilesets/headers.h b/src/data/tilesets/headers.h index f6afbcef53..6ac09b5f07 100644 --- a/src/data/tilesets/headers.h +++ b/src/data/tilesets/headers.h @@ -7,7 +7,7 @@ // consider taking a look at the .pla files // to mark colors as lights, instead. // The old method *should* still work, however. -// See the README for details. +// Check docs/tutorials/dns.md for details. // Whether a palette has lights the color indices to blend are stored in the palette's color 0 #define LIGHT_PAL(x) ((x) < NUM_PALS_IN_PRIMARY ? 1 << (x) : 1 << ((x) - NUM_PALS_IN_PRIMARY))