Composite Blur插件技术文档

Composite Blur插件技术文档

obs-composite-blur A comprehensive blur plugin for OBS that provides several different blur algorithms, and proper compositing. 项目地址: https://gitcode.com/gh_mirrors/ob/obs-composite-blur

复合模糊插件 是一款为OBS Studio设计的高级模糊工具，支持多种模糊算法和效果，专为满足不同的质量要求和计算需求而生。

安装指南

全平台通用步骤

前往发布页面，点击最新版本下的“Assets”，选择适合您操作系统的安装程序（Windows、MacOS或Linux）。下载并运行该文件以完成OBS中的安装。

针对Ubuntu的安装方法

• 图形界面: 下载适用于您的Ubuntu版本（目前支持20.04和22.04）的.tar.gz文件，解压后将obs-composite-blur文件夹移动到~/.config/obs-studio/plugins目录下。
• 终端命令行:

# 对于Ubuntu 20.04 或 22.04
wget https://github.com/FiniteSingularity/obs-composite-blur/releases/download/v1.0.2/obs-composite-blur-1.0.2-ubuntu-XX.04.tar.gz.zip
unzip obs-composite-blur-1.0.2-ubuntu-XX.04.tar.gz.zip
tar -zxf obs-composite-blur-(DATE)-(HASH)-ubuntu-XX.04.tar.gz
mkdir ~/.config/obs-studio/plugins
mv obs-composite-blur ~/.config/obs-studio/plugins

使用AUR在Arch Linux上安装

对于Arch Linux用户，可以通过AUR及其助手来安装。例如，可以使用paru进行安装：

paru -S obs-composite-blur

使用说明

安装完成后，启动OBS Studio，在过滤器中寻找名为“Composite Blur”的选项。添加此滤镜至需要模糊的源，然后通过控制面板调整所需参数，如选择不同的模糊算法、效果、背景合成选项等。

API使用文档

请注意，Composite Blur作为OBS Studio的一个插件，并不直接提供传统意义上的API供外部调用。其配置和调用是通过OBS的内置UI进行的。但如果您需要脚本化控制或自动化设置，可以通过OBS提供的Scripting功能或场景切换脚本来间接操纵这些滤镜的属性。

项目特性概览

模糊算法

• 高斯模糊：高质量，适用于平滑过渡和动画。
• 多通道盒式模糊：高效，可调节多次迭代以接近高斯模糊效果。
• 双Kawase模糊：高性能且适用于大半径模糊，支持连续变化的模糊值。
• 像素化：模拟复古像素风格，支持多种形状和大小。

模糊效果

• 区域模糊：标准2D模糊。
• 方向性模糊：沿单一轴向的模糊。
• 动态模糊：模拟运动过程中的模糊效果。
• 缩放模糊：从中心点向外扩散的模糊。
• 倾斜移焦：模拟微缩景观效果，定义清晰平面。

注意事项

升级到1.1.0版本后，插件名称固定为英文，即使有本地化语言包也不再翻译。若之前设置了特定的本地化选项，可能需要注意这一点。另外，更新可能会影响原背景混合模式设置，如遇到问题，切换回默认设置即可解决。

如有任何问题，务必在GitHub项目中提交问题以获得帮助。

obs-composite-blur A comprehensive blur plugin for OBS that provides several different blur algorithms, and proper compositing. 项目地址: https://gitcode.com/gh_mirrors/ob/obs-composite-blur