VDJPedia

Ingreso rápido:  


 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
  • colorVocal set the color for the Vocals (VirtualDJ 2021+)
  • colorInstru set the color for the Instrumental (VirtualDJ 2021+)
  • colorBeat set the color for the Beat (VirtualDJ 2021+)
  • colorNoVocal set the color for when the Vocals are killed (VirtualDJ 2021+)
  • colorNoInstru set the color for when the Instrumental is killed (VirtualDJ 2021+)
  • colorNoBeat set the color for when the beat is killed (VirtualDJ 2021+)
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