G4P (GUI for Processing) 4.3.11
A set of GUI controls for your Processing sketch.
Loading...
Searching...
No Matches
g4p_controls.GSlider2D Class Reference
Inheritance diagram for g4p_controls.GSlider2D:

Public Member Functions

void draw ()
 
float getValueXF ()
 
int getValueXI ()
 
String getValueXS ()
 
float getValueYF ()
 
int getValueYI ()
 
String getValueYS ()
 
 GSlider2D (PApplet theApplet, float p0, float p1, float p2, float p3)
 
void mouseEvent (MouseEvent event)
 
void setEasing (float easeBy)
 
void setLimitsX (float initValue, float start, float end)
 
void setLimitsX (float start, float end)
 
void setLimitsX (int initValue, int start, int end)
 
void setLimitsY (float initValue, float start, float end)
 
void setLimitsY (float start, float end)
 
void setLimitsY (int initValue, int start, int end)
 
void setLimitsY (int start, int end)
 
void setNumberFormat (int numberFormat)
 
void setNumberFormat (int numberFormat, int precision)
 
void setPrecision (int nd)
 
void setValueX (float v)
 
void setValueXY (float vx, float vy)
 
void setValueY (float v)
 
void setXlimits (int start, int end)
 
- Public Member Functions inherited from g4p_controls.GValueControl2D
 GValueControl2D (PApplet theApplet, float p0, float p1, float p2, float p3)
 
void pre ()
 
- Public Member Functions inherited from g4p_controls.GAbstractControl
void addControl (GAbstractControl c)
 
void addControl (GAbstractControl c, float x, float y)
 
void addControl (GAbstractControl c, float x, float y, float angle)
 
void addControls (GAbstractControl... controls)
 
void addEventHandler (Object obj, String methodName)
 
void dispose ()
 
void draw ()
 
void forceBufferUpdate ()
 
 GAbstractControl (PApplet theApplet)
 
 GAbstractControl (PApplet theApplet, float p0, float p1)
 
 GAbstractControl (PApplet theApplet, float p0, float p1, float p2, float p3)
 
int getAlpha ()
 
int getCursorOver ()
 
float getCX ()
 
float getCY ()
 
float getHeight ()
 
int getLocalColorScheme ()
 
PApplet getPApplet ()
 
GAbstractControl getParent ()
 
float getRotation ()
 
PGraphics getSnapshot ()
 
GToolTip getTip ()
 
float getWidth ()
 
float getX ()
 
float getY ()
 
boolean hasFocus ()
 
boolean isDragging ()
 
boolean isEnabled ()
 
boolean isOpaque ()
 
boolean isVisible ()
 
void keyEvent (KeyEvent e)
 
void mouseEvent (MouseEvent event)
 
void moveTo (float px, float py)
 
void moveTo (float px, float py, GControlMode mode)
 
void post ()
 
void pre ()
 
void removeTip ()
 
boolean saveSnapshot ()
 
boolean saveSnapshot (String filename)
 
void setAlpha (int alpha)
 
void setAlpha (int alpha, boolean includeChildren)
 
void setCursorOver (int cursorOver)
 
void setEnabled (boolean enable)
 
void setFocus (boolean focus)
 
void setLocalColor (int colorNo, int color)
 
void setLocalColorScheme (int cs)
 
void setLocalColorScheme (int cs, boolean includeChildren)
 
void setOpaque (boolean opaque)
 
void setRotation (float angle)
 
void setRotation (float angle, GControlMode mode)
 
void setTip (GToolTip tt, float offset, float angle)
 
void setTip (GToolTip tt, GAlign ax, GAlign ay, float gap)
 
void setTip (String text, float offset, float angle)
 
void setTip (String text, GAlign ax, GAlign ay, float gap)
 
void setTipDisplayTime (long msecs)
 
void setTipEnabled (boolean enable)
 
void setTipHorz (boolean level)
 
void setTipPos (float radius, float ang)
 
void setTipPos (GAlign ax, GAlign ay, float gap)
 
void setTipText (String text)
 
void setVisible (boolean visible)
 
String toString ()
 

Protected Member Functions

String getNumericDisplayString (float number)
 
void updateBuffer ()
 
void updateDueToValueChanging ()
 
- Protected Member Functions inherited from g4p_controls.GValueControl2D
void setEpsilon ()
 
void updateDueToValueChanging ()
 
- Protected Member Functions inherited from g4p_controls.GAbstractControl
void addControlImpl (GAbstractControl c, float x, float y, float angle)
 
void addToParent (GAbstractControl p)
 
void calcTransformedOrigin (float px, float py)
 
boolean controlSupportsToolTips ()
 
void createEventHandler (Object handlerObj, String methodName, Class[] param_classes, String[] param_names)
 
void drawChildren ()
 
void fireEvent (Object... objects)
 
int focusObjectZ ()
 
PGraphics getBuffer ()
 
int getCurrHotSpot ()
 
AffineTransform getTransform (AffineTransform aff)
 
void hideTip ()
 
boolean isAvailable ()
 
boolean isDisplayable (int ascii)
 
boolean isSuitableForGroupControl (GAbstractControl control)
 
void loseFocus (GAbstractControl grabber)
 
void makeBuffer ()
 
void manageToolTip ()
 
void resize (int w, int h)
 
void resize (int w, int h, GControlMode mode)
 
void setAvailable (boolean avail)
 
void setZ (int parentZ)
 
void showTip ()
 
void takeFocus ()
 
void updateBuffer ()
 
int whichHotSpot (float px, float py)
 

Protected Attributes

int downHotSpot = -1
 
float dragD
 
float dragHeight
 
float dragWidth
 
float endXlimit = 1
 
float endYlimit = 1
 
float startXlimit = 0
 
float startYlimit = 0
 
int status = OFF_CONTROL
 
- Protected Attributes inherited from g4p_controls.GValueControl2D
float easing = 1.0f
 
float offsetH
 
float offsetV
 
float parametricPosX = 0.5f
 
float parametricPosY = 0.5f
 
float parametricTargetX = 0.5f
 
float parametricTargetY = 0.5f
 
int precision = 2
 
int valueType = DECIMAL
 
- Protected Attributes inherited from g4p_controls.GAbstractControl
boolean allowChildren = true
 
boolean allowToolTips = true
 
int alphaLevel = G4P.globalAlpha
 
boolean available = true
 
PGraphicsJava2D buffer = null
 
boolean bufferInvalid = true
 
LinkedList< GAbstractControlchildren = null
 
int currSpot = -1
 
int cursorOver = HAND
 
float cx
 
float cy
 
boolean dragging = false
 
boolean enabled = true
 
Method eventHandlerMethod = null
 
String eventHandlerMethodName
 
Object eventHandlerObject = null
 
float halfHeight
 
float halfWidth
 
float height
 
HotSpot[] hotspots = null
 
int lastSpot = -1
 
int localColorScheme = G4P.globalColorScheme
 
boolean opaque = false
 
float ox
 
float oy
 
Color[] palette = null
 
GAbstractControl parent = null
 
int registeredMethods = 0
 
float rotAngle
 
double[] temp = new double[2]
 
GToolTip tip = null
 
boolean visible = true
 
float width
 
PApplet winApp
 
float x
 
float y
 
int z = Z_STICKY
 

Additional Inherited Members

- Public Attributes inherited from g4p_controls.GAbstractControl
String tag = ""
 
int tagNo
 
- Public Attributes inherited from g4p_controls.GConstants
int ALPHA_BLOCK = 128
 
int ALPHA_PICK = 48
 
TextAttribute BACKGROUND = TextAttribute.BACKGROUND
 
int BLUE_SCHEME = 6
 
int BOLD = Font.BOLD
 
int CANCEL = JOptionPane.CANCEL_OPTION
 
int CLOSE_WINDOW = 0x00000f02
 
int CLOSED = JOptionPane.CLOSED_OPTION
 
int CTRL_ANGULAR = 0x00000501
 
int CTRL_HORIZONTAL = 0x00000502
 
int CTRL_VERTICAL = 0x00000503
 
int CYAN_SCHEME = 5
 
int DECIMAL = 1
 
char END = java.awt.event.KeyEvent.VK_END
 
int ERROR_MESSAGE = JOptionPane.ERROR_MESSAGE
 
int EXIT_APP = 0x00000f01
 
int EXPONENT = 2
 
TextAttribute FAMILY = TextAttribute.FAMILY
 
TextAttribute FOREGROUND = TextAttribute.FOREGROUND
 
int FORWARD = 1
 
int GOLD_SCHEME = 7
 
int GREEN_SCHEME = 1
 
int HIDE_WINDOW = 0x00000f04
 
char HOME = java.awt.event.KeyEvent.VK_HOME
 
int INFO_MESSAGE = JOptionPane.INFORMATION_MESSAGE
 
int INTEGER = 0
 
int ITALIC = Font.ITALIC
 
int KEEP_OPEN = 0x00000f03
 
int NO = JOptionPane.NO_OPTION
 
int OK = JOptionPane.OK_OPTION
 
int OK_CANCEL = JOptionPane.OK_CANCEL_OPTION
 
int ORANGE_SCHEME = 4
 
int ORIENT_LEFT = -1
 
int ORIENT_RIGHT = 1
 
int ORIENT_TRACK = 0
 
int PLAIN = Font.PLAIN
 
int PLAIN_MESSAGE = JOptionPane.PLAIN_MESSAGE
 
TextAttribute POSTURE = TextAttribute.POSTURE
 
Float POSTURE_OBLIQUE = new Float(0.20f)
 
Float POSTURE_REGULAR = new Float(0.0f)
 
int PURPLE_SCHEME = 3
 
int QUERY_MESSAGE = JOptionPane.QUESTION_MESSAGE
 
int RED_SCHEME = 0
 
int REVERSE = -1
 
int SCHEME_10 = 10
 
int SCHEME_11 = 11
 
int SCHEME_12 = 12
 
int SCHEME_13 = 13
 
int SCHEME_14 = 14
 
int SCHEME_15 = 15
 
int SCHEME_8 = 8
 
int SCHEME_9 = 9
 
int SCROLLBARS_AUTOHIDE = 0x1000
 
int SCROLLBARS_BOTH = 0x0003
 
int SCROLLBARS_HORIZONTAL_ONLY = 0x0002
 
int SCROLLBARS_NONE = 0x0000
 
int SCROLLBARS_VERTICAL_ONLY = 0x0001
 
TextAttribute SIZE = TextAttribute.SIZE
 
TextAttribute STRIKETHROUGH = TextAttribute.STRIKETHROUGH
 
Boolean STRIKETHROUGH_OFF = new Boolean(false)
 
Boolean STRIKETHROUGH_ON = new Boolean(true)
 
TextAttribute SUPERSCRIPT = TextAttribute.SUPERSCRIPT
 
Integer SUPERSCRIPT_OFF = new Integer(0)
 
Integer SUPERSCRIPT_SUB = new Integer(-1)
 
Integer SUPERSCRIPT_SUPER = new Integer(1)
 
int UNDEFINED = Integer.MAX_VALUE
 
TextAttribute UNDERLINE = TextAttribute.UNDERLINE
 
int UNDERLINE_OFF = Integer.valueOf(-1)
 
int UNDERLINE_ON = TextAttribute.UNDERLINE_ON
 
int USER_COL_SCHEME = 0x00010102
 
int WARN_MESSAGE = JOptionPane.WARNING_MESSAGE
 
TextAttribute WEIGHT = TextAttribute.WEIGHT
 
Float WEIGHT_BOLD = new Float(2.0f)
 
Float WEIGHT_DEMIBOLD = new Float(1.75f)
 
Float WEIGHT_DEMILIGHT = new Float(0.875f)
 
Float WEIGHT_EXTRA_LIGHT = new Float(0.5f)
 
Float WEIGHT_EXTRABOLD = new Float(2.5f)
 
Float WEIGHT_HEAVY = new Float(2.25f)
 
Float WEIGHT_LIGHT = new Float(0.75f)
 
Float WEIGHT_MEDIUM = new Float(1.5f)
 
Float WEIGHT_REGULAR = new Float(1.0f)
 
Float WEIGHT_SEMIBOLD = new Float(1.25f)
 
Float WEIGHT_ULTRABOLD = new Float(2.75f)
 
TextAttribute WIDTH = TextAttribute.WIDTH
 
Float WIDTH_CONDENSED = new Float(0.75f)
 
Float WIDTH_EXTENDED = new Float(1.5f)
 
Float WIDTH_REGULAR = new Float(1.0f)
 
Float WIDTH_SEMI_CONDENSED = new Float(0.875f)
 
Float WIDTH_SEMI_EXTENDED = new Float(1.25f)
 
int X4 = 1
 
int X8 = 2
 
int YELLOW_SCHEME = 2
 
int YES = JOptionPane.YES_OPTION
 
int YES_NO = JOptionPane.YES_NO_OPTION
 
int YES_NO_CANCEL = JOptionPane.YES_NO_CANCEL_OPTION
 
- Static Protected Attributes inherited from g4p_controls.GValueControl2D
static int THUMB_SPOT = 1
 
static int TRACK_SPOT = 2
 
- Static Protected Attributes inherited from g4p_controls.GAbstractControl
static GAbstractControl controlToTakeFocus = null
 
static GAbstractControl cursorIsOver
 
static float epsilon = 0.001f
 
static GAbstractControl focusIsWith = null
 

Detailed Description

This slider is used to control 2 variables by dragging the thumb over a 2D surface. It has all the features of the standard slider (GSlider) except that it does not have ticks or stick-to-ticks functionality.

If no limits are set then the control will return a value in the range 0.0 to 1.0 for both the x and the y axis. The setXlimits and setYlimits can be used to set a different range for each axis independently.

The minimum size for this control is 40x40 pixels and this is enforced when the control is created. If necessary the width and/or height the rectangle will be increased to 40pixels.

Author
Peter Lager

Constructor & Destructor Documentation

◆ GSlider2D()

g4p_controls.GSlider2D.GSlider2D ( PApplet  theApplet,
float  p0,
float  p1,
float  p2,
float  p3 
)

Create a 2D slider inside the specified rectangle.

Parameters
theAppletthe main sketch or GWindow control for this control
p0x position based on control mode
p1y position based on control mode
p2x position or width based on control mode
p3y position or height based on control mode

Member Function Documentation

◆ draw()

void g4p_controls.GSlider2D.draw ( )

Reimplemented from g4p_controls.GAbstractControl.

◆ getNumericDisplayString()

String g4p_controls.GSlider2D.getNumericDisplayString ( float  number)
protected

Used to format the number into a string for display.

Parameters
number
Returns
the number formated as a string

◆ getValueXF()

float g4p_controls.GSlider2D.getValueXF ( )
Returns
the current X value as a float

◆ getValueXI()

int g4p_controls.GSlider2D.getValueXI ( )
Returns
the current X value as an integer.
DECIMAL and EXPONENT value types will be rounded to the nearest integer.

◆ getValueXS()

String g4p_controls.GSlider2D.getValueXS ( )
Returns
the current X value as a string taking into account the number format.

◆ getValueYF()

float g4p_controls.GSlider2D.getValueYF ( )
Returns
the current Y value as a float

◆ getValueYI()

int g4p_controls.GSlider2D.getValueYI ( )
Returns
the current Y value as an integer.
DECIMAL and EXPONENT value types will be rounded to the nearest integer.

◆ getValueYS()

String g4p_controls.GSlider2D.getValueYS ( )
Returns
the current Y value as a string taking into account the number format.

◆ mouseEvent()

void g4p_controls.GSlider2D.mouseEvent ( MouseEvent  event)

Reimplemented from g4p_controls.GAbstractControl.

◆ setEasing()

void g4p_controls.GSlider2D.setEasing ( float  easeBy)

Set the amount of easing to be used when a value is changing. The default value is 1 (no easing) values < 1 will cause the value to rush from its starting value and decelerate towards its final values. In other words it smoothes the movement of the slider thumb or knob rotation.

Parameters
easeBythe easing to set

◆ setLimitsX() [1/3]

void g4p_controls.GSlider2D.setLimitsX ( float  initValue,
float  start,
float  end 
)

X (horz) limits Sets the initial value and the range of values to be returned. This method will assume that you want to set the valueType to DECIMAL.

Parameters
initValuethe initial value
startthe X start value of the range
endthe X end value of the range

◆ setLimitsX() [2/3]

void g4p_controls.GSlider2D.setLimitsX ( float  start,
float  end 
)

X (horz) limits Sets the range of values to be returned. This method will assume that you want to set the valueType to DECIMAL

Parameters
startthe X start value of the range
endthe X end value of the range

◆ setLimitsX() [3/3]

void g4p_controls.GSlider2D.setLimitsX ( int  initValue,
int  start,
int  end 
)

X (horz) limits Sets the initial value and the range of values to be returned. This method will assume that you want to set the valueType to INTEGER.

Parameters
initValuethe initial value
startthe X start value of the range
endthe X end value of the range

◆ setLimitsY() [1/4]

void g4p_controls.GSlider2D.setLimitsY ( float  initValue,
float  start,
float  end 
)

Y (vert) limits Sets the initial value and the range of values to be returned. This method will assume that you want to set the valueType to DECIMAL.

Parameters
initValuethe initial value
startthe Y start value of the range
endthe Y end value of the range

◆ setLimitsY() [2/4]

void g4p_controls.GSlider2D.setLimitsY ( float  start,
float  end 
)

Y (vert) limits Sets the range of values to be returned. This method will assume that you want to set the valueType to DECIMAL

Parameters
startthe Y start value of the range
endthe Y end value of the range

◆ setLimitsY() [3/4]

void g4p_controls.GSlider2D.setLimitsY ( int  initValue,
int  start,
int  end 
)

Y (vert) limits Sets the initial value and the range of values to be returned. This method will assume that you want to set the valueType to INTEGER.

Parameters
initValuethe initial value
startthe start value of the range
endthe end value of the range

◆ setLimitsY() [4/4]

void g4p_controls.GSlider2D.setLimitsY ( int  start,
int  end 
)

Y (vert) limits Sets the range of values to be returned. This method will assume that you want to set the valueType to INTEGER

Parameters
startthe X start value of the range
endthe X end value of the range

◆ setNumberFormat() [1/2]

void g4p_controls.GSlider2D.setNumberFormat ( int  numberFormat)

Set the numberFormat and precision in one go.
Valid number formats are INTEGER, DECIMAL, EXPONENT
Precision must be ≥ 1 and is ignored for INTEGER.

Parameters
numberFormatG4P.INTEGER, G4P.DECIMAL or G4P.EXPONENT

◆ setNumberFormat() [2/2]

void g4p_controls.GSlider2D.setNumberFormat ( int  numberFormat,
int  precision 
)

Set the numberFormat and precision in one go.
Valid number formats are INTEGER, DECIMAL, EXPONENT
Precision must be ≥ 1 and is ignored for INTEGER.

Parameters
numberFormatG4P.INTEGER, G4P.DECIMAL orG4P. EXPONENT
precisionmust be ≥ 1

◆ setPrecision()

void g4p_controls.GSlider2D.setPrecision ( int  nd)

For DECIMAL values this sets the number of decimal places to be displayed.

Parameters
ndmust be ≥ 1 otherwise will use 1

◆ setValueX()

void g4p_controls.GSlider2D.setValueX ( float  v)

Set the X (horz) value for the slider.
The value supplied will be constrained to the current limits.

Parameters
vthe new value

◆ setValueXY()

void g4p_controls.GSlider2D.setValueXY ( float  vx,
float  vy 
)

Set both the XY values for the slider.
The values supplied will be constrained to the appropriate current limits.

Parameters
vxthe new X (horz) value
vythe new Y (vert) value

◆ setValueY()

void g4p_controls.GSlider2D.setValueY ( float  v)

Set the Y (vert) value for the slider.
The value supplied will be constrained to the current limits.

Parameters
vthe new value

◆ setXlimits()

void g4p_controls.GSlider2D.setXlimits ( int  start,
int  end 
)

X (horz) limits Sets the range of values to be returned. This method will assume that you want to set the valueType to INTEGER

Parameters
startthe start value of the range
endthe end value of the range

◆ updateBuffer()

void g4p_controls.GSlider2D.updateBuffer ( )
protected

Reimplemented from g4p_controls.GAbstractControl.

◆ updateDueToValueChanging()

void g4p_controls.GSlider2D.updateDueToValueChanging ( )
protected

Updates thumb hotspot due changes caused by easing

Reimplemented from g4p_controls.GValueControl2D.