No Revisions Have Been Made To This Page
Can you suggest an edit for this page? Click Here
A ds_grid is basically a type of two-dimensional
array. You define the grid by setting its integer width and
height, which then sets the total number of "cells" within the grid
(the width and height multiplied) and these cells are then used to
hold different data values (real numbers or strings).
This type of structure allows you to set and retrieve the value of cells in the grid by giving the x and y index of it (which starts with 0 for both the x and the y axis and goes up to the width - 1 and the height -1). But you can also set the value in specific grid regions, add single values, and retrieve the sum, maximum, minimum, and mean value over a given region, making this data structure the most versatile of all those available to you.
When accessing DS grid data structures, you should always try to use integer values for the cell position, and all non-integer indices will be floored by GameMaker: Studio if you do not. If that is not what you require, then you will need to do the rounding yourself previously before passing the index that you wish to check.
NOTE: As with all dynamic resources, data structures take up memory and so should always be destroyed when no longer needed to prevent memory leaks which will slow down and eventually crash your game.
The following functions exist that deal with DS grids.
Apart from these specific functions you can all use an expression (called an accessor) to add or modify the contents of your ds_grid. This accessor looks similar to a 2D array with the following syntax:
GML Code Example
grid_index[# xpos, ypos]
You can find more information, plus examples, from from the GML
Overview page on Accessors.