From 03f89e8ffca84e2ff2f6cea8dcee49b067280cc4 Mon Sep 17 00:00:00 2001 From: Paramat Date: Tue, 14 Aug 2018 00:30:13 +0100 Subject: [PATCH] texture_packs.txt: Add information for leaves texturing (#7637) Explain texture requirements due to the leaves rendering options. --- doc/texture_packs.txt | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/doc/texture_packs.txt b/doc/texture_packs.txt index 89fdc0826..40fdf2eeb 100644 --- a/doc/texture_packs.txt +++ b/doc/texture_packs.txt @@ -168,3 +168,44 @@ Here are face selectors you can choose from: | bottom | y- | | sides | x-, x+, z-, z+ | | all | All faces. You can also use '*' instead of 'all'. | + +Designing leaves textures for the leaves rendering options +---------------------------------------------------------- + +Minetest has three modes for rendering leaves nodes if the node has the +`allfaces_optional` drawtype. + +### Fancy + +Uses the texture specified in the `tiles` nodedef field. +The texture should have some transparent pixels and be in the RGBA format so +that the transparent pixels can have color information. +Faces of every leaves node are rendered even if they are inside a solid volume +of leaves; this gives a dense appearance. + +### Opaque + +Uses the texture specified in `tiles` but makes it opaque by converting each +transparent pixel into an opaque pixel that uses the color information of that +transparent pixel. +Due to this the `tiles` texture format must be RGBA not 'indexed alpha' to allow +each transparent pixel to have color information. + +The colors of the transparent pixels should be set for a good appearance in +`opaque` mode. This can be done by painting the pixels the desired colors then +erasing them. Then when saving the texture, use the 'save color information from +transparent pixels' option (or equivalent). + +### Simple + +Uses the texture specified in the `special_tiles` nodedef field if it exists, if +not, the `tiles` texture. +The `special_tiles` texture should have fewer transparent pixels than the +`tiles` texture and be in the 'indexed alpha' format. + +This mode is between the other two in terms of appearance and rendering load. +The nodes are rendered using the `glasslike` drawtype, only showing the surface +faces for any solid volume of leaves, not the internal faces. +Due to this the `tiles` texture might appear lacking in density, so optionally a +`special_tiles` texture can be used to provide a texture with fewer transparent +pixels for a denser appearance.