gishur.gui2.painter
Class SquarePointPainter

java.lang.Object
  |
  +--gishur.gui2.Painter
        |
        +--gishur.gui2.painter.SquarePointPainter

public class SquarePointPainter
extends Painter

A Painter for points of square shape. RoundPointPainters are created by RoundPointStyles. One of their tasks is to calculate the size of the screen which has to be drawn if an object using this SquarePointPainter must be redrawn. For this purpose, the method recalculate(gishur.gui2.RenderContext, gishur.gui2.PropertyStatusReader, gishur.core.Parameters) must be called with the point's properties, location etc. as arguments. The other task is to perform the drawing operation with draw(java.awt.Graphics, gishur.gui2.RenderContext, gishur.gui2.PropertyStatusReader, byte), using the DrawProperties of the calling object. These properties, settable with DrawAtom.setProperty(java.lang.String, java.lang.Object), determine the point's apperance, e.g. its filling colour, border color, border width, visiblity etc. Here is an overview of the properties used by a SquarePointPainter:

Properties Summary
Key Value Type Default value Meaning
color java.awt.Color java.awt.red The colour of the inner area of this point.
outline.visible java.lang.Boolean true Defines whether the border of the inner coloured area of this point shall be visible on the screen or not.
outline.width java.lang.Integer 1 Defines the width in pixels of the border of the inner coloured area of this point. Setting this value to zero has the same effect like setting outline.visible to false.
outline.color java.awt.Color java.awt.Color.black The colour of the border of the inner coloured area of this point.
border.visible java.lang.Boolean false If this property is set to true, a one-pixel border will drawn all around this point.
border.color java.awt.Color java.awt.Color.yellow The colour of the optional one-pixel border around the point.
width java.lang.Integer 10 The length of one side of the square shape of this point measured in pixels.

Version:
1.0
Author:
Christoph Sachse

Fields inherited from class gishur.gui2.Painter
LEVEL_0, LEVEL_1, LEVEL_2, LEVEL_3, LEVEL_ALL, LEVEL_BITS_USED, LEVEL_DEFAULT, LEVEL_FIRST, LEVEL_LAST, LOCATEABLE, VISIBLE
 
Constructor Summary
SquarePointPainter()
          Empty and only constructor.
 
Method Summary
 void draw(java.awt.Graphics g, RenderContext context, PropertyStatusReader prop, byte level)
          Draws the specified level of this Painter using the given Graphics object and RenderContext for drawing, and the given PropertyStatusReader for reading properties.
protected  void recalculate(RenderContext context, PropertyStatusReader prop, Parameters param)
          Recalculates this Painter using the given RenderContext, PropertyStatusReader, local point information and other parameters.
 
Methods inherited from class gishur.gui2.Painter
addBounds, addBounds, alignTo, alignTo, calculateDockingPoint, contains, getAlignmentPoint, getRelativeAlignmentPoint, height, isOnLevel, level, locateable, name, outline, reshape, setBounds, setBounds, setLevel, setLocation, setName, setOutline, setSubTypePrefix, style, visible, width, x, y
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SquarePointPainter

public SquarePointPainter()
Empty and only constructor. It only creates a RectangleShape-object which will furthermore store the size of this point and provide special drawing functionality.
Method Detail

recalculate

protected void recalculate(RenderContext context,
                           PropertyStatusReader prop,
                           Parameters param)
Recalculates this Painter using the given RenderContext, PropertyStatusReader, local point information and other parameters.
Overrides:
recalculate in class Painter
Parameters:
context - the RenderContext to use
prop - the PropertyStatusReader to use for reading properties
param - a Parameters-object for location and other parameters parsed by the DisplayObject, that uses this Painter.

draw

public void draw(java.awt.Graphics g,
                 RenderContext context,
                 PropertyStatusReader prop,
                 byte level)
Draws the specified level of this Painter using the given Graphics object and RenderContext for drawing, and the given PropertyStatusReader for reading properties.
Overrides:
draw in class Painter
Parameters:
g - the Graphics to draw on
context - the RenderContext to use
prop - the PropertyStatusReader to use for reading properties
level - the level to draw