Class representing an EGL display connection. More...

#include <kanzi/platform/platform/context/egl/egl_display.hpp>

Public Member Functions
KZ_NO_DISCARD::EGLConfig	chooseConfig (int graphicsFormatID) const
	Gets EGL config handle from a graphics format ID.

KZ_NO_DISCARD::EGLConfig	chooseConfig (span< const EGLint > attribs) const
	Gets EGL config handle using eglChooseConfig and attribute list.

EGLImage	createImage (const EGLContext &eglContext, EGLenum target, void data, const EGLint attributes) noexcept
	Creates a new EGL image.

bool	destroyImage (EGLImage image) noexcept
	Destroys an EGL image.

	EGLDisplay ()
	Default constructor, creates a no display.

	EGLDisplay (::EGLDisplay eglDisplay)
	Constructor.

KZ_NO_DISCARD bool	getConfigAttributeValue (::EGLConfig eglConfig, EGLint attribute, EGLint &attributeValue) const noexcept
	Gets the value of an EGL config attribute.

KZ_NO_DISCARD EGLint	getConfigCount () const noexcept
	Gets the number of EGL configs available.

KZ_NO_DISCARD vector<::EGLConfig >	getConfigs () const noexcept
	Gets all EGL configs.

KZ_NO_DISCARD::EGLDisplay	getNativeHandle () const noexcept
	Gets EGL display handle.

EGLVersion	initialize ()
	Opens the EGL display connection.

bool	makeCurrent (const ::EGLSurface eglDrawSurface, const ::EGLSurface eglReadSurface, const ::EGLContext eglContext) const noexcept
	Binds surfaces to a context and the current thread.

bool	swapInterval (int interval)
	Sets minimum number of displayed video frames before a buffer swap.

bool	terminate ()
	Closes the EGL display connection.

Static Public Member Functions
static KZ_NO_DISCARD ::EGLDisplay	getCurrentDisplay () noexcept
	Gets the current EGL display.

static KZ_NO_DISCARD ::EGLNativeDisplayType	getDefaultDisplay () noexcept
	Gets default native display handle.

static KZ_NO_DISCARD ::EGLDisplay	getDisplay (::EGLNativeDisplayType nativeDisplay) noexcept
	Gets EGL display handle from native display handle.

static KZ_NO_DISCARD ::EGLDisplay	getNoDisplay () noexcept
	Gets an no display EGL handle.

Detailed Description

Class representing an EGL display connection.

A display connection may either be open or closed.

Constructor & Destructor Documentation

◆ EGLDisplay() [1/2]

kanzi::EGLDisplay::EGLDisplay ( )

explicit

Default constructor, creates a no display.

Postcondition: egl::getError() returns EGL_SUCCESS.

◆ EGLDisplay() [2/2]

kanzi::EGLDisplay::EGLDisplay ( ::EGLDisplay eglDisplay )

explicit

Constructor.

Parameters

eglDisplay EGL display handle.

Postcondition: egl::getError() returns EGL_SUCCESS.

Member Function Documentation

◆ getDefaultDisplay()

static KZ_NO_DISCARD ::EGLNativeDisplayType kanzi::EGLDisplay::getDefaultDisplay ( )

staticnoexcept

Gets default native display handle.

Returns: Default native display handle.

◆ getDisplay()

static KZ_NO_DISCARD ::EGLDisplay kanzi::EGLDisplay::getDisplay ( ::EGLNativeDisplayType nativeDisplay )

staticnoexcept

Gets EGL display handle from native display handle.

Parameters

nativeDisplay Native display handle.

Returns: Display handle.

◆ getCurrentDisplay()

static KZ_NO_DISCARD ::EGLDisplay kanzi::EGLDisplay::getCurrentDisplay ( )

staticnoexcept

Gets the current EGL display.

Returns: The current EGL display handle.

Since: Kanzi 4.0.0

◆ getNoDisplay()

static KZ_NO_DISCARD ::EGLDisplay kanzi::EGLDisplay::getNoDisplay ( )

staticnoexcept

Gets an no display EGL handle.

Returns: EGL display handle with a value representing no display.

◆ initialize()

EGLVersion kanzi::EGLDisplay::initialize ( )

Opens the EGL display connection.

This should be the first function called on a new display object. Use terminate() to close the open connection before destructing the object.

Returns: EGL version information.

◆ terminate()

bool kanzi::EGLDisplay::terminate ( )

Closes the EGL display connection.

Returns: True on success, false on failure.

◆ makeCurrent()

bool kanzi::EGLDisplay::makeCurrent	(	const ::EGLSurface	eglDrawSurface,
		const ::EGLSurface	eglReadSurface,
		const ::EGLContext	eglContext ) const

noexcept

Binds surfaces to a context and the current thread.

Parameters

eglDrawSurface	Surface bound as draw destination.
eglReadSurface	Surface bound as read source.
eglContext	Context to bind to.

Returns: True on success, false on failure.

◆ swapInterval()

bool kanzi::EGLDisplay::swapInterval ( int interval )

Sets minimum number of displayed video frames before a buffer swap.

Parameters

interval Minimum number of video frames to wait before buffer swap.

Returns: True on success, false on failure.

◆ createImage()

EGLImage kanzi::EGLDisplay::createImage	(	const EGLContext &	eglContext,
		EGLenum	target,
		void *	data,
		const EGLint *	attributes )

noexcept

Creates a new EGL image.

Use destroyImage() to destroy the created image.

Parameters

eglContext	Context for which the image is created.
target	The image source type.
data	The image source.
attributes	The image attributes

Returns: A new EGL image. The value is a no image on failure.

◆ destroyImage()

bool kanzi::EGLDisplay::destroyImage ( EGLImage image )

noexcept

Destroys an EGL image.

Parameters

image EGL image to destroy.

Returns: True on success, false on failure.

◆ chooseConfig() [1/2]

KZ_NO_DISCARD::EGLConfig kanzi::EGLDisplay::chooseConfig ( int graphicsFormatID ) const

Gets EGL config handle from a graphics format ID.

Parameters

graphicsFormatID Graphics format ID to use.

Returns: EGL config handle corresponding to the graphics format ID. The value is a no config if there was no match.

◆ chooseConfig() [2/2]

KZ_NO_DISCARD::EGLConfig kanzi::EGLDisplay::chooseConfig ( span< const EGLint > attribs ) const

Gets EGL config handle using eglChooseConfig and attribute list.

Parameters

attribs List of EGL attributes used to choose the config. The list must be terminated with EGL_NONE.

Returns: EGL config handle returned by kzsEGLChooseConfig. The value is a no config if there was no match.

◆ getConfigCount()

KZ_NO_DISCARD EGLint kanzi::EGLDisplay::getConfigCount ( ) const

noexcept

Gets the number of EGL configs available.

Returns: The number of EGL configs available.

◆ getConfigs()

KZ_NO_DISCARD vector<::EGLConfig > kanzi::EGLDisplay::getConfigs ( ) const

noexcept

Gets all EGL configs.

Returns: A vector of EGL config handles.

◆ getConfigAttributeValue()

KZ_NO_DISCARD bool kanzi::EGLDisplay::getConfigAttributeValue	(	::EGLConfig	eglConfig,
		EGLint	attribute,
		EGLint &	attributeValue ) const

noexcept

Gets the value of an EGL config attribute.

Parameters

eglConfig	EGL config to query.
attribute	The attribute to query.
attributeValue	Stores the value of the attribute.

Returns: True on success, false on failure.

◆ getNativeHandle()

KZ_NO_DISCARD::EGLDisplay kanzi::EGLDisplay::getNativeHandle ( ) const

noexcept

Gets EGL display handle.

Returns: EGL display handle.

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

kanzi/platform/platform/context/egl/egl_display.hpp

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ EGLDisplay() [1/2]

◆ EGLDisplay() [2/2]

Member Function Documentation

◆ getDefaultDisplay()

◆ getDisplay()

◆ getCurrentDisplay()

◆ getNoDisplay()

◆ initialize()

◆ terminate()

◆ makeCurrent()

◆ swapInterval()

◆ createImage()

◆ destroyImage()

◆ chooseConfig() [1/2]

◆ chooseConfig() [2/2]

◆ getConfigCount()

◆ getConfigs()

◆ getConfigAttributeValue()

◆ getNativeHandle()