Package edu.hws.jcm.draw
Class DrawGeometric
java.lang.Object
edu.hws.jcm.draw.Drawable
edu.hws.jcm.draw.DrawGeometric
- All Implemented Interfaces:
Computable
,Serializable
- Direct Known Subclasses:
Crosshair
,TangentLine
A DrawGeometric object is a geometic figure such as a line or rectangle that can
be drawn in a CoordinateRect. The data for the object always consists of four
numbers, which are interpreted differenetly depending on the object. These numbers
can be specified as Value objects. A DrawGeometric is a Computable, and the
Values will be re-computed when its compute() method is called. It should be
added to a Controller that can respond to any changes in the data that define
the Values. If one of the Value objects has an undefined value, nothing will be drawn.
The type of object is given as one of the constants defined in this class: LINE_ABSOLUTE, OVAL_RELATIVE, CROSS, and so on. In the descriptions of these constants, x1, x2, y1, and y2 refer to the values of Value objects that provide data for the DrawGeomentric while h and v refer to int's that can be specified in place of x2 and y2 for certain types of figures. For those figures, h or v is used if x2 or y2, respectively, is null.
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected double
Value of x1.protected double
Value of y1.protected double
Value of x2.protected Color
Color of the shappe.static final int
Specifies a cross centered on the point (x1,y1).protected double
Value of y2.protected Color
Rects and ovals are filled with this color, if it is non-null.protected int
Integer that gives horizontal pixel offset from x1.static final int
Specifies a line that extends through the points (x1,y1) and (x2,y2) and beyond.static final int
Specifies an infinite line through (x1,y1) and (x1+x2,y1+y2), or through (x1,y1) and (x1+h,y1+v) if x2,y2 are null.static final int
Specifies a line segment from (x1,y1) to (x2,y2).static final int
Specifies a line segment centered on (x1,y1).static final int
Specifies a line segment from (x1,y1) to (x1+x2,y1+y2), or to (x1+h,y1+v) if x2,y2 are null.protected int
The width, in pixels, of lines, including the outlines of rects and ovals.static final int
Specifies an oval that just fits in the rectangle with corners at (x1,y1) and (x2,y2).static final int
Specifies an oval that just fits inside the rect specified by RECT_CENTERED.static final int
Specifies an oval that just fits inside the rect specified by RECT_RELATIVE.static final int
Specifies a rectangle with corners at (x1,y1) and (x2,y2).static final int
Specifies a Rectangle centered on (x1,y1).static final int
Specifies a rectangle with one corner at (x1,y1), and with width given by x2, or h if if x2 is null, and with height given by y2, or by v if y2 is null.protected int
One of the constants such as OVAL_CENTERED, specifying the shape to be drawnprotected int
Integer that gives vertical pixel offset fromy1.protected Value
One of the Value objects that determine the shape that is drawn.protected Value
One of the Value objects that determine the shape that is drawn.protected Value
One of the Value objects that determine the shape that is drawn.protected Value
One of the Value objects that determine the shape that is drawn. -
Constructor Summary
ConstructorsConstructorDescriptionCreate a DrawGeometric object.DrawGeometric
(int shape, Value x1, Value y1, int h, int v) Create a DrawGeometric with a specified shape and values.DrawGeometric
(int shape, Value x1, Value y1, Value x2, Value y2) Create a DrawGeometric with the specified shape and values for x1,x2,y1,y2 Any of the shapes makes sense in this context. -
Method Summary
Modifier and TypeMethodDescriptionvoid
compute()
Recompute the values that define the size/postion of the DrawGeometric.void
Do the drawing.getColor()
Get the non-null color that is used for drawing the shape.Get the color that is used for filling ovals and rects.int
getH()
Get the horizontal offset from (x1,y1).int
Get the width, in pixels, of lines that are drawn.int
getV()
Get the vertical offset from (x1,y1).getX1()
Get the value that gives the x-coordinate of the first point that determines the shape.getX2()
Get the value that gives the x-coordinate of the second point that determines the shape.getY1()
Get the value that gives the y-coordinate of the first point that determines the shape.getY2()
Get the value that gives the y-coordinate of the second point that determines the shape.void
Set the color that is used for drawing the shape.void
Set the color that is used for filling ovals and rects.void
setH
(int x) Set the integer that gives the horizontal offset from (x1,y1).void
setLineWidth
(int width) Set the width, in pixels, of lines that are drawn.void
Set the values that specify a point (x1,y1) and an offset (h,v) from that point.void
Set the Value objects that specify the two points that determine the shape.void
setShape
(int shape) Set the shape, which should be given as one of the shape constants such as LINE_ABSOLUTE or CROSS.void
setV
(int y) Set the integer that gives the vertical offset from (x1,y1).void
Set the value that gives the x-coordinate of the first point that determines the shape.void
Set the value that gives the x-coordinate of the second point that determines the shape.void
Set the value that gives the y-coordinate of the first point that determines the shape.void
Set the value that gives the y-coordinate of the second point that determines the shape.Methods inherited from class edu.hws.jcm.draw.Drawable
getVisible, needsRedraw, setOwnerData, setVisible
-
Field Details
-
LINE_ABSOLUTE
public static final int LINE_ABSOLUTESpecifies a line segment from (x1,y1) to (x2,y2).- See Also:
-
INFINITE_LINE_ABSOLUTE
public static final int INFINITE_LINE_ABSOLUTESpecifies a line that extends through the points (x1,y1) and (x2,y2) and beyond.- See Also:
-
RECT_ABSOLUTE
public static final int RECT_ABSOLUTESpecifies a rectangle with corners at (x1,y1) and (x2,y2).- See Also:
-
OVAL_ABSOLUTE
public static final int OVAL_ABSOLUTESpecifies an oval that just fits in the rectangle with corners at (x1,y1) and (x2,y2).- See Also:
-
LINE_RELATIVE
public static final int LINE_RELATIVESpecifies a line segment from (x1,y1) to (x1+x2,y1+y2), or to (x1+h,y1+v) if x2,y2 are null. (Note that h,v are given in terms of pixels while x1,x2,y1,y2 are given in terms of the CoordinateRect. If you use h,v, you get a line of a fixed size and direction.)- See Also:
-
INFINITE_LINE_RELATIVE
public static final int INFINITE_LINE_RELATIVESpecifies an infinite line through (x1,y1) and (x1+x2,y1+y2), or through (x1,y1) and (x1+h,y1+v) if x2,y2 are null.- See Also:
-
RECT_RELATIVE
public static final int RECT_RELATIVESpecifies a rectangle with one corner at (x1,y1), and with width given by x2, or h if if x2 is null, and with height given by y2, or by v if y2 is null.- See Also:
-
OVAL_RELATIVE
public static final int OVAL_RELATIVESpecifies an oval that just fits inside the rect specified by RECT_RELATIVE.- See Also:
-
LINE_CENTERED
public static final int LINE_CENTEREDSpecifies a line segment centered on (x1,y1). The amount it extends in each direction is given by x2,y2 or by h,v- See Also:
-
RECT_CENTERED
public static final int RECT_CENTEREDSpecifies a Rectangle centered on (x1,y1). The amount it extends in each direction is given by x2,y2 or by h,v. (Thus, x2 or h is the HALF-width and y2 or v is the HALF-height.)- See Also:
-
OVAL_CENTERED
public static final int OVAL_CENTEREDSpecifies an oval that just fits inside the rect specified by RECT_CENTERED.- See Also:
-
CROSS
public static final int CROSSSpecifies a cross centered on the point (x1,y1). Its arms extend horizontally by a distance of x2, or h, in each direction. Its vertical arms extend y2, or v, in each direction.- See Also:
-
shape
protected int shapeOne of the constants such as OVAL_CENTERED, specifying the shape to be drawn -
x1
One of the Value objects that determine the shape that is drawn. The shape is specified by two points, (x1,y1) and (x2,y2). x1 must be non-null. -
x2
One of the Value objects that determine the shape that is drawn. The shape is specified by two points, (x1,y1) and (x2,y2). x2 must be non-null for the "ABSOLUTE" shapes. (If not, they revert to "RELATIVE" shapes and use h,v as the offset values.) -
y1
One of the Value objects that determine the shape that is drawn. The shape is specified by two points, (x1,y1) and (x2,y2). y1 must be non-null. -
y2
One of the Value objects that determine the shape that is drawn. The shape is specified by two points, (x1,y1) and (x2,y2). y2 must be non-null for the "ABSOLUTE" shapes. (If not, they revert to "RELATIVE" shapes and use h,v as the offset values.) -
h
protected int hInteger that gives horizontal pixel offset from x1. This is only used if x2 is null. -
v
protected int vInteger that gives vertical pixel offset fromy1. This is only used if y2 is null. -
a
protected double aValue of x1. This is re-computed when the compute() method is called. -
b
protected double bValue of y1. This is re-computed when the compute() method is called. -
c
protected double cValue of x2. This is re-computed when the compute() method is called. -
d
protected double dValue of y2. This is re-computed when the compute() method is called. -
color
Color of the shappe. Color will be black if this is null. For shapes that have "insides", such as rects, this is the color of the outline. -
fillColor
Rects and ovals are filled with this color, if it is non-null. If this is null, only the outline of the shape is drawn. -
lineWidth
protected int lineWidthThe width, in pixels, of lines, including the outlines of rects and ovals. It is restricted to being an integer in the range from 0 to 10. A value of 0 means that lines won't be drawn at all; this would only be useful for a filled shape that has a colored interior.
-
-
Constructor Details
-
DrawGeometric
public DrawGeometric()Create a DrawGeometric object. By default, it is a LINE_ABSOLUTE. However, nothing will be drawn as long as x1,y1,x2,y2 are null. -
DrawGeometric
Create a DrawGeometric with the specified shape and values for x1,x2,y1,y2 Any of the shapes makes sense in this context.- Parameters:
shape
- One of the shape constants such as LINE_ABSOLUTE or RECT_RELATIVE.
-
DrawGeometric
Create a DrawGeometric with a specified shape and values. The last two parameters give pixel offsets from x1,y1. The "ABSOLUTE" shapes don't make sense in this context. (They will be treated as the corresponding "RELATIVE" shapes.)- Parameters:
shape
- One of the "RELATIVE" or "CENTERED" shape constants such as LINE_RELATIVE or OVAL_CENTERED or CROSS.
-
-
Method Details
-
setShape
public void setShape(int shape) Set the shape, which should be given as one of the shape constants such as LINE_ABSOLUTE or CROSS. -
setPoints
Set the Value objects that specify the two points that determine the shape. The first two parameters, x1 and y1, must be non-null. -
setPoints
Set the values that specify a point (x1,y1) and an offset (h,v) from that point. This only makes sense for RELATIVE shapes. The Value objects x1 and y1 must be non-null -
setX1
Set the value that gives the x-coordinate of the first point that determines the shape. This must be non-null, or nothing will be drawn. -
getX1
Get the value that gives the x-coordinate of the first point that determines the shape. -
setX2
Set the value that gives the x-coordinate of the second point that determines the shape. If this is null, then the value of h is used instead. -
getX2
Get the value that gives the x-coordinate of the second point that determines the shape. -
setY1
Set the value that gives the y-coordinate of the first point that determines the shape. This must be non-null, or nothing will be drawn. -
getY1
Get the value that gives the y-coordinate of the first point that determines the shape. -
setY2
Set the value that gives the y-coordinate of the second point that determines the shape. If this is null, then the value of v is used instead. -
getY2
Get the value that gives the y-coordinate of the second point that determines the shape. -
setH
public void setH(int x) Set the integer that gives the horizontal offset from (x1,y1). This only makes sense for RELATIVE shapes. This method also sets x2 to null, since the h value is only used when x2 is null. -
getH
public int getH()Get the horizontal offset from (x1,y1). -
setV
public void setV(int y) Set the integer that gives the vertical offset from (x1,y1). This only makes sense for RELATIVE shapes. This method also sets y2 to null, since the v value is only used when y2 is null. -
getV
public int getV()Get the vertical offset from (x1,y1). -
setColor
Set the color that is used for drawing the shape. If the color is null, black is used. For shapes that have interiors, such as rects, this is only the color of the outline of the shaape. -
getColor
Get the non-null color that is used for drawing the shape. -
setFillColor
Set the color that is used for filling ovals and rects. If the color is null, only the outline of the shape is drawn. -
getFillColor
Get the color that is used for filling ovals and rects. If null, no fill is done. -
setLineWidth
public void setLineWidth(int width) Set the width, in pixels, of lines that are drawn. This is also used for outlines of rects and ovals. -
getLineWidth
public int getLineWidth()Get the width, in pixels, of lines that are drawn. This is also used for outlines of rects and ovals. -
compute
public void compute()Recompute the values that define the size/postion of the DrawGeometric. This is ordinarily only called by a Controller.- Specified by:
compute
in interfaceComputable
-
draw
Do the drawing. This is not meant to be called directly.- Specified by:
draw
in classDrawable
- Parameters:
g
- The graphics context in which the Drawble is to be drawn. (The drawing can change the color in g, but should not permanently change font, painting mode, etc. Thus, every drawable is responsible for setting the color it wants to use.)coordsChanged
- Indicates whether the CoordinateRect has changed.
-