WoW:API GetLootSlotInfo: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
mNo edit summary
No edit summary
Line 3: Line 3:
<!-- List return values and arguments as well as function name, follow Blizzard usage convention for args -->
<!-- List return values and arguments as well as function name, follow Blizzard usage convention for args -->


  lootIcon, lootName, lootQuantity, rarity = GetLootSlotInfo(''index'');
  lootIcon, lootName, lootQuantity, rarity, locked = GetLootSlotInfo(''index'');


<!-- Describe the purpose of the function, though exhausting detail can be saved for a later section -->
<!-- Describe the purpose of the function, though exhausting detail can be saved for a later section -->
Line 13: Line 13:


<!-- List each argument, together with its type -->
<!-- List each argument, together with its type -->
: slot
:; slot: Number - the index of the item (1 is the first item)
:; slot: Number - the index of the item (1 is the first item)


Line 20: Line 19:


<!-- List each return value, together with its type -->
<!-- List each return value, together with its type -->
: lootIcon
:; lootIcon: String - The path of the graphical icon for the item.
:; lootIcon: String - The path of the graphical icon for the item.
: lootName
:; lootName: String - The name of the item.
:; lootName: String - The name of the item.
: lootQuantity
:; lootQuantity: Number - The quantity of the item in a stack. ''Note: Quantity for coin is always 0.''
:; lootQuantity: Number - The quantity of the item in a stack. ''Note: Quantity for coin is always 0.''
: rarity
:; rarity: Number - 0 for grey, 1 for white items and quest items, 2 for green, 3 for blue and have not seen output with epics yet presumably it would be 4 as it has incremented so far.
:; rarity: Number - 0 for grey, 1 for white items and quest items, 2 for green, 3 for blue and have not seen output with epics yet presumably it would be 4 as it has incremented so far.
:; locked: Whether you are eligible to loot this item or not. Locked items are by default shown tinted red.


----
----
Line 33: Line 29:


<!-- If it helps, include an example here, though it's not required if the usage is self-explanatory -->
<!-- If it helps, include an example here, though it's not required if the usage is self-explanatory -->
  local lootIcon, lootName, lootQuantity, rarity= GetLootSlotInfo(1);
  local lootIcon, lootName, lootQuantity, rarity, locked = GetLootSlotInfo(1);


;''Result''
;''Result''
Line 41: Line 37:
: lootQuantity is 0
: lootQuantity is 0
: rarity is 0
: rarity is 0
: locked is 0


----
----

Revision as of 23:54, 2 February 2009

WoW API < GetLootSlotInfo


lootIcon, lootName, lootQuantity, rarity, locked = GetLootSlotInfo(index);


Returns the information for a loot slot.


Arguments
slot
Number - the index of the item (1 is the first item)

Returns
lootIcon
String - The path of the graphical icon for the item.
lootName
String - The name of the item.
lootQuantity
Number - The quantity of the item in a stack. Note: Quantity for coin is always 0.
rarity
Number - 0 for grey, 1 for white items and quest items, 2 for green, 3 for blue and have not seen output with epics yet presumably it would be 4 as it has incremented so far.
locked
Whether you are eligible to loot this item or not. Locked items are by default shown tinted red.

Example
local lootIcon, lootName, lootQuantity, rarity, locked = GetLootSlotInfo(1);
Result
lootIcon is "Interface\Icons\INV_Misc_Coin_06"
lootName is "3 silver 40 copper"
lootQuantity is 0
rarity is 0
locked is 0

Notes

When returning coin data, the 'quanity' is always 0 and the 'item' contains the amount and text. It also includes a line break after each type of coin. The linebreak can be removed by string substitution.

DEFAULT_CHAT_FRAME:AddMessage("coins: "..string.gsub(item,"\n"," "),1,1,1);