home
Stardew Valley
Terms of Service | Privacy Policy
Copyright © 2024 Robin Scott. All rights reserved.
0 of 0

File information

Last updated

Original upload

Created by

Candidus42

Uploaded by

candidus42

Virus scan

Safe to use

Tags for this mod

Tag this mod
Current section

About this mod

Provides non-interactive image recoloring. Requires ContentPatcher.

Requirements
Permissions and credits
Provides the token ImageEd/Recolor which takes an image to recolor and optionally a mask and a desaturation mode. The final image loaded by ContentPatcher is created as following:

  • The source image is loaded, either from content pack or from game content.
  • A sub image of the source image is extracted using the given mask. If no mask is given, a copy is created.
  • The extracted sub image is optionally desaturized using the given mode (HSV, HSL, HSI or Luma, see HSL_and_HSV for details on the algorithms).
  • The desaturized image is multiplied with the given color.
  • The result is written to disk so it can loaded by ContentPatcher.

ImagEd/Recolor takes up to 8 arguments:

  • Content pack that uses recoloring. This is usually the content pack that contains the current config.json but a custom CP token doesn't have that information so we must provide it.
  • Asset name.
  • Source image or "gamecontent" to load a vanilla asset.
  • Mask image or "none". Mask is supposed to be a grayscale image so we always desaturate it (mode is DesaturateLuma).
  • Blend color in #RRGGBB format ([Hex triplet](https://en.wikipedia.org/wiki/Web_colors#Hex_triplet)). The non-standard format #RRGGBBAA is supported to set an alpha value.
  • Desaturation mode: DesaturateHSV, DesaturateHSL, DesaturateHSI, DesaturateLuma or None. This is an optional argument, default is None.
  • Flip mode: FlipHorizontally, FlipVertically, FlipBoth or None. This is an optional argument, default is None. Attention: This feature is not useful in most cases, especially not for NPCs. The whole image is flipped so if you flip a sprite sheet all sprite indexes are wrong afterwards. Also keep in mind that the flipped image is always a combination of base image and overlay because flipping an overlay without its base image wouldn't make sense. Nonetheless you can do cool things with flipping. You have been warned :-)
  • Brightness: Float value that will be multiplied with the extracted image before color blending. Use a value bigger than 1.0 to brighten the image. This is an optional argument, default is 1.0.

Source code and examples on GitHub

For a mod that actually uses this, see Random Flower Queen