This wiki was in read-only mode for many years, but can now be edited again. A lot of information will need to be updated.

TextureMatrix: Difference between revisions

From BZFlagWiki
Jump to navigation Jump to search
No edit summary
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: <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

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.