You need to enable JavaScript to run this app. 如何在Kivy中堆叠带透明层的自定义图形实现储罐Widget填充效果
优惠活动
大模型
产品
解决方案
定价
更多

如何在Kivy中堆叠带透明层的自定义图形实现储罐Widget填充效果

Kivy带透明镂空层的储罐自定义图形实现方案

核心实现逻辑

你之前通过圆形、矩形搭配纯色填充实现储罐图形的经验,完全可以平移到现在的自定义图需求上,不需要从零重写绘制逻辑。核心差异在于:直接把带透明通道的储罐前景图、自定义产品填充图上下堆叠时,填充图会透过前景的透明区铺满整个Widget,不会自动被约束在镂空轮廓里。要实现目标效果,需要借助Kivy内置的Stencil(模板)绘制机制,把带透明层的前景图作为裁切边界,限定填充图的显示范围。

分步实操指南

  • 提前准备两类素材:
    • 前景储罐素材:带Alpha透明通道的PNG图,实体储罐部分为不透明像素,内部需要填充的镂空区域为全透明像素
    • 产品填充素材:不同物料对应的自定义图形纹理,支持动态切换
  • 按照固定顺序在Canvas块中堆叠图层,核心代码如下:
from kivy.graphics import Rectangle, StencilPush, StencilUse, StencilPop, StencilUnUse
from kivy.uix.widget import Widget

class CustomTank(Widget):
    def __init__(self, tank_foreground_img, product_fill_img, **kwargs):
        super().__init__(**kwargs)
        # 绑定画布绘制流程
        with self.canvas:
            # 推入模板栈,开启裁切模式
            StencilPush()
            # 绘制带透明层的前景储罐图,作为裁切边界
            self.fg_layer = Rectangle(
                source=tank_foreground_img,
                pos=self.pos,
                size=self.size
            )
            # 启用模板匹配:后续绘制的内容仅在边界范围内显示
            StencilUse()

            # 绘制自定义产品填充图,会自动被裁切到镂空区域
            self.fill_layer = Rectangle(
                source=product_fill_img,
                pos=self.pos,
                size=self.size
            )

            # 退出模板裁切模式,恢复正常绘制
            StencilUnUse()
            StencilPop()

        # 绑定Widget尺寸、位置变化时,自动同步更新图层坐标
        self.bind(pos=self.sync_layer_pos, size=self.sync_layer_size)

    def sync_layer_pos(self, *args):
        self.fg_layer.pos = self.pos
        self.fill_layer.pos = self.pos

    def sync_layer_size(self, *args):
        self.fg_layer.size = self.size
        self.fill_layer.size = self.size
  • 常见问题调整:
    • 绘制顺序不能错:必须按照“压栈→画裁切边界→启用模板→画被裁切的填充内容→出栈”的顺序写,顺序颠倒会出现图层全透明、内容越界的问题
    • 做液位动画时,只需要修改fill_layer的纵向pos值,填充图会自动贴合镂空形状做升降,不会超出储罐轮廓
    • 切换产品类型时,直接修改fill_layer.source为新的填充图路径即可,无需重写蒙版逻辑
    • 之前实现的纯色圆形、矩形填充逻辑,可以直接替换掉fill_layer的图形容器,完全兼容原有代码

内容的提问来源于stack exchange,提问作者Dmolley

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.19 04:06:04