createFromNamedImage
Creates a new NativeImage
instance from the NSImage
that maps to the given image name. See Apple's NSImageName
documentation for a list of possible values.
The hslShift
is applied to the image with the following rules:
hsl_shift[0]
(hue): The absolute hue value for the image - 0 and 1 map to 0 and 360 on the hue color wheel (red).hsl_shift[1]
(saturation): A saturation shift for the image, with the following key values: 0 = remove all color. 0.5 = leave unchanged. 1 = fully saturate the image.hsl_shift[2]
(lightness): A lightness shift for the image, with the following key values: 0 = remove all lightness (make all pixels black). 0.5 = leave unchanged. 1 = full lightness (make all pixels white).
This means that [-1, 0, 1]
will make the image completely white and [-1, 1, 0]
will make the image completely black.
In some cases, the NSImageName
doesn't match its string representation; one example of this is NSFolderImageName
, whose string representation would actually be NSFolder
. Therefore, you'll need to determine the correct string representation for your image before passing it in. This can be done with the following:
where SYSTEM_IMAGE_NAME
should be replaced with any value from this list.