Slider2D

Slider2D[{x,y}]

represents a 2D slider with settings x and y in the range 0 to 1.

Slider2D[Dynamic[pt]]

takes the setting to be the dynamically updated current value of pt, with the value of pt being reset if the slider is moved.

Slider2D[pt,{min,max}]

represents a 2D slider with range min to max in each direction.

Slider2D[pt,{min,max,d}]

represents a 2D slider that jumps in steps d in each direction.

Slider2D[pt,{{xmin,ymin},{xmax,ymax}}]

specifies different ranges in x and y directions.

Slider2D[pt,{{xmin,ymin},{xmax,ymax},{dx,dy}}]

uses jumps dx, dy.

Details and Options

  • Slider2D[] displays in a notebook as a 2D slider that can be manipulated interactively, and moved in both horizontal and vertical directions.
  • Slider2D[Dynamic[pt]] will reset the value of pt when the slider is moved; Slider2D[pt] will not.
  • Slider2D[pt,{nmin,nmax,dn}] jumps to integer positions if nmin and dn are integers.
  • Slider2D[pt,{rmin,rmax,dr}] in general jumps to positions given by Range[rmin,rmax,dr].
  • In Slider2D[pt,{{xmin,ymin},{xmax,ymax},{dx,dy}}], dx or dy can be 0, indicating that settings in the corresponding direction should be continuous.
  • The coordinates in Slider2D run in the same directions as the default for Graphics, with x running from left to right, and y running from bottom to top.
  • Slider2D[pt,{{xmin,ymax},{xmax,ymin}}] with ymax > ymin represents a 2D slider with y running from top to bottom.
  • If the value of the 2D slider is outside the ranges given, it will be displayed at one of the sides.
  • The following options can be given:
  • AppearanceAutomaticthe overall appearance of the 2D slider
    AutoActionFalsewhether to move the 2D slider automatically when the mouse is over it
    BaselinePositionAutomatichow to align with a surrounding text baseline
    BaseStyle{}base style specifications for the 2D slider
    ContinuousActionTruewhether to update continuously when the slider is moved
    EnabledAutomaticwhether the 2D slider is enabled, or grayed out
    Exclusions{}specific points to exclude
    ImageMargins0margins around the image of the displayed 2D slider
    ImageSizeAutomaticthe overall image size of the displayed 2D slider
  • Appearance->"Labeled" displays the current values of the slider as editable labels.
  • The settings for BaseStyle are appended to the default style typically given by the "Slider2D" style in the current stylesheet.
  • Slider2D[] is equivalent to Slider2D[{0.5,0.5}].

Examples

open allclose all

Basic Examples  (2)

A particular 2D slider setting:

Dynamically update the slider setting:

Scope  (3)

Define a range:

Define a range and step size:

Use Evaluate in Place to get an active 2D slider:

Then evaluate Setting to get the actual value out:

Options  (12)

Appearance  (2)

Different sizes:

Add a label:

AutoAction  (1)

Values will change as the cursor moves over the slider:

Background  (2)

Set the background color:

Change the background dynamically:

BaselinePosition  (1)

Set the baseline for alignment with surrounding text:

ContinuousAction  (1)

By default, settings are changed continuously as the controller is affected:

Makes settings update only when the mouse is released:

Enabled  (1)

By default, Slider2D is enabled:

Make the slider disabled but visible in its current state:

ImageMargins  (2)

Use symbolic values for image margins:

Set the image margin in printer's points:

ImageSize  (2)

Use preset values:

Use numerical values:

Applications  (2)

A color selector:

A simple camera controller:

Properties & Relations  (1)

A Locator or LocatorPane can be used if the control should be contained within graphics:

Possible Issues  (1)

The limits in Slider2D are specified by giving coordinates of corners, not x and y ranges:

The limits are identical, so the slider cannot move:

Neat Examples  (1)

Coupled sliders:

Introduced in 2007
 (6.0)
 |
Updated in 2017
 (11.2)