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: <properties> 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. </properties>

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.