如何在Cairo中合并路径以消除相邻路径间的淡线？

可以通过将多个闭合路径合并为单个路径后统一填充的方式，避免相邻形状间出现淡空白线。这种问题本质是多个独立路径分别填充时，SVG渲染的抗锯齿或精度差异导致边缘出现缝隙。

以下是原问题中的示例代码，它因分别填充两个路径导致了分隔线：

import math, cairo

def draw_path_1(ctx):
    ctx.rectangle(40, 55, 30, 30)
    ctx.fill()

def draw_path_2(ctx):
    ctx.arc(70, 70, 30, -math.pi / 2, math.pi / 2)
    ctx.fill()

with cairo.SVGSurface("two_path_shape.svg", 150, 150) as surface:
    ctx = cairo.Context(surface)
    draw_path_1(ctx)
    draw_path_2(ctx)

通用解决方案：合并路径后单次填充 #

方法1：直接在同一上下文连续绘制路径后填充

将所有需要合并的路径依次绘制到同一个上下文，最后只执行一次填充操作，确保它们被视为单个形状：

import math, cairo

def draw_combined_path(ctx):
    # 绘制正方形路径
    ctx.rectangle(40, 55, 30, 30)
    # 衔接绘制半圆路径（注意方向匹配，保证路径闭合逻辑正确）
    ctx.arc(70, 70, 30, -math.pi / 2, math.pi / 2)
    # 闭合路径（可选，因rectangle本身已闭合，且arc终点与正方形起点衔接）
    ctx.close_path()
    # 单次填充整个合并路径
    ctx.fill()

with cairo.SVGSurface("combined_shape.svg", 150, 150) as surface:
    ctx = cairo.Context(surface)
    draw_combined_path(ctx)

方法2：通过append_path()合并已有路径对象

如果路径需要单独定义后再合并，可以用cairo.Path创建独立路径，再通过append_path()合并到上下文，最后统一填充：

import math, cairo

with cairo.SVGSurface("combined_shape_2.svg", 150, 150) as surface:
    ctx = cairo.Context(surface)
    
    # 创建第一个路径对象
    path1 = cairo.Path(ctx)
    path1.rectangle(40, 55, 30, 30)
    
    # 创建第二个路径对象
    path2 = cairo.Path(ctx)
    path2.arc(70, 70, 30, -math.pi / 2, math.pi / 2)
    
    # 将两个路径合并到当前上下文
    ctx.append_path(path1)
    ctx.append_path(path2)
    
    # 设置填充规则（默认WINDING规则可正确处理相邻路径的合并）
    ctx.set_fill_rule(cairo.FILL_RULE_WINDING)
    ctx.fill()

关键注意事项 #

• 路径方向：确保合并的路径绘制方向（顺时针/逆时针）一致，避免出现意外的镂空区域；
• 填充规则：复杂路径可切换FILL_RULE_EVEN_ODD或FILL_RULE_WINDING，适配不同的路径组合逻辑；
• 避免多次填充：核心原则是只对合并后的整体路径执行一次填充，不要分别填充独立路径。

内容的提问来源于stack exchange，提问作者The Matt