Darkplaces material system/Introduction - Revision history

VorteX at 21:45, 30 July 2012

2012-07-30T21:45:46Z

2012-07-27T19:10:21Z

2012-07-27T19:01:48Z

2012-07-27T18:51:22Z

2012-07-27T18:37:35Z

2012-07-27T18:17:01Z

‎Realtime lighting

2012-07-26T14:34:04Z

‎Material Types

2012-07-26T14:33:46Z

2012-07-26T05:54:48Z

changed description

2012-07-26T05:47:47Z

‎Material scripts Formatting

← Older revision		Revision as of 21:45, 30 July 2012
Line 103:		Line 103:

	{{navigation footer\|Key Concepts}}		{{navigation footer\|Key Concepts}}
		+	{{finished}}

@@ Line 1: / Line 1: @@
-{{navigation title|Darkplaces material system|Introduction|}}
+{{navigation title|}}
-{{SUBPAGENAME}}
 == What is a Material? ==
@@ Line 103: / Line 102: @@
 {{important|some of the material commands may be order dependent, so it's good practice to place all global material commands (keywords defined in this section) at the very beginning of the material and to place material stages at the end.}}
-{{navigation footer|Darkplaces material system|Introduction|Key Concepts}}
+{{navigation footer|Key Concepts}}

@@ Line 1: / Line 1: @@
 {{navigation title|Darkplaces material system|Introduction|}}
 == What is a Material? ==
 Materials are short text scripts that define the properties of a surface as it appears and functions in a game world (or compatible editing tool). By convention, the documents that contain these scripts usually has the same name as the texture set which contains the textures being modified (e.g; textures_inn, models_mapobjects_crypt, etc,). Several specific script documents have also been created to handle special cases, like liquids, environments and special effects.

@@ Line 1: / Line 1: @@
-{{navigation title|Darkplaces material system|Introduction|Key Concepts}}
+{{navigation title|Darkplaces material system|Introduction|}}
 == What is a Material? ==
 Materials are short text scripts that define the properties of a surface as it appears and functions in a game world (or compatible editing tool). By convention, the documents that contain these scripts usually has the same name as the texture set which contains the textures being modified (e.g; textures_inn, models_mapobjects_crypt, etc,). Several specific script documents have also been created to handle special cases, like liquids, environments and special effects.

← Older revision		Revision as of 18:37, 27 July 2012
Line 100:		Line 100:

	{{important\|some of the material commands may be order dependent, so it's good practice to place all global material commands (keywords defined in this section) at the very beginning of the material and to place material stages at the end.}}		{{important\|some of the material commands may be order dependent, so it's good practice to place all global material commands (keywords defined in this section) at the very beginning of the material and to place material stages at the end.}}
		+
		+	{{navigation footer\|Darkplaces material system\|Introduction\|Key Concepts}}

@@ Line 66: / Line 66: @@
 All other Id Tech 3 stage configuration such as skies are not supported.
-{{design|To simulate multilayer materials, should make several copies of surface with different material atatched (for map surfaces can use Q3map2's cloneShader keyword)}}
+{{design|To simulate multilayer materials, should make several copies of surface with different material attached (for map surfaces can use Q3map2's cloneShader keyword)}}
 === New keywords ===

← Older revision		Revision as of 14:34, 26 July 2012
Line 99:		Line 99:
	Material keywords are not case sensitive.		Material keywords are not case sensitive.

−	{{important\|some of the material commands may be order dependent, so it's good practice to place all global material commands (keywords defined in this section) at the very beginning of the material and to place material stages at the end ~~(see various examples)~~.}}	+	{{important\|some of the material commands may be order dependent, so it's good practice to place all global material commands (keywords defined in this section) at the very beginning of the material and to place material stages at the end.}}

@@ Line 66: / Line 66: @@
 All other Id Tech 3 stage configuration such as skies are not supported.
-'''Design Notes:''' To simulate multilayer materials, should make several copies of surface with different material atatched (for map surfaces can use Q3map2's cloneShader keyword)
+{{design|To simulate multilayer materials, should make several copies of surface with different material atatched (for map surfaces can use Q3map2's cloneShader keyword)}}
 === New keywords ===
@@ Line 99: / Line 99: @@
 Material keywords are not case sensitive.
-'''IMPORTANT NOTE''': some of the material commands may be order dependent, so it's good practice to place all global material commands (keywords defined in this section) at the very beginning of the material and to place material stages at the end (see various examples).
+{{important|some of the material commands may be order dependent, so it's good practice to place all global material commands (keywords defined in this section) at the very beginning of the material and to place material stages at the end (see various examples).}}

@@ Line 57: / Line 57: @@
 Any shader keywords that is not compatible with realtime lighting was removed. Other ones have sligtly changed behavior.
-Aiming to realtime lighting changes the way stages working. Darkplaces material render pipeline can have 1 to 3 fixed usage stages:
+Aiming to realtime lighting changes the way stages working. There is no render passes (so multilayered material can only be created by duplicating real surfaces).
-* No draw: 0 stages
+Darkplaces material render pipeline can have 1 to 3 fixed usage stages:
-* Unlit texture: 1 stage
+* No draw (0 stages)
-* Lit texture: 2 stages
+* Unlit texture (1 stage)
-* Lit texture with terrain blending: 3 stages
+* Lit texture (2 stages)
 All other Id Tech 3 stage configuration such as skies are not supported.

@@ Line 40: / Line 40: @@
 In order to get materials to be easily readable and editable it is recommended to format all material scripts like this template:
-  materialname
+  &lt;materialname&gt;
+  {
       &lt;Editor Specific Keywords&gt;
@@ Line 46: / Line 46: @@
       &lt;Q3Map2 Specific Keywords&gt;
       &lt;General Keywords&gt;
+      {
            &lt;Stage Keywords&gt;