Template:MatParamDef/doc: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 5: Line 5:
== Usage ==
== Usage ==
{{Code|<nowiki>{{MatParam|<name>|<variable type>|<description>}}</nowiki>}}
{{Code|<nowiki>{{MatParam|<name>|<variable type>|<description>}}</nowiki>}}
{{ModernNote|Don't forget to use [[Template:=]] to escape any "{{=}}" characters in the text.}}


== Examples and Parameters ==  
== Examples and Parameters ==  
Line 14: Line 12:
! Example
! Example
! Preview
! Preview
|-
| align="center" | {{Param|text}}
| Description of the parameter. If specified, then you will not encounter the problem of a broken description if there are equal signs in it.
| {{CodeBlock|margin=5px|<nowiki>{{MatParam
| I'm deprecated | bool
| text = Wow, I've been fixed!
}}</nowiki>}}
| {{MatParam|I'm deprecated|bool|deprecated=1|text=Wow, I've been fixed!}}
|-
|-
| align="center" | {{Param|deprecated}}
| align="center" | {{Param|deprecated}}
Line 94: Line 100:
| I only work with specific shaders!
| I only work with specific shaders!
}}</nowiki>}}
}}</nowiki>}}
| {{MatParam|$shaderspecificparameter|float|I only work with specific shaders!|shaders=VertexLitGeneric, UnlitGeneric}}
| {{MatParam|$shaderspecificparameter|float|shaders=VertexLitGeneric, UnlitGeneric|I only work with specific shaders!}}
|-
|-
| align="center" | {{Param|value}}
| align="center" | {{Param|value}}
Line 102: Line 108:
| Bla bla bla
| Bla bla bla
}}</nowiki>}}
}}</nowiki>}}
| {{MatParam|$defaultvalue|integer|Bla bla bla|value=1}}
| {{MatParam|$defaultvalue|integer|value=1|Why do I have such a small value? :(}}
|}
|}



Revision as of 04:46, 6 April 2023

Edit-copy.png
This is a documentation subpage for Template:MatParamDef.
Don't forget to purge the contents of the base page upon creating or editing this subpage.

This template is used to generate material shader parameter definitions on material shader pages.

Usage

{{MatParam|<name>|<variable type>|<description>}}

Examples and Parameters

Parameter Description Example Preview
{{{text}}} Description of the parameter. If specified, then you will not encounter the problem of a broken description if there are equal signs in it.
{{MatParam | I'm deprecated | bool | text = Wow, I've been fixed! }}
I'm deprecated
{{{deprecated}}} This material parameter is deprecated and should no longer be used.
{{MatParam | I'm deprecated | bool | deprecated = 1 | Really, don't use me anymore! }}
I'm deprecated
{{{since}}} This material parameter is available since this game. Uses the template {{Since}}.
{{MatParam | $likealienswarm | bool | since = {{as}} | I'm available in Portal 2, too! }}
$likealienswarm
{{{also}}} This material parameter is also available in this game. Uses the template {{Also}}.
{{MatParam | $likealienswarm | bool | since = {{as}} | also = {{GMOD}} | I'm also available in Garry's Mod! }}
$likealienswarm
{{{only}}} This material parameter is available only in this/these game(s). Uses the template {{Only}}.
{{MatParam | $lovealienswarm | integer | only = {{as}} | I'm only available in Alien Swarm! }}
$lovealienswarm
{{{removed}}} This material parameter was removed in this game. Uses the template {{Removed}}.
{{MatParam | $dxparameter | int | removed = {{l4d}} | I was removed in Left 4 Dead! }}
$dxparameter
{{{dx9}}} This material parameter requires DX9 or higher to function.
{{MatParam | $dx9parameter | bool | dx9 = 1 | I require DX9 to work! }}
$dx9parameter
{{{dx8}}} This material parameter is for DX8, and should not be used for DX9.
{{MatParam | $dx8parameter | bool | dx8 = 1 | I'm a material parameter for DX8! }}
$dx8parameter
{{{to}}} Use this to define a set of material parameters with very similar names.
{{MatParam | $basetexture1 | to = $basetexture4 | texture | There are many of us... }}
$basetexture1
{{{and}}} Use this to define two material parameters with very similar names.
{{MatParam | $bumpmap | and = $bumpmap2 | texture | This shader supports two bump maps. }}
$bumpmap
{{{shaders}}} Lists the shaders for a specific material parameter. Uses the template {{Shaders}}.
{{MatParam | $shaderspecificparameter | float | shaders = VertexLitGeneric, UnlitGeneric | I only work with specific shaders! }}
$shaderspecificparameter
{{{value}}} Default Value
{{MatParam | $defaultvalue | integer | value = 1 | Bla bla bla }}
$defaultvalue

See Also