如何使用pptx获取PPT中图片的层级深度以检查其可见性？

在python-pptx中，虽然图表有depth属性来反映叠放层级，但普通形状/图片并没有直接暴露这个属性。不过PPT的对象叠放次序（z-order）是通过幻灯片shapes集合的索引顺序来管理的：索引越靠后的形状，叠放层级越高，会覆盖前面的对象。基于这个逻辑，我们可以通过以下步骤检查图片是否被上方对象遮挡：

实现思路 #

1. 遍历幻灯片中的所有对象，筛选出图片类型（Picture）。
2. 对每张图片，检查所有索引大于它的对象（即层级在它之上的对象）。
3. 判断上方对象是否与图片的矩形区域重叠，若存在重叠则说明图片被遮挡。

代码实现 #

1. 导入依赖 #

from pptx import Presentation
from pptx.shapes.picture import Picture

2. 定义区域重叠判断函数 #

def shapes_overlap(shape_a, shape_b):
    # 计算两个对象的矩形边界坐标
    a_left, a_top = shape_a.left, shape_a.top
    a_right = a_left + shape_a.width
    a_bottom = a_top + shape_a.height

    b_left, b_top = shape_b.left, shape_b.top
    b_right = b_left + shape_b.width
    b_bottom = b_top + shape_b.height

    # 判断矩形是否存在交集
    return not (
        a_right <= b_left or
        a_left >= b_right or
        a_bottom <= b_top or
        a_top >= b_bottom
    )

3. 遍历PPT检查图片可见性 #

def audit_picture_visibility(ppt_file_path):
    prs = Presentation(ppt_file_path)
    for slide_num, slide in enumerate(prs.slides, start=1):
        print(f"=== 幻灯片 {slide_num} 图片检查结果 ===")
        # 收集当前幻灯片的所有图片及其索引
        pictures = [
            (idx, shape) for idx, shape in enumerate(slide.shapes)
            if isinstance(shape, Picture)
        ]
        for pic_idx, pic in pictures:
            obscured = False
            # 检查所有层级在图片之上的对象
            for upper_idx in range(pic_idx + 1, len(slide.shapes)):
                upper_shape = slide.shapes[upper_idx]
                # 跳过不可见的对象（如隐藏形状）
                if not upper_shape.is_visible:
                    continue
                if shapes_overlap(pic, upper_shape):
                    obscured = True
                    break
            status = "【被遮挡】" if obscured else "【可见】"
            print(f"图片 '{pic.name}'（索引：{pic_idx}）: {status}")

注意事项 #

• 该方法基于矩形区域重叠判断，无法识别对象透明度导致的部分可见情况（比如半透明形状覆盖图片）。
• 如果需要判断图片是否被完全遮挡，可以修改shapes_overlap函数为判断图片的矩形是否被上方形状完全包含。
• 幻灯片中的占位符（Placeholder）如果包含内容，也会被视为层级对象，需要根据实际需求决定是否跳过。
• 图表的depth属性本质上也是对应z-order的层级值，普通形状的层级关系可以通过shapes集合的索引位置等价判断。

内容的提问来源于stack exchange，提问作者Francesco Pettini