feat: add transparent colors

Author: lewisfm

examples/screen/src/main/kotlin/dev/vexide/hydrozoa/examples/screen/Main.kt

@@ -2,20 +2,20 @@ package dev.vexide.hydrozoa.examples.screen
 
 import dev.vexide.hydrozoa.Peripherals
 import dev.vexide.hydrozoa.Platform
+import dev.vexide.hydrozoa.display.Color
 import dev.vexide.hydrozoa.display.Rect
-import dev.vexide.hydrozoa.display.Rgb
 import dev.vexide.hydrozoa.display.Text
 
 fun main() {
     val peripherals = Peripherals.take().orElseThrow()
     val display = peripherals.takeDisplay()
 
     val rect = Rect(20, 20, 100, 100)
-    display.fill(rect, Rgb.fromInteger(0xFFFFFF))
-    display.stroke(rect, Rgb.fromInteger(0xFF00FF))
+    display.fill(rect, Color.WHITE)
+    display.stroke(rect, Color.FUCHSIA)
 
     val text = Text("Nice to see you!", 80, 80)
-    display.write(text, Rgb.fromInteger(0x00FFFF), Rgb.fromInteger(0x000000))
+    display.write(text, Color.OLIVE, Color.TRANSPARENT)
 
     while (true) {
         Platform.yield()

src/main/java/dev/vexide/hydrozoa/display/Circle.java

@@ -11,8 +11,8 @@ public record Circle(int x, int y, int radius) implements Shape {
     }
 
     @Override
-    public void draw(@NotNull Display screen, @NotNull Rgb color, boolean fill) {
-        VexSdk.Display.vexDisplayForegroundColor(color.toInteger());
+    public void draw(@NotNull Display screen, @NotNull Color color, boolean fill) {
+        VexSdk.Display.vexDisplayForegroundColor(color.raw());
         if (fill) {
             VexSdk.Display.vexDisplayCircleFill(x, y + Display.HEADER_HEIGHT, radius);
         } else {

src/main/java/dev/vexide/hydrozoa/display/Color.java

@@ -0,0 +1,52 @@
+package dev.vexide.hydrozoa.display;
+
+import org.jetbrains.annotations.Contract;
+
+public record Color(int raw) {
+    public static final Color TRANSPARENT = new Color(0, true);
+    public static final Color BLACK = new Color(0x000000);
+    public static final Color SILVER = new Color(0xC0C0C0);
+    public static final Color GRAY = new Color(0x808080);
+    public static final Color WHITE = new Color(0xFFFFFF);
+    public static final Color MAROON = new Color(0x800000);
+    public static final Color RED = new Color(0xFF0000);
+    public static final Color PURPLE = new Color(0x800080);
+    public static final Color FUCHSIA = new Color(0xFF00FF);
+    public static final Color GREEN = new Color(0x008000);
+    public static final Color LIME = new Color(0x00FF00);
+    public static final Color OLIVE = new Color(0x808000);
+    public static final Color YELLOW = new Color(0xFFFF00);
+    public static final Color NAVY = new Color(0x000080);
+    public static final Color BLUE = new Color(0x0000FF);
+    public static final Color TEAL = new Color(0x008080);
+    public static final Color AQUA = new Color(0x00FFFF);
+    public Color(int red, int green, int blue) {
+        this(red, green, blue, false);
+    }
+    public Color(int red, int green, int blue, boolean transparent) {
+        this((red << 16) | (green << 8) | blue, transparent);
+    }
+    public Color(int raw, boolean transparent) {
+        this(raw | (transparent ? 0x1000000 : 0));
+    }
+
+    @Contract(pure = true)
+    public boolean transparent() {
+        return (raw & 0x1000000) != 0;
+    }
+
+    @Contract(pure = true)
+    public int red() {
+        return (raw >> 16) & 0xFF;
+    }
+
+    @Contract(pure = true)
+    public int green() {
+        return (raw >> 8) & 0xFF;
+    }
+
+    @Contract(pure = true)
+    public int blue() {
+        return raw & 0xFF;
+    }
+}

src/main/java/dev/vexide/hydrozoa/display/Display.java

@@ -30,19 +30,19 @@ public void render() {
         }
     }
 
-    public void draw(@NotNull Shape shape, @NotNull Rgb color, boolean fill) {
+    public void draw(@NotNull Shape shape, @NotNull Color color, boolean fill) {
         shape.draw(this, color, fill);
     }
 
-    public void fill(@NotNull Shape shape, @NotNull Rgb color) {
+    public void fill(@NotNull Shape shape, @NotNull Color color) {
         shape.draw(this, color, true);
     }
 
-    public void stroke(@NotNull Shape shape, @NotNull Rgb color) {
+    public void stroke(@NotNull Shape shape, @NotNull Color color) {
         shape.draw(this, color, false);
     }
 
-    public void write(@NotNull Text text, @NotNull Rgb fgColor, @NotNull Rgb bgColor) {
+    public void write(@NotNull Text text, @NotNull Color fgColor, @NotNull Color bgColor) {
         text.draw(this, fgColor, bgColor);
     }
 

src/main/java/dev/vexide/hydrozoa/display/Rect.java

@@ -16,8 +16,8 @@ public record Rect(int x1, int y1, int x2, int y2) implements Shape {
     }
 
     @Override
-    public void draw(@NotNull Display screen, @NotNull Rgb color, boolean fill) {
-        VexSdk.Display.vexDisplayForegroundColor(color.toInteger());
+    public void draw(@NotNull Display screen, @NotNull Color color, boolean fill) {
+        VexSdk.Display.vexDisplayForegroundColor(color.raw());
         if (fill) {
             VexSdk.Display.vexDisplayRectFill(x1, y1 + Display.HEADER_HEIGHT, x2, y2 + Display.HEADER_HEIGHT);
         } else {

src/main/java/dev/vexide/hydrozoa/display/Rgb.java

@@ -3,5 +3,5 @@
 import org.jetbrains.annotations.NotNull;
 
 public interface Shape {
-    void draw(@NotNull Display screen, @NotNull Rgb color, boolean fill);
+    void draw(@NotNull Display screen, @NotNull Color color, boolean fill);
 }

src/main/java/dev/vexide/hydrozoa/display/Shape.java

@@ -49,9 +49,9 @@ public int width() {
         return VexSdk.Display.vexDisplayStringWidthGet(text);
     }
 
-    public void draw(@NotNull Display display, @NotNull Rgb fgColor, @NotNull Rgb bgColor) {
-        VexSdk.Display.vexDisplayForegroundColor(fgColor.toInteger());
-        VexSdk.Display.vexDisplayBackgroundColor(bgColor.toInteger());
+    public void draw(@NotNull Display display, @NotNull Color fgColor, @NotNull Color bgColor) {
+        VexSdk.Display.vexDisplayForegroundColor(fgColor.raw());
+        VexSdk.Display.vexDisplayBackgroundColor(bgColor.raw());
 
         var x = switch (hAlign) {
             case Left -> this.x;