WoW:API GetShapeshiftForm: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
m (human form -> humanoid form (not everyone plays human after all))
m (Move page script moved page API GetShapeshiftForm to API GetShapeshiftForm without leaving a redirect)
 
(12 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{wowapi}}
{{wowapi}}
  stance = GetShapeshiftForm(arg1);
  index = GetShapeshiftForm(flag);


== Parameters ==
== Parameters ==
Line 6: Line 6:
<big>'''Arguments'''</big>
<big>'''Arguments'''</big>


:(arg1)
:; flag: Boolean (Optional) - True if return value is to be compared to a macro's conditional statement. This makes it always return zero for Presences and Auras. False or nil returns an index based on which button to highlight on the shapeshift/stance bar left to right starting at 1.
:; arg1 : Boolean - Unknown purpose. the only argument Blizzard sends to this function is true


<big>'''Returns'''</big>
<big>'''Returns'''</big>
:stance
:;index : Number - one of following:
 
:;stance : Number - one of following:


::;Any class
::;Any class
:::*0 = humanoid form
:::*0 = humanoid form
::;Death Knight (only when arg1 is nil)
:::*1 = Blood Presence
:::*2 = Frost Presence
:::*3 = Unholy Presence


::;Druid
::;Druid
Line 22: Line 24:
:::*3 = Cat Form
:::*3 = Cat Form
:::*4 = Travel Form
:::*4 = Travel Form
:::*5 = Moonkin/Tree Form
:::*5 = Moonkin Form (balance) / Flight Form (resto/feral/guardian)
:::*6 = Flight Form
:::*6 = Flight Form (balance) / Tree Form (resto)


::;Paladin
::;Paladin (only when arg1 is nil)
:::*1 = Devotion Aura
:::*1 = Seal of Truth
:::*2 = Retribution Aura
:::*2 = Seal of Righteousness
:::*3 = Concentration Aura
:::*3 = Seal of Insight - Seal of Justice if retribution
:::*4 = Shadow Resistance Aura
:::*4 = Seal of Insight if retribution
:::*5 = Frost Resistance Aura
::: In 3.3.5a it appears the function returns the currently active Paladin Aura:
:::*6 = Fire Resistance Aura
:::* 0 - No paladin aura active
:::*7 = Crusader Aura
:::* 1 - Devotion Aura
:::*? = Sanctity Aura (Retribution Talent, unknown where it fits.)
:::* 2 - Retribution Aura
:::* 3 - Concentration Aura
:::* ....


::;Rogue
::;Priest
:::*1 = Stealth
:::* 1 = Chakra: Chastise or Shadowform
:::* 2 = Chakra: Sanctuary
:::* 3 = Chakra: Serenity
:::* 4 = Spirit of Redemption
 
::; Rogue
:::*1 = Stealth (3.1 - If the player has ''not'' learned the Shadow Dance talent, 1 is returned while in Stealth)
:::*2 = Stealth (3.1 - If the player has learned the Shadow Dance talent, 2 is returned while in Stealth instead of 1)
:::*3 = Shadow Dance (3.1 - This is used while Shadow Dance is active)
:::Note: This seems to have changed again in 3.2. It seems now that 1 is always stealth, and 3 is Shadow Dance. I have not done thorough testing to prove this though, so I'm leaving the 3.1 info.
 
::;Shaman
:::*1 = Ghost Wolf


::;Warrior
::;Warrior
:::*1 = Battle Stance
:::*1 = Battle Stance
:::*2 = Defensive Stance
:::*2 = Defensive Stance
:::*3 = Beserker Stance
:::*3 = Berserker Stance


== Example ==
== Example ==
  local nStance = GetShapeshiftForm(true);
  local nStance = GetShapeshiftForm();
 
== Notes ==
For some classes the return value is nil during the loading process. You need to wait until UPDATE_SHAPESHIFT_FORMS fires to get correct return values.

Latest revision as of 04:46, 15 August 2023

WoW API < GetShapeshiftForm

index = GetShapeshiftForm(flag);

Parameters[edit]

Arguments

flag
Boolean (Optional) - True if return value is to be compared to a macro's conditional statement. This makes it always return zero for Presences and Auras. False or nil returns an index based on which button to highlight on the shapeshift/stance bar left to right starting at 1.

Returns

index
Number - one of following:
Any class
  • 0 = humanoid form
Death Knight (only when arg1 is nil)
  • 1 = Blood Presence
  • 2 = Frost Presence
  • 3 = Unholy Presence
Druid
  • 1 = Bear/Dire Bear Form
  • 2 = Aquatic Form
  • 3 = Cat Form
  • 4 = Travel Form
  • 5 = Moonkin Form (balance) / Flight Form (resto/feral/guardian)
  • 6 = Flight Form (balance) / Tree Form (resto)
Paladin (only when arg1 is nil)
  • 1 = Seal of Truth
  • 2 = Seal of Righteousness
  • 3 = Seal of Insight - Seal of Justice if retribution
  • 4 = Seal of Insight if retribution
In 3.3.5a it appears the function returns the currently active Paladin Aura:
  • 0 - No paladin aura active
  • 1 - Devotion Aura
  • 2 - Retribution Aura
  • 3 - Concentration Aura
  • ....
Priest
  • 1 = Chakra: Chastise or Shadowform
  • 2 = Chakra: Sanctuary
  • 3 = Chakra: Serenity
  • 4 = Spirit of Redemption
Rogue
  • 1 = Stealth (3.1 - If the player has not learned the Shadow Dance talent, 1 is returned while in Stealth)
  • 2 = Stealth (3.1 - If the player has learned the Shadow Dance talent, 2 is returned while in Stealth instead of 1)
  • 3 = Shadow Dance (3.1 - This is used while Shadow Dance is active)
Note: This seems to have changed again in 3.2. It seems now that 1 is always stealth, and 3 is Shadow Dance. I have not done thorough testing to prove this though, so I'm leaving the 3.1 info.
Shaman
  • 1 = Ghost Wolf
Warrior
  • 1 = Battle Stance
  • 2 = Defensive Stance
  • 3 = Berserker Stance

Example[edit]

local nStance = GetShapeshiftForm();

Notes[edit]

For some classes the return value is nil during the loading process. You need to wait until UPDATE_SHAPESHIFT_FORMS fires to get correct return values.