红色图像获取器

- 引言 -

赛博朋克的墨水UI只能绘制存在于游戏档案中的纹理——这意味着模组UI一直无法显示来自互联网的图像。我的Redscript配置框架能在游戏内将整个Nexus模组页面渲染为文档，而那些页面满是

[img]

那些过去只能沦为可悲的小占位标签的标签。这件事困扰我超过了应有的程度，于是我一路追查了下去。

RedIMGRetriever 便是成果：一个 RED4ext 插件，它能下载图片（PNG、JPG 或 WebP，仅限 https），实时将其转换为游戏自身的纹理格式，将其封装进运行时归档并挂载——此时任何 ink 控件都能像绘制游戏自带资源一样绘制它。下载内容会缓存到磁盘，因此每张图片只会获取一次。

简而言之——互联网的图片，由游戏自己的界面绘制而成！(ﾉ◕ヮ◕)ﾉ


- 玩家 -

没什么可配置的。把它安装在旁边 红脚本配置框架 2.0.0+ 游戏内WIKI页面开始正确显示图片，尺寸恰当，正好出现在模组作者放置的位置。失效链接和网络波动会优雅降级，回退到旧的占位标签。

图像缓存于

r6\storages\RedIMGRetriever

随时可以删除该文件夹以回收空间，它只会在需要时重新生成。


- 模组作者 -

该插件暴露了一个小型轮询驱动的原生 API——启动获取，轮询直到图集路径到达，然后将其绑定到任意 inkImage：

import RedIMGRetriever.*

// 在 UI 刷新/轮询中：
let atlas: String = RedIMG.PrepareDocImage(url);
如果 !Equals(atlas, "") {
  img.SetAtlasResource(ResRef.FromString(atlas));
  img.SetTexturePart(n"full");
  // 根据图像的真实宽高比调整控件大小：
  让 w: Float = RedIMG.GetDocUvWidth(url); // 分数，较大的一侧 = 1.0
  let h: Float = RedIMG.GetDocUvHeight(url);
} 否则如果 RedIMG.IsDocFailed(url) {
  网络连接异常或链接失效，停止轮询，显示占位内容
}

完整表面：

RedIMG.PrepareDocImage(url) -> String // 挂载后的图集仓库路径，处理中/失败时为空字符串
RedIMG.GetDocUvWidth(url) -> Float // 图像宽高比，较大边 = 1.0
RedIMG.GetDocUvHeight(url) -> 浮点数
RedIMG.IsDocFailed(url) -> Bool // 永久失败 - 停止轮询
RedIMG.IsAvailable() -> Bool // DLL是否已加载
RedIMG.Log(message) // 记录到 red4ext\logs\RedIMGRetriever-*.log
RedIMG.ClearCache() // 清除磁盘上的下载缓存

获取、解码和归档构建都在工作线程上运行；PrepareDocImage 从不阻塞游戏。图像每条轴的上限为 2048 像素。 仅限HTTPS，设计如此.


- 更新 -

0.2.0 - 首次公开发布。支持通过 HTTPS 加载 PNG、JPG 和 WebP，磁盘缓存，运行时挂载归档，宽高比原生支持。正在研究支持动态 GIF。


- 要求 -

此模组需要你安装以下内容：
RED4ext
红脚本

可选（但其存在的原因）：
红脚本配置框架 - v2.0.0+（游戏内百科图片）


- 安装 -

1) 安装所有依赖项。
2) 将下载的文件解压到游戏主目录中。


- 卸载 -

删除目录 \Cyberpunk 2077\red4ext\plugins\RedIMGRetriever
删除目录 \Cyberpunk 2077\r6\scripts\RedIMGRetriever
删除目录 \Cyberpunk 2077\r6\storages\RedIMGRetriever（图像缓存）

你的存档中没有内置任何信息，因此随时可以安全删除。


- 制作人员 -

感谢RED4ext和redscript社区提供的工具与文档，以及WolvenKit项目对游戏文件格式的解析。