Manages the GUI of a command with ImGUI. More...

#include <geogram_gfx/gui/command.h>

Inheritance diagram for GEO::Command:

Public Member Functions
	Command (const std::string &prototype)
	Command constructor. More...

const std::string &	name () const
	Gets the name of this command. More...

void	set_invoker (CommandInvoker *invoker)
	Sets the invoker. More...

	~Command () override
	Command destructor.

bool	is_visible () const
	Tests whether this Command is visible. More...

bool *	is_visible_ptr ()
	Gets a pointer to the visibility flag of this command. More...

virtual void	draw ()
	Displays and manages the GUI of this Command. More...

virtual void	reset_factory_settings ()
	Restores default parameter values for all parameters. More...

virtual void	apply ()
	Gets the value of the parameters and does the task. More...

bool	bool_arg_by_index (index_t i) const
	Gets the value of a boolean argument by index. More...

int	int_arg_by_index (index_t i) const
	Gets the value of an integer argument by index. More...

unsigned int	uint_arg_by_index (index_t i) const
	Gets the value of an unsigned integer argument by index. More...

float	float_arg_by_index (index_t i) const
	Gets the value of a floating-point argument by index. More...

double	double_arg_by_index (index_t i) const
	Gets the value of a floating-point argument by index and converts it to a double. More...

std::string	string_arg_by_index (index_t i) const
	Gets the value of a string argument by index. More...

template<class T >
void	get_arg_by_index (index_t i, T &val)
	Gets the value of an argument by index. More...

template<class T >
void	invoke (T target, void(T::fptr)(void))
	Invokes a member function with the stored arguments. More...

template<class T , class ARG0 >
void	invoke (T target, void(T::fptr)(ARG0))
	Invokes a member function with the stored arguments. More...

template<class T , class ARG0 , class ARG1 >
void	invoke (T target, void(T::fptr)(ARG0, ARG1))
	Invokes a member function with the stored arguments. More...

template<class T , class ARG0 , class ARG1 , class ARG2 >
void	invoke (T target, void(T::fptr)(ARG0, ARG1, ARG2))
	Invokes a member function with the stored arguments. More...

template<class T , class ARG0 , class ARG1 , class ARG2 , class ARG3 >
void	invoke (T target, void(T::fptr)(ARG0, ARG1, ARG2, ARG3))
	Invokes a member function with the stored arguments. More...

template<class T , class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 >
void	invoke (T target, void(T::fptr)(ARG0, ARG1, ARG2, ARG3, ARG4))
	Invokes a member function with the stored arguments. More...

template<class T , class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 >
void	invoke (T target, void(T::fptr)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5))
	Invokes a member function with the stored arguments. More...

template<class T , class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 , class ARG6 >
void	invoke (T target, void(T::fptr)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5, ARG6))
	Invokes a member function with the stored arguments. More...

template<class T , class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 , class ARG6 , class ARG7 >
void	invoke (T target, void(T::fptr)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5, ARG6, ARG7))
	Invokes a member function with the stored arguments. More...

void	invoke (void(*fptr)(void))
	Invokes a function with the stored arguments. More...

template<class ARG0 >
void	invoke (void(*fptr)(ARG0))
	Invokes a function with the stored arguments. More...

template<class ARG0 , class ARG1 >
void	invoke (void(*fptr)(ARG0, ARG1))
	Invokes a function with the stored arguments. More...

template<class ARG0 , class ARG1 , class ARG2 >
void	invoke (void(*fptr)(ARG0, ARG1, ARG2))
	Invokes a function with the stored arguments. More...

template<class ARG0 , class ARG1 , class ARG2 , class ARG3 >
void	invoke (void(*fptr)(ARG0, ARG1, ARG2, ARG3))
	Invokes a function with the stored arguments. More...

template<class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 >
void	invoke (void(*fptr)(ARG0, ARG1, ARG2, ARG3, ARG4))
	Invokes a function with the stored arguments. More...

template<class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 >
void	invoke (void(*fptr)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5))
	Invokes a function with the stored arguments. More...

template<class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 , class ARG6 >
void	invoke (void(*fptr)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5, ARG6))
	Invokes a function with the stored arguments. More...

template<class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 , class ARG6 , class ARG7 >
void	invoke (void(*fptr)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5, ARG6, ARG7))
	Invokes a function with the stored arguments. More...

template<>
void	get_arg_by_index (index_t i, bool &val)
	Gets the value of an argument by index. More...

template<>
void	get_arg_by_index (index_t i, int &val)
	Gets the value of an argument by index. More...

template<>
void	get_arg_by_index (index_t i, unsigned int &val)
	Gets the value of an argument by index. More...

template<>
void	get_arg_by_index (index_t i, float &val)
	Gets the value of an argument by index. More...

template<>
void	get_arg_by_index (index_t i, double &val)
	Gets the value of an argument by index. More...

template<>
void	get_arg_by_index (index_t i, std::string &val)
	Gets the value of an argument by index. More...

Public Member Functions inherited from GEO::Counted
void	ref () const
	Increments the reference count. More...

void	unref () const
	Decrements the reference count. More...

bool	is_shared () const
	Check if the object is shared. More...

int	nb_refs () const
	Gets the number of references that point to this object. More...

Static Public Member Functions
template<class FPTR >
static void	set_current (const std::string &prototype, FPTR tfun)
	Binds the current command to a function. More...

template<class T , class TFPTR >
static void	set_current (const std::string &prototype, T *target, TFPTR tfun)
	Binds the current command to a member function of an object. More...

static void	flush_queue ()
	Flushes the potentially queued command invokation. More...

static void	replay_latest ()
	Replays the latest invoked command.

static Command *	current ()
	Gets the current command. More...

static Command *	latest ()
	Gets the latest command. More...

static Command *	queued ()
	Gets the queued command. More...

static void	reset_current ()
	Resets the current command.

static void	set_current (Command *command)
	Sets the current command. More...

Static Public Member Functions inherited from GEO::Counted
static void	ref (const Counted *counted)
	Increments the reference count. More...

static void	unref (const Counted *counted)
	Decrements the reference count. More...

Protected Member Functions
void	assert_nb_args_matches (index_t nb)
	Tests whether the number of declared arguments matches a specified number. More...

template<class T >
void	add_arg (const std::string &name, const T &default_val, const std::string &help="")
	Adds a parameter to this command. More...

template<class T >
void	create_arg (index_t i, const T &default_val)
	Creates an argument at a given index. More...

Protected Member Functions inherited from GEO::Counted
	Counted ()
	Creates a reference counted object. More...

virtual	~Counted ()
	Destroys a reference counted object. More...

Detailed Description

Manages the GUI of a command with ImGUI.

Client code will only need to use set_current()

Definition at line 99 of file command.h.

Constructor & Destructor Documentation

◆ Command()

GEO::Command::Command ( const std::string & prototype )

Command constructor.

Parameters

[in] prototype a const reference to a string with the prototype of the function that implements the callback, as declared in the C++ sources.

Note: Regular client code should not need to use this function.

Member Function Documentation

◆ add_arg()

template<class T >

void GEO::Command::add_arg	(	const std::string &	name,
		const T &	default_val,
		const std::string &	help = `""`
	)

inlineprotected

Adds a parameter to this command.

Template Parameters

T	type of the parameter, deduced from `default_val`

Parameters

[in]	name	name of the parameter
[in]	default_val	default value of the parameter
[in]	help	optionnal text, displayed in a tooltip

Definition at line 1027 of file command.h.

◆ apply()

virtual void GEO::Command::apply ( )

virtual

Gets the value of the parameters and does the task.

This is the function that is called when the user pushes the 'apply' button. It does not invoke the command immediatly, the command invocation is queued, and executed later by Command::flush_queue(), once we are no longer in the ImGui handler (else we would have two nested ImGui handlers, which is not correct).

Note: Regular client code should not need to use this function.

◆ assert_nb_args_matches()

void GEO::Command::assert_nb_args_matches ( index_t nb )

inlineprotected

Tests whether the number of declared arguments matches a specified number.

If the number of arguments differs from the expected number, then an assertion failure is triggered. When auto_create_args_ is set, number of stored arguments should be 0.

Parameters

[in] nb expected number of arguments.

Definition at line 1010 of file command.h.

◆ bool_arg_by_index()

bool GEO::Command::bool_arg_by_index ( index_t i ) const

inline

Gets the value of a boolean argument by index.

If the index is out of range, or if the argument is not of the correct type, then an assertion failure is triggered.

Parameters

[in] i the index of the argument

Returns: the value of the argument

Note: Regular client code should not need to use this function.

Definition at line 362 of file command.h.

◆ create_arg()

template<class T >

void GEO::Command::create_arg	(	index_t	i,
		const T &	default_val
	)

inlineprotected

Creates an argument at a given index.

Used by the auto_create_args mechanism, used when client code did not provide any function prototype

Template Parameters

T	type of the parameter, deduced from `default_val`

Parameters

[in] default_val default value of the parameter

Definition at line 1042 of file command.h.

◆ current()

static Command* GEO::Command::current ( )

inlinestatic

Gets the current command.

Returns: a pointer to the current command

Note: Regular client code should not need to use this function.

Definition at line 312 of file command.h.

◆ double_arg_by_index()

double GEO::Command::double_arg_by_index ( index_t i ) const

inline

Gets the value of a floating-point argument by index and converts it to a double.

If the index is out of range, or if the argument is not of the correct type, then an assertion failure is triggered.

Parameters

[in] i the index of the argument

Returns: the value of the argument

Note: Regular client code should not need to use this function.

Definition at line 417 of file command.h.

◆ draw()

virtual void GEO::Command::draw ( )

virtual

Displays and manages the GUI of this Command.

Note: Regular client code should not need to use this function.

◆ float_arg_by_index()

float GEO::Command::float_arg_by_index ( index_t i ) const

inline

Gets the value of a floating-point argument by index.

If the index is out of range, or if the argument is not of the correct type, then an assertion failure is triggered.

Parameters

[in] i the index of the argument

Returns: the value of the argument

Note: Regular client code should not need to use this function.

Definition at line 401 of file command.h.

◆ flush_queue()

static void GEO::Command::flush_queue ( )

static

Flushes the potentially queued command invokation.

When the user pushes the 'apply' button, the command is not invoked immediatly, because we are still in the ImGUI handling function. This function is called by the framework at the end of the frame, when the ImGUI handler is already finished. It can potentially re-trigger frame rendering operations, through the Logger and ProgressLogger. Without this mechanism, it would nest two ImGUI handlers, which is not allowed.

◆ get_arg_by_index() [1/7]

template<>

void GEO::Command::get_arg_by_index	(	index_t	i,
		bool &	val
	)

inline

Gets the value of an argument by index.

This function is generic, and has several specializations for bool, int, unsigned int, float, double and std::string. For all other types, an assertion failure is triggered.

Template Parameters

T	type of the argument

Parameters

[in]	i	the index of the argument
[out]	val	a reference to the argument

Note: Regular client code should not need to use this function.

Definition at line 1238 of file command.h.

◆ get_arg_by_index() [2/7]

template<>

void GEO::Command::get_arg_by_index	(	index_t	i,
		double &	val
	)

inline

Gets the value of an argument by index.

This function is generic, and has several specializations for bool, int, unsigned int, float, double and std::string. For all other types, an assertion failure is triggered.

Template Parameters

T	type of the argument

Parameters

[in]	i	the index of the argument
[out]	val	a reference to the argument

Note: Regular client code should not need to use this function.

Definition at line 1294 of file command.h.

◆ get_arg_by_index() [3/7]

template<>

void GEO::Command::get_arg_by_index	(	index_t	i,
		float &	val
	)

inline

Gets the value of an argument by index.

This function is generic, and has several specializations for bool, int, unsigned int, float, double and std::string. For all other types, an assertion failure is triggered.

Template Parameters

T	type of the argument

Parameters

[in]	i	the index of the argument
[out]	val	a reference to the argument

Note: Regular client code should not need to use this function.

Definition at line 1280 of file command.h.

◆ get_arg_by_index() [4/7]

template<>

void GEO::Command::get_arg_by_index	(	index_t	i,
		int &	val
	)

inline

Gets the value of an argument by index.

This function is generic, and has several specializations for bool, int, unsigned int, float, double and std::string. For all other types, an assertion failure is triggered.

Template Parameters

T	type of the argument

Parameters

[in]	i	the index of the argument
[out]	val	a reference to the argument

Note: Regular client code should not need to use this function.

Definition at line 1252 of file command.h.

◆ get_arg_by_index() [5/7]

template<>

void GEO::Command::get_arg_by_index	(	index_t	i,
		std::string &	val
	)

inline

Gets the value of an argument by index.

This function is generic, and has several specializations for bool, int, unsigned int, float, double and std::string. For all other types, an assertion failure is triggered.

Template Parameters

T	type of the argument

Parameters

[in]	i	the index of the argument
[out]	val	a reference to the argument

Note: Regular client code should not need to use this function.

Definition at line 1308 of file command.h.

◆ get_arg_by_index() [6/7]

template<class T >

void GEO::Command::get_arg_by_index	(	index_t	i,
		T &	val
	)

inline

Gets the value of an argument by index.

This function is generic, and has several specializations for bool, int, unsigned int, float, double and std::string. For all other types, an assertion failure is triggered.

Template Parameters

T	type of the argument

Parameters

[in]	i	the index of the argument
[out]	val	a reference to the argument

Note: Regular client code should not need to use this function.

Definition at line 447 of file command.h.

◆ get_arg_by_index() [7/7]

template<>

void GEO::Command::get_arg_by_index	(	index_t	i,
		unsigned int &	val
	)

inline

Gets the value of an argument by index.

This function is generic, and has several specializations for bool, int, unsigned int, float, double and std::string. For all other types, an assertion failure is triggered.

Template Parameters

T	type of the argument

Parameters

[in]	i	the index of the argument
[out]	val	a reference to the argument

Note: Regular client code should not need to use this function.

Definition at line 1266 of file command.h.

◆ int_arg_by_index()

int GEO::Command::int_arg_by_index ( index_t i ) const

Gets the value of an integer argument by index.

If the index is out of range, or if the argument is not of the correct type, then an assertion failure is triggered.

Parameters

[in] i the index of the argument

Returns: the value of the argument

Note: Regular client code should not need to use this function.

◆ invoke() [1/18]

template<class T , class ARG0 >

void GEO::Command::invoke	(	T *	target,
		void(T::*)(ARG0)	fptr
	)

inline

Invokes a member function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

T	class of the target object
ARG0	type of the argument

Parameters

[in]	target	the target object
[in]	fptr	the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 489 of file command.h.

◆ invoke() [2/18]

template<class T , class ARG0 , class ARG1 >

void GEO::Command::invoke	(	T *	target,
		void(T::*)(ARG0, ARG1)	fptr
	)

inline

Invokes a member function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

T	class of the target object
ARG0,ARG1	types of the arguments

Parameters

[in]	target	the target object
[in]	fptr	the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 514 of file command.h.

◆ invoke() [3/18]

template<class T , class ARG0 , class ARG1 , class ARG2 >

void GEO::Command::invoke	(	T *	target,
		void(T::*)(ARG0, ARG1, ARG2)	fptr
	)

inline

Invokes a member function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

T	class of the target object
ARG0,ARG1,ARG2	types of the arguments

Parameters

[in]	target	the target object
[in]	fptr	the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 542 of file command.h.

◆ invoke() [4/18]

template<class T , class ARG0 , class ARG1 , class ARG2 , class ARG3 >

void GEO::Command::invoke	(	T *	target,
		void(T::*)(ARG0, ARG1, ARG2, ARG3)	fptr
	)

inline

Invokes a member function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

T	class of the target object
ARG0,ARG1,ARG2,ARG3	types of the arguments

Parameters

[in]	target	the target object
[in]	fptr	the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 572 of file command.h.

◆ invoke() [5/18]

template<class T , class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 >

void GEO::Command::invoke	(	T *	target,
		void(T::*)(ARG0, ARG1, ARG2, ARG3, ARG4)	fptr
	)

inline

Invokes a member function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

T	class of the target object
ARG0,ARG4	types of the arguments

Parameters

[in]	target	the target object
[in]	fptr	the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 605 of file command.h.

◆ invoke() [6/18]

template<class T , class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 >

void GEO::Command::invoke	(	T *	target,
		void(T::*)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5)	fptr
	)

inline

Invokes a member function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

T	class of the target object
ARG0,ARG5	types of the arguments

Parameters

[in]	target	the target object
[in]	fptr	the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 640 of file command.h.

◆ invoke() [7/18]

template<class T , class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 , class ARG6 >

void GEO::Command::invoke	(	T *	target,
		void(T::*)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5, ARG6)	fptr
	)

inline

Invokes a member function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

T	class of the target object
ARG0,ARG6	types of the arguments

Parameters

[in]	target	the target object
[in]	fptr	the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 677 of file command.h.

◆ invoke() [8/18]

template<class T , class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 , class ARG6 , class ARG7 >

void GEO::Command::invoke	(	T *	target,
		void(T::*)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5, ARG6, ARG7)	fptr
	)

inline

Invokes a member function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

T	class of the target object
ARG0,ARG7	types of the arguments

Parameters

[in]	target	the target object
[in]	fptr	the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 716 of file command.h.

◆ invoke() [9/18]

template<class T >

void GEO::Command::invoke	(	T *	target,
		void(T::*)(void)	fptr
	)

inline

Invokes a member function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

T	class of the target object

Parameters

[in]	target	the target object
[in]	fptr	the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 467 of file command.h.

◆ invoke() [10/18]

template<class ARG0 >

void GEO::Command::invoke ( void(*)(ARG0) fptr )

inline

Invokes a function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

ARG0	type of the argument

Parameters

[in] fptr the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 772 of file command.h.

◆ invoke() [11/18]

template<class ARG0 , class ARG1 >

void GEO::Command::invoke ( void(*)(ARG0, ARG1) fptr )

inline

Invokes a function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

ARG0,ARG1 types of the arguments

Parameters

[in] fptr the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 794 of file command.h.

◆ invoke() [12/18]

template<class ARG0 , class ARG1 , class ARG2 >

void GEO::Command::invoke ( void(*)(ARG0, ARG1, ARG2) fptr )

inline

Invokes a function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

ARG0,ARG1,ARG2 types of the arguments

Parameters

[in] fptr the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 818 of file command.h.

◆ invoke() [13/18]

template<class ARG0 , class ARG1 , class ARG2 , class ARG3 >

void GEO::Command::invoke ( void(*)(ARG0, ARG1, ARG2, ARG3) fptr )

inline

Invokes a function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

ARG0,ARG1,ARG2,ARG3 types of the arguments

Parameters

[in] fptr the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 844 of file command.h.

◆ invoke() [14/18]

template<class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 >

void GEO::Command::invoke ( void(*)(ARG0, ARG1, ARG2, ARG3, ARG4) fptr )

inline

Invokes a function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

ARG0,ARG1,ARG2,ARG3,ARG4 types of the arguments

Parameters

[in] fptr the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 873 of file command.h.

◆ invoke() [15/18]

template<class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 >

void GEO::Command::invoke ( void(*)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5) fptr )

inline

Invokes a function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

ARG0,ARG5 types of the arguments

Parameters

[in] fptr the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 904 of file command.h.

◆ invoke() [16/18]

template<class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 , class ARG6 >

void GEO::Command::invoke ( void(*)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5, ARG6) fptr )

inline

Invokes a function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

ARG0,ARG6 types of the arguments

Parameters

[in] fptr the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 937 of file command.h.

◆ invoke() [17/18]

template<class ARG0 , class ARG1 , class ARG2 , class ARG3 , class ARG4 , class ARG5 , class ARG6 , class ARG7 >

void GEO::Command::invoke ( void(*)(ARG0, ARG1, ARG2, ARG3, ARG4, ARG5, ARG6, ARG7) fptr )

inline

Invokes a function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Template Parameters

ARG0,ARG7 types of the arguments

Parameters

[in] fptr the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 972 of file command.h.

◆ invoke() [18/18]

void GEO::Command::invoke ( void(*)(void) fptr )

inline

Invokes a function with the stored arguments.

If the type or number of stored arguments do not match the function pointer, then an assertion failure is triggered.

Parameters

[in] fptr the pointer to the member function to be called.

Note: Used by internal CommandInvoker mechanism.

Definition at line 752 of file command.h.

◆ is_visible()

bool GEO::Command::is_visible ( ) const

inline

Tests whether this Command is visible.

Return values

true	if this Command is visible
false	otherwise

Definition at line 265 of file command.h.

◆ is_visible_ptr()

bool* GEO::Command::is_visible_ptr ( )

inline

Gets a pointer to the visibility flag of this command.

Returns: a pointer to the visibility flag

Definition at line 274 of file command.h.

◆ latest()

static Command* GEO::Command::latest ( )

inlinestatic

Gets the latest command.

Returns: a pointer to the command that was last executed.

Used by playback mechanism ('F5' in applications).

Definition at line 322 of file command.h.

◆ name()

const std::string& GEO::Command::name ( ) const

inline

Gets the name of this command.

Returns: a const reference to the name of this command.

Definition at line 235 of file command.h.

◆ queued()

static Command* GEO::Command::queued ( )

inlinestatic

Gets the queued command.

Returns: a pointer to the command that is about to be executed

Definition at line 330 of file command.h.

◆ reset_factory_settings()

virtual void GEO::Command::reset_factory_settings ( )

virtual

Restores default parameter values for all parameters.

This is the function that is called when the user pushes the 'default' button.

Note: Regular client code should not need to use this function.

◆ set_current() [1/3]

static void GEO::Command::set_current ( Command * command )

inlinestatic

Sets the current command.

Parameters

[in] command a pointer to the command to be set as current

Note: Regular client code should not need to use this function.

Definition at line 348 of file command.h.

◆ set_current() [2/3]

template<class FPTR >

void GEO::Command::set_current	(	const std::string &	prototype,
		FPTR	tfun
	)

inlinestatic

Binds the current command to a function.

This makes the command dialog box display parameters that correspond to the arguments of the function, and whenever the 'apply' button is pushed, the function is invoked with the arguments. Example:

void my_command_impl(float x, float y, bool normalize) {
... do something
}
...
... 
if(ImGui::MenuItem("my command")) {
    GEO::Command::set_current(
       "void my_command_impl(float x, float y, bool normalize)",
       &my_command_impl
    )
}

The first argument (the string with the function prototype) is necessary to retrieve the names of the parameters. In addition, default values and tooltips may be specified, as follows:

GEO::Command::set_current(
   "void my_command_impl(                        "
   "   float x=0 [this is the x coordinate],     "
   "   float y=0 [this is the y coordinate],     "
   "   bool normalize=true [normalize the vector]"
   ") [does something with a vector]             ",
   &my_command_impl
)

Each text in the square brackets corresponds to a tooltip attached to an argument. There can be also one for the function. The default values are those that are obtained at initialization, or those that are set when the 'default' button is pushed.

Template Parameters

FPTR	function pointer type

Parameters

[in]	prototype	a string with the prototype of the function, as written in C++. In addition, the function and each parameter can be documented in square brackets.
[in]	tfun	the function pointer.

Definition at line 1417 of file command.h.

◆ set_current() [3/3]

template<class T , class TFPTR >

void GEO::Command::set_current	(	const std::string &	prototype,
		T *	target,
		TFPTR	tfun
	)

inlinestatic

Binds the current command to a member function of an object.

This makes the command dialog box display parameters that correspond to the arguments of the function, and whenever the 'apply' button is pushed, the function is invoked with the arguments. Example:

class MyCommands {
   void my_command_impl(float x, float y, bool normalize) {
   ... do something
   }
};
MyCommands my_commands;
...
... 
if(ImGui::MenuItem("my command")) {
    GEO::Command::set_current(
       "void my_command_impl(float x, float y, bool normalize)",
       &my_commands, &MyCommands::my_command_impl
    )
}

The first argument (the string with the function prototype) is necessary to retrieve the names of the parameters. In addition, default values and tooltips may be specified, as follows:

GEO::Command::set_current(
   "void my_command_impl(                        "
   "   float x=0 [this is the x coordinate],     "
   "   float y=0 [this is the y coordinate],     "
   "   bool normalize=true [normalize the vector]"
   ") [does something with a vector]             ",
   &my_commands, &MyCommands::my_command_impl
)

Each text in the square brackets corresponds to a tooltip attached to an argument. There can be also one for the function. The default values are those that are obtained at initialization, or those that are set when the 'default' button is pushed.

Template Parameters

T	object class
TFPTR	function pointer type, should be a member function of class T

Parameters

[in]	prototype	a string with the prototype of the function, as written in C++. In addition, the function and each parameter can be documented in square brackets.
[in]	target	a pointer to the object, of class T
[in]	tfun	the pointer to the member function

Definition at line 1429 of file command.h.

◆ set_invoker()

void GEO::Command::set_invoker ( CommandInvoker * invoker )

inline

Sets the invoker.

The invoker is used internally to transmit the stored arguments to the parameters of a function.

Parameters

[in] invoker a pointer to the CommandInvoker. Ownership is transferred to this Command.

Note: Regular client code should not need to use this function.

Definition at line 247 of file command.h.

◆ string_arg_by_index()

std::string GEO::Command::string_arg_by_index ( index_t i ) const

inline

Gets the value of a string argument by index.

If the index is out of range, or if the argument is not of the correct type, then an assertion failure is triggered.

Parameters

[in] i the index of the argument

Returns: the value of the argument

Note: Regular client code should not need to use this function.

Definition at line 430 of file command.h.

◆ uint_arg_by_index()

unsigned int GEO::Command::uint_arg_by_index ( index_t i ) const

Gets the value of an unsigned integer argument by index.

If the index is out of range, or if the argument is not of the correct type, then an assertion failure is triggered. If the stored value is negative, then it is clamped to 0, and a warning message is displayed on the console.

Parameters

[in] i the index of the argument

Returns: the value of the argument

Note: Regular client code should not need to use this function.

The documentation for this class was generated from the following file:

geogram_gfx/gui/command.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Command()

Member Function Documentation

◆ add_arg()

◆ apply()

◆ assert_nb_args_matches()

◆ bool_arg_by_index()

◆ create_arg()

◆ current()

◆ double_arg_by_index()

◆ draw()

◆ float_arg_by_index()

◆ flush_queue()

◆ get_arg_by_index() [1/7]

◆ get_arg_by_index() [2/7]

◆ get_arg_by_index() [3/7]

◆ get_arg_by_index() [4/7]

◆ get_arg_by_index() [5/7]

◆ get_arg_by_index() [6/7]

◆ get_arg_by_index() [7/7]

◆ int_arg_by_index()

◆ invoke() [1/18]

◆ invoke() [2/18]

◆ invoke() [3/18]

◆ invoke() [4/18]

◆ invoke() [5/18]

◆ invoke() [6/18]

◆ invoke() [7/18]

◆ invoke() [8/18]

◆ invoke() [9/18]

◆ invoke() [10/18]

◆ invoke() [11/18]

◆ invoke() [12/18]

◆ invoke() [13/18]

◆ invoke() [14/18]

◆ invoke() [15/18]

◆ invoke() [16/18]

◆ invoke() [17/18]

◆ invoke() [18/18]

◆ is_visible()

◆ is_visible_ptr()

◆ latest()

◆ name()

◆ queued()

◆ reset_factory_settings()

◆ set_current() [1/3]

◆ set_current() [2/3]

◆ set_current() [3/3]

◆ set_invoker()

◆ string_arg_by_index()

◆ uint_arg_by_index()