Work in progress

Godot documentation is being updated to reflect the latest changes in version 4.0. Some documentation pages may still state outdated information. This banner will tell you if you're reading one of such pages.

The contents of this page are up to date. If you can still find outdated information, please open an issue.

EngineDebugger

Inherits: Object

Exposes the internal debugger.

Description

EngineDebugger handles the communication between the editor and the running game. It is active in the running game. Messages can be sent/received through it. It also manages the profilers.

Methods

bool

has_capture ( StringName name )

bool

has_profiler ( StringName name )

bool

is_active ( )

bool

is_profiling ( StringName name )

void

profiler_add_frame_data ( StringName name, Array data )

void

profiler_enable ( StringName name, bool enable, Array arguments=[] )

void

register_message_capture ( StringName name, Callable callable )

void

register_profiler ( StringName name, EngineProfiler profiler )

void

send_message ( String message, Array data )

void

unregister_message_capture ( StringName name )

void

unregister_profiler ( StringName name )


Method Descriptions

bool has_capture ( StringName name )

Returns true if a capture with the given name is present otherwise false.


bool has_profiler ( StringName name )

Returns true if a profiler with the given name is present otherwise false.


bool is_active ( )

Returns true if the debugger is active otherwise false.


bool is_profiling ( StringName name )

Returns true if a profiler with the given name is present and active otherwise false.


void profiler_add_frame_data ( StringName name, Array data )

Calls the add callable of the profiler with given name and data.


void profiler_enable ( StringName name, bool enable, Array arguments=[] )

Calls the toggle callable of the profiler with given name and arguments. Enables/Disables the same profiler depending on enable argument.


void register_message_capture ( StringName name, Callable callable )

Registers a message capture with given name. If name is "my_message" then messages starting with "my_message:" will be called with the given callable.

Callable must accept a message string and a data array as argument. If the message and data are valid then callable must return true otherwise false.


void register_profiler ( StringName name, EngineProfiler profiler )

Registers a profiler with the given name. See EngineProfiler for more information.


void send_message ( String message, Array data )

Sends a message with given message and data array.


void unregister_message_capture ( StringName name )

Unregisters the message capture with given name.


void unregister_profiler ( StringName name )

Unregisters a profiler with given name.