$definevariable

From Valve Developer Community
Revision as of 20:06, 7 March 2024 by Stiffy360 (talk | contribs) (Clarified language and provided an example of passing a variable to a macro)
Jump to navigation Jump to search

The $definevariable QC command creates a Wikipedia icon variable. The variable's name, if surrounded by $, will be substituted by its value whenever encountered.

Note.pngNote:Variables do not work within "quote blocks"!
Note.pngNote:Variables declared out of the scope of a macro can't be used within the macro. You can pass the data on to the macro by instead using it as a token of the macro and retrieving it that way.
Note.pngNote:If you define the same variable twice, the compiler will use the first one it finds and drop the second one.
Icon-Bug.pngBug:Similar tokens prefixes causes to the compiler parser: merge, swap or even ignore it variable values. This doesn't happen with Source Filmmaker Source Filmmaker and Garry's Mod Garry's Mod  [todo tested in ?]
Icon-Bug.pngBug:tokens cannot be pushed further than 3 $include levels  [todo tested in ?]

This command is like a 'lite' version of $definemacro.

Example

$definevariable baseFile "fighter1"

$sequence attack $baseFile$_Attack // results in -> fighter1_Attack when resolved
$sequence run $baseFile$_Run
$sequence idle $baseFile$_Idle

Here's an example of passing the variable to a macro

$definevariable baseFile "fighter1"

$definemacro makefighteranim fightername framerate \\
$sequence attack $baseFile$_Attack ( fps $framerate$ } \\
$sequence run $baseFile$_Run { fps $framerate$ } \\
$sequence idle $baseFile$_Idle { fps $framerate$ } \\

$makefighteranim $basefile$ 30