JAL-2965 graduated sequence point colour from back to front
[jalview.git] / test / jalview / util / ColorUtilsTest.java
index 77a023f..0acd806 100644 (file)
@@ -24,13 +24,23 @@ import static org.testng.AssertJUnit.assertEquals;
 import static org.testng.AssertJUnit.assertNull;
 import static org.testng.AssertJUnit.assertSame;
 
+import jalview.gui.JvOptionPane;
+
 import java.awt.Color;
 
+import org.testng.annotations.BeforeClass;
 import org.testng.annotations.Test;
 
 public class ColorUtilsTest
 {
 
+  @BeforeClass(alwaysRun = true)
+  public void setUpJvOptionPane()
+  {
+    JvOptionPane.setInteractiveMode(false);
+    JvOptionPane.setMockResponse(JvOptionPane.CANCEL_OPTION);
+  }
+
   Color paleColour = new Color(97, 203, 111); // pale green
 
   Color midColour = new Color(135, 57, 41); // mid red
@@ -156,4 +166,125 @@ public class ColorUtilsTest
     assertEquals(new Color(46, 31, 16), // with rounding down
             ColorUtils.bleachColour(colour, -0.7f));
   }
+
+  @Test(groups = "Functional")
+  public void testParseColourString()
+  {
+    /*
+     * by colour name - if known to AWT, and included in
+     * 
+     * @see ColourSchemeProperty.getAWTColorFromName()
+     */
+    assertSame(Color.RED, ColorUtils.parseColourString("red"));
+    assertSame(Color.RED, ColorUtils.parseColourString("Red"));
+    assertSame(Color.RED, ColorUtils.parseColourString(" RED "));
+
+    /*
+     * by RGB hex code
+     */
+    String hexColour = Integer.toHexString(Color.RED.getRGB() & 0xffffff);
+    assertEquals("ff0000", hexColour);
+    assertEquals(Color.RED, ColorUtils.parseColourString(hexColour));
+    // 'hex' prefixes _not_ wanted here
+    assertNull(ColorUtils.parseColourString("0x" + hexColour));
+    assertNull(ColorUtils.parseColourString("#" + hexColour));
+    // out of range, but Color constructor just or's the rgb value with 0
+    assertEquals(Color.black, ColorUtils.parseColourString("1000000"));
+
+    /*
+     * by RGB triplet
+     */
+    Color c = Color.pink;
+    String rgb = String.format("%d,%d,%d", c.getRed(), c.getGreen(),
+            c.getBlue());
+    assertEquals("255,175,175", rgb);
+    assertEquals(c, ColorUtils.parseColourString(rgb));
+    assertEquals(c, ColorUtils.parseColourString("255, 175 , 175"));
+
+    /*
+     * odds and ends
+     */
+    assertNull(ColorUtils.parseColourString(null));
+    assertNull(ColorUtils.parseColourString("rubbish"));
+    assertEquals(Color.WHITE, ColorUtils.parseColourString("-1"));
+    assertNull(ColorUtils.parseColourString(String
+            .valueOf(Integer.MAX_VALUE)));
+    assertNull(ColorUtils.parseColourString("100,200,300")); // out of range
+    assertNull(ColorUtils.parseColourString("100,200")); // too few
+    assertNull(ColorUtils.parseColourString("100,200,100,200")); // too many
+  }
+
+  @Test(groups = "Functional")
+  public void testGetAWTColorFromName() {
+    assertEquals(Color.white, ColorUtils.getAWTColorFromName("white"));
+    assertEquals(Color.white, ColorUtils.getAWTColorFromName("White"));
+    assertEquals(Color.white, ColorUtils.getAWTColorFromName("WHITE"));
+    assertEquals(Color.pink, ColorUtils.getAWTColorFromName("pink"));
+    assertNull(ColorUtils.getAWTColorFromName("mauve")); // no such name
+    assertNull(ColorUtils.getAWTColorFromName(""));
+    assertNull(ColorUtils.getAWTColorFromName(null));
+  }
+
+  @Test(groups = "Functional")
+  public void testCreateColourFromName()
+  {
+    assertEquals(Color.white, ColorUtils.createColourFromName(null));
+    assertEquals(new Color(20, 20, 20), ColorUtils.createColourFromName(""));
+    assertEquals(new Color(98, 131, 171),
+            ColorUtils.createColourFromName("None")); // no special treatment!
+    assertEquals(new Color(123, 211, 122),
+            ColorUtils.createColourFromName("hello world"));
+    assertEquals(new Color(27, 147, 112),
+            ColorUtils.createColourFromName("HELLO WORLD"));
+    /*
+     * the algorithm makes the same values for r,g,b if 
+     * the string consists of 3 repeating substrings
+     */
+    assertEquals(new Color(184, 184, 184),
+            ColorUtils.createColourFromName("HELLO HELLO HELLO "));
+  }
+
+  /**
+   * Tests for the method that returns a colour graduated between darker() and
+   * brighter()
+   */
+  @Test(groups = { "Functional" })
+  public void testGetGraduatedColour_darkerToBrighter()
+  {
+    final Color colour = new Color(180, 200, 220);
+  
+    /*
+     * value half-way between min and max does _not_ mean colour unchanged
+     * darker (*.7) is (126, 140, 154)
+     * brighter (*1/.7) is (255, 255, 255)
+     * midway is (190, 197, 204)
+     */
+    Color col = ColorUtils.getGraduatedColour(20f, 10f, 30f, colour);
+    assertEquals(190, col.getRed());
+    assertEquals(197, col.getGreen());
+    assertEquals(204, col.getBlue());
+
+    // minValue (or less) returns colour.darker()
+    // - or would do if Color.darker calculated better!
+    col = ColorUtils.getGraduatedColour(10f, 10f, 30f, colour);
+    assertEquals(col, new Color(126, 140, 154));
+    // Color.darker computes 125.999999 and rounds down!
+    assertEquals(new Color(125, 140, 154), colour.darker());
+    col = ColorUtils.getGraduatedColour(-10f, 10f, 30f, colour);
+    assertEquals(new Color(126, 140, 154), col);
+
+    // maxValue (or more) returns colour.brighter()
+    col = ColorUtils.getGraduatedColour(30f, 10f, 30f, colour);
+    assertEquals(colour.brighter(), col);
+    col = ColorUtils.getGraduatedColour(40f, 10f, 30f, colour);
+    assertEquals(colour.brighter(), col);
+
+    /*
+     * 'linear' mid-point between 0.7 and 1/0.7 is 1.057
+     * so the '
+     */
+    Color c = new Color(200, 200, 200);
+    col = ColorUtils.getGraduatedColour(106f, 0f, 200f, c);
+    assertEquals(c, col);
+  }
 }