Original code: Sir.Bender <Meog on WoW Forums>
Contributors:
ciphersimian
... and MANY others whose names didn't appear in the code anywhere
***********
Description
***********
Adds a note system to the WorldMap helping you keep track of interesting locations.
MapNotes(Fan's Update) also provides a Plugin interface for other AddOns to take advantage of the note making ability. AlphaMap(Fans Update) uses this interface to allow Note creation on AlphaMap Maps of Instances, BattleGrounds, and World Boss Maps. This version of MapNotes comes with in-built support for creation of notes on Atlas maps, also using this Plugin interface.
For these purpose MapNotes offers the following main functions:
1. Marking notes on the WorldMap
2. Showing one of these notes on the MiniMap (see MiniNote)
3. Allows any other AddOn to use MapNotes note creation ability to mark notes on frames within their own AddOn :
- Marking notes on AlphaMap (Fan's Update) Instance maps
- Marking notes on Atlas maps
"/tloc" can be used to toggle this AddOns minimap coordinates instead of Thottbott's minimap coordinates.
NOTE : PLEASE still use "/mn -tloc xx,yy" to place a Thottbott marker on the map. "/tloc" ONLY toggles Minimap Coordinates.
Should be compatible with both Cartographer, although you may no longer be able to create notes on the map with the in-built functionality provided by that AddOn - only with the functionality provided by MapNotes (Fan's Update).
********
Features
********
[Slash Commands] - NOTE : See separate file "LegacySlashCommands.txt" for old style commands
================
/mapnote OR /mapnotes OR /mn
Use without any other parameters to see which version of MapNotes is installed, and access the list of available Slash Commands.
Otherwise can be used to insert a Map Note by a slash command (which you can create in the Send Menu), for example, to put a note at the Entrance of Stormwind City on the map Elwynn Forest:
NOTE: The above would all be on one line Description of the identifiers:
k<#> - Key based on the map name from GetMapInfo() prefixed by "WM " (English name on all clients - never localised) Varies for other AddOns using the Plugin functionality
x<#> - X coordinate, based on the GetPlayerMapPosition() function
y<#> - Y coordinate, based on the GetPlayerMapPosition() function
t<text> - Title for the MapNote
i1<text> - first line of text displayed under the Title in the MapNote (Info 1)
i2<text> - second line of text displayed under the Title in the MapNote (Info 2)
cr<text> - Creator of the MapNote
i<#> - icon to use for the MapNote, AddOns/MapNotes/POIIcons/Icon#.tga
tf<#> - color of the Title, AddOns/MapNotes/POIIcons/Color#.tga
i1f<#> - color of the Info 1 line (colors as above)
i1f<#> - color of the Info 2 line (colors as above)
mn<1> - (optional) If included, then a value of 1 will set the note as a mininote also. Any other value and the note will NOT be set as a mininote.
/mn -allow OR /mn -a
Allows you to receive the next note, even if you have disabled receiving in the options. If invoked with no parameters, it will toggle the current state.
/mn -automini
Shows the next note created (using any method) as a MiniNote and also puts it on the WorldMap. If invoked with no parameters, it will toggle the current state.
/mn -allmini
Toggle all MapNotes off/on as Mininotes
(Keybinding also available)
/mn -nextmini
Shows the next note created (using any method) as a MiniNote and also puts it on the WorldMap. If invoked with no parameters, it will toggle the current state.
/mn -minionly
Like the previous command, but doesn't put the note on the WorldMap.
/mn -minioff
Turns the MiniNote off.
/mn -tloc tbX,tbY
Sets a "Thottbot location" on the map. Use it with no arguments to toggle it off.
See the Section on Formatting of X,Y Coordinates
/mn -q [icon] [name]
Adds a note at your current location, icon and name are optional (icon any number from 0 to 9, AddOns/MapNotes/POIIcons/Icon#.tga)
If no [name] is passed, then the Note will be named based on the MiniMap Text, and the second/third lines will be populated with more zone information and/or the default QuickNote text.
/mn -qtloc xx,yy [icon] [name]
See the Section on Formatting of X,Y Coordinates
Adds a note on the map you are currently on at the given thottbot location, icon and name are optional (icon any number from 0 to 9, AddOns/MapNotes/POIIcons/Icon#.tga)
NEW SLASH COMMANDS IN MapNotes(Fan's Update)
/mn -s [search text]
If you want to search for a note, to see if one exists, or where it is, then you can use this command, and MapNotes will print out a report in the chat window, displaying the names of all maps which have a note containing that text
/mn -hl [note name]
If you have lots of notes and want to clearly identify a single one on a map, or if you want a certain note to remain highlighted, then use this command and they will be displayed with a green circle around them.
If there are several notes with that name or containing that text, then they will ALL be highlighted.
The note name does not have to be case sensitive, and doesn't have to be an exact match - all notes containing the [note name] text will be highlighted.
If the EXACT NAME is specified (not case-sensitive), the note will also be marked as a MiniNote on the Minimap
/mn -mapc
Toggle the display of Player and Cursor Coordinates on the World Map
Control-Left-Click and drag the coordinates to move them to a different position on the World Map if you are not happy with the default.
/mn -minic
Toggle the display of Player coordinates below the Minimap.
/mn -t [icon] [name]
Creates a quicknote at the Player's current location if the Player has no target.
If the Player does have a target, then it will create a note for that target at the Player's current location, icon and name are optional (icon any number from 0 to 9, AddOns/MapNotes/POIIcons/Icon#.tga)
/mn -m
Creates a note for the Player's target at the Player's current location.
OR Merges the details for the Player's current target in to a Map Note that has already been created at the Player's current location.
MUST have targetted a Player/NPC/Mob for this to work.
/mn -scale [0.5 - 1.5]
The size of MapNotes Menus and Frames are now fixed no matter what the scale of the World Map or other AddOn Map being used.
This command can be used to change the default size of MapNotes Menus and Frames if the user finds it too small or large.
The default value is 0.7
Therefore "/mn -scale 1.0" will make the Menus and Frames appear larger than they do by default.
/mn -undelete
Will undelete the last deleted MapNote.
IMPORTANT NOTE ON THE IMPORT FUNCTIONS BELOW
All of the functions below are mainly designed for people who have just installed MapNotes (Fan's Update). If you have been using this version of MapNotes for some time already, and have your own notes, then these functions may overwrite your existing notes. YOU HAVE BEEN WARNED.
/script MapNotes_ImportCarto()
NOTE: only works with English localisation currently
If you want to move from Cartographer 2 to MapNotes, then log in to the game with both AddOns enabled, ust the above command, after which you will receive notification in the chat window on how many notes have been imported.
/MapNotes_Import_MetaMap
If you want to move from MetaMapNotes to MapNotes, then log in to the game with both AddOns enabled, use the above command, after which you will receive notification in the chat window on how many notes have been imported.
/MapNotes_Import_AlphaMap
If you have AlphaMap installed, and want to convert the in-built Instance and World Boss notes in to MapNotes notes, then use the above command, and you will see a message in the chat window informing you of how many notes have been imported in to MapNotes.
This does NOT import Battleground notes by default, as AlphaMap's in built Battleground functionality works best without MapNotes overlaying the BG Objectives.
NOTE: You don't have to import notes from AlphaMap, to make MapNotes on AlphaMap Instance/Battleground/WorldBoss maps. You can create any notes you like manually.
/MapNotes_Import_AlphaMapBG
As mentioned above, the basic "/MapNotes_Import_AlphaMap" command does not import Battleground notes by default. If you do want to import AlphaMap Battlegournd map notes, then use this command to do so.
/MapNotes_Import_CTMapMod
If you want to move from using CTMapMod to MapNotes (Fan's Update), then log in to the game with both AddOns enabled, use the above command, after which you will receive notification in the chat window on how many notes have been imported; Then log out, and disable CTMapMod.
[Key Bindings]
==============
QuickNote/TargetNote
--------------------
Creates a quicknote at the Player's current location if the Player has no target.
If the Player does have a target, then it will create a note for that target at the Player's current location.
-OR CLICK MINIMAP COORDINATES-
If you are NOT targetting anything, then ALT-Left-Click on the Minimap Coordinates to create a QuickNote.
If you are targetting something, then ALT-Left-Click to create a Target note with details about the current target at the PLAYER'S current location - you will be warned if you are too near to an existing note to create a new note.
(Slash Command "/mn -t" also available)
TargetNote/MergeNote
--------------------
Creates a note for the Player's target at the Player's current location.
OR Merges the details for the Player's current target in to a Map Note that has already been created at the Player's current location.
MUST have targetted a Player/NPC/Mob for this to work.
-OR CLICK MINIMAP COORDINATES-
If you are targetting something, then you may also ALT-Right-Click on the Minimap Coordinates if you wish to create a note for your Target at the PLAYER'S current location. However, if a MapNote already exists at Player's location, then the details will be merged with the existing note.
(Slash Command "/mn -m" also available)
- <Control>+<Alt>+Right-click on a MAP/FRAME to create a Quicknote at that point
- <Control>+<Alt>+Right-click on a NOTE to quickly go to the note Editing Frame
- <Control>+<Alt>+Left-clicking to drag NOTES to new positions
- <Alt>+Right-click on a NOTE to toggle it as a Minimap note
- <Alt>+<Shift>+DOUBLE Right-click on a note to quickly delete it.
- <Control>+<Shift>+Right-click will create a temporary blue Group note on a map
If created on a World map, then it will also be displayed in the Minimap for you to track
If in a Raid group, then the note will be shared with other Raid members who have MapNotes installed
Otherwise, if in a Party, then the note will be shared with the Party members who have MapNotes installed
Otherwise, its just your own quick temporary marker
Change Log - MapNotes
=======================================
Changes in v5.16.30200 from v5.16.30100
=======================================
=======================================
Changes in v3.40.20003 from v3.36.20003
=======================================
- Enhanced the Plugin functionality to allow other AddOns to create and edit WorldMap notes in their own frames.
e.g. AlphaMap (Fan's Update) v3.90.20003 and later can now make/edit WorldMap notes within AlphaMap without opening the Blizzard map.
Via new Plugin option "wmflag"
Other AddOn frames displaying world map icons will also show Party/tloc notes, and Highlighted notes.
- Added Slider controls to the Options Frame to control :
1.) Frame Size
2.) MapNote Icon Size
3.) MapNote Icon Alpha Setting
- fix to a couple of non-critical errors reported in FrameXML.log
=======================================
Changes in v3.35.20003 from v3.30.20003
=======================================
- QuickNotes will now note your current location as detailed in the Minimap Text, possibly with more general zone location information in the second line of the note, and the default QuickNote text in the second or third lines of the note. I just felt this was more useful, as often when making quicknotes, I just wanted to note my current location's name.
You can still pass [icon] [name] parameters.
- Enhanced the Note Highlighting functionality.
If you have lots of notes, it can be quite useful to highlight the one you are looking for rather than inspecting the tooltip for each one in turn. This was the reason for originally introducing the "/mn -hl <Note Name>" command.
When you specify the exact name of a note, then the MapNote will be highlighted with a green circle on the Map, and will be displayed as a MiniNote you can track in the Minimap. MapNotes would highlight ALL notes with that name if more than one exists.
I have made this command more useful by allowing the user to enter part of a Notes name and not making it case sensitive, as often you won't be certain how the full name of the note is spelled, or whether it had capital letters, etc.
So for example if you have lots of notes in Shattrath city, and can't remember which one was the "Spymistress Mehlisah Highcrown", then you can type "/mn -hl spy", and that note will be highlighted on the map. More than one note might be highlighted if more than one note has the text "spy" in it.
You will still need to specify the exactly identical note name to make the highlighted note appear as a MiniNote automatically - although this is no longer case-sensitive either.
To remove Highlighting, just type "/mn -hl".
This functionality will highlight notes in any zone you look at on the Map.
- Fixed a problem with Alt-Clicking on the Minimap Coordinates to create Target/Merge Notes, which sometimes required double clicking
- Now Hides the World Map area Label information while the <Control> Key is depressed to hide clutter
- Now Hides the World Map area Label information when the MapNotes Quick Options Drop Down Menu is open
- MapNotes Quick Options Drop Down Menu will now close when the Map closes
- Added support that Cartographer users who want to use MapNotes (Fan's Update) requested.
<Control>-Right Click will now show the MapNotes note menu rather than the Cartographer note menu
v3.30.20003.low is a low Compression Ratio version of the zip file for v3.30.20003, and is provided purely for people who have Oversized.zip errors when trying to download other versions of MapNotes (Fan's Update)
The actual contents of the zip file are exactly the same as the normal v3.30.20003 download
Originally posted by Bender72 Oversized.Zip is not a Virus: Original File size is not this file size.
Original Message HAVP: (IPCop)
HAVP - Zugriff verweigert
Der Zugriff auf die Seite wurde
verweigert, weil folgender Virus gefunden wurde
Oversized.Zip
Yup, there is no virus in this file.
I use 7-zip to zip my AddOns and also to improve the compression ratio and make them as small as possible.
Although I'm not entirely certain whether this web site is one that unpacks submitted zips, and re-zips them itself or not...
Obviously your mail/web server has detected that the compression ratio is higher than it allows and has rejected it. Software called ClamAV seems particularly susceptible to this problem. (This check was originally introduced to filter "zip of death" files that have absurdly high compression ratios and unpack to truly HUGE files)
If you are downloading through a private/university network, you should raise this issue with the Administrator of that network.
Anyway, I'm submitting a 'low' compression ratio version to the Curse gaming web site :
I use 7-zip to zip my AddOns and also to improve the compression ratio and make them as small as possible.
Although I'm not entirely certain whether this web site is one that unpacks submitted zips, and re-zips them itself or not...
Obviously your mail/web server has detected that the compression ratio is higher than it allows and has rejected it. Software called ClamAV seems particularly susceptible to this problem. (This check was originally introduced to filter "zip of death" files that have absurdly high compression ratios and unpack to truly HUGE files)
If you are downloading through a private/university network, you should raise this issue with the Administrator of that network.
Anyway, I'm submitting a 'low' compression ratio version to the Curse gaming web site :
=======================================
Changes in v3.30.20003 from v3.27.20003
=======================================
- improved the MiniMap Tooltip to show all the same information as the WorldMap Tooltip
- now while holding down the Control key to create a Note, or the Shift key to create a Party Note on the World Map, the World Map Magnifying button will be hidden allowing notes to be made on that part of the map if needed
- Made sure WorldMapToolip will appear above other WorldMap components
- can now use x,y coordinate separators other than the commas, and/or spaces
(Its still possible to input bad coordinates, but much harder, and if bad coordinates are passed, the player will receive a warning message in the chat frame, rather than an error message box)
- can now use the decimal point as a separator between the x and y coordinates
NOTE: if using the decimal point as a separator between the x and y coordinates, then it is advisable to NOT use x and y coordinates that also contain decimal points - if you must use decimal points in the coordinates AND as a separator, then you should use a decimal point in BOTH the x and y coordinates
For Example :
/mn -tloc 10.50.90.0 will be correctly located at 10.5, 90.0
BUT if passed
/mn -tloc 10.50.90 then there's no way for MapNotes to know if you mean 10.5, 90 or 10, 50.9
I now have a headache, so please leave me alone ;p
Aaahh, k, I finally see what you mean about the note positions being sent - it was only meant to affect notes at the 5th decimal place, but it does potentially change much more significant digits
=======================================
Changes in v3.25.20003 from v3.24.20000
=======================================
- hopefully fixed problems with the /mn -qtloc xx,yy [icon] [text] slash command when passing extra Icon/Text information
- change to make sure that the Map Zone is the current one by default when logging in or using ReloadUI(), or when first showing the Minimap coordinates
=======================================
Changes in v3.24.20003 from v3.23.20000
=======================================
- hopefully fixed the Send Note problem introduced in v3.22.20003
- fixed a problem sending the '|' character in merged notes
=======================================
Changes in v3.23.20003 from v3.22.20003
=======================================
- new Slash Command '/mn -scale [0.5 - 1.5]'
The size of MapNotes Menus and Frames are now fixed no matter what the scale of the World Map or other AddOn Map being used.
This command can be used to change the default size of MapNotes Menus and Frames if the user finds it too small or too large.
The default value is 0.7
Therefore '/mn -scale 1.0' will make the Menus and Frames appear larger than they do by default.
Obviously MapNotes will remember this setting between sessions.
You have just downloaded by the author . If you like this AddOn why not consider supporting the author? This author has set up a donation account. Donations ensure that authors can continue to develop useful tools for everyone.
*Clicking the donate button above will take you to PayPal.com
*Clicking the donate button above will take you to Pledgie.com
