/*
* Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
* Copyright (C) $$Year-Rel$$ The Jalview Authors
*
* This file is part of Jalview.
*
* Jalview is free software: you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation, either version 3
* of the License, or (at your option) any later version.
*
* Jalview is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty
* of MERCHANTABILITY or FITNESS FOR A PARTICULAR
* PURPOSE. See the GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with Jalview. If not, see .
* The Jalview Authors are detailed in the 'AUTHORS' file.
*/
package jalview.schemes;
import jalview.api.AlignViewportI;
import jalview.datamodel.AnnotatedCollectionI;
import jalview.util.ColorUtils;
import jalview.util.StringUtils;
import java.awt.Color;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Map.Entry;
import java.util.StringTokenizer;
public class UserColourScheme extends ResidueColourScheme
{
/*
* lookup (by symbol index) of lower case colours (if configured)
*/
Color[] lowerCaseColours;
protected String schemeName;
public UserColourScheme()
{
super(ResidueProperties.aaIndex);
}
public UserColourScheme(Color[] newColors)
{
super(ResidueProperties.aaIndex);
colors = newColors;
}
@Override
public ColourSchemeI getInstance(AlignViewportI view,
AnnotatedCollectionI sg)
{
return new UserColourScheme(this);
}
/**
* Copy constructor
*
* @return
*/
protected UserColourScheme(UserColourScheme from)
{
this(from.colors);
schemeName = from.schemeName;
if (from.lowerCaseColours != null)
{
lowerCaseColours = new Color[from.lowerCaseColours.length];
System.arraycopy(from.lowerCaseColours, 0, lowerCaseColours, 0,
from.lowerCaseColours.length);
}
}
/**
* Constructor for an animino acid colour scheme. The colour specification may
* be one of
*
* - an AWT colour name e.g. red
* - an AWT hex rgb colour e.g. ff2288
* - residue colours list e.g. D,E=red;K,R,H=0022FF;c=yellow
*
*
* @param colour
*/
public UserColourScheme(String colour)
{
super(ResidueProperties.aaIndex);
if (colour.contains("="))
{
/*
* a list of colours per residue(s)
*/
parseAppletParameter(colour);
return;
}
Color col = ColorUtils.parseColourString(colour);
if (col == null)
{
System.out.println("Making colour from name: " + colour);
col = ColorUtils.createColourFromName(colour);
}
setAll(col);
schemeName = colour;
}
/**
* Sets all symbols to the specified colour
*
* @param col
*/
protected void setAll(Color col)
{
if (symbolIndex == null)
{
return;
}
int max = 0;
for (int index : symbolIndex)
{
max = Math.max(max, index);
}
colors = new Color[max + 1];
for (int i = 0; i <= max; i++)
{
colors[i] = col;
}
}
public Color[] getColours()
{
return colors;
}
public Color[] getLowerCaseColours()
{
return lowerCaseColours;
}
public void setName(String name)
{
schemeName = name;
}
public String getName()
{
return schemeName;
}
/**
* Parse and save residue colours specified as (for example)
*
*
* D,E=red; K,R,H=0022FF; c=100,50,75
*
*
* This should be a semi-colon separated list of colours, which may be defined
* by colour name, hex value or comma-separated RGB triple. Each colour is
* defined for a comma-separated list of amino acid single letter codes. (Note
* that this also allows a colour scheme to be defined for ACGT, but not for
* U.)
*
* @param paramValue
*/
void parseAppletParameter(String paramValue)
{
setAll(Color.white);
StringTokenizer st = new StringTokenizer(paramValue, ";");
StringTokenizer st2;
String token = null, colour, residues;
try
{
while (st.hasMoreElements())
{
token = st.nextToken().trim();
residues = token.substring(0, token.indexOf("="));
colour = token.substring(token.indexOf("=") + 1);
st2 = new StringTokenizer(residues, " ,");
while (st2.hasMoreTokens())
{
String residue = st2.nextToken();
int colIndex = ResidueProperties.aaIndex[residue.charAt(0)];
if (colIndex == -1)
{
continue;
}
if (residue.equalsIgnoreCase("lowerCase"))
{
if (lowerCaseColours == null)
{
lowerCaseColours = new Color[colors.length];
}
for (int i = 0; i < lowerCaseColours.length; i++)
{
if (lowerCaseColours[i] == null)
{
lowerCaseColours[i] = ColorUtils.parseColourString(colour);
}
}
continue;
}
if (residue.equals(residue.toLowerCase()))
{
if (lowerCaseColours == null)
{
lowerCaseColours = new Color[colors.length];
}
lowerCaseColours[colIndex] = ColorUtils
.parseColourString(colour);
}
else
{
colors[colIndex] = ColorUtils.parseColourString(colour);
}
}
}
} catch (Exception ex)
{
System.out.println(
"Error parsing userDefinedColours:\n" + token + "\n" + ex);
}
}
public void setLowerCaseColours(Color[] lcolours)
{
lowerCaseColours = lcolours;
}
/**
* Returns the colour for the given residue character. If the residue is
* lower-case, and there is a specific colour defined for lower case, that
* colour is returned, else the colour for the upper case residue.
*/
@Override
public Color findColour(char c)
{
if ('a' <= c && c <= 'z' && lowerCaseColours != null)
{
Color colour = lowerCaseColours[symbolIndex[c]];
if (colour != null)
{
return colour;
}
}
return super.findColour(c);
}
/**
* Answers the customised name of the colour scheme, if it has one, else "User
* Defined"
*/
@Override
public String getSchemeName()
{
if (schemeName != null && schemeName.length() > 0)
{
return schemeName;
}
return ResidueColourScheme.USER_DEFINED;
}
/**
* Generate an applet colour parameter like A,C,D=12ffe9;Q,W=2393fd;w=9178dd
*
* @return
*/
public String toAppletParameter()
{
/*
* step 1: build a map from colours to the symbol(s) that have the colour
*/
Map> colours = new HashMap<>();
for (char symbol = 'A'; symbol <= 'Z'; symbol++)
{
String residue = String.valueOf(symbol);
int index = symbolIndex[symbol];
Color c = colors[index];
if (c != null && !c.equals(Color.white))
{
if (colours.get(c) == null)
{
colours.put(c, new ArrayList());
}
colours.get(c).add(residue);
}
if (lowerCaseColours != null)
{
c = lowerCaseColours[index];
if (c != null && !c.equals(Color.white))
{
residue = residue.toLowerCase();
if (colours.get(c) == null)
{
colours.put(c, new ArrayList());
}
colours.get(c).add(residue);
}
}
}
/*
* step 2: make a list of { A,G,R=12f9d6 } residues/colour specs
*/
List residueColours = new ArrayList<>();
for (Entry> cols : colours.entrySet())
{
boolean first = true;
StringBuilder sb = new StringBuilder();
for (String residue : cols.getValue())
{
if (!first)
{
sb.append(",");
}
sb.append(residue);
first = false;
}
sb.append("=");
/*
* get color as hex value, dropping the alpha (ff) part
*/
String hexString = Integer.toHexString(cols.getKey().getRGB())
.substring(2);
sb.append(hexString);
residueColours.add(sb.toString());
}
/*
* sort and output
*/
Collections.sort(residueColours);
return StringUtils.listToDelimitedString(residueColours, ";");
}
@Override
public boolean hasGapColour()
{
return (findColour(' ') != null);
}
}