Matplotlib中无法将Path设为clip_path，如何为Patch添加transform？

我尝试在Matplotlib中制作Patch动画，想用Patch作为clip_path实现黑色描边逐步填充的效果，目标是复刻animCJK项目里的SVG动画。从SVG文件提取贝塞尔曲线信息后，用svgpath2mpl库生成自定义Path，替换Matplotlib官方示例里的圆形Patch时，出现了以下错误：

Traceback (most recent call last):
  File "C:\Users\Chris\Desktop\quick.py", line 15, in <module>
    im.set_clip_path(patch)
  File "C:\Users\Chris\AppData\Local\Programs\Python\Python39\lib\site-packages\matplotlib\artist.py", line 793, in set_clip_path
    self._clippath = TransformedPath(path, transform)
  File "C:\Users\Chris\AppData\Local\Programs\Python\Python39\lib\site-packages\matplotlib\transforms.py", line 2708, in __init__
    _api.check_isinstance(Transform, transform=transform)
  File "C:\Users\Chris\AppData\Local\Programs\Python\Python39\lib\site-packages\matplotlib\_api\__init__.py", line 92, in check_isinstance
    raise TypeError(
TypeError: 'transform' must be an instance of matplotlib.transforms.Transform, not a None

错误提示transform必须是matplotlib.transforms.Transform实例而非None，需要为Path对象添加transform=ax.transData参数，原代码如下：

import matplotlib.pyplot as plt
import matplotlib.patches as patches
import matplotlib.cbook as cbook
from svgpath2mpl import parse_path

string = "M181 359C174 359 165 363 166 371C167 382 176 389 183 396C198 412 199 435 204 455C222 538 238 623 276 700C300 745 333 786 374 816C385 824 400 826 411 818C418 814 420 805 420 797C421 780 417 762 420 745C422 720 430 696 436 671C437 666 438 657 431 654C424 652 417 658 414 664C399 686 387 710 372 731C370 734 366 735 364 732C347 718 331 702 319 683C303 658 294 629 285 601C276 570 267 538 260 506C254 477 250 448 249 419C249 409 254 399 253 389C251 379 240 375 232 370C216 363 199 359 181 359Z"
patch = parse_path(string)

with cbook.get_sample_data('grace_hopper.jpg') as image_file:
    image = plt.imread(image_file)

fig, ax = plt.subplots()
im = ax.imshow(image)
im.set_clip_path(patch)

ax.axis('off')
plt.show()

解决方案 #

问题核心是parse_path生成的是Path对象，而非Patch对象。直接给set_clip_path传入Path时，Matplotlib无法自动获取对应的变换矩阵，因此需要手动指定transform，或者将Path包装为Patch对象。

方式一：调用set_clip_path时指定transform #

修改set_clip_path的调用，传入ax.transData作为变换参数：

im.set_clip_path(patch, transform=ax.transData)

方式二：将Path包装为Patch对象 #

用patches.PathPatch把生成的Path包装成Patch，Patch会自动绑定变换逻辑，之后直接传入set_clip_path即可：

# 替换原代码中patch = parse_path(string)的部分
path = parse_path(string)
patch = patches.PathPatch(path, transform=ax.transData)

# 后续调用保持不变
im.set_clip_path(patch)

额外注意事项 #

SVG路径的坐标体系与Matplotlib存在差异（SVG y轴向上，Matplotlib y轴向下），且路径范围可能和图像不匹配，建议添加以下代码调整坐标轴范围，确保裁剪效果正常显示：

# 获取路径的边界范围
xmin, xmax = path.get_extents().xmin, path.get_extents().xmax
ymin, ymax = path.get_extents().ymin, path.get_extents().ymax
# 设置坐标轴范围适配路径
ax.set_xlim(xmin, xmax)
ax.set_ylim(ymax, ymin)  # 反转y轴以匹配SVG坐标方向

内容的提问来源于stack exchange，提问作者J.Doe