TextureMatrix

From BZFlagWiki
Revision as of 03:09, 28 July 2012 by Prestidigitator (Talk | contribs) (Code: properties formatting)

Jump to: navigation, search

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.