Have you ever wanted to automatically show file+line in your debug output so that you don't have to guess which of three places did a line reading "oh no" come out?
Classic
This works in any GM version released after 2020 or so:
function trace() { var _msg = debug_get_callstack(2)[1] + ":"; for (var _argi = 0; _argi < argument_count; _argi++) { _msg += " " + string(argument[_argi]); } show_debug_message(_msg); }
If you have scr_test
that has the following inside,
function scr_test() { scr_test_trace(); } function scr_test_trace() { trace("hey hey", 1, 2); }
the output will be:
gml_Script_scr_test_trace:5: hey hey 1 2
Instead of the file name you have a script name, but that works.
Macros (GM2023+ / LTS2024+)
Recent versions of GameMaker introduced _GMFILE_
and _GMLINE_
macros
that expand to point at their use location at compile.
So, if we did
show_debug_message(_GMFILE_ + ":" + string(_GMLINE_) + ": " + string(value) )
that would get us the same file:line: message
format that debug_get_callstack
did.
The macros cannot be inside the trace
function because then they'll just point at it instead,
but writing all of that by hand doesn't sound very exciting, does it?
Fortunately, these macros are allowed inside user-created macros, so you could do something like
#macro TP _GMFILE_ + ":" + string(_GMLINE_) + ":" show_debug_message(TP + "hello!");
and that would work, but can we do better?
Macros don't have to be "complete" expressions or statements, so we can do something like this:
#macro trace global.__trace_p = _GMFILE_ + ":" + string(_GMLINE_) + ":"; __trace
and define a __trace
function that reads that variable instead of calling debug_get_callstack
. This way, when you do
trace("hi!");
it will expand into
global.__trace_p = "scr_test:2:"; __trace("hi!");
and all will be well.
But there's a certain caveat: if you were to do
if (DEBUG) trace(x, y);
this would still expand "literally", becoming
if (DEBUG) global.__trace_p = "scr_test:2:"; __trace(x, y);
and thus escaping the condition.
The simplest workaround I could think of is to use a single-step for-loop, like so:
for (global.__trace_p = ...; ; break) ...
And thus the combined code is:
#macro trace for (global.__trace_p = _GMFILE_ + ":" + string(_GMLINE_) + ":";;break) __trace function __trace() { var _msg = global.__trace_p; for (var _argi = 0; _argi < argument_count; _argi++) { _msg += " " + string(argument[_argi]); } show_debug_message(_msg); }
2023.8 edition
If you're getting a @@FILENAME@@
instead of the usual location,
you must be using one of several GameMaker runtime versions
that have a bug with constant propagation
(_GMFILE_
is OK, _GMFILE_ + ":"
is not).
Here's a version of the script that avoids this problem by passing file/line as separate arguments to a function:
#macro trace repeat (__trace_1(_GMFILE_, ":" + string(_GMLINE_) + ":")) __trace function __trace_1(_file, _line) { global.__trace_p = _file + _line; return 1; } function __trace() { var _msg = global.__trace_p; for (var _argi = 0; _argi < argument_count; _argi++) { _msg += " " + string(argument[_argi]); } show_debug_message(_msg); }
Shout out to Red for suggesting to use repeat
instead of a for
,
which looks a little nicer but probably doesn't change anything.
Cool Buffer Edition
Should a debug output script be optimized? I guess it doesn't hurt to.
#macro trace repeat (__trace_pre(_GMFILE_, ":" + string(_GMLINE_) + ":")) __trace global.__trace_buf = -1; global.__trace_map = -1; function __trace_pre(_file, _line) { var _buf = global.__trace_buf; if (_buf == -1) { _buf = buffer_create(1024, buffer_grow, 1); global.__trace_buf = _buf; global.__trace_map = ds_map_create(); } else buffer_seek(_buf, buffer_seek_start, 0); var _pre = global.__trace_map[?_file]; if (_pre == undefined) { _pre = __trace_parse(_file); global.__trace_map[?_file] = _pre; } buffer_write(_buf, buffer_text, _pre); buffer_write(_buf, buffer_text, _line); return 1; } function __trace() { var _buf = global.__trace_buf; for (var i = 0; i < argument_count; i++) { buffer_write(_buf, buffer_u8, ord(" ")); buffer_write(_buf, buffer_text, string(argument[i])); } buffer_write(_buf, buffer_u8, 0); buffer_seek(_buf, buffer_seek_start, 0); show_debug_message(buffer_read(_buf, buffer_string)); } function __trace_parse(_file) { if (string_starts_with(_file, "gml_GlobalScript_")) { return string_delete(_file, 1, 17); } if (string_starts_with(_file, "gml_Object_")) { return string_delete(_file, 1, 11); } return _file; }
Another addition here is that the script will auto-trim the script/object prefixes in names.
And that's about it!