From 84e25c0673b9208a476f68b1e6bc932fb774d737 Mon Sep 17 00:00:00 2001 From: YYBartT Date: Fri, 8 Nov 2024 18:13:48 +0100 Subject: [PATCH 01/27] docs(general): add note about matrices being stored in arrays YoYoGames/GameMaker-Bugs#2960 --- Manual/contents/GameMaker_Language/GML_Overview/Data_Types.htm | 1 + 1 file changed, 1 insertion(+) diff --git a/Manual/contents/GameMaker_Language/GML_Overview/Data_Types.htm b/Manual/contents/GameMaker_Language/GML_Overview/Data_Types.htm index c432aa2b..a12f0a2c 100644 --- a/Manual/contents/GameMaker_Language/GML_Overview/Data_Types.htm +++ b/Manual/contents/GameMaker_Language/GML_Overview/Data_Types.htm @@ -43,6 +43,7 @@

Data Types

Arrays

+

Note that matrices are also stored in arrays. See Matrix Functions for more information.

 

Structs

From 502f486b14af62b7e7e021cf68555487017973e9 Mon Sep 17 00:00:00 2001 From: YYBartT Date: Mon, 11 Nov 2024 13:33:08 +0100 Subject: [PATCH 02/27] docs(feature): Add a new function matrix_inverse() for inverting a matrix YoYoGames/GameMaker-Bugs#2960 * Added matrix_inverse() page * Various other improvements to matrix function pages: * Changed the type "Matrix Array" to "Matrix", abstracting away the underlying type (similar to e.g. "Instance", "Surface", etc., which are stored in a "Handle") * Data Types: added a note under the "Arrays" section mentioning that matrices are stored in arrays * Matrix Functions page: * Grouped matrix functions according to their use, updated ToC accordingly * Documented that matrices are ordered column-major in arrays * Added a line to clarify that lines are the columns instead of the rows when splitting up an assignment over multiple lines * matrix_build() page: documented that matrices are ordered column-major in arrays, added note about matrices possibly ending up transposed in the shader * matrix_multiply() page: documented order of matrix multiplication on and added a second, copy-pastable example * matrix_set() page: listed the functions that can be used to create matrices of the various types, updated code example * matrix_get() and matrix_set() page: added proper short descriptions * Visual update of matrix function pages --- .../camera_get_proj_mat.htm | 18 +++-- .../camera_get_view_mat.htm | 18 +++-- .../Matrix_Functions/Matrix_Functions.htm | 58 ++++++++----- .../Matrix_Functions/matrix_build.htm | 19 ++--- .../matrix_build_identity.htm | 4 +- .../Matrix_Functions/matrix_build_lookat.htm | 4 +- .../matrix_build_projection_ortho.htm | 48 ++++++----- .../matrix_build_projection_perspective.htm | 50 ++++++------ ...atrix_build_projection_perspective_fov.htm | 46 ++++++----- .../Matrix_Functions/matrix_get.htm | 5 +- .../Matrix_Functions/matrix_inverse.htm | 76 ++++++++++++++++++ .../Matrix_Functions/matrix_multiply.htm | 40 ++++++--- .../Matrix_Functions/matrix_set.htm | 36 ++++++--- .../matrix_transform_vertex.htm | 21 +++-- .../matrix_array_indices_column_major.png | Bin 0 -> 7761 bytes .../snippets/Note_Matrix_Column_Major.hts | 15 ++++ Manual/toc/Default.toc | 5 +- Manual/variable/Default.var | 2 +- 18 files changed, 313 insertions(+), 152 deletions(-) create mode 100644 Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_inverse.htm create mode 100644 Manual/contents/assets/Images/Scripting_Reference/GML/Reference/Maths/matrix_array_indices_column_major.png create mode 100644 Manual/contents/assets/snippets/Note_Matrix_Column_Major.hts diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Cameras_And_Display/Cameras_And_Viewports/camera_get_proj_mat.htm b/Manual/contents/GameMaker_Language/GML_Reference/Cameras_And_Display/Cameras_And_Viewports/camera_get_proj_mat.htm index 5a363eda..299a04cf 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Cameras_And_Display/Cameras_And_Viewports/camera_get_proj_mat.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Cameras_And_Display/Cameras_And_Viewports/camera_get_proj_mat.htm @@ -4,7 +4,7 @@ camera_get_proj_mat - + @@ -16,25 +16,27 @@

camera_get_proj_mat

-

This function can be used to retrieve the projection matrix. The function returns the matrix array which can then be used in other matrix functions or to set the projection matrix of another camera (using camera_set_proj_mat()).

+

This function can be used to retrieve the projection matrix. The function returns the matrix which can then be used in other matrix functions or to set the projection matrix of another camera (using camera_set_proj_mat()).

 

Syntax:

camera_get_proj_mat(camera_id)

- + + - + - + + - +
ArgumentTypeArgumentType Description
camera_idcamera_idCamera ID The unique camera ID value returned when you created the camera

 

Returns:

-

Matrix Array

+

Matrix

 

Example:

mat = camera_get_proj_mat(camera_view[0]);

@@ -49,7 +51,7 @@

Example:

Next: camera_get_update_script
-
© Copyright YoYo Games Ltd. 2022 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved

camera_get_view_mat

-

This function can be used to retrieve the view matrix. The function returns the matrix array which can then be used in other matrix functions or to set the view matrix of another camera (using camera_set_view_mat()). Note that this function is generally for use with cameras created using camera_create(), but it can also be used on those created in the room editor (or with camera_create_view()) - in which case the returned matrix will only be valid after the given camera is used in a view port for the first time.

+

This function can be used to retrieve the view matrix. The function returns the matrix which can then be used in other matrix functions or to set the view matrix of another camera (using camera_set_view_mat()). Note that this function is generally for use with cameras created using camera_create(), but it can also be used on those created in the room editor (or with camera_create_view()) - in which case the returned matrix will only be valid after the given camera is used in a view port for the first time.

 

Syntax:

camera_get_view_mat(camera_id)

- + + - + - + + - +
ArgumentTypeArgumentType Description
camera_idcamera_idCamera ID The unique camera ID value returned when you created the camera

 

Returns:

-

Matrix Array

+

Matrix

 

Example:

mat = camera_get_view_mat(camera_view[0]);

@@ -49,7 +51,7 @@

Example:

Next: camera_get_proj_mat
-
© Copyright YoYo Games Ltd. 2022 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved

matrix_build

-

This function can be used to create your own custom matrix and will return a matrix array, which should be stored in a variable for future reference and use. It accepts 3-dimensional (x, y, z) translation, rotation and scale values, and uses them to build a matrix array.

-

The matrix array contains 16 values in total, where the initial 4 elements are row/column 1, the next 4 elements are row/column 2 and so on, as part of a 4x4 matrix. Whether the array is ordered by rows or columns depends on the target platform, as the graphics renderer used by a platform may use row-major or column-major matrices.

+

This function creates a custom transformation matrix from 3-dimensional (x, y, z) translation, rotation and scale values and returns it.

+
+

 When you set this matrix in a shader using shader_set_uniform_f_array, shader_set_uniform_matrix or shader_set_uniform_matrix_array, depending on the shader type and the target platform, you may receive the matrix transposed in the shader.

 When you build a new matrix in this way, the order of operation is YXZ.

 

Syntax:

@@ -47,17 +48,17 @@

Syntax:

xrotation Real - The angle to rotate around the x-axis (in degrees °). + The angle to rotate around the x-axis (in degrees). yrotation Real - The angle to rotate around the y-axis (in degrees °). + The angle to rotate around the y-axis (in degrees). zrotation Real - The angle to rotate around the z-axis (in degrees °). + The angle to rotate around the z-axis (in degrees). xscale @@ -78,18 +79,18 @@

Syntax:

 

Returns:

-

Matrix Array

+

Matrix

 

Example:

-

t_matrix = matrix_build(x, y, 0, 0, 90, 0, 1, 2, 1);

-

The above code will build a new matrix transform and store the resulting matrix index in a variable t_matrix.

+

t_matrix = matrix_build(x, y, 0, 0, 90, 0, 1, 2, 1);

+

The above code builds a new matrix transform and stores the resulting matrix index in a variable t_matrix.

 

 

- +
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_identity.htm b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_identity.htm index 4ed942e0..b784a0f2 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_identity.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_identity.htm @@ -26,10 +26,10 @@

Syntax:

matrix_build_identity();

 

Returns:

-

Matrix Array

+

Matrix

 

Example:

-

i_matrix = matrix_build_identity();

+

i_matrix = matrix_build_identity();

The above code will create an identity matrix and store its index in a variable for future use.

 

 

diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_lookat.htm b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_lookat.htm index c5040e1c..cd2b7100 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_lookat.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_lookat.htm @@ -78,14 +78,14 @@

Syntax:

 

Returns:

-

Matrix Array

+

Matrix

 

Example:

viewmat = matrix_build_lookat(640, 240, -10, 640, 240, 0, 0, 1, 0);
projmat = matrix_build_projection_ortho(640, 480, 1.0, 32000.0);
camera_set_view_mat(view_camera[0], viewmat);
camera_set_proj_mat(view_camera[0], projmat);

-

The above code creates a new look-at matrix and orthographic matrix, stores them in variables and then uses them to set the view and projection matrices for the camera assigned to view port[0].

+

The above code creates a new look-at matrix and orthographic projection matrix, stores them in variables and then uses them to set the view and projection matrices for the camera assigned to view port[0].

 

 

diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_projection_ortho.htm b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_projection_ortho.htm index 48be190a..33ab8076 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_projection_ortho.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_build_projection_ortho.htm @@ -4,7 +4,7 @@ matrix_build_projection_ortho - + @@ -15,39 +15,44 @@ -

matrix_build_projection_ortho

-

This function builds an orthographic projection matrix based on the specified parameters listed below (this is the default projection method used when you create a room in GameMaker without changing anything). Sometimes you need to switch from a perspective projection to an orthographic projection which is what this function is for. It is typically used to draw an overlay, for example, to show the score or other aspects as this gives a "flat" view of the elements drawn (ie: no perspective) in a 3D game. See the image below to get an idea of the difference between orthographic and perspective views.

-

NOTE: You may also need to temporarily switch off hidden surface removal if you want the information to be drawn regardless of the current depth value.

+

matrix_build_projection_ortho

+

This function builds an orthographic projection matrix based on the specified parameters listed below (this is the default projection method used when you create a room in GameMaker without changing anything). Sometimes you need to switch from a perspective projection to an orthographic projection which is what this function is for. It is typically used to draw an overlay, for example, to show the score or other aspects as this gives a "flat" view of the elements drawn (i.e.: no perspective) in a 3D game. See the image below to get an idea of the difference between orthographic and perspective views.

+

 You may also need to temporarily switch off hidden surface removal if you want the information to be drawn regardless of the current depth value.

Ortho prjection matrix example

Syntax:

-

matrix_build_projection_ortho(width, height, znear, zfar);

+

matrix_build_projection_ortho(width, height, znear, zfar);

- + + - + - + + - + - + + - + - - - + + + + - - - + + + +
ArgumentTypeArgumentType Description
wwidthReal The width of the projection.
hheightReal The height of the projection.
znearThe near clipping plane.
znearRealThe distance to the near clipping plane.
zfarThe far clipping plane.
zfarRealThe distance to the far clipping plane.

 

Returns:

-

Matrix Array

+

Matrix

 

Example:

viewmat = matrix_build_lookat(640, 240, -10, 640, 240, 0, 0, 1, 0);
@@ -57,15 +62,14 @@

Example:

The above code creates a new look-at matrix and orthographic matrix, stores their IDs in local variables and then uses them to set the view and projection matrices for the camera assigned to view port[0].

 

 

-

 

- - + +
-
© Copyright YoYo Games Ltd. 2022 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
-

matrix_build_projection_perspective

+

matrix_build_projection_perspective

This function builds a perspective projection matrix based on the dimensions of the near clipping plane, using the specified parameters listed below.

-

Note that the field of view of the camera will vary depending on the width, height and znear values specified, as the projection width and height are placed at the Z position specified in the znear argument.

-

For example, given a constant size of 640x480, the field of view will be wider if znear is closer to the camera, but it will be narrower if znear is far away from the camera. This behaviour is demonstrated in the following visual:

-

Due to this, it is recommended to use a znear value that is identical to the width of the projection, resulting in the field of view being consistent with an equivalent orthographic projection.

+

Note that the field of view of the camera will vary depending on the width, height and znear values specified, as the projection width and height are placed at the Z position specified in the znear argument.

+

For example, given a constant size of 640x480, the field of view will be wider if znear is closer to the camera, but it will be narrower if znear is far away from the camera. This behaviour is demonstrated in the following visual:

+

Due to this, it is recommended to use a znear value that is identical to the width of the projection, resulting in the field of view being consistent with an equivalent orthographic projection.

 

Syntax:

-

matrix_build_projection_perspective(width, height, znear, zfar);

+

matrix_build_projection_perspective(width, height, znear, zfar);

- + + - + - + + - + - + + - + - + + - + - + + - +
ArgumentTypeArgumentType Description
wwidthReal The width of the projection at the near Z position.
hheightReal The height of the projection at the near Z position.
znearznearReal The near clipping plane.
zfarzfarReal The far clipping plane.

 

Returns:

-

Matrix Array

+

Matrix

 

Example:

-

var projmat = matrix_build_projection_perspective(640, 480, 640.0, 32000.0);
- camera_set_proj_mat(view_camera[0], projmat);

+

var _projmat = matrix_build_projection_perspective(640, 480, 640.0, 32000.0);
+ camera_set_proj_mat(view_camera[0], _projmat);

The above code creates a perspective projection and then uses the matrix returned to set the camera assigned to view port[0].

 

 

-

 

- - + +
-
© Copyright YoYo Games Ltd. 2022 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
-

matrix_build_projection_perspective_fov

-

This function builds a perspective projection matrix matrix based on field of view, using the specified parameters listed below.

+

matrix_build_projection_perspective_fov

+

This function builds a perspective projection matrix based on field of view, using the specified parameters listed below.

 

Syntax:

-

matrix_build_projection_perspective_fov(fov_y, aspect, znear, zfar);

+

matrix_build_projection_perspective_fov(fov_y, aspect, znear, zfar);

- + + - + - - - + + + + - + + - + - + + - + - + + - +
ArgumentTypeArgumentType Description
fovThe angle of the field of view.
fov_yRealThe vertical angle of the field of view.
aspectaspectReal The aspect ratio of the field of view.
znearznearReal The near clipping plane.
zfarzfarReal The far clipping plane.

 

Returns:

-

Matrix Array

+

Matrix

 

Example:

-

projmat = matrix_build_projection_perspective_fov(60, 320/240, 1.0, 32000.0);
- camera_set_proj_mat(view_camera[0], projmat);

+

var _projmat = matrix_build_projection_perspective_fov(60, 320/240, 1.0, 32000.0);
+ camera_set_proj_mat(view_camera[0], _projmat);

The above code creates a field of view projection matrix which is then stored in a variable. This matrix is then used to set up the camera assigned to view port[0].

 

 

-

 

- +
-
© Copyright YoYo Games Ltd. 2022 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved

matrix_get

-

This function returns an array of 16 values, corresponding to the given 4x4 matrix type, where row 1 is elements [0 - 3], row 2 is elements [4 -7], etc. (see the image on the main page).

+

This function gets the currently used matrix of the given type.

+

The matrix is returned as an array of 16 values, corresponding to the given 4x4 matrix type, where column 1 is stored in elements [0 - 3], column 2 is stored in elements [4 -7], etc. (see the images on the main page).

The available matrices are view, projection and world, for which you would use one of the following constants:

@@ -64,7 +65,7 @@

Syntax:

 

Returns:

-

Matrix Array

+

Matrix

 

Example:

v_array = matrix_get(matrix_view);

diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_inverse.htm b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_inverse.htm new file mode 100644 index 00000000..cc8acfb0 --- /dev/null +++ b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_inverse.htm @@ -0,0 +1,76 @@ + + + + + + matrix_inverse + + + + + + + + + + +

matrix_inverse

+

This function returns a new matrix that is the inverse of the matrix you pass it.

+

The inverse of a matrix is the matrix that, when multiplied with the original matrix, is equal to an identity matrix.

+

From a more practical perspective, the inverse of a matrix undoes the transformation of the original matrix. For example, the matrix matrix_build(100, 100, 0, 90, 0, 0, 1, 1, 1) first rotates about x by 90 degrees and then moves right 100 and down 100. Its inverse matrix matrix_inverse(matrix_build(100, 100, 0, 90, 0, 0, 1, 1, 1)) first moves left 100 and up 100 and then rotates about x by -90 degrees, performing the exact same steps in reverse order. The product of these matrices (i.e. matrix_multiply(inverse, transform)) will be an identity matrix.

+

 

+

Syntax:

+

matrix_inverse(matrix);

+ + + + + + + + + + + + + + + + + + +
ArgumentTypeDescription
matrixMatrixThe matrix to get the inverse of
+

 

+

Returns:

+

Matrix

+

 

+

Example:

+

transform = matrix_build(x, y, 0, 90, 0, direction, 1, 1, 1);
+ transform_inverse = matrix_inverse(transform);
+
+ transform_product = matrix_multiply(transform, transform_inverse);
+
+ show_debug_message(transform);
+ show_debug_message(transform_inverse);
+ show_debug_message(transform_product); +

+

The above code shows how to build a transform matrix, get its inverse using matrix_inverse and multiply the two matrices back together. The three matrices, i.e. the original matrix, its inverse and their product are then output in a debug message. Note that the product of the matrices is equal to an identity matrix (i.e. matrix_build_identity).

+

 

+

 

+
+
+
+ + +
+
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
+
+ + + + \ No newline at end of file diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_multiply.htm b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_multiply.htm index 01f2b6d1..167ca493 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_multiply.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_multiply.htm @@ -15,8 +15,11 @@

matrix_multiply

-

This function multiplies two matrix arrays together to create a new transform matrix. The function will return the new matrix index which should be stored in a variable for future use.

-

 You can't use a matrix constant as an argument with this function, so if you wish to multiply the (for example) view matrix with a custom matrix that you have built, you must first call matrix_get and assign the view matrix values to an array variable, then multiply it by your custom matrix, and then set the chosen matrix (view, projection or world).

+

This function multiplies two matrices together to create a new matrix and returns the new matrix.

+

The order of the matrices in the multiplication affects the result. This function multiplies the two matrices you pass it in the following order: 

+

result = matrix2 * matrix1;

+

To know the order in which the transforms held by these matrices are applied this needs to be read from right to left, i.e. the result matrix first applies the transform stored in matrix1 and then the transform stored in matrix2.

+

 You cannot use a matrix constant as an argument with this function, so if you wish to multiply the (for example) view matrix with a custom matrix that you have built, you must first call matrix_get and assign the view matrix values to an array variable, then multiply it by your custom matrix, and then set the chosen matrix (view, projection or world).

 

Syntax:

matrix_multiply(matrix1, matrix2);

@@ -29,32 +32,49 @@

Syntax:

matrix1 - Matrix Array - The first matrix index to use. + Matrix + The first matrix to use (storing the first transformation to apply) matrix2 - Matrix Array - The second matrix index to use. + Matrix + The second matrix to use (storing the second transformation to apply)

 

Returns:

-

Matrix Array

+

Matrix

 

-

Example:

+

Example 1: Basic Use

var v_matrix = matrix_get(matrix_view);
var new_matrix = matrix_multiply(v_matrix, my_matrix);
matrix_set(matrix_view, new_matrix);

-

The above code will get the current view matrix, then multiply that with a custom matrix and then use the resulting matrix index to set the view matrix again.

+

The above code gets the current view matrix, multiplies that with a custom matrix and sets the view matrix to the resulting matrix.

+

 

+

Example 2: Drawing a Rectangle Relative to a Circle

+

Draw Event

+

var _mat_child_local = matrix_build(100, 100, 0, 0, 0, current_time/2, 1, 1, 1);
+ var _mat_parent_global = matrix_build(x, y, 0, 0, 0, current_time/12 + dsin(current_time/4) * 30, 1, 1, 1);
+ var _mat_child_global = matrix_multiply(_mat_child_local, _mat_parent_global);
+
+ matrix_set(matrix_world, _mat_parent_global);
+ draw_circle_color(0, 0, 100, c_blue, c_blue, false);
+ matrix_set(matrix_world, _mat_child_global);
+ draw_rectangle_color(-10, -10, 10, 10, c_red, c_red, c_red, c_red, false);
+ matrix_set(matrix_world, matrix_build_identity()); +

+

The code example above shows how matrix_multiply can be used to draw a rectangle shape relative to a circle shape.

+

In the Draw event, two matrices are built using matrix_build and stored in variables _mat_child_local and _mat_parent_global. The first matrix represents the transform of the rectangle relative to the circle, the second matrix that of the circle relative to the room. Using matrix_multiply a third matrix is then created that is the product of the first two matrices. The rectangle's transform is the first argument passed to the function, the circle's transform the second, i.e. the transformation stored in the resulting matrix will first apply the rectangle's transform, then the circle's transform.

+

Next, the world matrix is set to _mat_parent_global using matrix_set and a blue circle with radius 100 is drawn. After that, the world matrix is set to _mat_child_global and a red square with a side of 20 is drawn.

+

Finally, the world matrix is reset to an identity matrix to not affect further drawing.

 

 

- +
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_set.htm b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_set.htm index 980b851e..b7860a16 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_set.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_set.htm @@ -15,14 +15,19 @@

matrix_set

-

This function takes an array of 16 values, corresponding to a given 4x4 matrix type, where elements [0 - 3] would be row 1, elements [4 -7] would be row 2, etc. (see the image on the main page).

-

You can create such a matrix using the matrix_build or matrix_get functions or simply build the array yourself and pass that into the function. The available matrix types are view, projection and world, for which you would use one of the following constants:

- +

This function sets the current matrix of the given type to the given matrix.

+

The available matrix types are world, view, and projection, which are represented by the following constants:

+
+ + + + + @@ -31,12 +36,15 @@

matrix_set

- - - -
Matrix Type Constant
Constant Description
matrix_worldThe current world matrix
matrix_view The current view matrix matrix_projection The current projection matrix
matrix_worldThe current world matrix
+

You can create a matrix using the matrix_build* functions or simply build the array yourself and pass that into the function.

+

The built-in functions that you can use for the various types of matrices are:

+

 

Syntax:

matrix_set(type, matrix);

@@ -54,7 +62,7 @@

Syntax:

matrix - Matrix Array + Matrix The matrix data as an array @@ -64,15 +72,21 @@

Returns:

N/A

 

Example:

-

matrix_set(matrix_world, m_array);

-

The above code will set the values of the current world matrix to those stored in the array matrix m_array.

+

Draw Event

+

var _world_matrix = matrix_build(x, y, 0, 0, 0, image_angle, 1, 1, 1);
+ matrix_set(matrix_world, _world_matrix);
+ draw_sprite(sprite_index, 0, 0, 0);
+ matrix_set(matrix_world, matrix_build_identity()); +

+

The above code draws an instance's sprite at its position by changing the world matrix.

+

First, a world matrix is created with matrix_build which first does a rotation about image_angle degrees and then moves to the position given by x and y. Next, the world matrix is set to this matrix in a call to matrix_set and the sprite_index of the instance executing the Draw event is drawn with draw_sprite (note that the x and y passed to this function must be 0, since it is the world matrix that moves the sprite to the instance's (x, y) position!). Finally, the world matrix is reset to an identity matrix in another call to matrix_set.

 

 

- +
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_transform_vertex.htm b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_transform_vertex.htm index 9f43d557..a539ec03 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_transform_vertex.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Maths_And_Numbers/Matrix_Functions/matrix_transform_vertex.htm @@ -4,7 +4,7 @@ matrix_transform_vertex - + @@ -34,50 +34,49 @@

Syntax:

matrix - Matrix Array + Matrix The matrix to use x - Real + Real The x component of the vector to transform y - Real + Real The y component of the vector to transform z - Real + Real The z component of the vector to transform w - Real + Real  The w component of the vector to transform

 

Returns:

-

Array (3 elements (x, y and z are passed) or 4 elements (x, y, z and w are passed))

+

Array (3 elements (x, y and z are passed) or 4 elements (x, y, z and w are passed))

 

Example:

t_matrix = matrix_build(0, 0, 0, 0, 90, 0, 1, 2, 1);
new_xyz = matrix_transform_vertex(t_matrix, x, y, z);

-

The above code transforms the given values using the matrix stored in the variable "t_matrix" and stores them in the array new_xyz.

-

 

+

The above code transforms the given values using the matrix stored in the variable t_matrix and stores them in the array new_xyz.

 

 

- +
-
© Copyright YoYo Games Ltd. 2022 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved

Plugin Preferences

The Plugin Preferences are used to control any extra plugins that have been added to the GameMaker IDE. By default this has one section dedicated to the Source Control plugin for integrating GameMaker projects with Git.

+

Project Tool

+
+

Plugins Git SCM Preferences

+

This section contains the preferences related to Project Tool:

+
    +
  • Path to Project Tool: Here you can specify an alternative path to Project Tool. This field is empty by default, which indicates that the version bundled with this release of the IDE is used. You should normally not need to change this. See Project Tool Versions.
    • +
+

Source Control (Git)

Plugins Git SCM PreferencesThis section deals with the preferences that are required to get the Git SCM plugin to work with GameMaker.

@@ -46,15 +54,17 @@

Plugin Preferences

Next: Runtime Feed Preferences
-
© Copyright YoYo Games Ltd. 2023 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
\ No newline at end of file diff --git a/Manual/contents/assets/Images/Setup_And_Version/Preferences/Plugins_Project_Tool_Prefs.png b/Manual/contents/assets/Images/Setup_And_Version/Preferences/Plugins_Project_Tool_Prefs.png new file mode 100644 index 0000000000000000000000000000000000000000..8acfb8056583d10bea3f1490c887330baad13f6c GIT binary patch literal 46769 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

w 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 I-S^x71N_Y>L;wH) literal 0 HcmV?d00001 From cd53c3ddbf80a83840742db57325cceda97333a1 Mon Sep 17 00:00:00 2001 From: YYBartT Date: Thu, 14 Nov 2024 12:53:15 +0100 Subject: [PATCH 07/27] docs(general): Added a note to mention that websockets are not supported on Windows 7 YoYoGames/GameMaker-Bugs#7893 --- Manual/contents/assets/snippets/network_socket_types.hts | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/Manual/contents/assets/snippets/network_socket_types.hts b/Manual/contents/assets/snippets/network_socket_types.hts index 995e2552..2b823baf 100644 --- a/Manual/contents/assets/snippets/network_socket_types.hts +++ b/Manual/contents/assets/snippets/network_socket_types.hts @@ -3,7 +3,7 @@ - + network_socket_types @@ -16,7 +16,7 @@ - Socket Type Constant + Socket Type Constant Constant @@ -40,7 +40,8 @@ -

NOTE 1 It is also possible to secure your simple WebSocket (network_socket_ws) by using the wss:// protocol in your URLs.

-

NOTE 2 * Secure WebSockets will not work on UWP and Xbox One when using the legacy XDK platform, however they will work on those targets when using GDK.

+

 It is also possible to secure your simple WebSocket (network_socket_ws) by using the wss:// protocol in your URLs.

+

 * Secure WebSockets will not work on UWP and Xbox One when using the legacy XDK platform, however they will work on those targets when using GDK.

+

 Websockets are not supported on Windows 7.

\ No newline at end of file From 081d70960ef54ac76e989bd445f4c861db48fee2 Mon Sep 17 00:00:00 2001 From: YYBartT Date: Thu, 14 Nov 2024 20:09:09 +0100 Subject: [PATCH 08/27] docs(general): When launching a GM game that only supports full-screen it can be launched in Windowed Mode YoYoGames/GameMaker#4544 * Updated the "Start Fullscreen" option description on all desktop platforms' Game Options page * Slight visual update of the window_get_fullscreen() and window_get_fullscreen() pages * Various little changes to the pages: visual update, updated tags, a few typo fixes --- .../The_Game_Window/window_get_fullscreen.htm | 21 ++++++------ .../The_Game_Window/window_set_fullscreen.htm | 34 +++++++++++-------- .../contents/Settings/Game_Options/Ubuntu.htm | 7 ++-- .../Settings/Game_Options/Windows.htm | 8 ++--- .../contents/Settings/Game_Options/macOS.htm | 12 +++---- .../assets/snippets/Note_Fullscreen.hts | 14 ++++++++ 6 files changed, 57 insertions(+), 39 deletions(-) create mode 100644 Manual/contents/assets/snippets/Note_Fullscreen.hts diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Cameras_And_Display/The_Game_Window/window_get_fullscreen.htm b/Manual/contents/GameMaker_Language/GML_Reference/Cameras_And_Display/The_Game_Window/window_get_fullscreen.htm index bdab3c44..6ccf5981 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Cameras_And_Display/The_Game_Window/window_get_fullscreen.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Cameras_And_Display/The_Game_Window/window_get_fullscreen.htm @@ -4,7 +4,7 @@ window_get_fullscreen - + @@ -15,17 +15,17 @@ -

window_get_fullscreen

-

This function returns whether the game window is in fullscreen mode (true) or not (false).

+

window_get_fullscreen

+

This function returns whether the game window is in fullscreen mode (true) or not (false).

 

Syntax:

-

window_get_fullscreen();

+

window_get_fullscreen();

 

Returns:

-

+

Boolean

 

Example:

-

if (window_get_fullscreen())
+

if (window_get_fullscreen())
{
    draw_text(32, 32, "Fullscreen is ON");
}
@@ -33,18 +33,17 @@

Example:

{
    draw_text(32, 32, "Fullscreen is OFF");
}

-

The above code will check to see if the window is in full screen mode or not and draw a text message depending on the returned value.

-

 

+

The above code will check to see if the window is in fullscreen mode or not and draw a text message depending on the returned value.

 

 

- - + +
-
© Copyright YoYo Games Ltd. 2021 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
-

window_set_fullscreen

-

With this function you can set the game window to be full screen (true) or not (false). Please note that for the macOS target, you must have unchecked the "Start In Fullscreen" option and checked the "Allow the player to resize the game window" option in the Game Options, otherwise this function will fail. Also note that this function will not work on HTML5 unless it's added in as a "clickable" callback (see here for more details).

+

window_set_fullscreen

+

This function sets the game window to be full screen (true) or not (false).

+

Usage Notes

+
    +
  • For the macOS target, you must have unchecked the Start Fullscreen option and checked the Allow window resize option in the Game Options, otherwise this function will fail.
    • +
  • This function will not work on HTML5 unless it's added in as a "clickable" callback (see clickable_add for more details).
    • +

 

Syntax:

-

window_set_fullscreen(full);

+

window_set_fullscreen(full);

- + + - + - - - + + + +
ArgumentTypeArgumentType Description
fullWhether to set the screen to fullscreen (true) or not (false).
fullBooleanWhether to set the screen to fullscreen (true) or not (false).

 

Returns:

-

+

N/A

 

Example:

if mouse_check_button_pressed(mb_left)
@@ -50,15 +57,14 @@

Example:

The above code checks for a mouse button press and then sets the window to fullscreen if it is not already, or sets it to windowed if it is already.

 

 

-

 

- - + +
-
© Copyright YoYo Games Ltd. 2021 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
-

instance_create_layer

-

With this function you can create a new instance of the specified object at any given point within the room and on the layer specified. The layer can be identified using the layer handle (as returned by the function layer_create) or by the name of the layer (as a string, for example "instance_layer") as defined in The Room Editor.

-

This function returns the id of the new instance which can then be stored in a variable and used to access that instance. Note that this function will also call the Create Event of the instance being created before continuing with the code or actions for the event that called the function.

-
-

This function behaves differently when you call it after calling a room-changing function in the same event. See the note on room_goto for details.

-

Optional Struct

-

The last argument, var_struct, is optional and takes a struct containing additional variables for the new instance.

-

Variables from this struct are applied to the new instance before its Create event runs, but after its Variable Definitions are set.

-

This means that the values from that struct are readable in the Create event of the new instance. See Example 2 at the bottom.

-

Values applied to the new instance through this struct can be of any type, including method variables. Built-in variables can be changed as well.

-

NOTE Variables from the struct are "shallow-copied" to the new instance, meaning any arrays, structs, and other resources are copied by reference and not duplicated.

-

-

Syntax:

-

instance_create_layer(x, y, layer_id, obj, [var_struct]);

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ArgumentTypeDescription
xRealThe x position the object will be created at
yRealThe y position the object will be created at
layer_idLayer or StringThe layer handle (or name) to assign the created instance to
objObject AssetThe object index of the object to create an instance of
var_structStructOPTIONAL A struct with variables to assign to the new instance
-

-

Returns:

-

Object Instance

-

-

Example 1:

-

var inst = instance_create_layer(x, y, "Instances", obj_bullet); -
- with (inst) -
- { -
- speed = other.shoot_speed; -
- direction = other.image_angle; -
- }

-

The above code creates a new instance of the object obj_bullet in the "Instances" layer, and stores the instance ID in a variable. This variable is then used to assign speed and direction to the new instance.

-

This will first create the instance, run its Create event, and then assign values to its variables.

-

If you want to assign some variables before the Create event runs, see the example below.

-

-

Example 2:

-

var inst = instance_create_layer(x, y, "Instances", obj_bullet, -
- { -
- speed : shoot_speed, -
- direction : image_angle -
- });

-

The above code creates an instance of obj_bullet, and passes in a struct as the last argument.

-

That struct has variables for the speed and direction. It pulls its values from the calling instance, without the need to use other.

-

These variables are applied to the new instance before its Create event runs.

-

You're not limited to a struct literal, as you can also pass in a variable that stores an existing struct, or create a new struct from a constructor.

-

-

-
-
-
-
Back: Instances
- -
+ + + instance_create_layer + + + + + + + + + + +

instance_create_layer

+

With this function you can create a new instance of the specified object at any given point within the room and on the layer specified. The layer can be identified using the layer handle (as returned by the function layer_create) or by the name of the layer (as a string, for example "instance_layer") as defined in The Room Editor.

+

This function returns the id of the new instance which can then be stored in a variable and used to access that instance. Note that this function will also call the Create Event of the instance being created before continuing with the code or actions for the event that called the function.

+
+

This function behaves differently when you call it after calling a room-changing function in the same event. See the note on room_goto for details.

+
+

 

+

Syntax:

+

instance_create_layer(x, y, layer_id, obj, [var_struct]);

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ArgumentTypeDescription
xRealThe x position the object will be created at
yRealThe y position the object will be created at
layer_idLayer or StringThe layer handle (or name) to assign the created instance to
objObject AssetThe object index of the object to create an instance of
var_structStructOPTIONAL A struct with variables to assign to the new instance
+

 

+

Returns:

+

Object Instance

+

 

+

Example 1:

+

var inst = instance_create_layer(x, y, "Instances", obj_bullet);
+ with (inst)
+ {
+     speed = other.shoot_speed;
+     direction = other.image_angle;
+ }

+

The above code creates a new instance of the object obj_bullet in the "Instances" layer, and stores the instance ID in a variable. This variable is then used to assign speed and direction to the new instance.

+

This will first create the instance, run its Create event, and then assign values to its variables.

+

If you want to assign some variables before the Create event runs, see the example below.

+

 

+

Example 2:

+

var inst = instance_create_layer(x, y, "Instances", obj_bullet,
+ {
+     speed : shoot_speed,
+     direction : image_angle
+ });

+

The above code creates an instance of obj_bullet, and passes in a struct as the last argument.

+

That struct has variables for the speed and direction. It pulls its values from the calling instance, without the need to use other.

+

These variables are applied to the new instance before its Create event runs.

+

You're not limited to a struct literal, as you can also pass in a variable that stores an existing struct, or create a new struct from a constructor.

+

 

+

 

+
+
+
+
Back: Instances
+
-
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
- + +--> + \ No newline at end of file diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Asset_Management/Rooms/room_get_info.htm b/Manual/contents/GameMaker_Language/GML_Reference/Asset_Management/Rooms/room_get_info.htm index b8c102f9..6c78dba6 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Asset_Management/Rooms/room_get_info.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Asset_Management/Rooms/room_get_info.htm @@ -1,894 +1,869 @@ - + - - - room_get_info - - - - - - - - - - -

room_get_info

-

This function gets information on a room from storage and returns it as a struct. You can choose to exclude information through the given optional arguments.

-

The function cannot be used to get the current state of an active room (the current room or an already visited persistent room). In this case it returns the original state of the room.

-

The room must have been previously created using The Asset Browser or added in-game using room_add.

-

The format of the returned struct is as follows:

-

room_info_struct = -
- { -
- instances: -
- [ -
- {/* Instance Info Struct */}, -
- {/* Instance Info Struct */}, -
- ], -
- layers: -
- [ -
- { -
- elements: -
- [ -
- {/* Layer Element Info Struct */}, -
- { -
- /* Example */ -
- type: layerelementtype_tilemap, -
- tiles: [/* Tile Map Data */] -
- } -
- ] -
- }, -
- ], -
- views: -
- [ -
- {/* View Info Struct */}, -
- ] -
- }

-

The tables below list all the possible structs that can be contained in the returned struct:

-

Room Info

-
-

This is the main struct returned by the function. All variables listed below are present at the root of this returned struct:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Room Info Struct
Variable NameData TypeDescription
widthRealThe width of the room
heightRealThe height of the room
creationCodeScript FunctionThe index of the script function that contains this room's creation code
physicsWorldBooleanWhether the room has a physics world
physicsGravityXRealThe physics world's gravity component along the x axis
physicsGravityYRealThe physics world's gravity component along the y axis
physicsPixToMetersRealThe physics world's pixel-to-metre scale
persistentBooleanWhether the room is persistent
enableViewsBooleanWhether views are enabled for the room
clearDisplayBufferBooleanWhether to clear the display buffer before drawing the room
clearViewportBackgroundBooleanWhether to clear viewports' backgrounds before drawing to them
colourColourThe clear colour used when clearDisplayBuffer is set to true
instancesArray of Room Instance Info StructAn array listing all instances placed in the room with basic information on them
layersArray of Room Layer Info StructAn array listing all room layers, in order of increasing depth
viewsArray of Room View Info StructAn array listing all views, ordered by view index
-
-

Instance Info

-
-

This type of struct represents one instance in the room.

-

These structs are found in the instances array, which is part of the main struct returned by the function.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Instance Info Struct
Variable NameData TypeDescription
idObject InstanceThe instance ID
object_indexStringThe name of the object this is an instance of (use asset_get_index to get the actual object)
xRealThe x coordinate of the instance's position
yRealThe y coordinate of the instance's position
xscaleRealThe x scale of the instance
yscaleRealThe y scale of the instance
angleRealThe rotation angle of the instance
image_indexRealThe image index used by the instance
image_speedRealThe image speed of the instance
colourColourThe blend colour used to draw the instance
creation_codeScript FunctionThe index of the script function that contains the instance's creation code
pre_creation_codeScript FunctionThe index of the script function that contains the instance's pre-creation code
-
-

Layer Info

-
-

This type of struct represents one layer in the room.

-

These structs are found in the layers array, which is part of the main struct returned by the function.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Layer Info Struct
Variable NameData TypeDescription
idRealThe layer handle
nameStringThe name of the layer
visibleBooleanWhether the layer is visible
depthRealThe depth of the layer
xoffsetRealThe x offset of the layer
yoffsetRealThe y offset of the layer
hspeedRealThe horizontal speed of the layer
vspeedRealThe vertical speed of the layer
effectEnabledBooleanWhether the layer filter/effect is currently enabled
effectToBeEnabledBooleanWhether the layer filter/effect should be enabled/disabled in the next frame (the next value of effectEnabled)
effectFX StructA struct containing the effect's parameters (-1 if no layer effect is set)
shaderIDShader AssetThe shader to be applied to the layer (layer_shader)
elementsArray of Room Layer Element Info StructAn array listing all elements on the layer. Each element type struct contains information specific to it.
-
-

View Info

-
-

This type of struct represents one view in the room.

-

These structs are found in the views array, which is part of the main struct returned by the function.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
View Info Struct
Variable NameData TypeDescription
visibleBooleanWhether the view is visible
cameraIDCamera IDThe camera assigned to this view
xviewRealThe x coordinate of the view camera's position
yviewRealThe y coordinate of the view camera's position
wviewRealThe width of the view's camera
hviewRealThe height of the view's camera
hspeedRealThe horizontal movement speed of the view
vspeedRealThe vertical movement speed of the view
xportRealThe x position on screen where the view is drawn
yportRealThe y position on screen where the view is drawn
wportRealThe width of the viewport
hportRealThe height of the viewport
objectObject AssetThe object of which the first instance in the room should be followed by the camera
hborderRealThe horizontal border around the instance of the object to follow
vborderRealThe vertical border around the instance of the object to follow
-
-

Layer Element Info

-
-

This type of struct represents one element in a layer.

-

These structs are found in the elements array, which is part of a layer struct.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Layer Element Info Struct
Variable NameData TypeDescription
All Element Types
idRealThe unique ID of the element
typeLayer Element Type ConstantThe type of element
Background Element Type
sprite_indexSprite AssetThe sprite used by the background
image_indexRealThe sprite's subimage
xscaleRealThe scale along the x axis
yscaleRealThe scale along the y axis
htiledBooleanWhether to tile the background image horizontally
vtiledBooleanWhether to tile the background image vertically
stretchBooleanWhether to stretch the background so it fills the entire room
visibleBooleanWhether the background should be visible
blendColourColourThe blend colour to draw the background with
blendAlphaRealThe alpha value between 0 and 1 to use
image_speedRealThe image speed of the background
speed_typeSprite Speed ConstantThe units in which image_speed is expressed, either spritespeed_framespersecond or spritespeed_framespergameframe
nameStringThe name of the background
Instance Element Type
inst_idObject InstanceThe ID of the instance
Sprite Element Type
sprite_indexSprite AssetThe sprite index of this sprite element
image_indexRealThe subimage of the sprite
xRealThe x coordinate of the sprite's position
yRealThe y coordinate of the sprite's position
image_xscaleRealThe scale of the image along the x axis
image_yscaleRealThe scale of the image along the y axis
image_angleRealThe image angle
image_alphaRealThe alpha value between 0 and 1
image_blendColourThe blend colour
image_speedRealThe animation speed of the image, expressed in speed_type units
speed_typeSprite Speed ConstantThe units in which image_speed is expressed, either spritespeed_framespersecond or spritespeed_framespergameframe
nameStringThe name of the sprite element as given in The Room Editor (default is graphic_*)
Tile Map Element Type
xRealThe x position (or offset) of the tile map in the room
yRealThe y position (or offset) of the tile map in the room
tileset_indexTile Set AssetThe tile set that this tile map uses
data_maskRealThe bitmask value for the tile map
tilesArray of RealThis variable is only present when the tilemap_data parameter is set to true. It is a one-dimensional array that contains all the tile map data, listed row by row.
widthRealThe width in cells of the tile map
heightRealThe height in cells of the tile map
nameStringThe tile map's name
Particle System Element Type
psParticle System AssetThe particle system
xRealThe x coordinate of the particle system's position
yRealThe y coordinate of the particle system's position
angleRealThe angle by which the particle system is rotated
xscaleRealThe scale along the x axis of the particle system
yscaleRealThe scale along the y axis of the particle system
blendColourThe blend colour to use to draw the particle system
alphaRealThe alpha value between 0 and 1 to use
nameStringThe name of the particle system element as defined in The Room Editor (default is particle_*)
Tile Element Type
visibleBooleanWhether the tile is visible
sprite_indexSprite AssetThe sprite this tile is on
xRealThe x coordinate of the tile position
yRealThe y coordinate of the tile position
widthRealThe width of the tile
heightRealThe height of the tile
image_xscaleRealThe scale factor along the x axis of the tile
image_yscaleRealThe scale factor along the y axis of the tile
image_angleRealThe angle of the tile
image_blendColourThe blend colour to use to draw the tile
image_alphaRealThe alpha to use
xoRealThe x offset
yoRealThe y offset
Sequence Element Type
xRealThe x coordinate of the sequence position
yRealThe y coordinate of the sequence position
image_xscaleRealThe scale along the x axis of the entire sequence
image_yscaleRealThe scale along the y axis of the entire sequence
image_angleRealThe angle by which the sequence is rotated
image_alphaRealThe alpha value between 0 and 1 to use
image_blendColourThe blend colour to use to draw the sequence
image_speedRealThe animation speed of the sequence, expressed in speed_type units
speedTypeSprite Speed ConstantThe units in which image_speed is expressed, either spritespeed_framespersecond or spritespeed_framespergameframe
seq_idSequence AssetThe sequence asset
nameStringThe name of the sequence element as defined in The Room Editor (default is graphic_*)
head_positionRealThe playhead position of the sequence
-
-

-

Syntax:

-

room_get_info(room, [views], [instances], [layers], [layer_elements], [tilemap_data]);

- + + + room_get_info + + + + + + + + + + +

room_get_info

+

This function gets information on a room from storage and returns it as a struct. You can choose to exclude information through the given optional arguments.

+

The function cannot be used to get the current state of an active room (the current room or an already visited persistent room). In this case it returns the original state of the room.

+

The room must have been previously created using The Asset Browser or added in-game using room_add.

+

The format of the returned struct is as follows:

+

room_info_struct =
+ {
+ instances:
+ [
+ {/* Instance Info Struct */},
+ {/* Instance Info Struct */},
+ ],
+ layers:
+ [
+ {
+ elements:
+ [
+ {/* Layer Element Info Struct */},
+ {
+ /* Example */
+ type: layerelementtype_tilemap,
+ tiles: [/* Tile Map Data */]
+ }
+ ]
+ },
+ ],
+ views:
+ [
+ {/* View Info Struct */},
+ ]
+ }

+

The tables below list all the possible structs that can be contained in the returned struct:

+

Room Info

+
+

This is the main struct returned by the function. All variables listed below are present at the root of this returned struct:

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Room Info Struct
Variable NameData TypeDescription
widthRealThe width of the room
heightRealThe height of the room
creationCodeScript FunctionThe index of the script function that contains this room's creation code
physicsWorldBooleanWhether the room has a physics world
physicsGravityXRealThe physics world's gravity component along the x axis
physicsGravityYRealThe physics world's gravity component along the y axis
physicsPixToMetersRealThe physics world's pixel-to-metre scale
persistentBooleanWhether the room is persistent
enableViewsBooleanWhether views are enabled for the room
clearDisplayBufferBooleanWhether to clear the display buffer before drawing the room
clearViewportBackgroundBooleanWhether to clear viewports' backgrounds before drawing to them
colourColourThe clear colour used when clearDisplayBuffer is set to true
instancesArray of Room Instance Info StructAn array listing all instances placed in the room with basic information on them
layersArray of Room Layer Info StructAn array listing all room layers, in order of increasing depth
viewsArray of Room View Info StructAn array listing all views, ordered by view index
+
+

Instance Info

+
+

This type of struct represents one instance in the room.

+

These structs are found in the instances array, which is part of the main struct returned by the function.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Instance Info Struct
Variable NameData TypeDescription
idObject InstanceThe instance ID
object_indexStringThe name of the object this is an instance of (use asset_get_index to get the actual object)
xRealThe x coordinate of the instance's position
yRealThe y coordinate of the instance's position
xscaleRealThe x scale of the instance
yscaleRealThe y scale of the instance
angleRealThe rotation angle of the instance
image_indexRealThe image index used by the instance
image_speedRealThe image speed of the instance
colourColourThe blend colour used to draw the instance
creation_codeScript FunctionThe index of the script function that contains the instance's creation code
pre_creation_codeScript FunctionThe index of the script function that holds the pre-creation code for this specific instance, i.e. the overrides for its Object Variables as set in the Room Editor.
+
+

Layer Info

+
+

This type of struct represents one layer in the room.

+

These structs are found in the layers array, which is part of the main struct returned by the function.

+ + - - - + + + - - + + - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Layer Info Struct
ArgumentTypeVariable NameData Type Description
roomRoom AssetThe room to get the info fromidRealThe layer handle
nameStringThe name of the layer
visibleBooleanWhether the layer is visible
depthRealThe depth of the layer
xoffsetRealThe x offset of the layer
yoffsetRealThe y offset of the layer
hspeedRealThe horizontal speed of the layer
vspeedRealThe vertical speed of the layer
effectEnabledBooleanWhether the layer filter/effect is currently enabled
effectToBeEnabledBooleanWhether the layer filter/effect should be enabled/disabled in the next frame (the next value of effectEnabled)
effectFX StructA struct containing the effect's parameters (-1 if no layer effect is set)
shaderIDShader AssetThe shader to be applied to the layer (layer_shader)
elementsArray of Room Layer Element Info StructAn array listing all elements on the layer. Each element type struct contains information specific to it.
+
+

View Info

+
+

This type of struct represents one view in the room.

+

These structs are found in the views array, which is part of the main struct returned by the function.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
View Info Struct
Variable NameData TypeDescription
visibleBooleanWhether the view is visible
cameraIDCamera IDThe camera assigned to this view
xviewRealThe x coordinate of the view camera's position
yviewRealThe y coordinate of the view camera's position
wviewRealThe width of the view's camera
hviewRealThe height of the view's camera
hspeedRealThe horizontal movement speed of the view
vspeedRealThe vertical movement speed of the view
xportRealThe x position on screen where the view is drawn
yportRealThe y position on screen where the view is drawn
wportRealThe width of the viewport
hportRealThe height of the viewport
objectObject AssetThe object of which the first instance in the room should be followed by the camera
hborderRealThe horizontal border around the instance of the object to follow
vborderRealThe vertical border around the instance of the object to follow
+
+

Layer Element Info

+
+

This type of struct represents one element in a layer.

+

These structs are found in the elements array, which is part of a layer struct.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - + + + - - - + + + - - - + + + - - - + + + - - - + + +
Layer Element Info Struct
Variable NameData TypeDescription
All Element Types
idRealThe unique ID of the element
typeLayer Element Type ConstantThe type of element
Background Element Type
sprite_indexSprite AssetThe sprite used by the background
image_indexRealThe sprite's subimage
xscaleRealThe scale along the x axis
yscaleRealThe scale along the y axis
htiledBooleanWhether to tile the background image horizontally
vtiledBooleanWhether to tile the background image vertically
stretchBooleanWhether to stretch the background so it fills the entire room
visibleBooleanWhether the background should be visible
blendColourColourThe blend colour to draw the background with
blendAlphaRealThe alpha value between 0 and 1 to use
image_speedRealThe image speed of the background
speed_typeSprite Speed ConstantThe units in which image_speed is expressed, either spritespeed_framespersecond or spritespeed_framespergameframe
nameStringThe name of the background
Instance Element Type
inst_idObject InstanceThe ID of the instance
Sprite Element Type
sprite_indexSprite AssetThe sprite index of this sprite element
image_indexRealThe subimage of the sprite
xRealThe x coordinate of the sprite's position
yRealThe y coordinate of the sprite's position
image_xscaleRealThe scale of the image along the x axis
image_yscaleRealThe scale of the image along the y axis
image_angleRealThe image angle
image_alphaRealThe alpha value between 0 and 1
image_blendColourThe blend colour
image_speedRealThe animation speed of the image, expressed in speed_type units
speed_typeSprite Speed ConstantThe units in which image_speed is expressed, either spritespeed_framespersecond or spritespeed_framespergameframe
nameStringThe name of the sprite element as given in The Room Editor (default is graphic_*)
Tile Map Element Type
xRealThe x position (or offset) of the tile map in the room
yRealThe y position (or offset) of the tile map in the room
tileset_indexTile Set AssetThe tile set that this tile map uses
data_maskRealThe bitmask value for the tile map
tilesArray of RealThis variable is only present when the tilemap_data parameter is set to true. It is a one-dimensional array that contains all the tile map data, listed row by row.
widthRealThe width in cells of the tile map
heightRealThe height in cells of the tile map
nameStringThe tile map's name
Particle System Element Type
psParticle System AssetThe particle system
xRealThe x coordinate of the particle system's position
yRealThe y coordinate of the particle system's position
angleRealThe angle by which the particle system is rotated
xscaleRealThe scale along the x axis of the particle system
yscaleRealThe scale along the y axis of the particle system
blendColourThe blend colour to use to draw the particle system
alphaRealThe alpha value between 0 and 1 to use
nameStringThe name of the particle system element as defined in The Room Editor (default is particle_*)
Tile Element Type
visibleBooleanWhether the tile is visible
sprite_indexSprite AssetThe sprite this tile is on
xRealThe x coordinate of the tile position
yRealThe y coordinate of the tile position
widthRealThe width of the tile
heightRealThe height of the tile
image_xscaleRealThe scale factor along the x axis of the tile
image_yscaleRealThe scale factor along the y axis of the tile
image_angleRealThe angle of the tile
image_blendColourThe blend colour to use to draw the tile
image_alphaRealThe alpha to use
xoRealThe x offset
yoRealThe y offset
Sequence Element Type
xRealThe x coordinate of the sequence position
yRealThe y coordinate of the sequence position
image_xscaleRealThe scale along the x axis of the entire sequence
image_yscaleRealThe scale along the y axis of the entire sequence
image_angleRealThe angle by which the sequence is rotated
image_alphaRealThe alpha value between 0 and 1 to use
image_blendColourThe blend colour to use to draw the sequence
viewsBoolean Whether to include view information in the struct (defaults to true)image_speedRealThe animation speed of the sequence, expressed in speed_type units
instancesBoolean Whether to include instance information in the struct (defaults to true)speedTypeSprite Speed ConstantThe units in which image_speed is expressed, either spritespeed_framespersecond or spritespeed_framespergameframe
layersBoolean Whether to include layer information in the struct (defaults to true)seq_idSequence AssetThe sequence asset
layer_elementsBoolean Whether to include layer element information in the struct (defaults to true, requires layers to be set to true)nameStringThe name of the sequence element as defined in The Room Editor (default is graphic_*)
tilemap_dataBoolean Whether to include tile map data in the struct (defaults to true, requires layers and layer_elements to be set to true)head_positionRealThe playhead position of the sequence
-

-

Returns:

-

Room Info Struct

-

-

Example:

-

var _info = room_get_info(Room1); -
- var _info_json = json_stringify(_info, true); -
- show_debug_message(_info_json);

-

The above code gets the information of the room Room1, converts the returned struct to a JSON string using json_stringify, then outputs it in a debug message. All view, instance, layer, layer element and tile map information is included in the output.

-

-

-
-
-
-
Back: Rooms
-
Next: room_goto
-
+
+

 

+

Syntax:

+

room_get_info(room, [views], [instances], [layers], [layer_elements], [tilemap_data]);

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ArgumentTypeDescription
roomRoom AssetThe room to get the info from
viewsBoolean Whether to include view information in the struct (defaults to true)
instancesBoolean Whether to include instance information in the struct (defaults to true)
layersBoolean Whether to include layer information in the struct (defaults to true)
layer_elementsBoolean Whether to include layer element information in the struct (defaults to true, requires layers to be set to true)
tilemap_dataBoolean Whether to include tile map data in the struct (defaults to true, requires layers and layer_elements to be set to true)
+

 

+

Returns:

+

Room Info Struct

+

 

+

Example:

+

var _info = room_get_info(Room1);
+ var _info_json = json_stringify(_info, true);
+ show_debug_message(_info_json);

+

The above code gets the information of the room Room1, converts the returned struct to a JSON string using json_stringify, then outputs it in a debug message. All view, instance, layer, layer element and tile map information is included in the output.

+

 

+

 

+
+
+
+
Back: Rooms
+
Next: room_goto
-
© Copyright YoYo Games Ltd. 2023 All Rights Reserved
- + +--> + \ No newline at end of file diff --git a/Manual/contents/The_Asset_Editors/Object_Properties/Event_Order.htm b/Manual/contents/The_Asset_Editors/Object_Properties/Event_Order.htm index 6d252dc6..0ebb2eea 100644 --- a/Manual/contents/The_Asset_Editors/Object_Properties/Event_Order.htm +++ b/Manual/contents/The_Asset_Editors/Object_Properties/Event_Order.htm @@ -21,9 +21,9 @@

Upon Entering a Room

  • All instances are created one after the other, according to the room's Instance Creation Order. More specifically, for every instance: 

     You can also set the order in which specific instances are created within The Room Editor itself by moving them up or down the list of the Instance Layer Properties window.

    Every Step/Frame

    -

    Other than those specific events, events in a game step also always occur in the same order. However, the order of the instances within an event is not always guaranteed, and may vary between different GameMaker versions and target platforms.

    +

    Other than those specific events, events in a game step also always occur in the same order. However, the order of the instances within an event is not always guaranteed, and may vary between different Event Order versions and target platforms.

    As a general rule, you can rely on the order of the events listed below, but not on the order in which the instances in the room execute one event.

    For example, you will see below that the "Step" event always executes after the "Begin Step" event, however you cannot guarantee that, for example, Object2 will always execute its Step event after Object1. If you require such an execution order, then making use of a different event is recommended (e.g. putting Object2's Step code in End Step, if you need it to execute after Object1's Step).

    So when you have code that relies on specific timing during each step of your game, make use of the events as listed below. To put it simply, first all Begin Step events are executed, then all Step events are executed, after that all End Step events are executed, then all Draw events, etc.

    diff --git a/Manual/contents/The_Asset_Editors/Object_Properties/Object_Variables.htm b/Manual/contents/The_Asset_Editors/Object_Properties/Object_Variables.htm index 5b9f0728..7cd9a54a 100644 --- a/Manual/contents/The_Asset_Editors/Object_Properties/Object_Variables.htm +++ b/Manual/contents/The_Asset_Editors/Object_Properties/Object_Variables.htm @@ -16,42 +16,49 @@

    Object Variables

    When you click on the Variable Definitions button it will open up the Object Variables window, which you can then use to generate any number of variables before the Create Event is run for every new instance of the object: 

    -

    Object Editor Variables WindowIn this window you can click on the button Add to add a new variable to the list. You can then name the variable as well as set its type and adjust its properties:

    -

    Object Editor New VariableThe variable name must start with a letter and can contain only letters, numbers, and the underscore symbol '_' with a maximum length of 64 symbols. So, valid variables are things like fish, foo_bar, num1, and invalid variables would be 6fish, foo bar, or *num. Once you have given the name of the variable you need to set its type, which can be any of the following:Object Editor Variable TypesIt is worth noting that this feature is particularly useful when working with parent/child instances - since you can have a parent object with a set of defined variables and then simply modify them in child object (see the section Object Variables And Child Objects below for more details) - and for when you add instances into The Room Editor (see the section on Layers > Instance Layer), since you can also modify these variables for individual instances that have been placed in the room.

    +

    Object Editor Variables WindowIn this window you can click on the button Add to add a new variable to the list. You can then name the variable as well as set its type and adjust its properties:

    +

    Object Editor New VariableThe variable name must start with a letter and can contain only letters, numbers, and the underscore symbol _ with a maximum length of 64 symbols. So, valid variables are things like fish, foo_bar, num1, and invalid variables would be 6fish, foo bar, or *num. Once you have given the name of the variable you need to set its type, which can be any of the following:Object Editor Variable TypesIt is worth noting that this feature is particularly useful when working with parent/child objects - since you can have a parent object with a set of defined variables and then simply modify them in a child object (see the section Object Variables And Child Objects below for more details) - and for when you add instances to The Room Editor (see the section on Layers > Instance Layer), since you can also modify these variables for individual instances that have been placed in the room.

    The different types of variable that you can create are listed below:

      -
    • Real: A real number is any number that is not a whole integer and can be positive or negative. So, 124.5, 45639.566546456, 0.9, -45.5 etc... are all examples of real numbers. All real numbers are stored as 64bit floating point values (doubles). The real (and integer) data types have an option for setting a range of values which can be accessed by clicking the Options Variable Options Icon button:Object Editor Real Variable OptionsWhen you check this you can then input a start value and an end value and instead of having a fixed value shown for the variable in the Object Variables window, you will have a slider that is clamped to these values:
      +
    • Real: A real number is any number that is not a whole integer and can be positive or negative. So, 124.5, 45639.566546456, 0.9, -45.5, etc., are all examples of real numbers. All real numbers are stored as 64bit floating point values (doubles). The real (and integer) data types have an option for setting a range of values which can be accessed by clicking the Options Variable Options Icon button:Object Editor Real Variable OptionsWhen you check this you can then input a start value and an end value and instead of having a fixed value shown for the variable in the Object Variables window, you will have a slider that is clamped to these values:
      Object Editor Variable Range
      • -
    • Integer: An integer is a whole number and can be positive or negative, for example 30004, 19, 0, -300. Note that you can set a range of values for the output integer, as explained above for real numbers.
      • +
    • Integer: An integer is a whole number and can be positive or negative, for example 30004, 19, 0, -300. Note that you can set a range of values for the output integer, as explained above for real numbers.
    • String: A string is anything that has been placed within double quotation marks, for example "fish", "Hello World", or "12345".
      • -
    • Boolean: A boolean is a value that is either true or false. In the Object Editor Variables window, this is simply shown as a box that you check for true and uncheck for false.
      • -
    • Expression: An expression is a mathematical phrase that can contain ordinary numbers, variables, strings, or GML Code functions as well as one or more operators. For example sqrt(85 * 6) + 5.5 is an expression.
      • -
    • Resource: A resource is simply any one of the resources that you have defined in the Asset Browser. When you select this resource type, you can then click on the Open Asset Explorer Open Asset Explorer Icon button to open the Asset Explorer and select the resource you require.
      • +
    • Boolean: A boolean is a value that is either true or false. In the Object Variables window, this is simply shown as a box that you check for true and uncheck for false.
      • +
    • Expression: An expression is a mathematical phrase that can contain ordinary numbers, variables, strings, or GML Code functions as well as one or more operators. For example sqrt(85 * 6) + 5.5 is an expression.
      • +
    • Asset: An asset is simply any one of the assets that you have defined in The Asset Browser. When you select this variable type, you can then click on the Open Asset Explorer Open Asset Explorer Icon button to open the Asset Explorer and select the asset you require. You can filter the list of assets by selecting only the desired asset types in the Options Variable Options Icon.
    • List: Selecting a list type of input means that you can then create a selection of values (these can be strings, reals, expressions  etc.) of which you can then choose one or more for the variable to return. To define the items that go in the list you need to add them into the Options first (click the Variable Options Icon button):
      List OptionsYou will be able to choose the item as the default value for the variable in the main window from the drop down menu:
      Object Editor List MenuNote that if you have Multi-select ticked in the List Options then the variable will become an array of all the selected options:
      List Array Options
      • -
    • Colour: The colour type is for you to define a colour value to be stored in the variable. You can input a real number (from 0 to 16777216, this will have an alpha value of 255), or a hex value (in the format of $RRGGBBAA), or you can double click LMB Icon on the colour swatch to open the Colour Picker and define the colour there.
      • +
    • Colour: The colour type is for you to define a colour value to be stored in the variable. You can input a real number (from 0 to 16777216, this will have an alpha value of 255), or a hex value (in the format of $RRGGBBAA), or you can double click LMB Icon on the colour swatch to open the Colour Picker and define the colour there.
    -

     

    -

     

    -

    Object Variables And Child Objects

    -

    An important feature of the Object Variables is that they are inherited by any child objects that you have in the Asset Browser (see the section on Parent Objects for more information), which means that you can then choose to override or change any or all of them if you wish.

    -

    When you create a child object of another object resource that has Variables defined for it, these will show up in the Object Variables window like this:

    -

    Object Editor Variable In A Child ObjectYou can see in the top image that the Parent object has four Object Variables and in the bottom image these are also shown, only "greyed out" and have the Inherited From Parent Inherited From Parent Icon icon to indicate that they have been inherited. These inherited variables can then be edited if you click the Override Variable Override Variable Icon button, so you can then adjust the range slider or values, or select different items from lists, etc... Note that when you edit a parent variable you can only change the defined value but not the name, nor can you change the variable options. Also note that you can add in new Object Variables to child objects as well (and in the example image above you can see that "Character Type" is a new Object Variable only for the child object).

    +

    Object Variables And Child Objects

    +

    An important feature of the Object Variables is that they are inherited by any child objects that you have in the Asset Browser (see the section on Parent Objects for more information), which means that you can then choose to override or change any or all of them if you wish.

    +

    When you create a child object of another object asset that has variables defined for it, these will show up in the Object Variables window like this:

    +

    Object Editor Variable In A Child ObjectYou can see in the top image that the Parent object has four Object Variables and in the bottom image these are also shown, only "greyed out" and have the Inherited From Parent Inherited From Parent Icon icon to indicate that they have been inherited. These inherited variables can then be edited if you click the Override Variable Override Variable Icon button, so you can then adjust the range slider or values, or select different items from lists, etc. Note that when you edit a parent variable you can only change the defined value but not the name, nor can you change the variable options. Also note that you can add in new Object Variables to child objects as well (and in the example image above you can see that "Character Type" is a new Object Variable only for the child object).

    If you have edited an inherited Object Variable, then you can click the Delete Delete Variable Icon button to remove the edit, but not the variable. The variable will still be inherited from the parent, but will use the parent default value again. If you need to completely remove the variable, then you must do this from the parent object.

    +

    Pre-creation Code

    +

    Pre-creation code is any code generated by the compiler to initialise object variables. This includes the variables that you override in an instance added to the Room Editor. It runs before the Create event and before the variables in the var_struct are assigned (when using instance_create_depth or instance_create_layer). The pre-creation code for variables that you override in the Room Editor can be found in the struct returned by room_get_info.

    +

    This makes the order of variable initialisation in an instance as follows:

    +
      +
    1. The pre-creation code runs for the new instance, assigning it the variables set in the Variable Definitions.
      2. +
    2. The pre-creation code generated for instances added to the room in the Room Editor runs.
      3. +
    3. The variables in the var_struct are assigned.
      4. +
    4. The Create event runs for the instance.
      5. +

     

     

    - +
    -
    © Copyright YoYo Games Ltd. 2023 All Rights Reserved
    +
    © Copyright YoYo Games Ltd. 2024 All Rights Reserved
    -

    iOS / tvOS Extensions

    +

    iOS / tvOS Extensions

    To create an extension for iOS or tvOS you have to do it in two parts. The first part would be to add the extension itself, along with the required files, and the second is to create the functions and macros/constants that the extension requires.

    The functions and constants are added using placeholder files to group them together, so you'd add a placeholder and then define the functions and macros as explained in the section here. To add the rest of the files though you need to first tick the iOS and/or the tvOS check-box in the Additional Features section of the editor to open up the relevant Extension Properties window (the image below shows the iOS properties window, but the tvOS window is exactly the same):

    iOS Editor

    @@ -69,6 +69,8 @@

    Code Injection

    YYIosCFBundleURLSchemesArray
    YYIosLSApplicationQueriesSchemesArray
    YYIosPrivacyManifest
    + YYIosLaunchActionCommandLineArguments
    + YYIosBridgeHeader

    YYTvosPlist
    YYTvosEntitlements
    @@ -124,7 +126,7 @@

    Code Injection

    -

    NOTE These paths are only for VM. For YYC, injected code will go into the {RUNTIME}\yyc\ directory, where the paths may or may not be equivalent to those for VM.

    +

     These paths are only for VM. For YYC, injected code will go into the {RUNTIME}\yyc\ directory, where the paths may or may not be equivalent to those for VM.

    You can also inject tags conditionally. See: Conditional Injection

    Injecting Values

    You can insert various values into your injected code. This follows the ${NAME} syntax, where NAME can be any of the following:

    From f379163f2b8d37f4f77fbbf0b92c24f15de459f1 Mon Sep 17 00:00:00 2001 From: YYBartT Date: Tue, 19 Nov 2024 21:59:58 +0100 Subject: [PATCH 18/27] docs(feature): array functions clamp offset to upper bound, string_delete() negative offset & length YoYoGames/GameMaker-Bugs#7917 YoYoGames/GameMaker-Bugs#2785 * Added an item under "offset" on the Array Functions page to indicate it is clamped * Documented negative index and count for string_delete(), which was missing there (original ticket linked above) --- .../GML_Reference/Strings/string_delete.htm | 33 +++++++++++-------- .../Variable_Functions/Array_Functions.htm | 3 +- 2 files changed, 22 insertions(+), 14 deletions(-) diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Strings/string_delete.htm b/Manual/contents/GameMaker_Language/GML_Reference/Strings/string_delete.htm index 720905d6..f975844a 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Strings/string_delete.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Strings/string_delete.htm @@ -4,7 +4,7 @@ string_delete - + @@ -19,7 +19,7 @@

    string_delete

    This function is used to remove a part of the given string. You supply the input string, the starting position within that string to remove characters from (the index starts at 1) and the number of characters to remove. The function will return a new string without that part in it.

     

    Syntax:

    -

    string_delete(str, index, count);

    +

    string_delete(str, index, count);

    @@ -29,30 +29,37 @@

    Syntax:

    - + - - + + - - + +
    strStringString The string to copy and delete from.
    indexRealThe position of the first character to remove (from 1).RealThe position of the first character to remove (from 1). Negative indices are supported and count from the end of the string, e.g. -1 indicates the last character.
    countRealThe number of characters to remove.RealThe number of characters to remove. A negative number means characters are deleted backwards. For example, -4 indicates the character at index and the 3 characters in front of it will be deleted.

     

    Returns:

    -

    String

    +

    String

     

    -

    Example:

    -

    str1 = "Helloo World";
    - str2 = string_delete(str1, 5, 1);

    -

    This will set str2 to "Hello World", as it removes the extra "o" from "Hello" (which is present at position 5).

    +

    Example 1: Basic Use

    +

    str = "Helloo World";
    + str = string_delete(str, 5, 1);

    +

    This will set str to "Hello World", as it removes the extra "o" from "Hello" (which is present at position 5).

     

    +

    Example 2: Negative Index and Count

    +

    str = "One, two, three, four!";
    +
    + str = string_delete(str, -2, -6);
    + show_debug_message(str); +

    +

    This will set str to "One, two, three!", since the call to string_delete removes the word "four" as well as the space and comma characters in front of it (a total of 6 characters starting at the one before last character).

     

     

    @@ -62,7 +69,7 @@

    Example:

-
© Copyright YoYo Games Ltd. 2022 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
-

sprite_get_bbox_bottom

-

This function returns the relative position of the bottom of the sprite bounding box. This value is given as a relative value based on the upper left corner of the base sprite asset being (0,0). it is the same value as can be found in the sprite editor - for the collision mask properties. The image below shows how it is calculated:

+

sprite_get_bbox_bottom

+

This function returns the relative position of the bottom of the sprite bounding box.

+

This value is given as a relative value based on the upper left corner of the base sprite asset being (0, 0). it is the same value as can be found in the Sprite Editor for the collision mask properties. The image below shows how it is calculated:

BBox Example

Syntax:

-

sprite_get_bbox_bottom(ind);

+

sprite_get_bbox_bottom(ind);

- + + - + - + + - +
ArgumentTypeArgumentType Description
indindSprite Asset The index of the sprite to check.

 

Returns

-

+

Real

 

Example:

-

var ww, hh;
ww = sprite_get_bbox_left(sprite_index) - sprite_get_bbox_right(sprite_index);
hh = sprite_get_bbox_bottom(sprite_index) - sprite_get_bbox_top(sprite_index);

-

The above code calculates the width and height of the collision mask based on the relative bounding box side positions.

-

 

+

 

 

- - + +
-
© Copyright YoYo Games Ltd. 2021 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
-

sprite_get_bbox_left

-

This function returns the relative position of the left of the sprite bounding box. This value is given as a relative value based on the upper left corner of the base sprite asset being (0,0). it is the same value as can be found in the sprite editor - for the collision mask properties. The image below shows how it is calculated:

+

sprite_get_bbox_left

+

This function returns the relative position of the left of the sprite bounding box.

+

The value is given as a relative value based on the upper left corner of the base sprite asset being (0, 0). it is the same value as can be found in the Sprite Editor for the collision mask properties. The image below shows how it is calculated:

BBox Example

Syntax:

-

sprite_get_bbox_left(ind);

+

sprite_get_bbox_left(ind);

- + + - + - + + - +
ArgumentTypeArgumentType Description
indindSprite Asset The index of the sprite to check.

 

Returns

-

+

Real

 

Example:

-

var ww, hh;
ww = sprite_get_bbox_left(sprite_index) - sprite_get_bbox_right(sprite_index);
hh = sprite_get_bbox_bottom(sprite_index) - sprite_get_bbox_top(sprite_index);

-

The above code calculates the width and height of the collision mask based on the relative bounding box side positions.

-

 

+

 

 

- - + +
-
© Copyright YoYo Games Ltd. 2021 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
-

sprite_get_bbox_mode

+

sprite_get_bbox_mode

This function will return the current "mode" for the bounding box calculations. You supply the sprite index of the sprite to check, and the function will return one of the constants shown below.

 

Syntax:

-

sprite_get_bbox_mode(ind);

+

sprite_get_bbox_mode(ind);

- + + - + - + + - +
ArgumentTypeArgumentType Description
indindSprite Asset The index of the sprite to check.

 

Returns

-

Bounding Box Mode Constant

+

Bounding Box Mode Constant

@@ -51,28 +53,27 @@

Returns

- +
bboxmode_manualManual - The bounding box has been set manually to user defined values (either in the sprite editor, or using the function sprite_set_bbox())Manual - The bounding box has been set manually to user-defined values (either in the Sprite Editor, or using the function sprite_set_bbox)

 

Example:

-

if (sprite_get_bbox_mode(sprite_index) != 0)
+

if (sprite_get_bbox_mode(sprite_index) != 0)
{
    sprite_set_bbox_mode(sprite_index, bboxmode_automatic);
}

-

The above checks the bbox mode for the current sprite and if it's not automatic, then it is sets it to that value.

-

 

+

The above checks the bbox mode for the current sprite and, if it's not automatic, sets it to that value.

 

 

- - + +
-
© Copyright YoYo Games Ltd. 2022 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
-

sprite_get_bbox_right

-

This function returns the relative position of the right of the sprite bounding box. This value is given as a relative value based on the upper left corner of the base sprite asset being (0,0). it is the same value as can be found in the sprite editor - for the collision mask properties. The image below shows how it is calculated:

+

sprite_get_bbox_right

+

This function returns the relative position of the right of the sprite bounding box.

+

This value is given as a relative value based on the upper left corner of the base sprite asset being (0, 0). it is the same value as can be found in the Sprite Editor for the collision mask properties. The image below shows how it is calculated:

BBox Example

Syntax:

-

sprite_get_bbox_right(ind);

+

sprite_get_bbox_right(ind);

- + + - + - + + - +
ArgumentTypeArgumentType Description
indindSprite Asset The index of the sprite to check.

 

Returns

-

+

Real

 

Example:

-

var ww, hh;
ww = sprite_get_bbox_left(sprite_index) - sprite_get_bbox_right(sprite_index);
hh = sprite_get_bbox_bottom(sprite_index) - sprite_get_bbox_top(sprite_index);

+

var _ww, _hh;
+ _ww = sprite_get_bbox_right(sprite_index) - sprite_get_bbox_left(sprite_index);
+ _hh = sprite_get_bbox_bottom(sprite_index) - sprite_get_bbox_top(sprite_index);

The above code calculates the width and height of the collision mask based on the relative bounding box side positions.

 

 

-

 

- - + +
-
© Copyright YoYo Games Ltd. 2021 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
-

sprite_get_bbox_top

-

This function returns the relative position of the top of the sprite bounding box. This value is given as a relative value based on the upper left corner of the base sprite asset being (0,0). it is the same value as can be found in the sprite editor - for the collision mask properties. The image below shows how it is calculated:

+

sprite_get_bbox_top

+

This function returns the relative position of the top of the sprite bounding box.

+

This value is given as a relative value based on the upper left corner of the base sprite asset being (0, 0). it is the same value as can be found in the Sprite Editor for the collision mask properties. The image below shows how it is calculated:

BBox Example

 

Syntax:

-

sprite_get_bbox_top(ind);

+

sprite_get_bbox_top(ind);

- + + - + - + + - +
ArgumentTypeArgumentType Description
indindSprite Asset The index of the sprite to check.

 

Returns

-

+

Real

 

Example:

-

var ww, hh;
ww = sprite_get_bbox_left(sprite_index) - sprite_get_bbox_right(sprite_index);
hh = sprite_get_bbox_bottom(sprite_index) - sprite_get_bbox_top(sprite_index);

-

The above code calculates the width and height of the collision mask based on the relative bounding box side positions.

-

 

+

 

 

- - + +
-
© Copyright YoYo Games Ltd. 2021 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved
+ +--> + \ No newline at end of file diff --git a/Manual/variable/Default.var b/Manual/variable/Default.var index bd10fd36..3c003224 100644 --- a/Manual/variable/Default.var +++ b/Manual/variable/Default.var @@ -1446,7 +1446,7 @@ - <a target="_blank" href="contents/GameMaker_Language/GML_Reference/Drawing/Particles/Particle_Emitters/part_emitter_create.htm">Particle Emitter ID</a> + <a target="_blank" href="contents/GameMaker_Language/GML_Reference/Drawing/Particles/Particle_Emitters/part_emitter_create.htm">Particle Emitter</a> @@ -1460,7 +1460,7 @@ - <a target="_blank" href="contents/GameMaker_Language/GML_Reference/Drawing/Particles/Particle_Types/part_type_create.htm">Particle Type ID</a> + <a target="_blank" href="contents/GameMaker_Language/GML_Reference/Drawing/Particles/Particle_Types/part_type_create.htm">Particle Type</a> From 1fbb34d307d1db938aac6dc8d1fe91228c48ac13 Mon Sep 17 00:00:00 2001 From: YYBartT Date: Wed, 20 Nov 2024 21:40:21 +0100 Subject: [PATCH 27/27] docs(general): Incorrect Manual entry note for network_send_broadcast YoYoGames/GameMaker-Manual#196 * Changed "TCP" -> "UDP" * Minor other changes --- .../Networking/network_send_broadcast.htm | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Networking/network_send_broadcast.htm b/Manual/contents/GameMaker_Language/GML_Reference/Networking/network_send_broadcast.htm index deafbe3b..8dedac5c 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Networking/network_send_broadcast.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Networking/network_send_broadcast.htm @@ -15,9 +15,9 @@

network_send_broadcast

-

This function broadcasts the data from a buffer locally to a range of IP addresses (for more information on buffers see Reference - Buffers).

+

This function broadcasts the data from a buffer locally to a range of IP addresses (for more information on buffers see Buffers).

The range is limited to that of the device running the server, such that if the device has an IP of 92.168.11.130, then the data will be broadcast over the range 92.168.11.*. The function will return the number of bytes of data sent, or a number less than 0 if the send has failed.

-

 This function will only work when used with UDP - your server needs to be TCP and your client needs to have a UDP client socket created with network_create_socket_ext in order to receive any broadcasts sent from the server.

+

 This function will only work when used with UDP - your server needs to be UDP and your client needs to have a UDP client socket created with network_create_socket_ext in order to receive any broadcasts sent from the server.

 This function will not work when used in a project running on the HTML5 target.

Syntax:

@@ -32,7 +32,7 @@

Syntax:

socket Network Socket ID - The id of the socket to use. + The ID of the socket to use. port @@ -57,9 +57,9 @@

Returns:

 

Example:

buffer_seek(broadcast_buffer, buffer_seek_start, 0);
- buffer_write(broadcast_buffer, buffer_string, global.ServerName);
+ buffer_write(broadcast_buffer, buffer_string, global.server_name);
network_send_broadcast(server, 6511, broadcast_buffer, buffer_tell(broadcast_buffer));

-

The above code writes the name string of the current server (stored in global.ServerName), then writes it to a buffer stored in broadcast_buffer. This data is then broadcast locally to a range of IPs (the device IP is currently implied as the broadcast base range) to port 6511.

+

The above code writes the name string of the current server (stored in global.server_name), then writes it to a buffer stored in broadcast_buffer. This data is then broadcast locally to a range of IPs (the device IP is currently implied as the broadcast base range) to port 6511.

 

 

@@ -69,7 +69,7 @@

Example:

-
© Copyright YoYo Games Ltd. 2023 All Rights Reserved
+
© Copyright YoYo Games Ltd. 2024 All Rights Reserved