From: Paramat <paramat@users.noreply.github.com>
Date: Mon, 13 Aug 2018 23:30:13 +0000 (+0100)
Subject: texture_packs.txt: Add information for leaves texturing (#7637)
X-Git-Tag: 5.0.0~261
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=03f89e8ffca84e2ff2f6cea8dcee49b067280cc4;p=oweals%2Fminetest.git

texture_packs.txt: Add information for leaves texturing (#7637)

Explain texture requirements due to the leaves rendering options.
---

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.