Color scripts modified by Jordan Bunke

Jordan Bunke — Tue, 13 Aug 2024 17:33:50 -0000

--- v1
+++ v2
@@ -1,15 +1,18 @@
 [`< back`](Scripting)

 ### Overview
-TODO
+Color scripts are used to defined custom color action behaviour. Examples of color actions in _Stipple Effect_ are HSV level shifting and palettization. These target a scope of the project, whether it be a layer, the selection, a frame, the layer-frame, or the entire project, and then apply a transformation to the colors of the pixels in the targeted scope. Executing a color script is a more generalized framework of this behaviour, whereby users can programmatically specify the input to output color mapping.

 Example:

     :::js
     (~ color c -> color) {
-        // TODO - greyscale
+        ~ int total = c.r + c.g + c.b;
+        ~ int avg = total / 3;
+    
+        return rgb(avg, avg, avg, c.a);
     }
-Explanation: TODO
+This script takes the input color `c` and returns a shade of grey (or black or white in extreme cases) with the same lightness as `c`.

 ### Contract

Color scripts modified by Jordan Bunke

Jordan Bunke — Tue, 13 Aug 2024 17:33:50 -0000

< back

Overview

TODO

Example:

(~ color c -> color) {
    // TODO - greyscale
}

Explanation: TODO

Contract

Color scripts must have take a single color parameter^{a, b} and return a color. Thus, the head function of a color script should be of the following form^c:

(color c -> color) {
    // contents here...
}

^a - The parameter name c is just used as an example.

^b - The parameter represented by c can optionally be declared as immutable by prepending final or ~ to the declaration. For example:

(~ color c -> color) { /* contents here... */ }

^c - Color scripts do not have to have complex function bodies { ... }. For example, the following preview script is valid:

(color c -> color) -> rgb(c.r, 0, c.b / 2)

Color script examples

Recent changes to Color scripts

Color scripts modified by Jordan Bunke

Color scripts modified by Jordan Bunke

Overview

Contract

More