aibis-dream/Docs/MemoryProcessSpriteShaderNotes.md

MemoryProcess Sprite Shader Notes

本文记录 FixSystem/Memory 记忆调频表现的结构与维护边界。该系统属于旧版 FixSystem，但仍承载佩佩修复场景里的记忆播放、打孔带检索和双滑杆调频表现。

相关文件

• Assets/Scripts/FixSystem/Memory/MemoryProcess.cs
• Assets/Scripts/FixSystem/Memory/MemorySlider.cs
• Assets/Shader/Shader/MemoryTuningSprite.shader
• 历史 VolFx profile 参考位于 Assets/Scenes/VFXtest/

当前结构

记忆图像由两层 SpriteRenderer 叠加：

• memoryFinishedSpriteRenderer：彩色记忆层。
• memoryFinishedImageNoColor：无色底图层。

旧版表现主要依赖 VolFx 后处理。现在调频阶段默认由 AibisDream/MemoryTuningSprite 在 sprite 材质上完成。运行时会为两层分别创建材质实例，并把同一组调频参数同步写入两层，避免只扰动彩色层时露出或错开无色底图。

memoryFinishedImageNoColor 使用同一个 shader，但通过材质参数保留无色底图观感：

• _MemoryGrayscale = 1
• _MemoryContrast = 1.8

彩色层保持：

• _MemoryGrayscale = 0
• _MemoryContrast = 1

调频语义

MemorySlider 输出的是距离目标值的归一化偏差：

• 越接近目标区间，传出的值越接近 0。
• 越远离目标区间，传出的值越接近 1。

因此 shader 表现应遵循“远离目标时混乱，靠近目标时清晰稳定”的方向。

目前两个轴的职责是：

• 频率轴：像素化、颗粒化、焦糊感。
• 清晰度轴：色散、轻微相位错位、弱 UV 扭曲。

后续如果要增强反馈，优先保持两个轴的视觉语义差异，不要让两个轴都只表现为普通模糊。

后处理迁移边界

旧 VolFx profile 可以作为视觉参考，但不要直接照搬参数到 sprite shader。原因是后处理作用于最终合成画面，而 sprite shader 只作用于单个 sprite 层。尤其是 UV 扭曲：

• 后处理中的强扭曲通常不会暴露底层。
• sprite 层上的强扭曲会撕开当前层边缘，露出下面的 nocolor 层或背景。

因此 sprite shader 中的扭曲应保持较弱，并在 UV 边缘做衰减。

旧 VolFx 参考

调频滑杆的历史 profile：

• Assets/Scenes/VFXtest/记忆像素滑块.asset
  • PixelationVol
  • BlurVol
• Assets/Scenes/VFXtest/记忆清晰度滑块.asset
  • ChromaticVol
  • DistortVol

加载与屏幕类历史 profile：

• Assets/Scenes/VFXtest/花屏.asset
  • 用于放入记忆卡带后的加载花屏。
  • 不属于双滑杆调频效果。
• Assets/Scenes/VFXtest/记忆屏幕.asset
  • 曾用于 mainEffect 的默认记忆屏幕后处理。

这些 profile 的用途不同，迁移或复刻时需要先确认当前目标是“调频反馈”、“卡带加载过场”，还是“进入记忆界面的默认屏幕质感”。

Volume 字段现状

MemoryProcess 中仍保留若干 Volume 字段：

• memoryClarityVolume
• memoryFrequencyVolume
• memoryProcessVolume
• mainEffect

当 useSpriteShaderTuning = true 时，memoryClarityVolume 与 memoryFrequencyVolume 不再驱动调频表现，只作为后处理模式的兼容入口。

memoryProcessVolume 仍可用于放入记忆卡带后的加载花屏，并已做空引用安全处理。

mainEffect 曾指向默认记忆屏幕后处理。如果未来要恢复或迁移它，需要先明确是否要作为常驻屏幕质感，而不是误接到卡带加载流程中。

常见问题

sprite 变紫

优先检查 MemoryTuningSprite.shader 编译错误。Unity 的紫色材质通常表示 shader 编译失败或材质 shader 丢失。

如果 Unity Console 不方便读取，可以查看：

%LOCALAPPDATA%\Unity\Editor\Editor.log

曾经出现过的坑：

• HLSL 局部变量命名为 line 会触发 syntax error: unexpected token 'line'。
• 与 Unity/URP include 中的函数名冲突也可能导致编译失败，工具函数建议使用项目专属前缀。

nocolor 层露出

通常是彩色层和无色层没有同步应用同一套采样扰动，或 UV 扭曲太强。检查：

• 两层是否都使用运行时材质。
• 调频参数是否同步写入两层。
• 扭曲是否有边缘衰减。

调频差异不明显

优先调整 shader 内响应曲线，而不是恢复 VolFx 后处理。可以从以下方向处理：

• 频率轴加强像素密度、模糊半径或响应曲线。
• 清晰度轴加强色散方向、相位错位或轻微漂移。
• 避免把两个轴都调成类似的模糊/噪声效果。

维护建议

• 手动编辑 shader 后，及时检查 Unity Console 或 Editor.log。
• 不要把后处理参数机械映射到 sprite shader。
• 涉及两层记忆图像时，优先考虑两层同步。
• 如果要迁移新的后处理效果，先确认它属于调频、加载过场还是默认屏幕氛围。