This wiki is archived and useful information is being migrated to the main bzflag.org website
Difference between revisions of "TextureMatrix"
From BZFlagWiki
(→Code: added wiki table) |
|||
(13 intermediate revisions by 10 users not shown) | |||
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. | |
− | ==Code== | + | == 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: | ||
+ | {|{{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 | ||
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == | + | == Editor Support == |
− | Texture Matrix | + | The Texture Matrix can only be added to a map by hand, or by pyBzEdit. |
+ | |||
+ | ==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: | + | [[Category:Map Objects]] |
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.