Class CheckerBoard is a standalone utility that permits
* a user to interactively compare two colors. The user may pick a pair
* colors using two ColorView panes and the utility will show
* these colors in a checkerboard pattern that enables comparison.
Colors may be entered in the following ways:
* *ColorView dropdown list.The default constructor creates a checkerboard with default settings * and installs the checkerboard in a frame.
* *Using the general constructor, one can control settings, choose whether * to show the interactive controls, and whether to frame the panel.
* *Since the checkerboard is painted on the bit map layer of a
* BufferedPanel, one may add Paintable objects to
* the paintable sequence layer that is painted above the bit map. In this
* way, it is possible to add "game pieces" such as checkers or chess pieces
* to this panel and use external code to control these game pieces.
The constructor that opens the checkerboard application in a frame * using the default block size and default colors.
* *Since this constructor opens the checkerboard in a frame, the panel * cannot be inserted into another GUI component. To obtain only a panel * and to control all parameters, use the other constructor.
*/ public CheckerBoard() { this(BLOCK, null, null, true, true); } /** *The constructor that permits the caller to control the size of the
* checkerboard block (within limits), the initial block colors, whether
* to show the interactive color controls, and whether to automatically
* put the checkerboard into a JPTFrame.
Returns a reference to the checkerboard BufferedPanel
* on which the checkerboard is painted.
This permits the user to add Paintable objects such as
* "game pieces" to the paintable sequence layer of the checkerboard.
Returns the checkerboard block size.
* *The checkerboard panel has size equal to 8 times the block size.
*/ public final int getBlockSize() { return block; } /** *Returns the checkerboard BufferedPanel size.
The checkerboard panel has size equal to 8 times the block size.
* *The caller should not modify the BufferedPanel size
* using calls from the BufferedPanel class.
Sets the color for blocks with (row + column) sum even * to the given color.
* *Does nothing if the given color is Sets the color for blocks with (row + column) sum odd
* to the given color. Does nothing if the given color is null
*
* @param color0 color for blocks with (row + column) sum even
*/
public final void setColor0(Color color0) {
if (color0 != null)
view0.setColor(color0);
}
/**
* null
*
* @param color1 color for blocks with (row + column) sum odd
*/
public final void setColor1(Color color1) {
if (color1 != null)
view1.setColor(color1);
}
/** Resets the colors to their original settings. */
public final void resetColorViews() {
view0.reset();
view1.reset();
}
/** Adjust the block size to lie between the minimum and maximum. */
private final int adjustBlock(int block) {
if (block < MINIMUM_BLOCK)
return MINIMUM_BLOCK;
else
if (block > MAXIMUM_BLOCK)
return MAXIMUM_BLOCK;
else
return block;
}
/** Create the checker board and the blocks data structure. */
private final void createCheckerBoard(int block) {
block = adjustBlock(block);
this.block = block;
int size = 8 * block;
window = new BufferedPanel(size, size);
for (int row = 0; row < 8; row++)
for (int col = 0; col < 8; col++)
blocks[row][col] =
new Rectangle2D.Double
(col * block, row * block, block, block);
}
/**
* Create the color views with the given original colors.
*
* @param color0 color for blocks with (row + column) sum even
* @param color1 color for blocks with (row + column) sum odd
*/
private final void createColorViews(Color color0, Color color1) {
if (color0 == null)
color0 = COLOR0;
if (color1 == null)
color1 = COLOR1;
view0 = new ColorView(color0);
view1 = new ColorView(color1);
view0.addAction(colorCheckerBoard);
view1.addAction(colorCheckerBoard);
}
/** Install the contents in this panel. */
private final void installContents(boolean showColorViews) {
addObject(window, 0, 0);
if (showColorViews) {
addObject(view0, 1, 0);
addObject(view1, 2, 0);
addObject(resetColorViews, 3, 0);
}
}
/** Auto frame if desired. */
private final void autoFramePanel(boolean autoFrame) {
if (autoFrame)
frame("Checker Board");
}
/** The method to color the checkerboard patten. */
protected final void colorCheckerBoard() {
window.clearPanel();
Graphics2D graphics = window.getBufferGraphics();
Color[] colors = new Color[] { view0.getColor(), view1.getColor() };
for (int row = 0; row <= 7; row++)
for (int col = 0; col <= 7; col++) {
graphics.setPaint(colors[(row + col) % 2]);
graphics.fill(blocks[row][col]);
}
window.repaint();
}
}