• Home
• net.sourceforge.plantuml
• plantuml
• 1.2024.1
• source code
• BasicGraphicAttributes.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

jcckit.graphic.BasicGraphicAttributes Maven / Gradle / Ivy

/*
 * Copyright 2003-2004, Franz-Josef Elmer, All rights reserved
 *
 * This library is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation; either version 2.1 of the License, or
 * (at your option) any later version.
 *
 * This program 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 Lesser General Public License for more details
 * (http://www.gnu.org/copyleft/lesser.html).
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
package jcckit.graphic;

import java.awt.Color;

import jcckit.util.ConfigParameters;

/**
 * The basic attributes of any {@link BasicGraphicalElement}. This is an
 * extension of {@link ShapeAttributes} implementing {@link TextAttributes}.
 *
 * @author Franz-Josef Elmer
 */
public class BasicGraphicAttributes extends ShapeAttributes
                                    implements TextAttributes {
  /** Configuration parameter key. */
  public static final String TEXT_COLOR_KEY = "textColor",
                             FONT_NAME_KEY = "fontName",
                             FONT_STYLE_KEY = "fontStyle",
                             FONT_SIZE_KEY = "fontSize",
                             HORIZONTAL_ANCHOR_KEY = "horizontalAnchor",
                             VERTICAL_ANCHOR_KEY = "verticalAnchor",
                             ORIENTATION_ANGLE_KEY = "orientationAngle";

  private final Color _textColor;
  private final String _fontName;
  private final FontStyle _fontStyle;
  private final double _fontSize;
  private final double _orientationAngle;
  private final Anchor _horizontalAnchor;
  private final Anchor _verticalAnchor;

  /**
   * Creates a new instance based on the specified configuration
   * parameters.
   * 
   * 
   *     
   * 
   *     
   * 
   *     
   * 
   *     
   * 
   *     
   * 
   *     
   *     
   * 
   *     
   * 
   *     
   * 
Key & Default Value
Type
Mandatory
Description
textColor = default foreground color of the
   *     renderer
Color
no
The text color.
fontName = default font name of the
   *     renderer
String
no
The name of the text font. The standard Java font name
   *         "Serif", "SansSerif", and "Monospaced" can be used.
   *         Other font names depend on the actual {@link Renderer}
   *         rendering the corresponding {@link BasicGraphicalElement}.
   *         
fontStyle = normal
String
   *     
no
The font style. Possible values are:
   *     
normal
bold
italic
   *     
bold italic
   *     
fontSize = default font size of the
   *     renderer
double
no
The font size in units of the device-independent
   *     coordinates.
orientationAngle = 0
double
no
The orientation angle of the text (in degree).
   *     Zero means normal orientation whereas a positive value means
   *     a rotation in counter-clockweise direction.
horizontalAnchor = left
String
   *     
no
Anchor for horizontal text position. Possible values are
   *     left, center, and right.
verticalAnchor = center
String
   *     
no
Anchor for vertical text position. Possible values are
   *     top, center, and bottom.
   * Additional configuration parameters are explained in the
   * {@link ShapeAttributes#ShapeAttributes constructor}
   * of the superclass {@link ShapeAttributes}.
   */
  public BasicGraphicAttributes(ConfigParameters config) {
    super(config);
    _textColor = config.getColor(TEXT_COLOR_KEY, null);
    _fontName = config.get(FONT_NAME_KEY, null);
    _fontStyle = FontStyle.getFontStyle(config, FONT_STYLE_KEY,
                                        FontStyle.NORMAL);
    _fontSize = config.getDouble(FONT_SIZE_KEY, 0);
    _orientationAngle = config.getDouble(ORIENTATION_ANGLE_KEY, 0);

    _horizontalAnchor = Anchor.getHorizontalAnchor(config,
                                  HORIZONTAL_ANCHOR_KEY, Anchor.LEFT_BOTTOM);
    _verticalAnchor = Anchor.getVerticalAnchor(config,
                                  VERTICAL_ANCHOR_KEY, Anchor.CENTER);
  }

  /**
   * Creates a new instance.
   * @param fillColor The fill color. May be null.
   * @param lineColor The line color. May be null.
   * @param lineThickness Thickness of the line.
   *        Negative numbers will be trimmed to zero.
   * @param linePattern Line pattern. May be null.
   * @param textColor The text color. May be null.
   * @param fontName The font name. May be null.
   * @param fontStyle The font style. May be null.
   * @param fontSize The font size in units of the device-independent
   *        coordinates. May be null.
   * @param orientationAngle Orientation angle of the text.
   * @param horizontalAnchor Horizontal text anchor.
   * @param verticalAnchor Vertical text anchor.
   */
  public BasicGraphicAttributes(Color fillColor, Color lineColor,
                                double lineThickness,
                                double[] linePattern, Color textColor,
                                String fontName, FontStyle fontStyle,
                                double fontSize, double orientationAngle,
                                Anchor horizontalAnchor,
                                Anchor verticalAnchor) {
    super(fillColor, lineColor, lineThickness, linePattern);
    _textColor = textColor;
    _fontName = fontName;
    _fontStyle = fontStyle;
    _fontSize = fontSize;
    _orientationAngle = orientationAngle;
    _horizontalAnchor = horizontalAnchor;
    _verticalAnchor = verticalAnchor;
  }

  /**
   *  Returns the text color.
   *  @return null means default color of the renderer.
   */
  public Color getTextColor() {
    return _textColor;
  }

  /**
   *  Returns the font name.
   *  @return null means default font name of the renderer.
   */
  public String getFontName() {
    return _fontName;
  }

  /**
   *  Returns the font style.
   *  @return null means default font style of the renderer.
   */
  public FontStyle getFontStyle() {
    return _fontStyle;
  }

  /**
   *  Returns the font size in units of the device-independent coordinates.
   */
  public double getFontSize() {
    return _fontSize;
  }

  /**
   *  Returns the orientation angle in degree. Zero means
   *  normal text orientation. Any positive angle means a
   *  counter-clockwise rotation of the text.
   */
  public double getOrientationAngle() {
    return _orientationAngle;
  }

  /**
   *  Returns the anchor for horizontal position of the text.
   *  Note, that the anchor is related to the text before
   *  it is rotated by the orientation angle.
   *  @return one of the three instances of Anchor.
   */
  public Anchor getHorizontalAnchor() {
    return _horizontalAnchor;
  }

  /**
   *  Returns the anchor for vertical position of the text.
   *  Note, that the anchor is related to the text before
   *  it is rotated by the orientation angle.
   *  @return one of the three instances of Anchor.
   */
  public Anchor getVerticalAnchor() {
    return _verticalAnchor;
  }
}