Darkplaces material system/General Keywords - Revision history

VorteX at 23:56, 29 November 2014

2014-11-29T23:56:03Z

2014-11-29T23:54:57Z

‎Renderer features

2014-11-29T23:30:15Z

‎deformVertexes normal

2014-11-29T23:29:39Z

‎deformVertexes bulge

2014-11-29T23:29:03Z

‎deformVertexes normal

2014-11-29T23:26:15Z

‎deformVertexes normal

2014-11-29T23:25:24Z

‎deformVertexes wave

2014-11-29T23:22:46Z

‎deformVertexes roundwave

2014-11-29T23:20:34Z

2014-11-29T23:15:32Z

‎deformVertexes

@@ Line 203: / Line 203: @@
 {{tip|The <nowiki><div></nowiki> and <nowiki><amplitude></nowiki> parameters, when used in conjunction with liquid volumes like water should take into consideration how much the water will be moving. A large ocean area would have have massive swells (big div values) that rose and fell dramatically (big amplitude values). While a small, quiet pool may move very little.}}
-==Renderer features==
+==Engine renderer features==
 This keywords controls various renderer features.
@@ Line 214: / Line 214: @@
 ===dpNoFog===
 Disables fog rendering for a surface.
 ===dpPolygonOffset &lt;factor&gt; &lt;offset&gt;===
@@ Line 223: / Line 221: @@
 {{tip|mod_q3shader_default_polygonfactor and mod_q3shader_default_polygonoffset controls default values.}}
 ===dpTransparentSort <nowiki><sort></nowiki>===
 Rendering of blended materials requires software sorting to keep the depth order of geometry. This keyword changes default distance sorting to allow for special effects.
@@ Line 311: / Line 310: @@
 ==Physics==
-This keywords controls various parameters used by game physics.
+This keywords controls parameters for game physics.
 ===dpMeshCollisions===

@@ Line 204: / Line 204: @@
 ==Renderer features==
-This keywords controls various parameters used by renderer and physics.
+This keywords controls various renderer features.
 ===dpOffsetMapping <nowiki><type> <scale> [<biastype> <biasvalue>]</nowiki>===

@@ Line 154: / Line 154: @@
   deformVertexes normal 2 0.5
-{{bug|On lightmapped surface, deformVertexes normal has no effect if tangentspace deluxemapping is used (since tangentspace deluxemapping do not take into account vertex normals). Use modelspace deluxemapping.}}
+{{bug|On lightmapped surface, deformVertexes normal has no effect if tangentspace deluxemapping is used (since tangentspace deluxemapping do not use vertex normals). Use modelspace deluxemapping.}}
 ===deformVertexes bulge <nowiki><bulgeWidth> <bulgeHeight> <bulgeSpeed></nowiki>===

@@ Line 158: / Line 158: @@
 ===deformVertexes bulge <nowiki><bulgeWidth> <bulgeHeight> <bulgeSpeed></nowiki>===
 :This forces a bulge to move along the given S and T directions. Designed for use on curved pipes.
 ===deformVertexes roundwave <nowiki><radius> <wavesize> <radiusexponent> <x> <y> <z> {wavefunc}</nowiki>===

@@ Line 153: / Line 153: @@
 Typical usage:
   deformVertexes normal 2 0.5
 ===deformVertexes bulge <nowiki><bulgeWidth> <bulgeHeight> <bulgeSpeed></nowiki>===

@@ Line 150: / Line 150: @@
 :'''IMPORTANT NOTE''': In Darkplaces, offset mapping uses vertex normals for the calculations. deformVertexes normal most likely will mess it up.
 :'''Design Notes''': Putting values of 0.1 t o 0.5 in Amplitude and 1.0 to 4.0 in the Frequency can produce some satisfying results.
 ===deformVertexes bulge <nowiki><bulgeWidth> <bulgeHeight> <bulgeSpeed></nowiki>===

@@ Line 141: / Line 141: @@
 :Designed for water surfaces, modifying the values differently at each point. It accepts the standard [[Darkplaces material system/Key Concepts#Waveform_Functions | waveform functions]].
 :The "div" parameter is used to control the wave "spread" - a value equal to the tesselation distance (see q3map_tessSize, a subdivision size, in game units, used for the material when seen in the game world).
 ===deformVertexes normal <nowiki><div> <func> <base> <amplitude ~0.1-~0.5> <frequency ~1.0-~4.0></nowiki>===

@@ Line 151: / Line 151: @@
 :This forces a bulge to move along the given S and T directions. Designed for use on curved pipes.
-===deformVertexes roundwave <nowiki><radius> <wavesize> <radiusexponent> <centerx> <centery> <centerz> <wavefunc> <base> <amplitude> <phase> <freq></nowiki>===
+===deformVertexes roundwave <nowiki><radius> <wavesize> <radiusexponent> <x> <y> <z> {wavefunc}</nowiki>===
 :Makes round waves coming from center point. Designed to simulate fountains and pools.
-:"Radius" is max radius of roundwave. "Wavesize" is length of wave at the start. "Exponent" is a power function, it makes wave longer with the distance from center point. Center are effect offsets from entity center (or from world origin for worldspawn surfaces).
+:"Radius" is max radius of roundwave. "Wavesize" is length of wave at the start. "Exponent" is a power function, it makes wave longer with the distance from center point. X,y,z are effect offsets from entity center (or from world origin for worldspawn surfaces).
 :example: deformVertexes roundwave 180 18 3 0 0 0 sin 0 1.00 0.0 1.2

@@ Line 190: / Line 190: @@
 {{tip|The <nowiki><div></nowiki> and <nowiki><amplitude></nowiki> parameters, when used in conjunction with liquid volumes like water should take into consideration how much the water will be moving. A large ocean area would have have massive swells (big div values) that rose and fell dramatically (big amplitude values). While a small, quiet pool may move very little.}}
 ==Transparent surfaces==
@@ Line 295: / Line 307: @@
 Disable Bounding Interval Hierarchy tree construction for a surface. Used an an optimisation on surfaces which never need game physics (such as grass).
 {{navigation footer|Special Keywords}}
 {{finished}}