TiXL 图像变形效果库(Lib.image.fx.distort)完全指南:从气泡放大到时间置换的 9 大算子

TiXL 图像变形效果库(Lib.image.fx.distort)完全指南:从气泡放大到时间置换的 9 大算子 音视频图形学桌面应用【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址https://gitcode.com/GitHub_Trending/t3/t3点击查看免费下载TiXL 的Lib.image.fx.distort是一组专注于图像几何变形的实时特效算子覆盖圆形放大BubbleZoom、镜头色散ChromaticDistortion、UV 位移贴图Displace、极坐标转换PolarCoordinates以及基于时间历史缓冲的 TimeDisplace 等能力适用于 VJ 演出、现场视觉与后期 PostFX 管线。阅读本文后你将掌握每个算子的输入参数语义、默认值与典型应用场景并能结合仓库中的算子源码与.t3配置定位实现细节直接在 TiXL 编辑器中搭建可复用的变形特效链。本文内容以 .help/docs/operators/lib/image/fx/distort/README.md 为骨架展开所有算子的 C# 定义与默认配置均可在 Operators/Lib/Symbols/image/fx/distort/ 目录下逐一对号入座。算子一览一张目录看懂整套变形家族Lib.image.fx.distort命名空间共收录 9 个算子每个算子在仓库中都对应BubbleZoom.cs / .t3 / .t3ui这样的三件套C# 插槽定义、TiXL 配置、编辑器 UI 布局目录见 Operators/Lib/Symbols/image/fx/distort/。其核心用途如下算子一句话定位典型场景BubbleZoom放大内部圆形区域并带平滑边缘放大镜、鱼眼放大、气泡变形Bulge / Blob distortChromaticDistortion模拟镜头色散边缘出现模糊与偏色PostFX 管线的镜头缺陷模拟Displace用第二张贴图按 UV 位移扭曲图像水面折射、能量扭曲、贴图扰动DistortAndShade双图合成出斜角/浮雕bevel/emboss质感纹理玻璃、浮雕文字、立体表面EdgeRepeat沿一条直线重复拉伸输入像素镜像拉伸、条纹扫掠、无限延伸地面FieldToImage将 ShaderGraph 字段渲染为图像把程序化场数据可视化或接入图像链KochKaleidoskope基于科赫雪花分形曲线的万花筒分形装饰、镜面对称万花筒PolarCoordinates圆形坐标与直角坐标互转wrap / unwrap极坐标贴图、环形展开、360° 环境展开TimeDisplace用纹理数组历史缓冲做时间维位移时间拖影、运动涟漪、历史帧扭曲从源码结构看这些算子都继承自InstanceT泛型基类通过[Input]/[Output]特性声明插槽例如BubbleZoom的定义见 BubbleZoom.cs其输出统一为SlotTexture2D即每个算子的产物都是一张可继续向下游传递的 2D 纹理。BubbleZoom带平滑边缘的圆形放大镜BubbleZoom 将图像内部圆形区域放大且边缘是平滑过渡的官方文档称之为Bulge / Blob distort / Fish Eye zoom / Magnifying glass效果。它非常适合在画面局部制造气泡般的张力例如放大画面中的某个主体同时保持外围不变。输入参数名称类型说明Image(Texture2D)输入图像Center(Vector2)放大圆心的位置Magnify(Single)放大倍率Feather(Single)边缘羽化宽度FeatherGradient(Gradient)自定义羽化渐变用于精细控制边缘过渡Radius(Single)放大区域的半径默认值 0.5FlipEffect(Single)翻转效果方向GainAndBias(Vector2)增益与偏置调整默认 (0.5, 0.5)Resolution(Int2)输出分辨率Bias(Single)整体偏置输出TextureOutputT3.Core.DataTypes.Texture2D仓库中 BubbleZoom.t3 的默认配置值得注意Radius默认为0.5、GainAndBias默认为{X: 0.5, Y: 0.5}而FeatherGradient默认是一条从透明Alpha0过渡到不透明的线性渐变——这说明羽化默认由渐变控制调试时若边缘过硬或过软应优先调整FeatherGradient的两个端点。ChromaticDistortion镜头色散与周边失真的模拟ChromaticDistortion 模拟光学镜头在边缘产生的成像误差表现为画面外圈的模糊或偏色类似色差文档还将其列入 PostFX 管线推荐组合MotionBlur、DepthOfField、ChromaticAberration、Glow、Grain、Blur。这是让画面更像真实镜头的关键算子。输入参数名称类型说明Texture2d(Texture2D Required)输入图像必填Center(Vector2)偏移效果中心Size(Single)控制效果强度Colorize(Single)将图像染成黄色调Distort(Single)镜头畸变强度配合下方 DistortOffset 使用DistortOffset(Single)均匀缩放图像用于修复使用 Distort 时边缘出现的多余伪影ScaleImage(Single)均匀缩放图像而不裁切边缘SampleCount(Int32)效果保真度数值越高结果越平滑但渲染越慢输出OutputT3.Core.DataTypes.Texture2D实践建议先调Size建立基础色散量再以Distort引入桶形/枕形畸变随后用DistortOffset补偿边缘伪影SampleCount是典型的质量-性能权衡旋钮实时演出时应从低值起步逐步上调。Displace贴图驱动的通用 UV 位移Displace 是变形家族中最通用的成员它用第二张纹理DisplaceMap作为位移场按通道值把Image的采样坐标推开从而产生水面、扭曲能量场、旗帜飘动等效果。文档还提示它与 DistortAndShade 可互相参考。输入参数名称类型说明Image(Texture2D Required)被位移的图像必填DisplaceMap(Texture2D Required)位移贴图必填DisplaceMode(Int32)位移模式Displacement(Single)位移强度DisplacementOffset(Single)位移偏置Twist(Single)扭转量Shade(Single)使效果变暗SampleRadius(Single)采样半径DisplaceMapOffset(Vector2)位移贴图自身的偏移WrapMode(TextureAddressMode)定义图像边缘是否及如何重复GenerateMips(Boolean)是否生成 Mip 贴图RGSS_4xAA(Boolean)是否启用 4x 旋转网格超采样抗锯齿TextureFiltering(Filter)纹理过滤方式输出OutputT3.Core.DataTypes.Texture2D实战要点DisplaceMap的对比度直接决定扭曲幅度通常先给Displacement一个适中小值再配合Twist增加螺旋感WrapMode用于控制图像边缘的循环方式Clamp / Wrap 等RGSS_4xAA在扭曲剧烈、出现锯齿时开启代价是更多采样开销。DistortAndShade双图合成的斜角与浮雕DistortAndShade 使用两张图像图像 A 被图像 B 位移从而在 A 上雕刻出 B 的起伏形成 bevel / emboss斜角/浮雕效果观感类似纹理玻璃。文档建议与 [Steps]、[DetectEdges]、[FakeLight] 等效果类比也可与 Displace 对照理解。输入参数名称类型说明ImageA(Texture2D Required)基底图像必填ImageB(Texture2D Required)位移/雕刻源必填Displacement(Single)控制效果的方向与强度Center(Vector2)偏移图像 A 被图像 B 位移的方向Shading(Single)控制图像 B 的可见度 / 亮度ShadeColor(Vector4)与图像 B 相乘的颜色仅当 Shading 增大时可见输出OutputT3.Core.DataTypes.Texture2D用法提示Shading从 0 开始推高时B 的明暗起伏会逐渐浮出ShadeColor提供染色能力比如用偏蓝的 Vector4 给玻璃质感加入冷色调。想要立体感更强可提升Displacement并微调Center改变光照方向感。EdgeRepeat沿直线重复拉伸像素EdgeRepeat 沿一条直线重复拉伸输入图像的像素官方文档建议直接探索其自带预设presets并指出与 Dither抖动搭配效果好。它适合制作无限延伸的地面、条纹扫掠或边缘拉伸的抽象视觉。输入参数名称类型说明Image(Texture2D Required)输入图像必填Fill(Vector4)填充颜色Background(Vector4)背景颜色LineColor(Vector4)线条颜色Center(Vector2)拉伸中心Width(Single)拉伸宽度Rotation(Single)线条/拉伸方向旋转LineThickness(Single)线条粗细Resolution(Int2)输出分辨率输出TextureOutputT3.Core.DataTypes.Texture2D从参数组合看LineColor与LineThickness负责定义那条拉伸轴的可视化WidthRotation决定拉伸作用的范围与方向Fill/Background处理边界外的区域方便与合成背景无缝衔接。FieldToImage把 ShaderGraph 字段渲染成图像FieldToImage 接收一个 ShaderGraph 节点Field并将其渲染为一张纹理是场 → 图像的桥梁算子常用于把程序化噪声场、SDF 场转为可被其他图像算子继续处理的 2D 贴图。输入参数名称类型说明Field(ShaderGraphNode)输入的着色器图节点Center(Vector2)中心位置SliceDepth(Single)切片深度Scale(Single)缩放Rotate(Single)旋转Mode(Int32)渲染模式Range(Vector2)值域范围GainAndBias(Vector2)增益与偏置PingPong(Boolean)是否乒乓往返Repeat(Boolean)是否平铺重复Gradient(Gradient)伪彩色渐变映射Resolution(Int2)输出分辨率OutputFormat(Format)输出格式GenerateMips(Boolean)是否生成 Mip 贴图输出TextureOutputT3.Core.DataTypes.Texture2D实践方向Gradient用于把场的数值映射为伪彩色RangeGainAndBias负责把场值裁剪/搬移到理想区间PingPong/Repeat则控制场在空间上的循环方式。渲染出的纹理可继续喂给 Displace 等算子作位移贴图形成程序化场 → 变形的完整链路。KochKaleidoskope科赫雪花分形万花筒KochKaleidoskope 基于科赫雪花Koch snowflake分形曲线构造万花筒效果文档特别注明Angle参数在 Steps 大于等于 2 时才开始生效。需要更简单版本时可参考 [MirrorRepeat] 或 [TransformImage]感兴趣的组合还有 [MosaicTiling]、[VoronoiCells]、[SubdivisionStretch]。输入参数名称类型说明Image(Texture2D)输入图像Offset(Vector2)图案偏移Angle(Single)旋转角Steps ≥ 2 时生效Steps(Int32)分形迭代步数Rotate(Single)整体旋转Scale(Single)缩放Center(Vector2)万花筒中心ShadeSteps(Single)分形台阶着色量ShadeFolds(Single)折叠处着色量Resolution(Int2)输出分辨率输出TextureOutputT3.Core.DataTypes.Texture2D使用建议从Steps 1起步理解结构再逐步上调以增加分形复杂度Angle在 Steps≥2 时才参与计算因此调整角度前务必确认 Steps 满足条件ShadeSteps/ShadeFolds可给各折叠面加入立体明暗让分形不再平。PolarCoordinates圆与直角坐标的互相转换PolarCoordinates 执行极坐标变换在圆形坐标与直角坐标之间转换——即包裹/展开圆形图像wrap and unwrap round images。文档推荐与 [Equirectangle]、ConvertEquirectangle 对照使用是制作 360° 环境贴图展开、环形扭曲与万花筒底盘的核心算子。输入参数名称类型说明Image(Texture2D Required)输入图像必填Center(Vector2)极坐标原点默认 (0, 0)Radius(Single)半径默认 1.0RadialBias(Single)径向偏置RadialOffset(Single)径向偏移默认 0Twist(Single)角度扭转默认 0Stretch(Vector2)双向拉伸默认 (1, 1)Resolution(Int2)输出分辨率Mode(Int32)转换方向输出TextureOutputT3.Core.DataTypes.Texture2D模式枚举源码实证从 PolarCoordinates.cs 可以看到Mode由Modes枚举映射MappedType typeof(Modes)仅有两个取值private enum Modes { Cartesian2Polar, // 直角坐标 → 极坐标wrap把方形图像卷成圆 Polar2Cartesian, // 极坐标 → 直角坐标unwrap把圆展开成方形 }这两个模式对应文档所说的wraps and unwraps round images。Center决定极点位置Radius决定展开的圆周范围Twist制造螺旋形偏转Stretch则独立压缩/拉伸径向与角度轴——组合使用即可完成从星球表面卷曲到环状纹理展开的各类视觉。TimeDisplace基于历史缓冲的时间维度位移TimeDisplace 是家族中最特别的一员它维护一个纹理数组历史缓冲texture array history buffer用 DisplaceMap 在时间维度上对历史帧做位移从而产生随时间的流动与拖影。其参数表与 Displace 高度一致但语义从空间位移扩展为时间位移。输入参数名称类型说明Image(Texture2D Required)输入图像必填DisplaceMap(Texture2D Required)位移贴图必填DisplaceMode(Int32)位移模式Displacement(Single)位移强度DisplacementOffset(Single)位移偏置Twist(Single)扭转量Shade(Single)使效果变暗SampleRadius(Single)采样半径DisplaceMapOffset(Vector2)位移贴图偏移WrapMode(TextureAddressMode)边缘重复方式GenerateMips(Boolean)是否生成 Mip 贴图RGSS_4xAA(Boolean)4x 旋转网格超采样抗锯齿TextureFiltering(Filter)纹理过滤方式输出OutputT3.Core.DataTypes.Texture2D实现机制上纹理数组的每一层保存一帧历史位移场决定从哪一层历史帧采样因此Displacement越大、回溯越深拖影越长Shade让历史帧变暗可做出淡出残影的轨迹感。它非常适合粒子流、液体流动、运动残影等强调时间感的视觉。组合实战一条典型的变形 PostFX 链路综合以上算子可以在 TiXL 中搭建一条实时变形效果链例如准备位移场用 FieldToImage 把噪声 ShaderGraph 渲染成DisplaceMap配合 Gradient 与 Range 调好对比度空间变形将场景画面与位移场接入 Displace调节Displacement与Twist制造水面扭曲时间扰动如需动态涟漪改用 TimeDisplace让位移随时间在历史缓冲中流动镜头质感链路末端接 ChromaticDistortion用SizeDistort增加镜头色散DistortOffset修正边缘伪影局部强调对画面局部用 BubbleZoom 放大主体用FeatherGradient控制过渡柔和度。每个算子的输出都是标准Texture2D槽可无缝串接也可用Resolution统一各环节的输出尺寸以控制性能。延伸阅读与源码索引算子总览README.md单个算子文档BubbleZoom、ChromaticDistortion、Displace、DistortAndShade、EdgeRepeat、FieldToImage、KochKaleidoskope、PolarCoordinates、TimeDisplaceC# 插槽定义与枚举参见 Operators/Lib/Symbols/image/fx/distort/ 下同名.cs文件例如 PolarCoordinates.cs 中的Modes枚举、BubbleZoom.cs 的输入输出声明默认配置值同名.t3文件例如 BubbleZoom.t3Radius0.5、PolarCoordinates.t3Center(0,0)、Radius1.0、Stretch(1,1)相关参考ConvertEquirectangle极坐标/环境展开方向、image/fx 效果总览说明上述算子文档由操作符库自动生成Auto-generated from the operator library个别算子的参数注释尚未填充完整对无描述的参数可结合同族算子的语义与.t3默认值推断并在 TiXL 编辑器中直接调节参数观察实时效果。赞分享音视频图形学桌面应用【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址https://gitcode.com/GitHub_Trending/t3/t3点击查看免费下载相关推荐TiXL 图像生成算子库 Lib.image.generate 完全指南TiXL 图像生成算子库 Lib.image.generate 完全指南 TiXL 是一套用于创建实时动态图形的开源软件其内置算子库中 Lib.image.音视频图形学桌面应用TiXL 图像特效算子库 Lib.image.fx 完全指南从模糊反馈到故障艺术TiXL 图像特效算子库 Lib.image.fx 完全指南从模糊反馈到故障艺术 本篇技术指南聚焦 TiXL开源实时动态图形创作工具中 Lib.image音视频图形学桌面应用TiXL ReflectField 算子完全指南基于平面折叠与镜像的 SDF 场空间变换TiXL ReflectField 算子完全指南基于平面折叠与镜像的 SDF 场空间变换 导读 ReflectField 是 TiXLLib.field.s音视频图形学桌面应用创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考