diff --git a/source/_static/controllers/numark_scratch.svg b/source/_static/controllers/numark_scratch.svg new file mode 100644 index 0000000000..138f9b21d5 --- /dev/null +++ b/source/_static/controllers/numark_scratch.svg @@ -0,0 +1,2 @@ + + diff --git a/source/_static/controllers/numark_scratch_performancepads.svg b/source/_static/controllers/numark_scratch_performancepads.svg new file mode 100644 index 0000000000..369897d54e --- /dev/null +++ b/source/_static/controllers/numark_scratch_performancepads.svg @@ -0,0 +1,2 @@ + + diff --git a/source/chapters/appendix/commandline_dev_tools.rst b/source/chapters/appendix/commandline_dev_tools.rst index e5c322f60e..70efc0831b 100644 --- a/source/chapters/appendix/commandline_dev_tools.rst +++ b/source/chapters/appendix/commandline_dev_tools.rst @@ -46,7 +46,7 @@ types, go to :ref:`file-format-compatibility`. --settings-path PATH Top-level directory where Mixxx will look for user settings files such as the library database and preferences configuration file. ---disable-vumetergl Do not use OpenGL vu meter +--enable-legacy-vumeter Do not use OpenGL vu meter --controller-debug Log all controller data Mixxx sends and receives as well as scripts it loads. --controller-abort-on-warning The controller mapping will issue more diff --git a/source/chapters/appendix/mixxx_controls.rst b/source/chapters/appendix/mixxx_controls.rst index 05e2b34f70..184cade0c1 100644 --- a/source/chapters/appendix/mixxx_controls.rst +++ b/source/chapters/appendix/mixxx_controls.rst @@ -2893,10 +2893,13 @@ Then you can use your :term:`MIDI` controller to control its volume and some oth .. note:: Although the first auxiliary group is named :mixxx:cogroupref:`[Auxiliary1]`, the group for the first microphone is just called :mixxx:cogroupref:`[Microphone] <[MicrophoneN]>`, not :mixxx:cogroupref:`[Microphone1] <[MicrophoneN]>`. -.. mixxx:control:: [MicrophoneN],input_configured +.. mixxx:control:: [ChannelN],input_configured + [MicrophoneN],input_configured [AuxiliaryN],input_configured 1 if there is input is configured for this channel, 0 if not. + In the case of :mixxx:cogroupref:`[ChannelN]` it corresponds to + Vinyl Control. A configured input is required to enable :mixxx:coref:`[ChannelN],passthrough` :range: binary, read-only :feedback: Configured channel in the sound preferences. @@ -4543,7 +4546,8 @@ In the meantime, skins and controller mappings that still use them will keep wor :range: binary :feedback: Waveform view - Loads the currently highlighted song into the first stopped deck + Performs the same action action like :mixxx:coref:`[Library],GoToItem` does when the tracks table has focus, + just regardless of the focus. .. deprecated:: 2.1.0 Use :mixxx:coref:`[Library],GoToItem` instead. diff --git a/source/hardware/controllers/numark_scratch.rst b/source/hardware/controllers/numark_scratch.rst new file mode 100644 index 0000000000..2955f65ae7 --- /dev/null +++ b/source/hardware/controllers/numark_scratch.rst @@ -0,0 +1,116 @@ +.. _numark_scratch: + +Numark Scratch +============== + +The Numark Scratch is a 24-bit 2 channel mixer designed for the scratch DJ. +It's equipped with an InnoFader crossfader and 8 performance pads across 3 modes, and +6 dedicated software FX selectors with dual toggle triggers. The Scratch is DVS ready under Mixxx + +- `Manufacturer’s product page `__ +- `Serato DJ Hardware Page `__ +- `Owner’s Manual `__ +- `Driver Download Page `__ +- `Mapping Forum Thread `__ + +.. versionadded:: 2.4.0 + +Drivers +------- + +You can download the latest Windows driver from the `manufacturer’s website `__. +The Scratch is class complaint on Mac and Linux. + +Audio Setup +----------- + +The mapping relies on the following channel assignments: + +===================== ================ +Output Channels Assigned to +===================== ================ +1-2 Master +3-4 Headphones +===================== ================ + +===================== ================ +Input Channels Assigned to +===================== ================ +1-2 (CH 1 Line/Phono) Vinyl Control 1 +3-4 (CH 2 Line/Phono) Vinyl Control 2 +5-6 (Mix) Record/Broadcast +===================== ================ + +The microphone, and external inputs are mixed +together in input channels 5-6, so Mixxx can record and broadcast them. + +The knobs for :hwlabel:`MASTER`, :hwlabel:`BOOTH`, :hwlabel:`MIC LEVEL`, :hwlabel:`MIC TONE` and :hwlabel:`CUE GAIN` are controlling the hardware mixer of the built-in audio interface. +Hence, turning the knobs will not change values in the Mixxx :term:`GUI` and you’ll need to set the Mixxx knobs to their default values when using the controller: + +- Set the master/booth/headphones/microphone levels to 100% (knob center position) + +.. note:: + The :hwlabel:`PC / LINE/PHONO` switches work only if the :guilabel:`Vinyl Control` input channels are assigned to software inputs. + So even if you do not intend to use timecode vinyl but want to pass through line or phono inputs directly to the left/right deck, you need assign these channels in the Sound Hardware preferences. + +Controller Mapping +------------------ + +Schematic +~~~~~~~~~~~~~~~~~~~~~~ + +.. figure:: ../../_static/controllers/numark_scratch.svg + :align: center + :width: 100% + :figwidth: 100% + :alt: Numark Scratch (schematic view) + :figclass: pretty-figures + + Numark Scratch (schematic view) + +======== ================================================== ========================================== +No. Control Function +======== ================================================== ========================================== +1 CHANNEL EQ/GAIN Adjust volume & the high / mid / low EQs per channel +2 :hwlabel:`BOOTH` Adjust Booth output level +3 :hwlabel:`MASTER` Adjust Master output level +4 :hwlabel:`LINE/PHONO` & :hwlabel:`PC` Toggle between LINE / PHONO or PC per channel +5 CUE :hwlabel:`MIX` Adjust monitoring between CUE and PGM +6 CUE :hwlabel:`GAIN` Adjust CUE level +7 FX :hwlabel:`DRY / WET` Adjust FX wet/dry depth +7 :hwlabel:`SHIFT` :hwlabel:`DRY / WET` Adjust the metaknob for all effects in the chain. +8 FX SELECT Toggle single FX +8 :hwlabel:`SHIFT` + FX SELECT Toggle multiple FX selections at the same time +9 FX :hwlabel:`HOLD / ON` paddle Push up to toggle FX on or push down to toggle FX momentarily +10 :hwlabel:`CUE` Press to cue channel for monitoring in headphones +11 :hwlabel:`SHIFT` Used with other controls that have SHIFT modifier function +12 CROSSFADER Crossfade audio between channel 1/2 +13 X-FADER :hwlabel:`REVERSE` & :hwlabel:`SLOPE` Toggle crossfader reverse, & adjust between crossfader curves +14 CHANNEL FADER Adjust per channel volume +15 PERFORMANCE PADS SEE PERFORMANCE PADS SECTION FOR MORE INFO +16 :hwlabel:`LOOP -/+` Turn right/left to increase/decrease loop size, press in to toggle loop on/off +16 :hwlabel:`SHIFT` + :hwlabel:`LOOP -/+` Turn for Library scroll, press in to load selected track to deck, double press to load instant double +17 :hwlabel:`FILTER` Adjust hardware Filter per channel +18 MIC :hwlabel:`TONE` & :hwlabel:`MIC` level Adjust microphone tone & level +======== ================================================== ========================================== + +Performance Pads +~~~~~~~~~~~~~~~~ + +.. figure:: ../../_static/controllers/numark_scratch_performancepads.svg + :align: center + :width: 65% + :figwidth: 100% + :alt: Numark Scratch (performance pads) + :figclass: pretty-figures + +To change modes, press the PAD MODE button repeatedly, which +will cycle through the available pade modes, which are as follows: + +**CUE** mode: Pads 1-4 trigger the respective hotcues, and if no hotcue point is set on that pad, will set a Cue point +in the respective pad/slot. Holding SHIFT while pressing a pad will clear the Cue point from that pad. + +**SAMPLER** mode: Press pads 1-4 to trigger samples loaded into the sample slot. Hold SHIFT while pressing a pad to +stop the sample playback once triggered. + +**ROLL** mode: In this mode holding pads 1-4 activates a loop roll of varying sizes. Release the pad to exit the loop roll.