godot_macros.h File Reference

C-style preprocessor macros to simplify using godot's C++ API. More...

#include "godot_cpp/classes/engine.hpp"
#include "godot_cpp/core/class_db.hpp"
#include "godot_cpp/variant/string.hpp"

Go to the source code of this file.

Macros
#define	MACRO_STRING_INNER(_Arg)   #_Arg
#define	MACRO_STRING(_Arg)   MACRO_STRING_INNER(_Arg)
#define	GDPROPERTY(PropName_, PropType_)
	Register property.
#define	GDPROPERTY_HINTED(PropName_, PropType_, ...)
	Register a hinted property.
#define	GDFUNCTION(FnName_)   godot::ClassDB::bind_method(godot::D_METHOD(#FnName_), &CLASSNAME::FnName_)
	Register a function.
#define	GDFUNCTION_ARGS(FnName_, ...)   godot::ClassDB::bind_method(godot::D_METHOD(#FnName_, __VA_ARGS__), &CLASSNAME::FnName_)
	Register a function with arguments.
#define	GDFUNCTION_STATIC(FnName_)   godot::ClassDB::bind_static_method(MACRO_STRING(CLASSNAME), godot::D_METHOD(#FnName_), &CLASSNAME::_FnName)
	Register a static function.
#define	GDFUNCTION_STATIC_ARGS(FnName_, ...)   godot::ClassDB::bind_static_method(MACRO_STRING(CLASSNAME), godot::D_METHOD(#FnName_, __VA_ARGS__), &CLASSNAME::FnName_)
	Register a static function with arguments.
#define	GDSIGNAL(...)   godot::ClassDB::add_signal(MACRO_STRING(CLASSNAME), godot::MethodInfo(__VA_ARGS__))
	Declare a godot Observer signal.
#define	GDRESOURCETYPE(Class_)   godot::vformat("%s/%s:%s", godot::Variant::OBJECT, godot::PROPERTY_HINT_RESOURCE_TYPE, #Class_)
	Construct godot resource type hint.
#define	GDEDITORONLY()   if(!godot::Engine::get_singleton()->is_editor_hint()) return;
	Execute the rest of the function only if currently running as editor.
#define	GDGAMEONLY()   if(godot::Engine::get_singleton()->is_editor_hint()) return;
	Execute the rest of the function only if currently running as game.
#define	GDENUM(Name_, ...)
	Declare a scoped enum struct.

Detailed Description

C-style preprocessor macros to simplify using godot's C++ API.

Macro Definition Documentation

GDEDITORONLY

#define GDEDITORONLY

(

)

if(!godot::Engine::get_singleton()->is_editor_hint()) return;

Execute the rest of the function only if currently running as editor.

Useful for _ready, _enter/_exit, _process, etc. functions.

GDENUM

#define GDENUM	(		Name_,
			...
	)

Value:

    struct Name_ {\
    enum Value {__VA_ARGS__};\
    private:\
    Value value{};\
    public:\
    static inline godot::String get_property_hint() { return godot::String(#__VA_ARGS__); }\
    inline Name_(Value value): value{value} {}\
    inline Name_(Name_ const &value): value{value.value} {}\
}

Declare a scoped enum struct.

Declares a struct Name_ with an enum Value and a single variable and a get_property_hint() function.

GDFUNCTION

#define GDFUNCTION

(

FnName_

)

godot::ClassDB::bind_method(godot::D_METHOD(#FnName_), &CLASSNAME::FnName_)

Register a function.

Register a function CLASSNAME::FnName_() to godot. Requires setting CLASSNAME as a #define first.

GDFUNCTION_ARGS

#define GDFUNCTION_ARGS	(		FnName_,
			...
	)		godot::ClassDB::bind_method(godot::D_METHOD(#FnName_, __VA_ARGS__), &CLASSNAME::FnName_)

Register a function with arguments.

Register a function CLASSNAME::FnName_(...) to godot. Requires setting CLASSNAME as a #define first.

GDFUNCTION_STATIC

#define GDFUNCTION_STATIC

(

FnName_

)

godot::ClassDB::bind_static_method(MACRO_STRING(CLASSNAME), godot::D_METHOD(#FnName_), &CLASSNAME::_FnName)

Register a static function.

Register a static member function CLASSNAME::FnName_() to godot. Requires setting CLASSNAME as a #define first.

GDFUNCTION_STATIC_ARGS

#define GDFUNCTION_STATIC_ARGS	(		FnName_,
			...
	)		godot::ClassDB::bind_static_method(MACRO_STRING(CLASSNAME), godot::D_METHOD(#FnName_, __VA_ARGS__), &CLASSNAME::FnName_)

Register a static function with arguments.

Register a static member function CLASSNAME::FnName_(...) to godot. Requires setting CLASSNAME as a #define first.

GDGAMEONLY

#define GDGAMEONLY

(

)

if(godot::Engine::get_singleton()->is_editor_hint()) return;

Execute the rest of the function only if currently running as game.

Useful for _ready, _enter/_exit, _process, etc. functions.

GDPROPERTY

#define GDPROPERTY	(		PropName_,
			PropType_
	)

Value:

    godot::ClassDB::bind_method(godot::D_METHOD("get_" #PropName_), &CLASSNAME::get_##PropName_); \
    godot::ClassDB::bind_method(godot::D_METHOD("set_" #PropName_, "value"), &CLASSNAME::set_##PropName_); \
    godot::ClassDB::add_property(MACRO_STRING(CLASSNAME), godot::PropertyInfo(PropType_, #PropName_), "set_" #PropName_, "get_" #PropName_)

Register property.

Register variable CLASSNAME::PropName_ with variant type PropType_. Requires setting CLASSNAME as a #define first. Also requires a CLASSNAME::get_PropName_ and CLASSNAME::set_PropName_ to exist.

GDPROPERTY_HINTED

#define GDPROPERTY_HINTED	(		PropName_,
			PropType_,
			...
	)

Value:

    godot::ClassDB::bind_method(godot::D_METHOD("get_" #PropName_), &CLASSNAME::get_##PropName_); \
    godot::ClassDB::bind_method(godot::D_METHOD("set_" #PropName_, "value"), &CLASSNAME::set_##PropName_); \
    godot::ClassDB::add_property(MACRO_STRING(CLASSNAME), godot::PropertyInfo(PropType_, #PropName_, __VA_ARGS__), "set_" #PropName_, "get_" #PropName_)

Register a hinted property.

Register variable CLASSNAME::PropName_ with variant type PropType_. Requires setting CLASSNAME as a #define first, and CLASSNAME::get_PropName and CLASSNAME::set_PropName_ to exist.

GDRESOURCETYPE

#define GDRESOURCETYPE

(

Class_

)

godot::vformat("%s/%s:%s", godot::Variant::OBJECT, godot::PROPERTY_HINT_RESOURCE_TYPE, #Class_)

Construct godot resource type hint.

Use when registering properties of arrays of resource classes.

GDSIGNAL

#define GDSIGNAL

(

...

)

godot::ClassDB::add_signal(MACRO_STRING(CLASSNAME), godot::MethodInfo(__VA_ARGS__))

Declare a godot Observer signal.

Declare the existence of a Observer signal to godot.