impeller::Paint::MaskBlurDescriptor Struct Reference

#include <paint.h>

Public Member Functions
std::shared_ptr< FilterContents >	CreateMaskBlur (std::shared_ptr< ColorSourceContents > color_source_contents, const std::shared_ptr< ColorFilter > &color_filter) const
std::shared_ptr< FilterContents >	CreateMaskBlur (std::shared_ptr< TextureContents > texture_contents) const
std::shared_ptr< FilterContents >	CreateMaskBlur (const FilterInput::Ref &input, bool is_solid_color, const Matrix &ctm) const

Public Attributes
FilterContents::BlurStyle	style
Sigma	sigma
bool	respect_ctm = true

Detailed Description

Definition at line 48 of file paint.h.

Member Function Documentation

CreateMaskBlur() [1/3]

std::shared_ptr< FilterContents > impeller::Paint::MaskBlurDescriptor::CreateMaskBlur	(	const FilterInput::Ref &	input,
		bool	is_solid_color,
		const Matrix &	ctm
	)		const

Definition at line 205 of file paint.cc.

                             {
  Vector2 blur_sigma(sigma.sigma, sigma.sigma);
  if (!respect_ctm) {
    blur_sigma /= Vector2(ctm.GetBasisX().Length(), ctm.GetBasisY().Length());
  }
  if (is_solid_color) {
    return FilterContents::MakeGaussianBlur(input, Sigma(blur_sigma.x),
                                            Sigma(blur_sigma.y),
                                            Entity::TileMode::kDecal, style);
  }
  return FilterContents::MakeBorderMaskBlur(input, Sigma(blur_sigma.x),
                                            Sigma(blur_sigma.y), style);
}

References impeller::Matrix::GetBasisX(), impeller::Matrix::GetBasisY(), impeller::Entity::kDecal, impeller::Vector3::Length(), impeller::FilterContents::MakeBorderMaskBlur(), impeller::FilterContents::MakeGaussianBlur(), impeller::Paint::style, impeller::TPoint< T >::x, and impeller::TPoint< T >::y.

CreateMaskBlur() [2/3]

std::shared_ptr< FilterContents > impeller::Paint::MaskBlurDescriptor::CreateMaskBlur	(	std::shared_ptr< ColorSourceContents >	color_source_contents,
		const std::shared_ptr< ColorFilter > &	color_filter
	)		const

1. Create an opaque white mask of the original geometry.
2. Blur the mask.
3. Replace the geometry of the original color source with a rectangle that covers the full region of the blurred mask. Note that geometry is in local bounds.
4. Apply the user set color filter on the GPU, if applicable.
5. Composite the color source with the blurred mask.

Definition at line 155 of file paint.cc.

                                                          {
  // If it's a solid color and there is no color filter, then we can just get
  // away with doing one Gaussian blur.
  if (color_source_contents->IsSolidColor() && !color_filter) {
    return FilterContents::MakeGaussianBlur(
        FilterInput::Make(color_source_contents), sigma, sigma,
        Entity::TileMode::kDecal, style, color_source_contents->GetGeometry());
  }
 
  /// 1. Create an opaque white mask of the original geometry.
 
  auto mask = std::make_shared<SolidColorContents>();
  mask->SetColor(Color::White());
  mask->SetGeometry(color_source_contents->GetGeometry());
 
  /// 2. Blur the mask.
 
  auto blurred_mask = FilterContents::MakeGaussianBlur(
      FilterInput::Make(mask), sigma, sigma, Entity::TileMode::kDecal, style,
      color_source_contents->GetGeometry());
 
  /// 3. Replace the geometry of the original color source with a rectangle that
  ///    covers the full region of the blurred mask. Note that geometry is in
  ///    local bounds.
 
  auto expanded_local_bounds = blurred_mask->GetCoverage({});
  if (!expanded_local_bounds.has_value()) {
    expanded_local_bounds = Rect();
  }
  color_source_contents->SetGeometry(
      Geometry::MakeRect(*expanded_local_bounds));
  std::shared_ptr<Contents> color_contents = color_source_contents;
 
  /// 4. Apply the user set color filter on the GPU, if applicable.
 
  if (color_filter) {
    color_contents = color_filter->WrapWithGPUColorFilter(
        FilterInput::Make(color_source_contents),
        ColorFilterContents::AbsorbOpacity::kYes);
  }
 
  /// 5. Composite the color source with the blurred mask.
 
  return ColorFilterContents::MakeBlend(
      BlendMode::kSourceIn,
      {FilterInput::Make(blurred_mask), FilterInput::Make(color_contents)});
}

References impeller::Paint::color_filter, impeller::Entity::kDecal, impeller::kSourceIn, impeller::ColorFilterContents::kYes, impeller::FilterInput::Make(), impeller::ColorFilterContents::MakeBlend(), impeller::FilterContents::MakeGaussianBlur(), impeller::Geometry::MakeRect(), impeller::Paint::style, and impeller::Color::White().

CreateMaskBlur() [3/3]

std::shared_ptr< FilterContents > impeller::Paint::MaskBlurDescriptor::CreateMaskBlur

(

std::shared_ptr< TextureContents >

texture_contents

)

const

Definition at line 127 of file paint.cc.

                                                           {
  Scalar expand_amount = GaussianBlurFilterContents::CalculateBlurRadius(
      GaussianBlurFilterContents::ScaleSigma(sigma.sigma));
  texture_contents->SetSourceRect(
      texture_contents->GetSourceRect().Expand(expand_amount, expand_amount));
  auto mask = std::make_shared<SolidColorContents>();
  mask->SetColor(Color::White());
  std::optional<Rect> coverage = texture_contents->GetCoverage({});
  std::shared_ptr<Geometry> geometry;
  if (coverage) {
    texture_contents->SetDestinationRect(
        coverage.value().Expand(expand_amount, expand_amount));
    geometry = Geometry::MakeRect(coverage.value());
  }
  mask->SetGeometry(geometry);
  auto descriptor = texture_contents->GetSamplerDescriptor();
  texture_contents->SetSamplerDescriptor(descriptor);
  std::shared_ptr<FilterContents> blurred_mask =
      FilterContents::MakeGaussianBlur(FilterInput::Make(mask), sigma, sigma,
                                       Entity::TileMode::kDecal, style,
                                       geometry);
 
  return ColorFilterContents::MakeBlend(
      BlendMode::kSourceIn,
      {FilterInput::Make(blurred_mask), FilterInput::Make(texture_contents)});
}

References impeller::GaussianBlurFilterContents::CalculateBlurRadius(), impeller::Entity::kDecal, impeller::kSourceIn, impeller::FilterInput::Make(), impeller::ColorFilterContents::MakeBlend(), impeller::FilterContents::MakeGaussianBlur(), impeller::Geometry::MakeRect(), impeller::GaussianBlurFilterContents::ScaleSigma(), impeller::Sigma::sigma, sigma, style, and impeller::Color::White().

Member Data Documentation

respect_ctm

bool impeller::Paint::MaskBlurDescriptor::respect_ctm = true

Text mask blurs need to not apply the CTM to the blur kernel. See: https://github.com/flutter/flutter/issues/115112

Definition at line 53 of file paint.h.

sigma

Sigma impeller::Paint::MaskBlurDescriptor::sigma

Definition at line 50 of file paint.h.

Referenced by CreateMaskBlur().

style

FilterContents::BlurStyle impeller::Paint::MaskBlurDescriptor::style

Definition at line 49 of file paint.h.

Referenced by CreateMaskBlur(), impeller::DlDispatcherBase::drawShadow(), impeller::testing::MaskBlurVariantTest(), and impeller::testing::TEST_P().

---

The documentation for this struct was generated from the following files:

• impeller/aiks/paint.h
• impeller/aiks/paint.cc