Difference between revisions of "TextureMatrix"

From BZFlagWiki
Jump to: navigation, search
(Hmm... there appears to have been some confusion)
Line 1: Line 1:
The texture matrix object allows you to define how a texture will appear in an material.  It can be used to manipulate still (fixed) textures as well as animated ones.
+
A TextureMatrix, or texmat, when applied to a material, object allows you to define how a texture will appear in an material.  It can be used to manipulate still (fixed) textures as well as animated ones.
  
==Code==
+
== Code ==
 
{|
 
{|
 
|
 
|
textureMatrix
+
textureMatrix
name example_texmat
+
  name example_texmat
scale 0.0 0.0 1.0 1.0
+
  scale 0.0 0.0 1.0 1.0 # u/v freqs, u/v scales
spin 0.0
+
  spin 0.0 # rotation freq
shift 0.0 0.0
+
  shift 0.0 0.0 # u/v freqs
center 0.5 0.5  
+
  center 0.5 0.5 # dynamic u/v center (for spin and scale)
fixedscale 0.0 0.0
+
  fixedscale 0.0 0.0 # time invariant u/v scale
fixedspin 0.0
+
  fixedspin 0.0 # time invariant rotation
fixedshift 0.0 0.0
+
  fixedshift 0.0 0.0 # time invariant u/v shift
end
+
end
 
|}
 
|}
Texture Matrix must be used in conjunction with the [[Material]] object using texmat.
+
 
valid parameters for a textureMatrix are:
+
The valid parameters for textureMatrix are:
 
<properties>
 
<properties>
name=name for reference
+
name=Name of the texmat, for reference
scale=u/v freqs, u/v scales
+
scale=Causes texture to dynamically change it's size, parameters are u/v frequencies, then u/v scales.
spin=rotation freq
+
spin=Cause a texture to spin around a center point, parameter is rotational frequency.
shift=u/v freqs
+
shift=Causes texture to move linearly, parameters are u/v frequencies.
center=dynamic u/v center (for spin and scale)
+
center=Central point for spin and scale
fixedscale=time invariant u/v scale
+
fixedscale=Fixed scale, texture doesn't move with time.
fixedspin=time invariant rotation
+
fixedspin=Fixed spin, texture doesn't move with time.
fixedshift=time invariant u/v shift
+
fixedshift=Fixed shift, texture doesn't move with time.
 
</properties>
 
</properties>
  
==Examples==
+
A textureMatrix can be called by adding 'texmat <name>' to a material containing a texture, like so:
Texture Matrix is often used to create the appearance of flowing water or lava with the "shift" argument.
+
{|
 +
|
 +
material
 +
  name example_material
 +
  diffuse 1 1 1 1
 +
  texture caution
 +
  texmat example_texmat
 +
end
 +
|}
 +
 
 +
== Editor Support ==
 +
There are currently no supported editors: Texture Matrices will need to be added by hand in a text editor.
 +
 
 +
==History==
 +
The Physics object was added with the [[BZFlag 2.0.0|v2.0.0]] release of BZFlag.
  
 
[[Category:Map Making]]
 
[[Category:Map Making]]
[[Category:Map_Objects]]
+
[[Category:Map Objects]]

Revision as of 21:05, 24 November 2007

A TextureMatrix, or texmat, when applied to a material, object allows you to define how a texture will appear in an 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

There are currently no supported editors: Texture Matrices will need to be added by hand in a text editor.

History

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