
预HUD摄像机
以摄影师的视角体验夜之城。动态景深、真实世界镜头预设以及可选随身摄像头、镜头污渍与镜头抖动——全部在HUD之前渲染,以保持界面清晰。通过直观的游戏内面板微调你的视觉效果,支持超宽屏。无需ReShade。
查看大图PreHUD Camera v0.5.1
动态景深与受相机启发的效果,在 HUD 绘制之前应用。
让夜之城呈现相机影像的质感,同时保持 HUD 清晰可读。PreHUD Camera 在 HUD 绘制通道之前对游戏场景应用处理,并附带一个游戏内英文控制面板用于实时调整。
从细腻的自动对焦和柔和的背景分离开始,为驾驶选择一个受保护的径向中心,或用可选的镜头、光照、色彩和运动效果构建更具风格化的画面。每项设置都有自己的 Reset 按钮和 (?) 悬停说明。每个标签页也有 Reset tab,与默认值不同的数值会显示 [modified]。标签页标签会统计已更改的数值数量,包括隐藏设置。
v0.5.1 是实验性测试版。 原生插件和着色器已通过编译和自动化逻辑检查。v0.5.1 在所有硬件、HDR、光线追踪/路径追踪和帧生成配置下的完整游戏内验证仍待进行。较早版本曾收到玩法反馈;这并不代表 v0.5.1 的每项功能都兼容。
v0.5.1 更新: 新增了按标签页重置、默认值变更指示器和活动快捷操作标记。修复了 Shake 激活及其他下拉选项因 CET 选中状态处理而回退的问题。原生渲染器与 v0.5 相比没有变化。
功能
- 基于深度的动态 DOF,支持自动对焦、手动对焦、焦点锁定和平滑焦点适应。
- 光圈、焦距和传感器宽度控制,以及在可获取深度时对近处物体和武器的近场模糊。
- 可选的径向模糊,具有干净的中心和视觉上柔和的过渡,与场景深度无关。
- 受保护对焦区域之外的武器变焦色差,带开/关开关。
- 镜头目录,包含通用预设、Nikon NIKKOR Z 和 Canon RF 光学参数,以及 RED V-RAPTOR VV 传感器格式组合。
- 散景控制:圆形/多边形形状、旋转、变形宽银幕比例、猫眼塑形和高光强调。
- 可选的焦点呼吸和焦点搜寻。
- 随身摄像头风格、独立的镜头畸变和程序化脏镜头灰尘/污迹。
- 泛光、光晕、镜头光斑鬼影和薄雾眩光。
- 曝光补偿、可选自动曝光和光圈联动曝光。
- 温度/色调控制、可选自动白平衡和艺术图像配置文件。
- 抖动镜头,支持 Random、Walking、Driving 和 Adaptive 激活方式;实验性滚动快门式倾斜。
- 超宽屏修复复选框、总旁路、单项设置重置和上下文帮助。
全新安装时,可选的相机瑕疵默认禁用。升级时会保留已有的可识别设置。
前置需求
- Cyberpunk 2077 PC,补丁 2.50 / 2.5 — 此安装包面向该构建版本。其他补丁不受此版本支持。
- RED4ext — 面向目标游戏构建版本的 v1.31.0。
- REDGraph — 适用于补丁 2.50 的 v0.4.2。REDGraph 0.4.1 适用于补丁 2.31。
- Cyber Engine Tweaks (CET) — 明确支持补丁 2.50 的版本。完整受支持配置需要它,包括 UI 和玩法遥测。
- 支持 Shader Model 6.0 的 DirectX 12 GPU 和驱动。
- 安装 RED4ext 和 CET 指定的运行时前置组件,包括这些框架所需的 Microsoft x64 Visual C++ Redistributable。
不需要 ReShade。 此模组不需要 ClearFrame、redscript、ArchiveXL、TweakXL、Codeware、Native Settings UI 或 REDmod。框架必须从各自作者处单独下载;此处不捆绑它们的运行时包。
安装
- 关闭游戏。
- 按照各自的安装说明安装上述必需框架。
- 如果你之前安装过原始的 ClearFrame bridge,请删除其 REDGraphReShadeBridge.dll 和 ClearFrame.reds。请保留备份,不要删除无关的 ReShade 文件或你仍在使用的着色器。
- 将此模组的 bin 和 red4ext 文件夹解压到 Cyberpunk 2077 安装文件夹中,合并文件夹并允许替换此模组的文件。这是包含 bin 的游戏根目录,而不是 bin/x64 本身。
- 启动游戏。如果 CET 是新安装的,请完成其首次启动的覆盖层按键设置。
- 打开 CET 覆盖层,找到 PreHUD Camera | v0.5.1。你也可以在 CET Bindings 中分配 PreHUD Camera - Show control panel。
安装后检查以下文件是否存在:
Cyberpunk 2077/red4ext/plugins/PreHUD_DOF/PreHUD_DOF.dll
Cyberpunk 2077/bin/x64/plugins/cyber_engine_tweaks/mods/PreHUD_DOF/init.lua
文件夹名称仍为 PreHUD_DOF,以兼容较早版本。仅安装 DLL 不会安装控制面板。
快速开始
- 启用 Camera processing 和 DOF。
- 在 Quick 中,选择 Everyday / 35 mm f/2.8 或 Natural / 35 mm f/4 作为起点。
- 选择 Depth-based focus 进行深度驱动的自动对焦,或选择 Driving / protected center 获得无论物体距离如何都保持中心干净的径向模糊。
- 如需更轻的效果,降低 Overall DOF strength 和 Maximum blur radius。在光学模式下,更高的光圈 f 值也会减少深度模糊。
- 如果你使用超宽屏显示器,请启用 Ultrawide fix。对于常规显示器,请保持关闭,除非你确实需要其校正。
- 逐一启用可选效果。将鼠标悬停在 (?) 上以了解控件,使用其 Reset 按钮仅恢复该项数值。
更改会实时应用并自动保存。也可使用 Save / Apply。
Reset tab 恢复当前标签页拥有的所有设置,包括隐藏控件,而不重置其他标签页。Quick 拥有 Camera processing 和 Ultrawide;Focus 拥有 DOF enable。快捷操作按钮是其他标签页设置的快捷方式,因此 Quick 中的 Reset tab 不会撤销这些跨标签页操作。当快捷操作的配置匹配时,会显示 [active]。
Clean image 禁用可选的相机瑕疵,同时保留你的 DOF 配置。Subtle character 应用随身摄像头风格、辉光和电影风格色调肩部的克制组合。
控制面板指南
Quick 主控制、镜头选择和起始配置。Camera processing 会旁路整个模组的渲染。F8 仅切换 DOF;它不会禁用其他相机效果。
Focus 调整模糊强度、最大半径、自动对焦和焦点。默认焦点为屏幕中心;如果你的准星偏移,请手动对齐。更大的 AF 采样半径会改变自动对焦测量的区域;它与受保护的径向中心不同。关闭自动对焦以显示手动对焦距离。焦点锁定会保持对焦距离。对焦速度控制随时间的适应;羽化/模糊控制决定图像上的视觉过渡。
在径向模式下,radius 控制干净的中心,feather 控制其周围的柔和过渡。此模式有意忽略场景深度,当你希望在驾驶时保持中心可读时很有用。
Optics 选择目录镜头或调整光圈、焦距和传感器宽度。较低 f 值和较长焦距通常会在光学模型中增加深度分离。预设会改变 DOF 模型,而不是游戏 FOV 或透视。散景、呼吸和搜寻控制增加可选特性;请从克制的数值开始。
Lens 配置色差、随身摄像头风格、畸变和污渍。色差仅在检测到放大武器瞄准时激活。普通未放大瞄准和扫描仪缩放不会激活它。在径向模式下,CA 共享受保护的圆形区域;在深度模式下,它也会保护合焦深度表面。随身摄像头风格和抖动镜头是独立选项。
Light 控制泛光/光晕、光斑/眩光和曝光。曝光补偿会提亮或压暗渲染图像。自动曝光和光圈联动曝光为可选,可能会与游戏自身的适应叠加。
Color 调整温度和色调,可选启用自动白平衡,并选择艺术图像配置文件。自动白平衡可能会中和有意的霓虹灯光。配置文件是艺术变换,不是实测的 Nikon、Canon 或 RED 色彩科学。
Motion 启用抖动镜头并选择其激活模式。Walking/Driving/Adaptive 模式依赖实时 CET 玩法遥测。Random 模式提供合成运动。滚动快门会添加实验性的按行依赖图像倾斜。这些效果会变换渲染图像;它们不会移动玩法相机。
Diagnostics 检查渲染器和遥测状态。深度校准会影响估计距离;除非排查特定深度问题,否则请保持默认值。缺失或过期的玩法遥测会禁用依赖遥测的激活方式。
设置、更新和移除
用户设置会创建在此处:
bin/x64/plugins/cyber_engine_tweaks/mods/PreHUD_DOF/camera.ini
下载包有意不包含活动的 camera.ini。更新模组会保留可识别设置,并为新控件添加默认值。camera.defaults.ini 是参考文件。runtime.ini 和 status.ini 是生成的通信文件,不是用户预设。
要升级,请关闭游戏并替换包文件。如果你想保留个人预设,请备份 camera.ini。要完全重置设置,请关闭游戏,备份并移除 camera.ini,然后重新启动。
要卸载,请关闭游戏并仅移除:
red4ext/plugins/PreHUD_DOF
bin/x64/plugins/cyber_engine_tweaks/mods/PreHUD_DOF
如果其他模组需要共享框架,请保留它们。PreHUD Camera 不会修改存档文件。
兼容性和已知限制
- 首次对比时请禁用其他 DOF 效果。ReShade 和其他相机/色彩效果可与此模组叠加,包括在管线后期应用时叠加到 HUD 上。
- 这是屏幕空间相机效果实现,不是完整的物理镜头或原始传感器模拟器。深度边缘、前景遮挡和散景可能出现伪影。
- 近处武器模糊取决于武器在所选缓冲区中是否具有可用深度。它无法重建缺失的武器深度。
- 镜头预设使用公开的焦距/光圈和传感器宽度假设。它们不会复现镜头镀膜、实测光学特征或厂商 LUT。
- 抖动镜头、焦点呼吸和滚动快门是图像变换。滚动快门不使用逐物体运动向量。
- 污渍是程序化的;光斑和辉光响应图像高光,而非几何感知的光线追踪。曝光/色彩处理无法恢复已经剪切的高光。
- HDR、RT/PT、DLSS 和帧生成组合需要进一步的游戏内测试。不声称通用兼容性或固定 FPS 开销。开销取决于分辨率和启用的效果。
- 反复更改分辨率或渲染格式后,请重启游戏。此原型保留有限数量的渲染分配,并在八次资源代际后停止绘制,直到重启。
故障排查和错误报告
控制面板缺失 确认 CET 正常工作,且 init.lua 安装在上方路径。打开 CET 覆盖层,检查其 Game Log 是否有 Lua 错误,并确认你安装的是 v0.5.1 而不是较旧的存档。REDGraph 中的客户端条目确认的是原生插件,而不是 Lua 面板。
面板出现但没有效果 检查 Camera processing、DOF 和强度,然后尝试一个明显的模糊设置。确认渲染器已就绪且 REDGraph 是适用于该游戏的正确版本。不受支持或不可用的场景/深度源可能导致渲染被跳过。
模糊或色彩过强 使用 Clean image,降低 DOF 强度/半径,并在禁用其他 DOF/色彩模组的情况下进行比较。增大光圈 f 值以获得更轻的光学深度模糊。如果自动曝光/自动白平衡与游戏光照冲突,请禁用它们。
CA 或运动效果不激活 检查 Diagnostics。CA 需要检测到放大武器瞄准。运动模式需要有效的玩家/载具遥测。缺失遥测会有意使这些激活模式保持不激活。
崩溃或渲染问题 报告游戏补丁、PreHUD 版本、框架版本、GPU/驱动、分辨率/宽高比、HDR 状态、RT/PT 设置、超分辨率/帧生成以及其他渲染模组。包括复现步骤、有用的截图/视频、red4ext/logs 中最新的 RED4ext/REDGraph 日志,以及相关 CET 日志错误。请在问题发生后立即复制日志,以免下一次启动替换它们。
致谢和第三方代码
- dimkatet 和 REDGraph 贡献者 — REDGraph,其公开宿主 API/头文件以及用于 HUD 前集成的参考场景/深度标识符。包含的 SDK 头文件是 MIT 许可证下的第三方代码。
- Octavian Dima / WopsS 和 RED4ext 贡献者 — RED4ext.SDK 头文件,用于加载器元数据/ABI 集成,以及玩法状态的参考信息。包含的 SDK 头文件采用 MIT 许可证。RED4ext 提供插件加载。
- yamashi 和 Cyber Engine Tweaks 贡献者 — Cyber Engine Tweaks,提供设置面板和遥测所使用的 Lua 环境、覆盖层和暴露的游戏 API。
- jackhumbert — Let There Be Flight CET 状态查询示例,参考了只读的载具挂载/玩家位置 API 用法。其模组实现未捆绑。
- Microsoft 和 DirectX Shader Compiler 贡献者 — DXC,用于编译和验证嵌入的着色器字节码。编译器运行时未捆绑。
- Nikon、Canon 和 RED — 公开的产品规格用作光学预设的参考;单独链接包含在 SOURCES.md 中。产品名称仅标识这些参考,不暗示隶属关系或背书。
下载包包含源代码、参考资料和原始第三方许可证声明,位于 source/vendor/REDGraph-LICENSE 和 source/vendor/RED4ext-LICENSE。在再分发相应第三方材料时请保留这些声明。致谢不能替代许可证声明。
PreHUD Camera 是独立实现。它不捆绑 ClearFrame bridge DLL 或第三方 ReShade DOF 着色器。
此模组使用 GPT 进行 vibe-coding。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。