Warning

You are viewing the readme for the master branch, which may contain unreleased features. For a specific version, please select the corresponding tag.

GaseousMarble

Draw Unicode texts in GameMaker 8.2, 90% faster than FoxWriting, with more features.

Functions

Function	Description	Returned Value
gm_font(font_name, sprite_path)	Add a font generated by tools/generate_font.py.	1 - Font already exists 0 - OK -1 - Failed to open file -2 - Invalid header -3 - Data corrupted -4 - Failed to load sprite -100 - Invalid argument
gm_free(font_name)	Free a font.	1 - Font not found 0 - OK
gm_clear()	Free all fonts.	Always OK
gm_draw(x, y, str)	Draw a UTF-8 string.	0 - OK -1 - Failed to decode -2 - Failed to word break -3 - Invalid option
gm_width(str)	Return the width of the text.	>= 0 - Width -1 - Failed to decode -2 - Failed to word break -3 - Invalid option
gm_height(str)	Return the height of the text.	>= 0 - Height -1 - Failed to decode -2 - Failed to word break -3 - Invalid option

Setter	Getter	Returned Value
gm_set_font(font_name)	gm_get_font()	Setter 0 - OK -1 - Font not found Getter != "" - OK "" - Font unspecified
gm_set_halign(align) gm_set_valign(align) gm_set_justified(justified) gm_set_align(halign, valign) gm_set_align3(halign, valign, justified)	gm_get_halign() gm_get_valign() gm_is_justified()	Always OK
gm_set_color(color) gm_set_color2(color_top, color_bottom)	gm_get_color_top() gm_get_color_bottom()	Always OK
gm_set_alpha(alpha)	gm_get_alpha()	Always OK
gm_set_letter_spacing(spacing)	gm_get_letter_spacing()	Always OK
gm_set_word_spacing(spacing)	gm_get_word_spacing()	Always OK
gm_set_paragraph_spacing(spacing)	gm_get_paragraph_spacing()	Always OK
gm_set_line_height(height)	gm_get_line_height()	Always OK
gm_set_max_line_length(length)	gm_get_max_line_length()	Always OK
gm_set_offset(x, y)	gm_get_offset_x() gm_get_offset_y()	Always OK
gm_set_scale(x, y)	gm_get_scale_x() gm_get_scale_y()	Setter 0 - OK -1 - Invalid argument Getter Always OK
gm_set_rotation(theta)	gm_get_rotation()	Always OK

Development

1. Install Visual Studio 2026 and vcpkg.
2. vcpkg install wil:x86-windows.

Credits

Project	Reference
GMAPI	Data structures