acm.graphics

Class GOval

java.lang.Object

acm.graphics.GObject

acm.graphics.GOval

All Implemented Interfaces:

GFillable, GResizable, GScalable, java.lang.Cloneable

public class GOval
extends GObject
implements GFillable, GResizable, GScalable

The GOval class is a graphical object whose appearance consists of an oval.

Constructor Summary

Constructors

Constructor and Description
GOval(double width, double height) Constructs a new oval with the specified width and height, positioned at the origin.
GOval(double x, double y, double width, double height) Constructs a new oval with the specified bounds.

Method Summary

Modifier and Type	Method and Description
boolean	contains(double x, double y) Checks to see whether a point is inside the object.
protected java.awt.Rectangle	getAWTBounds() Returns an AWT Rectangle that specifies the bounds of this object.
GRectangle	getBounds() Returns the bounding box of this object.
java.awt.Color	getFillColor() Returns the color used to display the filled region of this object.
double	getHeight() Returns the height of this object as a double-precision value, which is defined to be the height of the bounding box.
GDimension	getSize() Returns the size of this object as a GDimension.
double	getWidth() Returns the width of this object as a double-precision value, which is defined to be the width of the bounding box.
boolean	isFilled() Returns whether this object is filled.
void	paint(java.awt.Graphics g) Implements the paint operation for this graphical object.
void	scale(double sf) Scales the object on the screen by the scale factor sf, which applies in both dimensions.
void	scale(double sx, double sy) Scales the object on the screen by the scale factors sx and sy.
void	setBounds(double x, double y, double width, double height) Changes the bounds of this object to the specified values.
void	setBounds(GRectangle bounds) Changes the bounds of this object to the values from the specified Rectangle.
void	setFillColor(java.awt.Color color) Sets the color used to display the filled region of this object.
void	setFilled(boolean fill) Sets whether this object is filled.
void	setSize(double width, double height) Changes the size of this object to the specified width and height.
void	setSize(GDimension size) Changes the size of this object to the specified GDimension.

Methods inherited from class acm.graphics.GObject

addActionListener, addMouseListener, addMouseMotionListener, areMouseListenersEnabled, colorName, contains, fireActionEvent, fireActionEvent, fireMouseListeners, getColor, getComponent, getLocation, getObjectColor, getParent, getX, getY, isVisible, move, movePolar, paintObject, paramString, pause, removeActionListener, removeMouseListener, removeMouseMotionListener, repaint, sendBackward, sendForward, sendToBack, sendToFront, setColor, setLocation, setLocation, setParent, setVisible, start, start, toString, updateEnabledList

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

GOval

public GOval(double width,
             double height)

Constructs a new oval with the specified width and height, positioned at the origin.

Parameters:

width - The width of the oval in pixels

height - The height of the oval in pixels

GOval

public GOval(double x,
             double y,
             double width,
             double height)

Constructs a new oval with the specified bounds.

Parameters:

x - The x-coordinate of the upper left corner

y - The y-coordinate of the upper left corner

width - The width of the oval in pixels

height - The height of the oval in pixels

Method Detail

contains

public boolean contains(double x,
                        double y)

Checks to see whether a point is inside the object.

Overrides:

contains in class GObject

Parameters:

x - The x-coordinate of the point being tested

y - The y-coordinate of the point being tested

Returns:

true if the point (x, y) is inside the object, and false otherwise

paint

public void paint(java.awt.Graphics g)

Implements the paint operation for this graphical object. This method is not called directly by clients.

Specified by:

paint in class GObject

Parameters:

g - The graphics context into which the painting is done

setFilled

public void setFilled(boolean fill)

Sets whether this object is filled.

Specified by:

setFilled in interface GFillable

Parameters:

fill - true if the object should be filled, false for an outline

isFilled

public boolean isFilled()

Returns whether this object is filled.

Specified by:

isFilled in interface GFillable

Returns:

The color used to display the object

setFillColor

public void setFillColor(java.awt.Color color)

Sets the color used to display the filled region of this object.

Specified by:

setFillColor in interface GFillable

Parameters:

color - The color used to display the filled region of this object

getFillColor

public java.awt.Color getFillColor()

Returns the color used to display the filled region of this object. If none has been set, getFillColor returns the color of the object.

Specified by:

getFillColor in interface GFillable

Returns:

The color used to display the filled region of this object

setSize

public void setSize(double width,
                    double height)

Changes the size of this object to the specified width and height.

Specified by:

setSize in interface GResizable

Parameters:

width - The new width of the object

height - The new height of the object

setSize

public final void setSize(GDimension size)

Changes the size of this object to the specified GDimension.

Specified by:

setSize in interface GResizable

Parameters:

size - A GDimension object specifying the size

getSize

public GDimension getSize()

Returns the size of this object as a GDimension.

Overrides:

getSize in class GObject

Returns:

The size of this object

setBounds

public void setBounds(double x,
                      double y,
                      double width,
                      double height)

Changes the bounds of this object to the specified values.

Specified by:

setBounds in interface GResizable

Parameters:

x - The new x-coordinate for the object

y - The new y-coordinate for the object

width - The new width of the object

height - The new height of the object

setBounds

public final void setBounds(GRectangle bounds)

Changes the bounds of this object to the values from the specified Rectangle.

Specified by:

setBounds in interface GResizable

Parameters:

bounds - A GRectangle specifying the new bounds

getBounds

public GRectangle getBounds()

Returns the bounding box of this object.

Specified by:

getBounds in class GObject

Returns:

The bounding box for this object

getWidth

public double getWidth()

Returns the width of this object as a double-precision value, which is defined to be the width of the bounding box.

Overrides:

getWidth in class GObject

Returns:

The width of this object on the screen

getHeight

public double getHeight()

Returns the height of this object as a double-precision value, which is defined to be the height of the bounding box.

Overrides:

getHeight in class GObject

Returns:

The height of this object on the screen

scale

public void scale(double sx,
                  double sy)

Scales the object on the screen by the scale factors sx and sy.

Specified by:

scale in interface GScalable

Parameters:

sx - The factor used to scale all coordinates in the x direction

sy - The factor used to scale all coordinates in the y direction

scale

public final void scale(double sf)

Scales the object on the screen by the scale factor sf, which applies in both dimensions.

Specified by:

scale in interface GScalable

Parameters:

sf - The factor used to scale all coordinates in both dimensions

getAWTBounds

protected java.awt.Rectangle getAWTBounds()

Returns an AWT Rectangle that specifies the bounds of this object.

Returns:

A Rectangle that specifies the bounds of this object