vanilla-wow-addons – Blame information for rev 1

Subversion Repositories:
Rev:
Rev Author Line No. Line
1 office 1 TrinketMenu 2.7
2  
3 This is a mod to make swapping trinkets easier. It will display your two equipped trinkets in a bar. Mouseover on either trinket will display a menu of up to 30 trinkets in your bags to swap.
4  
5 __ New in 2.7 __
6 - "/trinket debug" to help isolate reports of menu problems
7 - optimized zoning (events disabled while zoning)
8  
9 __ Swapping/Using trinkets __
10  
11 Left click a trinket in the menu to equip it to the top trinket slot.
12 Right click a trinket in the menu to equip it to the bottom trinket slot.
13  
14 Left or Right click either trinket to use them. Or make a key binding for either trinket.
15  
16 __ Customizing display __
17  
18 The main and menu windows are independently scalable and rotatable. While the windows are unlocked:
19 - Move either window by dragging its edge.
20 - Rotate either window by right-clicking its edge.
21 - Scale/resize either window by dragging the lower-right corner to the desired size.
22  
23 If you're having problems grabbing the edge of the menu window to move/rotate/resize it, hold Shift down while it's open and the menu won't go away when the mouse leaves the menu's edge.
24  
25 If you right-click the gear icon around the minimap (or /trinket options) a small options window will appear under the minimap. Here you can customize the display further by showing cooldowns as numbers and keeping the menu always open.
26  
27 Once you're settled on a setup you like, you can lock the windows in options.
28  
29 To set an exact scale (optional):
30 /trinket scale main n : Scale the main window to n
31 /trinket scale menu n : Scale the menu window to n
32 ie: /trinket scale menu 0.85
33  
34 __ Docking __
35  
36 While 'Keep Menu Docked' is checked (default), the menu will always be docked to one corner of the main window. To change the corner where it's docked, drag the menu window so that a corner of the main and menu windows meet. White brackets will appear at the corners that will dock as you drag.
37  
38 If you uncheck 'Keep Menu Docked', remember the menu goes away when the mouse leaves your trinkets. Feel free to experiment if you'd like. Remember that /trinket reset will restore positions/docking, or you can hold Shift down to keep the menu open. Or you can turn on 'Keep Menu Open' in options.
39  
40 __ Queued Trinkets __
41  
42 We can't swap trinkets during combat or when we're dead. If you attempt to swap trinkets during combat or while dead it will put the trinket on hold and automatically swap them once you leave combat:
43  
44 - The queued trinket will appear as a small icon inset into the slot it's heading to.
45 - If you want to unqueue the trinket, reselect it again for that slot (left or right click).
46 - If you want to queue the trinket to the other slot, reselect it again for the other slot (left or right click).
47 - The "queue" is only one-trinket deep right now. Meaning, once a queued trinket is equipped that queue is emptied.
48 - Selecting a series of trinkets for a slot will only change the queued trinket, it won't set up an order to them yet.
49  
50 __ Misc __
51  
52 - Left-click the minimap icon to toggle the trinket windows. Right-click to toggle options.
53 - You can drag the minimap icon around the minimap directly.
54 - You can Shift+click the trinkets to link them to chats just as you would from your bags or inventory.
55 - If you log in to a character with no trinkets in bags or on their person, the trinket window will not be displayed.
56 - You can hold Shift while swapping trinkets or manipulating the windows to prevent the menu from disappearing.
57 - You can set up key bindings to use whatever trinket is in the top or bottom slot.
58 - If you have Scrolling Combat Text installed, and 'Notify When Ready' checked, it will send a message via SCT when a trinket is ready.
59  
60 __ Optional Slash Commands __
61  
62 /trinket or /trinketmenu : toggle the window
63 /trinket reset : reset window
64 /trinket opt : summons options window
65 /trinket lock|unlock : toggles window lock
66 /trinket scale main|menu n : scales windows to exact scale
67 /trinket help : lists the above commands
68  
69 __ Users of CooldownCount __
70  
71 I wasn't aware that CooldownCount even supported TrinketMenu until recently. Thanks Sarf that was a pleasant surprise. While this version of TrinketMenu has numerical counters built in, users of CooldownCount would probably want it to look and act the same as the rest of their cooldowns. So I've thrown together a new TrinketMenu CooldownCount as a separate download. Those who don't use CooldownCount but want to try it, you'll need the core CooldownCount mod by Sarf here: http://www.wowwiki.com/CooldownCount
72  
73 The numbers are bigger and more customizable so it's a great option if you don't like the basic cooldown numbers in this mod.
74  
75 You will need to use the new CooldownCountTrinketMenu with TrinketMenu 2.0+. Unfortunately the old one will not work. However it won't create any conflicts or errors if you do have the old one running.
76  
77 __ FAQ __
78  
79 Q: Can you add items other than trinkets to the menu?
80 A: See ItemRack, which is the big brother to this mod. It handles all inventory slots as well as item sets and stuff.
81  
82 Q: What does ItemRack mean for TrinketMenu's future?
83 A: TrinketMenu will stay focused on trinkets. For the foreseeable future it will be maintained alongside ItemRack since many are looking for just a trinket manager without the extras. While some new stuff may be added from time to time, any larger changes would probably happen in ItemRack. TrinketMenu will be kept small and focused.
84  
85 Q: Localization?
86 A: This mod should work on all clients. I can't test this for myself but many report it works fine.
87  
88 Q: I changed my notify settings on my warrior, but the change shows on my other characters also.
89 A: Everything in the options window saves for all characters. Just position, orientation, docking and scaling are saved per-character.
90  
91 Q: I'd like to go back to using global position/orientation/docking for all my characters. Can I do this?
92 A: Sure. Edit TrinketMenu.lua and change these two lines to the one that follows:
93  
94 Change:
95 ## SavedVariables: TrinketMenuOptions
96 ## SavedVariablesPerCharacter: TrinketMenuPerOptions
97  
98 To:
99 ## SavedVariables: TrinketMenuOptions, TrinketMenuPerOptions
100  
101 To change all settings (notify, tooltips, etc), change the previous two lines to:
102 ## SavedVariablesPerCharacter: TrinketMenuOptions, TrinketMenuPerOptions
103  
104 Q: How do I move the minimap icon?
105 A: Drag it like a normal window. Left click and drag it around and it will slide around the edge.
106  
107 Q: I'm trying to swap trinkets, but instead of swapping it put a tiny trinket icon over my equipped one.
108 A: This means you're in combat mode. You won't be able to swap trinkets until you leave combat. The tiny trinket is the one that will swap in once you leave combat.
109  
110 Q: What if I don't have Scrolling Combat Text, will it still notify me when trinket cooldowns expire?
111 A: If you don't have SCT, it will notify in the "errors" overhead, where you get "Insufficient mana", "Out of range", etc type errors.
112  
113 Q: I don't have many trinkets and because of this I'm having problems docking to some corners. Any way to make it easier?
114 A: Temporarily resize (drag lower-right corner) either window to make the differences greater so it's easier to dock to an exact corner.
115  
116 Q: My menu is docked to the left of my main window, when I resize it by dragging the lower right corner, it's not behaving as I expect.
117 A: You likely expect the topleft corner of the menu to remain and the bottomright corner to follow the pointer as you drag. If it worked this way, the window would then "snap" to dock position after you're done resizing, and it'd be difficult to know exactly how it'd look while resizing. A better solution would've been to make all corners resizable, but it was kept in this awkward state for simplicity's sake. If there's demand for it, I can make all corners resizable.
118  
119 Q: Any plans for a trinket queue system? So that you can set up an order of trinkets to equip and it will automatically swap new ones in when you leave combat with equipped trinkets on a cooldown?
120 A: If one happens it will probably be in ItemRack before TrinketMenu. This mod will remain small and to the point. I don't plan to introduce automatic queues to TrinketMenu.
121  
122 Q: I was looking at the XML and there are 7 OnUpdates! Isn't that going to kill performance?
123 A: Actually, they're done that way to improve performance and lower overhead. Two examples:
124  
125 1. Over 200 BAG_UPDATE events can happen when you log in or zone into an instance. Instead of reacting to all of them or checking every so often, when the first BAG_UPDATE occurs, the inventory OnUpdate starts and waits until the game is done sending BAG_UPDATES. Once a period has gone by without new BAG_UPDATEs, it processes the changes needed and then quietly shuts down the inventory OnUpdate.
126  
127 2. For visual feedback while docking (the corners that will dock light up), it needs to continually monitor the window positions relative to each other. Since docking is only done a handful of times for the lifetime of this mod's use, the OnUpdate that monitors those positions will only be active when you're docking.
128  
129 The only OnUpdate that runs continuously is the cooldown counters if "Cooldown Numbers" or "Notify When Ready" is on, and the menu frame if "Keep Menu Open" is checked. If neither are checked, no OnUpdates happen unless you start manipulating the mod.
130  
131 You'll find that this mod's processing time and memory churn is far less than your usual "action bar" type addon.
132  
133 Q: It's not showing all my trinkets, I have over 30 of them in my bags.
134 A: This version can handle only up to 32 trinkets. Two equipped and 30 in bags. If you exceed this amount, post how many trinkets you have and I'll up the limit. 30 seemed a reasonable number, but as the screenshots show it's not very difficult to get 30 trinkets if you're an engineer. In the meantime the mod will lift trinkets from right bag to left if you want to control which 30 are displayed.
135  
136 Q: I can't rotate, resize, move or do anything with the windows.
137 A: That sounds like the windows are locked. Enter: /trinket unlock
138  
139 __ Changes __
140 2.7 3/30/05 - added: /trinket debug, changed: update events disabled while zoning
141 2.6 2/8/05 - bug fixed: minimap button movement, added: option to drag around square minimap, option to show menu on shift only
142 2.5 1/4/05 - added: notify at 30 sec option, changes: 1.9 scaling, uses GetItemInfo, removed: scalebugfix, cooldowns off screen check
143 2.4 10/21/05 - added: /trinket scale slash command, sound on notify, changed: per-character position/orientation/docking, UseInventoryItem 13 and 14 hooked to reflect use, bug fixed: added scale bug fix back in
144 2.3 10/2/05 - added: option to disable tooltip, changed: options movable window that defaults to center, bug fixed: logging in character without trinkets won't prevent it from showing next login, for 1.8: pre-emptive fix for 1.8 SetPoint layout-cache bit, scale bug fix no longer performed
145 2.23 9/3/05 - bug fixed: hunter fd won't queue a trinket that can ordinarily swap, if the mod is hidden on logout it will be hidden on login
146 2.22 9/2/05 - bug fixed: if res'ed before releasing your spirit with trinkets in queue, they'll swap on revive normally
147 2.21 8/21/05 - bug fixed: window scaling bug definitively fixed, and error when clicking an empty trinket slot
148 2.2 8/20/05 - added: swap attempts while dead will queue trinkets to swap on revive, options to disable toggle, notify used only, and notify chats also, bugs fixed: error for more than 30 trinkets, notify corrected, hopeful fix for location bug some have: forced start/stopmove to save to layout-cache.txt, move the window to saved point going in/out of windowed mode
149 2.11 8/17/05 - changed: swap attempts won't happen if anything on cursor, bug fixed: options window will appear on screen irregardless where minimap is, added: /trinket debug to help find location bug issue some see
150 2.1 8/17/05 - added: a resize grip to lower right corner, trinket queue, option to dock/undock, notification when trinket cooldown ends (via SCT or overhead), bugs fixed: cooldown update made less frequent,
151 2.0 8/14/05 - rewritten from scratch, added up to 30+2 trinkets, menu grows outward, cooldown numbers, keep menu open option, minimap icon and scaling, far better handling of bag/inventory updates, cooldown models won't update if they're off the screen
152 1.1 7/20/05 - only react to BAG_UPDATE every second (by Thelgar), made lock/unlock more visually apparent and moved menu closer to main window
153 1.0 4/8/05 - initial release