#include <GlMainWidget.h>

Inherits QOpenGLWidget.

Public Types
enum	RenderingOption { RenderScene = 0x1 , SwapBuffers = 0x2 }

Public Slots
void	centerScene (bool graphChanged=false, float zoomFactor=1.0)

void	closeEvent (QCloseEvent *e) override

void	draw (bool graphChanged=true)

void	emitGraphChanged ()

void	redraw ()

Signals
void	closing (GlMainWidget , QCloseEvent )

void	glResized (int w, int h)

void	graphChanged ()

void	viewDrawn (GlMainWidget *glWidget, bool graphChanged)

void	viewRedrawn (GlMainWidget *glWidget)

Public Member Functions
	GlMainWidget (QWidget parent=nullptr, View view=nullptr)

void	computeInteractors ()

void	createPicture (const std::string &pictureName, int width, int height, bool center=true)

QImage	createPicture (int width, int height, bool center=true, QImage::Format format=QImage::Format_RGB32)

qreal	devicePixelRatio () const

void	doneCurrent ()

void	drawInteractors ()

tlp::GlScene *	getScene ()

bool	isCurrent ()

bool	keepScenePointOfViewOnSubgraphChanging () const

void	makeCurrent ()

bool	pickGlEntities (const int x, const int y, const int width, const int height, std::vector< SelectedEntity > &pickedEntities, tlp::GlLayer *layer=nullptr)

bool	pickGlEntities (const int x, const int y, std::vector< SelectedEntity > &pickedEntities, tlp::GlLayer *layer=nullptr)

void	pickNodesEdges (const int x, const int y, const int width, const int height, std::vector< SelectedEntity > &selectedNodes, std::vector< SelectedEntity > &selectedEdges, tlp::GlLayer *layer=nullptr, bool pickNodes=true, bool pickEdges=true)

bool	pickNodesEdges (const int x, const int y, SelectedEntity &selectedEntity, tlp::GlLayer *layer=nullptr, bool pickNodes=true, bool pickEdges=true)

void	render (RenderingOptions options=RenderingOptions(RenderScene\|SwapBuffers), bool checkVisibility=true)

void	resizeGL (int w, int h) override

Coord	screenToViewport (const Coord &point) const

double	screenToViewport (double l) const

int	screenToViewport (int l) const

void	setKeepScenePointOfViewOnSubgraphChanging (bool)

Coord	viewportToScreen (const Coord &point) const

double	viewportToScreen (double l) const

Static Public Member Functions
static void	getTextureRealSize (int width, int height, int &textureRealWidth, int &textureRealHeight)

Protected Slots
void	paintEvent (QPaintEvent *) override

Detailed Description

This widget provide a simple system to visualize data/graph with OpenGL 3D engine.

This widget is an interface between Qt Widget system and tulip OpenGL engine The central object of GlMainWidget is the GlScene member

See also: GlScene

To use this class you have to :

create a GlMainWidget
get the GlScene with getScene() function
add GlLayer and GlEntity to this scene
call centerScene() to compute a good GlCamera
see the result

See also: GlLayer; GlSimpleEntity

If you only want to visualize a graph, you can call the setGraph function

After scene construction you can perform some operation on GlMainWidget :

Selection with pickNodesEdges() and pickGlEntities()
Image output with getImage(), createPicture()
Texture output with createTexture()
others operation on GlScene and QGlWidget

Definition at line 63 of file GlMainWidget.h.

Member Enumeration Documentation

◆ RenderingOption

enum tlp::GlMainWidget::RenderingOption

Configure the rendering process ( see render function)

See also: render

Enumerator
SwapBuffers	Force to render the graph even if there is a previous buffered render. You need to call this option if the graph is updated to regenerate the buffer. If not set try to use the last buffered graph render, if there is no valid buffer this flag is forced.

Definition at line 71 of file GlMainWidget.h.

Constructor & Destructor Documentation

◆ GlMainWidget()

tlp::GlMainWidget::GlMainWidget	(	QWidget *	parent = `nullptr`,
		View *	view = `nullptr`
	)

Constructor of GlMainWidget.

Create a GlMainWidget with the GlScene associated to it

Parameters

parent	Qt Widget parent system
view	if you want to link this GlMainWidget to a view : use this parameter

Member Function Documentation

◆ centerScene

void tlp::GlMainWidget::centerScene	(	bool	graphChanged = `false`,
		float	zoomFactor = `1.0`
	)

slot

Convenience function that calls center function on the current scene, applies a zoom (if needed) and draws the view. Same thing than.

getScene()->centerScene();
getScene()->zoomFactor();
draw();

◆ closing

void tlp::GlMainWidget::closing	(	GlMainWidget *	,
		QCloseEvent *
	)

signal

This signal is emitted when the GlMainWidget will be deleted

◆ computeInteractors()

void tlp::GlMainWidget::computeInteractors ( )

Compute interactors before drawing

◆ createPicture() [1/2]

void tlp::GlMainWidget::createPicture	(	const std::string &	pictureName,
		int	width,
		int	height,
		bool	center = `true`
	)

Take a snapshot of the Widget and put it in a picture.

Parameters

width	size
height	size
center	if true this function calls a centerScene() before picture output

◆ createPicture() [2/2]

QImage tlp::GlMainWidget::createPicture	(	int	width,
		int	height,
		bool	center = `true`,
		QImage::Format	format = `QImage::Format_RGB32`
	)

Take a snapshot of the Widget and return it

Parameters

width	size
height	size
center	if true this function calls a centerScene() before picture output
format	indicates the format of the created image

◆ draw

void tlp::GlMainWidget::draw ( bool graphChanged = true )

slot

Draw the GlScene and the interactors

◆ drawInteractors()

void tlp::GlMainWidget::drawInteractors ( )

Draw interactors

◆ getScene()

tlp::GlScene* tlp::GlMainWidget::getScene ( )

inline

Get the GlScene of this GlMainWidget You have to add yours GlLayer and GlEntity to this GlScene At the construction this GlScene is empty.

See also: GlScene; GlScene::createLayer(const std::string &name); GlLayer::addGlEntity(GlSimpleEntity *entity,const std::string& name)

Definition at line 99 of file GlMainWidget.h.

Here is the caller graph for this function:

◆ getTextureRealSize()

static void tlp::GlMainWidget::getTextureRealSize	(	int	width,
		int	height,
		int &	textureRealWidth,
		int &	textureRealHeight
	)

static

Compute texture size in power of two with given height and width For example if you set width to 94 and height to 256, this function set textureRealWidth to 128 and textureRealHeight to 256.

◆ isCurrent()

bool tlp::GlMainWidget::isCurrent ( )

Indicates if this is associated to the current OpenGL context

◆ keepScenePointOfViewOnSubgraphChanging()

bool tlp::GlMainWidget::keepScenePointOfViewOnSubgraphChanging ( ) const

Returns if the scene point of view must be kept when changing between graphs belonging to the same hierarchy.

◆ makeCurrent()

void tlp::GlMainWidget::makeCurrent ( )

Override default makeCurrent/doneCurrent behavior to activate deactivate adequate OpenGL context based on the QOpenGLWidget visibility

◆ pickGlEntities() [1/2]

bool tlp::GlMainWidget::pickGlEntities	(	const int	x,
		const int	y,
		const int	width,
		const int	height,
		std::vector< SelectedEntity > &	pickedEntities,
		tlp::GlLayer *	layer = `nullptr`
	)

Function to do picking on entities in a screen region It just calls selectEntities on the GlScene instance.

Parameters

x	screen coordinates
y	screen coordinates
width	screen size
height	screen size
pickedEntities	filled with entity under the selection screen rectangle
layer	if you want to do the selection only on one GlLayer

◆ pickGlEntities() [2/2]

bool tlp::GlMainWidget::pickGlEntities	(	const int	x,
		const int	y,
		std::vector< SelectedEntity > &	pickedEntities,
		tlp::GlLayer *	layer = `nullptr`
	)

Function to do picking on entities. It just calls selectEntities on the GlScene instance with a small window of twelve pixels.

Parameters

x	screen coordinates
y	screen coordinates
pickedEntities	filled with entity under the selection screen rectangle
layer	if you want to do the selection only on one GlLayer

◆ pickNodesEdges() [1/2]

void tlp::GlMainWidget::pickNodesEdges	(	const int	x,
		const int	y,
		const int	width,
		const int	height,
		std::vector< SelectedEntity > &	selectedNodes,
		std::vector< SelectedEntity > &	selectedEdges,
		tlp::GlLayer *	layer = `nullptr`,
		bool	pickNodes = `true`,
		bool	pickEdges = `true`
	)

Select nodes and edges in a region of the screen.

Select all nodes and edges lying in the area of the screen of given width and height, and with its upper-left corner at (x,y)

Parameters

selectedNodes	filled by the method with the nodes found in the region
selectedEdges	filled by the method with the edges found in the region
layer	specify the layer in which to perform the picking
pickNodes	enable or disable the picking of nodes
pickEdges	enable or disable the picking of edges

◆ pickNodesEdges() [2/2]

bool tlp::GlMainWidget::pickNodesEdges	(	const int	x,
		const int	y,
		SelectedEntity &	selectedEntity,
		tlp::GlLayer *	layer = `nullptr`,
		bool	pickNodes = `true`,
		bool	pickEdges = `true`
	)

Select a node or edge at a screen point Try to select at point (x,y) a node in the first place then if no result try to select an edge.

Parameters

type	tells what has been found: NODE, EDGE
layer	specify the layer in which to perform the picking
pickNodes	enable or disable the picking of nodes
pickEdges	enable or disable the picking of edges

Returns: true if something has been found, false otherwise

◆ redraw

void tlp::GlMainWidget::redraw ( )

slot

This function is given for optimisation purpose only. If the hardware allows it, it enables to redraw only the Augmented display and the interactors and not the graph it is really useful for interactors such as zoom box etc.. Warning, if you change the graph or the properties of element (Colors, size, etc...) applying that function will not display the change, in that case, use the draw function.

◆ render()

void tlp::GlMainWidget::render	(	RenderingOptions	options = `RenderingOptions(RenderScene\|SwapBuffers)`,
		bool	checkVisibility = `true`
	)

This function performs all the rendering process of the graph. Use this function only for advanced purpose, if you want to perform simple rendering use the draw or redraw functions instead.

Parameters

options Configure the rendering process, see the RenderingOption documentation for more information on each rendering option effect.

See also: RenderingOption

Parameters

checkVisibility If check visibility is true : the engine check if GlMainWidget QWidget is visible. If false: the engine renders the scene in all cases

◆ resizeGL()

void tlp::GlMainWidget::resizeGL	(	int	w,
		int	h
	)

override

Resize openGL view

◆ screenToViewport() [1/3]

Coord tlp::GlMainWidget::screenToViewport ( const Coord & point ) const

inline

convert a screen point into a viewport point

Parameters

a	point in screen coordinates

Returns: the converted point in viewport coordinates

Definition at line 158 of file GlMainWidget.h.

◆ screenToViewport() [2/3]

double tlp::GlMainWidget::screenToViewport ( double l ) const

inline

convert a screen measure into a viewport measure

Parameters

a	measure in screen coordinates specified as a double

Returns: the converted measure in viewport coordinates as a double

Definition at line 149 of file GlMainWidget.h.

◆ screenToViewport() [3/3]

int tlp::GlMainWidget::screenToViewport ( int l ) const

inline

convert a screen measure into a viewport measure

Parameters

a	measure in screen coordinates specified as an integer

Returns: the converted measure in viewport coordinates as an integer

Definition at line 140 of file GlMainWidget.h.

◆ setKeepScenePointOfViewOnSubgraphChanging()

void tlp::GlMainWidget::setKeepScenePointOfViewOnSubgraphChanging ( bool )

Specify if the scene point of view must be kept when changing between graphs belonging to the same hierarchy.

◆ viewDrawn

void tlp::GlMainWidget::viewDrawn	(	GlMainWidget *	glWidget,
		bool	graphChanged
	)

signal

This signal is emitted when GlMainWidget::draw() is call

◆ viewportToScreen() [1/2]

Coord tlp::GlMainWidget::viewportToScreen ( const Coord & point ) const

inline

convert a viewport point into a screen point

Parameters

a	point in viewport coordinates

Returns: the converted point in screen coordinates

Definition at line 177 of file GlMainWidget.h.

◆ viewportToScreen() [2/2]

double tlp::GlMainWidget::viewportToScreen ( double l ) const

inline

convert a viewport measure into a screen measure

Parameters

a	measure in viewport coordinates specified as a double

Returns: the converted measure in screen coordinates as a double

Definition at line 168 of file GlMainWidget.h.

◆ viewRedrawn

void tlp::GlMainWidget::viewRedrawn ( GlMainWidget * glWidget )

signal

This signal is emitted when GlMainWidget::redraw() is call

Public Types

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Protected Slots

Detailed Description

Member Enumeration Documentation

◆ RenderingOption

Constructor & Destructor Documentation

◆ GlMainWidget()

Member Function Documentation

◆ centerScene

◆ closing

◆ computeInteractors()

◆ createPicture() [1/2]

◆ createPicture() [2/2]

◆ draw

◆ drawInteractors()

◆ getScene()

◆ getTextureRealSize()

◆ isCurrent()

◆ keepScenePointOfViewOnSubgraphChanging()

◆ makeCurrent()

◆ pickGlEntities() [1/2]

◆ pickGlEntities() [2/2]

◆ pickNodesEdges() [1/2]

◆ pickNodesEdges() [2/2]

◆ redraw

◆ render()

◆ resizeGL()

◆ screenToViewport() [1/3]

◆ screenToViewport() [2/3]

◆ screenToViewport() [3/3]

◆ setKeepScenePointOfViewOnSubgraphChanging()

◆ viewDrawn

◆ viewportToScreen() [1/2]

◆ viewportToScreen() [2/2]

◆ viewRedrawn