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
		
No edit summary  | 
				 →Code:  added wiki table  | 
				||
| (12 intermediate revisions by 10 users not shown) | |||
| Line 1: | Line 1: | ||
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:  | |||
{|{{Prettytable}}  | |||
|-  | |||
| {{Hl3}} |'''Parameter'''   | |||
| {{Hl3}} |'''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  |   end  | ||
|}  | |}  | ||
==  | == Editor Support ==  | ||
Texture Matrix   | The Texture Matrix can only be added to a map by hand, or by pyBzEdit.  | ||
==History==  | |||
The TextureMatrix object was added with the [[BZFlag 2.0.0|v2.0.0]] release of BZFlag.  | |||
[[Category:Map Making]]  | [[Category:Map Making]]  | ||
[[Category:  | [[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.