用途:在 PixiJS v8 中为容器或精灵添加视觉效果。通过给 container.filters 赋值单个滤镜或数组(数组用于链式叠加)来应用效果。
主要能力:内置滤镜包含 AlphaFilter、BlurFilter、ColorMatrixFilter、DisplacementFilter、NoiseFilter。自定义滤镜可用 Filter.from(...) 包装 GLSL/WGSL 片段着色器。BlurFilter 支持 strength、quality、strengthX/strengthY、kernelSize(须为奇数)、repeatEdgePixels。ColorMatrixFilter 提供 brightness、contrast、saturate、negative、sepia 等预设,可通过 matrix(20 元素数组)和 alpha 直接访问。DisplacementFilter 的 scale 可为数字或 PointData。NoiseFilter 的 seed 决定噪声图案,相同 seed 复现相同结果。
用法:为精灵设置 sprite.filters = [blur, colorMatrix]。Filter.from({ gl: { fragment } , resources: {...} }) 可仅提供片段着色器;自行构造可用 GlProgram.from 或 GpuProgram.from。着色器用 out vec4 finalColor 与 texture(),纹理放在 resources 而非 uniforms。滤镜选项含 resolution、padding、antialias、blendMode、blendRequired、clipToViewport。已知尺寸容器设置 container.filterArea 可避免逐帧测量。filter.enabled 可开关注效。社区滤镜在 v8 用 pixi-filters/{name} 导入。高级混合模式需先 import "pixi.js/advanced-blend-modes"。
适用场景:需要模糊、调色、位移、噪声、发光等画面效果,或在 WebGL/WebGPU 下自定义着色器特效。
限制与注意:v8 使用选项对象构造 Filter,旧 (vertex, fragment, uniforms) 写法错误;@pixi/filter-* 仅适用于 v7;同一滤镜加在父容器比逐个加在子元素更省性能;blendRequired 滤镜在 WebGL 需 useBackBuffer: true;高级混合模式继承 Filter.defaultOptions,高 DPI 下可将 resolution 设为 'inherit'。部分细节暂未提供。