Provides a DUECA shell around a window with a Gtk4 GtkGlarea. More...

#include <DuecaGLGtk4Window.hxx>

Inheritance diagram for dueca::DuecaGLGtk4Window:

Collaboration diagram for dueca::DuecaGLGtk4Window:

Public Member Functions
	DuecaGLGtk4Window (const char *window_title="DUECA", bool pass_passive=false)
	Constructor.

	DuecaGLGtk4Window (const char *window_title, bool dummy1, bool dummy2, bool dummy3=true, bool dummy4=true, bool mouse_passive=true)
	Backwards compatible constructor.

	~DuecaGLGtk4Window ()
	Destructor.

bool	setFullScreen (const bool &fs=true)
	Request full screen drawing – or not.

bool	setWindow (const std::vector< int > &wpos)
	Set the window position, at least if the window manager will honour this.

void	setWindow (int posx, int poxy, int width, int height)
	Set up the window initial position and size.

void	openWindow ()
	Do the opening and displaying of the window.

void	placeWindow ()
	If position given, place the window.

void	selectCursor (int cursor)
	Select cursor type.

void	redraw ()
	Indicate that a redraw of the window is needed.

void	swapBuffers ()
	Swap front and back buffers.

void	selectGraphicsContext (bool do_select=true)
	Set the graphics content as current.

void	makeCurrent ()
	If you want to do GL work outside the draw routine (add GL lists etc.) the window needs to be current.

virtual void	display ()=0
	Function to implement in a derived class.

virtual void	initGL ()
	Function to implement in a derived class.

Detailed Description

Provides a DUECA shell around a window with a Gtk4 GtkGlarea.

After deriving from this class, you should implement the GL drawing routine.

You can also implement callbacks for reshape, initialisation and mouse and keyboard events, check DuecaGtkInteraction for these.

Note that these GL windows are primarily for testing. Using e.g. BareDuecaGLWindow you will get a window with lower overhead, that can also be run in a separate thread, blocking for the graphics refresh. Use that for serious deployment, and the GTK version for testing.

Constructor & Destructor Documentation

◆ DuecaGLGtk4Window() [1/2]

dueca::DuecaGLGtk4Window::DuecaGLGtk4Window	(	const char *	window_title = "DUECA",
		bool	pass_passive = false )

Constructor.

Parameters

window_title	Title for the window
pass_passive	For compatibility, passive movement always passed.

◆ DuecaGLGtk4Window() [2/2]

dueca::DuecaGLGtk4Window::DuecaGLGtk4Window	(	const char *	window_title,
		bool	dummy1,
		bool	dummy2,
		bool	dummy3 = true,
		bool	dummy4 = true,
		bool	mouse_passive = true )

Backwards compatible constructor.

Arguments, except mouse_passive, are ignored.

Member Function Documentation

◆ setFullScreen()

bool dueca::DuecaGLGtk4Window::setFullScreen ( const bool & fs = true )

Request full screen drawing – or not.

Can be linked to Scheme in a parameter table. This call is ignored for

◆ setWindow() [1/2]

bool dueca::DuecaGLGtk4Window::setWindow ( const std::vector< int > & wpos )

Set the window position, at least if the window manager will honour this.

Can be linked to Scheme in a parameter table. Use this call before opening the window with openWindow.

◆ setWindow() [2/2]

void dueca::DuecaGLGtk4Window::setWindow	(	int	posx,
		int	poxy,
		int	width,
		int	height )

Set up the window initial position and size.

Honouring of initial position depends on the window manager. Use this call before opening the window with openWindow.

◆ openWindow()

void dueca::DuecaGLGtk4Window::openWindow ( )

Do the opening and displaying of the window.

In your module, preferably place this call in the "complete()" method. At this time, all GL stuff is in place, while the system is normally not yet running real-time.

◆ selectCursor()

void dueca::DuecaGLGtk4Window::selectCursor ( int cursor )

Select cursor type.

0, no cursor
1, the same cursor as the master (root) window
2, a crosshair cursor
3, a right arrow pointer
4, a left arrow pointer

◆ selectGraphicsContext()

void dueca::DuecaGLGtk4Window::selectGraphicsContext ( bool do_select = true )

inline

Set the graphics content as current.

Note that this is normally not needed, in the initGL, display and reshape callbacks, the GC will be current. You can use this in your destructor, when GL objects are deleted, and you need a correct GC for that.

Parameters

do_select When false, resets the GC

◆ makeCurrent()

void dueca::DuecaGLGtk4Window::makeCurrent ( )

If you want to do GL work outside the draw routine (add GL lists etc.) the window needs to be current.

First call this routine in that case.

◆ display()

virtual void dueca::DuecaGLGtk4Window::display ( )

pure virtual

Function to implement in a derived class.

Can assume that the GL context is current, do not need a swap call at the end! Only draw!

◆ initGL()

virtual void dueca::DuecaGLGtk4Window::initGL ( )

virtual