Mindcode comes equipped with a system library. At this moment, the library is just a single source file, sys.mnd, which is automatically compiled together with each source file, both in the command line compiler and in the web app. The library is only included if the language target is 8A or higher, as it contains functions that build upon some of the instructions that will be added in the upcoming Mindustry 8 version.
To use the functions and constants provided by the system library in your program, you need to compile for Mindustry Logic 8 y including #set target = ML8A in your program.
The system library is an experimental feature. The functions provided by the library and the mechanism for its inclusion in your program may change in future releases.
Individual functions in the library are documented here.
The provided library functions use transformations to rotate, invert or scale graphics output as needed for each display (large or small). Transformations are additive, so it is suggested to call reset() at the beginning of each program that uses transformations to clean up possible transformations from earlier runs.
The parameters used for transformations must be adapted to the size of the output display being drawn. The transformation functions therefore exist in versions for both logic displays and large logic displays, plus a version which automatically detects the display type from a block passed in as a parameter.
Constants are defined for the small and large display sizes:
const DISPLAY_SIZE_SMALL = 80;const DISPLAY_SIZE_LARGE = 176;
Definition: def displaySize(display)
Returns the actual display size based on the type of display passed in as an argument. When the passed-in argument is not a display, the processor is stopped.
The following functions use graphics transformation to rotate the graphics output in multiples of 90 degrees. Functions that take a display as a parameter choose the transformation parameters to match the display size. When the passed-in argument is not a display, the processor is stopped.
Definitions:
def rotateRightSmall()def rotateRightLarge()def rotateRight(display)
Rotates the output to the right (clockwise) by 90 degrees for a small or a large display, or for a display given as an argument.
Definitions:
def rotateLeftSmall()def rotateLeftLarge()def rotateLeft(display)
Rotates the output to the left (counterclockwise) by 90 degrees for a small or a large display, or for a display given as an argument.
Definitions:
def upsideDownSmall()def upsideDownLarge()def upsideDown(display)
Rotates the output by 180 degrees (upside down) for a small or a large display, or for a display given as an argument.
Definitions:
def flipVerticalSmall()def flipVerticalLarge()def flipVertical(display)
Flips the output vertically (along the Y axis) for a small or a large display, or for a display given as an argument.
Definitions:
def flipHorizontalSmall()def flipHorizontalLarge()def flipHorizontal(display)
Flips the output horizontally (along the X axis) for a small or a large display, or for a display given as an argument.
Definition: def scaleSmallToLarge()
Scales the graphics output so that an output that targets a small display gets displayed over the entire area of a large display.
Definition: def scaleLargeToSmall()
Scales the graphics output so that an output that targets a large display gets displayed over the entire area of a small display.
Definition: def findFreeUnit(unit_type, initial_flag)
Finds and binds a free unit of given type. When such a unit is found, it is flagged by the given initial flag. If no free unit of given type can be found (either because none exists, or because all existing units are occupied), returns immediately.
Inputs and outputs:
unit_type: type of the unit:@flare,@mono,@polyetc. Can be a variable.initial_flag: initial flag to set to he freshly bound unit.- returns the freshly bound unit, or null if no free unit of given type exists
The function doesn't use units that are controlled by a player or a different processor.
Definition: def findClosestUnit(x, y, unit_type, initial_flag)
Searches for and binds a free unit of given type closest to the coordinates on the map given. If no free unit of given type can be found (either because none exists, or because all existing units are occupied), returns immediately.
Inputs and outputs:
x,y: position of the map to compute unit distance relative tounit_type: type of the unit:@flare,@mono,@polyetc. Can be a variable.initial_flag: initial flag to set to he freshly bound unit.- returns the freshly bound unit closest to given coordinates, or null if no free unit of given type exists
The function doesn't use units that are controlled by a player or a different processor.
Definition: def waitForFreeUnit(unit_type, initial_flag)
Finds and binds a free unit of given type. When such a unit is found, it is flagged by the given initial flag. The function doesn't return until a free unit of the given type can be found,
Inputs and outputs:
unit_type: type of the unit:@flare,@mono,@polyetc. Can be a variable.initial_flag: initial flag to set to he freshly bound unit.- returns the freshly bound unit
The function doesn't use units that are controlled by a player or a different processor.
The status of the search is output to SYS_MESSAGE. Either set the message to an existing memory block to receive the updates, or set SYS_MESSAGE to null to disable status updates (const SYS_MESSAGE = null; is also supported).
Formats the number passed in as a parameter into the text buffer, using comma as thousands separator. Fractional part of the number to be printed is ignored.
To use the function, a placeholder must be inserted into the text buffer prior to the call of this function. The placeholder must be {2} or higher, placeholders {0} and {1} are reserved.
The number will be rendered at the place of the lowest formatting placeholder.
Tip
While the functions is optimized for performance, formatting numbers is many times slower than just printing them using the print() function.
Prints the number passed in as a parameter, using comma as thousands separator. Fractional parts of the number to be printed is ignored.
To use the function, the text buffer must not contain placeholders {0}, {1} or {2}. The number will be printed at the end of the print buffer.
Tip
While the functions is optimized for performance, formatting numbers is many times slower than just printing them using the print() function.
Computes the distance between points (x1, y1) and (x2, y2). Uses the len instruction for efficient hypotenuse calculation.
The sys.mnd is integrated into the compiler and as such is available to both the command-line compiler and the web application. The current version of the file can be found here.