
/////////////////////////////////////////////////
//
//  DAC-2 Mapper for VDJ 4.1x                  //
//
//  Version 1.0, Optimized for video.          //
// 
//  By: Pern                                   //
//
/////////////////////////////////////////////////



If you have any problems, ideas or other suggestions about this mapper, 
just send me a message on the VDJ discussion forum  ( User name:  Pern ).


/ Pern



==================
== Installation ==
==================

Just copy the DLL-file to the folder: VirtualDJ\plugins\controldevice
If you want to uninstall it, just delete the DLL file.

Also note that at the moment you can only have ONE of my mappers
in the controldevice folder. 


==========================
== Mapper Functionality ==
==========================


The mapper uses four different "Modes" , These are

  - LOAD/CUE
  - PLAY 
  - PAUSE
  - BROWSE


** LOAD/CUE 
When a new song is loaded to a deck or when [CUE] is pressed.

** PLAY 
When [PLAY] is pressed and the song is playing.

** PAUSE
When pressing [PLAY] while the song is playing.

** BROWSE
For browsing the record library and selecta new song to load.


Some off these modes are indecated by the CUE and PLAY LEDs, more on that below.


When you start VDJ, the mapper starts in BROWSE mode.

 
---------------------
-- Generic Buttons --
---------------------

There are 2 buttons that doesn't have any functionality by there own and are only used 
in combinations with other keys, these are:

* [ WAITLIST ] 
* [ SHIFT ]


--------------------
-- Core Functions --
--------------------

* [ WAITLIST ] + [ CUE ] 
Sets the BROWSE mode, enables you to select and load a new song.
CUE and PLAY LEDs are flashing to indicate this mode.

Also note that you MUST stop [ CUE ] the song before you can activate
BROWSE mode. This so that you don't enter it by misstake.



* [ Play/Pause ] Pressing this button generates a PLAY/PAUSE. 
If the song is playing the PLAY LED is on, if it's paused
it's flashing.

- [ SHIFT ] + [ Play/Pause ] generates a STUTTER PLAY. 
- [ WAITLIST ] + [ Play/Pause ] plays the selected loop Sampler.


* [ CUE ] Pressing the [ CUE ] button makes a track stop. 
- [ SHIFT ] + [ CUE ] sets CUE Pos #1. If Mode = PLAY then it's HOTCUE #1.


* [ + ]
Pitch Bends the track forward while being pressed.


* [ - ]
Pitch Bends the track back while being pressed.


* [ MATCH ] Applies a Beatlock, Beatlock is released when you release the key. 
- [ Shift ] + [ Match ] Locks Beatlock. Just repeat to unlock.  
- [ WAITLIST ] + [ MATCH ] generates a PITCH RESET.


* [ LOAD ] Loads the selected Track into the player (In BROWSE mode).
- Left Deck [ SHIFT ] + [ LOAD ]  toggles between Elapsed and Remain time in the players. 
- [ WAITLIST ] + [ LOAD ]  Loads the selected track into the playlist (In BROWSE mode).

The Progress Bar flash when the track has 30 seconds remaining, and faster when 10 seconds remain. 


--------------
-- Jogwheel --
--------------

These use the different "modes".

*** LOAD/CUE Mode: ***
- [ Inner wheel ] This performs a track nudge to set cue points. 
- [ Outer wheel ] This is used to Seek throughout the track.  


*** PLAY Mode: ***
- [ Inner wheel ] Does a mild pitch bend.. 
- [ Outer wheel ] This is used to Seek throughout the track.  


*** PAUSE Mode: ***  [ PLAY LED flashing ]
- [ Inner wheel ] This performs a track nudge to set cue points. 
- [ Outer wheel ] This is used to Seek throughout the track.  


*** BROWSE Mode: *** [ CUE + PLAY LED flashing ]
- [ Inner wheel ] Used to browse the record library .

- [ Outer wheel ] Used to change directories in the browser.  


-------------------
-- Loop handling --
-------------------

The Loop function of the mappper uses 3 buttons.

* [ |<< ]
Decrease Loop time, loop length is shown on the left of the display. 
The loop range is from 128 beats to 1/8th beat. 


* [ >>| ]
Increase Loop time, loop length is shown on the left of the display. 
the loop range is from 1/8th beat to 128 beats.


* [ GROUP ]
Apply Preset Loop as shown in the display, a second press will exit the loop. When player 
is in loop play mode, "SINGLE" is shown in the display. Note that 1/8th beat shows as -8, 
1/4 shows as -4 and half beat shows at -2. 128 beats shows as "28"


---------------------
-- Effect handling --
---------------------

* [ FX ]
This button activates/deactivates the selected effect.

* [ SHIFT ] + [ FX ] 
Selects the next effect in the effect list and makes it the active one.


* [ WAITLIST ] + [ FX ]
Selects the previous effect in the effect list and makes it the active one.


---------------------------
-- Loop Sampler handling --
---------------------------

* [ WAITLIST ] + [ Play/Pause ]
Playes the selected Loop Sample.


* [ WAITLIST ] + [ + ]
Selects the next loop sample in the list and makes it the active one.


* [ WAITLIST ] + [ - ]
Selects the previous loop sample in the list and makes it the active one.



--------------------
-- Video handling --
--------------------

* [ LOOP/PREVIEW ]
This performs a Video Transition to the other player. A quick tap will just switch video to the new player with no transition. Pressed and held, [ LOOP/PREVIEW ] will perform a transition using your selected transition. The Transition will only be applied for as long as you hold the button,  For a full transition you'll need to hold the button for about 4 seconds.



* Left Deck [ SHIFT ] + [ + ]
Selects the next transition in the transition list and makes it the active one.


* Left Deck [ SHIFT ] + [ - ]
Selects the previous transition in the transition list and makes it the active one.



* Right Deck [ SHIFT ] + [ + ]
Selects the next video effect in the video effect list and makes it the active one.


* Right Deck [ SHIFT ] + [ - ]
Selects the previous video effect in the video effect list and makes it the active one.



* Right Deck [ SHIFT ] + [ LOAD ]
Activates/deactivates the selected video effect.



--------------------------------------
-- Working with the Playlist in VDJ --
--------------------------------------

The Playlist can be used with this mapper to load requested songs to or
any song that you want to have easy access to later. 


** This only works in BROWSE mode.
**   [ WAITLIST ] + [ CUE ] to enter it when Deck is NOT playing.

- Loading a song to the Playlist:
Select the song that you want to add to the Playlist with [ Inner jogwheel ],
then press [ WAITLIST ] + [ LOAD ] to load it to the Playlist.


- Loading a song from the Playlist to the Deck:
If you press [ Waitlist ] and turn the [ Inner jogwheel ] you can browse the 
playlist. Select a song and press [ LOAD ] to load it to the Deck.



////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////

Version History:


2006-10-20 : v 1.0

- First release








