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

Editing TextureMatrix

Jump to: navigation, search

Warning: The database has been locked for maintenance, so you will not be able to save your edits right now. You may wish to copy and paste your text into a text file and save it for later.

The administrator who locked it offered this explanation: Archived wiki

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
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.
+
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.
  
== Code ==
+
==Code==
 
{|
 
{|
 
|
 
|
  textureMatrix
+
textureMatrix
  name example_texmat
+
name example_texmat
  scale 0.0 0.0 1.0 1.0 # u/v freqs, u/v scales
+
scale 0.0 0.0 1.0 1.0
  spin 0.0 # rotation freq
+
spin 0.0
  shift 0.0 0.0 # u/v freqs
+
shift 0.0 0.0
  center 0.5 0.5 # dynamic u/v center (for spin and scale)
+
center 0.5 0.5  
  fixedscale 0.0 0.0 # time invariant u/v scale
+
fixedscale 0.0 0.0
  fixedspin 0.0 # time invariant rotation
+
fixedspin 0.0
  fixedshift 0.0 0.0 # time invariant u/v shift
+
fixedshift 0.0 0.0
  end
+
|}
+
 
+
The valid parameters for textureMatrix are:
+
{|{{Prettytable}}
+
|-
+
| {{Hl3}} |'''Parameter'''
+
| {{Hl3}} |'''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
 
  end
 
|}
 
|}
 +
Texture Matrix must be used in conjunction with the [[Material]] object using texmat.
 +
valid parameters for a Material are:
 +
<properties>
 +
name=name for reference
 +
scale=u/v freqs, u/v scales
 +
spin=rotation freq
 +
shift=u/v freqs
 +
center=dynamic u/v center (for spin and scale)
 +
fixedscale=time invariant u/v scale
 +
fixedspin=time invariant rotation
 +
fixedshift=time invariant u/v shift
 +
</properties>
  
== Editor Support ==
+
==Examples==
The Texture Matrix can only be added to a map by hand, or by pyBzEdit.
+
Texture Matrix is often used to create the appearance of flowing water or lava with the "shift" argument.
 
+
==History==
+
The TextureMatrix 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]]

Please note that all contributions to BZFlagWiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see BZFlagWiki:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel | Editing help (opens in new window)

Templates used on this page: