at.tuwien.ifs.somtoolbox.visualization
Class Palette

java.lang.Object
  extended by at.tuwien.ifs.somtoolbox.visualization.Palette
All Implemented Interfaces:
Comparable<Palette>

public class Palette
extends Object
implements Comparable<Palette>

This class represents a palette for the visualization.

Version:
$Id: Palette.java 3888 2010-11-02 17:42:53Z frank $
Author:
Rudolf Mayer, Jakob Frank

Field Summary
private  Color[] colors
           
private  String description
           
private  ColorGradient gradient
           
private  boolean hidden
           
private  String name
           
private  int numberOfGradientColours
           
private  String paletteGroup
           
private  boolean reversed
           
private  String shortName
           
 
Constructor Summary
Palette()
           
Palette(String name, String shortName, String description, Color[] colors)
           
Palette(String name, String shortName, String description, ColorGradient gradient, int numberOfGradientColours)
           
 
Method Summary
 int compareTo(Palette other)
          Compares palette objects by name.
 void deleteColor(int pos)
           
 String getCacheKey()
           
 Color getColor(int index)
           
 Color getColorConstrained(int index)
           
 Color[] getColors()
           
 String getDescription()
           
 ColorGradient getGradient()
           
 String getLongDescription()
           
 String getName()
           
 int getNumberOfColours()
           
 int getNumberOfGradientColours()
           
 org.jdom.Element getPaletteAsXML()
           
 String getPaletteGroup()
           
 String getShortName()
           
 void insertColor(int pos, Color c)
           
 boolean isHidden()
          Returns true if the palette should not be shown in the Palettes menu.
 boolean isReversed()
           
private static Palette loadPaletteFromXML_v1x0(org.jdom.Element root)
           
private static Palette loadPaletteFromXML(org.jdom.Document doc)
           
static Palette loadPaletteFromXML(File file)
           
static Palette loadPaletteFromXML(InputStream in)
           
static Palette loadPaletteFromXML(JarFile jarFile, String name)
           
 double maxColourIndex()
           
 void reverse()
           
 Color[] reverseColors()
           
 void savePaletteAsJavaCode(File file)
          Save the Palette as Javacode to the given file.
 void savePaletteToMatlab(File file)
          Save the Palette as Matlab code to the given file.
 void savePaletteToXML(File file)
           
 void setColor(int index, Color c)
           
 void setDescription(String description)
           
 void setGradient(ColorGradient gradient)
           
private  void setGradient(ColorGradient gradient, int numberOfGradientColours)
           
 void setHidden(boolean hidden)
           
 void setName(String name)
           
 void setNumberOfGradientColours(int numberOfGradientColours)
          Sets the number of gradient colours to be used, and generates the palette colours (colors) new.
 void setPaletteGroup(String paletteGroup)
           
 void setShortName(String shortName)
           
 String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

name

private String name

description

private String description

paletteGroup

private String paletteGroup

colors

private Color[] colors

gradient

private ColorGradient gradient

numberOfGradientColours

private int numberOfGradientColours

shortName

private String shortName

hidden

private boolean hidden

reversed

private boolean reversed
Constructor Detail

Palette

public Palette()

Palette

public Palette(String name,
               String shortName,
               String description,
               ColorGradient gradient,
               int numberOfGradientColours)

Palette

public Palette(String name,
               String shortName,
               String description,
               Color[] colors)
Method Detail

getPaletteGroup

public String getPaletteGroup()

setPaletteGroup

public void setPaletteGroup(String paletteGroup)

deleteColor

public void deleteColor(int pos)

insertColor

public void insertColor(int pos,
                        Color c)

getColors

public Color[] getColors()

getColor

public Color getColor(int index)

getColorConstrained

public Color getColorConstrained(int index)

getDescription

public String getDescription()

getName

public String getName()

getShortName

public String getShortName()

compareTo

public int compareTo(Palette other)
Compares palette objects by name.

Specified by:
compareTo in interface Comparable<Palette>

toString

public String toString()
Overrides:
toString in class Object

getCacheKey

public String getCacheKey()

getLongDescription

public String getLongDescription()

getNumberOfGradientColours

public int getNumberOfGradientColours()

getGradient

public ColorGradient getGradient()

setColor

public void setColor(int index,
                     Color c)

setGradient

public void setGradient(ColorGradient gradient)

setGradient

private void setGradient(ColorGradient gradient,
                         int numberOfGradientColours)

setNumberOfGradientColours

public void setNumberOfGradientColours(int numberOfGradientColours)
Sets the number of gradient colours to be used, and generates the palette colours (colors) new.


loadPaletteFromXML

public static Palette loadPaletteFromXML(InputStream in)
                                  throws org.jdom.JDOMException,
                                         IOException
Throws:
org.jdom.JDOMException
IOException

loadPaletteFromXML

public static Palette loadPaletteFromXML(File file)
                                  throws SOMToolboxException
Throws:
SOMToolboxException

loadPaletteFromXML

public static Palette loadPaletteFromXML(JarFile jarFile,
                                         String name)
                                  throws SOMToolboxException
Throws:
SOMToolboxException

loadPaletteFromXML

private static Palette loadPaletteFromXML(org.jdom.Document doc)
                                   throws org.jdom.JDOMException
Throws:
org.jdom.JDOMException

loadPaletteFromXML_v1x0

private static Palette loadPaletteFromXML_v1x0(org.jdom.Element root)

savePaletteToMatlab

public void savePaletteToMatlab(File file)
Save the Palette as Matlab code to the given file.

Parameters:
file - The file to save to or null to write to System.out

savePaletteAsJavaCode

public void savePaletteAsJavaCode(File file)
Save the Palette as Javacode to the given file.

Parameters:
file - The file to save to or null to write to System.out

savePaletteToXML

public void savePaletteToXML(File file)

getPaletteAsXML

public org.jdom.Element getPaletteAsXML()
Returns:
The root element <palette>...</palette>

setDescription

public void setDescription(String description)

setName

public void setName(String name)

setShortName

public void setShortName(String shortName)

reverse

public void reverse()

isReversed

public boolean isReversed()

reverseColors

public Color[] reverseColors()

getNumberOfColours

public int getNumberOfColours()

maxColourIndex

public double maxColourIndex()

isHidden

public boolean isHidden()
Returns true if the palette should not be shown in the Palettes menu.

Returns:
true iff the palette is secret.

setHidden

public void setHidden(boolean hidden)