An instance of an EGL context. More...

#include <context.h>

Public Types
enum class	LifecycleEvent { kDidMakeCurrent , kWillClearCurrent }

using	LifecycleListener = std::function< void(LifecycleEvent)>

Public Member Functions
	~Context ()

bool	IsValid () const
	Determines if a valid context could be created. The context still needs to be made current on the thread for it to be useful. More...

const EGLContext &	GetHandle () const
	Get the underlying handle to the EGL context. More...

bool	MakeCurrent (const Surface &surface) const
	Make the context current on the calling thread. It is the caller responsibility to ensure that any context previously current on the thread must be cleared via `ClearCurrent`. More...

bool	ClearCurrent () const
	Clear the thread association of this context. More...

std::optional< UniqueID >	AddLifecycleListener (const LifecycleListener &listener)
	Add a listener that gets invoked when the context is made and cleared current from the thread. Applications typically use this to manage workers that schedule OpenGL API calls that need to be careful about the context being current when called. More...

bool	RemoveLifecycleListener (UniqueID id)
	Remove a previously added context listener. More...

bool	IsCurrent () const

Friends
class	Display

Detailed Description

An instance of an EGL context.

        An EGL context can only be used on a single thread at a given
        time. A thread can only have a single context current at any
        given time.

        Context cannot be created directly. Only a valid instance of an
        egl::Display can create a context.

Definition at line 30 of file context.h.

Member Typedef Documentation

◆ LifecycleListener

using impeller::egl::Context::LifecycleListener = std::function<void(LifecycleEvent)>

Definition at line 75 of file context.h.

Member Enumeration Documentation

◆ LifecycleEvent

enum impeller::egl::Context::LifecycleEvent

strong

Enumerator
kDidMakeCurrent
kWillClearCurrent

Definition at line 71 of file context.h.

                             {
     kDidMakeCurrent,
     kWillClearCurrent,
   };

Constructor & Destructor Documentation

◆ ~Context()

impeller::egl::Context::~Context ( )

Definition at line 15 of file context.cc.

                   {
   if (context_ != EGL_NO_CONTEXT) {
     if (::eglDestroyContext(display_, context_) != EGL_TRUE) {
       IMPELLER_LOG_EGL_ERROR;
     }
   }
 }

References IMPELLER_LOG_EGL_ERROR.

Member Function Documentation

◆ AddLifecycleListener()

std::optional< UniqueID > impeller::egl::Context::AddLifecycleListener ( const LifecycleListener & listener )

Add a listener that gets invoked when the context is made and cleared current from the thread. Applications typically use this to manage workers that schedule OpenGL API calls that need to be careful about the context being current when called.

Parameters

[in] listener The listener

Returns: A unique ID for the listener that can used used in RemoveLifecycleListener to remove a previously added listener.

Definition at line 74 of file context.cc.

                                        {
   if (!listener) {
     return std::nullopt;
   }
   WriterLock lock(listeners_mutex_);
   UniqueID id;
   listeners_[id] = listener;
   return id;
 }

◆ ClearCurrent()

bool impeller::egl::Context::ClearCurrent ( ) const

Clear the thread association of this context.

Returns: If the thread association could be cleared.

Definition at line 61 of file context.cc.

                                  {
   DispatchLifecyleEvent(LifecycleEvent::kWillClearCurrent);
   const auto result = EGLMakeCurrentIfNecessary(display_,        //
                                                 EGL_NO_SURFACE,  //
                                                 EGL_NO_SURFACE,  //
                                                 EGL_NO_CONTEXT   //
                                                 ) == EGL_TRUE;
   if (!result) {
     IMPELLER_LOG_EGL_ERROR;
   }
   return result;
 }

References impeller::egl::EGLMakeCurrentIfNecessary(), and IMPELLER_LOG_EGL_ERROR.

Referenced by impeller::glvk::AutoTrampolineContext::~AutoTrampolineContext().

◆ GetHandle()

const EGLContext & impeller::egl::Context::GetHandle ( ) const

Get the underlying handle to the EGL context.

Returns: The handle.

Definition at line 27 of file context.cc.

                                            {
   return context_;
 }

Referenced by impeller::egl::Display::CreateContext().

◆ IsCurrent()

bool impeller::egl::Context::IsCurrent ( ) const

Returns: True if the context is current and attached to any surface, False otherwise.

Definition at line 102 of file context.cc.

                               {
   return ::eglGetCurrentContext() == context_;
 }

Referenced by impeller::glvk::AutoTrampolineContext::AutoTrampolineContext().

◆ IsValid()

bool impeller::egl::Context::IsValid ( ) const

Determines if a valid context could be created. The context still needs to be made current on the thread for it to be useful.

Returns: True if valid, False otherwise.

Definition at line 23 of file context.cc.

                             {
   return context_ != EGL_NO_CONTEXT;
 }

◆ MakeCurrent()

bool impeller::egl::Context::MakeCurrent ( const Surface & surface ) const

Make the context current on the calling thread. It is the caller responsibility to ensure that any context previously current on the thread must be cleared via ClearCurrent.

@important The config used to create the surface must match the config used to create this context instance.

Parameters

[in] surface The surface to use to make the context current.

Returns: If the context could be made current on the callers thread.

Definition at line 45 of file context.cc.

                                                       {
   if (context_ == EGL_NO_CONTEXT) {
     return false;
   }
   const auto result = EGLMakeCurrentIfNecessary(display_,             //
                                                 surface.GetHandle(),  //
                                                 surface.GetHandle(),  //
                                                 context_              //
                                                 ) == EGL_TRUE;
   if (!result) {
     IMPELLER_LOG_EGL_ERROR;
   }
   DispatchLifecyleEvent(LifecycleEvent::kDidMakeCurrent);
   return result;
 }

References impeller::egl::EGLMakeCurrentIfNecessary(), impeller::egl::Surface::GetHandle(), and IMPELLER_LOG_EGL_ERROR.

Referenced by impeller::glvk::AutoTrampolineContext::AutoTrampolineContext().

◆ RemoveLifecycleListener()

bool impeller::egl::Context::RemoveLifecycleListener ( UniqueID id )

Remove a previously added context listener.

Parameters

[in] id The identifier obtained via a previous call to AddLifecycleListener.

Returns: True if the listener could be removed.

Definition at line 85 of file context.cc.

                                                  {
   WriterLock lock(listeners_mutex_);
   auto found = listeners_.find(id);
   if (found == listeners_.end()) {
     return false;
   }
   listeners_.erase(found);
   return true;
 }

Friends And Related Function Documentation

◆ Display

friend class Display

friend

Definition at line 109 of file context.h.

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

impeller/toolkit/egl/context.h
impeller/toolkit/egl/context.cc

Public Types

Public Member Functions

Friends

Detailed Description

Member Typedef Documentation

◆ LifecycleListener

Member Enumeration Documentation

◆ LifecycleEvent

Constructor & Destructor Documentation

◆ ~Context()

Member Function Documentation

◆ AddLifecycleListener()

◆ ClearCurrent()

◆ GetHandle()

◆ IsCurrent()

◆ IsValid()

◆ MakeCurrent()

◆ RemoveLifecycleListener()

Friends And Related Function Documentation

◆ Display