Changes between Version 2 and Version 3 of TextureFormat

Timestamp:

Sep 10, 2010, 4:41:14 PM (14 years ago)

Author:

Philip Taylor

Comment:

--

TextureFormat

@@ -20 +20 @@
 DXT1, DXT3 and DXT5 all compress the RGB channels in precisely the same way. The only difference is the alpha channel. The [http://blog.wolfire.com/2009/01/dxtc-texture-compression/ Wolfire Games blog] (no relation to Wildfire Games) has some examples.
 
- * DXT1: 1-bit alpha: good for textures that are all solid, or for UI elements with non-antialiased transparency masks. Generally unsuitable for non-solid world textures - even if the texture only needs 1-bit alpha, its mipmaps are likely to need semi-transparent pixels.
- * DXT3: 4-bit alpha: good for textures with a wide range of alpha values in a 4x4 block of pixels; bad for smooth alpha gradients.
- * DXT5: 3-bit alpha gradient: good for smooth gradients; fine for most of the cases where DXT3 is good. You should generally use this instead of DXT3.
+ * DXT1: 1-bit alpha - good for textures that are all solid, or for UI elements with non-antialiased transparency masks. Generally unsuitable for non-solid world textures - even if the texture only needs 1-bit alpha, its mipmaps are likely to need semi-transparent pixels.
+ * DXT3: 4-bit alpha - good for textures with a wide range of alpha values in a 4x4 block of pixels; bad for smooth alpha gradients.
+ * DXT5: 3-bit alpha gradient - good for smooth gradients; fine for most of the cases where DXT3 is good. You should generally use this instead of DXT3.
 
 == Mipmaps ==
@@ -47 +47 @@
 
 The available settings are:
- * `format="rgba"`
- * `format="dxt1"`
- * `format="dxt3"`
- * `format="dxt5"`
- * `mipmap="true"`
- * `mipmap="false"`
- * `alpha="transparency"`
- * `alpha="player"`
- * `filter="box"`
- * `filter="triangle"`
- * `filter="kaiser"`
- * `kaiserwidth="3.0" kaiseralpha="4.0" kaiserstretch="1.0"`
+ `format="rgba"`::
+  Use uncompressed RGBA format (useful for small textures where DXTC compression artifacts are unacceptable).
+ `format="dxt1"`::
+  Use DXT1 format.
+ `format="dxt3"`::
+  Use DXT3 format (will automatically switch to DXT1 if the texture is solid).
+ `format="dxt5"`::
+  Use DXT5 format (will automatically switch to DXT1 if the texture is solid).
+ `mipmap="true"`::
+  Generate mipmaps.
+ `mipmap="false"`::
+  Don't generate mipmaps.
+ `alpha="transparency"`::
+  Alpha channel represents transparency - the RGB of pixels with A=0 can be ignored.
+ `alpha="player"`::
+  Alpha channel represents player colouring - the RGB of pixels with A=0 are still important.
+ `filter="box"`::
+  Use box filter for mipmaps (generally recommended).
+ `filter="triangle"`::
+  Use triangle filter for mipmaps.
+ `filter="kaiser"`::
+  Use Kaiser filter for mipmaps.
+ `kaiserwidth="3.0" kaiseralpha="4.0" kaiserstretch="1.0"`::
+  Set Kaiser filter parameters (be very careful when modifying these).