g4p_controls

Class GImageToggleButton

java.lang.Object

g4p_controls.GAbstractControl

g4p_controls.GImageToggleButton

All Implemented Interfaces:

GConstants, processing.core.PConstants

public class GImageToggleButton
extends GAbstractControl

Buttons created from this class have 2 or more toggle states. If the number of states is N then the button's value will be in the range 0 to N-1. Most toggle buttons will have just two states and these have values 0 and 1.
Clicking on the button advances the state by one, restarting at zero after the last state.
Each state must have its own 'picture' and the user must supply these as a tiled image where the pictures are tiled in 1D or 2D arrangement without 'empty space' around the tiles.
If for any reason the library is unable to use the specified graphics then it will provide a default two state toggle switch.
It is also possible to provide an over-button image set for when the mouse moves over the button - this is optional.
The button control will always be resized to suit the state picture size (tile size).
The mouse is considered to be over the button it its position is over an opaque pixel in the state picture. Since transparent pixels are not included then the button shape can be different for each state.
Three types of event can be generated :-
GEvent.PRESSED GEvent.RELEASED GEvent.CLICKED
To simplify event handling the button only fires off CLICKED events when the mouse button is pressed and released over the button face (the default behaviour).
Using

button1.fireAllEvents(true);

enables the other 2 events for button button1. A PRESSED event is created if the mouse button is pressed down over the button face, the CLICKED event is then generated if the mouse button is released over the button face. Releasing the button off the button face creates a RELEASED event. This is included for completeness since it is unlikely you will need to detect these events for this type of control.

Author:

Peter Lager

Nested Class Summary

Nested classes/interfaces inherited from class g4p_controls.GAbstractControl

GAbstractControl.Z_Order

Field Summary

Fields

Modifier and Type	Field and Description
static int	ALL_METHOD
static int	CLIP_RUN
static int	COMBI_MODES
static java.lang.String	DEFAULT_SLIDER_STYLE
static int	DRAG_CONTROL
static int	DRAW_METHOD
static char	EOL
static int	EXCP_IN_HANDLER
static int[][]	grid
static int	GROUP_CONTROL_METHOD
static int	I_CL
static int	I_COVERED
static int	I_CR
static int	I_INSIDE
static int	I_MODES
static int	I_NONE
static int	I_TL
static int	I_TR
static int	INVALID_PAPPLET
static int	INVALID_TYPE
static int	KEY_METHOD
static int	MERGE_RUNS
static int	MISSING
static int	MOUSE_METHOD
static int	NONEXISTANT
static int	OFF_CONTROL
static int	OVER_CONTROL
static java.awt.BasicStroke	pen_1_0
static java.awt.BasicStroke	pen_2_0
static java.awt.BasicStroke	pen_3_0
static java.awt.BasicStroke	pen_4_0
static int	POST_METHOD
static int	PRE_METHOD
static int	PRESS_CONTROL
static int	SCROLLBAR_HORIZONTAL
static int	SCROLLBAR_VERTICAL
static java.lang.String	SLIDER_STYLES
static int	TINT_FOR_ALPHA
static int	TPAD2
static int	TPAD4
static int	TPAD6
static int	TPAD8
static float	WHEEL_DELTA
static float	WHEEL_STICK_FACTOR
static int	Z_PANEL
static int	Z_SLIPPY
static int	Z_SLIPPY_EXPANDS
static int	Z_STICKY

Fields inherited from class g4p_controls.GAbstractControl

tag, tagNo

Fields inherited from interface processing.core.PConstants

ADD, ALPHA, ALT, AMBIENT, ARC, ARGB, ARROW, BACKSPACE, BASELINE, BEVEL, BEZIER_VERTEX, BLEND, BLUR, BOTTOM, BOX, BREAK, BURN, CENTER, CHATTER, CHORD, CLAMP, CLOSE, CODED, COMPLAINT, CONTROL, CORNER, CORNERS, CROSS, CURVE_VERTEX, CUSTOM, DARKEST, DEG_TO_RAD, DELETE, DIAMETER, DIFFERENCE, DILATE, DIRECTIONAL, DISABLE_ASYNC_SAVEFRAME, DISABLE_BUFFER_READING, DISABLE_DEPTH_MASK, DISABLE_DEPTH_SORT, DISABLE_DEPTH_TEST, DISABLE_KEY_REPEAT, DISABLE_NATIVE_FONTS, DISABLE_OPENGL_ERRORS, DISABLE_OPTIMIZED_STROKE, DISABLE_STROKE_PERSPECTIVE, DISABLE_STROKE_PURE, DISABLE_TEXTURE_MIPMAPS, DODGE, DOWN, DXF, ELLIPSE, ENABLE_ASYNC_SAVEFRAME, ENABLE_BUFFER_READING, ENABLE_DEPTH_MASK, ENABLE_DEPTH_SORT, ENABLE_DEPTH_TEST, ENABLE_KEY_REPEAT, ENABLE_NATIVE_FONTS, ENABLE_OPENGL_ERRORS, ENABLE_OPTIMIZED_STROKE, ENABLE_STROKE_PERSPECTIVE, ENABLE_STROKE_PURE, ENABLE_TEXTURE_MIPMAPS, ENTER, EPSILON, ERODE, ESC, EXCLUSION, FX2D, GIF, GRAY, GROUP, HALF_PI, HAND, HARD_LIGHT, HINT_COUNT, HSB, IMAGE, INVERT, JAVA2D, JPEG, LANDSCAPE, LEFT, LIGHTEST, LINE, LINE_LOOP, LINE_STRIP, LINES, LINUX, MACOSX, MAX_FLOAT, MAX_INT, MIN_FLOAT, MIN_INT, MITER, MODEL, MODELVIEW, MOVE, MULTIPLY, NORMAL, OPAQUE, OPEN, OPENGL, ORTHOGRAPHIC, OTHER, OVERLAY, P2D, P3D, PATH, PDF, PERSPECTIVE, PI, PIE, platformNames, POINT, POINTS, POLYGON, PORTRAIT, POSTERIZE, PROBLEM, PROJECT, PROJECTION, QUAD, QUAD_BEZIER_VERTEX, QUAD_STRIP, QUADRATIC_VERTEX, QUADS, QUARTER_PI, RAD_TO_DEG, RADIUS, RECT, REPEAT, REPLACE, RETURN, RGB, RIGHT, ROUND, SCREEN, SHAPE, SHIFT, SOFT_LIGHT, SPAN, SPHERE, SPOT, SQUARE, SUBTRACT, SVG, TAB, TARGA, TAU, TEXT, THIRD_PI, THRESHOLD, TIFF, TOP, TRIANGLE, TRIANGLE_FAN, TRIANGLE_STRIP, TRIANGLES, TWO_PI, UP, VERTEX, WAIT, WHITESPACE, WINDOWS, X, Y, Z

Fields inherited from interface g4p_controls.GConstants

ALPHA_BLOCK, ALPHA_PICK, BACKGROUND, BLUE_SCHEME, CANCEL, CLOSE_WINDOW, CLOSED, CTRL_ANGULAR, CTRL_HORIZONTAL, CTRL_VERTICAL, CYAN_SCHEME, DECIMAL, END, ERROR, EXIT_APP, EXPONENT, FAMILY, FOREGROUND, FORWARD, GOLD_SCHEME, GREEN_SCHEME, HOME, INFO, INTEGER, KEEP_OPEN, NO, OK, OK_CANCEL, ORANGE_SCHEME, ORIENT_LEFT, ORIENT_RIGHT, ORIENT_TRACK, PLAIN, POSTURE, POSTURE_OBLIQUE, POSTURE_REGULAR, PURPLE_SCHEME, QUERY, RED_SCHEME, REVERSE, SCHEME_10, SCHEME_11, SCHEME_12, SCHEME_13, SCHEME_14, SCHEME_15, SCHEME_8, SCHEME_9, SCROLLBARS_AUTOHIDE, SCROLLBARS_BOTH, SCROLLBARS_HORIZONTAL_ONLY, SCROLLBARS_NONE, SCROLLBARS_VERTICAL_ONLY, SIZE, STRIKETHROUGH, STRIKETHROUGH_OFF, STRIKETHROUGH_ON, SUPERSCRIPT, SUPERSCRIPT_OFF, SUPERSCRIPT_SUB, SUPERSCRIPT_SUPER, USER_COL_SCHEME, WARNING, WEIGHT, WEIGHT_BOLD, WEIGHT_DEMIBOLD, WEIGHT_DEMILIGHT, WEIGHT_EXTRA_LIGHT, WEIGHT_EXTRABOLD, WEIGHT_HEAVY, WEIGHT_LIGHT, WEIGHT_MEDIUM, WEIGHT_REGULAR, WEIGHT_SEMIBOLD, WEIGHT_ULTRABOLD, WIDTH, WIDTH_CONDENSED, WIDTH_EXTENDED, WIDTH_REGULAR, WIDTH_SEMI_CONDENSED, WIDTH_SEMI_EXTENDED, X4, X8, YELLOW_SCHEME, YES, YES_NO, YES_NO_CANCEL

Constructor Summary

Constructors

Constructor and Description
GImageToggleButton(processing.core.PApplet theApplet, float p0, float p1) Create the library default image-toggle-button at the stated position.
GImageToggleButton(processing.core.PApplet theApplet, float p0, float p1, java.lang.String offPicture, int nbrCols) Create an image-toggle-button.
GImageToggleButton(processing.core.PApplet theApplet, float p0, float p1, java.lang.String offPicture, int nbrCols, int nbrRows) Create an image-toggle-button.
GImageToggleButton(processing.core.PApplet theApplet, float p0, float p1, java.lang.String offPicture, java.lang.String overPicture, int nbrCols) Create an image-toggle-button.
GImageToggleButton(processing.core.PApplet theApplet, float p0, float p1, java.lang.String offPicture, java.lang.String overPicture, int nbrCols, int nbrRows) Create an image-toggle-button.

Method Summary

Methods

Modifier and Type	Method and Description
void	draw()
void	fireAllEvents(boolean all) If the parameter is true all 3 event types are generated, if false only CLICKED events are generated (default behaviour).
int	getState() Get the current state value of the button.
void	mouseEvent(processing.event.MouseEvent event) When a mouse button is clicked on a GImageToggleButton it generates the GEvent.CLICKED event.
void	setState(int newState) Change the current toggle state.
int	stateValue() Deprecated. use getState()
void	stateValue(int newState) Deprecated. use setState(int)

Methods inherited from class g4p_controls.GAbstractControl

addControl, addControl, addControl, addControls, addEventHandler, dispose, forceBufferUpdate, getCursorOver, getCX, getCY, getHeight, getLocalColorScheme, getPApplet, getParent, getSnapshot, getWidth, getX, getY, hasFocus, isDragging, isEnabled, isOpaque, isOver, isVisible, keyEvent, markForDisposal, moveTo, moveTo, post, pre, saveSnapshot, saveSnapshot, setAlpha, setAlpha, setCursorOver, setEnabled, setFocus, setLocalColor, setLocalColorScheme, setLocalColorScheme, setOpaque, setRotation, setRotation, setVisible, toString

Methods inherited from class java.lang.Object

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

Field Detail

SLIDER_STYLES

public static final java.lang.String SLIDER_STYLES

See Also:

Constant Field Values

DEFAULT_SLIDER_STYLE

public static final java.lang.String DEFAULT_SLIDER_STYLE

See Also:

Constant Field Values

DRAW_METHOD

public static final int DRAW_METHOD

See Also:

Constant Field Values

MOUSE_METHOD

public static final int MOUSE_METHOD

See Also:

Constant Field Values

PRE_METHOD

public static final int PRE_METHOD

See Also:

Constant Field Values

KEY_METHOD

public static final int KEY_METHOD

See Also:

Constant Field Values

POST_METHOD

public static final int POST_METHOD

See Also:

Constant Field Values

ALL_METHOD

public static final int ALL_METHOD

See Also:

Constant Field Values

GROUP_CONTROL_METHOD

public static final int GROUP_CONTROL_METHOD

See Also:

Constant Field Values

MISSING

public static final int MISSING

See Also:

Constant Field Values

NONEXISTANT

public static final int NONEXISTANT

See Also:

Constant Field Values

INVALID_TYPE

public static final int INVALID_TYPE

See Also:

Constant Field Values

INVALID_PAPPLET

public static final int INVALID_PAPPLET

See Also:

Constant Field Values

EXCP_IN_HANDLER

public static final int EXCP_IN_HANDLER

See Also:

Constant Field Values

OFF_CONTROL

public static final int OFF_CONTROL

See Also:

Constant Field Values

OVER_CONTROL

public static final int OVER_CONTROL

See Also:

Constant Field Values

PRESS_CONTROL

public static final int PRESS_CONTROL

See Also:

Constant Field Values

DRAG_CONTROL

public static final int DRAG_CONTROL

See Also:

Constant Field Values

TINT_FOR_ALPHA

public static final int TINT_FOR_ALPHA

See Also:

Constant Field Values

I_NONE

public static final int I_NONE

See Also:

Constant Field Values

I_TL

public static final int I_TL

See Also:

Constant Field Values

I_TR

public static final int I_TR

See Also:

Constant Field Values

I_CL

public static final int I_CL

See Also:

Constant Field Values

I_CR

public static final int I_CR

See Also:

Constant Field Values

I_INSIDE

public static final int I_INSIDE

See Also:

Constant Field Values

I_COVERED

public static final int I_COVERED

See Also:

Constant Field Values

I_MODES

public static final int I_MODES

See Also:

Constant Field Values

MERGE_RUNS

public static final int MERGE_RUNS

See Also:

Constant Field Values

CLIP_RUN

public static final int CLIP_RUN

See Also:

Constant Field Values

COMBI_MODES

public static final int COMBI_MODES

See Also:

Constant Field Values

grid

public static final int[][] grid

pen_1_0

public static final java.awt.BasicStroke pen_1_0

pen_2_0

public static final java.awt.BasicStroke pen_2_0

pen_3_0

public static final java.awt.BasicStroke pen_3_0

pen_4_0

public static final java.awt.BasicStroke pen_4_0

TPAD2

public static final int TPAD2

See Also:

Constant Field Values

TPAD4

public static final int TPAD4

See Also:

Constant Field Values

TPAD6

public static final int TPAD6

See Also:

Constant Field Values

TPAD8

public static final int TPAD8

See Also:

Constant Field Values

SCROLLBAR_VERTICAL

public static final int SCROLLBAR_VERTICAL

See Also:

Constant Field Values

SCROLLBAR_HORIZONTAL

public static final int SCROLLBAR_HORIZONTAL

See Also:

Constant Field Values

WHEEL_DELTA

public static final float WHEEL_DELTA

See Also:

Constant Field Values

WHEEL_STICK_FACTOR

public static final float WHEEL_STICK_FACTOR

See Also:

Constant Field Values

EOL

public static final char EOL

See Also:

Constant Field Values

Z_STICKY

public static final int Z_STICKY

See Also:

Constant Field Values

Z_SLIPPY

public static final int Z_SLIPPY

See Also:

Constant Field Values

Z_SLIPPY_EXPANDS

public static final int Z_SLIPPY_EXPANDS

See Also:

Constant Field Values

Z_PANEL

public static final int Z_PANEL

See Also:

Constant Field Values

Constructor Detail

GImageToggleButton

public GImageToggleButton(processing.core.PApplet theApplet,
                  float p0,
                  float p1)

Create the library default image-toggle-button at the stated position.

Parameters:

theApplet -

p0 - horizontal position of the control

p1 - vertical position of the control

GImageToggleButton

public GImageToggleButton(processing.core.PApplet theApplet,
                  float p0,
                  float p1,
                  java.lang.String offPicture,
                  int nbrCols)

Create an image-toggle-button.
Single row of tiles.

Parameters:

theApplet -

p0 - horizontal position of the control

p1 - vertical position of the control

offPicture - the filename of bitmap containing toggle state pictures

nbrCols - number of tiles horizontally

GImageToggleButton

public GImageToggleButton(processing.core.PApplet theApplet,
                  float p0,
                  float p1,
                  java.lang.String offPicture,
                  int nbrCols,
                  int nbrRows)

Create an image-toggle-button.

Parameters:

theApplet -

p0 - horizontal position of the control

p1 - vertical position of the control

offPicture - the filename of bitmap containing toggle state pictures

nbrCols - number of tiles horizontally

nbrRows - number of tiles vertically

GImageToggleButton

public GImageToggleButton(processing.core.PApplet theApplet,
                  float p0,
                  float p1,
                  java.lang.String offPicture,
                  java.lang.String overPicture,
                  int nbrCols)

Create an image-toggle-button.
Single row of tiles.

Parameters:

theApplet -

p0 - horizontal position of the control

p1 - vertical position of the control

offPicture - the filename of bitmap containing toggle state pictures

overPicture - the filename of bitmap containing mouse-over button toggle state pictures

nbrCols - number of tiles horizontally

GImageToggleButton

public GImageToggleButton(processing.core.PApplet theApplet,
                  float p0,
                  float p1,
                  java.lang.String offPicture,
                  java.lang.String overPicture,
                  int nbrCols,
                  int nbrRows)

Create an image-toggle-button.

Parameters:

theApplet -

p0 - horizontal position of the control

p1 - vertical position of the control

offPicture - the filename of bitmap containing toggle state pictures

overPicture - the filename of bitmap containing mouse-over button toggle state pictures

nbrCols - number of tiles horizontally

nbrRows - number of tiles vertically

Method Detail

draw

public void draw()

Overrides:

draw in class GAbstractControl

mouseEvent

public void mouseEvent(processing.event.MouseEvent event)

When a mouse button is clicked on a GImageToggleButton it generates the GEvent.CLICKED event. If you also want the button to generate GEvent.PRESSED and GEvent.RELEASED events then you need the following statement.

btnName.fireAllEvents(true); 

 void handleButtonEvents(void handleToggleButtonEvents(GImageToggleButton button, GEvent event) {
          if(button == btnName && event == GEvent.CLICKED){
        int buttonState = btnName.stateValue();
    }
 

Where

btnName

is the GImageToggleButton identifier (variable name)

Overrides:

mouseEvent in class GAbstractControl

stateValue

@Deprecated
public int stateValue()

Deprecated. use getState()

Get the current state value of the button.

getState

public int getState()

Get the current state value of the button.

stateValue

@Deprecated
public void stateValue(int newState)

Deprecated. use setState(int)

Change the current toggle state.
If the parameter is not a valid toggle state value then it is ignored and the button's state value is unchanged.

Parameters:

newState -

setState

public void setState(int newState)

Change the current toggle state.
If the parameter is not a valid toggle state value then it is ignored and the button's state value is unchanged.

Parameters:

newState -

fireAllEvents

public void fireAllEvents(boolean all)

If the parameter is true all 3 event types are generated, if false only CLICKED events are generated (default behaviour).
For this toggle control I can't see the need for anything but CLICKED events

Parameters:

all -