#include <GHOST_ISystem.hh>

Inherited by GHOST_System.

Public Member Functions
virtual uint64_t	getMilliSeconds () const =0
virtual GHOST_ITimerTask *	installTimer (uint64_t delay, uint64_t interval, GHOST_TimerProcPtr timer_proc, GHOST_TUserDataPtr user_data=nullptr)=0
virtual GHOST_TSuccess	removeTimer (GHOST_ITimerTask *timerTask)=0
virtual uint8_t	getNumDisplays () const =0
virtual void	getMainDisplayDimensions (uint32_t &width, uint32_t &height) const =0
virtual void	getAllDisplayDimensions (uint32_t &width, uint32_t &height) const =0
virtual GHOST_IWindow *	createWindow (const char title, int32_t left, int32_t top, uint32_t width, uint32_t height, GHOST_TWindowState state, GHOST_GPUSettings gpu_settings, const bool exclusive=false, const bool is_dialog=false, const GHOST_IWindow parent_window=nullptr)=0
virtual GHOST_TSuccess	disposeWindow (GHOST_IWindow *window)=0
virtual GHOST_IContext *	createOffscreenContext (GHOST_GPUSettings gpu_settings)=0
virtual GHOST_TSuccess	disposeContext (GHOST_IContext *context)=0
virtual bool	validWindow (GHOST_IWindow *window)=0
virtual bool	useNativePixel ()=0
virtual GHOST_TCapabilityFlag	getCapabilities () const =0
virtual void	useWindowFocus (const bool use_focus)=0
virtual void	setAutoFocus (const bool auto_focus)=0
virtual GHOST_IWindow *	getWindowUnderCursor (int32_t x, int32_t y)=0
virtual bool	processEvents (bool waitForEvent)=0
virtual void	dispatchEvents ()=0
virtual GHOST_TSuccess	addEventConsumer (GHOST_IEventConsumer *consumer)=0
virtual GHOST_TSuccess	removeEventConsumer (GHOST_IEventConsumer *consumer)=0
virtual GHOST_TSuccess	getCursorPositionClientRelative (const GHOST_IWindow *window, int32_t &x, int32_t &y) const =0
virtual GHOST_TSuccess	setCursorPositionClientRelative (GHOST_IWindow *window, int32_t x, int32_t y)=0
virtual GHOST_TSuccess	getCursorPosition (int32_t &x, int32_t &y) const =0
virtual uint32_t	getCursorPreferredLogicalSize () const =0
virtual GHOST_TSuccess	setCursorPosition (int32_t x, int32_t y)=0
virtual GHOST_TSuccess	getModifierKeyState (GHOST_TModifierKey mask, bool &is_down) const =0
virtual GHOST_TSuccess	getButtonState (GHOST_TButton mask, bool &is_down) const =0
virtual void	setMultitouchGestures (const bool use)=0
virtual void	setTabletAPI (GHOST_TTabletAPI api)=0
virtual GHOST_TSuccess	getPixelAtCursor (float r_color[3]) const =0
virtual bool	setConsoleWindowState (GHOST_TConsoleWindowState action)=0
virtual char *	getClipboard (bool selection) const =0
virtual void	putClipboard (const char *buffer, bool selection) const =0
virtual GHOST_TSuccess	hasClipboardImage () const =0
virtual uint *	getClipboardImage (int r_width, int r_height) const =0
virtual GHOST_TSuccess	putClipboardImage (uint *rgba, int width, int height) const =0
virtual GHOST_TSuccess	showMessageBox (const char , const char , const char , const char , const char *, GHOST_DialogOptions) const =0
virtual void	initDebug (GHOST_Debug debug)=0
virtual bool	isDebugEnabled ()=0

Static Public Member Functions
static GHOST_TSuccess	createSystem (bool verbose, bool background)
static GHOST_TSuccess	createSystemBackground ()
static GHOST_TSuccess	disposeSystem ()
static GHOST_ISystem *	getSystem ()
static const char *	getSystemBackend ()
static GHOST_TBacktraceFn	getBacktraceFn ()
static void	setBacktraceFn (GHOST_TBacktraceFn backtrace_fn)
static bool	getUseWindowFrame ()
static void	setUseWindowFrame (bool use_window_frame)

Protected Member Functions
	GHOST_ISystem ()
virtual	~GHOST_ISystem ()=default
virtual GHOST_TSuccess	init ()=0
virtual GHOST_TSuccess	exit ()=0

Static Protected Attributes
static GHOST_ISystem *	system_ = nullptr
static const char *	system_backend_id_ = nullptr
static GHOST_TBacktraceFn	backtrace_fn_ = nullptr
static bool	use_window_frame_ = true

Detailed Description

Interface for classes that provide access to the operating system. There should be only one system class in an application. Therefore, the routines to create and dispose the system are static. Provides:

Time(r) management.
Display/window management (windows are only created on the main display).
Event management.
Cursor shape management (no custom cursors for now).
Access to the state of the mouse buttons and the keyboard.
Menus for windows with events generated when they are accessed (this is work in progress).

Definition at line 117 of file GHOST_ISystem.hh.

Constructor & Destructor Documentation

◆ GHOST_ISystem()

GHOST_ISystem::GHOST_ISystem ( )

inlineprotected

Constructor. Protected default constructor to force use of static createSystem member.

Definition at line 161 of file GHOST_ISystem.hh.

Referenced by getSystem().

◆ ~GHOST_ISystem()

virtual GHOST_ISystem::~GHOST_ISystem ( )

protectedvirtualdefault

Destructor. Protected default constructor to force use of static dispose member.

Member Function Documentation

◆ addEventConsumer()

virtual GHOST_TSuccess GHOST_ISystem::addEventConsumer ( GHOST_IEventConsumer * consumer )

pure virtual

Adds the given event consumer to our list.

Parameters

consumer The event consumer to add.

Returns: Indication of success.

Implemented in GHOST_System.

Referenced by GHOST_AddEventConsumer().

◆ createOffscreenContext()

virtual GHOST_IContext * GHOST_ISystem::createOffscreenContext ( GHOST_GPUSettings gpu_settings )

pure virtual

Create a new off-screen context. Never explicitly delete the context, use disposeContext() instead.

Returns: The new context (or 0 if creation failed).

Implemented in GHOST_System, GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_CreateGPUContext().

◆ createSystem()

GHOST_TSuccess GHOST_ISystem::createSystem	(	bool	verbose,
		bool	background )

static

Creates the one and only system.

Parameters

verbose	report back-ends that were attempted no back-end could be loaded.
background	loading the system for background rendering (no visible windows).

Returns: An indication of success.

The cause of the failure.

Definition at line 44 of file GHOST_ISystem.cc.

References CLG_LEVEL_INFO, CLOG_CHECK, CLOG_INFO, CLOG_STR_INFO_NOCHECK, e, getUseWindowFrame(), GHOST_kFailure, GHOST_kSuccess, i, LOG, system_, system_backend_id_, and verbose.

Referenced by createSystemBackground(), GHOST_CreateSystem(), and main().

◆ createSystemBackground()

GHOST_TSuccess GHOST_ISystem::createSystemBackground ( )

static

Definition at line 209 of file GHOST_ISystem.cc.

References CLOG_INFO, createSystem(), GHOST_kFailure, GHOST_kSuccess, LOG, and system_.

Referenced by GHOST_CreateSystemBackground().

◆ createWindow()

virtual GHOST_IWindow * GHOST_ISystem::createWindow	(	const char *	title,
		int32_t	left,
		int32_t	top,
		uint32_t	width,
		uint32_t	height,
		GHOST_TWindowState	state,
		GHOST_GPUSettings	gpu_settings,
		const bool	exclusive = false,
		const bool	is_dialog = false,
		const GHOST_IWindow *	parent_window = nullptr )

pure virtual

Create a new window. The new window is added to the list of windows managed. Never explicitly delete the window, use disposeWindow() instead.

Parameters

title	The name of the window (displayed in the title bar of the window if the OS supports it).
left	The coordinate of the left edge of the window.
top	The coordinate of the top edge of the window.
width	The width the window.
height	The height the window.
state	The state of the window when opened.
gpu_settings	Misc GPU settings.
exclusive	Use to show the window on top and ignore others (used full-screen).
is_dialog	Stay on top of parent window, no icon in taskbar, can't be minimized.
parent_window	Parent (embedder) window

Returns: The new window (or 0 if creation failed).

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

References left, state, and top.

Referenced by Application::Application(), and GHOST_CreateWindow().

◆ dispatchEvents()

virtual void GHOST_ISystem::dispatchEvents ( )

pure virtual

Retrieves events from the queue and send them to the event consumers. The event stack will be empty afterwards.

Implemented in GHOST_System.

Referenced by GHOST_DispatchEvents().

◆ disposeContext()

virtual GHOST_TSuccess GHOST_ISystem::disposeContext ( GHOST_IContext * context )

pure virtual

Dispose of a context.

Parameters

context Pointer to the context to be disposed.

Returns: Indication of success.

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_DisposeGPUContext().

◆ disposeSystem()

GHOST_TSuccess GHOST_ISystem::disposeSystem ( )

static

Disposes the one and only system.

Returns: An indication of success.

Definition at line 235 of file GHOST_ISystem.cc.

References CLOG_DEBUG, GHOST_kFailure, GHOST_kSuccess, LOG, and system_.

Referenced by GHOST_DisposeSystem(), and main().

◆ disposeWindow()

virtual GHOST_TSuccess GHOST_ISystem::disposeWindow ( GHOST_IWindow * window )

pure virtual

Dispose a window.

Parameters

window Pointer to the window to be disposed.

Returns: Indication of success.

Implemented in GHOST_System.

Referenced by GHOST_DisposeWindow().

◆ exit()

virtual GHOST_TSuccess GHOST_ISystem::exit ( )

protectedpure virtual

Shut the system down.

Returns: Indication of success.

Implemented in GHOST_System, and GHOST_SystemWin32.

◆ getAllDisplayDimensions()

virtual void GHOST_ISystem::getAllDisplayDimensions	(	uint32_t &	width,
		uint32_t &	height ) const

pure virtual

Returns the combine dimensions of all monitors.

Returns: The dimension of the workspace.

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_GetAllDisplayDimensions().

◆ getBacktraceFn()

GHOST_TBacktraceFn GHOST_ISystem::getBacktraceFn ( )

static

Definition at line 259 of file GHOST_ISystem.cc.

References backtrace_fn_.

Referenced by ghost_wayland_log_handler().

◆ getButtonState()

virtual GHOST_TSuccess GHOST_ISystem::getButtonState	(	GHOST_TButton	mask,
		bool &	is_down ) const

pure virtual

Returns the state of a mouse button (outside the message queue).

Parameters

mask	The button state to retrieve.
is_down	Button state.

Returns: Indication of success.

Implemented in GHOST_System.

References mask().

Referenced by GHOST_GetButtonState().

◆ getCapabilities()

virtual GHOST_TCapabilityFlag GHOST_ISystem::getCapabilities ( ) const

pure virtual

Return features supported by the system back-end.

The resulting value doesn't change at run-time.

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_GetCapabilities().

◆ getClipboard()

virtual char * GHOST_ISystem::getClipboard ( bool selection ) const

pure virtual

Return the clipboard buffer or null.

Parameters

selection Use the "primary" selection. Check the GHOST_kCapabilityClipboardPrimary for backends that support this.

Returns: Returns the clipboard data as a null terminated string or null when unavailable.

Implemented in GHOST_System, GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_getClipboard().

◆ getClipboardImage()

virtual uint * GHOST_ISystem::getClipboardImage	(	int *	r_width,
		int *	r_height ) const

pure virtual

Get image data from the Clipboard

Parameters

r_width	the returned image width in pixels.
r_height	the returned image height in pixels.

Returns: pointer uint array in RGBA byte order. Caller must free.

Implemented in GHOST_System, GHOST_SystemCocoa, GHOST_SystemWayland, and GHOST_SystemWin32.

Referenced by GHOST_getClipboardImage().

◆ getCursorPosition()

virtual GHOST_TSuccess GHOST_ISystem::getCursorPosition	(	int32_t &	x,
		int32_t &	y ) const

pure virtual

Returns the current location of the cursor (location in screen coordinates)

Parameters

x	The x-coordinate of the cursor.
y	The y-coordinate of the cursor.

Returns: Indication of success.

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

References x, and y.

Referenced by GHOST_System::getCursorPositionClientRelative().

◆ getCursorPositionClientRelative()

virtual GHOST_TSuccess GHOST_ISystem::getCursorPositionClientRelative	(	const GHOST_IWindow *	window,
		int32_t &	x,
		int32_t &	y ) const

pure virtual

Returns the current location of the cursor (location in window coordinates)

Parameters

x	The x-coordinate of the cursor.
y	The y-coordinate of the cursor.

Returns: Indication of success.

Implemented in GHOST_System, and GHOST_SystemWayland.

References x, and y.

Referenced by GHOST_GetCursorPosition().

◆ getCursorPreferredLogicalSize()

virtual uint32_t GHOST_ISystem::getCursorPreferredLogicalSize ( ) const

pure virtual

Returns: the size of the cursor in logical pixels (before Hi-DPI scaling is applied).

Implemented in GHOST_System, GHOST_SystemWayland, and GHOST_SystemWin32.

Referenced by GHOST_GetCursorPreferredLogicalSize().

◆ getMainDisplayDimensions()

virtual void GHOST_ISystem::getMainDisplayDimensions	(	uint32_t &	width,
		uint32_t &	height ) const

pure virtual

Returns the dimensions of the main display on this system.

Returns: The dimension of the main display.

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_GetMainDisplayDimensions().

◆ getMilliSeconds()

virtual uint64_t GHOST_ISystem::getMilliSeconds ( ) const

pure virtual

Returns the system time. Returns the number of milliseconds since the start of the system.

Note: The exact method used is platform dependent however monotonic methods should be used instead of wall-clock time.

Returns: The number of milliseconds.

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_System::dispatchEvents(), GHOST_GetMilliSeconds(), and GHOST_System::installTimer().

◆ getModifierKeyState()

virtual GHOST_TSuccess GHOST_ISystem::getModifierKeyState	(	GHOST_TModifierKey	mask,
		bool &	is_down ) const

pure virtual

Returns the state of a modifier key (outside the message queue).

Parameters

mask	The modifier key state to retrieve.
is_down	The state of a modifier key (true == pressed).

Returns: Indication of success.

Implemented in GHOST_System.

References mask().

Referenced by GHOST_GetModifierKeyState().

◆ getNumDisplays()

virtual uint8_t GHOST_ISystem::getNumDisplays ( ) const

pure virtual

Returns the number of displays on this system.

Returns: The number of displays.

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_GetNumDisplays().

◆ getPixelAtCursor()

virtual GHOST_TSuccess GHOST_ISystem::getPixelAtCursor ( float r_color[3] ) const

pure virtual

Get the color of the pixel at the current mouse cursor location

Parameters

r_color returned sRGB float colors

Returns: Success value (true == successful and supported by platform)

Implemented in GHOST_System, GHOST_SystemCocoa, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_GetPixelAtCursor().

◆ getSystem()

GHOST_ISystem * GHOST_ISystem::getSystem ( )

static

Returns a pointer to the one and only system (nil if it hasn't been created).

Returns: A pointer to the system.

Definition at line 249 of file GHOST_ISystem.cc.

References GHOST_ISystem(), and system_.

◆ getSystemBackend()

const char * GHOST_ISystem::getSystemBackend ( )

static

Return an identifier for the one and only system.

Warning: while it may be tempting this should never be used to check for supported features, in that case, the GHOST API should be extended to query capabilities. This is needed for X11/WAYLAND on Unix, without this - there is no convenient way for users to check if WAYLAND or XWAYLAND are in use since they are dynamically selected at startup. When dynamically switching between X11/WAYLAND is removed, this function can go too.

Definition at line 254 of file GHOST_ISystem.cc.

References system_backend_id_.

Referenced by GHOST_SystemBackend().

◆ getUseWindowFrame()

bool GHOST_ISystem::getUseWindowFrame ( )

static

Definition at line 269 of file GHOST_ISystem.cc.

References use_window_frame_.

Referenced by createSystem(), GHOST_SystemWayland::GHOST_SystemWayland(), and GHOST_WindowX11::GHOST_WindowX11().

◆ getWindowUnderCursor()

virtual GHOST_IWindow * GHOST_ISystem::getWindowUnderCursor	(	int32_t	x,
		int32_t	y )

pure virtual

Get the Window under the cursor. Although coordinates of the mouse are supplied, platform- specific implementations are free to ignore these and query the mouse location themselves, due to them possibly being incorrect under certain conditions, for example when using multiple monitors that vary in scale and/or DPI.

Parameters

x	The x-coordinate of the cursor.
y	The y-coordinate of the cursor.

Returns: The window under the cursor or nullptr if none.

Implemented in GHOST_System, GHOST_SystemCocoa, GHOST_SystemHeadless, and GHOST_SystemWin32.

References x, and y.

Referenced by GHOST_GetWindowUnderCursor().

◆ hasClipboardImage()

virtual GHOST_TSuccess GHOST_ISystem::hasClipboardImage ( ) const

pure virtual

Returns GHOST_kSuccess if the clipboard contains an image.

Implemented in GHOST_System, GHOST_SystemCocoa, GHOST_SystemWayland, and GHOST_SystemWin32.

Referenced by GHOST_hasClipboardImage().

◆ init()

virtual GHOST_TSuccess GHOST_ISystem::init ( )

protectedpure virtual

Initialize the system.

Returns: Indication of success.

Implemented in GHOST_System, GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

◆ initDebug()

virtual void GHOST_ISystem::initDebug ( GHOST_Debug debug )

pure virtual

Specify whether debug messages are to be shown.

Parameters

debug Flag for systems to debug.

Implemented in GHOST_System, and GHOST_SystemWin32.

Referenced by GHOST_SystemInitDebug().

◆ installTimer()

virtual GHOST_ITimerTask * GHOST_ISystem::installTimer	(	uint64_t	delay,
		uint64_t	interval,
		GHOST_TimerProcPtr	timer_proc,
		GHOST_TUserDataPtr	user_data = nullptr )

pure virtual

Installs a timer.

Note: On most operating systems, messages need to be processed in order for the timer callbacks to be invoked.

Parameters

delay	The time to wait for the first call to the #timer_proc (in milliseconds).
interval	The interval between calls to the #timer_proc.
timer_proc	The callback invoked when the interval expires.
user_data	Placeholder for user data.

Returns: A timer task (0 if timer task installation failed).

Implemented in GHOST_System.

Referenced by Application::Application(), and GHOST_InstallTimer().

◆ isDebugEnabled()

virtual bool GHOST_ISystem::isDebugEnabled ( )

pure virtual

Check whether debug messages are to be shown.

Implemented in GHOST_System.

Referenced by GHOST_X11_ApplicationErrorHandler(), and GHOST_X11_ApplicationIOErrorHandler().

◆ processEvents()

virtual bool GHOST_ISystem::processEvents ( bool waitForEvent )

pure virtual

Retrieves events from the system and stores them in the queue.

Parameters

waitForEvent Flag to wait for an event (or return immediately).

Returns: Indication of the presence of events.

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_ProcessEvents().

◆ putClipboard()

virtual void GHOST_ISystem::putClipboard	(	const char *	buffer,
		bool	selection ) const

pure virtual

Put data to the Clipboard

Parameters

buffer	The buffer to copy to the clipboard.
selection	The clipboard to copy too only used on X11.

Implemented in GHOST_System, GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_putClipboard().

◆ putClipboardImage()

virtual GHOST_TSuccess GHOST_ISystem::putClipboardImage	(	uint *	rgba,
		int	width,
		int	height ) const

pure virtual

Put image data to the Clipboard

Parameters

rgba	uint array in RGBA byte order.
width	the image width in pixels.
height	the image height in pixels.

Implemented in GHOST_System, GHOST_SystemCocoa, GHOST_SystemWayland, and GHOST_SystemWin32.

Referenced by GHOST_putClipboardImage().

◆ removeEventConsumer()

virtual GHOST_TSuccess GHOST_ISystem::removeEventConsumer ( GHOST_IEventConsumer * consumer )

pure virtual

Removes the given event consumer to our list.

Parameters

consumer The event consumer to remove.

Returns: Indication of success.

Implemented in GHOST_System.

Referenced by GHOST_RemoveEventConsumer().

◆ removeTimer()

virtual GHOST_TSuccess GHOST_ISystem::removeTimer ( GHOST_ITimerTask * timerTask )

pure virtual

Removes a timer.

Parameters

timerTask Timer task to be removed.

Returns: Indication of success.

Implemented in GHOST_System.

Referenced by GHOST_RemoveTimer().

◆ setAutoFocus()

virtual void GHOST_ISystem::setAutoFocus ( const bool auto_focus )

pure virtual

Focus and raise windows on mouse hover.

Implemented in GHOST_System.

Referenced by GHOST_SetAutoFocus().

◆ setBacktraceFn()

void GHOST_ISystem::setBacktraceFn ( GHOST_TBacktraceFn backtrace_fn )

static

Definition at line 264 of file GHOST_ISystem.cc.

References backtrace_fn_.

Referenced by GHOST_SetBacktraceHandler().

◆ setConsoleWindowState()

virtual bool GHOST_ISystem::setConsoleWindowState ( GHOST_TConsoleWindowState action )

pure virtual

Set the Console State

Parameters

action console state

Returns: current status (true: visible, 0: hidden)

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_setConsoleWindowState().

◆ setCursorPosition()

virtual GHOST_TSuccess GHOST_ISystem::setCursorPosition	(	int32_t	x,
		int32_t	y )

pure virtual

Updates the location of the cursor (location in screen coordinates). Not all operating systems allow the cursor to be moved (without the input device being moved).

Parameters

x	The x-coordinate of the cursor.
y	The y-coordinate of the cursor.

Returns: Indication of success.

Implemented in GHOST_SystemCocoa, GHOST_SystemHeadless, GHOST_SystemSDL, GHOST_SystemWayland, GHOST_SystemWin32, and GHOST_SystemX11.

References x, and y.

Referenced by GHOST_System::setCursorPositionClientRelative().

◆ setCursorPositionClientRelative()

virtual GHOST_TSuccess GHOST_ISystem::setCursorPositionClientRelative	(	GHOST_IWindow *	window,
		int32_t	x,
		int32_t	y )

pure virtual

Updates the location of the cursor (location in window coordinates).

Parameters

x	The x-coordinate of the cursor.
y	The y-coordinate of the cursor.

Returns: Indication of success.

Implemented in GHOST_System, and GHOST_SystemWayland.

References x, and y.

Referenced by GHOST_SetCursorPosition().

◆ setMultitouchGestures()

virtual void GHOST_ISystem::setMultitouchGestures ( const bool use )

pure virtual

Enable multi-touch gestures if supported.

Parameters

use	Enable or disable.

Implemented in GHOST_System, and GHOST_SystemWayland.

Referenced by GHOST_SetMultitouchGestures().

◆ setTabletAPI()

virtual void GHOST_ISystem::setTabletAPI ( GHOST_TTabletAPI api )

pure virtual

Set which tablet API to use. Only affects Windows, other platforms have a single API.

Parameters

api	Enum indicating which API to use.

Implemented in GHOST_System, and GHOST_SystemWin32.

Referenced by GHOST_SetTabletAPI().

◆ setUseWindowFrame()

void GHOST_ISystem::setUseWindowFrame ( bool use_window_frame )

static

Definition at line 274 of file GHOST_ISystem.cc.

References use_window_frame_.

Referenced by GHOST_UseWindowFrame().

◆ showMessageBox()

virtual GHOST_TSuccess GHOST_ISystem::showMessageBox	(	const char *	,
		const char *	,
		const char *	,
		const char *	,
		const char *	,
		GHOST_DialogOptions	) const

pure virtual

Show a system message box

Parameters

title	The title of the message box.
message	The message to display.
help_label	Help button label.
continue_label	Continue button label.
link	An optional hyperlink.
dialog_options	Options how to display the message.

Implemented in GHOST_System, GHOST_SystemCocoa, GHOST_SystemWin32, and GHOST_SystemX11.

Referenced by GHOST_ShowMessageBox().

◆ useNativePixel()

virtual bool GHOST_ISystem::useNativePixel ( )

pure virtual

Native pixel size support (MacBook 'retina').

Returns: The pixel size in float.

Implemented in GHOST_System.

Referenced by GHOST_UseNativePixels().

◆ useWindowFocus()

virtual void GHOST_ISystem::useWindowFocus ( const bool use_focus )

pure virtual

Focus window after opening, or put them in the background.

Implemented in GHOST_System.

Referenced by GHOST_UseWindowFocus().

◆ validWindow()

virtual bool GHOST_ISystem::validWindow ( GHOST_IWindow * window )

pure virtual

Returns whether a window is valid.

Parameters

window Pointer to the window to be checked.

Returns: Indication of validity.

Implemented in GHOST_System.

Referenced by GHOST_ValidWindow().

Member Data Documentation

◆ backtrace_fn_

GHOST_TBacktraceFn GHOST_ISystem::backtrace_fn_ = nullptr

staticprotected

Function to call that sets the back-trace.

Definition at line 545 of file GHOST_ISystem.hh.

Referenced by getBacktraceFn(), and setBacktraceFn().

◆ system_

GHOST_ISystem * GHOST_ISystem::system_ = nullptr

staticprotected

The one and only system

Definition at line 541 of file GHOST_ISystem.hh.

Referenced by createSystem(), createSystemBackground(), disposeSystem(), and getSystem().

◆ system_backend_id_

const char * GHOST_ISystem::system_backend_id_ = nullptr

staticprotected

Definition at line 542 of file GHOST_ISystem.hh.

Referenced by createSystem(), and getSystemBackend().

◆ use_window_frame_

bool GHOST_ISystem::use_window_frame_ = true

staticprotected

When false, don't use window frame.

Note: This needs to be set before system initialization to avoid loading LIBDECOR libraries (which can crash). If LIBDECOR is removed, this could be set on window creation instead.

Definition at line 554 of file GHOST_ISystem.hh.

Referenced by getUseWindowFrame(), and setUseWindowFrame().

The documentation for this interface was generated from the following files:

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ GHOST_ISystem()

◆ ~GHOST_ISystem()

Member Function Documentation

◆ addEventConsumer()

◆ createOffscreenContext()

◆ createSystem()

◆ createSystemBackground()

◆ createWindow()

◆ dispatchEvents()

◆ disposeContext()

◆ disposeSystem()

◆ disposeWindow()

◆ exit()

◆ getAllDisplayDimensions()

◆ getBacktraceFn()

◆ getButtonState()

◆ getCapabilities()

◆ getClipboard()

◆ getClipboardImage()

◆ getCursorPosition()

◆ getCursorPositionClientRelative()

◆ getCursorPreferredLogicalSize()

◆ getMainDisplayDimensions()

◆ getMilliSeconds()

◆ getModifierKeyState()

◆ getNumDisplays()

◆ getPixelAtCursor()

◆ getSystem()

◆ getSystemBackend()

◆ getUseWindowFrame()

◆ getWindowUnderCursor()

◆ hasClipboardImage()

◆ init()

◆ initDebug()

◆ installTimer()

◆ isDebugEnabled()

◆ processEvents()

◆ putClipboard()

◆ putClipboardImage()

◆ removeEventConsumer()

◆ removeTimer()

◆ setAutoFocus()

◆ setBacktraceFn()

◆ setConsoleWindowState()

◆ setCursorPosition()

◆ setCursorPositionClientRelative()

◆ setMultitouchGestures()

◆ setTabletAPI()

◆ setUseWindowFrame()

◆ showMessageBox()

◆ useNativePixel()

◆ useWindowFocus()

◆ validWindow()

Member Data Documentation

◆ backtrace_fn_

◆ system_

◆ system_backend_id_

◆ use_window_frame_