Difference between revisions of "GetNthSummon"

From the Oblivion ConstructionSet Wiki
Jump to navigation Jump to search
imported>Kyoma
imported>Kyoma
Line 11: Line 11:
==Examples:==
==Examples:==


Getting the number of summons active on a reference (in this case the player)
Getting a reference to a summon active on a reference (in this case the player)
  Let rSummon := player.Call GetNthSummon 0
  Let rSummon := player.Call GetNthSummon 0
  Let rSummon := player.Call GetNthSummon 1
  Let rSummon := player.Call GetNthSummon 1
  . . .
  . . .
  Let rSummon := player.Call GetNthSummon ''Nth''
  Let rSummon := player.Call GetNthSummon ''Nth''
 
==Code==
==Code==


Line 43: Line 43:
* [[User Functions]]
* [[User Functions]]
* [[GetNumSummons]]
* [[GetNumSummons]]
* [[GetSummons]]
[[Category: User Functions]]
[[Category: User Functions]]



Revision as of 10:37, 24 December 2009

A User Function for use with Oblivion Script Extender

Syntax:

(summon:ref) reference.Call GetNthSummon whichSummon:short

Returns a reference to the nth actor currently summoned by the calling actor.

Notes

  • This function must be called on a reference (Ref.call <function>)

Examples:

Getting a reference to a summon active on a reference (in this case the player)

Let rSummon := player.Call GetNthSummon 0
Let rSummon := player.Call GetNthSummon 1
. . .
Let rSummon := player.Call GetNthSummon Nth

Code

ScriptName GetNthSummon
long iNth
array_var arFollowers
ref rFollower
long iFollower

Begin Function {iNth}
	let arFollowers := GetFollowers
	let iFollower := GetNumFollowers
 	While iFollower > 0
		let iFollower -= 1
		let rFollower := GetNthFollower iFollower
		ar_Erase arFollowers ( ar_Find rFollower arFollowers )
	Loop

	if TestExpr arFollowers[iNth]
		SetFunctionValue arFollowers[iNth]
	endif
 	let arFollowers := ar_Null
 End 

See Also