图像编辑

创作者: candidus42
已更新:2022-09-15 17:24:01
20KB

关于此 MOD

提供非交互式图像重新着色功能。需要ContentPatcher支持。
提供令牌ImageEd/Recolor,该令牌接收一张需要重新着色的图像,并可选择性地接收一个遮罩和去色模式。ContentPatcher加载的最终图像按以下方式创建:

  • 源图像已加载,无论是来自内容包还是游戏内容。
  • 使用给定的掩码从源图像中提取子图像。若未提供掩码,则创建副本。
  • 提取的子图像可根据给定的模式(HSV、HSL、HSI或亮度模式)进行选择性去饱和度处理(参见 HSL与HSV 有关算法的详细信息)。
  • 去饱和后的图像与指定颜色相乘。
  • 结果已写入磁盘,以便ContentPatcher可以加载它。

ImagEd/Recolor最多接受8个参数:

  • 使用重新着色功能的内容包。这通常是包含当前config.json文件的内容包,但由于自定义内容包令牌不包含该信息,因此我们必须提供它。
  • 资产名称。
  • 源图像或“游戏内容”用于加载原版资源。
  • 遮罩图像或“无”。遮罩应为灰度图像,因此我们始终会对其进行去色处理(模式为亮度去色)。
  • 混合颜色采用 #RRGGBB 格式([十六进制三元组](https://zh.wikipedia.org/wiki/网页颜色#十六进制三元组))。同时支持非标准格式 #RRGGBBAA 以设置透明度值。
  • 去饱和度模式:HSV去饱和度、HSL去饱和度、HSI去饱和度、亮度去饱和度或无。此为可选参数,默认值为无。
  • 翻转模式:水平翻转、垂直翻转、双向翻转或无翻转。此为可选参数,默认值为无翻转。 注意:此功能在多数情况下并不实用,尤其不适用于NPC角色。翻转操作将作用于整张图像,因此若翻转精灵图集,会导致后续所有精灵索引错乱。另请注意,翻转后的图像始终由基础图像与叠加层组合而成,因为单独翻转叠加层而不处理基础图像并无意义。尽管如此,巧妙运用翻转功能仍可实现炫酷效果。特此提醒 :-)
  • 亮度:一个浮点数值,在颜色混合前将与提取的图像相乘。使用大于1.0的值可使图像变亮。此为可选参数,默认值为1.0。

源代码与示例 GitHub

对于实际使用此功能的模组,请参阅 随机花后

使用 Xmod 解锁 星露谷物语 的全部潜力 — 今天就探索这些顶级 MOD!