mirror of
https://github.com/flutter/flutter.git
synced 2026-02-20 02:29:02 +08:00
e6fbc63d37
The 2 enum classes `impeller::BlendMode` and `flutter::DlBlendMode` were essentially identical so they were merged. The names were consolidated to the ui.BlendMode/DlBlendMode versions and the implementation is shared from Impeller to DisplayList via a `using` directive. No conversion is needed any more to describe blend modes between DisplayList and Impeller.
133 lines
3.9 KiB
C++
133 lines
3.9 KiB
C++
// Copyright 2013 The Flutter Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
#ifndef FLUTTER_IMPELLER_ENTITY_ENTITY_H_
|
|
#define FLUTTER_IMPELLER_ENTITY_ENTITY_H_
|
|
|
|
#include <cstdint>
|
|
|
|
#include "impeller/entity/contents/contents.h"
|
|
#include "impeller/geometry/color.h"
|
|
#include "impeller/geometry/matrix.h"
|
|
#include "impeller/geometry/rect.h"
|
|
|
|
namespace impeller {
|
|
|
|
class Renderer;
|
|
class RenderPass;
|
|
|
|
class Entity {
|
|
public:
|
|
static constexpr BlendMode kLastPipelineBlendMode = BlendMode::kModulate;
|
|
static constexpr BlendMode kLastAdvancedBlendMode = BlendMode::kLuminosity;
|
|
|
|
static constexpr Scalar kDepthEpsilon = 1.0f / 262144.0;
|
|
|
|
enum class RenderingMode {
|
|
/// In direct mode, the Entity's transform is used as the current
|
|
/// local-to-screen transform matrix.
|
|
kDirect,
|
|
/// In subpass mode, the Entity passed through the filter is in screen space
|
|
/// rather than local space, and so some filters (namely,
|
|
/// MatrixFilterContents) need to interpret the given EffectTransform as the
|
|
/// current transform matrix.
|
|
kSubpassAppendSnapshotTransform,
|
|
kSubpassPrependSnapshotTransform,
|
|
};
|
|
|
|
/// An enum to define how to repeat, fold, or omit colors outside of the
|
|
/// typically defined range of the source of the colors (such as the
|
|
/// bounds of an image or the defining geometry of a gradient).
|
|
enum class TileMode {
|
|
/// Replicate the edge color if the shader draws outside of its original
|
|
/// bounds.
|
|
kClamp,
|
|
|
|
/// Repeat the shader's image horizontally and vertically (or both along and
|
|
/// perpendicular to a gradient's geometry).
|
|
kRepeat,
|
|
|
|
/// Repeat the shader's image horizontally and vertically, seamlessly
|
|
/// alternating mirrored images.
|
|
kMirror,
|
|
|
|
/// Render the shader's image pixels only within its original bounds. If the
|
|
/// shader draws outside of its original bounds, transparent black is drawn
|
|
/// instead.
|
|
kDecal,
|
|
};
|
|
|
|
enum class ClipOperation {
|
|
kDifference,
|
|
kIntersect,
|
|
};
|
|
|
|
/// @brief Create an entity that can be used to render a given snapshot.
|
|
static Entity FromSnapshot(const Snapshot& snapshot,
|
|
BlendMode blend_mode = BlendMode::kSrcOver);
|
|
|
|
Entity();
|
|
|
|
~Entity();
|
|
|
|
Entity(Entity&&);
|
|
|
|
Entity& operator=(Entity&&);
|
|
|
|
/// @brief Get the global transform matrix for this Entity.
|
|
const Matrix& GetTransform() const;
|
|
|
|
/// @brief Get the vertex shader transform used for drawing this Entity.
|
|
Matrix GetShaderTransform(const RenderPass& pass) const;
|
|
|
|
/// @brief Static utility that computes the vertex shader transform used for
|
|
/// drawing an Entity with a given the clip depth and RenderPass size.
|
|
static Matrix GetShaderTransform(Scalar clip_depth,
|
|
const RenderPass& pass,
|
|
const Matrix& transform);
|
|
|
|
/// @brief Set the global transform matrix for this Entity.
|
|
void SetTransform(const Matrix& transform);
|
|
|
|
std::optional<Rect> GetCoverage() const;
|
|
|
|
void SetContents(std::shared_ptr<Contents> contents);
|
|
|
|
const std::shared_ptr<Contents>& GetContents() const;
|
|
|
|
void SetClipDepth(uint32_t clip_depth);
|
|
|
|
uint32_t GetClipDepth() const;
|
|
|
|
float GetShaderClipDepth() const;
|
|
|
|
static float GetShaderClipDepth(uint32_t clip_depth);
|
|
|
|
void SetBlendMode(BlendMode blend_mode);
|
|
|
|
BlendMode GetBlendMode() const;
|
|
|
|
bool Render(const ContentContext& renderer, RenderPass& parent_pass) const;
|
|
|
|
static bool IsBlendModeDestructive(BlendMode blend_mode);
|
|
|
|
bool SetInheritedOpacity(Scalar alpha);
|
|
|
|
std::optional<Color> AsBackgroundColor(ISize target_size) const;
|
|
|
|
Entity Clone() const;
|
|
|
|
private:
|
|
Entity(const Entity&);
|
|
|
|
Matrix transform_;
|
|
std::shared_ptr<Contents> contents_;
|
|
BlendMode blend_mode_ = BlendMode::kSrcOver;
|
|
uint32_t clip_depth_ = 1u;
|
|
};
|
|
|
|
} // namespace impeller
|
|
|
|
#endif // FLUTTER_IMPELLER_ENTITY_ENTITY_H_
|