如何在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
相关产品推荐
相关产品推荐

