
/////////////////////////////////////////////////
//
//  DMC1/DAC2 Mapper for VDJ 4.0, DMC1 Optimized 
//
//  Version 1.0
// 
//  Core code:     jpboggis 
//  Modification:  Pern
//
/////////////////////////////////////////////////



-----------------------------------------------
Note:  This Mapper only works 100% with VDJ 4.0
-----------------------------------------------


This mapper is Using jpboggis excellent mapper code as a base and also parts of halo_djk's latest mapper functionality. Thanks to both of them. 

I made this mapper since i really wanted to have this functionality on my DMC1, and every DMC1/DAC2 mapper at the moment use the [ FX ] button that the DMC1 doesn't have. With this mapper i now have almost total controll over all important functions in VDJ 4.0 without using extra controllers/Kbd etc.

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


-------------------
- DMC Optimized ? -
-------------------

First, This mapper works with both DMC1 and DAC2.

In this mapper, functions using the [ FX ] button on DAC2 are also mapped to other buttons on the DMC1.
Some button-combinations that works on DAC2 doesn't work on the DMC1, this is corrected so that they also works on the DMC1.



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

Just copy the dmc1mapper.dll file to the same folder as Virtualdj.exe. Then start VDJ to use it.
If you want to uninstall it, just delete the DLL file.


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

 
---------------------
-- 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 Function keys --
------------------------

* [ Play/Pause ]
Pressing this button generates a PLAY/PAUSE. Using [ SHIFT ] + [ Play/Pause ] generates a STUTTER PLAY. Using [ WAITLIST ] + [ Play/Pause ] plays the selected loop Sampler.


* [ CUE ]
Pressing the [ CUE ] button makes a track stop. [ SHIFT ] + [ CUE ] sets CUE Pos #1. 
[ WAITLIST ] + [ CUE ] autocues to the first beat of the song.


* [ + ]
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. To Lock Beatlock press 
[ Shift ] + [ Match ], to unlock, just repeat.  [ WAITLIST ] + [ MATCH ] generates a PITCH RESET.


* [ LOAD ]
Loads the selected Track into the player. [ SHIFT ] + [ LOAD ] (DAC2 only) toggles between Elapsed and Remain time in the players, note that time is calulated out for real time display taking pitch into account. The Progress Bar will also flash when the track has 30 seconds remaining, and faster when 10 seconds remain. 


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

* [ Inner wheel ]
This performs a track nudge to set cue points while not playing, and a mild pitch bend while playing. 
Hold [ Shift ] and then use the wheel to browse the record library. 

* [ Outer wheel ]
This is used to Seek throughout the track, if used with [ Shift ] it will 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. 


* [ >>| ]
Increase Loop time, loop length is shown on the left of the display. 


* [ 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.


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

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


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


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


// Note: DAC2 function only //
If you are using DAC2 you can also use the [ FX ] button.

* [ 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.



=====================
== Version History ==
=====================

2006-09-31: v 1.0 Release





