This wiki was in read-only mode for many years, but can now be edited again. A lot of information will need to be updated.
TextureMatrix: Difference between revisions
		
		
		
		Jump to navigation
		Jump to search
		
mNo edit summary  | 
				 →Code:  added wiki table  | 
				||
| (9 intermediate revisions by 8 users not shown) | |||
| Line 1: | Line 1: | ||
A TextureMatrix, or texmat, when applied to a material,   | A TextureMatrix, or texmat, when applied to a material object, allows you to define how a texture will appear in a material.  It can be used to manipulate still (fixed) textures as well as animated ones.  | ||
== Code ==  | == Code ==  | ||
{|  | {|  | ||
|  | |  | ||
  textureMatrix  | |||
   name example_texmat  | |||
   scale 0.0 0.0 1.0 1.0 # u/v freqs, u/v scales  | |||
   spin 0.0 # rotation freq  | |||
   shift 0.0 0.0 # u/v freqs  | |||
   center 0.5 0.5 # dynamic u/v center (for spin and scale)  | |||
   fixedscale 0.0 0.0 # time invariant u/v scale  | |||
   fixedspin 0.0 # time invariant rotation  | |||
   fixedshift 0.0 0.0 # time invariant u/v shift  | |||
  end  | |||
|}  | |}  | ||
The valid parameters for textureMatrix are:  | The valid parameters for textureMatrix are:  | ||
{|{{Prettytable}}  | |||
name  | |-  | ||
scale  | | {{Hl3}} |'''Parameter'''   | ||
spin  | | {{Hl3}} |'''Description'''  | ||
shift  | |-  | ||
center  | | '''name''' || Name of the texmat, for reference.  | ||
fixedscale  | |-  | ||
fixedspin  | | '''scale''' || Causes texture to dynamically change it's size, parameters are u/v frequencies, then u/v scales.  | ||
fixedshift  | |-  | ||
| '''spin''' || Cause a texture to spin around a center point, parameter is rotational frequency.  | |||
|-  | |||
| '''shift''' || Causes texture to move linearly, parameters are u/v frequencies.  | |||
|-  | |||
| '''center''' || Central point for spin and scale.  | |||
|-  | |||
| '''fixedscale''' || Fixed scale, texture doesn't move with time.  | |||
|-  | |||
| '''fixedspin''' || Fixed spin, texture doesn't move with time.  | |||
|-  | |||
| '''fixedshift''' || Fixed shift, texture doesn't move with time.  | |||
|}  | |||
A textureMatrix can be called by adding 'texmat <name>' to a material containing a texture, like so:  | A textureMatrix can be called by adding 'texmat <name>' to a material containing a texture, like so:  | ||
| Line 40: | Line 51: | ||
== Editor Support ==  | == Editor Support ==  | ||
The Texture Matrix can only be added to a map by hand, or by pyBzEdit.  | |||
==History==  | ==History==  | ||
The   | The TextureMatrix object was added with the [[BZFlag 2.0.0|v2.0.0]] release of BZFlag.  | ||
[[Category:Map Making]]  | [[Category:Map Making]]  | ||
[[Category:Map Objects]]  | [[Category:Map Objects]]  | ||
Latest revision as of 02:23, 3 December 2016
A TextureMatrix, or texmat, when applied to a material object, allows you to define how a texture will appear in a material. It can be used to manipulate still (fixed) textures as well as animated ones.
Code
textureMatrix name example_texmat scale 0.0 0.0 1.0 1.0 # u/v freqs, u/v scales spin 0.0 # rotation freq shift 0.0 0.0 # u/v freqs center 0.5 0.5 # dynamic u/v center (for spin and scale) fixedscale 0.0 0.0 # time invariant u/v scale fixedspin 0.0 # time invariant rotation fixedshift 0.0 0.0 # time invariant u/v shift end  | 
The valid parameters for textureMatrix are:
| Parameter | Description | 
| name | Name of the texmat, for reference. | 
| scale | Causes texture to dynamically change it's size, parameters are u/v frequencies, then u/v scales. | 
| spin | Cause a texture to spin around a center point, parameter is rotational frequency. | 
| shift | Causes texture to move linearly, parameters are u/v frequencies. | 
| center | Central point for spin and scale. | 
| fixedscale | Fixed scale, texture doesn't move with time. | 
| fixedspin | Fixed spin, texture doesn't move with time. | 
| fixedshift | Fixed shift, texture doesn't move with time. | 
A textureMatrix can be called by adding 'texmat <name>' to a material containing a texture, like so:
material name example_material diffuse 1 1 1 1 texture caution texmat example_texmat end  | 
Editor Support
The Texture Matrix can only be added to a map by hand, or by pyBzEdit.
History
The TextureMatrix object was added with the v2.0.0 release of BZFlag.