AddOn Studio

WoW:USERAPI GetMinimapShape: Difference between revisions

WoW Talk

WoW:USERAPI GetMinimapShape (source)

Revision as of 04:49, 15 August 2023

58 bytes added ,  15 August 2023
m
Move page script moved page USERAPI GetMinimapShape to WoW:USERAPI GetMinimapShape without leaving a redirect
(Add {{userapi}})
m (Move page script moved page USERAPI GetMinimapShape to WoW:USERAPI GetMinimapShape without leaving a redirect)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{userapi}}
{{userapi}}
GetMinimapShape is a function that is declared by the currently running minimap addon to provide information about what shape it is, in case other addons need to deal with the minimap's borders.
GetMinimapShape is a function that is declared by the currently running minimap addon to provide information about what shape it is, in case other addons need to deal with the minimap's borders.


It takes no arguments and returns one of the following strings:
It takes no arguments and returns one of the following strings:
; "ROUND" : standard shape, round. This is to be assumed if an unknown string is returned or if no string is returned or if GetMinimapShape does not exist.
; "ROUND"
; "SQUARE" : square shape.
: standard shape, round. This is to be assumed if an unknown string is returned or if no string is returned or if GetMinimapShape does not exist.
; "CORNER-TOPLEFT" : square, but with the top-left corner being round. This would normally be put at the bottom-right of the screen.
; "SQUARE"
; "CORNER-TOPRIGHT" : square, but with the top-right corner being round. This would normally be put at the bottom-left of the screen.
: square shape.
; "CORNER-BOTTOMLEFT" : square, but with the bottom-left corner being round. This would normally be put at the top-right of the screen.
; "CORNER-TOPLEFT"
; "CORNER-BOTTOMRIGHT" : square, but with the bottom-right corner being round. This would normally be put at the top-left of the screen.
: square, but with the top-left corner being round. This would normally be put at the bottom-right of the screen.
; "SIDE-LEFT" : square on the right side, rounded on the left side. This would normally be put at the right of the screen.
; "CORNER-TOPRIGHT"
; "SIDE-RIGHT" : square on the left side, rounded on the right side. This would normally be put at the left of the screen.
: square, but with the top-right corner being round. This would normally be put at the bottom-left of the screen.
; "SIDE-TOP" : square on the bottom side, rounded on the top side. This would normally be put at the bottom of the screen.
; "CORNER-BOTTOMLEFT"
; "SIDE-BOTTOM" : square on the top side, rounded on the bottom side. This would normally be put at the top of the screen.
: square, but with the bottom-left corner being round. This would normally be put at the top-right of the screen.
; "TRICORNER-TOPLEFT" : round, but with the bottom-right corner being square. This would normally be put at the bottom-right of the screen.
; "CORNER-BOTTOMRIGHT"
; "TRICORNER-TOPRIGHT" : round, but with the bottom-left corner being square. This would normally be put at the bottom-left of the screen.
: square, but with the bottom-right corner being round. This would normally be put at the top-left of the screen.
; "TRICORNER-BOTTOMLEFT" : round, but with the top-right corner being square. This would normally be put at the top-right of the screen.
; "SIDE-LEFT"
; "TRICORNER-BOTTOMRIGHT" : round, but with the top-left corner being square. This would normally be put at the top-left of the screen.
: square on the right side, rounded on the left side. This would normally be put at the right of the screen.
; "SIDE-RIGHT"
: square on the left side, rounded on the right side. This would normally be put at the left of the screen.
; "SIDE-TOP"
: square on the bottom side, rounded on the top side. This would normally be put at the bottom of the screen.
; "SIDE-BOTTOM"
: square on the top side, rounded on the bottom side. This would normally be put at the top of the screen.
; "TRICORNER-TOPLEFT"
: round, but with the bottom-right corner being square. This would normally be put at the bottom-right of the screen.
; "TRICORNER-TOPRIGHT"
: round, but with the bottom-left corner being square. This would normally be put at the bottom-left of the screen.
; "TRICORNER-BOTTOMLEFT"
: round, but with the top-right corner being square. This would normally be put at the top-right of the screen.
; "TRICORNER-BOTTOMRIGHT"
: round, but with the top-left corner being square. This would normally be put at the top-left of the screen.


It is possible this function will be called once a frame, so it is recommended not to do anything CPU-intensive in calculating the shape.
It is possible this function will be called once a frame, so it is recommended not to do anything CPU-intensive in calculating the shape.


This is currently used by [http://www.wowace.com/wiki/FuBarPlugin-2.0 FuBarPlugin-2.0] to determine position of minimap buttons.<br>
This is currently used by [http://www.wowace.com/wiki/FuBarPlugin-2.0 FuBarPlugin-2.0] to determine position of minimap buttons.<br />
This is currently used by [http://www.wowace.com/wiki/Cartographer/Notes Cartographer_Notes] to determine edge position of notes on the minimap.<br>
This is currently used by [http://www.wowace.com/wiki/Cartographer/Notes Cartographer_Notes] to determine edge position of notes on the minimap.<br />
This is currently used by [[MobileMinimapButtons]] to determine position of draggable minimap buttons.<br>
This is currently used by [[MobileMinimapButtons]] to determine position of draggable minimap buttons.<br />


This is the code currently used by FuBarPlugin-2.0 to determine position on the edge of a minimap:
This is the code currently used by FuBarPlugin-2.0 to determine position on the edge of a minimap:
Line 101: Line 114:
  local MinimapShapes = {
  local MinimapShapes = {
  -- quadrant booleans (same order as SetTexCoord)
  -- quadrant booleans (same order as SetTexCoord)
  -- {upper-left, lower-left, upper-right, lower-right}
  -- {bottom-right, bottom-left, top-right, top-left}
  -- true = rounded, false = squared
  -- true = rounded, false = squared
  ["ROUND"] = {true, true, true, true},
  ["ROUND"] = {true, true, true, true },
  ["SQUARE"] = {false, false, false, false},
  ["SQUARE"] = {false, false, false, false},
  ["CORNER-TOPLEFT"] = {true, false, false, false},
  ["CORNER-TOPLEFT"] = {false, false, false, true },
  ["CORNER-TOPRIGHT"] = {false, false, true, false},
  ["CORNER-TOPRIGHT"] = {false, false, true, false},
  ["CORNER-BOTTOMLEFT"] = {false, true, false, false},
  ["CORNER-BOTTOMLEFT"] = {false, true, false, false},
  ["CORNER-BOTTOMRIGHT"] = {false, false, false, true},
  ["CORNER-BOTTOMRIGHT"] = {true,  false, false, false},
  ["SIDE-LEFT"] = {true, true, false, false},
  ["SIDE-LEFT"] = {false, true, false, true },
  ["SIDE-RIGHT"] = {false, false, true, true},
  ["SIDE-RIGHT"] = {true, false, true, false},
  ["SIDE-TOP"] = {true, false, true, false},
  ["SIDE-TOP"] = {false, false, true, true },
  ["SIDE-BOTTOM"] = {false, true, false, true},
  ["SIDE-BOTTOM"] = {true, true, false, false},
  ["TRICORNER-TOPLEFT"] = {true, true, true, false},
  ["TRICORNER-TOPLEFT"] = {false, true, true, true },
  ["TRICORNER-TOPRIGHT"] = {true, false, true, true},
  ["TRICORNER-TOPRIGHT"] = {true, false, true, true },
  ["TRICORNER-BOTTOMLEFT"] = {true, true, false, true},
  ["TRICORNER-BOTTOMLEFT"] = {true, true, false, true },
  ["TRICORNER-BOTTOMRIGHT"] = {false, true, true, true},
  ["TRICORNER-BOTTOMRIGHT"] = {true, true, true, false},
  }
  }
   
   
  function UpdateButtonPosition(position, radius, rounding)
  function UpdateButtonPosition(position, radius, rounding)
  if not radius then rounding = 80 end
  if not radius then radius = 80 end
  if not rounding then rounding = 10 end
  if not rounding then rounding = 10 end
  local angle = math.rad(position) -- determine position on your own
  local angle = math.rad(position) -- determine position on your own
  local x = math.sin(angle)
  local x, y
  local y = math.cos(angle)
local cos = math.cos(angle)
  local sin = math.sin(angle)
  local q = 1;
  local q = 1;
  if x < 0 then
  if cos < 0 then
  q = q + 1; -- lower
  q = q + 1; -- lower
  end
  end
  if y > 0 then
  if sin > 0 then
  q = q + 2; -- right
  q = q + 2; -- right
  end
  end
Line 135: Line 149:
  local quadTable = MinimapShapes[minimapShape];
  local quadTable = MinimapShapes[minimapShape];
  if quadTable[q] then
  if quadTable[q] then
  x = x*radius;
  x = cos*radius;
  y = y*radius;
  y = sin*radius;
  else
  else
  local diagRadius = math.sqrt(2*(radius)^2)-rounding
  local diagRadius = math.sqrt(2*(radius)^2)-rounding
  x = math.max(-radius, math.min(x*diagRadius, radius))
  x = math.max(-radius, math.min(cos*diagRadius, radius))
  y = math.max(-radius, math.min(y*diagRadius, radius))
  y = math.max(-radius, math.min(sin*diagRadius, radius))
  end
  end
  frame:SetPoint("CENTER", Minimap, "CENTER", x, y)
  frame:SetPoint("CENTER", Minimap, "CENTER", x, y)
  end
  end
Anonymous user
Retrieved from "https://addonstudio.org/wiki/Special:MobileDiff/16787...16790"