impeller::testing::MockGLES Class Reference

Provides a mocked version of the |ProcTableGLES| class. More...

#include <mock_gles.h>

Public Member Functions
const ProcTableGLES &	GetProcTable () const
	Returns a configured |ProcTableGLES| instance.
	~MockGLES ()
IMockGLESImpl *	GetImpl ()

Static Public Member Functions
static std::shared_ptr< MockGLES >	Init (std::unique_ptr< MockGLESImpl > impl, const std::optional< std::vector< const char * > > &extensions=std::nullopt, const char *version_string="OpenGL ES 3.0")
static std::shared_ptr< MockGLES >	Init (const std::optional< std::vector< const char * > > &extensions=std::nullopt, const char *version_string="OpenGL ES 3.0", ProcTableGLES::Resolver resolver=kMockResolverGLES)
	Returns an initialized |MockGLES| instance.

Friends
void	RecordGLCall (const char *name)
void	mockGenTextures (GLsizei n, GLuint *textures)

Detailed Description

Provides a mocked version of the |ProcTableGLES| class.

Typically, Open GLES at runtime will be provided the host's GLES bindings (as function pointers). This class maintains a set of function pointers that appear to be GLES functions, but are actually just stubs that record invocations.

See README.md for more information.

Definition at line 259 of file mock_gles.h.

Constructor & Destructor Documentation

~MockGLES()

impeller::testing::MockGLES::~MockGLES

(

)

Definition at line 479 of file mock_gles.cc.

                    {
  g_test_lock.unlock();
}

References impeller::testing::g_test_lock.

Member Function Documentation

GetImpl()

IMockGLESImpl * impeller::testing::MockGLES::GetImpl ( )

inline

Definition at line 281 of file mock_gles.h.

{ return impl_.get(); }

GetProcTable()

const ProcTableGLES & impeller::testing::MockGLES::GetProcTable ( ) const

inline

Returns a configured |ProcTableGLES| instance.

Definition at line 277 of file mock_gles.h.

{ return proc_table_; }

Init() [1/2]

std::shared_ptr< MockGLES > impeller::testing::MockGLES::Init ( const std::optional< std::vector< const char * > > &  extensions = std::nullopt, const char *  version_string = "OpenGL ES 3.0", ProcTableGLES::Resolver  resolver = kMockResolverGLES  )

static

Returns an initialized |MockGLES| instance.

This method overwrites mocked global GLES function pointers to record invocations on this instance of |MockGLES|. As such, it should only be called once per test.

Definition at line 381 of file mock_gles.cc.

                                    {
  // If we cannot obtain a lock, MockGLES is already being used elsewhere.
  FML_CHECK(g_test_lock.try_lock())
      << "MockGLES is already being used by another test.";
  g_extensions = extensions.value_or(kExtensions);
  g_extensions_string.clear();
  for (const auto& ext : g_extensions) {
    if (!g_extensions_string.empty()) {
      g_extensions_string += " ";
    }
    g_extensions_string += ext;
  }
  g_version = version_string;
  auto mock_gles = std::shared_ptr<MockGLES>(new MockGLES(std::move(resolver)));
  g_mock_gles = mock_gles;
  return mock_gles;
}

References FML_CHECK, impeller::testing::g_extensions, impeller::testing::g_extensions_string, impeller::testing::g_mock_gles, impeller::testing::g_test_lock, impeller::testing::g_version, and impeller::testing::kExtensions.

Init() [2/2]

std::shared_ptr< MockGLES > impeller::testing::MockGLES::Init ( std::unique_ptr< MockGLESImpl >  impl, const std::optional< std::vector< const char * > > &  extensions = std::nullopt, const char *  version_string = "OpenGL ES 3.0"  )

static

Definition at line 360 of file mock_gles.cc.

                                {
  FML_CHECK(g_test_lock.try_lock())
      << "MockGLES is already being used by another test.";
  g_extensions = extensions.value_or(kExtensions);
  g_extensions_string.clear();
  for (const auto& ext : g_extensions) {
    if (!g_extensions_string.empty()) {
      g_extensions_string += " ";
    }
    g_extensions_string += ext;
  }
  g_version = version_string;
  auto mock_gles = std::shared_ptr<MockGLES>(new MockGLES());
  mock_gles->impl_ = std::move(impl);
  g_mock_gles = mock_gles;
  return mock_gles;
}

References FML_CHECK, impeller::testing::g_extensions, impeller::testing::g_extensions_string, impeller::testing::g_mock_gles, impeller::testing::g_test_lock, impeller::testing::g_version, and impeller::testing::kExtensions.

Referenced by impeller::testing::RenderPassGLESViewportTest::CreateRenderPassGLESContext(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST(), impeller::testing::TEST_P(), and impeller::testing::TEST_P().

Friends And Related Symbol Documentation

mockGenTextures

void mockGenTextures ( GLsizei  n, GLuint *  textures  )

friend

Definition at line 236 of file mock_gles.cc.

                                                  {
  CallMockMethod(&IMockGLESImpl::GenTextures, n, textures);
}

RecordGLCall

void RecordGLCall ( const char *  name )

friend

---

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

• impeller/renderer/backend/gles/test/mock_gles.h
• impeller/renderer/backend/gles/test/mock_gles.cc