Global Functions
Global functions are functions that are globally available to be called by any script.
This is a list of all of the global functions provided by the KAG application (that is, not defined in a script).
| Function | Description |
|---|---|
| AddIconMarker |
This defines a token (e.g. $EmptyShop$) for icon replacement in menus and suchlike. |
| AddColorMarker |
This defines a token (e.g. $RED$) for colouring text in menus and suchlike. |
| CreateGridMenu |
Creates a CGridMenu with the given position on-screen, a reference to the owner blob, the grid dimensions and a caption. Returns a reference to the created CGridMenu. |
| MakeCoin |
Creates a coin with a given position on-screen, velocity and a style. |
| makeAnimatedParticle |
Creates a particle with a number of different options. |
| banPlayer |
Bans the given player (by name or CPlayer reference) for the given length of time, in minutes. Can optionally provide a reason too. |
| getPlayerByUsername |
Returns a reference to the CPlayer that has the given username, if one currently exists, otherwise it returns null. |
| Play |
Plays the a sound file at the given position (position used to determine if it can be heard). |
| Blobs | |
| CreateBlob |
Creates a CBlob with the given factory and the given path to a config file defining the CBlob. Returns a reference to the created CBlob. |
| getBlob |
Returns a reference to the CBlob with the given index in the list of blobs that currently exist. |
| getPlayingBlob |
Returns a reference to the CBlob with the given index in the list of blobs that are currently active - i.e. not settled map blocks or in inventories. |
| getBlobByNetworkId |
Returns a reference to the CBlob with the given Network ID. |
| getBlobByName |
Returns a reference to the first CBlob with the given name. Probably not very useful. |
| populateBlobsByNameList |
Populates the 'Blobs By Name List' with all of the CBlobs that currently exist with the given name. |
| getBlobsByNameListBlob |
Returns a reference to a CBlob from the 'Blobs By Name List' with the given index in the list. |
| getBlobsByNameListSize |
Returns the number of CBlobs in the 'Blobs By Name List'. |
| getPlayingBlobsSize |
Returns the number of CBlobs that are currently active and in play - i.e. not settled map blocks or in inventories. |
| getBlobSize |
Returns the number of CBlobs that currently exist. |
| getBlobCacheIndex | GetBlobCacheIndex |
| Inventory | |
| AddRequirement |
Pushes the given requirements to a CBitStream, to be read by other requirement methods. |
| ReadRequirement |
Reads requirements from the given CBitStream into variables you provide. |
| hasRequirements |
Checks 1 or 2 inventories to see if they have the given requirements, and writes any missing requirements into a given CBitStream. Returns true if the requirements are met, otherwise false. |
| TakeRequirementsCombined |
Removes the requirements in the given CBitStream from one of the CInventorys passed to it. |
| GUI | |
| LoadSkin |
Loads a skin config file. See GUI/guiSkin.cfg for example file. |
| DrawPane |
Draws a pane with a shape specified by the given rect. |
| DrawSunkenPane |
Draws a sunken pane with a shape specified by the given rect. |
| DrawWindow |
Draws a window with a shape specified by the given rect. |
| DrawFramedPane |
Draws a framed pane with a shape specified by the given rect. |
| DrawButton |
Draws a button with a shape specified by the given rect. |
| DrawButtonPressed |
Draws a pressed button with a shape specified by the given rect. |
| DrawButtonHover |
Draws a hover-highlighted button with a shape specified by the given rect. |
| DrawRectangle |
Draws a rectangle with a shape specified by the given rect. |
| DrawProgressBar |
Draws a progress bar with a shape specified by the given rect and a given % fill. |
| DrawIconByName |
Draws an icon added by AddIconToken using its token name. |
| DrawIcon |
Draws an icon from the given file. |
| DrawText |
Draws some text. |
| Maths | |
| Cos |
Returns the cosine of the given angle in radians. |
| FastCos |
Returns the cosine of the given angle in radians. Faster, less reliable version. |
| ACos |
Returns the arc cosine of the given angle in radians. |
| Sin |
Returns the sine of the given angle in radians. |
| FastSin |
Returns the sine of the given angle in radians. Faster, less reliable version. |
| ASin |
Returns the arc sine of the given angle in radians. |
| Tan |
Returns the tangent of the given angle in radians. |
| ATan |
Returns the arc tangent of the given angle in radians. |
| Pow |
Returns base raised to the power exponent. |
| Sqrt |
Returns the square root of x. |
| InvSqrt |
Returns the inverse square root of x. |
| isValid |
Returns true if the given float is a valid number (not NaN or infinity) or not. |
| Floor |
Returns the largest integral value that is not greater than the given number. |
| Ceil |
Returns the smallest integral value that is not less than the given number. |
| Equals |
Returns true if the two given floats are equal, otherwise false. |
| Min |
Returns the smaller of the two given numbers. |
| Max |
Returns the larger of the two given numbers. |
| Abs |
Returns the absolute value of the given number. |
| FMod |
Returns the floating-point remainder of the given numerator divided by the given denominator. |
| Round |
Rounds the given float to the nearest whole number, as an int. |
| Roundf |
Rounds the given float to the nearest whole number, as a float. |
| Random |
Returns a pseudo-random int in the range 0 to the given max int. |
| FastRandom |
Returns a seemingly-random (much less random than Random, though it is faster) int in the range 0 to the given max int. |
| Strings | |
| formatInt |
Returns a formatted string representation of the given int. |
| formatFloat |
Returns a formatted string representation of the given float. |
| parseInt |
Returns an int from the given string representation of an int. |
| parseFloat |
Returns a double from the given string representation of an float. |
| Printing | |
|
Prints the given text - to the console, if its available. | |
| printInt |
Prints the given integer with the given prefix text - to the console, if its available. |
| printFloat |
Prints the given float with the given prefix text - to the console, if its available. |
| printString |
Prints the given string with the given prefix text - to the console, if its available. |
| printVec2f |
Prints the given Vec2f with the given prefix text - to the console, if its available. |
| printBool |
Prints the given bool with the given prefix text - to the console, if its available. |
| printPos |
Prints the given position2d with the given prefix text - to the console, if its available. |
| error |
Prints an error with the given text - to the console, if its available. |
| warning |
Prints a warning with the given text - to the console, if its available. |
| World | |
| getMap |
Returns a reference to the CMap object. |
| getRules |
Returns a reference to the CRules object. |
| getRespawn |
Returns a reference to the CRespawn object. |
| getHUD |
Returns a reference to the CHUD object. |
| getNet |
Returns a reference to the CNet object. |
| getSecurity |
Returns a reference to the CSecurity object. |
| getCamera |
Returns a reference to the CCamera object. |
| getControls |
Returns a reference to the CControls object. |
| getDriver |
Returns a reference to the Driver object. |
| LoadRules |
Loads the given rules config file. |
| LoadMap |
Loads the given map file. |
| LoadNextMap |
Loads the next map in the map cycle. |
| LoadMapCycle |
Loads the given map cycle file. |
| LoadSeclevs |
Loads the given seclev config file. |
| getGameTime |
Returns the game time (number of ticks) as an integer (s32). |
| FontHeight |
Returns the font height as an integer (s32). |
| ScreenHeight |
Returns the screen height as an integer (s32). |
| ScreenWidth |
Returns the screen width as an integer (s32). |
| IsPlayerListShowing |
Returns true if the player list/scoreboard is showing, otherwise false. |
| drawRulesFont |
Draws the given text with the given colour, position and alignment. |
| setHelpText |
Sets the help text to the given string (I think its the text that shows above your head - like 'press E to buy bomb' or whatever) |
| getTicksASecond |
Returns the number of ticks per second. |
