cslib.fractal

Class MandelbrotGUI

java.lang.Object

cslib.fractal.MandelbrotGUI

public class MandelbrotGUI
extends java.lang.Object

The graphical user interface for the Mandelbrot assignment. Initial version by Christian Andersson.

May 09, PH: added proportional zooming, removed double buffering, removed some interface options, added "Extra" text field, added constructor for variable image width, simplified layouts, cleaned up a lot.

Field Summary

Fields

Modifier and Type	Field and Description
static int	MODE_BW Black and White mode.
static int	MODE_COLOR Color mode.
static int	QUIT Quit command.
static int	RENDER Render command.
static int	RESET Reset command.
static int	RESOLUTION_HIGH High resolution.
static int	RESOLUTION_LOW Low resolution.
static int	RESOLUTION_MEDIUM Medium resolution.
static int	RESOLUTION_VERY_HIGH Very high resolution.
static int	RESOLUTION_VERY_LOW Very low resolution.
static int	ZOOM Zoom command.

Constructor Summary

Constructors

Constructor and Description
MandelbrotGUI() Creates a graphical user interface with the default width.
MandelbrotGUI(int width) Creates a graphical user interface with the specified width.

Method Summary

Modifier and Type	Method and Description
void	clearPlane() Clears the image plane.
void	disableInput() Disables user input.
void	enableInput() Enables user input.
int	getCommand() Returns a command triggered by the user.
java.lang.String	getExtraText() Returns the string that the user has typed in the "Extra" field.
int	getHeight() Returns the image height.
double	getMaximumImag() Returns the maximum imaginary value.
double	getMaximumReal() Returns the maximum real value.
double	getMinimumImag() Returns the minimum imaginary value.
double	getMinimumReal() Returns the minimum real value.
int	getMode() Returns the image mode.
int	getResolution() Returns the image resolution.
int	getWidth() Returns the image width.
void	putData(java.awt.Color[][] image, int pixelWidth, int pixelHeight) Draws an image on the complex plane.
void	resetPlane() Resets the axis limits to their default values.

Methods inherited from class java.lang.Object

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

Field Detail

RENDER

public static final int RENDER

Render command.

This constant is returned by getCommand() when the user presses the RENDER button.

See Also:

getCommand(), Constant Field Values

ZOOM

public static final int ZOOM

Zoom command.

This constant is returned by getCommand() when the user zooms in the picture.

See Also:

getCommand(), Constant Field Values

RESET

public static final int RESET

Reset command.

This constant is returned by getCommand() when the user presses the RESET button.

See Also:

getCommand(), Constant Field Values

QUIT

public static final int QUIT

Quit command.

This constant is returned by getCommand() when the user presses the QUIT button or chooses Quit in the File menu.

See Also:

getCommand(), Constant Field Values

MODE_BW

public static final int MODE_BW

Black and White mode.

This is the value returned by getMode() when the user has requested a black and white image.

See Also:

Constant Field Values

MODE_COLOR

public static final int MODE_COLOR

Color mode.

This is the value returned by getMode() when the user has requested a color image.

See Also:

Constant Field Values

RESOLUTION_VERY_LOW

public static final int RESOLUTION_VERY_LOW

Very low resolution.

This is the value returned by getResolution() when the user has requested very low resolution of the image.

See Also:

getResolution(), Constant Field Values

RESOLUTION_LOW

public static final int RESOLUTION_LOW

Low resolution.

This is the value returned by getResolution() when the user has requested low resolution of the image.

See Also:

getResolution(), Constant Field Values

RESOLUTION_MEDIUM

public static final int RESOLUTION_MEDIUM

Medium resolution.

This is the value returned by getResolution() when the user has requested medium resolution of the image.

See Also:

getResolution(), Constant Field Values

RESOLUTION_HIGH

public static final int RESOLUTION_HIGH

High resolution.

This is the value returned by getResolution() when the user has requested high resolution of the image.

See Also:

getResolution(), Constant Field Values

RESOLUTION_VERY_HIGH

public static final int RESOLUTION_VERY_HIGH

Very high resolution.

This is the value returned by getResolution() when the user has requested very high resolution of the image.

See Also:

getResolution(), Constant Field Values

Constructor Detail

MandelbrotGUI

public MandelbrotGUI()

Creates a graphical user interface with the default width. The height is scaled so the default complex plane can be displayed.

MandelbrotGUI

public MandelbrotGUI(int width)

Creates a graphical user interface with the specified width. The height is scaled so the default complex plane can be displayed.

Parameters:

width - The width in pixels.

Method Detail

disableInput

public void disableInput()

Disables user input.

See Also:

enableInput()

enableInput

public void enableInput()

Enables user input.

See Also:

disableInput()

getMinimumReal

public double getMinimumReal()

Returns the minimum real value.

Returns:

Minimum real value of the complex coordinate system.

See Also:

getMaximumReal(), getMinimumImag(), getMaximumImag()

getMaximumReal

public double getMaximumReal()

Returns the maximum real value.

Returns:

Maximum real value of the complex coordinate system.

See Also:

getMinimumReal(), getMinimumImag(), getMaximumImag()

getMinimumImag

public double getMinimumImag()

Returns the minimum imaginary value.

Returns:

Minimum imaginary value of the complex coordinate system.

See Also:

getMinimumReal(), getMaximumReal(), getMinimumImag()

getMaximumImag

public double getMaximumImag()

Returns the maximum imaginary value.

Returns:

Maximum imaginary value of the complex coordinate system.

See Also:

getMinimumReal(), getMaximumReal(), getMinimumImag()

getMode

public int getMode()

Returns the image mode.

The mode is chosen among the two alternatives MODE_BW and MODE_COLOR, given as constants by the class.

Returns:

The image mode chosen by the user.

See Also:

MODE_BW, MODE_COLOR

getResolution

public int getResolution()

Returns the image resolution.

The resolution is chosen among five alternatives given as constants in the class.

Returns:

The image resolution chosen by the user.

See Also:

RESOLUTION_VERY_LOW, RESOLUTION_LOW, RESOLUTION_MEDIUM, RESOLUTION_HIGH, RESOLUTION_VERY_HIGH

getExtraText

public java.lang.String getExtraText()

Returns the string that the user has typed in the "Extra" field.

Returns:

The text in the "Extra" field.

getWidth

public int getWidth()

Returns the image width.

Returns:

The width of the image in pixels.

See Also:

getHeight()

getHeight

public int getHeight()

Returns the image height.

Returns:

The height of the image in pixels.

See Also:

getWidth()

getCommand

public int getCommand()

Returns a command triggered by the user.

The possible return values are defined as constants in the class.

Returns:

A command triggered by the user.

See Also:

QUIT, RENDER, ZOOM, RESET

clearPlane

public void clearPlane()

Clears the image plane.

resetPlane

public void resetPlane()

Resets the axis limits to their default values.

putData

public void putData(java.awt.Color[][] image,
                    int pixelWidth,
                    int pixelHeight)

Draws an image on the complex plane.

An image represented as a matrix of colors is drawn on the complex plane of the interface. Matrix element [0][0] is drawn at image position (0,0).

Parameters:

image - A matrix of color objects, each of whose elements is interpreted as a picture element of the image to draw.

pixelWidth - The width of a picture element.

pixelHeight - The height of a picture element.