Flutter Impeller
tiled_texture_contents.cc
Go to the documentation of this file.
1 // Copyright 2013 The Flutter Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
4 
6 
7 #include "fml/logging.h"
9 #include "impeller/entity/tiled_texture_fill.frag.h"
10 #include "impeller/entity/tiled_texture_fill_external.frag.h"
12 
13 namespace impeller {
14 
15 static std::optional<SamplerAddressMode> TileModeToAddressMode(
16  Entity::TileMode tile_mode,
17  const Capabilities& capabilities) {
18  switch (tile_mode) {
21  break;
24  break;
27  break;
29  if (capabilities.SupportsDecalSamplerAddressMode()) {
31  }
32  return std::nullopt;
33  }
34 }
35 
37 
39 
40 void TiledTextureContents::SetTexture(std::shared_ptr<Texture> texture) {
41  texture_ = std::move(texture);
42 }
43 
45  Entity::TileMode y_tile_mode) {
46  x_tile_mode_ = x_tile_mode;
47  y_tile_mode_ = y_tile_mode;
48 }
49 
51  sampler_descriptor_ = std::move(desc);
52 }
53 
55  color_filter_ = std::move(color_filter);
56 }
57 
58 std::shared_ptr<Texture> TiledTextureContents::CreateFilterTexture(
59  const ContentContext& renderer) const {
60  if (!color_filter_) {
61  return nullptr;
62  }
63  auto color_filter_contents = color_filter_(FilterInput::Make(texture_));
64  auto snapshot = color_filter_contents->RenderToSnapshot(
65  renderer, // renderer
66  Entity(), // entity
67  std::nullopt, // coverage_limit
68  std::nullopt, // sampler_descriptor
69  true, // msaa_enabled
70  /*mip_count=*/1,
71  "TiledTextureContents Snapshot"); // label
72  if (snapshot.has_value()) {
73  return snapshot.value().texture;
74  }
75  return nullptr;
76 }
77 
78 SamplerDescriptor TiledTextureContents::CreateSamplerDescriptor(
79  const Capabilities& capabilities) const {
80  SamplerDescriptor descriptor = sampler_descriptor_;
81  auto width_mode = TileModeToAddressMode(x_tile_mode_, capabilities);
82  auto height_mode = TileModeToAddressMode(y_tile_mode_, capabilities);
83  if (width_mode.has_value()) {
84  descriptor.width_address_mode = width_mode.value();
85  }
86  if (height_mode.has_value()) {
87  descriptor.height_address_mode = height_mode.value();
88  }
89  return descriptor;
90 }
91 
92 bool TiledTextureContents::UsesEmulatedTileMode(
93  const Capabilities& capabilities) const {
94  return !TileModeToAddressMode(x_tile_mode_, capabilities).has_value() ||
95  !TileModeToAddressMode(y_tile_mode_, capabilities).has_value();
96 }
97 
98 // |Contents|
100  if (GetOpacityFactor() < 1 || x_tile_mode_ == Entity::TileMode::kDecal ||
101  y_tile_mode_ == Entity::TileMode::kDecal) {
102  return false;
103  }
104  if (color_filter_) {
105  return false;
106  }
107  return texture_->IsOpaque() && !AppliesAlphaForStrokeCoverage(transform);
108 }
109 
111  const Entity& entity,
112  RenderPass& pass) const {
113  if (texture_ == nullptr) {
114  return true;
115  }
116 
117  using VS = TextureUvFillVertexShader;
118  using FS = TiledTextureFillFragmentShader;
119 
120  const auto texture_size = texture_->GetSize();
121  if (texture_size.IsEmpty()) {
122  return true;
123  }
124 
125  VS::FrameInfo frame_info;
126  frame_info.texture_sampler_y_coord_scale = texture_->GetYCoordScale();
127  frame_info.uv_transform =
128  Rect::MakeSize(texture_size).GetNormalizingTransform() *
130 
131  PipelineBuilderCallback pipeline_callback =
132  [&renderer](ContentContextOptions options) {
133  return renderer.GetTiledTexturePipeline(options);
134  };
135  return ColorSourceContents::DrawGeometry<VS>(
136  renderer, entity, pass, pipeline_callback, frame_info,
137  [this, &renderer, &entity](RenderPass& pass) {
138  auto& host_buffer = renderer.GetTransientsBuffer();
139 #ifdef IMPELLER_DEBUG
140  pass.SetCommandLabel("TextureFill");
141 #endif // IMPELLER_DEBUG
142 
143  FS::FragInfo frag_info;
144  frag_info.x_tile_mode = static_cast<Scalar>(x_tile_mode_);
145  frag_info.y_tile_mode = static_cast<Scalar>(y_tile_mode_);
146  frag_info.alpha =
147  GetOpacityFactor() *
149  FS::BindFragInfo(pass, host_buffer.EmplaceUniform(frag_info));
150 
151  if (color_filter_) {
152  auto filtered_texture = CreateFilterTexture(renderer);
153  if (!filtered_texture) {
154  return false;
155  }
156  FS::BindTextureSampler(
157  pass, filtered_texture,
158  renderer.GetContext()->GetSamplerLibrary()->GetSampler(
159  CreateSamplerDescriptor(renderer.GetDeviceCapabilities())));
160  } else {
161  FS::BindTextureSampler(
162  pass, texture_,
163  renderer.GetContext()->GetSamplerLibrary()->GetSampler(
164  CreateSamplerDescriptor(renderer.GetDeviceCapabilities())));
165  }
166 
167  return true;
168  });
169 }
170 
172  const ContentContext& renderer,
173  const Entity& entity,
174  std::optional<Rect> coverage_limit,
175  const std::optional<SamplerDescriptor>& sampler_descriptor,
176  bool msaa_enabled,
177  int32_t mip_count,
178  const std::string& label) const {
179  std::optional<Rect> geometry_coverage = GetGeometry()->GetCoverage({});
180  if (GetInverseEffectTransform().IsIdentity() &&
181  GetGeometry()->IsAxisAlignedRect() &&
182  (!geometry_coverage.has_value() ||
183  Rect::MakeSize(texture_->GetSize())
184  .Contains(geometry_coverage.value()))) {
185  auto coverage = GetCoverage(entity);
186  if (!coverage.has_value()) {
187  return std::nullopt;
188  }
189  auto scale = Vector2(coverage->GetSize() / Size(texture_->GetSize()));
190 
191  return Snapshot{
192  .texture = texture_,
193  .transform = Matrix::MakeTranslation(coverage->GetOrigin()) *
195  .sampler_descriptor = sampler_descriptor.value_or(sampler_descriptor_),
196  .opacity = GetOpacityFactor(),
197  };
198  }
199 
201  renderer, // renderer
202  entity, // entity
203  std::nullopt, // coverage_limit
204  sampler_descriptor.value_or(sampler_descriptor_), // sampler_descriptor
205  true, // msaa_enabled
206  /*mip_count=*/1,
207  label); // label
208 }
209 
210 } // namespace impeller
impeller::ColorSourceContents::PipelineBuilderCallback
std::function< std::shared_ptr< Pipeline< PipelineDescriptor > >(ContentContextOptions)> PipelineBuilderCallback
Definition: color_source_contents.h:108
impeller::Entity::TileMode::kClamp
@ kClamp
impeller::ColorSourceContents::GetOpacityFactor
Scalar GetOpacityFactor() const
Get the opacity factor for this color source.
Definition: color_source_contents.cc:28
impeller::Geometry::ComputeAlphaCoverage
virtual Scalar ComputeAlphaCoverage(const Matrix &transform) const
Definition: geometry.h:124
impeller::Scalar
float Scalar
Definition: scalar.h:18
impeller::TiledTextureContents::TiledTextureContents
TiledTextureContents()
impeller::Entity::GetTransform
const Matrix & GetTransform() const
Get the global transform matrix for this Entity.
Definition: entity.cc:47
impeller::Geometry::GetCoverage
virtual std::optional< Rect > GetCoverage(const Matrix &transform) const =0
impeller::FilterInput::Make
static FilterInput::Ref Make(Variant input, bool msaa_enabled=true)
Definition: filter_input.cc:19
impeller::Entity::TileMode::kDecal
@ kDecal
impeller::TiledTextureContents::IsOpaque
bool IsOpaque(const Matrix &transform) const override
Whether this Contents only emits opaque source colors from the fragment stage. This value does not ac...
Definition: tiled_texture_contents.cc:99
impeller::Contents::RenderToSnapshot
virtual std::optional< Snapshot > RenderToSnapshot(const ContentContext &renderer, const Entity &entity, std::optional< Rect > coverage_limit=std::nullopt, const std::optional< SamplerDescriptor > &sampler_descriptor=std::nullopt, bool msaa_enabled=true, int32_t mip_count=1, const std::string &label="Snapshot") const
Render this contents to a snapshot, respecting the entity's transform, path, clip depth,...
Definition: contents.cc:63
tiled_texture_contents.h
impeller::Vector2
Point Vector2
Definition: point.h:331
impeller::TRect::GetNormalizingTransform
constexpr Matrix GetNormalizingTransform() const
Constructs a Matrix that will map all points in the coordinate space of the rectangle into a new norm...
Definition: rect.h:485
impeller::TiledTextureContents::SetSamplerDescriptor
void SetSamplerDescriptor(SamplerDescriptor desc)
Definition: tiled_texture_contents.cc:50
impeller::ContentContext::GetTiledTexturePipeline
std::shared_ptr< Pipeline< PipelineDescriptor > > GetTiledTexturePipeline(ContentContextOptions opts) const
Definition: content_context.h:457
impeller::SamplerAddressMode::kClampToEdge
@ kClampToEdge
impeller::Entity::TileMode::kRepeat
@ kRepeat
impeller::Matrix::MakeTranslation
static constexpr Matrix MakeTranslation(const Vector3 &t)
Definition: matrix.h:95
impeller::RenderPass::SetCommandLabel
virtual void SetCommandLabel(std::string_view label)
The debugging label to use for the command.
Definition: render_pass.cc:97
impeller::Entity::TileMode::kMirror
@ kMirror
impeller::VS
SolidFillVertexShader VS
Definition: stroke_path_geometry.cc:16
impeller::SamplerDescriptor
Definition: sampler_descriptor.h:15
impeller::Entity
Definition: entity.h:20
impeller::Capabilities
Definition: capabilities.h:14
impeller::TSize< Scalar >
render_pass.h
transform
Matrix transform
Definition: gaussian_blur_filter_contents.cc:213
impeller::ContentContext::GetContext
std::shared_ptr< Context > GetContext() const
Definition: content_context.cc:550
impeller::Contents::ColorFilterProc
std::function< Color(Color)> ColorFilterProc
Definition: contents.h:35
impeller::Snapshot
Represents a texture and its intended draw transform/sampler configuration.
Definition: snapshot.h:24
impeller::Entity::TileMode
TileMode
Definition: entity.h:42
impeller::TiledTextureContents::SetColorFilter
void SetColorFilter(ColorFilterProc color_filter)
Set a color filter to apply directly to this tiled texture.
Definition: tiled_texture_contents.cc:54
impeller::TRect::Contains
constexpr bool Contains(const TPoint< Type > &p) const
Returns true iff the provided point |p| is inside the half-open interior of this rectangle.
Definition: rect.h:225
impeller::ColorSourceContents::GetGeometry
const Geometry * GetGeometry() const
Get the geometry that this contents will use to render.
Definition: color_source_contents.cc:20
impeller::RenderPass
Render passes encode render commands directed as one specific render target into an underlying comman...
Definition: render_pass.h:33
content_context.h
impeller::ContentContext::GetDeviceCapabilities
const Capabilities & GetDeviceCapabilities() const
Definition: content_context.cc:554
impeller::ColorSourceContents::GetCoverage
std::optional< Rect > GetCoverage(const Entity &entity) const override
Get the area of the render pass that will be affected when this contents is rendered.
Definition: color_source_contents.cc:44
impeller::SamplerAddressMode::kMirror
@ kMirror
impeller::TRect< Scalar >::MakeSize
constexpr static TRect MakeSize(const TSize< U > &size)
Definition: rect.h:150
scale
const Scalar scale
Definition: stroke_path_geometry.cc:301
impeller::TiledTextureContents::RenderToSnapshot
std::optional< Snapshot > RenderToSnapshot(const ContentContext &renderer, const Entity &entity, std::optional< Rect > coverage_limit=std::nullopt, const std::optional< SamplerDescriptor > &sampler_descriptor=std::nullopt, bool msaa_enabled=true, int32_t mip_count=1, const std::string &label="Tiled Texture Snapshot") const override
Render this contents to a snapshot, respecting the entity's transform, path, clip depth,...
Definition: tiled_texture_contents.cc:171
impeller::TiledTextureContents::Render
bool Render(const ContentContext &renderer, const Entity &entity, RenderPass &pass) const override
Definition: tiled_texture_contents.cc:110
impeller::TiledTextureContents::SetTileModes
void SetTileModes(Entity::TileMode x_tile_mode, Entity::TileMode y_tile_mode)
Definition: tiled_texture_contents.cc:44
impeller::TiledTextureContents::~TiledTextureContents
~TiledTextureContents() override
impeller::TileModeToAddressMode
static std::optional< SamplerAddressMode > TileModeToAddressMode(Entity::TileMode tile_mode, const Capabilities &capabilities)
Definition: tiled_texture_contents.cc:15
impeller::Snapshot::texture
std::shared_ptr< Texture > texture
Definition: snapshot.h:25
impeller::ColorSourceContents::AppliesAlphaForStrokeCoverage
bool AppliesAlphaForStrokeCoverage(const Matrix &transform) const
Whether the entity should be treated as non-opaque due to stroke geometry requiring alpha for coverag...
Definition: color_source_contents.cc:53
impeller::Capabilities::SupportsDecalSamplerAddressMode
virtual bool SupportsDecalSamplerAddressMode() const =0
Whether the context backend supports SamplerAddressMode::Decal.
impeller::ContentContextOptions
Definition: content_context.h:254
impeller
Definition: allocation.cc:12
impeller::Matrix::MakeScale
static constexpr Matrix MakeScale(const Vector3 &s)
Definition: matrix.h:104
impeller::ContentContext
Definition: content_context.h:366
impeller::Matrix
A 4x4 matrix using column-major storage.
Definition: matrix.h:37
impeller::ColorSourceContents::GetInverseEffectTransform
const Matrix & GetInverseEffectTransform() const
Set the inverted effect transform for this color source.
Definition: color_source_contents.cc:36
impeller::ContentContext::GetTransientsBuffer
HostBuffer & GetTransientsBuffer() const
Retrieve the currnent host buffer for transient storage.
Definition: content_context.h:753
impeller::TiledTextureContents::SetTexture
void SetTexture(std::shared_ptr< Texture > texture)
Definition: tiled_texture_contents.cc:40
impeller::SamplerAddressMode::kRepeat
@ kRepeat
impeller::SamplerAddressMode::kDecal
@ kDecal
decal sampling mode is only supported on devices that pass the Capabilities.SupportsDecalSamplerAddre...