dev.roanh.convexmerger.ui

Class Screen

java.lang.Object

dev.roanh.convexmerger.ui.Screen

Direct Known Subclasses:

GamePanel, InfoMenu, JoinMenu, MainMenu, NewGameMenu

public abstract class Screen
extends java.lang.Object

Base class for all screens containing shared rendering subroutines.

Field Summary

Fields

Modifier and Type	Field and Description
static int	BOTTOM_OFFSET Offset from the bottom to the playfield rectangle.
static int	BOX_HEADER_HEIGHT Height of a box title header.
static int	BOX_INSETS Inset into a drawn box and also the corner triangle size.
static int	BOX_SPACING Space between the boxes.
static int	BOX_TEXT_OFFSET Text offset from the side of a box.
private static int	BUTTON_HEIGHT Height of the buttons in the bottom left and right.
private static int	BUTTON_WIDTH Width of the buttons in the bottom left and right.
private ConvexMerger	context The active game context.
private java.awt.geom.Point2D	lastLocation Last mouse location.
private java.awt.Polygon	leftPoly Bottom left button polygon.
private java.awt.Polygon	rightPoly Bottom right button polygon.
static int	SIDE_OFFSET Offset from the side to the playfield rectangle.
static double	SPACING Spacing between various components.
static int	TOP_MIDDLE_OFFSET Height of the middle text area attached to the top part.
static int	TOP_MIDDLE_TEXT_OFFSET Text offset from the bottom in the top middle text area.
static int	TOP_MIDDLE_WIDTH Width of the middle text area attached to the top part.
static int	TOP_OFFSET Offset from the score display part of the game panel to the playfield rectangle.
static int	TOP_SIDE_TRIANGLE Dimensions of the triangles on the left and right side of the top part.
static int	TOP_SPACE Height of the top score display part of the game panel.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Screen(ConvexMerger context) Constructs a new screen with the given game context.

Method Summary

Modifier and Type	Method and Description
protected java.awt.geom.Path2D	computeBox(double x, double y, double w, double h, double inset) Computes the bounds of a box if draw according to the given parameters.
protected void	drawBox(java.awt.Graphics2D g, double x, double y, double w, double h) Draws a box according to the given parameters.
protected java.awt.geom.Path2D	drawButton(java.awt.Graphics2D g, java.lang.String text, double x, double y, double w, double h, java.awt.geom.Point2D mouseLoc) Draws a button at the given location with the given text.
protected void	drawTitle(java.awt.Graphics2D g, int width) Draws the main screen title.
protected void	drawTitledBox(java.awt.Graphics2D g, java.awt.Paint gradient, double x, double y, double w, double h, java.lang.String title) Draws a titled box according to the given parameters.
protected int	fillText(java.awt.Graphics2D g, int rx, int ry, int width, int height, java.util.List<java.lang.String> text) Fills the given area with the given text.
protected ConvexMerger	getContext() Gets the game context this screen is associated with.
protected abstract java.lang.String	getLeftButtonText() Gets the text for the bottom left button.
protected static double	getMaxWidth(int width, double ratio, int max) Computes how wide the content should be given a screen width, width usage ratio and maximum width.
protected abstract java.lang.String	getRightButtonText() Gets the text for the bottom right button.
void	handleKeyPressed(java.awt.event.KeyEvent event) Handles a key press event.
void	handleKeyReleased(java.awt.event.KeyEvent event) Handles a key release event.
protected abstract void	handleLeftButtonClick() Handles the bottom left button being clicked.
void	handleMouseDrag(java.awt.geom.Point2D loc, int width, int height) Handles a mouse move on this screen.
void	handleMouseMove(java.awt.geom.Point2D loc, int width, int height) Handles a mouse move on this screen.
void	handleMousePress(java.awt.geom.Point2D loc, int width, int height) Handles a mouse button press on this screen.
void	handleMouseRelease(java.awt.geom.Point2D loc, int width, int height) Handles a mouse button release on this screen.
protected abstract void	handleRightButtonClick() Handles the bottom right button being clicked.
protected abstract boolean	isLeftButtonEnabled() Checks if the bottom left button is enabled.
protected abstract boolean	isRightButtonEnabled() Checks if the bottom right button is enabled.
void	render(java.awt.Graphics2D g, int width, int height) Renders this screen with the given graphics and dimensions.
protected abstract void	render(java.awt.Graphics2D g, int width, int height, java.awt.geom.Point2D mouseLoc) Renders the content of this screen with the given graphics.
protected void	renderMainInterface(java.awt.Graphics2D g, int width, int height, GameState state) Renders the main interface, the top panel and button left and right buttons.
protected void	renderMenuTitle(java.awt.Graphics2D g, int width, java.lang.String title) Renders a screen sub title.
protected void	switchScene(Screen next) Switches the context from the current screen to the given screen.

Methods inherited from class java.lang.Object

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

Field Detail

TOP_SPACE

public static final int TOP_SPACE

Height of the top score display part of the game panel.

See Also:

Constant Field Values

SIDE_OFFSET

public static final int SIDE_OFFSET

Offset from the side to the playfield rectangle.

See Also:

Constant Field Values

TOP_OFFSET

public static final int TOP_OFFSET

Offset from the score display part of the game panel to the playfield rectangle.

See Also:

Constant Field Values

BOTTOM_OFFSET

public static final int BOTTOM_OFFSET

Offset from the bottom to the playfield rectangle.

See Also:

Constant Field Values

TOP_MIDDLE_WIDTH

public static final int TOP_MIDDLE_WIDTH

Width of the middle text area attached to the top part.

See Also:

Constant Field Values

TOP_MIDDLE_TEXT_OFFSET

public static final int TOP_MIDDLE_TEXT_OFFSET

Text offset from the bottom in the top middle text area.

See Also:

Constant Field Values

TOP_SIDE_TRIANGLE

public static final int TOP_SIDE_TRIANGLE

Dimensions of the triangles on the left and right side of the top part.

See Also:

Constant Field Values

TOP_MIDDLE_OFFSET

public static final int TOP_MIDDLE_OFFSET

Height of the middle text area attached to the top part.

See Also:

Constant Field Values

BUTTON_HEIGHT

private static final int BUTTON_HEIGHT

Height of the buttons in the bottom left and right.

See Also:

Constant Field Values

BUTTON_WIDTH

private static final int BUTTON_WIDTH

Width of the buttons in the bottom left and right.

See Also:

Constant Field Values

BOX_SPACING

public static final int BOX_SPACING

Space between the boxes.

See Also:

Constant Field Values

BOX_INSETS

public static final int BOX_INSETS

Inset into a drawn box and also the corner triangle size.

See Also:

Constant Field Values

BOX_HEADER_HEIGHT

public static final int BOX_HEADER_HEIGHT

Height of a box title header.

See Also:

Constant Field Values

BOX_TEXT_OFFSET

public static final int BOX_TEXT_OFFSET

Text offset from the side of a box.

See Also:

Constant Field Values

SPACING

public static final double SPACING

Spacing between various components.

See Also:

Constant Field Values

rightPoly

private java.awt.Polygon rightPoly

Bottom right button polygon.

leftPoly

private java.awt.Polygon leftPoly

Bottom left button polygon.

lastLocation

private java.awt.geom.Point2D lastLocation

Last mouse location.

context

private ConvexMerger context

The active game context.

Constructor Detail

Screen

protected Screen(ConvexMerger context)

Constructs a new screen with the given game context.

Parameters:

context - The game context.

Method Detail

getContext

protected ConvexMerger getContext()

Gets the game context this screen is associated with.

Returns:

The game context.

switchScene

protected void switchScene(Screen next)

Switches the context from the current screen to the given screen.

Parameters:

next - The screen to switch to.

render

public void render(java.awt.Graphics2D g,
                   int width,
                   int height)

Renders this screen with the given graphics and dimensions.

Parameters:

g - The graphics context to use.

width - The width of the screen.

height - The height of the screen.

render

protected abstract void render(java.awt.Graphics2D g,
                               int width,
                               int height,
                               java.awt.geom.Point2D mouseLoc)

Renders the content of this screen with the given graphics.

Parameters:

g - The graphics context to use.

width - The width of the screen.

height - The height of the screen.

mouseLoc - The current cursor location.

getMaxWidth

protected static double getMaxWidth(int width,
                                    double ratio,
                                    int max)

Computes how wide the content should be given a screen width, width usage ratio and maximum width. So effectively this computes min(ratio * width, max).

Parameters:

width - The width of the screen.

ratio - The fraction of the width to use.

max - The maximum width.

Returns:

The content width.

drawTitle

protected void drawTitle(java.awt.Graphics2D g,
                         int width)

Draws the main screen title.

Parameters:

g - The graphics context to use.

width - The width of the screen.

drawTitledBox

protected void drawTitledBox(java.awt.Graphics2D g,
                             java.awt.Paint gradient,
                             double x,
                             double y,
                             double w,
                             double h,
                             java.lang.String title)

Draws a titled box according to the given parameters.

Parameters:

g - The graphics context to use.

gradient - The gradient to use.

x - The x location of the top left corner of the box.

y - The y location of the top left corner of the box.

w - The width of the box.

h - The height of the box.

title - The header title of the box.

drawBox

protected void drawBox(java.awt.Graphics2D g,
                       double x,
                       double y,
                       double w,
                       double h)

Draws a box according to the given parameters.

Parameters:

g - The graphics context to use.

x - The x location of the top left corner of the box.

y - The y location of the top left corner of the box.

w - The width of the box.

h - The height of the box.

computeBox

protected java.awt.geom.Path2D computeBox(double x,
                                          double y,
                                          double w,
                                          double h,
                                          double inset)

Computes the bounds of a box if draw according to the given parameters.

Parameters:

x - The x location of the top left corner of the box.

y - The y location of the top left corner of the box.

w - The width of the box.

h - The height of the box.

inset - The box insets, see BOX_INSETS.

Returns:

The box bounds.

drawButton

protected java.awt.geom.Path2D drawButton(java.awt.Graphics2D g,
                                          java.lang.String text,
                                          double x,
                                          double y,
                                          double w,
                                          double h,
                                          java.awt.geom.Point2D mouseLoc)

Draws a button at the given location with the given text.

Parameters:

g - The graphics context to use.

text - The button text.

x - The x location of the top left corner of the button.

y - The y location of the top left corner of the button.

w - The width of the button.

h - The height of the button.

mouseLoc - The cursor location or null.

Returns:

The bounds of the drawn button.

renderMenuTitle

protected void renderMenuTitle(java.awt.Graphics2D g,
                               int width,
                               java.lang.String title)

Renders a screen sub title.

Parameters:

g - The graphics context to use.

width - The width of the screen.

title - The sub title to draw.

fillText

protected int fillText(java.awt.Graphics2D g,
                       int rx,
                       int ry,
                       int width,
                       int height,
                       java.util.List<java.lang.String> text)

Fills the given area with the given text. The text is given as a list of words and it is assumed that each word should be separated by a single space. The words automatically get wrapped and no words will go outside the bounding box.

Parameters:

g - The graphics context to use.

rx - The x coordinate of the top left corner of the area.

ry - The y coordinate of the top left corner of the area.

width - The width of the area.

height - The height of the area.

text - The list of words to draw.

Returns:

The y coordinate of the last text baseline used.

renderMainInterface

protected void renderMainInterface(java.awt.Graphics2D g,
                                   int width,
                                   int height,
                                   GameState state)

Renders the main interface, the top panel and button left and right buttons.

Parameters:

g - The graphics context to use.

width - The width of the screen.

height - The height of the screen.

state - The game state to use to determine the gradient to use, can be null.

handleMouseRelease

public void handleMouseRelease(java.awt.geom.Point2D loc,
                               int width,
                               int height)

Handles a mouse button release on this screen. If this method is overridden a super call needs to be made.

Parameters:

loc - The location that was clicked.

width - The width of the screen.

height - The height of the screen.

handleMousePress

public void handleMousePress(java.awt.geom.Point2D loc,
                             int width,
                             int height)

Handles a mouse button press on this screen.

Parameters:

loc - The location that was clicked.

width - The width of the screen.

height - The height of the screen.

handleMouseMove

public void handleMouseMove(java.awt.geom.Point2D loc,
                            int width,
                            int height)

Handles a mouse move on this screen. If this method is overridden a super call needs to be made.

Parameters:

loc - The current cursor location.

width - The width of the screen.

height - The height of the screen.

handleMouseDrag

public void handleMouseDrag(java.awt.geom.Point2D loc,
                            int width,
                            int height)

Handles a mouse move on this screen. If this method is overridden a super call needs to be made.

Parameters:

loc - The current cursor location.

width - The width of the screen.

height - The height of the screen.

handleKeyPressed

public void handleKeyPressed(java.awt.event.KeyEvent event)

Handles a key press event.

Parameters:

event - The key press event.

handleKeyReleased

public void handleKeyReleased(java.awt.event.KeyEvent event)

Handles a key release event.

Parameters:

event - The key release event.

isLeftButtonEnabled

protected abstract boolean isLeftButtonEnabled()

Checks if the bottom left button is enabled.

Returns:

True if the bottom left button is enabled.

isRightButtonEnabled

protected abstract boolean isRightButtonEnabled()

Checks if the bottom right button is enabled.

Returns:

True if the bottom right button is enabled.

getLeftButtonText

protected abstract java.lang.String getLeftButtonText()

Gets the text for the bottom left button.

Returns:

The text for the bottom left button.

getRightButtonText

protected abstract java.lang.String getRightButtonText()

Gets the text for the bottom right button.

Returns:

The text for the bottom right button.

handleLeftButtonClick

protected abstract void handleLeftButtonClick()

Handles the bottom left button being clicked.

handleRightButtonClick

protected abstract void handleRightButtonClick()

Handles the bottom right button being clicked.