Explanation of API, MUI, and GetHandleId

[ALTELMA]

- What's API and Example it?
- Sometimes why call some spell is MUI?
- What's GetHandle and show an example plz.

Thanks all guys for answer.

 

[watermelon_1234]

1. In the most basic sense, an API is what the user is allowed to use from a programming language or system. For instance, the Jass API provides for GetTriggerUnit which allows you to get the triggering unit from an event. You can look at this to get a better definition and this to look at the API for Jass.
2. A spell is called MUI (Multi-Unit Instanceability) if multiple units can cast the spell simultaneously without any conflicts. This applies even if the multiple units are owned by the same player.
   MPI is similar to MUI but only one unit from each player can cast the spell without conflicts.
3. I'm assuming you mean GetHandleId.
   It basically returns the unique integer id for a handle.
   Example: two units that are basically clones of each other (same unit type id, same mana, same life, etc.) would have different handle ids.
   
   Example usage:

   local integer id = GetHandleId(YourUnit) // Gets the handle id of YourUnit

   
   Even though my examples are only using units, you should know that the function can be used for any type that extends handle, like items and timers.

 

[ALTELMA]

Thanks for your help. And please help me on it. From what you've said, I feel that many do not know what's about jass.

- Can you explain me about do MUI Spell? Plz!!
- And Handle Value can use for what?
- Declaration globals variable is neccessary?
ex.

globals
unit u = GetTriggerUnit()
integer i = 2
endglobals

 

[WaterKnight]

For a spell to be MUI, it has to store its data in different memory spaces.

Simple example: Everytime the spell is being cast, the caster shall be attached its current intelligence amount. This means that each caster needs its own designated variable. GetHandleId provides a different integer value for each unit, a unique marker. You can use this marker/index in a hashtable

SaveInteger(<table>, GetHandleId(<caster>), <key>, <intelligence>)

so the hashtable field is dependent on the caster, like we wanted it.

MPI is not necessarily easier but there was no hashtable in GUI before, nor the GetHandleId. That is why some mapmakers stored the data that should actually belong to the unit to the owner of the unit instead and used that player's player number as an index for arrays.

Do not grasp what your third point is about. There is no GetTriggerUnit() when variables are being declared. GetTriggerUnit() is an event response for unitevents, playerunitevents and some more. Global variables do not have to be initialized in declaration but they should have some value before you try to read something out of them.

 

[ALTELMA]

summary Handle and Hashtable is useful for make MUI spell? It'sright. Can you exmaple some MUI Spell for me plz. About Globals Declaration I wonder It's different from normal varibles creates on Crtl+B

 

[mckill2009]

there are so many MUI spells in the spells section, pick one...be careful in using handle
ID's using hashtable coz it may overwrite the existing value...

if you call this again, it will reset the integer to 100...
call SaveInteger(Hash, GetHandleId(<caster>), 1, 100)