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. More...

std::vector< std::string >	GetCapturedCalls ()
	Returns a vector of the names of all recorded calls. More...

	~MockGLES ()

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

Friends
void	RecordGLCall (const char *name)

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 26 of file mock_gles.h.

Constructor & Destructor Documentation

◆ ~MockGLES()

impeller::testing::MockGLES::~MockGLES ( )

Definition at line 213 of file mock_gles.cc.

                    {
  g_test_lock.unlock();
}

Member Function Documentation

◆ GetCapturedCalls()

std::vector< std::string > impeller::testing::MockGLES::GetCapturedCalls ( )

inline

Returns a vector of the names of all recorded calls.

Calls are cleared after this method is called.

Definition at line 45 of file mock_gles.h.

                                          {
    std::vector<std::string> calls = captured_calls_;
    captured_calls_.clear();
    return calls;
  }

◆ GetProcTable()

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

inline

Returns a configured |ProcTableGLES| instance.

Definition at line 40 of file mock_gles.h.

40{ return proc_table_; }

◆ Init()

std::shared_ptr< MockGLES > impeller::testing::MockGLES::Init	(	const std::optional< std::vector< const unsigned 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 166 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_version = (unsigned char*)version_string;
  g_extensions = extensions.value_or(kExtensions);
  auto mock_gles = std::shared_ptr<MockGLES>(new MockGLES(std::move(resolver)));
  g_mock_gles = mock_gles;
  return mock_gles;
}

Friends And Related Function Documentation

◆ RecordGLCall

void RecordGLCall ( const char * name )

friend

Definition at line 29 of file mock_gles.cc.

                                    {
  if (auto mock_gles = g_mock_gles.lock()) {
    mock_gles->RecordCall(name);
  }
}

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

Public Member Functions

Static Public Member Functions

Friends