在 Python 中处理 SVG 滤镜

快速回答： 要在 Python 中处理 SVG 滤镜，请用 SVGDocument 加载 SVG，用 query_selector() 找到目标元素，通过 set_attribute() 设置它的 filter 属性，然后保存 SVG。

from aspose.svg import SVGDocument

with SVGDocument("document.svg") as document:
    element = document.root_element.query_selector("circle")
    if element is not None:
        element.set_attribute("filter", "url(#filter-id)")
    document.save("filtered.svg")

SVG 滤镜可以创建模糊、阴影、发光、光照和颜色处理等视觉效果。滤镜通常定义在 <defs> 中，并通过 filter="url(#filter-id)" 属性应用到可见元素。在 Aspose.SVG for Python via .NET 中，你通过 SVG DOM 处理滤镜：查找目标元素，创建滤镜 primitive，设置属性，追加节点，并保存编辑后的文件。

在本文中，你将学习如何：

• 在 Python 中创建 SVG blur filter 并应用到元素；
• 使用滤镜 primitives 构建 drop shadow filter；
• 编辑 stdDeviation、dx、dy 和 flood-color 等滤镜属性；
• 从 SVG 元素中移除 filter 引用，而不删除可复用的滤镜定义。

SVG 滤镜编辑基础

滤镜工作流包含两部分：滤镜定义和滤镜引用。定义位于 <defs> 中，而可见元素通过 ID 指向它。

任务	要编辑的 SVG 标记	典型 API 模式
应用现有滤镜	filter="url(#filter-id)"	用 query_selector() 找到可见元素并设置 filter 属性
创建新滤镜	<defs><filter id="..."></filter></defs>	用 create_element_ns() 创建 SVG 元素，并用 append_child() 追加它们
配置模糊或阴影	stdDeviation、dx、dy、flood-color 等滤镜 primitive 属性	找到 primitive 并更新属性
移除效果	可见元素上的 filter 属性	用 remove_attribute() 移除 filter 引用

如何在 Python 中应用 SVG 滤镜

当 SVG 文件需要模糊、阴影、发光或其他滤镜效果时，可以使用这个工作流：

1. 用 SVGDocument 加载 SVG 文件。
2. 查找或创建用于存储可复用定义的 <defs> 元素。
3. 查找或创建具有稳定 id 的 <filter> 元素。
4. 添加或更新 <feGaussianBlur>、<feOffset> 或 <feDropShadow> 等滤镜 primitives。
5. 用 filter="url(#filter-id)" 将滤镜应用到可见 SVG 元素。
6. 保存编辑后的 SVG，并检查渲染输出。

下面的示例使用 svg-filters.svg 作为输入文件。

创建并应用模糊滤镜

滤镜必须先定义，之后可见元素才能使用它。下面的示例在 <defs> 中创建 #blur 滤镜，添加 <feGaussianBlur> primitive，把滤镜应用到圆，并把结果保存为 svg-blur-filter-applied.svg。

import os
from aspose.svg import SVGDocument

SVG_NS = "http://www.w3.org/2000/svg"

input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "svg-filters.svg")
output_path = os.path.join(output_folder, "svg-blur-filter-applied.svg")
os.makedirs(output_folder, exist_ok=True)

with SVGDocument(input_path) as document:
    svg = document.root_element
    defs = svg.query_selector("defs")

    if defs is None:
        defs = document.create_element_ns(SVG_NS, "defs")
        svg.insert_before(defs, svg.first_child)

    blur_filter = document.create_element_ns(SVG_NS, "filter")
    blur_filter.set_attribute("id", "blur")
    blur_filter.set_attribute("x", "-20%")
    blur_filter.set_attribute("y", "-20%")
    blur_filter.set_attribute("width", "140%")
    blur_filter.set_attribute("height", "140%")

    gaussian_blur = document.create_element_ns(SVG_NS, "feGaussianBlur")
    gaussian_blur.set_attribute("in", "SourceGraphic")
    gaussian_blur.set_attribute("stdDeviation", "3")

    blur_filter.append_child(gaussian_blur)
    defs.append_child(blur_filter)

    circle = svg.query_selector("circle")
    if circle is not None:
        circle.set_attribute("filter", "url(#blur)")

    document.save(output_path)

代码展示 SVG 滤镜工作流所需的两个部分。<filter> 和 <feGaussianBlur> 元素定义效果，filter="url(#blur)" 属性把该效果应用到可见圆上。插图比较源 SVG 图像 (a) 与应用模糊后的圆 (b)。

创建 Drop Shadow 滤镜

当 SVG 中还没有你需要的效果时，可以创建新滤镜。下一个示例使用 <feDropShadow> 创建 #label-shadow 滤镜，把它追加到 <defs>，并应用到文本标签。

import os
from aspose.svg import SVGDocument

SVG_NS = "http://www.w3.org/2000/svg"

input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "svg-filters.svg")
output_path = os.path.join(output_folder, "svg-drop-shadow-filter.svg")
os.makedirs(output_folder, exist_ok=True)

with SVGDocument(input_path) as document:
    svg = document.root_element
    defs = svg.query_selector("defs")

    if defs is None:
        defs = document.create_element_ns(SVG_NS, "defs")
        svg.insert_before(defs, svg.first_child)

    shadow_filter = document.create_element_ns(SVG_NS, "filter")
    shadow_filter.set_attribute("id", "label-shadow")
    shadow_filter.set_attribute("x", "-20%")
    shadow_filter.set_attribute("y", "-20%")
    shadow_filter.set_attribute("width", "150%")
    shadow_filter.set_attribute("height", "150%")

    drop_shadow = document.create_element_ns(SVG_NS, "feDropShadow")
    drop_shadow.set_attribute("dx", "6")
    drop_shadow.set_attribute("dy", "8")
    drop_shadow.set_attribute("stdDeviation", "2")
    drop_shadow.set_attribute("flood-color", "#455a64")
    drop_shadow.set_attribute("flood-opacity", "0.6")

    shadow_filter.append_child(drop_shadow)
    defs.append_child(shadow_filter)

    label = svg.query_selector("#label")
    if label is not None:
        label.set_attribute("filter", "url(#label-shadow)")

    document.save(output_path)

此示例展示滤镜工作流的两个部分：可复用滤镜在 <defs> 中创建，可见文本元素接收 filter="url(#label-shadow)"。如果缺少其中任一部分，阴影都不会出现。插图显示原始标签图像 (a) 以及带 drop shadow 的同一标签 (b)。

编辑现有滤镜属性

滤镜效果由滤镜 primitive 上的属性控制。下面的示例打开由模糊示例创建的 SVG，找到 #blur 内部的 <feGaussianBlur>，并增大它的 stdDeviation 值。

import os
from aspose.svg import SVGDocument

input_folder = "output/"
output_folder = "output/"
input_path = os.path.join(input_folder, "svg-blur-filter-applied.svg")
output_path = os.path.join(output_folder, "svg-filter-attributes-edited.svg")
os.makedirs(output_folder, exist_ok=True)

with SVGDocument(input_path) as document:
    svg = document.root_element
    blur = svg.query_selector("#blur feGaussianBlur")

    if blur is not None:
        blur.set_attribute("stdDeviation", "8")

    document.save(output_path)

输出使用同一个滤镜 ID，但由于 stdDeviation 从 3 改为 8，模糊效果更强。插图比较第一次模糊结果图像 (a) 与编辑滤镜 primitive 后更强的模糊效果 (b)。

从 SVG 元素中移除滤镜

从可见元素中移除滤镜，与删除滤镜定义不同。下一个示例打开由模糊示例创建的 SVG，只从圆上移除 filter 引用；#blur 定义可以继续留在 <defs> 中供复用。

import os
from aspose.svg import SVGDocument

input_folder = "output/"
output_folder = "output/"
input_path = os.path.join(input_folder, "svg-blur-filter-applied.svg")
output_path = os.path.join(output_folder, "svg-filter-removed.svg")
os.makedirs(output_folder, exist_ok=True)

with SVGDocument(input_path) as document:
    circle = document.root_element.query_selector("circle")

    if circle is not None and circle.has_attribute("filter"):
        circle.remove_attribute("filter")

    document.save(output_path)

当某个滤镜不应再影响特定元素，但其他元素可能仍使用同一滤镜定义时，可以使用这种模式。

常见错误和修复

问题	修复
滤镜没有显示	确认可见元素具有 filter="url(#filter-id)"，并且该 ID 存在于 <defs> 中
阴影或模糊被裁切	在 <filter> 上通过 x、y、width 和 height 扩大滤镜区域
滤镜影响了错误元素	把 filter 属性应用到真正应接收效果的可见形状或组上
编辑 fill 或 stroke 没有改变效果	更新滤镜 primitive 属性，例如 stdDeviation、flood-color、dx 或 dy
重复 filter ID 导致输出混乱	使用稳定且唯一的 ID，并同步更新 url(#...) 引用
输出文件没有变化	保存编辑后的文档，并打开输出路径，而不是输入 SVG

FAQ

如何在 Python 中应用 SVG 滤镜？

用 SVGDocument 加载 SVG，找到可见目标元素，并通过 set_attribute() 设置 filter="url(#filter-id)"。被引用的 <filter> 必须存在于 SVG 文档中，通常位于 <defs> 内。

如何创建 SVG 模糊滤镜？

在 <defs> 中创建 <filter> 元素，添加 <feGaussianBlur> primitive，设置 stdDeviation，然后用 filter="url(#filter-id)" 把滤镜应用到可见元素。

如何在 Python 中给 SVG 添加 drop shadow？

创建包含 <feDropShadow> 等阴影 primitive 的滤镜，设置 dx、dy、stdDeviation 和 flood-color 等属性，把滤镜追加到 <defs>，并用 filter="url(#filter-id)" 应用它。

可以编辑现有 SVG 滤镜属性吗？

可以。找到滤镜 primitive，例如 #blur feGaussianBlur，并更新 stdDeviation 等属性。修改后保存 SVG。

可以不从 defs 中删除定义，只移除滤镜吗？

可以。从可见元素中删除 filter 属性即可。如果其他元素仍在使用该 <filter> 定义，或你想稍后复用它，定义可以继续保留在 <defs> 中。

相关文章

• Python 高级 SVG 编辑 汇总了编辑 SVG 样式、几何图形、滤镜和可复用图形的定向工作流。
• 在 Python 中编辑 SVG 样式 介绍 presentation attributes、内联样式、CSS 块和样式优先级。
• 在 Python 中修改 SVG 颜色 说明 fill、stroke、内联样式和渐变的颜色编辑。
• 在 Python 中用 CSS 选择器编辑 SVG 元素 展示在应用滤镜或其他编辑之前如何定位 SVG 元素。
• 处理 SVG 属性 说明如何获取、设置、检查和删除 SVG 属性。