jhplot
Class HKey

java.lang.Object
  extended by jhplot.HKey
All Implemented Interfaces:
java.io.Serializable

public class HKey
extends java.lang.Object
implements java.io.Serializable

Create an interactive key label in the USER or NDC coordinates. The label can be defined in the NDC (normalized coordinate system) or the user coordinate. Only one line of the text can be shown. The key is not related to any data set, so you can plot this key even if no data are shown.

See Also:
Serialized Form

Constructor Summary
HKey(java.lang.String s)
          Make a key label with default attributes
HKey(java.lang.String s, double x, double y)
          Make a key label with specific coordinated in the data system
HKey(java.lang.String s, double x, double y, java.lang.String howToSet)
          Make a label with specific coordinates.
HKey(java.lang.String s, java.awt.Font f)
          Make a key label (color- black)
HKey(java.lang.String s, java.awt.Font f, java.awt.Color c)
          Create a key label.
 
Method Summary
 java.awt.Color getColor()
          Get color of a label.
 java.awt.Font getFont()
          Get the font of the label text.
 jplot.GraphLabel getGraphLabel()
          Get a label with default attributes
 java.awt.Color getKeyColor()
          Get key color
 float getKeySize()
          Get key size
 double getKeySpace()
          Get a space between the key and the text describing the key
 int getKeyType()
          Get key type
 double getLineWidth()
          Get a key line width
 int getPositionCoordinate()
          Is the position set?
 double getRotation()
          Returns the rotation angle.
 java.lang.String getText()
          Get the text of the label.
 double getX()
          Returns the X position of the text.
 double getY()
          Returns the Y position of the text.
 void setColor(java.awt.Color c)
          Sets the color to a specific value
 void setFont(java.awt.Font f)
          Sets the font to a specific value
 void setKey(int key_type, double key_size, java.awt.Color key_color)
          Sets a key
 void setKeySpace(double key_space)
          Sets a space between the key and the text describing the key
 void setLineWidth(int key_line_width)
          Sets key line width
 void setLocation(double x, double y)
          Sets the location of the label in data coordinates.
 void setLocation(double x, double y, java.lang.String howToSet)
          Sets the location of the label in data coordinates.
 void setRotation(double r)
          Sets the rotation angle.
 void setText(java.lang.String s)
          Sets a text of the label.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

HKey

public HKey(java.lang.String s,
            java.awt.Font f,
            java.awt.Color c)
Create a key label.

Parameters:
s - Text
f - Font
c - Color

HKey

public HKey(java.lang.String s,
            java.awt.Font f)
Make a key label (color- black)

Parameters:
s - Text
f - Font

HKey

public HKey(java.lang.String s)
Make a key label with default attributes

Parameters:
s - text

HKey

public HKey(java.lang.String s,
            double x,
            double y)
Make a key label with specific coordinated in the data system

Parameters:
s - Text
x - Position in X
y - Position in Y

HKey

public HKey(java.lang.String s,
            double x,
            double y,
            java.lang.String howToSet)
Make a label with specific coordinates.

Parameters:
s - Text
x - position in X
y - position in Y
howToSet - set it to "NDC" for normalized coordinates (in the range 0-1). This is a data independent position set it to "USER" for the user coordinates
Method Detail

setText

public void setText(java.lang.String s)
Sets a text of the label.

Parameters:
s - new text for the label

getText

public java.lang.String getText()
Get the text of the label.

Returns:
the current text of the label

setColor

public void setColor(java.awt.Color c)
Sets the color to a specific value

Parameters:
c - color used to draw the label

getColor

public java.awt.Color getColor()
Get color of a label.

Returns:
the color used to draw the label

setFont

public void setFont(java.awt.Font f)
Sets the font to a specific value

Parameters:
f - font used to draw the label

getFont

public java.awt.Font getFont()
Get the font of the label text.

Returns:
the font used to draw the label

setRotation

public void setRotation(double r)
Sets the rotation angle. Although all kind of angles (in PI-units) are allowed, internally we only use the interval 0-2pi hence we take care of all other cases.

Parameters:
r - angle for this label

getRotation

public double getRotation()
Returns the rotation angle.

Returns:
angle for this label

setLocation

public void setLocation(double x,
                        double y)
Sets the location of the label in data coordinates. Ones set this way, you cannot plot the label, it must first define the location in pixel-coordinates (setLocation(x,y));

Parameters:
x - x-position of the lower-left corner of the text
y - y-position of the lower-left corner of the text

setKey

public void setKey(int key_type,
                   double key_size,
                   java.awt.Color key_color)
Sets a key

Parameters:
key_type - type of the key. 0 means a box
key_size - size (i.e. length) a key in terms of character width
key_color - color of the key

setLineWidth

public void setLineWidth(int key_line_width)
Sets key line width

Parameters:
key_line_width - line width of the key

setKeySpace

public void setKeySpace(double key_space)
Sets a space between the key and the text describing the key

Parameters:
key_space - key space in terms of character width

getKeySpace

public double getKeySpace()
Get a space between the key and the text describing the key

Returns:
key space in terms of character width

getLineWidth

public double getLineWidth()
Get a key line width

Returns:
key line width

getKeyType

public int getKeyType()
Get key type

Returns:
key type

getKeyColor

public java.awt.Color getKeyColor()
Get key color

Returns:
key color

getKeySize

public float getKeySize()
Get key size

Returns:
key size

setLocation

public void setLocation(double x,
                        double y,
                        java.lang.String howToSet)
Sets the location of the label in data coordinates. Ones set this way, you cannot plot the label, it must first define the location in pixel-coordinates (setLocation(x,y));

Parameters:
x - x-position of the lower-left corner of the text
y - y-position of the lower-left corner of the text
howToSet - set it to "NDC" for normalized coordinates (in the range 0-1). This is a data independent position set it to "USER" for the user coordinates

getPositionCoordinate

public int getPositionCoordinate()
Is the position set?

Returns:
zero if location is not defined of unity if the position is defined in the NDC system 2 if the location is defined in the user coordinates

getX

public double getX()
Returns the X position of the text.

Returns:
the x-position of the text

getY

public double getY()
Returns the Y position of the text.

Returns:
the y-position of the text

getGraphLabel

public jplot.GraphLabel getGraphLabel()
Get a label with default attributes

Returns:
get GraphLabel


jHepWork 2.8 (©) S.Chekanov