WoW:API SetRaidTarget: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
No edit summary
Line 4: Line 4:


== Arguments ==
== Arguments ==
;unit : String - The [[API TYPE UnitId|unit]] to change the target markers of.
;unit
;iconId : Number - Raid icon index; 0 to remove any icons from the unit.
: String - The [[API TYPE UnitId|unit]] to change the target markers of.
;iconId
: Number - Raid icon index; 0 to remove any icons from the unit.
::1 = Yellow 4-point Star
::1 = Yellow 4-point Star
::2 = Orange Circle
::2 = Orange Circle
::3 = Purple Diamond
::3 = Pink Diamond
::4 = Green Triangle
::4 = Green Triangle
::5 = White Crescent Moon
::5 = White Crescent Moon
Line 23: Line 25:
* In a 5-man party, all party members may assign raid icons. In a raid, only the raid leader and the assistants may do so.
* In a 5-man party, all party members may assign raid icons. In a raid, only the raid leader and the assistants may do so.
* Units may only be assigned one icon at a time; an icon may only be assigned to one unit at a time.
* Units may only be assigned one icon at a time; an icon may only be assigned to one unit at a time.
* This function does not remove the icon if you're trying to assign the icon that is already assigned to the unit. {{api|SetRaidTargetIcon}} function, provided by FrameXML, provides this toggling behavior. (This note seems to be false. SetRaidTarget does currently toggle the icon off if it is already set. You can use [http://www.wowwiki.com/API_GetRaidTargetIndex GetRaidTargetIndex] to check if the icon already exists on the unit)
* This function does not remove the icon if you're trying to assign the icon that is already assigned to the unit. {{api|SetRaidTargetIcon}} function, provided by FrameXML, provides this toggling behavior. (This note seems to be false. SetRaidTarget does currently toggle the icon off if it is already set. You can use [http://www.wowwiki.com/API_GetRaidTargetIndex GetRaidTargetIndex] to check if the icon already exists on the unit)

Revision as of 20:06, 16 November 2013

WoW API < SetRaidTarget

Set which target markers will be shown over a mob or raid member.

SetRaidTarget("unit", iconId);

Arguments

unit
String - The unit to change the target markers of.
iconId
Number - Raid icon index; 0 to remove any icons from the unit.
1 = Yellow 4-point Star
2 = Orange Circle
3 = Pink Diamond
4 = Green Triangle
5 = White Crescent Moon
6 = Blue Square
7 = Red "X" Cross
8 = White Skull

Example

To set a skull over your current target:

/script SetRaidTarget("target",8);

Notes

  • This function was added in patch 1.11, which introduced the 8 different target icons that can be assigned to mobs or players. The icons are only visible to your party.
  • In a 5-man party, all party members may assign raid icons. In a raid, only the raid leader and the assistants may do so.
  • Units may only be assigned one icon at a time; an icon may only be assigned to one unit at a time.
  • This function does not remove the icon if you're trying to assign the icon that is already assigned to the unit. SetRaidTargetIcon function, provided by FrameXML, provides this toggling behavior. (This note seems to be false. SetRaidTarget does currently toggle the icon off if it is already set. You can use GetRaidTargetIndex to check if the icon already exists on the unit)