Visindigo::Widgets::LiquidGlassEffect Class

成员函数文档

[explicit, since Visindigo 0.13.0] LiquidGlassEffect::LiquidGlassEffect(QWidget *parent = nullptr)

parent 父窗口，且必须为将被应用效果的QWidget，否则效果可能无法正确显示。 构造函数。

这个function 从 Visindigo 0.13.0 开始支持。

[noexcept, since Visindigo 0.13.0] LiquidGlassEffect::~LiquidGlassEffect()

析构函数。

这个function 从 Visindigo 0.13.0 开始支持。

[static, since Visindigo 0.13.0] QImage LiquidGlassEffect::blurImage(const QImage &image, int radius)

对图像进行高斯模糊处理。 image 要模糊的图像。 radius 模糊效果的半径，值越大模糊效果越明显。

此函数不提供sigma的手动设置，其sigma采用

sigma = 0.3 * ((radius - 1) * 0.5 - 1) + 0.8

来计算，这个公式是OpenCV使用的经验公式，可以在不同半径下得到比较自然的模糊效果。

这个function 从 Visindigo 0.13.0 开始支持。

[static, since Visindigo 0.15.0] QImage LiquidGlassEffect::colorMaskImage(const QImage &image, const QColor &color, qreal percent)

对图像进行颜色遮罩处理。 image 要处理的图像。color 遮罩的颜色，决定了模糊效果的色调。percent 遮罩的透明度，值越大遮罩越透明，默认1。

这个function 从 Visindigo 0.15.0 开始支持。

[static, since Visindigo 0.13.0] QImage LiquidGlassEffect::distortImage(const QImage &coverdArea, int liquidDistortRadius)

对图像进行液体扭曲处理。 coverdArea 要扭曲的图像。 liquidDistortRadius 扭曲效果的半径，值越大扭曲效果越明显。 此函数通过对图像的边缘区域进行基于正弦函数的坐标偏移来实现液体流动的效果。 扭曲半径决定了边缘区域的宽度，半径越大，扭曲效果越明显。

为了保持性能，扭曲效果仅应用于图像的边缘区域，而图像的中心部分保持不变。 这种方法可以在不显著增加计算量的情况下提供明显的液体流动效果。

当扭曲半径超过图像最短边的一半时，内部会自动按最短边的一半进行扭曲，且不改变用户设置值。

此外，这个扭曲不为不同颜色分量提供不同强度的扭曲以形成色散，因为总的来说色散对于液态玻璃效果的贡献非常有限， 但性能损耗却相对较大，因此这个实现没有提供色散效果。

与此同时，由于液态玻璃通常需要模糊效果，本质上算是一种平滑处理，因此考虑到综合性能， 这个扭曲实现在采样的时候没有单独进行插值计算，因此单独使用时可能会出现锯齿状的边缘。

这个function 从 Visindigo 0.13.0 开始支持。

[override virtual, since Visindigo 0.13.0] void LiquidGlassEffect::draw(QPainter *painter)

重写了QGraphicsEffect的draw()方法，在其中实现了液态玻璃效果的绘制逻辑。 painter 用于绘制效果的QPainter对象。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void LiquidGlassEffect::setBackgroundImage(const QImage &image)

设置被模糊源的图像，仅在BackgroundPolicy为CustomImage时有效。 image 用于模糊的图像。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void LiquidGlassEffect::setBackgroundPolicy(Visindigo::Widgets::LiquidGlassEffect::BackgroundPolicy policy)

设置获取被模糊源的方法。 policy 获取被模糊源的方法，决定了模糊效果的来源。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void LiquidGlassEffect::setBlurRadius(int radius)

设置模糊效果的半径，单位为像素。 radius 模糊效果的半径，值越大模糊效果越明显。 出于性能考虑，建议不要设置过大的模糊半径，尤其是在较大的控件上。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void LiquidGlassEffect::setBorderRadius(int radius)

设置边框半径，单位为像素。 radius 边框的半径，值越大边框越圆润。 如果被应用效果的控件具有圆角，那么就应该同步设置此值以避免输出时溢出应有的视觉边界。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.15.0] void LiquidGlassEffect::setColorMask(const QColor &color, qreal percent)

设置颜色遮罩。 color 遮罩的颜色，决定了模糊效果的色调。 percent 遮罩的透明度，值越大遮罩越透明，默认1。 颜色遮罩会在模糊效果之后应用，可以用来调整模糊效果的整体色调和透明度，从而更好地模仿液态玻璃的外观。

这个function 从 Visindigo 0.15.0 开始支持。

[since Visindigo 0.13.0] void LiquidGlassEffect::setCustomGeometry(const QRect &geometry)

设置自定义几何形状，仅在PositionPolicy为CustomGeometry时有效。 geometry 自定义的几何形状，决定了模糊效果在CustomImage上的位置和大小。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void LiquidGlassEffect::setEffectTypes(Visindigo::Widgets::LiquidGlassEffect::EffectTypes effects)

设置效果类型 effects 要应用的效果类型，可以是EffectType的任意组合。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void LiquidGlassEffect::setLiquidDistortRadius(int radius)

设置液体扭曲效果的半径，单位为像素。 radius 扭曲效果的半径，值越大扭曲效果越明显。 当扭曲半径超过控件最短边的一半时，内部会自动按最短边的一半进行扭曲，且不改变用户设置值。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void LiquidGlassEffect::setPositionPolicy(Visindigo::Widgets::LiquidGlassEffect::PositionPolicy policy)

设置模糊效果的位置策略，仅在BackgroundPolicy为CustomImage时有效。 policy 模糊效果的位置策略，决定了模糊效果在CustomImage上的定位和裁剪方式。

这个function 从 Visindigo 0.13.0 开始支持。