acm.graphics

Class G3DRect

java.lang.Object

acm.graphics.GObject

acm.graphics.GRect

acm.graphics.G3DRect

All Implemented Interfaces:

GFillable, GResizable, GScalable, java.lang.Cloneable

public class G3DRect
extends GRect

The G3DRect class is used to represent a rectangle whose borders are drawn to create a three-dimensional effect. The G3DRect class is a subclass of GRect, and therefore implements all the methods defined for that class. In addition, the G3DRect class supports the following methods:

void setRaised(boolean raised) Sets the G3DRect to appear raised or lowered as specified by the parameter boolean isRaised() Returns true if this G3DRect is raised.

The appearance of a G3DRect object depends on the system on which it is displayed and is typically more effective if the G3DRect is filled.

To use the G3DRect class, the first step is to construct a new G3DRect object and add it to an existing GCanvas (assumed here to be stored in the variable gc), as follows: G3DRect rect = new G3DRect(100, 75, 150, 50); gc.add(rect); This code creates a G3DRect with the specified dimensions and installs the label in the GCanvas as shown in the figure to the right.

Constructor Summary

Constructors

Constructor and Description
G3DRect(double width, double height) Constructs a new 3D rectangle with the specified width and height, positioned at the origin.
G3DRect(double x, double y, double width, double height) Constructs a new 3D rectangle with the specified bounds.
G3DRect(double x, double y, double width, double height, boolean raised) Constructs a new 3D rectangle with the specified bounds which is raised if the final parameter is true.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isRaised() Tests whether this object appears raised.
void	paint(java.awt.Graphics g) Implements the paint operation for this graphical object.
void	setRaised(boolean raised) Sets whether this object appears raised.

Methods inherited from class acm.graphics.GRect

getBounds, getFillColor, getHeight, getSize, getWidth, isFilled, scale, scale, setBounds, setBounds, setFillColor, setFilled, setSize, setSize

Methods inherited from class acm.graphics.GObject

addActionListener, addMouseListener, addMouseMotionListener, contains, contains, fireActionEvent, fireActionEvent, getColor, getLocation, getParent, getX, getY, isVisible, move, movePolar, pause, removeActionListener, removeMouseListener, removeMouseMotionListener, sendBackward, sendForward, sendToBack, sendToFront, setColor, setLocation, setLocation, setParent, setVisible, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

G3DRect

public G3DRect(double width,
       double height)

Constructs a new 3D rectangle with the specified width and height, positioned at the origin.

Parameters:

width - The width of the rectangle in pixels

height - The height of the rectangle in pixels

G3DRect

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

Constructs a new 3D rectangle 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 rectangle in pixels

height - The height of the rectangle in pixels

G3DRect

public G3DRect(double x,
       double y,
       double width,
       double height,
       boolean raised)

Constructs a new 3D rectangle with the specified bounds which is raised if the final parameter is true.

Parameters:

x - The x-coordinate of the upper left corner

y - The y-coordinate of the upper left corner

width - The width of the rectangle in pixels

height - The height of the rectangle in pixels

raised - true if this rectangle should appear raised

Method Detail

paint

public void paint(java.awt.Graphics g)

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

Overrides:

paint in class GRect

Parameters:

g - The graphics context into which the painting is done

setRaised

public void setRaised(boolean raised)

Sets whether this object appears raised.

Parameters:

raised - true if the object appears raised, false otherwise

isRaised

public boolean isRaised()

Tests whether this object appears raised.

Returns:

true if the object appears raised, false otherwise