Flutter Impeller
sweep_gradient_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 "flutter/fml/logging.h"
11 #include "impeller/entity/entity.h"
14 
15 namespace impeller {
16 
18 
20 
22  Degrees start_angle,
23  Degrees end_angle) {
24  center_ = center;
25  Scalar t0 = start_angle.degrees / 360;
26  Scalar t1 = end_angle.degrees / 360;
27  FML_DCHECK(t0 < t1);
28  bias_ = -t0;
29  scale_ = 1 / (t1 - t0);
30 }
31 
32 void SweepGradientContents::SetColors(std::vector<Color> colors) {
33  colors_ = std::move(colors);
34 }
35 
36 void SweepGradientContents::SetStops(std::vector<Scalar> stops) {
37  stops_ = std::move(stops);
38 }
39 
41  tile_mode_ = tile_mode;
42 }
43 
44 const std::vector<Color>& SweepGradientContents::GetColors() const {
45  return colors_;
46 }
47 
48 const std::vector<Scalar>& SweepGradientContents::GetStops() const {
49  return stops_;
50 }
51 
53  if (GetOpacityFactor() < 1 || tile_mode_ == Entity::TileMode::kDecal) {
54  return false;
55  }
56  for (auto color : colors_) {
57  if (!color.IsOpaque()) {
58  return false;
59  }
60  }
62 }
63 
64 #define ARRAY_LEN(a) (sizeof(a) / sizeof(a[0]))
65 #define UNIFORM_FRAG_INFO(t) \
66  t##GradientUniformFillPipeline::FragmentShader::FragInfo
67 #define UNIFORM_COLOR_SIZE ARRAY_LEN(UNIFORM_FRAG_INFO(Sweep)::colors)
68 #define UNIFORM_STOP_SIZE ARRAY_LEN(UNIFORM_FRAG_INFO(Sweep)::stop_pairs)
70 static_assert(UNIFORM_STOP_SIZE == kMaxUniformGradientStops / 2);
71 
73  const Entity& entity,
74  RenderPass& pass) const {
75  if (renderer.GetDeviceCapabilities().SupportsSSBO()) {
76  return RenderSSBO(renderer, entity, pass);
77  }
78  if (colors_.size() <= kMaxUniformGradientStops &&
79  stops_.size() <= kMaxUniformGradientStops) {
80  return RenderUniform(renderer, entity, pass);
81  }
82  return RenderTexture(renderer, entity, pass);
83 }
84 
85 bool SweepGradientContents::RenderSSBO(const ContentContext& renderer,
86  const Entity& entity,
87  RenderPass& pass) const {
90 
91  VS::FrameInfo frame_info;
92  frame_info.matrix = GetInverseEffectTransform();
93  VS::BindFrameInfo(
94  pass, renderer.GetTransientsDataBuffer().EmplaceUniform(frame_info));
95 
96  PipelineBuilderCallback pipeline_callback =
97  [&renderer](ContentContextOptions options) {
98  return renderer.GetSweepGradientSSBOFillPipeline(options);
99  };
100  return ColorSourceContents::DrawGeometry<VS>(
101  renderer, entity, pass, pipeline_callback, frame_info,
102  [this, &renderer, &entity](RenderPass& pass) {
103  FS::FragInfo frag_info;
104  frag_info.center = center_;
105  frag_info.bias = bias_;
106  frag_info.scale = scale_;
107  frag_info.tile_mode = static_cast<Scalar>(tile_mode_);
108  frag_info.decal_border_color = decal_border_color_;
109  frag_info.alpha =
110  GetOpacityFactor() *
112 
113  auto& data_host_buffer = renderer.GetTransientsDataBuffer();
114  auto colors = CreateGradientColors(colors_, stops_);
115 
116  frag_info.colors_length = colors.size();
117  auto color_buffer = data_host_buffer.Emplace(
118  colors.data(), colors.size() * sizeof(StopData),
119  renderer.GetDeviceCapabilities()
121 
122  pass.SetCommandLabel("SweepGradientSSBOFill");
123 
124  FS::BindFragInfo(
125  pass, renderer.GetTransientsDataBuffer().EmplaceUniform(frag_info));
126  FS::BindColorData(pass, color_buffer);
127 
128  return true;
129  });
130 }
131 
132 bool SweepGradientContents::RenderUniform(const ContentContext& renderer,
133  const Entity& entity,
134  RenderPass& pass) const {
137 
138  VS::FrameInfo frame_info;
139  frame_info.matrix = GetInverseEffectTransform();
140  VS::BindFrameInfo(
141  pass, renderer.GetTransientsDataBuffer().EmplaceUniform(frame_info));
142 
143  PipelineBuilderCallback pipeline_callback =
144  [&renderer](ContentContextOptions options) {
145  return renderer.GetSweepGradientUniformFillPipeline(options);
146  };
147  return ColorSourceContents::DrawGeometry<VS>(
148  renderer, entity, pass, pipeline_callback, frame_info,
149  [this, &renderer, &entity](RenderPass& pass) {
150  FS::FragInfo frag_info;
151  frag_info.center = center_;
152  frag_info.bias = bias_;
153  frag_info.scale = scale_;
154  frag_info.tile_mode = static_cast<Scalar>(tile_mode_);
155  frag_info.alpha =
156  GetOpacityFactor() *
157  GetGeometry()->ComputeAlphaCoverage(entity.GetTransform());
158  frag_info.colors_length = PopulateUniformGradientColors(
159  colors_, stops_, frag_info.colors, frag_info.stop_pairs);
160 
161  frag_info.decal_border_color = decal_border_color_;
162 
163  pass.SetCommandLabel("SweepGradientUniformFill");
164 
165  FS::BindFragInfo(
166  pass, renderer.GetTransientsDataBuffer().EmplaceUniform(frag_info));
167 
168  return true;
169  });
170 }
171 
172 bool SweepGradientContents::RenderTexture(const ContentContext& renderer,
173  const Entity& entity,
174  RenderPass& pass) const {
177 
178  auto gradient_data = CreateGradientBuffer(colors_, stops_);
179  auto gradient_texture =
180  CreateGradientTexture(gradient_data, renderer.GetContext());
181  if (gradient_texture == nullptr) {
182  return false;
183  }
184 
185  VS::FrameInfo frame_info;
186  frame_info.matrix = GetInverseEffectTransform();
187 
188  PipelineBuilderCallback pipeline_callback =
189  [&renderer](ContentContextOptions options) {
190  return renderer.GetSweepGradientFillPipeline(options);
191  };
192  return ColorSourceContents::DrawGeometry<VS>(
193  renderer, entity, pass, pipeline_callback, frame_info,
194  [this, &renderer, &gradient_texture, &entity](RenderPass& pass) {
195  FS::FragInfo frag_info;
196  frag_info.center = center_;
197  frag_info.bias = bias_;
198  frag_info.scale = scale_;
199  frag_info.texture_sampler_y_coord_scale =
200  gradient_texture->GetYCoordScale();
201  frag_info.tile_mode = static_cast<Scalar>(tile_mode_);
202  frag_info.decal_border_color = decal_border_color_;
203  frag_info.alpha =
204  GetOpacityFactor() *
205  GetGeometry()->ComputeAlphaCoverage(entity.GetTransform());
206  frag_info.half_texel =
207  Vector2(0.5 / gradient_texture->GetSize().width,
208  0.5 / gradient_texture->GetSize().height);
209 
210  SamplerDescriptor sampler_desc;
211  sampler_desc.min_filter = MinMagFilter::kLinear;
212  sampler_desc.mag_filter = MinMagFilter::kLinear;
213 
214  pass.SetCommandLabel("SweepGradientFill");
215 
216  FS::BindFragInfo(
217  pass, renderer.GetTransientsDataBuffer().EmplaceUniform(frag_info));
218  FS::BindTextureSampler(
219  pass, gradient_texture,
220  renderer.GetContext()->GetSamplerLibrary()->GetSampler(
221  sampler_desc));
222 
223  return true;
224  });
225 }
226 
228  const ColorFilterProc& color_filter_proc) {
229  for (Color& color : colors_) {
230  color = color_filter_proc(color);
231  }
232  decal_border_color_ = color_filter_proc(decal_border_color_);
233  return true;
234 }
235 
236 } // namespace impeller
virtual size_t GetMinimumStorageBufferAlignment() const
The minimum alignment of storage buffer value offsets in bytes.
Definition: capabilities.cc:14
virtual bool SupportsSSBO() const =0
Whether the context backend supports binding Shader Storage Buffer Objects (SSBOs) to pipelines.
const Geometry * GetGeometry() const
Get the geometry that this contents will use to render.
Scalar GetOpacityFactor() const
Get the opacity factor for this color source.
bool AppliesAlphaForStrokeCoverage(const Matrix &transform) const
Whether the entity should be treated as non-opaque due to stroke geometry requiring alpha for coverag...
const Matrix & GetInverseEffectTransform() const
Set the inverted effect transform for this color source.
std::function< PipelineRef(ContentContextOptions)> PipelineBuilderCallback
const Capabilities & GetDeviceCapabilities() const
PipelineRef GetSweepGradientSSBOFillPipeline(ContentContextOptions opts) const
HostBuffer & GetTransientsDataBuffer() const
Retrieve the current host buffer for transient storage of other non-index data.
std::function< Color(Color)> ColorFilterProc
Definition: contents.h:35
const Matrix & GetTransform() const
Get the global transform matrix for this Entity.
Definition: entity.cc:44
virtual Scalar ComputeAlphaCoverage(const Matrix &transform) const
Definition: geometry.h:125
BufferView EmplaceUniform(const UniformType &uniform)
Emplace uniform data onto the host buffer. Ensure that backend specific uniform alignment requirement...
Definition: host_buffer.h:47
Render passes encode render commands directed as one specific render target into an underlying comman...
Definition: render_pass.h:30
FragmentShader_ FragmentShader
Definition: pipeline.h:164
void SetTileMode(Entity::TileMode tile_mode)
void SetCenterAndAngles(Point center, Degrees start_angle, Degrees end_angle)
bool Render(const ContentContext &renderer, const Entity &entity, RenderPass &pass) const override
bool ApplyColorFilter(const ColorFilterProc &color_filter_proc) override
If possible, applies a color filter to this contents inputs on the CPU.
bool IsOpaque(const Matrix &transform) const override
Whether this Contents only emits opaque source colors from the fragment stage. This value does not ac...
const std::vector< Color > & GetColors() const
const std::vector< Scalar > & GetStops() const
void SetStops(std::vector< Scalar > stops)
void SetColors(std::vector< Color > colors)
Point Vector2
Definition: point.h:331
float Scalar
Definition: scalar.h:19
LinePipeline::FragmentShader FS
int PopulateUniformGradientColors(const std::vector< Color > &colors, const std::vector< Scalar > &stops, Vector4 frag_info_colors[kMaxUniformGradientStops], Vector4 frag_info_stop_pairs[kMaxUniformGradientStops/2])
Populate 2 arrays with the colors and stop data for a gradient.
std::vector< StopData > CreateGradientColors(const std::vector< Color > &colors, const std::vector< Scalar > &stops)
Populate a vector with the color and stop data for a gradient.
LinePipeline::VertexShader VS
std::shared_ptr< Texture > CreateGradientTexture(const GradientData &gradient_data, const std::shared_ptr< impeller::Context > &context)
Create a host visible texture that contains the gradient defined by the provided gradient data.
GradientData CreateGradientBuffer(const std::vector< Color > &colors, const std::vector< Scalar > &stops)
Populate a vector with the interpolated color bytes for the linear gradient described by colors and s...
Definition: gradient.cc:20
static constexpr uint32_t kMaxUniformGradientStops
Scalar alpha
Definition: color.h:143
Scalar degrees
Definition: scalar.h:67
A 4x4 matrix using column-major storage.
Definition: matrix.h:37
#define UNIFORM_STOP_SIZE
#define UNIFORM_COLOR_SIZE