TextureMatrix

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.