Difference between revisions of "Template:Function"

From the Oblivion ConstructionSet Wiki
Jump to navigation Jump to search
imported>DragoonWraith
imported>DragoonWraith
Line 29: Line 29:


<pre>{{Function
<pre>{{Function
  |origin = CS1
  |origin = OBSE
  |summary = Plays the visuals of the specified Magic Effect on the calling reference.
  |summary = Sets the constant effect barter factor of the magic effect.
  |name = PlayMagicEffectVisuals
  |name = SetMagicEffectBarterFactor
  |alias = pme
  |alias = SetMEBarterFactor
|altName = SetMagicEffectBarterFactorC
|altAlias = SetMEBarterFactorC
  |returnVal = nothing
  |returnVal = nothing
  |returnType = void
  |returnType = void
|referenceType = [Actor, Activator]
  |arguments =  
  |arguments =  
   {{FunctionArgument
   {{FunctionArgument
   |Name = mgefID
   |Name = newBarterFactor
   |Type = ref
   |Type = float
   }}{{FunctionArgument
   }}{{FunctionArgument
   |Name = duration
   |Name = effect
   |Type = short
   |Type = chars
  |Optional = y
   }}
   }}
  |example = PlayMagicEffectVisuals FIDG
|altArgs =
  pme FTHR 10
  {{FunctionArgument
  |Name = newBarterFactor
  |Type = float
  }}{{FunctionArgument
  |Name = effectCode
  |Type = long
  }}
  |example = SetMagicEffectBarterFactor 5 FIDG
  SetMEBarterFactorC 1.5 1397247044 ; code for SHLD
}}</pre>
}}</pre>


Line 52: Line 60:


{{Function
{{Function
  |origin = CS1
  |origin = OBSE
  |summary = Plays the visuals of the specified Magic Effect on the calling reference.
  |summary = Sets the constant effect barter factor of the magic effect.
  |name = PlayMagicEffectVisuals
  |name = SetMagicEffectBarterFactor
  |alias = pme
  |alias = SetMEBarterFactor
|altName = SetMagicEffectBarterFactorC
|altAlias = SetMEBarterFactorC
  |returnVal = nothing
  |returnVal = nothing
  |returnType = void
  |returnType = void
|referenceType = [Actor, Activator]
  |arguments =  
  |arguments =  
   {{FunctionArgument
   {{FunctionArgument
   |Name = mgefID
   |Name = newBarterFactor
   |Type = ref
   |Type = float
  }}{{FunctionArgument
  |Name = effect
  |Type = chars
  }}
|altArgs =
  {{FunctionArgument
  |Name = newBarterFactor
  |Type = float
   }}{{FunctionArgument
   }}{{FunctionArgument
   |Name = duration
   |Name = effectCode
   |Type = short
   |Type = long
  |Optional = y
   }}
   }}
  |example = PlayMagicEffectVisuals FIDG
  |example = SetMagicEffectBarterFactor 5 FIDG
  pme FTHR 10
  SetMEBarterFactorC 1.5 1397247044 ; code for SHLD
}}
}}



Revision as of 01:11, 6 August 2010



This is a WIP, feedback is appreciated. To retain readability a lot of HTML comments are used, they shouldn't impact the working of the template, but could add to the confusion a bit.

{{Function
 origin            = whether the function came from the CS itself or was added by OBSE.
                     valid values: CS1 (TES CS 1.0), CS1.1 (TES CS 1.1), CS1.2 (TES CS 1.2), OBSE
 summary           = description of the function
 name              = the name of the function. The page name is the default value.
 alias             = An abbreviated version of the function name that can be
                     used instead of the long name.
 altName           = the name of an alternate version of a function (e.g. the "C" Magic Effect functions)
 altAlias          = the alias of the alternate function.
 returnVal         = what the function returns.
 returnType        = the type of the returned value.
 referenceType     = if appropriate, the type of reference that the function may be called
                     on with the dot syntax
 referenceOpt      = if can take a reference, whether it must take a reference.
 arguments         = List of arguments specified using the {{FunctionArgument}} template,
                     or any other wiki syntax.
 altArgs           = List of arguments for the alternate version of the function.
 example           = optionally, the function used as part of a script to serve as an example
 CategoryList      = the list of categories to which the page belongs
}}

Example

{{Function
 |origin = OBSE
 |summary = Sets the constant effect barter factor of the magic effect.
 |name = SetMagicEffectBarterFactor
 |alias = SetMEBarterFactor
 |altName = SetMagicEffectBarterFactorC
 |altAlias = SetMEBarterFactorC
 |returnVal = nothing
 |returnType = void
 |arguments = 
  {{FunctionArgument
   |Name = newBarterFactor
   |Type = float
  }}{{FunctionArgument
   |Name = effect
   |Type = chars
  }}
 |altArgs = 
  {{FunctionArgument
   |Name = newBarterFactor
   |Type = float
  }}{{FunctionArgument
   |Name = effectCode
   |Type = long
  }}
 |example = SetMagicEffectBarterFactor 5 FIDG
 SetMEBarterFactorC 1.5 1397247044 ; code for SHLD
}}

Result

A function added by the Oblivion Script Extender.

Syntax:

(void)SetMagicEffectBarterFactor  
(void)SetMEBarterFactor  (void)SetMagicEffectBarterFactorC  
(void)SetMEBarterFactorC  

Sets the constant effect barter factor of the magic effect.

Example

SetMagicEffectBarterFactor 5 FIDG
SetMEBarterFactorC 1.5 1397247044 ; code for SHLD