This wiki is archived and useful information is being migrated to the main bzflag.org website

Difference between revisions of "TextureMatrix"

From BZFlagWiki
Jump to: navigation, search
m (Code: properties formatting)
(Code: added wiki table)
 
Line 17: Line 17:
  
 
The valid parameters for textureMatrix are:
 
The valid parameters for textureMatrix are:
 
+
{|{{Prettytable}}
;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.
+
| {{Hl3}} |'''Parameter'''
;spin: Cause a texture to spin around a center point, parameter is rotational frequency.
+
| {{Hl3}} |'''Description'''
;shift: Causes texture to move linearly, parameters are u/v frequencies.
+
|-
;center: Central point for spin and scale
+
| '''name''' || Name of the texmat, for reference.
;fixedscale: Fixed scale, texture doesn't move with time.
+
|-
;fixedspin: Fixed spin, texture doesn't move with time.
+
| '''scale''' || Causes texture to dynamically change it's size, parameters are u/v frequencies, then u/v scales.
;fixedshift: Fixed shift, texture doesn't move with time.
+
|-
 +
| '''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:
 
A textureMatrix can be called by adding 'texmat <name>' to a material containing a texture, like so:

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[edit]

 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[edit]

The Texture Matrix can only be added to a map by hand, or by pyBzEdit.

History[edit]

The TextureMatrix object was added with the v2.0.0 release of BZFlag.