[orx-palette] Add ColorBrewer2, demos, update README

Author: hamoid

README.md

@@ -42,7 +42,7 @@ To make use of these extensions clone the [OPENRNDR template](https://github.com
 | [`orx-no-clear`](orx-no-clear/) | Provides the classical "draw-without-clearing-the-screen" functionality. |
 | [`orx-noise`](orx-noise/) | Randomness for every type of person: Perlin, uniform, value, simplex, fractal and many other types of noise. |
 | [`orx-obj-loader`](orx-obj-loader/) | Simple loader and saver for Wavefront .obj 3D mesh files. |
-| [`orx-palette`](orx-palette/) | Provides hundreds of color palettes. |
+| [`orx-palette`](orx-palette/) | Collections of color palettes and tools for interacting with them. |
 | [`orx-parameters`](orx-parameters/) | Provides annotations and tools for turning Kotlin properties into introspectable parameters. Used by [`orx-gui`](../orx-jvm/orx-gui/README.md) to automatically generate user interfaces. |
 | [`orx-property-watchers`](orx-property-watchers/) | Tools for setting up property watcher based pipelines |
 | [`orx-quadtree`](orx-quadtree/) | A [Quadtree](https://en.wikipedia.org/wiki/Quadtree) is a spatial partioning tree structure meant to provide fast spatial queries such as nearest points within a range. |

orx-palette/README.md

@@ -1,12 +1,44 @@
 # orx-palette
 
-Provides hundreds of color palettes.
+Collections of color palettes and tools for interacting with them.
 
-## Usage
+Find demos in the demo folder.
+
+## ColorBrewer2
+
+A collection of color palettes based on the research of Dr. Cynthia Brewer. Explore them live at [colorbrewer2.org](https://colorbrewer2.org/).
+
+Each Palette has between 3 and 11 colors.
+
+Use `colorBrewer2Palettes()` to query and obtain a list of `ColorBrewer2Palette` instances.
 
 ```kotlin
-import org.openrndr.extra.palette.PaletteStudio
+// all palettes
+val palettes = colorBrewer2Palettes()
+
+// palettes with 5 colors
+val palettes = colorBrewer2Palettes(numberOfColors = 5)
+
+// palettes of type Sequential 
+val palettes = colorBrewer2Palettes(palettetype = ColorBrewer2Type.Sequential)
+```
+
+Once we have some palettes, we can pick one and use its colors:
+
+```kotlin
+palettes.first().colors.forEachIndexed { i, color ->
+    drawer.fill = color
+    drawer.circle(drawer.bounds.center, 300.0 - i * 40.0)
+}
+```
+
+## Palette Studio
 
+A class to load palette collections from JSON files, load random palettes and sort colors. JVM only.
+
+### Usage
+
+```kotlin
 val paletteStudio = PaletteStudio(
     loadDefault = true, // Loads the first collection of palettes. [default -> true]
     sortBy = PaletteStudio.SortBy.DARKEST, // Sorts the colors by luminance. [default -> PaletteStudio.SortBy.NO_SORTING]
@@ -28,79 +60,43 @@ paletteStudio.randomPalette()
 paletteStudio.randomize()
 
 // changes the collection of palettes
-paletteStudio.changeCollection(PaletteStudio.Collections.TWO)
+paletteStudio.loadCollection(PaletteStudio.Collections.TWO)
 
 // load your own from a JSON file with a structure of Array<Array<String>>
 paletteStudio.loadExternal("data/palette-autumn.json")
 ```
 
-### Keybindings
+#### Keybindings
 
 Keybindings for getting a random palette (`l`) and randomizing (`k`) one can be set easily by declaring inside the `program`:
 ```kotlin
 val paletteStudio = PaletteStudio()
 
 extend(paletteStudio)
 ```
+<!-- __demos__ -->
+## Demos
+### DemoColorBrewer2_01
+[source code](src/jvmDemo/kotlin/DemoColorBrewer2_01.kt)
 
-## Example
+![DemoColorBrewer2_01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-palette/images/DemoColorBrewer2_01Kt.png)
 
-```kotlin
-fun main() = application {
-    configure {
-        title = "Palette"
-        width = 720
-        height = 720
-    }
-    program {
-        val colors = mutableListOf<ColorRGBa>()
-
-        fun fillColors() {
-            for (n in 0..36) {
-                when(n) {
-                    12 -> paletteStudio.changeCollection(PaletteStudio.Collections.TWO)
-                    24 -> paletteStudio.changeCollection(PaletteStudio.Collections.THREE)
-                }
-
-                val color = Random.pick(paletteStudio.colors!!)
-
-                colors.add(color)
-            }
-        }
-
-        keyboard.keyDown.listen {
-            if (it.name == "c") {
-                colors.clear()
-                fillColors()
-            }
-        }
-
-        fillColors()
-
-        extend() {
-            drawer.background(paletteStudio.background)
-
-            val size = 120.0
-            val radius = size / 2.0
-
-            for (x in 0 until 6) {
-                for (y in 0 until 6) {
-                    val index = x + y * 6
-                    val color = colors[index]
-                    val x = size * x
-                    val y = size * y
-
-                    drawer.fill = color
-                    drawer.stroke = color
-
-                    if (index <= 11 || index > 23) {
-                        drawer.circle(x + radius, y + radius, radius)
-                    } else {
-                        drawer.rectangle(x, y, size, size)
-                    }
-                }
-            }
-        }
-    }
-}
-```
+### DemoColorBrewer2_02
+[source code](src/jvmDemo/kotlin/DemoColorBrewer2_02.kt)
+
+![DemoColorBrewer2_02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-palette/images/DemoColorBrewer2_02Kt.png)
+
+### DemoColorBrewer2_03
+[source code](src/jvmDemo/kotlin/DemoColorBrewer2_03.kt)
+
+![DemoColorBrewer2_03Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-palette/images/DemoColorBrewer2_03Kt.png)
+
+### DemoPaletteStudio01
+[source code](src/jvmDemo/kotlin/DemoPaletteStudio01.kt)
+
+![DemoPaletteStudio01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-palette/images/DemoPaletteStudio01Kt.png)
+
+### DemoPaletteStudio02
+[source code](src/jvmDemo/kotlin/DemoPaletteStudio02.kt)
+
+![DemoPaletteStudio02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-palette/images/DemoPaletteStudio02Kt.png)

orx-palette/build.gradle.kts

@@ -1,10 +1,25 @@
 plugins {
-    org.openrndr.extra.convention.`kotlin-jvm`
+    org.openrndr.extra.convention.`kotlin-multiplatform`
 }
 
-dependencies {
-    implementation(libs.gson)
-    implementation(project(":orx-noise"))
-    implementation(libs.openrndr.application)
-    implementation(libs.openrndr.math)
-}
+kotlin {
+    sourceSets {
+        @Suppress("UNUSED_VARIABLE")
+        val jvmMain by getting {
+            dependencies {
+                implementation(libs.gson)
+                implementation(project(":orx-noise"))
+                implementation(libs.openrndr.application)
+                implementation(libs.openrndr.math)
+            }
+        }
+
+        val jvmDemo by getting {
+            dependencies {
+                implementation(project(":orx-palette"))
+                implementation(project(":orx-palette"))
+                implementation(project(":orx-shapes"))
+            }
+        }
+    }
+}