WoW:API GetMapInfo: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
{{wowapi}} __NOTOC__
{{wowapi}}


  mapFileName, textureHeight, textureWidth, isMicrodungeon, microDungeonMapName = GetMapInfo();
  mapFileName, textureHeight, textureWidth, isMicrodungeon, microDungeonMapName = GetMapInfo();
Line 5: Line 5:
Return the map information about the current world map texture.
Return the map information about the current world map texture.


----
== Parameters ==
;''Arguments''
=== Arguments ===
 
:''none''
:''none''


----
=== Returns ===
;''Returns''
 
:mapFileName, textureHeight, textureWidth
:mapFileName, textureHeight, textureWidth
:;mapFileName : String - The name of the file containing the textures for the current world map (<tt>nil</tt> for the whole world, BUT the official API catches this with a comment of <tt>Temporary Hack</tt> and uses the value "<tt>World</tt>" instead!)
:;textureHeight : Number - The height of the specified texture (0 if no texture)
:;textureWidth : Number - The width of the specified texture (0 if no texture) (<small>This is a guess, it's not used in the UI</small>)
:;isMicroDungeon : Boolean - True if the current map is a MicroDungeon, False otherwise.
:;microDungeonMapName : String - The name of the map for the current MicroDungeon, if applicable. (ex. ShrineofSevenStars)


----
* mapFileName (string) - The name of the file containing the textures for the current world map ('nil' for the whole world, BUT the official API catches this with a comment of 'Temporary Hack' and uses the value 'World' instead!)
;''Details''P
* textureHeight (number) - The height of the specified texture (0 if no texture)
* textureWidth (number) - The width of the specified texture (0 if no texture) (This is a guess, it's not used in the UI)
* isMicroDungeon (Boolean) - 'true' if the current map is a MicroDungeon, 'false' otherwise.
* microDungeonMapName (string) - The name of the map for the current MicroDungeon, if applicable. (ex. ShrineofSevenStars)


== Details ==
Note that the width and height aren't in a consistent order with most of the other API functions. Neither of the values are used by the UI so it's impossible to tell whether this is a deliberate inconsistency or a typo! The return values would appear to imply they are, however, reversed from the usual width, height convention.
Note that the width and height aren't in a consistent order with most of the other API functions. Neither of the values are used by the UI so it's impossible to tell whether this is a deliberate inconsistency or a typo! The return values would appear to imply they are, however, reversed from the usual width, height convention.

Revision as of 03:32, 29 May 2020

WoW API < GetMapInfo

mapFileName, textureHeight, textureWidth, isMicrodungeon, microDungeonMapName = GetMapInfo();

Return the map information about the current world map texture.

Parameters

Arguments

none

Returns

mapFileName, textureHeight, textureWidth
  • mapFileName (string) - The name of the file containing the textures for the current world map ('nil' for the whole world, BUT the official API catches this with a comment of 'Temporary Hack' and uses the value 'World' instead!)
  • textureHeight (number) - The height of the specified texture (0 if no texture)
  • textureWidth (number) - The width of the specified texture (0 if no texture) (This is a guess, it's not used in the UI)
  • isMicroDungeon (Boolean) - 'true' if the current map is a MicroDungeon, 'false' otherwise.
  • microDungeonMapName (string) - The name of the map for the current MicroDungeon, if applicable. (ex. ShrineofSevenStars)

Details

Note that the width and height aren't in a consistent order with most of the other API functions. Neither of the values are used by the UI so it's impossible to tell whether this is a deliberate inconsistency or a typo! The return values would appear to imply they are, however, reversed from the usual width, height convention.