Difference between revisions of "TextureMatrix"

From BZFlagWiki
Jump to: navigation, search
(Changed "Physics object" to "TextureMatrix object")
(Editor Support)
Line 40: Line 40:
  
 
== Editor Support ==
 
== Editor Support ==
There are currently no supported editors. The Texture Matrix object must be added by hand in a text editor.
+
The Texture Matrix can only be added to a map by hand, or by pyBzEdit.
  
 
==History==
 
==History==

Revision as of 01:31, 18 October 2009

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:

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.