GML-Extended v1.5.0 - The Compatibility Update!

Release Notes:

Compatibility!

As one fo the (probably) latest updates of the library, this library is now compatible with GameMaker versions from v2.3.7 to v2024.4 using the compatibility scripts that can be imported into the project!

Draw Profiles

You can now create draw profiles with custom properties, so everytime you need to use the same draw configurations, you can now just call a profile! i.e: When drawing texts maybe you have different fonts and colors defined for those fonts, like titles always on center and with color c_orange, so now instead of having to setup the draw functions to set color, alpha, font, align, and more, you can now just create a profile with draw_create_profile(), and the call the profile in your draw event with the function draw_set_profile(). More explaination in the documentation (Optional > Draw > draw_create_profile)

New Libraries

Compatibility

• Library contains scripts to make all the other functions compatible with older versions of GameMaker from 2.3.7!

Core > Types

• Library contains new functions to get and define types for your variables. Know more on the Types documentation!

Optional > GUI

• Library for some GUI manipulation and aspects. Contains some previously core shortcuts that weren’t used as often.

Experimental > Colors

• Moved some of the functions that weren’t working that well on previous versions to this library.

Experimental > Files

• New library with functions to manipulate .yy room files.

New functions

lib_datetime

• current_week(): Returns the current week of the year.
• current_day_of_the_year(): Returns the current day of the year.

lib_math

• percentage(): Return a percentage number from the given values.

lib_shortcuts -contains(): Checks if an element is inside a container.

lib_strings

• string_percentage(): Returns a string with the percentage of the given values.

lib_types

• New macros for gm_types.
• str(): Converts a value to string.
• int(): Converts a value to an int with no decimals.
• int8(): Coverts a value to an 8-bit int.
• int16(): Coverts a value to an 16-bit int.
• int8s(): Coverts a value to a signed 8-bit int.
• int16s(): Coverts a value to a a signed 16-bit int.
• is_type(): Checks if a value corresponds to a gm_type.

lib_draw

• New macros for current draw state.
• draw_surface_from_center(): Draw a surface from center x,y coordinates and can include rotation.
• draw_set_gui_scale(): Sets GUI draw scale.
• draw_set_blendmode(): Sets blendmode. It’s like a shortcut for gpu_set_blendmode() and gpu_set_blendmode_ext() functions.
• draw_reset_blendmode(): Resets blendmode to bm_normal.
• surface_clear(): Works as draw_clear_alpha() for surfaces.
• draw_set_depth(): Works as gpu_set_depth().
• draw_reset_depth(): Resets depth to object depth.
• draw_reset_alpha(): Resets alpha to 1.
• draw_reset_color(): Resets color to c_white.
• draw_create_profile(): Creates a draw profile to setup recurrent draw setup calls.
• draw_set_profile(): Sets a created profile.

lib_ease

• Library is no longer experimental and is now optional.
• Last 2 arguments changed from min, max to factor, so instead of defining min and max value, you just multiply it for a factor.

lib_images

• image_set(): Sets built-in variables from an image in one line.
• image_set_scale(): Set image xscale and yscale in one line.
• image_smooth_rotate(): Rotate the sprite smoothly to a direction given.

lib_layers

• New macros for layer element types to setup for future functions.

• layer_get_background(): A way to get the background of a layer using the ID or the name of the layer in one line.

• layer_get_tileset(): A way to get the tileset of a layer using the ID or the name of the layer in one line.

• And a lot more related to the experimental library on the docs!

Misc changes

• Some functions from library “Core > Shortcuts” were moved to new library “Optional > GUI”.
• Fixed @param definition for functions so feather shouldn’t give any new errors now.
• Added new demo rooms for draw events and easing.

Full Changelog: https://github.com/DAndrewBox/GML-Extended/compare/v1.3…v1.5.0