graphic: improve dump styling

- Class names are in bold
- Colors now have the #RRGGBB part of their textual representation
  colored with the actual color
- Field names are dimmed
- Children begin "inline" rather than on a new line

Author: bvlj

lib/src/main/java/jtamaro/graphic/ActionableGraphic.java

@@ -66,8 +66,8 @@ SequencedMap<String, Graphic> getChildren() {
   }
 
   @Override
-  protected SequencedMap<String, String> getProps(boolean plainText) {
-    final SequencedMap<String, String> props = super.getProps(plainText);
+  protected SequencedMap<String, String> getProps(PropStyle propStyle) {
+    final SequencedMap<String, String> props = super.getProps(propStyle);
     if (!pressAction.isEmpty()) {
       props.put("onPress", "event");
     }

lib/src/main/java/jtamaro/graphic/CircularSector.java

@@ -63,13 +63,11 @@ protected String getInspectLabel() {
   }
 
   @Override
-  protected SequencedMap<String, String> getProps(boolean plainText) {
-    final SequencedMap<String, String> props = super.getProps(plainText);
+  protected SequencedMap<String, String> getProps(PropStyle propStyle) {
+    final SequencedMap<String, String> props = super.getProps(propStyle);
     props.put("radius", String.format("%.2f", radius));
     props.put("angle", String.format("%.2f", radius));
-    props.put("color", plainText
-        ? color.toString()
-        : Colors.htmlString(color));
+    props.put("color", Colors.format(propStyle, color));
     return props;
   }
 

lib/src/main/java/jtamaro/graphic/Color.java

@@ -31,6 +31,12 @@ public int alpha() {
 
   @Override
   public String toString() {
-    return String.format("Color[rgb=#%1$02X%2$02X%3$02X, opacity=%4$.2f]", red, green, blue, opacity);
+    return String.format(
+        "Color[rgb=#%1$02X%2$02X%3$02X, opacity=%4$.2f]",
+        red,
+        green,
+        blue,
+        opacity
+    );
   }
 }

lib/src/main/java/jtamaro/graphic/Colors.java

@@ -165,24 +165,47 @@ public static Color hsva(double hue, double saturation, double value, double opa
     return new Color(red, green, blue, opacity);
   }
 
+  /**
+   * Return a textual visualization for the given color following the given style.
+   */
+  static String format(Graphic.PropStyle style, Color color) {
+    return switch (style) {
+      case PLAIN -> color.toString();
+      case ANSI_ESCAPE_CODES -> formatAnsiEscape(color);
+      case HTML -> formatHtml(color);
+    };
+  }
+
+  /**
+   * Return a textual visualization for the given color with ansi escape codes that use the color
+   * itself to colorize its representation.
+   *
+   * @hidden
+   */
+  public static String formatAnsiEscape(Color color) {
+    return String.format(
+        "Color[rgb=\033[38;2;%5$sm\033[48;2;%1$d;%2$d;%3$dm#%1$02X%2$02X%3$02X\033[0m, opacity=%4$.2f]",
+        color.red(),
+        color.green(),
+        color.blue(),
+        color.opacity(),
+        isLight(color) ? "0;0;0" : "255;255;255"
+    );
+  }
+
   /**
    * Return an HTML string of a span with text color that of the given color and for content its
    * <pre>#RRGGBB</pre> representation.
    */
-  static String htmlString(Color color) {
-    final double luminance = 0.2126 * color.red() / 255.0
-        + 0.7152 * color.green() / 255.0
-        + 0.0722 * color.blue() / 255.0;
-    final String foregroundColor = luminance > 0.5
-        ? "#000000"
-        : "#ffffff";
+  private static String formatHtml(Color color) {
     return String.format(
         "<font bgcolor=\"rgba(%1$d,%2$d,%3$d,%4$.2f)\" color=\"%5$s\">&nbsp;#%1$02x%2$02x%3$02x&nbsp;</font>",
         color.red(),
         color.green(),
         color.blue(),
         color.opacity(),
-        foregroundColor);
+        isLight(color) ? "#000000" : "#ffffff"
+    );
   }
 
   /**
@@ -191,4 +214,19 @@ static String htmlString(Color color) {
   public static java.awt.Color toAwtColor(Color color) {
     return new java.awt.Color(color.red(), color.green(), color.blue(), color.alpha());
   }
+
+  /**
+   * Return whether the given color is light or dark.
+   *
+   * @implNote Formula taken from Item 3.5 of the
+   * <a href="https://www.itu.int/dms_pubrec/itu-r/rec/bt/R-REC-BT.709-6-201506-I!!PDF-E.pdf">
+   * Parameter values for the HDTV standards for production and international programme
+   * exchange</a>
+   */
+  private static boolean isLight(Color color) {
+    final double luminance = 0.2126 * color.red() / 255.0
+        + 0.7152 * color.green() / 255.0
+        + 0.0722 * color.blue() / 255.0;
+    return luminance > 0.5;
+  }
 }

lib/src/main/java/jtamaro/graphic/Ellipse.java

@@ -60,11 +60,9 @@ protected String getInspectLabel() {
   }
 
   @Override
-  protected SequencedMap<String, String> getProps(boolean plainText) {
-    final SequencedMap<String, String> props = super.getProps(plainText);
-    props.put("color", plainText
-        ? color.toString()
-        : Colors.htmlString(color));
+  protected SequencedMap<String, String> getProps(PropStyle propStyle) {
+    final SequencedMap<String, String> props = super.getProps(propStyle);
+    props.put("color", Colors.format(propStyle, color));
     return props;
   }
 

lib/src/main/java/jtamaro/graphic/Graphic.java

@@ -226,31 +226,32 @@ public final String dump() {
    *
    * @implSpec Remember to invoke {@code super.dump(sb, indent)} first, then add all children using
    * {@link #dumpChild(StringBuilder, String, String, Graphic)}.
-   * @implNote All the props from {@link #getProps(boolean)} are automatically added by invoking the
-   * super method.
+   * @implNote All the props from {@link #getProps(PropStyle)} are automatically added by invoking
+   * the super method.
    */
   protected final void dump(StringBuilder sb, String indent) {
-    sb.append(indent)
+    sb.append("\033[1m")
         .append(getClass().getSimpleName())
+        .append("\033[0m")
         .append("\n");
-    getProps(true).forEach((k, v) -> dumpField(sb, indent, k, v));
+    getProps(PropStyle.ANSI_ESCAPE_CODES).forEach((k, v) -> dumpField(sb, indent, k, v));
     getChildren().forEach((k, v) -> dumpChild(sb, indent, k, v));
   }
 
   private void dumpField(StringBuilder sb, String indent, String name, Object value) {
     sb.append(indent)
-        .append("├─ ")
+        .append("├─ \033[2m")
         .append(name)
-        .append(": ")
+        .append("\033[0m: ")
         .append(value)
         .append("\n");
   }
 
   private void dumpChild(StringBuilder sb, String indent, String name, Graphic child) {
     sb.append(indent)
-        .append("├─ ")
+        .append("├─ \033[2m")
         .append(name)
-        .append(":\n");
+        .append("\033[0m: ");
     child.dump(sb, indent + "│  ");
   }
 
@@ -272,21 +273,35 @@ protected String getInspectLabel() {
     return "graphic";
   }
 
+
+  /**
+   * Properties of the graphic.
+   *
+   * <p>Same as {@link #getProps(PropStyle)}, with {@link PropStyle#PLAIN} as the style.
+   *
+   * @implSpec The returned map is supposed to be mutable in non final-classes that override this
+   * method so that it's easier for subclasses to add more entries to it.
+   * @see #getProps(PropStyle)
+   */
+  protected SequencedMap<String, String> getProps() {
+    return getProps(PropStyle.PLAIN);
+  }
+
   /**
    * Properties of the graphic.
    *
    * <p>These are used to produce various representations of the graphic.
    *
-   * @param plainText Whether the value strings be in plain text ({@code true}) or formatted in HTML
-   *                  markup ({@code false}).
+   * @param propStyle Whether the value strings be in plain text, formatted in HTML or ANSI escape
+   *                  codes markup.
    * @implSpec The returned map is supposed to be mutable in non final-classes that override this
    * method so that it's easier for subclasses to add more entries to it.
    * @see #dump(StringBuilder, String)
    * @see #toString()
    * @see GuiGraphicPropertiesPanel
    * @see GuiGraphicTreeCellRenderer
    */
-  protected SequencedMap<String, String> getProps(boolean plainText) {
+  protected SequencedMap<String, String> getProps(PropStyle propStyle) {
     // We use LinkedHashMap as the implementation class because:
     //   1. We care about insertion order
     //   2. We never perform random reads on the map, just forEach iterations
@@ -327,7 +342,7 @@ public int hashCode() {
   public final String toString() {
     return getClass().getSimpleName()
         + "["
-        + getProps(true).entrySet().stream()
+        + getProps(PropStyle.PLAIN).entrySet().stream()
         .map(e -> e.getKey() + "=" + e.getValue())
         .collect(Collectors.joining(", "))
         + "]";
@@ -351,4 +366,13 @@ public Graphic getGraphic() {
       return Graphic.this;
     }
   }
+
+  /**
+   * @hidden
+   */
+  protected enum PropStyle {
+    PLAIN,
+    ANSI_ESCAPE_CODES,
+    HTML,
+  }
 }

lib/src/main/java/jtamaro/graphic/GuiGraphicPropertiesPanel.java

@@ -47,7 +47,7 @@ public void setGraphic(Graphic graphic) {
     } else {
       label.setText("<html><b>" + graphic.getInspectLabel() + "</b>"
           + "<table>"
-          + graphic.getProps(false).entrySet().stream()
+          + graphic.getProps(Graphic.PropStyle.HTML).entrySet().stream()
           .map(e -> "<tr><td><b>"
               + e.getKey()
               + "</b></td><td>"

lib/src/main/java/jtamaro/graphic/GuiGraphicTreeCellRenderer.java

@@ -38,7 +38,7 @@ public Component getTreeCellRendererComponent(
     if (value instanceof Graphic.InspectTreeNode node) {
       final Graphic graphic = node.getGraphic();
       setText(graphic.getInspectLabel());
-      final Map<String, String> props = graphic.getProps(false);
+      final Map<String, String> props = graphic.getProps(Graphic.PropStyle.HTML);
       final String toolTipText = "<html><b>" + graphic.getInspectLabel() + "</b>"
           + "<table>"
           + props.entrySet().stream()

lib/src/main/java/jtamaro/graphic/Pin.java

@@ -107,8 +107,8 @@ protected String getInspectLabel() {
   }
 
   @Override
-  protected SequencedMap<String, String> getProps(boolean plainText) {
-    final SequencedMap<String, String> props = super.getProps(plainText);
+  protected SequencedMap<String, String> getProps(PropStyle propStyle) {
+    final SequencedMap<String, String> props = super.getProps(propStyle);
     props.put("pinPoint", Points.format(pinPoint));
     return props;
   }

lib/src/main/java/jtamaro/graphic/Rectangle.java

@@ -56,11 +56,9 @@ protected String getInspectLabel() {
   }
 
   @Override
-  protected SequencedMap<String, String> getProps(boolean plainText) {
-    final SequencedMap<String, String> props = super.getProps(plainText);
-    props.put("color", plainText
-        ? color.toString()
-        : Colors.htmlString(color));
+  protected SequencedMap<String, String> getProps(PropStyle propStyle) {
+    final SequencedMap<String, String> props = super.getProps(propStyle);
+    props.put("color", Colors.format(propStyle, color));
     return props;
   }