用途:在 Unity 项目中搭建、诊断并修复基于 PixelPerfectCamera 的 2D 像素完美渲染,适用于复古风或像素画 2D 游戏出现画面模糊、瓦片缝隙、非整数缩放等问题时。
主要能力:区分并适配两套互不兼容的实现——URP 使用 UnityEngine.Rendering.Universal.PixelPerfectCamera(内置于 URP,无需额外安装),Built-in 使用 UnityEngine.U2D.PixelPerfectCamera(需 com.unity.2d.pixel-perfect v6.0.0+)。提供管线检测、精灵导入设置检查与修复、相机配置、编辑器吸附设置、API 参考、迁移与兼容处理,以及常见问题排查(模糊精灵、瓦片缝隙、Cinemachine 冲突、后处理模糊、UI 文字模糊、物理与渲染不同步、非整数缩放、缺失 URP 2D Renderer、HDRP 回退)。
使用方式:先调用 DetectPipeline()(见 references/pipeline-detection.cs)判断渲染管线,再按结果分支处理。诊断优先,先报告发现再修复。默认作用于场景范围,仅在用户明确要求时全项目扫描。关键修复包括:精灵 Filter Mode 设为 Point、禁用 Mip Maps、关闭抗锯齿;相机使用正交投影并配置正确的 Pixel Perfect Camera 组件。
限制:不适用于 HD 2D 或高分辨率 2D 游戏、纯 UI 场景(应使用 Canvas Scaler)以及 HDRP 项目(不支持 Pixel Perfect Camera)。不要在 URP 项目中安装 com.unity.2d.pixel-perfect。参考分辨率需在制作资产前确定,之后不应更改。部分问题(如 Target Group + Framing Transposer 卡顿、upscaleRT 下 UI 文字模糊)为已知限制或无官方修复。