#include <golden_playground_test.h>

Inheritance diagram for impeller::GoldenPlaygroundTest:

Classes
struct	GoldenPlaygroundTestImpl

Public Types
using	AiksPlaygroundCallback = std::function< std::optional< Picture >(AiksContext &renderer)>

using	AiksDlPlaygroundCallback = std::function< sk_sp< flutter::DisplayList >()>

Public Member Functions
	GoldenPlaygroundTest ()

	~GoldenPlaygroundTest () override

void	SetUp ()

void	TearDown ()

PlaygroundBackend	GetBackend () const

void	SetTypographerContext (std::shared_ptr< TypographerContext > typographer_context)

bool	OpenPlaygroundHere (Picture picture)

bool	OpenPlaygroundHere (AiksPlaygroundCallback callback)

bool	OpenPlaygroundHere (const AiksDlPlaygroundCallback &callback)

bool	OpenPlaygroundHere (const sk_sp< flutter::DisplayList > &list)

std::shared_ptr< Texture >	CreateTextureForFixture (const char *fixture_name, bool enable_mipmapping=false) const

sk_sp< flutter::DlImage >	CreateDlImageForFixture (const char *fixture_name, bool enable_mipmapping=false) const

RuntimeStage::Map	OpenAssetAsRuntimeStage (const char *asset_name) const

std::shared_ptr< Context >	GetContext () const

std::shared_ptr< Context >	MakeContext () const

Point	GetContentScale () const

Scalar	GetSecondsElapsed () const

ISize	GetWindowSize () const

fml::Status	SetCapabilities (const std::shared_ptr< Capabilities > &capabilities)

bool	WillRenderSomething () const

Static Public Member Functions
static bool	ImGuiBegin (const char name, bool p_open, ImGuiWindowFlags flags)

Protected Member Functions
void	SetWindowSize (ISize size)

Detailed Description

Definition at line 25 of file golden_playground_test.h.

Member Typedef Documentation

◆ AiksDlPlaygroundCallback

using impeller::GoldenPlaygroundTest::AiksDlPlaygroundCallback = std::function<sk_sp<flutter::DisplayList>()>

Definition at line 31 of file golden_playground_test.h.

◆ AiksPlaygroundCallback

using impeller::GoldenPlaygroundTest::AiksPlaygroundCallback = std::function<std::optional<Picture>(AiksContext& renderer)>

Definition at line 29 of file golden_playground_test.h.

Constructor & Destructor Documentation

◆ GoldenPlaygroundTest()

impeller::GoldenPlaygroundTest::GoldenPlaygroundTest ( )

default

Definition at line 119 of file golden_playground_test_mac.cc.

120 : typographer_context_(TypographerContextSkia::Make()),

121 pimpl_(new GoldenPlaygroundTest::GoldenPlaygroundTestImpl()) {}

◆ ~GoldenPlaygroundTest()

impeller::GoldenPlaygroundTest::~GoldenPlaygroundTest ( )

overridedefault

Member Function Documentation

◆ CreateDlImageForFixture()

sk_sp< flutter::DlImage > impeller::GoldenPlaygroundTest::CreateDlImageForFixture	(	const char *	fixture_name,
		bool	enable_mipmapping = `false`
	)		const

Definition at line 278 of file golden_playground_test_mac.cc.

                                   {
   std::shared_ptr<Texture> texture =
       CreateTextureForFixture(fixture_name, enable_mipmapping);
   return DlImageImpeller::Make(texture);
 }

References CreateTextureForFixture(), and impeller::DlImageImpeller::Make().

◆ CreateTextureForFixture()

std::shared_ptr< Texture > impeller::GoldenPlaygroundTest::CreateTextureForFixture	(	const char *	fixture_name,
		bool	enable_mipmapping = `false`
	)		const

Definition at line 265 of file golden_playground_test_mac.cc.

                                   {
   std::shared_ptr<fml::Mapping> mapping =
       flutter::testing::OpenFixtureAsMapping(fixture_name);
   auto result = Playground::CreateTextureForMapping(GetContext(), mapping,
                                                     enable_mipmapping);
   if (result) {
     result->SetLabel(fixture_name);
   }
   return result;
 }

References impeller::Playground::CreateTextureForMapping(), and GetContext().

Referenced by CreateDlImageForFixture().

◆ GetBackend()

PlaygroundBackend impeller::GoldenPlaygroundTest::GetBackend ( ) const

Definition at line 201 of file golden_playground_test_mac.cc.

                                                          {
   return GetParam();
 }

◆ GetContentScale()

Point impeller::GoldenPlaygroundTest::GetContentScale ( ) const

Definition at line 319 of file golden_playground_test_mac.cc.

                                                   {
   return pimpl_->screenshotter->GetPlayground().GetContentScale();
 }

◆ GetContext()

std::shared_ptr< Context > impeller::GoldenPlaygroundTest::GetContext ( ) const

Definition at line 296 of file golden_playground_test_mac.cc.

                                                               {
   return pimpl_->screenshotter->GetPlayground().GetContext();
 }

Referenced by CreateTextureForFixture(), MakeContext(), OpenPlaygroundHere(), and SetUp().

◆ GetSecondsElapsed()

Scalar impeller::GoldenPlaygroundTest::GetSecondsElapsed ( ) const

Definition at line 323 of file golden_playground_test_mac.cc.

                                                      {
   return 0.0f;
 }

◆ GetWindowSize()

ISize impeller::GoldenPlaygroundTest::GetWindowSize ( ) const

Definition at line 327 of file golden_playground_test_mac.cc.

                                                 {
   return pimpl_->window_size;
 }

◆ ImGuiBegin()

bool impeller::GoldenPlaygroundTest::ImGuiBegin	(	const char *	name,
		bool *	p_open,
		ImGuiWindowFlags	flags
	)

static

Definition at line 259 of file golden_playground_test_mac.cc.

                                                               {
   return false;
 }

◆ MakeContext()

std::shared_ptr< Context > impeller::GoldenPlaygroundTest::MakeContext ( ) const

On Metal we create a context for each test.

On OpenGL we create a context for each test.

Definition at line 300 of file golden_playground_test_mac.cc.

                                                                {
   if (GetParam() == PlaygroundBackend::kMetal) {
     /// On Metal we create a context for each test.
     return GetContext();
   } else if (GetParam() == PlaygroundBackend::kVulkan) {
     bool enable_vulkan_validations = true;
     FML_CHECK(!pimpl_->test_vulkan_playground)
         << "We don't support creating multiple contexts for one test";
     pimpl_->test_vulkan_playground =
         MakeVulkanPlayground(enable_vulkan_validations);
     pimpl_->screenshotter = std::make_unique<testing::VulkanScreenshotter>(
         pimpl_->test_vulkan_playground);
     return pimpl_->test_vulkan_playground->GetContext();
   } else {
     /// On OpenGL we create a context for each test.
     return GetContext();
   }
 }

References GetContext(), impeller::kMetal, and impeller::kVulkan.

◆ OpenAssetAsRuntimeStage()

RuntimeStage::Map impeller::GoldenPlaygroundTest::OpenAssetAsRuntimeStage ( const char * asset_name ) const

Definition at line 286 of file golden_playground_test_mac.cc.

                                   {
   const std::shared_ptr<fml::Mapping> fixture =
       flutter::testing::OpenFixtureAsMapping(asset_name);
   if (!fixture || fixture->GetSize() == 0) {
     return {};
   }
   return RuntimeStage::DecodeRuntimeStages(fixture);
 }

References impeller::RuntimeStage::DecodeRuntimeStages().

◆ OpenPlaygroundHere() [1/4]

bool impeller::GoldenPlaygroundTest::OpenPlaygroundHere ( AiksPlaygroundCallback callback )

Definition at line 232 of file golden_playground_test_mac.cc.

                   {  // NOLINT(performance-unnecessary-value-param)
   AiksContext renderer(GetContext(), typographer_context_);
  
   std::optional<Picture> picture;
   std::unique_ptr<testing::Screenshot> screenshot;
   for (int i = 0; i < 2; ++i) {
     picture = callback(renderer);
     if (!picture.has_value()) {
       return false;
     }
     screenshot = pimpl_->screenshotter->MakeScreenshot(
         renderer, picture.value(), pimpl_->window_size);
   }
  
   return SaveScreenshot(std::move(screenshot));
 }

References GetContext().

◆ OpenPlaygroundHere() [2/4]

bool impeller::GoldenPlaygroundTest::OpenPlaygroundHere ( const AiksDlPlaygroundCallback & callback )

Definition at line 213 of file golden_playground_test_mac.cc.

                                               {
   AiksContext renderer(GetContext(), typographer_context_);
  
   std::optional<Picture> picture;
   std::unique_ptr<testing::Screenshot> screenshot;
   for (int i = 0; i < 2; ++i) {
     auto display_list = callback();
     DlDispatcher dispatcher;
     display_list->Dispatch(dispatcher);
     Picture picture = dispatcher.EndRecordingAsPicture();
  
     screenshot = pimpl_->screenshotter->MakeScreenshot(renderer, picture,
                                                        pimpl_->window_size);
   }
  
   return SaveScreenshot(std::move(screenshot));
 }

References impeller::DlDispatcherBase::EndRecordingAsPicture(), and GetContext().

◆ OpenPlaygroundHere() [3/4]

bool impeller::GoldenPlaygroundTest::OpenPlaygroundHere ( const sk_sp< flutter::DisplayList > & list )

Definition at line 251 of file golden_playground_test_mac.cc.

                                            {
   DlDispatcher dispatcher;
   list->Dispatch(dispatcher);
   Picture picture = dispatcher.EndRecordingAsPicture();
   return OpenPlaygroundHere(std::move(picture));
 }

References impeller::DlDispatcherBase::EndRecordingAsPicture(), and OpenPlaygroundHere().

◆ OpenPlaygroundHere() [4/4]

bool impeller::GoldenPlaygroundTest::OpenPlaygroundHere ( Picture picture )

Definition at line 205 of file golden_playground_test_mac.cc.

                                                              {
   AiksContext renderer(GetContext(), typographer_context_);
  
   auto screenshot = pimpl_->screenshotter->MakeScreenshot(renderer, picture,
                                                           pimpl_->window_size);
   return SaveScreenshot(std::move(screenshot));
 }

References GetContext().

Referenced by OpenPlaygroundHere().

◆ SetCapabilities()

fml::Status impeller::GoldenPlaygroundTest::SetCapabilities ( const std::shared_ptr< Capabilities > & capabilities )

Definition at line 335 of file golden_playground_test_mac.cc.

                                                      {
   return pimpl_->screenshotter->GetPlayground().SetCapabilities(capabilities);
 }

◆ SetTypographerContext()

void impeller::GoldenPlaygroundTest::SetTypographerContext ( std::shared_ptr< TypographerContext > typographer_context )

Definition at line 125 of file golden_playground_test_mac.cc.

                                                            {
   typographer_context_ = std::move(typographer_context);
 };

◆ SetUp()

void impeller::GoldenPlaygroundTest::SetUp ( )

Definition at line 144 of file golden_playground_test_mac.cc.

                                  {
   std::filesystem::path testing_assets_path =
       flutter::testing::GetTestingAssetsPath();
   std::filesystem::path target_path = testing_assets_path.parent_path()
                                           .parent_path()
                                           .parent_path()
                                           .parent_path();
   std::filesystem::path icd_path = target_path / "vk_swiftshader_icd.json";
   setenv("VK_ICD_FILENAMES", icd_path.c_str(), 1);
  
   std::string test_name = GetTestName();
   bool enable_wide_gamut = test_name.find("WideGamut_") != std::string::npos;
   switch (GetParam()) {
     case PlaygroundBackend::kMetal:
       if (!DoesSupportWideGamutTests()) {
         GTEST_SKIP_(
             "This metal device doesn't support wide gamut golden tests.");
       }
       pimpl_->screenshotter =
           std::make_unique<testing::MetalScreenshotter>(enable_wide_gamut);
       break;
     case PlaygroundBackend::kVulkan: {
       if (enable_wide_gamut) {
         GTEST_SKIP_("Vulkan doesn't support wide gamut golden tests.");
       }
       const std::unique_ptr<PlaygroundImpl>& playground =
           GetSharedVulkanPlayground(/*enable_validations=*/true);
       pimpl_->screenshotter =
           std::make_unique<testing::VulkanScreenshotter>(playground);
       break;
     }
     case PlaygroundBackend::kOpenGLES: {
       if (enable_wide_gamut) {
         GTEST_SKIP_("OpenGLES doesn't support wide gamut golden tests.");
       }
       FML_CHECK(::glfwInit() == GLFW_TRUE);
       PlaygroundSwitches playground_switches;
       playground_switches.use_angle = true;
       pimpl_->test_opengl_playground = PlaygroundImpl::Create(
           PlaygroundBackend::kOpenGLES, playground_switches);
       pimpl_->screenshotter = std::make_unique<testing::VulkanScreenshotter>(
           pimpl_->test_opengl_playground);
       break;
     }
   }
  
   if (std::find(kSkipTests.begin(), kSkipTests.end(), test_name) !=
       kSkipTests.end()) {
     GTEST_SKIP_(
         "GoldenPlaygroundTest doesn't support interactive playground tests "
         "yet.");
   }
  
   testing::GoldenDigest::Instance()->AddDimension(
       "gpu_string", GetContext()->DescribeGpuModel());
 }

References impeller::testing::GoldenDigest::AddDimension(), impeller::PlaygroundImpl::Create(), GetContext(), impeller::testing::GoldenDigest::Instance(), impeller::kMetal, impeller::kOpenGLES, impeller::kSkipTests, impeller::kVulkan, and impeller::PlaygroundSwitches::use_angle.

◆ SetWindowSize()

void impeller::GoldenPlaygroundTest::SetWindowSize ( ISize size )

protected

Definition at line 83 of file golden_playground_test_stub.cc.

83 {}

◆ TearDown()

void impeller::GoldenPlaygroundTest::TearDown ( )

Definition at line 130 of file golden_playground_test_mac.cc.

                                     {
   ASSERT_FALSE(dlopen("/usr/local/lib/libMoltenVK.dylib", RTLD_NOLOAD));
 }

◆ WillRenderSomething()

bool impeller::GoldenPlaygroundTest::WillRenderSomething ( ) const

inline

TODO(https://github.com/flutter/flutter/issues/139950): Remove this. Returns true if OpenPlaygroundHere will actually render anything.

Definition at line 83 of file golden_playground_test.h.

83 { return true; }

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

impeller/golden_tests/golden_playground_test.h
impeller/golden_tests/golden_playground_test_mac.cc
impeller/golden_tests/golden_playground_test_stub.cc

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions