| 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
5 #include "impeller/entity/contents/tiled_texture_contents.h"
6
7 #include "fml/logging.h"
8 #include "impeller/core/formats.h"
9 #include "impeller/entity/contents/content_context.h"
10 #include "impeller/entity/tiled_texture_fill.frag.h"
11 #include "impeller/entity/tiled_texture_fill_external.frag.h"
12 #include "impeller/renderer/render_pass.h"
13
14 namespace impeller {
15
16 static std::optional<SamplerAddressMode> TileModeToAddressMode(
17 Entity::TileMode tile_mode,
18 const Capabilities& capabilities) {
19 switch (tile_mode) {
20 case Entity::TileMode::kClamp:
21 return SamplerAddressMode::kClampToEdge;
22 break;
23 case Entity::TileMode::kMirror:
24 return SamplerAddressMode::kMirror;
25 break;
26 case Entity::TileMode::kRepeat:
27 return SamplerAddressMode::kRepeat;
28 break;
29 case Entity::TileMode::kDecal:
30 if (capabilities.SupportsDecalSamplerAddressMode()) {
31 return SamplerAddressMode::kDecal;
32 }
33 return std::nullopt;
34 }
35 }
36
37 TiledTextureContents::TiledTextureContents() = default;
38
39 TiledTextureContents::~TiledTextureContents() = default;
40
41 void TiledTextureContents::SetTexture(std::shared_ptr<Texture> texture) {
42 texture_ = std::move(texture);
43 }
44
45 void TiledTextureContents::SetTileModes(Entity::TileMode x_tile_mode,
46 Entity::TileMode y_tile_mode) {
47 x_tile_mode_ = x_tile_mode;
48 y_tile_mode_ = y_tile_mode;
49 }
50
51 void TiledTextureContents::SetSamplerDescriptor(const SamplerDescriptor& desc) {
52 sampler_descriptor_ = desc;
53 }
54
55 void TiledTextureContents::SetColorFilter(ColorFilterProc color_filter) {
56 color_filter_ = std::move(color_filter);
57 }
58
59 std::shared_ptr<Texture> TiledTextureContents::CreateFilterTexture(
60 const ContentContext& renderer) const {
61 if (!color_filter_) {
62 return nullptr;
63 }
64 auto color_filter_contents = color_filter_(FilterInput::Make(texture_));
65 auto snapshot = color_filter_contents->RenderToSnapshot(
66 /*renderer=*/renderer,
67 /*entity=*/Entity(),
68 /*options=*/
69 {.coverage_limit = std::nullopt,
70 .sampler_descriptor = std::nullopt,
71 .msaa_enabled = true,
72 .mip_count = 1,
73 .label = "TiledTextureContents Snapshot"});
74 if (snapshot.has_value()) {
75 return snapshot.value().texture;
76 }
77 return nullptr;
78 }
79
80 SamplerDescriptor TiledTextureContents::CreateSamplerDescriptor(
81 const Capabilities& capabilities) const {
82 SamplerDescriptor descriptor = sampler_descriptor_;
83 auto width_mode = TileModeToAddressMode(x_tile_mode_, capabilities);
84 auto height_mode = TileModeToAddressMode(y_tile_mode_, capabilities);
85 if (width_mode.has_value()) {
86 descriptor.width_address_mode = width_mode.value();
87 }
88 if (height_mode.has_value()) {
89 descriptor.height_address_mode = height_mode.value();
90 }
91 return descriptor;
92 }
93
94 bool TiledTextureContents::UsesEmulatedTileMode(
95 const Capabilities& capabilities) const {
96 return !TileModeToAddressMode(x_tile_mode_, capabilities).has_value() ||
97 !TileModeToAddressMode(y_tile_mode_, capabilities).has_value();
98 }
99
100 // |Contents|
101 bool TiledTextureContents::IsOpaque(const Matrix& transform) const {
102 if (GetOpacityFactor() < 1 || x_tile_mode_ == Entity::TileMode::kDecal ||
103 y_tile_mode_ == Entity::TileMode::kDecal) {
104 return false;
105 }
106 if (color_filter_) {
107 return false;
108 }
109 return texture_->IsOpaque() && !AppliesAlphaForStrokeCoverage(transform);
110 }
111
112 bool TiledTextureContents::Render(const ContentContext& renderer,
113 const Entity& entity,
114 RenderPass& pass) const {
115 if (texture_ == nullptr) {
116 return true;
117 }
118
119 using VS = TextureUvFillVertexShader;
120 using FS = TiledTextureFillFragmentShader;
121
122 const auto texture_size = texture_->GetSize();
123 if (texture_size.IsEmpty()) {
124 return true;
125 }
126
127 VS::FrameInfo frame_info;
128 frame_info.texture_sampler_y_coord_scale = texture_->GetYCoordScale();
129 frame_info.uv_transform =
130 Rect::MakeSize(texture_size).GetNormalizingTransform() *
131 GetInverseEffectTransform();
132
133 #if defined(IMPELLER_ENABLE_OPENGLES) && !defined(FML_OS_EMSCRIPTEN)
134 using FSExternal = TiledTextureFillExternalFragmentShader;
135 if (texture_->GetTextureDescriptor().type ==
136 TextureType::kTextureExternalOES) {
137 return ColorSourceContents::DrawGeometry<VS>(
138 renderer, entity, pass,
139 [&renderer](ContentContextOptions options) {
140 return renderer.GetTiledTextureUvExternalPipeline(options);
141 },
142 frame_info,
143 [this, &renderer](RenderPass& pass) {
144 auto& data_host_buffer = renderer.GetTransientsDataBuffer();
145 #ifdef IMPELLER_DEBUG
146 pass.SetCommandLabel("TextureFill External");
147 #endif // IMPELLER_DEBUG
148
149 FML_DCHECK(!color_filter_);
150 FSExternal::FragInfo frag_info;
151 frag_info.x_tile_mode =
152 static_cast<Scalar>(sampler_descriptor_.width_address_mode);
153 frag_info.y_tile_mode =
154 static_cast<Scalar>(sampler_descriptor_.height_address_mode);
155 frag_info.alpha = GetOpacityFactor();
156 FSExternal::BindFragInfo(pass,
157 data_host_buffer.EmplaceUniform(frag_info));
158
159 SamplerDescriptor sampler_desc;
160 // OES_EGL_image_external states that only CLAMP_TO_EDGE is valid,
161 // so we emulate all other tile modes here by remapping the texture
162 // coordinates.
163 sampler_desc.width_address_mode = SamplerAddressMode::kClampToEdge;
164 sampler_desc.height_address_mode = SamplerAddressMode::kClampToEdge;
165 sampler_desc.min_filter = sampler_descriptor_.min_filter;
166 sampler_desc.mag_filter = sampler_descriptor_.mag_filter;
167 sampler_desc.mip_filter = MipFilter::kBase;
168
169 FSExternal::BindSAMPLEREXTERNALOESTextureSampler(
170 pass, texture_,
171 renderer.GetContext()->GetSamplerLibrary()->GetSampler(
172 sampler_desc));
173 return true;
174 });
175 }
176 #endif // IMPELLER_ENABLE_OPENGLES
177
178 PipelineBuilderCallback pipeline_callback =
179 [&renderer](ContentContextOptions options) {
180 return renderer.GetTiledTexturePipeline(options);
181 };
182 return ColorSourceContents::DrawGeometry<VS>(
183 renderer, entity, pass, pipeline_callback, frame_info,
184 [this, &renderer, &entity](RenderPass& pass) {
185 auto& data_host_buffer = renderer.GetTransientsDataBuffer();
186 #ifdef IMPELLER_DEBUG
187 pass.SetCommandLabel("TextureFill");
188 #endif // IMPELLER_DEBUG
189
190 FS::FragInfo frag_info;
191 frag_info.x_tile_mode = static_cast<Scalar>(x_tile_mode_);
192 frag_info.y_tile_mode = static_cast<Scalar>(y_tile_mode_);
193 frag_info.alpha =
194 GetOpacityFactor() *
195 GetGeometry()->ComputeAlphaCoverage(entity.GetTransform());
196 FS::BindFragInfo(pass, data_host_buffer.EmplaceUniform(frag_info));
197
198 if (color_filter_) {
199 auto filtered_texture = CreateFilterTexture(renderer);
200 if (!filtered_texture) {
201 return false;
202 }
203 FS::BindTextureSampler(
204 pass, filtered_texture,
205 renderer.GetContext()->GetSamplerLibrary()->GetSampler(
206 CreateSamplerDescriptor(renderer.GetDeviceCapabilities())));
207 } else {
208 FS::BindTextureSampler(
209 pass, texture_,
210 renderer.GetContext()->GetSamplerLibrary()->GetSampler(
211 CreateSamplerDescriptor(renderer.GetDeviceCapabilities())));
212 }
213
214 return true;
215 });
216 }
217
218 std::optional<Snapshot> TiledTextureContents::RenderToSnapshot(
219 const ContentContext& renderer,
220 const Entity& entity,
221 const SnapshotOptions& options) const {
222 std::optional<Rect> geometry_coverage = GetGeometry()->GetCoverage({});
223 if (GetInverseEffectTransform().IsIdentity() &&
224 GetGeometry()->IsAxisAlignedRect() &&
225 (!geometry_coverage.has_value() ||
226 Rect::MakeSize(texture_->GetSize())
227 .Contains(geometry_coverage.value()))) {
228 auto coverage = GetCoverage(entity);
229 if (!coverage.has_value()) {
230 return std::nullopt;
231 }
232 auto scale = Vector2(coverage->GetSize() / Size(texture_->GetSize()));
233
234 return Snapshot{
235 .texture = texture_,
236 .transform = Matrix::MakeTranslation(coverage->GetOrigin()) *
237 Matrix::MakeScale(scale),
238 .sampler_descriptor =
239 options.sampler_descriptor.value_or(sampler_descriptor_),
240 .opacity = GetOpacityFactor(),
241 };
242 }
243
244 return Contents::RenderToSnapshot(
245 renderer, entity,
246 {.coverage_limit = std::nullopt,
247 .sampler_descriptor =
248 options.sampler_descriptor.value_or(sampler_descriptor_),
249 .msaa_enabled = true,
250 .mip_count = 1,
251 .label = options.label});
252 }
253
254 } // namespace impeller
impeller::Capabilities
Definition: capabilities.h:14
impeller::Capabilities::SupportsDecalSamplerAddressMode
virtual bool SupportsDecalSamplerAddressMode() const =0
Whether the context backend supports SamplerAddressMode::Decal.
impeller::ColorSourceContents::GetGeometry
const Geometry * GetGeometry() const
Get the geometry that this contents will use to render.
Definition: color_source_contents.cc:20
impeller::ColorSourceContents::GetOpacityFactor
Scalar GetOpacityFactor() const
Get the opacity factor for this color source.
Definition: color_source_contents.cc:28
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::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::ColorSourceContents::GetInverseEffectTransform
const Matrix & GetInverseEffectTransform() const
Set the inverted effect transform for this color source.
Definition: color_source_contents.cc:36
impeller::ColorSourceContents::PipelineBuilderCallback
std::function< PipelineRef(ContentContextOptions)> PipelineBuilderCallback
Definition: color_source_contents.h:42
impeller::ContentContext
Definition: content_context.h:122
impeller::ContentContext::GetTiledTexturePipeline
PipelineRef GetTiledTexturePipeline(ContentContextOptions opts) const
Definition: content_context.cc:1151
impeller::ContentContext::GetDeviceCapabilities
const Capabilities & GetDeviceCapabilities() const
Definition: content_context.cc:968
impeller::ContentContext::GetTransientsDataBuffer
HostBuffer & GetTransientsDataBuffer() const
Retrieve the current host buffer for transient storage of other non-index data.
Definition: content_context.h:299
impeller::ContentContext::GetContext
std::shared_ptr< Context > GetContext() const
Definition: content_context.cc:964
impeller::Contents::RenderToSnapshot
virtual std::optional< Snapshot > RenderToSnapshot(const ContentContext &renderer, const Entity &entity, const SnapshotOptions &options) const
Render this contents to a snapshot, respecting the entity's transform, path, clip depth,...
Definition: contents.cc:56
impeller::Contents::ColorFilterProc
std::function< Color(Color)> ColorFilterProc
Definition: contents.h:35
impeller::Entity
Definition: entity.h:26
impeller::Entity::TileMode
TileMode
Definition: entity.h:48
impeller::Entity::TileMode::kDecal
@ kDecal
impeller::Entity::TileMode::kRepeat
@ kRepeat
impeller::Entity::TileMode::kClamp
@ kClamp
impeller::Entity::TileMode::kMirror
@ kMirror
impeller::Entity::GetTransform
const Matrix & GetTransform() const
Get the global transform matrix for this Entity.
Definition: entity.cc:46
impeller::FilterInput::Make
static FilterInput::Ref Make(Variant input, bool msaa_enabled=true)
Definition: filter_input.cc:19
impeller::Geometry::ComputeAlphaCoverage
virtual Scalar ComputeAlphaCoverage(const Matrix &transform) const
Definition: geometry.h:125
impeller::Geometry::GetCoverage
virtual std::optional< Rect > GetCoverage(const Matrix &transform) const =0
impeller::RenderPass
Render passes encode render commands directed as one specific render target into an underlying comman...
Definition: render_pass.h:30
impeller::RenderPass::SetCommandLabel
virtual void SetCommandLabel(std::string_view label)
The debugging label to use for the command.
Definition: render_pass.cc:97
impeller::TiledTextureContents::~TiledTextureContents
~TiledTextureContents() override
impeller::TiledTextureContents::Render
bool Render(const ContentContext &renderer, const Entity &entity, RenderPass &pass) const override
Definition: tiled_texture_contents.cc:112
impeller::TiledTextureContents::RenderToSnapshot
std::optional< Snapshot > RenderToSnapshot(const ContentContext &renderer, const Entity &entity, const SnapshotOptions &options) const override
Render this contents to a snapshot, respecting the entity's transform, path, clip depth,...
Definition: tiled_texture_contents.cc:218
impeller::TiledTextureContents::TiledTextureContents
TiledTextureContents()
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:101
impeller::TiledTextureContents::SetSamplerDescriptor
void SetSamplerDescriptor(const SamplerDescriptor &desc)
Definition: tiled_texture_contents.cc:51
impeller::TiledTextureContents::SetColorFilter
void SetColorFilter(ColorFilterProc color_filter)
Set a color filter to apply directly to this tiled texture.
Definition: tiled_texture_contents.cc:55
impeller::TiledTextureContents::SetTileModes
void SetTileModes(Entity::TileMode x_tile_mode, Entity::TileMode y_tile_mode)
Definition: tiled_texture_contents.cc:45
impeller::TiledTextureContents::SetTexture
void SetTexture(std::shared_ptr< Texture > texture)
Definition: tiled_texture_contents.cc:41
content_context.h
formats.h
transform
Matrix transform
Definition: gaussian_blur_filter_contents.cc:312
impeller
Definition: allocation.cc:12
impeller::Vector2
Point Vector2
Definition: point.h:429
impeller::Scalar
float Scalar
Definition: scalar.h:19
impeller::SamplerAddressMode::kDecal
@ kDecal
decal sampling mode is only supported on devices that pass the Capabilities.SupportsDecalSamplerAddre...
impeller::SamplerAddressMode::kRepeat
@ kRepeat
impeller::SamplerAddressMode::kMirror
@ kMirror
impeller::SamplerAddressMode::kClampToEdge
@ kClampToEdge
impeller::FS
LinePipeline::FragmentShader FS
Definition: line_contents.cc:14
impeller::MipFilter::kBase
@ kBase
The texture is sampled as if it only had a single mipmap level.
impeller::TileModeToAddressMode
static std::optional< SamplerAddressMode > TileModeToAddressMode(Entity::TileMode tile_mode, const Capabilities &capabilities)
Definition: tiled_texture_contents.cc:16
impeller::TextureType::kTextureExternalOES
@ kTextureExternalOES
impeller::VS
LinePipeline::VertexShader VS
Definition: line_contents.cc:13
render_pass.h
impeller::ContentContextOptions
Definition: content_context.h:40
impeller::Contents::SnapshotOptions
Definition: contents.h:85
impeller::Contents::SnapshotOptions::label
std::string_view label
Definition: contents.h:90
impeller::Contents::SnapshotOptions::sampler_descriptor
const std::optional< SamplerDescriptor > & sampler_descriptor
Definition: contents.h:87
impeller::Matrix
A 4x4 matrix using column-major storage.
Definition: matrix.h:37
impeller::Matrix::MakeTranslation
static constexpr Matrix MakeTranslation(const Vector3 &t)
Definition: matrix.h:95
impeller::Matrix::MakeScale
static constexpr Matrix MakeScale(const Vector3 &s)
Definition: matrix.h:104
impeller::SamplerDescriptor
Definition: sampler_descriptor.h:14
impeller::SamplerDescriptor::mip_filter
MipFilter mip_filter
Definition: sampler_descriptor.h:17
impeller::SamplerDescriptor::width_address_mode
SamplerAddressMode width_address_mode
Definition: sampler_descriptor.h:19
impeller::SamplerDescriptor::height_address_mode
SamplerAddressMode height_address_mode
Definition: sampler_descriptor.h:20
impeller::SamplerDescriptor::mag_filter
MinMagFilter mag_filter
Definition: sampler_descriptor.h:16
impeller::SamplerDescriptor::min_filter
MinMagFilter min_filter
Definition: sampler_descriptor.h:15
impeller::Snapshot
Represents a texture and its intended draw transform/sampler configuration.
Definition: snapshot.h:24
impeller::Snapshot::texture
std::shared_ptr< Texture > texture
Definition: snapshot.h:25
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:231
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:491
impeller::TRect< Scalar >::MakeSize
constexpr static TRect MakeSize(const TSize< U > &size)
Definition: rect.h:150
impeller::TSize< Scalar >
tiled_texture_contents.h