VDJPedia



 Skin songpos

Back to Skin SDK

Skin SDK: The <songpos> element



The songpos is a special slider that is used to display and set the song position, display the song's structure, it will also display your Hot Cues and other POI markers.

Basic - this is your standard horizontal waveform as seen in most skins.
The syntax of the songpos element is <songpos deck="" colorPlayed="" colorBass="" colorMed="" colorHigh="">
  • deck is the deck number the element will apply to
  • colorPlayed set the color to display once the song has been played
  • colorBass set the color for the low frequencies
  • colorMed set the color for the medium (mid) frequencies
  • colorHigh set the color for the high frequencies
n.b. colorBass, colorMed and colorHigh are optional (VirtualDJ will automatically use default colors if not define) and only used when coloredWaveforms is set to monochrome.

The <songpos> element has these sub-elements :
  • <pos x="" y=""> : give the position of the element.
  • <size width="" height=""> : Give the width and height of the element.
  • <cues> : The <cues> elements has these sub-elements:
    • <size width="" height=""> : Give the width and height of the cue sprite
    • <up x="" y=""> : give the cue sprite graphic
    • <down x="" y=""> : give the graphic to be used when the cue is pushed
    • <over x="" y=""> : give the graphic to be used when the mouse is over the cue
    • <clipmask x="" y=""> : Give the coordinate of the B&W graphic that should be used as a clip mask when drawing the cue
Example:
<songpos deck="left" colorPlayed="#00a5e4" colorBass="#00567a" colorMed="#00a5e4" colorHigh="#7fc8e9" >
<size height="45" width="250"/>
<pos x="100" y="350"/>
<cues>
<size width="18" height="52"/>
<clipmask x="344" y="1140"/>
<up x="363" y="1140"/>
<down x="363" y="1140"/>
<over x="401" y="1140"/>
</cues>
</songpos>

Special - in principle exactly the same as above but some additional options.
The syntax of the songpos element is <songpos deck="" orientation="" waveform="">
  • deck is the deck number the element will apply to
  • 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
It has all the properties and definitions of a <slider>, plus those:
  • <down x="" y=""> : Give the graphic to use for portions of the song not played yet, and without any volume
  • <volume x="" y=""> : Give the graphic to use for portions of the song not played yet, and with a maximum volume (the display will be a fade between down and volume)
  • <selected x="" y=""> : Give the graphic to use for portions of the song already played, and without any volume
  • <volumeselected x="" y=""> : Give the graphic to use for portions of the song already played, and with a maximum volume (the display will be a fade between selected and volumeselected)
  • <upselected x="" y=""> : Give the graphic to use for background of the played part
  • <cues> : Define the sprites to be used as CUE markers. Includes the following definitions :
    • <size width="" height=""> : Give the width and height of the cue sprite
    • <up x="" y=""> : give the cue sprite graphic
    • <down x="" y=""> : give the graphic to be used when the cue is pushed
    • <over x="" y=""> : give the graphic to be used when the mouse is over the cue
    • <clipmask x="" y=""> : Give the coordinate of the B&W graphic that should be used as a clip mask when drawing the cue





Back to Skin SDK