impeller::GoldenPlaygroundTest Class Reference

#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 28 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.

    : typographer_context_(TypographerContextSkia::Make()),
      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);
}

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;
}

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();
}

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();
  }
}

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);
}

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));
}

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));
}

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));
}

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));
}

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());
}

SetWindowSize()

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

protected

Definition at line 83 of file golden_playground_test_stub.cc.

{}

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.

{ 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