Difference between revisions of "Engine ApplyEffectAtLocation"

From Dragon Age Toolset Wiki
Jump to: navigation, search
(fix some issues)
m (Correcting category)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{dafunction
 
{{dafunction
|name=Engine_ApplyEffectAtLocation
+
|name         = Engine_ApplyEffectAtLocation
|brief=This function applies an effect at a location.
+
|brief         = This function applies an effect at a location.
|param1type=int
+
|param1type   = int
|param1name=nDurationType
+
|param1name   = nDurationType
|param1desc=can be [[EFFECT_DURATION_TYPE_PERMANENT]], [[EFFECT_DURATION_TYPE_INSTANTANEOUS]] or [[EFFECT_DURATION_TYPE_TEMPORARY]]
+
|param1desc   = an [[EFFECT_DURATION_TYPE_*]] constant or literal
|param2type=effect
+
|param1default =
|param2name=eEffect
+
|param2type   = effect
|param2desc=the effect to be applied
+
|param2name   = eEffect
|param3type=location
+
|param2desc   = the effect to be applied
|param3name=lLocation
+
|param2default =
|param3desc=the location at which the effect is applied
+
|param3type   = location
|param4type=float
+
|param3name   = lLocation
|param4name=fDuration
+
|param3desc   = the location at which the effect is applied
|param4desc=this value needs to be set only when nDurationType is EFFECT_DURATION_TYPE_TEMPORARY
+
|param3default =
|param5type=object
+
|param4type   = float
|param5name=oCreator
+
|param4name   = fDuration
|param5desc=effect creator
+
|param4desc   = the duration in seconds (only required for temporary effects)
|param6type=int
+
|param4default = 0.0
|param6name=nAbilityId
+
|param5type   = object
|param6desc=ability id
+
|param5name   = oCreator
|returntype=void
+
|param5desc   = effect creator
|returndesc=
+
|param5default = OBJECT_SELF
|sourcefile=script.ldf
+
|param6type   = int
|sourcemodule=
+
|param6name   = nAbilityId
 +
|param6desc   = ability id
 +
|param6default = 0
 +
|returntype   = void
 +
|returndesc   =
 +
|sourcefile   = script.ldf
 +
|sourcemodule =
 
}}
 
}}
  
 
== Description ==
 
== Description ==
 
<!-- This section contains the full description from the functions comments. Do not change unless you are confident these are incomplete or incorrect. -->
 
<!-- This section contains the full description from the functions comments. Do not change unless you are confident these are incomplete or incorrect. -->
Applies eEffect to lLocation.  If nDurationType is EFFECT_DURATION_TYPE_TEMPORARY, then fDuration is the duration of the effect.
+
Applies <code>eEffect</code> at <code>lLocation</code>.   
  
<!-- == Remarks == -->
+
If <code>nDurationType</code> is <code>EFFECT_DURATION_TYPE_TEMPORARY</code>, then <code>fDuration</code> is the duration of the effect.
 +
== Remarks ==
 
<!-- This section contains additional comments, observations and known issues. -->
 
<!-- This section contains additional comments, observations and known issues. -->
 
+
The [[EFFECT_DURATION_TYPE_*]] constant which are valid for the <code>nDurationType</code> parameter are:
 +
* <code>EFFECT_DURATION_TYPE_INSTANTANEOUS</code>
 +
* <code>EFFECT_DURATION_TYPE_PERMANENT</code>
 +
* <code>EFFECT_DURATION_TYPE_TEMPORARY</code>
 
<!-- == Examples == -->
 
<!-- == Examples == -->
 
<!-- This section contains examples transcluded from the snippet library. -->
 
<!-- This section contains examples transcluded from the snippet library. -->
 
 
<!-- == See also == -->
 
<!-- == See also == -->
 
<!-- This section contains links to articles, functions or constant groups. -->
 
<!-- This section contains links to articles, functions or constant groups. -->
  
[[Category:Effect Access Functions]]
+
[[Category:Effect functions]]

Latest revision as of 20:01, 10 March 2012

This function applies an effect at a location.

void Engine_ApplyEffectAtLocation(
int nDurationType,
effect eEffect,
location lLocation,
float fDuration = 0.0,
object oCreator = OBJECT_SELF,
int nAbilityId = 0
);
Parameters:
nDurationType
an EFFECT_DURATION_TYPE_* constant or literal
eEffect
the effect to be applied
lLocation
the location at which the effect is applied
fDuration
the duration in seconds (only required for temporary effects)
oCreator
effect creator
nAbilityId
ability id
Returns:

Nothing.

Source:

script.ldf

Description

Applies eEffect at lLocation.

If nDurationType is EFFECT_DURATION_TYPE_TEMPORARY, then fDuration is the duration of the effect.

Remarks

The EFFECT_DURATION_TYPE_* constant which are valid for the nDurationType parameter are:

  • EFFECT_DURATION_TYPE_INSTANTANEOUS
  • EFFECT_DURATION_TYPE_PERMANENT
  • EFFECT_DURATION_TYPE_TEMPORARY