From 47942140df724bb4465dd2cfcf034a0a8ba4e94e Mon Sep 17 00:00:00 2001 From: Garux Date: Mon, 4 May 2020 11:21:20 +0300 Subject: [PATCH] docs: shaderManual: fix cull parm info (front doesn't exist, back shows back) --- docs/shaderManual/general-directives.html | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/shaderManual/general-directives.html b/docs/shaderManual/general-directives.html index fc579cea..63beb882 100644 --- a/docs/shaderManual/general-directives.html +++ b/docs/shaderManual/general-directives.html @@ -97,12 +97,11 @@ textures/skies/xtoxicsky_dm9

cull side

-

Every surface of a polygon has two sides, a front and a back. Typically, we only see the front or "out" side. For example, a solid block you only show the front side. In many applications we see both. For example, in water, you can see both front and a back. The same is true for things like grates and screens.

-

To "cull" means to remove. The value parameter determines the type of face culling to apply. The default value is cull back if this keyword is not specified. However for items that should be inverted then the value front should be used. To disable culling, the value disable or none should be used. Only one cull instruction can be set for the shader.

+

Every surface of a polygon has two sides, a front and a back. Typically, we only see the front or "out" side. For example, a solid block only shows the front side. In many applications we see both. For example, in water, you can see both front and a back. The same is true for things like grates and screens.

+

To "cull" means to remove, however naming is messy here, so value parameter may be understood as "which side to show" too. The default behavior is to draw front side if this keyword is not specified. Only one cull instruction can be set for the shader.

-
front
The front or "outside" of the polygon is not drawn in the world. It is used if the keyword "cull" appears in the content instructions without a side value.
-
back
Cull back removes the back or "inside" of a polygon from being drawn in the world.
-
disable or none
Neither side of the polygon is removed. Both sides are drawn in the game. Very useful for making panels or barriers that have no depth, such as grates, screens, metal wire fences and so on and for liquid volumes that the player can see from within. Also used for energy fields, sprites, and weapon effects (e.g. plasma).
+
back or backside or backsided
Cull back shows the back or "inside" of a polygon, removes front side from being drawn in the world.
+
none or twosided or disable
Neither side of the polygon is removed. Both sides are drawn in the game. Very useful for making panels or barriers that have no depth, such as grates, screens, metal wire fences and so on and for liquid volumes that the player can see from within. Also used for energy fields, sprites, and weapon effects (e.g. plasma).

Design Notes: