WoW:API GetSpecializationInfo: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
mNo edit summary
(genderCode argument added)
Line 1: Line 1:
{{wowapi}}
{{wowapi}}
Returns information about the player's specializations.
Returns information about the player's specializations.
  local id, name, description, icon, background, role = GetSpecializationInfo(specIndex [, isInspect [, isPet]])
  local id, name, description, icon, background, role = GetSpecializationInfo(specIndex [, isInspect [, isPet [, ? [, genderCode]]]])


== Arguments ==
== Arguments ==
Line 7: Line 7:
;isInspect : Optional boolean - If true, query specialization information for the inspected unit.
;isInspect : Optional boolean - If true, query specialization information for the inspected unit.
;isPet : Optional boolean - If true, query specialization information for the player's pet.
;isPet : Optional boolean - If true, query specialization information for the player's pet.
;genderCode : Number - Index returned by {{Api|UnitSex}}().


== Returns ==
== Returns ==

Revision as of 19:07, 21 August 2015

WoW API < GetSpecializationInfo

Returns information about the player's specializations.

local id, name, description, icon, background, role = GetSpecializationInfo(specIndex [, isInspect [, isPet [, ? [, genderCode]]]])

Arguments

specIndex
Number - Index of the specialization to query, ascending from 1 to GetNumSpecializations().
isInspect
Optional boolean - If true, query specialization information for the inspected unit.
isPet
Optional boolean - If true, query specialization information for the player's pet.
genderCode
Number - Index returned by UnitSex().

Returns

id
Number - specializationID.
name
String - specialization name, e.g. "Balance".
description
String - description of the specialization, e.g. "Can take on the form of a powerful Moonkin, balancing the power of Arcane and Nature magic to destroy enemies at a distance."
icon
String - Texture path to this specialization's icon.
background
String - Background texture name for this talent tree; prepend "Interface\TALENTFRAME\" to this value for a valid texture path.
role
String - This specialization's intended role in a party, one of "DAMAGER", "TANK", "HEALER".

Details

  • Despite the argument names, this function does not appear to return valid information for inspected units. FrameXML uses GetInspectSpecialization("unit") to retrieve a specialization ID instead.
    • Warning: As of 2012/07/12, this seems to be quite often buggy. The return of GetInspectSpecialization() should be a number less than 500, but sometimes is far greater and not interpretable. FrameXML is therefore 'validating' the value by calling GetSpecializationRoleByID(), and only if that returns a non-nil value, it decodes the number with GetSpecializationInfoByID().

Patch history

Template:Mists-inline <span style="" title="Patch 5.0.4">Patch 5.0.4</span> (patch date::28-August-2012): Replaced GetTalentTabInfo.

See also