Input Default-Behavior Control

API for bypassing or re-enabling the library's built-in input processing. More...

Collaboration diagram for Input Default-Behavior Control:

Functions
BGI_API int BGI_CALL	wxbgi_get_input_defaults (void)
	Returns the current input default-behavior bitmask.
BGI_API void BGI_CALL	wxbgi_set_input_defaults (int flags)
	Sets the active input default-behavior flags.

Detailed Description

API for bypassing or re-enabling the library's built-in input processing.

By default, the library performs the following actions inside its GLFW callbacks:

Flag	Default action
WXBGI_DEFAULT_KEY_QUEUE	Translate GLFW keys to DOS codes; push to keyQueue.
WXBGI_DEFAULT_CURSOR_TRACK	Write cursor position to mouseX/mouseY; set mouseMoved.
WXBGI_DEFAULT_MOUSE_PICK	On left-click, call overlayPerformPick() to update selectedObjectIds.
WXBGI_DEFAULT_SCROLL_ACCUM	Accumulate scroll deltas in scrollDeltaX/scrollDeltaY.

Clearing a flag disables only that default. User hooks always fire regardless of flags. Call wxbgi_set_input_defaults(WXBGI_DEFAULT_ALL) to restore all defaults; wxbgi_set_input_defaults(WXBGI_DEFAULT_NONE) to disable all.

Function Documentation

wxbgi_get_input_defaults()

BGI_API int BGI_CALL wxbgi_get_input_defaults

(

void

)

Returns the current input default-behavior bitmask.

Returns

Bitwise OR of active WXBGI_DEFAULT_* flags.

wxbgi_set_input_defaults()

BGI_API void BGI_CALL wxbgi_set_input_defaults

(

int

flags

)

Sets the active input default-behavior flags.

Parameters

flags

Bitwise OR of WXBGI_DEFAULT_* constants (e.g. WXBGI_DEFAULT_ALL & ~WXBGI_DEFAULT_MOUSE_PICK to keep all defaults except object picking).