VDJPedia



 Skin Slider

Back to Skin SDK

Skin SDK: The <slider> element



The syntax of the slider element is <slider action="" dblclick="" rightclick="" panel="" visibility="" orientation="" direction="" relative="" os="" visibility="">.
Properties :
  • action is a VDJ Script action that will be performed from the slider
  • rightclick can specify a different value if the slider is clicked with the right mouse button
  • leftclick can specify a different value if the slider is clicked with the left mouse button
  • dblclick can specify a different value if the slider is double-clicked
  • visibility define the % transparency of the graphics. VDJ script actions that return true or false to specify when the slider will be visible or not. Tip: if you have lots of sliders with the same visibility, it is suggested and less cpu consuming to nest all buttons inside a panel with the same visibility (see Panel)
  • panel provide the name of the panel that the slider is part of. Should be avoided. It is suggested to nest elements inside a <panel> (see Panel element)
  • orientation : Possible values:
    • horizontal, for a simple horizontal slider
    • vertical, for a simple vertical slider
    • circle, for a circular slider
    • round, for a knob-like button
    • 2d, for a X-Y 2 dimensions slider
  • direction (horizontal and vertical sliders only) : possible values: "up" (default) or "down"
  • relative : if set to "yes", the slider will move its associated value relatively
  • os : use os="mac" or os="pc" if you need to display the element only when VirtualDJ is running on Window or Mac Do not include os="" if you want the element to be displayed on both platforms.
  • visibility Set to true|false or provide a VDJ script actions that returns true or false, to specify when the element will be visible or not.


Children :
  • <size width="" height=""> : Give the width and height of the slider
  • <pos x="" y=""> : Give the position of the slider on the screen
  • <up x="" y=""> : Give the coordinate of the graphic to use when the slider is normal
  • <selected x="" y=""> : Give the coordinate of the graphic to use when the slider is selected
  • <clipmask x="" y=""> : Give the coordinate of the B&W graphic that should be used as a clip mask when drawing the slider
  • <mousemask x="" y=""> : Give the coordinate of the B&W graphic that should be used as a mask to decide if the mouse is over the slider
  • <mouserect x="" y="" width="" height=""> : Set a simple rect zone as a mouse mask
  • <mousecircle x="" y="" r=""> : Set a simple circle zone as a mouse mask
  • <fader> (horizontal and vertical sliders only) : The definition is the same as a <button> element without an action, and it will act as a fader for the slider
  • <circle x="" y="" anglemin="" anglemax="" sectsize="" direction=""> (circle sliders only) : define the circular slider geometry with these properties:
    • x : center of the circle
    • y : center of the circle
    • anglemin : angle (in degree) for the zero position of the slider
    • anglemax : angle (in degree) for the maximum position of the slider
    • sectsize : if not zero (default value), the slider will have a "fader" of sectsize width
    • direction : possible values: "cw" (default) or "ccw"
  • <fader move="" sensibility=""> (round sliders only) : The move possible values are "full", "horz", "vert", "v" or "circ".
    The <fader> element may contains these children:
    • <pos x="" y="" nb="" nbx=""> : give the coordinate of the graphics to use for the slider (depending on the slider value). If nbx is specified, the graphic is split on several rows
    • <over x="" y="" nb="" nbx=""> : give the coordinate of the graphics to use when the mouse is over the slider
  • <fill> (for round sliders only)
    The <fill> element contains the following children
    • <off x="" x=""/> : define the off graphics for the "ring" of a round slider (when at 0%)
    • <on> x="" y=""/> : define the on graphics for the "ring" of a round slider (when at 100%)




Back to Skin SDK