Effect - Revision history

Sunjammer: Fixing links, fixing category

2012-03-10T19:40:44Z

Fixing links, fixing category

BryanDerksen at 22:14, 15 January 2010

2010-01-15T22:14:06Z

Sunjammer: moved the "see also" to the see also section

2009-10-15T23:32:48Z

moved the "see also" to the see also section

Sunjammer: Generated by Sunjammer's Dragon Age Script Paser

2009-07-31T22:37:17Z

Generated by Sunjammer's Dragon Age Script Paser

BryanDerksen at 22:09, 31 July 2009

2009-07-31T22:09:20Z

BryanDerksen: 1 revision: re-import with default parameter value parameters set

2009-07-31T22:08:20Z

1 revision: re-import with default parameter value parameters set

BryanDerksen: disambiguate

2009-07-29T15:46:54Z

disambiguate

BryanDerksen: 1 revision: Importing auto-generated function articles

2009-07-29T15:44:22Z

1 revision: Importing auto-generated function articles

Sunjammer: Generated by Sunjammer's Dragon Age Script Paser

2009-07-29T01:40:43Z

Generated by Sunjammer's Dragon Age Script Paser

BryanDerksen: Category:Data types

2009-07-26T20:36:14Z

Category:Data types

@@ Line 1: / Line 1: @@
 {{dafunction
-|name=Effect
+|name          = Effect
-|brief=Creates a blank effect
+|brief         = Basic effect constructor.
-|param1type=int
+|param1type    = int
-|param1name=nType
+|param1name    = nType
-|param1desc=
+|param1desc    = an [[EFFECT_TYPE_*]] constant or literal
-|param1default=EFFECT_TYPE_INVALID
+|param1default = EFFECT_TYPE_INVALID
-|returntype=effect
+|returntype    = effect
-|returndesc=a blank effect
+|returndesc    = a blank effect
-|sourcefile=script.ldf
+|sourcefile    = script.ldf
-|sourcemodule=
+|sourcemodule  =
 }}
 == Description ==
 <!-- This section contains the full description from the functions comments. Do not change unless you are confident these are incomplete or incorrect. -->
-Creates an empty effect.
+Creates an basic effect of the specified type.
 == Remarks ==
-<!-- == Remarks == -->
 <!-- This section contains additional comments, observations and known issues. -->
+The basic effect constructor can be used to create any type of effect however it does not set any of the effect's other parameters so the effect returned may be incomplete. If an effect has additional parameters these would have to be set using [[SetEffectFloat]], [[SetEffectInteger]], etc. Therefore, for pre-existing effects such as damage or heal it is better to use the appropriate constructor, namely, [[EffectDamage]] or [[EffectHeal]].
 <!-- == Examples == -->
 <!-- This section contains examples transcluded from the snippet library. -->
 == See also ==
 <!-- This section contains links to articles, functions or constant groups. -->
-[[effect (data type)]]
+* [[Effect keyword]]
-[[Category: Effect access functions]]
+[[Category:Effect functions]]

@@ Line 1: / Line 1: @@
 {{dafunction
 |name=Effect
@@ Line 8: / Line 7: @@
 |param1default=EFFECT_TYPE_INVALID
 |returntype=effect
-|returndesc=
+|returndesc=a blank effect
 |sourcefile=script.ldf
 |sourcemodule=
@@ Line 15: / Line 14: @@
 == Description ==
 <!-- This section contains the full description from the functions comments. Do not change unless you are confident these are incomplete or incorrect. -->
-Creates an empty effect
+Creates an empty effect.
 <!-- == Remarks == -->

@@ Line 1: / Line 1: @@
 {{Generated with errors}}
 {{dafunction
@@ Line 24: / Line 23: @@
 <!-- This section contains examples transcluded from the snippet library. -->
-<!-- == See also == -->
+== See also ==
 <!-- This section contains links to articles, functions or constant groups. -->
 [[Category: Effect access functions]]

@@ Line 1: / Line 1: @@
 {{Generated with errors}}
 {{dafunction
@@ Line 8: / Line 6: @@
 |param1name=nType
 |param1desc=
 |returntype=effect
 |returndesc=

← Older revision		Revision as of 22:09, 31 July 2009
Line 1:		Line 1:
		+	:See also: [[effect (data type)]]
	{{Generated with errors}}		{{Generated with errors}}
	{{dafunction		{{dafunction

← Older revision	Revision as of 22:08, 31 July 2009
(One intermediate revision by one other user not shown)
(No difference)

← Older revision		Revision as of 15:46, 29 July 2009
Line 1:		Line 1:
		+	:See also: [[effect (data type)]]
		+
	{{Generated with errors}}		{{Generated with errors}}
	{{dafunction		{{dafunction

← Older revision	Revision as of 15:44, 29 July 2009
(No difference)

@@ Line 1: / Line 1: @@
-An Effect is a modifier that can be applied to a game object.  When the effect is removed (usually because the duration on the effect expires) the modifier is removed.  These modifiers can be rule or stat based or more complicated visual and game effects.
+{{Generated with errors}}
-Every effect has a type set on it that determines how it affects the object it is applied to.  They also have a number of parameters on them, which vary based on the type, that change the specific behaviour.
+== Description ==
-They can be assigned different duration types which affect how they're applied and removed:
+<!-- == Remarks == -->
-# '''Temporary:''' Applied for a short duration (measured in seconds)
+<!-- == Examples == -->
-# '''Permanent:''' Applied until manually removed through scripting
+<!-- This section contains examples transcluded from the snippet library. -->
-# '''Instant:'''  These are one-shot modifiers that are not stored on the object (the death effect is an instant modifier for example)
-# '''Equipped:''' Associated with an equipped item. The effect is removed when the item is unequipped.
-Some effect types can only be applied as instant effects.  These effects will delete themselves after they've been applied no matter what duration type was set for them.  All other duration types will be stored in a list on the object they're applied to.
+<!-- == See also == -->
-Effects are usually created and applied through the [[script|scripting language]].  The list of effects applied to an object can also be examined and modified through scripting.  The game engine itself will apply some instant effects when appropriate (like death or damage during combat).
+[[Category: Effect access functions]]
-−
-When an effect is applied through scripting, the designer has the option of specifying a sub-type on it.  The subtype, which can be either "normal" or "magical", affects whether a "Dispel Magic" spell should clear the effect or not (Dispel Magic is an instant effect type).  Magical effects are usually tagged with the spell id that created it so that more rules checking can be done when they're cleared.
-−
-Some effects trigger [[event]]s to the object that they're applied to.  This is especially important for hostile effects like damage or death.  Each effect is tagged with the object id of the creator so that the target can react appropriately.
-−
-All stat modifiers stack with each other.  If an object has two bonuses of the same type applied, they will get the full bonus from each.
-−
-When a game is reloaded, all the effects on an object are re-applied but with a special "loading" flag turned on.  Most effects will see this and do nothing, since the object they're applying themselves to has already had the modifiers applied.  A few effects will need to re-apply themselves if their effect is not easily saved.
-−
-Packages of effects can be constructed by "linking" them in the scripting language before they're applied.  Any effects that are linked together will be given the same unique id when they're applied.  If any effect in this group is then removed, either through expiry or scripting, then the entire group will go with them. This is most often used to tie a visual effect to a stat modifier.  When the modifier expires the visual effect will disappear.
-−
-Effects are applied internally by signalling an "apply effect" event with pointer to the effect attached.  They are usually removed in the same way because you don't know what else is linked to that effect and what dispelling them will do to the object.
-−
-The check to see if an effect has expired is done as part of an object's AI Update.  Some effect types also have timers that are checked here to see if they need to be given an update (used for regeneration type effects).
-−
-Party members will have a series of "effect icons" that appear on their character sheets so that the player can see what effects are on them.  These icons will be controlled by a special "Effect Icon" effect that will be linked to the spell's effects and managed by the scripter.
-−
-== Effect Behaviour ==
-−
-Behaviour for effects can be defined in either the engine or in scripting.  When an effect is applied or removed, the game will check for a defined handler for that effect type.  If none exists, then the object will receive an event to their script with the effect attached.
-−
-To access the effect in an onApply or onRemove event, use the <code>effect GetCurrentEffect()</code> scripting command.  The properties on this effect can be examined to determine type, duration and other parameters.  If your script handles the effect properly and you want it to be stored (so that you get the onRemove event later) you need to call the special <code>void SetIsCurrentEffectValid(int nValid)</code> function.  This will add it to the effect list on that object.
-−
-Effects will usually be handled by the core scripts rather than by an object's AI script.
-−
-[[Category:Data types]]

← Older revision		Revision as of 20:36, 26 July 2009
Line 38:		Line 38:
	Effects will usually be handled by the core scripts rather than by an object's AI script.		Effects will usually be handled by the core scripts rather than by an object's AI script.

−	[[Category:~~Scripts~~]]	+	[[Category:Data types]]