Emergency v. 2.2
(wow interface 20000)
About
Have you ever been distracted by your family while in a raid, then look back only to notice you've got Burning adrenaline and you are 2 seconds from wiping the whole raid? Have you been known to pull aggro off the tanks but not noticed until it's too late? Are you a tank who loses aggro? Do you not keep a close eye on your hearth or mana bar? If the answer to any of these is "yes" you surely need this addon. If the answer is no, you'll probly want it anyway.
What Emergency does is it gives you a list of things you'd like to be notified about, and flashes the screen in the color and type of flash that you choose for that important event. The above is just an example of some of the things it can notify you of. The list includes (all of which are optional) Low health, Low Mana, Losing aggro, Gaining aggro, You are burning (Burning adrenaline for Vael fight in BWL), Tranquilizing Shot for hunters on tranq duty, and pet has low health. You can enable or disable any of these, set the flash type (smooth, quick, flash, double), choose a custom color, and even a class-based defaults reset button to restore the original color, flash type and on/off state of all the events.
This mod employs dynamic event registration so it only watches events that you have enabled. This improves speed and reduces processing time for your UI. It also uses a robust queueing system with true animation.
Things for the future
I'll be adding in any user submitted event warnings and flash types. I'm open to suggestions so keep them coming. Thanks!
Flash Types
If you'd like to add a flash type, you'll need to know what I'm expecting. The various flashes are all based off of graphs (math equations.) Yep, this is where geometry and trigonometry come into your gaming life. The flash sees the line of a graph which exists in 0-1x and 0-1y. Y is the intensity of the flash and X is time passed. There are some are real simple ones like (y = -4 * x + 2 ) but some are more complicated like ( y = ( 0.5 * sin( 4 * pi * x - pi/2 ) ) + 0.5 ). If you are still interested in making one, please post it on the Orgrimmar.org forum or send it to me directly via email or PM.
Enabling your addon to generate Emergency flashes
Emergency has been written to be very friendly to queueing flashes. It's easy to add the flashing functionality into your addon too. There are 2 ways to Queue a flash for immediate display. One excepts a single object/table for more complex uses, while the other accepts simple strings. The 2 functions are Emergency_QueueFlash() and Emergency_QueueFlashFromString(). Accessing it via the string method is more forgiving and allows for most of the variables to be optional, making it probly the preferred way unless you are sure you want the EventObject way.
The functions intake 4 elements.
color -- Required: this is a small table with the red green and blue colors of the flash.
text -- Optional: The text you want to display in the middle of the screen.
type -- Optional: An integer indicating which flash you want. There are 1-5 as of this writing.
increment -- Optional: a number indicating how often in seconds the flash should update. Standard is 0.05, and unless you really want to change it, don't bother sending this value.
Here's some examples:
Emergency_QueueFlashFromString({r=0.5,g=1,b=1},"OMG A FLASH",2); -- This flash has almost everything specified, including a double flash and some text to display
Emergency_QueueFlashFromString({r=0.5,g=1,b=1}) -- This flash has a color but no text and the default flash type
Emergency_QueueFlash(EventObject) -- An event object consists of basically all the above elements, but they are sent as keys with values == whatever you want them to be. This function is more strict than the FromString function. All but the the increment are required.
When adding this function to your addon, please include it inside an "if" statement which checks to see if Emergency is actually loaded, unless it's a required dependancy in your TOC file. This will help prevent errors in case a user has disabled Emergency. Thanks
/command Options:
Command Aliases: /Emergency, /eme any of these can be used with the commands below |
|---|
| /eme | Shows the options window. |
| /eme (on | off) | Turns the display of addon on and off. |
Changes
- 2.2
- Added a new Entering Combat flash option. Off by default for all classes.
- Added the name of who you gained or lost aggro from to the warning text that shows on your screen when said flash happens.
- Fixed a bug introduced with teh last version where the Sound Drop-down would be blank/empty if you'd never choosen a sound.
- Fixed an OnLoad bug that would cause an error on new characters.
- Updated the Gained Aggro and Lost Aggro flashes to truely work as intended.
- 2.1
- Added sound effects! yippie! (optional obviously)
- Added SoundPack support for the new sounds system. More info on this later.
- Fixed (hopefuly) the warlock "gained soul shard" flash so it will only flash when you get a soul shard, not everyone.
- Updated the inner-workings so updates to internal things don't affect your saved settings.
- Wrote an auto-setting-upgrader to the new version to convert your old settings to the new leaner method.
- 2.01
- Fix a typo in the French localization that would cause an error upon loading into the game.
- 2.0
- Added support for the Burning Crusade Expansion.
- Updated all table refrences to Lua 5.1.1 standard.
- 1.6
- Added Sunder Flash with an option to flash at the user setable sunder-count.
- Added Tabs to the bottom of the Options Window
- Rebuilt the Options Window to be prettier, more organized, and ultimately support more flashes.
- 1.5
- Added 2 new flashes for warlocks. Nightfall's Shadow Trance and Flash when you get a Soul Shard.
- Emergency will now flash your screen even if you have the UI not showing. No text will display, but the flash will.
- Fixed the French localization for Priests and Warlocks (was an ASCII to Unicode problem)
- 1.4
- Added German Localization. Yay for Germany.
- Minor bug fixes.
- 1.3
- Added Clearcasting Flash
- Added Raid Warning Flash
- Added Ready Check Flash
- Adjusted the Lost Aggro flash so it won't go off when your target dies (because that's obviously how it should be)
- Fixed a localization bug experienced by non-english clients
- Improved the efficency of the more complex flashes
- 1.2
- Added and improved documentation on how to add Emergency's flashes into other addons.
- Added French localization. Yay for France.
- Adjusted the options window's options to compinsate for the longer localization strings.
- Updated the UI Version to work with 1.12
- 1.1
- Added 8 new raid / boss related event flashes
- Added a flash for when you get 5 combo points on a mob
- Added helpful comments, new files and some extra robustness for when new Flashes are added.
- 1.0
2587 hits for this version. 3567 hits for all versions.