Class CvsKnob

This class represents a turnable knob with a surrounding status track (optional). Three modes are available to rotate the knob.

Major and minor tick marks can be added to the status track and supports stick-to-ticks if wanted.

Since

1.1.0

Hierarchy

Properties

_limit0: number
_limit1: number
_majorTicks: number
_minorTicks: number
_s2ticks: boolean
_t01: number
action: Function = ...

The event handler for this control. Although it is permitted to set this property directly it is recommended that the setAction(...) method is used to define the event handler actions.

Methods

  • Add a child to this control using its relative position [rx, ry]. If rx and ry are not provided then it uses the values set in the child.

    Returns

    this control

    Parameters

    • c: string | CvsBaseControl

      is the actual control or its name

    • Optional rx: number
    • Optional ry: number

    Returns any

  • Set or get the corner radii used for this control

    Returns

    an array with the 4 corner radii

    Parameters

    • c: number[]

      an array of 4 corner radii

    Returns number[] | CvsBaseControl

  • Disables this control

    Returns

    this control

    Parameters

    • Optional cascade: boolean

      if true disable child controls

    Returns CvsBaseControl

  • Enables this control

    Returns

    this control

    Parameters

    • Optional cascade: boolean

      if true enable child controls

    Returns CvsBaseControl

  • If the turn angle is < 360° then there will be an 'unused' section of track. This is called the gap and this method sets the position of the gap center effectively rotating the whole knob.

    The angle is 0° along positive x-axis and increases clockwise. The default value is 90° which means the gap center is facing south.

    Returns

    this control

    Parameters

    • ang: number

      must be in the range ≥ 0 and ≤ 360

    Returns CvsKnob

  • Make this control invisible

    Returns

    this control

    Parameters

    • Optional cascade: boolean

      if true hide children

    Returns CvsBaseControl

  • Invalidates the control's buffer forcing it to validate it on the next frame

    Returns

    this control

    Returns CvsKnob

  • Use enable() and disable() to enable and disable it.

    Returns

    true if the control is enabled else false

    Returns boolean

  • Returns

    true if the value lies within the slider's limits else false

    Parameters

    • value: number

      scale value to test

    Returns boolean

  • Returns

    true if this control is visible

    Since

    0.9.3

    Returns boolean

  • Set the lower and upper limits for the slider

    Returns

    this slider object

    Parameters

    • l0: number

      lower limit

    • l1: number

      upper limit

    Returns CvsSlider

  • Sets the interaction mode for rotating the knob.

    • 'x' : dragging left and right turns the knob anticlockwise and clockwise respectively.
    • 'y' : dragging down and up turns the knob anticlockwise and clockwise respectively.
    • 'a' : dragging in a circular motion round the knob center turns the knob to face the drag point.

    Rotation is constrained within the maximum turn angle for this knob.

    Any other parameter value is ignored and the mode is unchanged.

    Returns

    this control

    Parameters

    • mode: string

      'x', 'y' or 'a'

    Returns CvsKnob

  • Returns

    the unique identier for this control

    Returns string

  • Makes the controls background opaque. The actual color depends on the controls color scheme

    Returns

    this control

    Returns CvsBaseControl

  • Specify the orientation to show this control

    Returns

    this control

    Parameters

    • dir: string

      'north', 'south', 'east' or 'west'

    Returns CvsBaseControl

  • Adds this control to another control which becomes its parent

    Returns

    this control

    Parameters

    • p: string | CvsBaseControl

      is the parental control or its name

    • Optional rx: number

      x position relative to parent

    • Optional ry: number

      y position relative to parent

    Returns CvsBaseControl

  • Sets or gets the color scheme used by this control.

    Returns

    this control or the control's color scheme

    Parameters

    • Optional id: string

      the color scheme id e.g. 'blue'

    • Optional cascade: boolean

      if true propogate scheme to all child controls.

    Returns any

  • Only applies to modes 'x' and 'y'. It controls how far the knob rotates for a given drag distance.

    The drag distance needed to rotate the knob by the maximum turn angle is the reciprocal of the parameter value i.e. 1.0 / sens.

    The default value is 0.005 which equates to a drag distance of 200 pixels and the minimum permitted value is 0.0025 (400 pixels).

    Returns

    this control

    Parameters

    • svty: number

      ≥0.0025

    Returns CvsKnob

  • This sets the event handler to be used when this control fires an event. The parameter can take three forms:

    1. Arrow function definition
    2. Anonymous function definition
    3. Named function declaration

    Returns

    this control

    Parameters

    • event_handler: Function

      the function to handle this controls event

    Returns CvsKnob

  • Make this control visible

    Returns

    this control

    Parameters

    • Optional cascade: boolean

      if true show children

    Returns CvsBaseControl

  • Shrink the control to fit contents.

    To shrink on one dimension only pass either 'w' (width) or 'h' (height) to indicate which dimmension to shrink

    Returns

    this control

    Parameters

    • Optional dim: string

      the dimension to shrink

    Returns CvsBaseControl

  • The track can be divided up into a number of domains separated with major ticks. The major domains and be further divided into subdomains separated with minor ticks. If the final parameter is true then values returned by the slider are consrained to the tick values.

    Returns

    this slider object

    Parameters

    • major: number

      the number of major domains on the track

    • minor: number

      the number of minor domains between major ticks

    • Optional stick2ticks: boolean

      slider value is constrainged to tick values

    Returns CvsBaseControl

  • Sets the size of the text to use in the tooltip

    Parameters

    • Optional tsize: number

      text size for this tooltip

    Returns CvsKnob

  • Create a tooltip for this control

    Returns

    this control

    Parameters

    • tiptext: string

      the text to appear in the tooltip

    • duration: number = 1600

      how long the tip remains visible (milliseconds)

    Returns CvsKnob

  • Sets the width of the track surrounding the central knob-grip. The value will be constrained so the minimum width is 6 pixels upto the radius of the knob.

    The track is used to display current value bar as well as any user specified ticks.

    Returns

    this control

    Parameters

    • tw: number

      the width of the value track

    Returns CvsKnob

  • Sets the maximum angle the knob can be turned in degrees. Angles outside the range >0° and ≤360° will be ignored and the current turn angle is unchanged.

    Returns

    this control

    Parameters

    • ang: number

      max.turn angle >0 and ≤360 degrees

    Returns CvsKnob

  • If the parameter value is withing the slider limits it will move the thumb to the appropriate position. If no parameter is passed or is outside the limits this methods returns the current slider value.

    Returns

    the current value or this slider object

    Parameters

    • Optional value: number

      the selected value to be set

    Returns number | CvsBaseControl

Generated using TypeDoc