src/jalview/util/ColorUtils.java

   1 /*
   2  * Jalview - A Sequence Alignment Editor and Viewer (Version 2.9)
   3  * Copyright (C) 2015 The Jalview Authors
   4  *
   5  * This file is part of Jalview.
   6  *
   7  * Jalview is free software: you can redistribute it and/or
   8  * modify it under the terms of the GNU General Public License
   9  * as published by the Free Software Foundation, either version 3
  10  * of the License, or (at your option) any later version.
  11  *
  12  * Jalview is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty
  14  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  15  * PURPOSE.  See the GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
  19  * The Jalview Authors are detailed in the 'AUTHORS' file.
  20  */
  21 /**
  22  * author: Lauren Michelle Lui
  23  */
  24
  25 package jalview.util;
  26
  27 import java.awt.Color;
  28 import java.util.Random;
  29
  30 public class ColorUtils
  31 {
  32
  33   /**
  34    * Generates a random color, will mix with input color. Code taken from
  35    * http://stackoverflow
  36    * .com/questions/43044/algorithm-to-randomly-generate-an-aesthetically
  37    * -pleasing-color-palette
  38    *
  39    * @param mix
  40    * @return Random color in RGB
  41    */
  42   public static final Color generateRandomColor(Color mix)
  43   {
  44     Random random = new Random();
  45     int red = random.nextInt(256);
  46     int green = random.nextInt(256);
  47     int blue = random.nextInt(256);
  48
  49     // mix the color
  50     if (mix != null)
  51     {
  52       red = (red + mix.getRed()) / 2;
  53       green = (green + mix.getGreen()) / 2;
  54       blue = (blue + mix.getBlue()) / 2;
  55     }
  56
  57     Color color = new Color(red, green, blue);
  58     return color;
  59
  60   }
  61
  62   /**
  63    * Convert to Tk colour code format
  64    *
  65    * @param colour
  66    * @return
  67    * @see http
  68    *      ://www.cgl.ucsf.edu/chimera/current/docs/UsersGuide/colortool.html#
  69    *      tkcode
  70    */
  71   public static final String toTkCode(Color colour)
  72   {
  73     String colstring = "#" + ((colour.getRed() < 16) ? "0" : "")
  74             + Integer.toHexString(colour.getRed())
  75             + ((colour.getGreen() < 16) ? "0" : "")
  76             + Integer.toHexString(colour.getGreen())
  77             + ((colour.getBlue() < 16) ? "0" : "")
  78             + Integer.toHexString(colour.getBlue());
  79     return colstring;
  80   }
  81
  82   /**
  83    * Returns a colour three shades darker. Note you can't guarantee that
  84    * brighterThan reverses this, as darkerThan may result in black.
  85    *
  86    * @param col
  87    * @return
  88    */
  89   public static Color darkerThan(Color col)
  90   {
  91     return col == null ? null : col.darker().darker().darker();
  92   }
  93
  94   /**
  95    * Returns a colour three shades brighter. Note you can't guarantee that
  96    * darkerThan reverses this, as brighterThan may result in white.
  97    *
  98    * @param col
  99    * @return
 100    */
 101   public static Color brighterThan(Color col)
 102   {
 103     return col == null ? null : col.brighter().brighter().brighter();
 104   }
 105
 106 }