Flutter Impeller
impeller::PlaygroundTest Class Reference

#include <playground_test.h>

Inheritance diagram for impeller::PlaygroundTest:
impeller::Playground impeller::AiksPlayground impeller::DlPlayground impeller::EntityPlayground impeller::interop::testing::PlaygroundTest impeller::RuntimeStagePlayground impeller::testing::RendererDartTest impeller::testing::BlendFilterContentsTest impeller::testing::GaussianBlurFilterContentsTest impeller::testing::MatrixFilterContentsTest

Public Member Functions

 PlaygroundTest ()
 
virtual ~PlaygroundTest ()
 
void SetUp () override
 
void TearDown () override
 
PlaygroundBackend GetBackend () const
 
std::unique_ptr< fml::Mapping > OpenAssetAsMapping (std::string asset_name) const override
 
RuntimeStage::Map OpenAssetAsRuntimeStage (const char *asset_name) const
 
std::string GetWindowTitle () const override
 
- Public Member Functions inherited from impeller::Playground
 Playground (PlaygroundSwitches switches)
 
virtual ~Playground ()
 
void SetupContext (PlaygroundBackend backend, const PlaygroundSwitches &switches)
 
void SetupWindow ()
 
void TeardownWindow ()
 
bool IsPlaygroundEnabled () const
 
Point GetCursorPosition () const
 
ISize GetWindowSize () const
 
Point GetContentScale () const
 
Scalar GetSecondsElapsed () const
 Get the amount of time elapsed from the start of the playground's execution. More...
 
std::shared_ptr< ContextGetContext () const
 
std::shared_ptr< ContextMakeContext () const
 
bool OpenPlaygroundHere (const RenderCallback &render_callback)
 
bool OpenPlaygroundHere (SinglePassCallback pass_callback)
 
std::shared_ptr< TextureCreateTextureForFixture (const char *fixture_name, bool enable_mipmapping=false) const
 
std::shared_ptr< TextureCreateTextureCubeForFixture (std::array< const char *, 6 > fixture_names) const
 
fml::Status SetCapabilities (const std::shared_ptr< Capabilities > &capabilities)
 
bool WillRenderSomething () const
 Returns true if OpenPlaygroundHere will actually render anything. More...
 
GLProcAddressResolver CreateGLProcAddressResolver () const
 

Additional Inherited Members

- Public Types inherited from impeller::Playground
using SinglePassCallback = std::function< bool(RenderPass &pass)>
 
using RenderCallback = std::function< bool(RenderTarget &render_target)>
 
using GLProcAddressResolver = std::function< void *(const char *proc_name)>
 
- Static Public Member Functions inherited from impeller::Playground
static bool ShouldOpenNewPlaygrounds ()
 
static std::shared_ptr< CompressedImageLoadFixtureImageCompressed (std::shared_ptr< fml::Mapping > mapping)
 
static std::optional< DecompressedImageDecodeImageRGBA (const std::shared_ptr< CompressedImage > &compressed)
 
static std::shared_ptr< TextureCreateTextureForMapping (const std::shared_ptr< Context > &context, std::shared_ptr< fml::Mapping > mapping, bool enable_mipmapping=false)
 
static bool SupportsBackend (PlaygroundBackend backend)
 
- Protected Member Functions inherited from impeller::Playground
void SetWindowSize (ISize size)
 
- Protected Attributes inherited from impeller::Playground
const PlaygroundSwitches switches_
 

Detailed Description

Definition at line 21 of file playground_test.h.

Constructor & Destructor Documentation

◆ PlaygroundTest()

impeller::PlaygroundTest::PlaygroundTest ( )

Definition at line 13 of file playground_test.cc.

14  : Playground(PlaygroundSwitches{flutter::testing::GetArgsForProcess()}) {
16  [](const char* message, const char* file, int line) -> bool {
17  // GTEST_MESSAGE_AT_ can only be used in a function that returns void.
18  // Hence the goofy lambda. The failure message and location will still
19  // be correct however.
20  //
21  // https://google.github.io/googletest/advanced.html#assertion-placement
22  [message, file, line]() -> void {
23  GTEST_MESSAGE_AT_(file, line, "Impeller Validation Error",
24  ::testing::TestPartResult::kFatalFailure)
25  << message;
26  }();
27  return true;
28  });
29 }

◆ ~PlaygroundTest()

impeller::PlaygroundTest::~PlaygroundTest ( )
virtual

Member Function Documentation

◆ GetBackend()

PlaygroundBackend impeller::PlaygroundTest::GetBackend ( ) const

Definition at line 72 of file playground_test.cc.

72  {
73  return GetParam();
74 }

Referenced by impeller::interop::testing::PlaygroundTest::CreateContext(), and GetWindowTitle().

◆ GetWindowTitle()

std::string impeller::PlaygroundTest::GetWindowTitle ( ) const
overridevirtual

Implements impeller::Playground.

Definition at line 97 of file playground_test.cc.

97  {
98  std::stringstream stream;
99  stream << "Impeller Playground for '"
100  << flutter::testing::GetCurrentTestName() << "' ";
101  switch (GetBackend()) {
103  break;
105  if (switches_.use_angle) {
106  stream << " (Angle) ";
107  }
108  break;
111  stream << " (SwiftShader) ";
112  }
113  break;
114  }
115  stream << " (Press ESC to quit)";
116  return stream.str();
117 }

References GetBackend(), impeller::kMetal, impeller::kOpenGLES, impeller::kVulkan, impeller::Playground::switches_, impeller::PlaygroundSwitches::use_angle, and impeller::PlaygroundSwitches::use_swiftshader.

◆ OpenAssetAsMapping()

std::unique_ptr< fml::Mapping > impeller::PlaygroundTest::OpenAssetAsMapping ( std::string  asset_name) const
overridevirtual

Implements impeller::Playground.

Definition at line 81 of file playground_test.cc.

82  {
83  return flutter::testing::OpenFixtureAsMapping(asset_name);
84 }

◆ OpenAssetAsRuntimeStage()

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

Definition at line 86 of file playground_test.cc.

87  {
88  const std::shared_ptr<fml::Mapping> fixture =
89  flutter::testing::OpenFixtureAsMapping(asset_name);
90  if (!fixture || fixture->GetSize() == 0) {
91  return {};
92  }
93  return RuntimeStage::DecodeRuntimeStages(fixture);
94 }

References impeller::RuntimeStage::DecodeRuntimeStages().

◆ SetUp()

void impeller::PlaygroundTest::SetUp ( )
override

Definition at line 45 of file playground_test.cc.

45  {
46  if (!Playground::SupportsBackend(GetParam())) {
47  GTEST_SKIP() << "Playground doesn't support this backend type.";
48  return;
49  }
50 
52  GTEST_SKIP() << "Skipping due to user action.";
53  return;
54  }
55 
56  // Test names that end with "WideGamut" will render with wide gamut support.
57  std::string test_name = flutter::testing::GetCurrentTestName();
58  PlaygroundSwitches switches = switches_;
59  switches.enable_wide_gamut =
60  test_name.find("WideGamut/") != std::string::npos;
61 
62  if (switches.enable_wide_gamut && (GetParam() != PlaygroundBackend::kMetal ||
63  !DoesSupportWideGamutTests())) {
64  GTEST_SKIP() << "This backend doesn't yet support wide gamut.";
65  return;
66  }
67 
68  SetupContext(GetParam(), switches);
69  SetupWindow();
70 }

References impeller::PlaygroundSwitches::enable_wide_gamut, impeller::kMetal, impeller::Playground::SetupContext(), impeller::Playground::SetupWindow(), impeller::Playground::ShouldOpenNewPlaygrounds(), impeller::Playground::SupportsBackend(), and impeller::Playground::switches_.

Referenced by impeller::interop::testing::PlaygroundTest::SetUp().

◆ TearDown()

void impeller::PlaygroundTest::TearDown ( )
override

The documentation for this class was generated from the following files:
impeller::Playground::ShouldOpenNewPlaygrounds
static bool ShouldOpenNewPlaygrounds()
Definition: playground.cc:160
impeller::PlaygroundBackend::kVulkan
@ kVulkan
impeller::RuntimeStage::DecodeRuntimeStages
static Map DecodeRuntimeStages(const std::shared_ptr< fml::Mapping > &payload)
Definition: runtime_stage.cc:61
impeller::PlaygroundBackend::kMetal
@ kMetal
impeller::PlaygroundSwitches::enable_wide_gamut
bool enable_wide_gamut
Definition: switches.h:35
impeller::PlaygroundSwitches::use_swiftshader
bool use_swiftshader
Definition: switches.h:27
impeller::Playground::SetupWindow
void SetupWindow()
Definition: playground.cc:137
impeller::Playground::switches_
const PlaygroundSwitches switches_
Definition: playground.h:121
impeller::Playground::SetupContext
void SetupContext(PlaygroundBackend backend, const PlaygroundSwitches &switches)
Definition: playground.cc:124
impeller::PlaygroundSwitches::use_angle
bool use_angle
Definition: switches.h:33
impeller::PlaygroundBackend::kOpenGLES
@ kOpenGLES
impeller::Playground::SupportsBackend
static bool SupportsBackend(PlaygroundBackend backend)
Definition: playground.cc:100
impeller::Playground::TeardownWindow
void TeardownWindow()
Definition: playground.cc:150
impeller::Playground::Playground
Playground(PlaygroundSwitches switches)
Definition: playground.cc:83
impeller::PlaygroundTest::GetBackend
PlaygroundBackend GetBackend() const
Definition: playground_test.cc:72
impeller::ImpellerValidationErrorsSetCallback
void ImpellerValidationErrorsSetCallback(ValidationFailureCallback callback)
Sets a callback that callers (usually tests) can set to intercept validation failures.
Definition: validation.cc:21