From b9abc7ec029a36ba3ce775fdf80211396fd0d1a2 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Tue, 17 Nov 2020 20:30:12 -0500 Subject: [PATCH 01/41] Traktor S3: manual --- .../native_instruments_traktor_kontrol_s3.jpg | Bin 0 -> 120730 bytes .../native_instruments_traktor_kontrol_s3.rst | 161 ++++++++++++++++++ 2 files changed, 161 insertions(+) create mode 100644 source/_static/controllers/native_instruments_traktor_kontrol_s3.jpg create mode 100644 source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst diff --git a/source/_static/controllers/native_instruments_traktor_kontrol_s3.jpg b/source/_static/controllers/native_instruments_traktor_kontrol_s3.jpg new file mode 100644 index 0000000000000000000000000000000000000000..cc6fabb7addcbe8b553ec765e1b340d472282194 GIT binary patch literal 120730 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

{1PS*y{&e5N}`O=X}W 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

{zdbm9HJMT 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�P9hxm~mtv5Z=#`pQS=@-uenw39NWU&hD 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 G`2PS}gENBw literal 0 HcmV?d00001 diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst new file mode 100644 index 0000000000..513349e01c --- /dev/null +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -0,0 +1,161 @@ +Native Instruments Traktor Kontrol S3 +===================================== + +.. versionadded:: 2.3.0 + +.. figure:: ../../_static/controllers/native_instruments_traktor_kontrol_s3.jpg + :align: center + :width: 100% + :figwidth: 100% + :alt: Native Instruments Traktor Kontrol S3 (top view) + :figclass: pretty-figures + + Native Instruments Traktor Kontrol S3 (top view) + +References: + + - `Manufacturer's product + page `__ + - `DJTechTools + review `__ + - `DJWORX + overview `__ + +The Kontrol S3 is an introductory 4 deck controller with good build +quality and integrated sound card. This is the first controller released +with the "S3" name. + +The Kontrol S3 can run from USB bus power. Using the separate power +supply increases the brightness of the LEDs, which is helpful for using +it in daylight, and increases the volume of the headphone output. + +Compatibility +------------- + +Controller +~~~~~~~~~~ + +The Kontrol S3 is a USB class compliant audio and HID device, +so it is compatible with Mixxx without any proprietary drivers on +GNU/Linux and Mac OS X. On Windows, it is recommended to install the +`driver from Native +Instruments `__ +and select the ASIO sound API in the Sound Hardware section of Mixxx's +Preferences. + +With the S3 plugged in, a MIDI device is listed as an available +controller in Mixxx's Preferences. The controller uses +HID for the knobs, buttons, and other components on the device, so the +mapping can only be loaded when you select the HID device on the left +side of Mixxx's Preferences. + +Mapping description +------------------- + +Note that Mixxx doesn't have the concept of a single "master" deck for +sync. Instead, push and hold the sync button to "lock" sync on for all +decks you want to remain in sync. Or you can push Shift + Sync to lock +sync on. Refer to `the Mixxx +manual `__ +for details. + +Mixer +~~~~~ + + - Gain, equalizer high/mid/low, and cue (headphones) + behave as labelled. + - FX Enable buttons: See Effect section below. + - Filter: controls QuickEffect superknob. This controls the Filter + effect by default, but a different effect can be chosen in the + Equalizer section of Mixxs's Preferences. + - EXT: The EXT button changes the fourth channel pregain (knob), pfl, and volume (slider) adjustments to operate with the Microphone input. The microphone does not respond to EQ or effects. + - Shift + EXT: Switches input from Mic to Line and back again. + +The Master Volume knob on the S3 controls the volume of the S3's master +output in hardware, so it does not affect the software master gain knob +in Mixxx by default. You can hold shift and turn the knob to adjust Mixxx's +master gain. Note that this will still also adjust the hardware gain, so +after you release shift you'll need to adjust the knob again. + +Peak display is only generated from software. So if +you see clipping indicated, lower the gain of the playing decks or use Shift + Master Volume. + +Decks +~~~~~ + + - Pressing the library knob: Load track selected in library to the deck. + - Shift + pressing knob: Eject track. + - Small play button: While held, plays the current track in the preview deck. If you rotate the library knob while you hold the play button, Mixxx will scan through the track being previewed. + - Star button: This button is not used (yet). + - List-plus button: Adds the current track to the Auto DJ list. + - View button: move focus of library control between left-hand tree and main list. + +Transport Mode Buttons +~~~~~~~~~~~~~~~~~~~~~~ + + - REV: Activates a reverse-roll (aka "censor") effect. + - Shift + REV: Turns on reverse playback mode. + - GRID: Turns on Quantize mode. + - FLUX: Turns on Slip mode. + - JOG: Hold to use the wheels to quickly scroll through the track + +Looping +~~~~~~~ + + - Right Encoder Turn: double/halve loop size. + - Right Encoder Press: activate loop of set size from current position. + - Shift + Right Encoder Press: Toggles the existing loop on and off. + - Left Encoder Turn: Beatjump forward/backward. + - Shift + Left Encoder Turn: Adjust beatjump size. + - Left Encoder Press: Activates beatloop roll. + - Shift + Left Encoder Press: Activates a loop and then stops. + +Rate / Keylock +~~~~~~~~~~~~~~ + +There are two ways the rate sliders can be mapped: Absolute, and Relative. Absolute mode is the default. In this mode, the position of the pitch slider matches the on-screen pitch slider position. If the sliders are misaligned, Mixxx engages "soft takeover mode" -- Mixxx won't update the value of the slider until the controller matches the GUI. In Relative mode, moving the slider always adjusts the value of the pitch slider, even if they don't match. + + - Absolute Mode: + - Keylock: Press to toggle keylock mode. + - Sync: Press to beatsync, or press and hold to activate Sync Lock Mode. + - Pitch slider: Adjusts playback speed. + - Shift + Pitch slider: Adjusts musical key + - Relative Mode: + - Keylock: Press to toggle keylock mode. + - Sync: Press to beatsync, or press and hold to activate Sync Lock Mode. + - Pitch slider: Adjusts playback speed. + - Keylock + Pitch Slider: adjusts musical key + - Shift + Pitch Slider: Allows the user to move the slider without any effect. + +Effects +~~~~~~~ + +The FX setup is unusual on this controller. Each deck has a single toggle button for effects, and on the right-hand side of the mixer there are five buttons that determine which effects are applied to every channel that has effects on. This means it is not possible to use the controller to select one effect for one deck, and another effect for another. You can still make these choices in the Mixxx UI, however. + +When the Filter Enable button is off, the knob still controls the default QuickEffect, even if that button is not lit in the FX section. When the Filter Enable button is on, the QuickEffect is only enabled if the Filter FX Select button is on. This means the QuickEffect is available on channels that don't have any other effects active. + +When turning Filter Enable off, Mixxx will use soft takeover so the QuickEffect doesn't suddenly activate. + +Mapping options +~~~~~~~~~~~~~~~ + +There are two user-friendly customizations possible on the S3: + + 1. Toggle between Absolute and Relative pitch slider mode. + 2. Customize the colors for decks A, B, C, and D. + +Making these changes is still a little awkward and we will be making +controller preferences easier to change in the future. For now you'll +have to make a small change to the mapping script file. Don't worry, the +actual edit only involves replacing a single word in a text file. + +1. Open Mixxx Preferences and select the Kontrol S3 in the side list. +2. You should see a series of tabs at the top of the preferences + window, one of which is "Scripts". Select that tab. +3. Select "Traktor-Kontrol-S3-hid-scripts.js". +4. Click "Open Selected File." +5. Either the file should open in an editor, or you should see a file + browser window with that file selected. If you see a file browser, + right click the file and select an option to edit it. +6. At the top of the file will be short instructions explaining what to + do. From 08935e166ec7323983cd5faf5ce8abc624c2592f Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Tue, 17 Nov 2020 21:04:22 -0500 Subject: [PATCH 02/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 513349e01c..0ad60ecd02 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -153,7 +153,7 @@ actual edit only involves replacing a single word in a text file. 2. You should see a series of tabs at the top of the preferences window, one of which is "Scripts". Select that tab. 3. Select "Traktor-Kontrol-S3-hid-scripts.js". -4. Click "Open Selected File." +4. Click :guilabel:`Open Selected File.` 5. Either the file should open in an editor, or you should see a file browser window with that file selected. If you see a file browser, right click the file and select an option to edit it. From 01c48c1ea0fb253e77cf2b3d508f3066318c9142 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Tue, 17 Nov 2020 21:10:28 -0500 Subject: [PATCH 03/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 0ad60ecd02..77dc0becbc 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -152,7 +152,7 @@ actual edit only involves replacing a single word in a text file. 1. Open Mixxx Preferences and select the Kontrol S3 in the side list. 2. You should see a series of tabs at the top of the preferences window, one of which is "Scripts". Select that tab. -3. Select "Traktor-Kontrol-S3-hid-scripts.js". +3. Select :file:`Traktor-Kontrol-S3-hid-scripts.js`. 4. Click :guilabel:`Open Selected File.` 5. Either the file should open in an editor, or you should see a file browser window with that file selected. If you see a file browser, From eab118b7aaa9d8e561e4fbed56cd4dbfce4233f0 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Tue, 17 Nov 2020 21:21:20 -0500 Subject: [PATCH 04/41] Traktor S3: Address Notes --- .../native_instruments_traktor_kontrol_s3.rst | 97 +++++++++++-------- 1 file changed, 56 insertions(+), 41 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 513349e01c..3d7adc416b 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -1,6 +1,9 @@ Native Instruments Traktor Kontrol S3 ===================================== +.. sectionauthor:: + Owen Williams + .. versionadded:: 2.3.0 .. figure:: ../../_static/controllers/native_instruments_traktor_kontrol_s3.jpg @@ -12,15 +15,6 @@ Native Instruments Traktor Kontrol S3 Native Instruments Traktor Kontrol S3 (top view) -References: - - - `Manufacturer's product - page `__ - - `DJTechTools - review `__ - - `DJWORX - overview `__ - The Kontrol S3 is an introductory 4 deck controller with good build quality and integrated sound card. This is the first controller released with the "S3" name. @@ -83,32 +77,44 @@ you see clipping indicated, lower the gain of the playing decks or use Shift + M Decks ~~~~~ - - Pressing the library knob: Load track selected in library to the deck. - - Shift + pressing knob: Eject track. - - Small play button: While held, plays the current track in the preview deck. If you rotate the library knob while you hold the play button, Mixxx will scan through the track being previewed. - - Star button: This button is not used (yet). - - List-plus button: Adds the current track to the Auto DJ list. - - View button: move focus of library control between left-hand tree and main list. +========================================== =========================================================================================================================================================================== +Control +========================================== =========================================================================================================================================================================== +Library knob press Load track selected in library to the deck. +:hwlabel:`SHIFT` + Library knob press Eject track. +Small play button While held, plays the current track in the preview deck. If you rotate the library knob while you hold the play button, Mixxx will scan through the track being previewed. +Star button This button is not used. +List-plus button Adds the current track to the Auto DJ list. +:hwlabel:`VIEW` button Move focus of library control between left-hand tree and main list. +========================================== =========================================================================================================================================================================== Transport Mode Buttons ~~~~~~~~~~~~~~~~~~~~~~ - - REV: Activates a reverse-roll (aka "censor") effect. - - Shift + REV: Turns on reverse playback mode. - - GRID: Turns on Quantize mode. - - FLUX: Turns on Slip mode. - - JOG: Hold to use the wheels to quickly scroll through the track +================================= ========================================================== +Control +================================= ========================================================== +:hwlabel:`REV` Activates a reverse-roll (aka "censor") effect. +:hwlabel:`SHIFT` + :hwlabel:`REV` Turns on reverse playback mode. +:hwlabel:`GRID` Turns on Quantize mode. +:hwlabel:`FLUX` Turns on Slip mode. +:hwlabel:`JOG` Hold to use the wheels to quickly scroll through the track +================================= ========================================================== Looping ~~~~~~~ - - Right Encoder Turn: double/halve loop size. - - Right Encoder Press: activate loop of set size from current position. - - Shift + Right Encoder Press: Toggles the existing loop on and off. - - Left Encoder Turn: Beatjump forward/backward. - - Shift + Left Encoder Turn: Adjust beatjump size. - - Left Encoder Press: Activates beatloop roll. - - Shift + Left Encoder Press: Activates a loop and then stops. +====================================== ================================================ +Control +====================================== ================================================ +Right Encoder Turn Double/halve loop size. +Right Encoder Press Activate loop of set size from current position. +:hwlabel:`SHIFT` + Right Encoder Press Toggles the existing loop on and off. +Left Encoder Turn Beatjump forward/backward. +:hwlabel:`SHIFT` + Left Encoder Turn Adjust beatjump size. +Left Encoder Press Activates beatloop roll. +:hwlabel:`SHIFT` + Left Encoder Press Activates a loop and then stops. +====================================== ================================================ Rate / Keylock ~~~~~~~~~~~~~~ @@ -116,16 +122,18 @@ Rate / Keylock There are two ways the rate sliders can be mapped: Absolute, and Relative. Absolute mode is the default. In this mode, the position of the pitch slider matches the on-screen pitch slider position. If the sliders are misaligned, Mixxx engages "soft takeover mode" -- Mixxx won't update the value of the slider until the controller matches the GUI. In Relative mode, moving the slider always adjusts the value of the pitch slider, even if they don't match. - Absolute Mode: - - Keylock: Press to toggle keylock mode. - - Sync: Press to beatsync, or press and hold to activate Sync Lock Mode. - - Pitch slider: Adjusts playback speed. - - Shift + Pitch slider: Adjusts musical key + + - Keylock: Press to toggle keylock mode. + - Sync: Press to beatsync, or press and hold to activate Sync Lock Mode. + - Pitch slider: Adjusts playback speed. + - Shift + Pitch slider: Adjusts musical key - Relative Mode: - - Keylock: Press to toggle keylock mode. - - Sync: Press to beatsync, or press and hold to activate Sync Lock Mode. - - Pitch slider: Adjusts playback speed. - - Keylock + Pitch Slider: adjusts musical key - - Shift + Pitch Slider: Allows the user to move the slider without any effect. + + - Keylock: Press to toggle keylock mode. + - Sync: Press to beatsync, or press and hold to activate Sync Lock Mode. + - Pitch slider: Adjusts playback speed. + - Keylock + Pitch Slider: adjusts musical key + - Shift + Pitch Slider: Allows the user to move the slider without any effect. Effects ~~~~~~~ @@ -150,12 +158,19 @@ have to make a small change to the mapping script file. Don't worry, the actual edit only involves replacing a single word in a text file. 1. Open Mixxx Preferences and select the Kontrol S3 in the side list. -2. You should see a series of tabs at the top of the preferences - window, one of which is "Scripts". Select that tab. +2. There will be a box labeled Preset Info, and that box will have a section + labeled "Script Files". 3. Select "Traktor-Kontrol-S3-hid-scripts.js". -4. Click "Open Selected File." 5. Either the file should open in an editor, or you should see a file browser window with that file selected. If you see a file browser, right click the file and select an option to edit it. -6. At the top of the file will be short instructions explaining what to - do. +6. At the top of the file will be short instructions explaining how to edit + the file. + +Changes you make will take effect as soon as you save the file. + +References +---------- + + - `Manufacturer's product + page `__ From e99a83e569d827e83ea6ff3352e65062b7efc821 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Tue, 17 Nov 2020 21:22:05 -0500 Subject: [PATCH 05/41] Traktor S3: remove image --- .../native_instruments_traktor_kontrol_s3.rst | 9 --------- 1 file changed, 9 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 3d7adc416b..bb81c95d1c 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -6,15 +6,6 @@ Native Instruments Traktor Kontrol S3 .. versionadded:: 2.3.0 -.. figure:: ../../_static/controllers/native_instruments_traktor_kontrol_s3.jpg - :align: center - :width: 100% - :figwidth: 100% - :alt: Native Instruments Traktor Kontrol S3 (top view) - :figclass: pretty-figures - - Native Instruments Traktor Kontrol S3 (top view) - The Kontrol S3 is an introductory 4 deck controller with good build quality and integrated sound card. This is the first controller released with the "S3" name. From 6b731a258694a674eff6bb25c5a7e0eece3a6bf8 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Tue, 17 Nov 2020 21:22:22 -0500 Subject: [PATCH 06/41] Traktor S3: remove image --- .../native_instruments_traktor_kontrol_s3.jpg | Bin 120730 -> 0 bytes 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 source/_static/controllers/native_instruments_traktor_kontrol_s3.jpg diff --git a/source/_static/controllers/native_instruments_traktor_kontrol_s3.jpg b/source/_static/controllers/native_instruments_traktor_kontrol_s3.jpg deleted file mode 100644 index cc6fabb7addcbe8b553ec765e1b340d472282194..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 120730 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

{1PS*y{&e5N}`O=X}W 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

{zdbm9HJMT zq7;rw6_XBg$lvfo7DZ{I_YX^VXdZc5Zmm)>1lmsl;$D)$v{VkvcWNK91e_gz{SrmI zg&mS+9TT4VfXyYKj}%L5M!ZHAP}h|dEkP#iSQ|2MozhAYiJvEP2CDvvCM=D_q?;<$ z5K%2$Rbti&gAG@=$lP5#SF#x&!cPznU@Gtf{RsLp0jNtM|I>C{*mL0XN)ID=4_eCp$h>5o%qv^dL5#> z8`g_w+6nWL@7Pk94fD>V?oCgGV~ryAWYC7b=FPH0%#X0ib_n2h2+;eGn=`|Hce7CK zu5IkckO<(GiqLAsgk~yFfUVBteTEFg|Bqe|r@q zrE}8g?1oO+#w4N#ep04mo=^i`C4+gMLp-Y z+F#L#A)n%aGiLP8Kt~WECng5JBtKzUvypa%c*)WW97C@!V{_Kjhk+l#m{-{p+*kjI zK%Q_+aV5CVfbI9TlzOklUGHI66i{#5iAECY5}HPHt6?P+BwHHb?%@XWn1gj0;%PcY zkf*@3nyupshcKEAKugKW(?e5<5e@f8>lMA5{WiNrCWycI#RA;oV>ia`SEM9HYb7Oy zFi`8e*Hgop?2#JmWY${04i96}_4a(D&M)jylE5K5hTkVdUNqw>(6a8Kh#fGMV2)|F z1^@&+aFTF`dZU5mx~^|6C-|B5XN$>h>YNQaZ+WarL+)mNX!1a*Ob~=~*a~7gUyf0B zxu1_XDr!+$Q$$%80WN97k~n!#2_KY?p0zSB8XQ^gGeHuzcGI$o&QSb~7nG2F+LcVz zA@67;OBLlbc(Ni^*Ap)5X!P|^<00q=)_&NV2rUaC^We$a-e*8K! z*RDqGjm`VQi@q4DtOESq5$`qvEUR)myyS)T@q^Z8ZorQ66ZAAGPR5rXY~6Cjlk+hw ziabb^P<)#QmWSp$oxMiL)Q_*b%ym!0%w>8_w>4vODI73ss)i5xy9KQ>b_c#EXt|P9 zJE!Nh+@Ax(EV*D{cCnALT3T+E=ni8;77Mj?6y|gs6JQZH-}hfdxPTK_+yfaw4Q?B5 zXY>!ZwDB!)?w`=qd=e?p&Nc!fzT^3P{I5jH$heUUJOspH4AN{|2(CR-BM$>EA zufE%VK^TNwqEy5sqP#_xST3UKjk04Lj~(;(i~%e`m*sZe3;JHh0-v-5Q&IuK1G?)C zmo9=F08c!>vmiB*Y$RLKXEJLrP>ar_#tR`w|$ZKQ)wDF=3)C;C{AqGuJkRKFaXrEqp=Nx84&;?>YqDFNLW8 zQ^v;zYwN+ROV*WQHm=nKGd;(Kc;ZtD)UDr&ENDrkmy}M|J^FfXL|^R3vy-dwBbtV! zlU!wnJFM$_;}b9=u}ZBZ(Yr~x3ARAF9`~I$OqY~WB67odG-8W;0Q9YE5PsFKE}v3>3Xb zCD8V)ZSAO3<#?CUU5Z6dg>LSklS=_)Hnf=8iEZn@Dme8N_Lh3(Om>t7o#E_jdj9ZC z+1I{rAlRv}NAWQN3E3+c%Py%FicyR10GJbwi9frZBAZKJ9Um(Ly;GH)A}T*CV0r!U z35{m*>VPv5)mG=(jWwwJ(#$DQ9>s7N@w6b8jbc({I6lxYT&#c}S%yG556oXG5~ZKdJi-i=`IN!rj3d3|t`HA7gf<7ceE;yO%xiz;8r zb_;KuZpo=C2sF66b@rlDiUvC;tAZ^2q(*XPn7k1`3E8n-ezfI0#W_uisl2ao4SSU2 z!=lD>nHhd4^-jMMA7fli#@4s4-ijRSb|LwtkL2qO>)LvEOK5_1Uo0>@%;4h*zJgie z9}tF(YC$^*P!ZAKmT91XSLZD#3Y(ztksW`okM2^K)?sFV(54v|Vx8Nx^(-P(`Rqyc z$#~CIU=*1h6y>FdHjaA9;Pqdz6ybimVs{LD^ajAr)V0k?aa(3N!2scDrQva*4>OpT z*;y#gp>_j<`>~q=p3nrmB0-!emxlwf^)T>(s*c zE_PslF?jN2+oA2_no4t2Q&PMzrO+Q4{*<1H-lyRp8f9Jt?PayTHrtbu^^LT>FxxeU z^6KF{T!xOvY*h<4AuhAbG)W&PV~|@w6}6l^TsTF* ze2tS4Np?GSgCNKBxUP3pM4wj0K;xG$jWLem`Pv;*)Wy&|Rf~w?_sUi=5_WZg?Z)Z>=>|ecW<(`=u(d~_ie=t zV~7C#=Th3u7L67=hYVN3l0mCssP{7eAsvI(|ecQsd6Ty(2*k zqMEXYQW^?!CUU~X@RFg7aMkBDbs5>u7=h=l{Fudsfb^wuSwtR zp~y*AP_azBc@wYI!ji&@rw(5@-2&ZY-hC-faf@P!>;qm$nst2g7qOigpw{fi5D9X^ zb8-Ic7d^HZZN8^ntnKbvL#zW;sxq2O9X9>dznipY}LC(Tub>$-rsoA+z)8HwHJi zQp|rck4iVX8rlRBAzW0(*7<6)?PkNnaxgn9TJ=h0`NWf}6R2@6Zn8)ovXEt$^EUQJ zd6j`ry-C9r2q~)yG?Kb)zhJvW4AoApW^R5LxS?r_I>hlO0qs0?!e)tKwjDdmKd@L% zrA;>so}8Ihn!?$N?z{DkDQzIs6pc7EW_4F!R0nds(H5N_Gnme;w|rMtdPaL-MSpG% zNN){PmsEMm`U%ppSq}Ex+y$P)S2Xj3A8zE0+v+ABzSlQOMKQ{ z(O{tSw`M?RNa4v_H}Qiy=)^#6$+iBnib3UK{Z0HVT&ZMh0Q+Mrw9NKIwKz`oJWu8G zcq*=%bgF*yse{_J zX=xs_<>n8n2qlRH#pq!xZAvj4dB@h08r7amKM@bv0Rk4DxB1|7p!3aXxauQBd|5 z>>J5Jl0lakz)2}0T1s4C3a`A~nHUd|(}+@pznhjKAT_g;I)>OtLd}^W08g-0lU-@0 zTtXyg0S*3N`BYT3FFh zhZe;Xy#$D6OI&{0E%(*(mACkyX`@n%wnEhOQagW(>D$^>MFuD%ekIo%ixBYb+SU+t zr0@CK9=xmP3j&$T5!nc#pg5y607u#!>`7l<@J2||NKR0s&k$r{X6dS&IF&Xrg8u&e z#Vlf7oq!thOLwB&)p8U-H|oo&i+zClyWV6mD3cWDpOt= z`eEM~binys`%46JHRXO|0^3_P?gDjW1`g~%J(#VBD%n$~8UO3SbeJyS&RC{{drB=x z4-3DRj&ha`rhQHjq~)GvY9ik;marV!@)n#IIs<=oY9g`3uhnXUwj;RWx?OMu`NOYl zJ>cNp#&(*ycIhrmJ}(k8r>oCIO%T&Z$gmf9QAr(oMl?h#mBn`C*uqm5dhUZV*Q)uD z#fz7b8+}o+(XwE0Z2cGW)DWD{Wzlwa(x7;%^;<*Zy=ak5KS_53OphbHK$3gZ*uUFt zBHbq?!-c0OUB25@f|9vaPyRra+$WGerh)Sq;ym&B3PEwep*SL@1Z~)uLIqCFE~wqQ z)K7$VAO*c=Xsul7IV}~BT}zTKWZ>MjgOccc!KSRVa)4~B!{DtreBZYDsgYq5eZ=nO z%N0)TKQIA9JuHFTa?Cfy%^t(CR-&Tz?mUGg%bxor<{{7eet18K^&}#d%LFj6QINec zh+E6HIvA?`JsAbuKfZi!FXPb$jRD3rL9=#{y07`0p7}oraIe})^2>NQD^%?3Dw2PF zUEnKFM-olseZf|)V&>VuEx9qNEtH6e5e&a9!wT9iUCL&17K9N)lyrBPDoF7)YE}Ho+xbUq+xtfA06FY@&hH8AT zN!#efw_s9@6p)Mxk$)6ExfTWDp#2>=HHk%3N9T%#=zSekie1d=Cdu!5ftf4F=f65r z54sorqIN94-M}8quJu8?YeykAm=);-52w>BM$2c86=GruBf;; zM&QDJQ6Mh`xd=Magv$iCL;)q%HhMmk^d{@iFPJhhn|_2Z z>{Af2oAT}HyF>gkB3l}S$SpHKOL(E%`W5p;YJdV7cq{b{ago1oOSBK_*E}aV_6Y3y zF&KD`t$bkPPE+dasSh9#`U8iRR5XYWEOI5iMh@Z89tNv)N*%!#DE-*$n6(&F{%XJ^ zG<}X0!t?8MyGaxSv5-Kh3>K~CNbcK)FGTc%9#}m)!Bo`&Th%j5 zDg&Ipf7@*|uxYnH@JVwPR6!uwVT`61p~HxNSvkC^KiBjCObnXxm($8W|ZzkCdzd zByx{9nE7<$_IfZ4z43-gD9hS}{9FE>QRSfan zC__cVXD53#Y1fjEtqq($XiW4D4SkKqy*|2c-mFxBb*FDf{lPhWa=m8H_$=yLAV ze1BCnZRqRs?I*`H>q-3fH$=^Df!Rqv&DB(LDUo}&GRq(*HfS?jh7pZpMeUDD zI4HRhqMeh{5SOs0X7UIh?OqkZ!wK{=8DcC{A3x#fLq6)96U2_~fc^<>_-^!na{u9q z{ashg+(363N8U}dg?1LbrUi=FU4CF|vn?Xs{DZykP+25D`nBo?)qzz_TeA;YM@^`s z^^J$>=m6zsY-s1Vp9yK%YtYUtrWY6N!1qb^e_$}bU`+aC{W}}6AU@IrDnJz_B|WA_ z4!)?Kx3=g_z&|j}FiUk>7Py|NElSz(ZE_~ZWO z5u%7W1SalspEKW>$ms=bfIo_aRKu8U0X8J}rEd!>KDH!@{mlVExbG6Q)57F~bIJ8L zu!b|owvz3fCBjjl%R}{cWp;qyYh)jN)i_xusUu)*JoWW)D-lnyHgi8MlR&W=(@l69$s82+rza4ctfe_h6Awch<9&V(9;(@jnz8^ zj?7bVieh$SCw~burYz3B68UGlI|dNoL2iA1hS58|`fu@8Ssav!E(jU&SNIhxpX=&T?zUiaFALDX8wBraxTC$bZ;yo{QhXNt zQzV`>IA-urh26J`4vz=x;R@Ier4{>}!>|!~(+*V38iuQT({hrSt)$fK_Gt%dfyiE~ z?z*0|ekO*Z{?R1zsY)R`#qBDLdp{}8`;NP?fYYo7#4>_$4sqg9ZaRrAYbnekjnUKq zR3Cn;f)ElOjqjVnQi>Rgif(cdjC-P?$fey*6?-?Y6>estbwIp(&%WmNhp3w+ zBgcvR0L2JMY^41_T^n6`3c2TU4T52M{s?VC9#&4aKfvl$cU&tjC|`2^G~ofErvWB!Zr=O36Pykd`%ABf{*%KTy{d|KhDN~GC$L7xitS0o z%Fy?Pdq{2~IY4|YB_L@wM2Ax@B+{0D=s5nwVA|>0Oj9La0R@H2v(AF;)Q~Eez0Of} zcuVDj)zFLhj15sefQ&P$!mR1@^*iHw&Qf%k+Qprr;krO1bvG2>$*EgT^+&(+0i9-a z$r^5~PDWC2p|BAQBhAa2F=5wQZuQ9B;Aju~Hvj2!Wus4`bZjdO#|NlMxiRb@7?|~JOlKO@KrSFa(U|~1tI#DmK9wYA-*^L%*XeeUu z4e=3*U!LzQz8&};dU&B5@EJeLXZhl?M945Y>*6QAW*je80die@bJncGn%HNuQ<01% zubY*K*aWh}lr8kwMOMAKUSY!_mN%WvTQoeJzgKkVECe-jMsOVRF!eq?4)Gd4~2&iZs7 zUVFM7pW}DGq-?(cd3KWsS<}qebRhS85N$!}NKt)wv-IUlg&Wj)q9rH&!XKH=V+tU@ zZxFaoaD6=c=0t{Xk(@V(D$lXVbp$hCb4(vol;bAcV7Ib+47J!6)&M~dd*#w-hCXE) zJ+p=45`FhE85s5a}lz+o6(p9;(*KgBe z(}P{9_cbWJ?U5ScUel~pToE4(K75QK-gGbcKt_qsDwrU*U3-$}l75;GDO2{MI_v{0ulm%biC3=^G9E{)^*TEr~R(Foy*~R*JZCIi_Q5QQ>XG|T^iQ|>@q-o z;$9{3?@DqQ+g_sQ`r3G@5uF+Hf}=6|l_&cwZtdc++y!`%tTa(xq}qmf}EDS z>Vs->9s|CeJ=Xum;B5|xAF4DaQ@ydl48ZIR6C+@uoptMuhNw+3rA)sZ`UW)cdL-bA z`GEgA9<>z*i0l;I$GEbMe1B7ED*06BX%TamzeX*I^`{b6Mx2t@ze}2ow@OJEkJPC!=&4OtpiLa^oLh=GFSqI*^rD8`eZ-@0jl#vmz$L5;$Oh$?{SE25ymz`iJ*_$N%&4T<70wBfZTl zUZJB>`#ZO>Im2GZMC*|A!}Q!k*29kQ6SY?i8-esXw3izoIhVDo+X+_Hwdpb5j9B~1 zRbR@ZhSkgH&RFXpkk^_Cw$mu6I?N!b2yh)ge8TZ~ zIMdn1)^KWqM?UlXlk{`~E9U*lUy~oBdwfD7O4dcGyC7aEPPnLVs7wBs$B?88+%{TZ zZ})FAPw;X_*e6T8#Sub$G&s?&Myon=^I6B|Lu+PK8Mo!{I?$)g0;z7l_U(tMD{L6? zfw;fGl5NGjr(}%d=dJbq&Tk&8ZZaBC|Mq_e@;`I!zh^x*jOFdc@U67$7Qy5(XsPEP z7^yw134E=d z1MNzh%qo3F>L2tT)kaf3uZjC2yzamSEj`Z#k&8M=O>9@Q_E+&E(i%lNO^Io~+9`M` zYz{O1RCh8#bK9T_Xbc+Dp*YkM`I4Kk29|hDGjZYi-AnY76XT?+N71DU!)d+X9Q+SV z@Q(UWH}4-a+w(Wmz_^CLWm<<&Zpqrl-k-^e89`9{_U2FSzPuS|0h#J?Gb`a9H1L;smn|vo z=<8l9tssR04$N9_s+Yy~avL;`V)&pJ8X>6kaA<%of4QR^&ODVb7xC%|M6_{=7RcU*iUnwL9CQ;xFTUItz_r&bxj#~| z+>ls(xIe7Z6+KkY?(vP?5iRRQJ6+_%LnyMf0E`6JxmX*ab;Y#lpM2mcg+#i=lbO-<}eR zC<~*p*f;u#GVRHqgATO}8Lslo*_kLQwj3^LT)cc|1Wq0sHss(Rk@l3JNv67c3roEc z?~f>Me(WP@-}1avd*J|rFT6;|)|8hZaNgzz>O27)61W4i@sIGpt(vg|x2sTq?e*K= z9FXf>lhn;zLFr6Mn~L0vy8fBG(W>XBmBZ-#=bHummD2jJw-1ySWFEd#DD4JDcFl*b z!|s1JJ%8diCbg2ZTJ$JjwVJEw`?fB&uF{a87?fF+C*IS+O_JjQo0^pOWHg<;I-cr< zrECqIc|y?PZN=srxMlQL^ykPP3$a_C$^Ayy5~;1kk}-oK>58NyEwUBBC|-E5HfJ|@ zd4<0TFzSBV?*lk5%)MJ`tXG$`IPHe>G zJ3+rJ!G=Ihr1)@nx%dZkWd_aC)1q%Bv z6xVh=?My2)##0iUipX5SxP+hLdDONogqjca_y|ciZu@Hu*RQp#2tKCqaw`4)h-DI0 zm7{E(KbqR`BXU|=KDJb*@uye2N-5$x3mLBHKGuCTdegRY(TXwSOx{DY-cdN${!TcJ zxyWmdm@)ZIIAyOTLY>e7?M<`|7z-BQZME|iIXL{uz5RxN@R2^LN)SI2Qywbj_ zy_MYrtz^7WBgbvy3v6G$BgF@HDa&wCT#H;f#qr7z=sc#!x#iW}@bHI@*}iypLH(9z z;x7EQDtcVyrxUfaf%J?)+5xczLb?(UhK6%K*Aw#%Ywvo5dNy$@eoF?mAcIx6{{N;S z`d=sg|8E+UwuRigZl>+38nhuEfV`g|P8T2+qj%ST;q{PTXuUiU%}v6h!!(^qFLAr$ zsewt-x~e};08TUc`DiNX*^z4N|Ec4gAe`)O)SHWj$a?EbUdZBG(|HR z+Z>N0-%)gnQ=^hY@F1BOdE${M%zVX2N=#T#+H zzOIOfK9Nkp1?EUpQ`8#Yh2jBGG|L<(?Y@<>uttDu{zR%n@K=?V`oS5>wk7`(9aMy( z!W0Ds(kRLF0Mz^Gn<-lUKQKfTvie{bkq&P-wCt$smBgF%tWc{jf;RjuAHWfgW-RT( zKw#^-Kz@g-MRD<5B_}CF=XizPZcCBzXu=H+FI51u9U9EU#Lj?F z63^9x8-KbUpMzB5mjvD^*nK4ZLM#EEDC}5vt2?n#qYXP~E(r7r0C4)x-{qV(v==Ew=PQ5X zUHwz8WusyztJ|B~QK6%mm<(sGaaD(01--Ilt2^zQ(xNz4fj1^(#+gk}bFeJsv04g$ zYSA29oETnRC&AWrf(<9t;PRbNEemn!VrQ{O&!$%I5N9_Z>sUa%`ID3H7QyZ!&(O zs+p$@W9;e`En0HMRodE}Ux3rXC)8*EXaXx$Al(WHV_eodG~p=c1tr$Vp3gk&h1Drk zurQ5(cC3fCYqSv>{;(% z!&;~NZVBx*;&-OBOGk1e$(;d3!{^rO&+Y7m(<&EC`0Jh7aOch3ua$>WF-O}6&h&52 z9~>5r3N&70`eH%oCyZv&sF6C)mvNee4Ao#l^2QXkhnN-~uUnjJg5}Y3#_J8^J(_Eg zlNUeUY3$Ki`3pusMnTa_Y6gCs%7K}MtiqumhaC)HL5U=h9{J=z(aR{sE6>< zgwBiQ?pol&r4omcR1{7vV=#$1z#*#co9XcK>X7adp9Dvrhq#&gLr(TtrPSiiO@iL2 zs<#buuM)pG&8$m|{g)BJ1DqYQ2T9*bsRIRx0K@u0ig2XL*eD#!bfggS;po*5wgRnCfkh{AnId+Fk? zqyHVZLPVjb-k?vv`g5>Hf{Z~@nv?{;O_*dlPc$}pf4-tMjbS3OcJNgg(Wt5yyjP)E zD}J-BoJd2L@sZF--vKRZKef=vz=6_5kyxN%B1Y)XJ}{f2ufx;89)<&UJVMmqEx|_> zmXr$|PASpSbuO3*2o8eu43^`6F)Lbi_frXtNIglrdTnV%k7hq~MZEtfQWDk=R%S1< zcHeH-Qpw1eb$L6+iM}U^{{}Rw3M@S=N}N#@eKN*hBe#+YDWJ+(HLHt{-rsp63ty3$ zy0Ke34-56w7w5WCDdCJc6E*Y+#z~}JLFjBEPUJyF3!NXNEbc2i2we@X18Xk;dy=o? z-!b$L2~WX4&)1lWcx32F+7lf4Ueg*aIP~mVtPg|D0x{-2Aw&A}M>vo8|AhXs?xVVA zPwV$Wpyix!1bQ<&llzx&iIT#Sg81~(;-oBDeM3p?>~9t**|-IN0snF-WPJ3pPW`@{ zt4ny^!vQ<{9-po67(A*>95QKpVehVLLWfL^Q68OH)OT7OZRcc<1GR@x!fD%f)HJEWXZEZ@T4QHgtL!@_ves2!bE=Tw@*gNA!&y-F)bN;uP4wEW*PgnlWL z_8%BYTauHT$2-odYG2oV*F!j0%C|%_p%ZLEODN#O%m}>rm+mlhsKGQ&&lQCGNABuX zWqDGe#oe1C1w)zLv_P}>*sP=V-J1j>^o;CWi6;q(&QjshdHioS&J|eih9mX-E#QojAd!nLZaW z3fNUKT=o$hiY)V&1E3JSaECynq03E0OwY<+cu<+TQi*y5oav|q-Xh3eF0li{GW)xG19Ga@-Q#dGcu21Q&O=vp$aRz_)|1oR5vk@Q={k+NC&MBY&kveDHhUI)7x-;}ulz(LO*wu{ z`)n~rL@@cmh4f3-!V!}d#mG@XNlpms_tH#{iLO#T5>>=GXmChZOH|eIi$R>m!~=&T za|uFjj<=Ikp_I4mx6=Id)`P=ek;cDVbB}syYt`$i`ghI%D?{5wzw--$yG*f-n+vE7 zf^qtep47ir!5v4t`@#`MMqNHaIr5znOKS=RUhcbwoVX)U-UVrXuvV%Fpvt%?ae9RP zCkB4D8DFjH+#YM+_fy^yO(l8V2B=`Kxmm=pTkOSkCOe$wZBe9FFVpXWxn~u9YkZut zy7-|$L;=-h6A`9js~Vm4A*#mfvJra(B!NxcM*oh(2StkhOqS)s$k{gMCur=cO3Vlf z`9pTw%LYZhs(Nf+uI~i6axJ|a0-@tV%&LZ;;1-&@bn&~HqLWzP8L`LK2Rrth2M<;T zdaN3kiUqxDquN+vdDyM0tR)=5%KS6H&5woE5?!gl8DK3mMpQSp;P)PxK$TP~Ps!n# zCY@I{v(_``$so8^I?rWv*J_UyJA0OgrSVQPE+iqvk+!FD_3Y;#aV0WAI|_^@6-R*` z4od9j`73mDtdd>SgdO*0$%AZ0|SW|iFEH;#U1C=v?_(!P0{_i$`s|W1kS5Mr@4|mBU#0ZDD9(CLDA_@coi?Oj&f$C5#9^7NZhT#0Y1rIpqhGhSIBB8zqQ z0RdO?sNouMi}?tlahz51Ip2=YDW0(T$o$H$^GNIA>_>AY3_Xomp8=JH(f2cLgoI2Z zD9xN#<*{Z|m|T4>ypE1}6;yXH&OpFL#)yV(*U@}OPSzjQam+;6`d(qT-lrWD8Qe10 zx3&f2z`|`$6TWNbDouc`?y@h8-IigLiT}hCZa(D}X`MZwdnxNtMl~wen^!$HqpFjn zxeous&gfHpM_IIW{#Lzj1nrEh+>f=86?I|l)1V}|(VAN5bOShI4 zd3+kwmBw)sv{#o391|m(ooTNzCF80W!yb0?9(8gu%QP`ujs614NA|^JTqT@wT20A2 z3gZVO@P?k)7td*c;6BM>%qoGX9)p?b-JKhBoyG)T$Sx!$;XMXhuUnU>b-f&CjPRpn z`)@}D|G5F1E8cbag3{~RIw6=GXw0wMbCb48q)^+nnsWxzb4Vr?+)m0o=tYi#3`#5c7>imMXK!L)Z^oofgT~^Ze~s zwtxgKGWg!YI<2`DIUrUvMDOt6#FpjDRHC!}IaX+@K~~2mX<1x7E33P~Lth2< zkI3T{_LZomc@5*IY-_4PV@Uaf9$s19X{Dse_9v|Gv(a5$NlAYyI<^g7GGLE0L9(8(rd#3tI^-z!Uq&7-#nG5)q@+tuyk)HA7^&Nu^Ul zEYBi#3*&sn&$=bkA!`X7H3G5eIw+6BeP4Im;Fsif3aK3-JzAGj>1Zh-(9h|bWOUS6 zzeprMQu1Ie9oRXx^Wee2;@y^b9+@;YXiS~}FFu4mx|8F4wo}Y1j z1V$-9pJo=#5P)=&lvFtQ+NjG;u}SC27~4@#+F*z8+}-R)p!Sp!SwTc3tt9v;APWD(Zk~? z64M@T#h+f1aE=zTt?$K@_K}1HZHCJ7O2WK;7VZ{vFQ?tsmZ^Z(4Ywe{JiO01ux!{mFArLM$hDxp`HHu0>YhnCLK}-rW zH>!zy^C)8Zsr!c3znJ?kfF>c)t&oX4{iw(pOV!DGCD3Ywe2rM>PwXe_**&4?kb&Slq`|J(+IwzjB;Bj7?ks&d3*3I`W# zc+Z3uoo44)g(UJ$33EABF4*j?IPU{5exX^v0{a}0?<%YjTa4)eo`tD#$W)>t4cs69 zQ2@FJHA~0kS!xXbiBu>at%1JO&Qe6V$r4!-3Dlm&#_?YY@GqIFk$}-dB#W#K-fpn9 zGY73}*m!;$&xZcfW8p4}UEU3TP?Y$RRFraBwxK&m%tV`d5O@T_b=#Zmq&O347xhzP zNP+5laGC9FKRK!Ou{Z=OXloOi+LZ*PW#MV2(iE?H1>_&=ZqM6yNhHECfbQ8fi;?1z z@}%|NIwU@ip){r(SAcy3u*nD}B6`#*jomV3Ehr*u1?4()2E*CiDi~)>$Qx$n9YWdN z66%j+^1^-v>@M3Fw~_gJ9{F8kO>T?{dZ9W>8kCSdKsQ*H<%IK?!lw;#;gqdJ37X`z zK9~$<`XG7vt0bR)+I8lQpAEEdH<>c?`B@@J($KQ?sceW=ZwQ}I`AMn!~+#)kNn#x9f z>jD2Uzc5T?sZY>9WIf`5hn*>@2LsCv`E9yb9qf~8t$z5NR609bQJJAW)i}Bk(I-Y| z$wYsAGVz}YRga#inDujA@(`yMTTLtz*Mm40zStLJkFg!V1Gp89YVwk$eff#ZDtTz# zWSuU$CdU_YI-MiRnN?_#Qq$^1RF#G25vw?2zFp#Yx!rLc%+pD3zpHj5#_$REF!H(? zAgjk9aZgMJWfP+B0bk`ei|cvx@TPC5$`ip!vosIOzsSav8sSIhzW!sz0Abx6$+4*8B0 zZc^n{QEA=H)`TxMQZT425u)G`*F@GD+nDQT>>`G?pk7+d5H<@sI!;5k@S$IiV-<=~ zgKLA|{G&`?ioXN99mV)&(%-_p}u< zS6S5j`%}7>njiEV3Nn3ZreN^HvWIlsGTo5*hLZi9ozEXf#J>O3i??{HF0ZP*z-Dr; zFg)iH;nPB6VL`*6ekaloU<;|`{gr~W_Q&omVLd}WilHld)bT@836=%}+r|Vw+KElr za47jzdLysooi$^84@nm3&xQ1Ow92B+i6YyWBG1xFK3337TLq&*2>v?Ft>OR;ID$4& zMA+e_NCGqidA+?t*>tAfKS|b-VAlfmZBR_KLq@X`Hwj=}<7%3cV-(cV`+^jb@j7B4 zo3wT90PP~Dyc@S4wbWsLbj9Fu#uxYvwc0mOe(_ExPeqeHWwzUql9+Eq& z1j|`9xRC&hLfBN7kwHwWWwBEN1dv^MJ^B7Q9Db;NSQV;~<{b^YDvpM#4gEFTV0 zyP~qR-}s2GV09N4)t}ASJg7-?_12aZWJtyV9b0s_a#w6^-$FV*qeiRo^}PlxLH_*X zl23hi`Vg5Kq3859wr<86wgG??H1ikGz`%q&OGoS*cvFc+&nAP)7c_!DMz~G_2Q{mM zHrm!)U$&~V9tj44l0_XPL`R!Rp|5 z{RFPo*$n*2u5D6%#NBA(XhpvI)m_rX%gu0yM$$Mp`c3zjCf;$&i>l>aH;D0ojJ=UTbcO{i|er>Kk zU&1K4LRx(T?{eIIFW_!QuZ8uN_qqPf6m0v_lu@?+o6)=*cSGBB@X@-Py``Q278!I4 z-o}H$j-1~!AZhC0FQU{)E&=#(5lV&`fwkn zZ+LEBWhG>G`{1sKXDsVTU=EVGvf}U_-{TwR{LGSJ%wnTUpYj?GXmI_65N-#<_M1;t zIea>>DGrunb%-5b&S1}m@!GtDiBn_AGB7^O)UyjR7_YdW_=^eK?jhyp_P|Y+O2^Ct zE(nG3#Ht>t|Wd> z6s?@?>;68_w(!01L}86}C||zDX2Xj3ev2D7WM$+>i>}PPQWU9!XZ)fjrN}q3?52^9 zX;Ww!SYfEZgqKMt*|EoysNX)ha@qrux@WpOa35NKBhI4$a4Hf zqS>Y}e@V+}v2AQ5p`7qlF~CN6a522O!6lKPQOZrF{T|9#E`Y@w;Sbd@0bB0|1hW7N z0+kH$_8=awj*=f>8e%yT5?Whp_(-TE^K+y*lt{5M=>Q(oxs*>sf@h~HqOdy#d6yOx zJPA7udVmWS_};Qzyu~4wwfn-rY4+LSnFMC?oKEobos7>s?JG_zh;@RxmobW&=(}Uw zdqgkX8^A9~+nb@+tJl{6B??r1VKw#8z&0uCTbLrXyMyYWUz;NG7clqhVIT&1sZ{F1 z$_LD!RAU`Ab>m_BXB^qhzjfc9xZ7Xzmig=Fe> z?NpZ5hXnlrtfAg@DNF0(3ee2q5ZzS8)6atb3pmYEeiJ6+c`y_#xJi~wfH0j|&S@UH z{Xv?#_3h>O#K44tzaL#iYGUX!b2HkKof%q{0vya=fOuVE z=M@sSlT01T*C{YSRpu^x4G3;}1{=Zg7ybpjT-9sGh~)D;ICjwX)t(E^M_M)krH>BM3HmBf=%=N&;HZ}_)AWWHGeid7p`d}i(3gDYni864e4!cDTR z9W)%x=YMfYT?6WAbYatv0(rnWq_oaO|G zw1L8bNyfc;6x;9zm8x$TOIb`lR9)EXv)wz|U{d<8l`MAD3t>#{xp_6wxH6s%Xby;` zM;?jQKLH%?ZqO);3)9LwwY+n!pxKtfyn$*Ulrg*QYRBcSRt9J!i7$;LsvKuvua`Eh zdwCDrE7A-gGt&`{_Iq?`*U?ZJrD%?O2*A&{!(;v>a?vm@q>OG0nZyEOmZcrv{+))s zB{>#o7r}0b`6bLFBs0gW!ZM#aXU(B!K$`-0oc%dGgVAwyX$q-&@+;6ZzGZR4r*OmJ zfh%yqK`Nv4WV(X-?rh`7jFkyOE+b%Ny^F$iLLI)fOqRTA9mkU(e z;NsG>_Is9_>S|o%vbP|wB!K8R%2Uu#U>ZAs(I?Q(E7TnI1bI;^YbueJG+R7g?-#1> zCmabMc(g&k8LVkxrg)Oo(DM@@{1a*C3FIE!z~P|XoBIt)Ssbto3HFhd41!4Vx8_+S zC-#W}V@9i4s|uU+UdzP!Ggz{yvTSTQrLu@~aXZ$|wxdv+Ko)iY-qI*3@q+6s?ys2u z*Ru;oy+LFUh>YuyNYCp>_*C>Ksy#(RCQBp#t21dTd${(teL(R_%cHngrS4%DE#2;B`zB4zR`bHFDy_6Qy&DSQwiPr82KRxF-L&+D6r7WR7=REw1GRfJf@M5}eRJ<5MD&)+o?0lhi`31L*B6vsqNysSmN|aPvRVeP))2QG@DdhUNKobq- zxIq49G?{$@3hV=s_>}9yAMfboN>MNvcm-*Z8q z1x2oGfAUMGK}q-loXJH1+o34KPC4*yG5=0c;j0$|e9++ps8`?0Za)oL+9Qy2V5T@L zu=n5-vy(J)C~f}*Ncn=_oajB!O0||d(Kf7nkD=2O%BzVU=w(s9e*gSS`_eA4PH}|} zylZalYRnZ_Ao&RE6~cjUD-%V#(8E}z?bYiM`?)6mJ}|sDi#+-qMNDpj;WrqwI5@r7 zc=#Gn2&X{SUWT2Yey)Z$=6TELjDhEOU2O^WtoZStmhCA00MZ&k@PFhd&<-%goWOK% zEpMftgoH!X2i08hrs8t_N#Ihir|I2GbSY+J>Zv zvgk9^MV+5(WceF#Y|DYKG;}%|oA@)zSjO$5YLXu~X(eP`iCD8{W_eBd(x`ug@k68)Ah4#dbG`-ujsu`NOJIz2!===J8{DDf7XQ9W_f)BIoju2Y+z35&W4%k!aZu3I zM{(KgkFAaLMDoGiSTV)|oMFhAu=~Aw(3-iP9U4;1>c8m_R zcly3ikMXxqWd%&Wto;SRAn}2hHZ8{D;fdCTEq0-2nzkJ|&Wasn)y6dQvYH-kx+6B; zHGZu|p--i!Cj288Dqf^(<#~Ulks|~B2&h=8pquc%=>zdA`1p)P-SpOH>1ydU=Pm7Z z#r9c*43ylon0~4$$*;m2YPpdl(7W0kE5!%~>9HiyBCYD{Qzu4^vy(F z-4aDTlBzuDf>dY6pQt0wStap#ic50NwraC#d<&F(7`%ZkAEu+tvMR*GheB%v@`2zPY6!@ogPGaz2X`vUOyqp+h6vdn zkX=mYvKO7P2_@u)*V8;b2d+Kn_$B6J6$y(3%{`AAn*AF#;pEg{VbW{AcOdQLJ5f;& zuLM$s*1<}12{f(m%;qZ}B5MUz6;&l;lm+A!4$R5mkA43Y=iHMxk1!IRoKDs|4CiRo(?c zEr+rlP;<6Y(`sS_YWkV1-w0k7iOGyty&PGVW(~=Tz9Dl|A8p9bH5^&rT7kMi)j#Rd z*BVWBq7Btw+u|`(lfecAWqF0=UJT`__2Uot(vO@EmrZLb#afiUiO-zn<2;jH^s+xz zdBaF)y`oGP9tdF1xz@2--XpPs^{rTZn7l0$=MUQri?Mx}H|oT6DdZw=MO_HC0eEZY z60e`$TMzZ?o1?QGP%bR?@rvmWR^Nb6^Uf&w(HSfu@T>DEkAHMZE`B6xRufef$EB6y zR%Ic;j_rB%gZe7y@|%xCEZ8ou#&KSg!f#EKwx8SwYAyJAsxi_^_x$+7&(3+5?#kO= z-`HS34)Wf9rw0K^65~Z5S*6zrh8mU|BKt|sE}qlq28J4O8#q5uz0J{5^D5Gj`*5VL z9RKKatyP)43WO3rT}YfSu|}W#TXvtO_q_^#8zwaGH)mL<&SQO@tG6g`SuyMA>2G_V z`56tnKW@tK8etN~do(*BY~o0n#@8}o>4$^o^gFZr)`r|~KojL_aT4!PolGjfTnx`R zMZ=%L{UX9t7RRvp-Sd7r@~Sd>HaYwU*(&Fa-5Y4J@{hr^uKWKiGBwjpQ45DE9k3o| zq?F<+CtONDw6$)xZI^zofk5k_QgMBAWaq{Hf}X{YWofpYTKM7=a==uSjEp5{mtO?N zV)ih)G$Z>FT(91vX+~?!nFhYDj1s#|{RJrAVQG58y9h;18!#k@TAEpri89wab~tN- zC-Q53w~(d&0_43dqg23f`B_PE;?)FxW6A?Qc5FXA&XLZTZ}Bqt0-~l}rnXjAI(F2E zTQUDzW%!Ic+!$ld8bvI!YRZSZiql*v$v+ze3eKG~u@sv4heh5u`lUDSTq%FL_hEL^ z92VxYAJUpyiyRqPJ{X&maO>OS<;-joBuu2RMe!t)^{*iGhVoxWTV~+9;Gy9ZS_F@; zXnxd4Jhj|c$-)YR%`U2{tL$R2sLp>fNsK0))mdMEDD~N3qh48;Dn7mtX_@2?Q9VFz zQi~jkkWyYX>^4MCI=ANL@_t!j$8#>d=gG$F2WHD^hX0s?8eRow4On}8LwCh43~X-y zyqfI!E2IHC!dIxE3W$FFXnp7@=vLH=UYdjA#45}3e6*C| z2@_P8&FL;k;aWljc$mk6uaB44luiX~eZCfO=rXNfZ&nY*9VcnDLH}v8&JbM)ZjNnG zH#gyS(T<g>NDk&p|nk*$xGWD~c5Y#QwEvb&*ahENacm>?{a)8rZJ|Q!gFM@c5oxD!c0E zGm8S5Wq)&iODlV#|CP=Z8DY76nC-=7Q-l3SM8%1zQXsOo;02p=@m@~;@J&4L0VN75 zec)OhIsA*@kp+37YTUmMqtv|I1)N=o1`c@>|gTOprf>ezMAv0^st zqK0EA65{srb7+f6YI`!>_fKs{E4y9cH>ITU7pM>_WiPL!23ui023ZLB@O$mrsq*k> z3iDCz8L*qF^+mT(;YV7M+#M!3&?o%<0xD&mD3M0)ONC(M!Z9Z5+Dw`!1Rk<_K)5)L zB9v_n(`dbjf|SvR8FY{@8Cuw5bp*@qu?|cSJKfnLx}W0wi&2(dSi)Fupt@ZRXy-(T zpga*8&(-PaKYVhdfx8;t#T9~T*;w{HpH4e!hh48VlRv5RfgSycmFzXksIbsc2Yf`gy)QPVg;S6vT#rF6=2xJ z4&1k@0{TXqe7P+chX}I!yUSaU?X4xbtl#E;yiqfSa?(<0{8H`ZN)jk&6=nx6_Dy>u z9eem9rm{SK7xXN-M=}^$Lx!auR%LIt)|KPrpor`FT!8Eellk-8KA(g~nhera`?o`I z^OWK(uD$wH$6E@(CdtdxawMped)sZU`Q}5{G5L|_qrD zl~@=&3A`@aH+VFkyC0_#PUu7-+ND_2n|^ojgZl{(bujw|o5w zWb^{3ImzKoa%2?K9g}Q4hFdL0V2Wi}J=Tq)^uNkBA^r>aSgUg|L)PkmYm&LX&LXHD zYq!YW{DMx2il|Vl5q*z1_TIBuAQ0Zq;A{TFT(Is^8Gid2y|tt|KdlHXw@#imjmLmy z(H;;~XD+r=P?DI`I7jB_f9>aAp05o4lu*eJ_h65BN2LW7c3uzQE|3#edd&7fc;-sM zaPB7f?%`iq_>mdT^xwjf?X^YjeMJKNfbReDOIt>1h++z30Ds?oeK0(JU!H&sop_v{ zzpq33ODn#v0pFPo>APt4c-wq^^CYp7x+)<-b+k!t0o0HxPLt?6yt0zognS5iWA9JuEx&1Gn;a4O%MA)B*Z`jQ&W5`L}2f*ODWO7F4XgH zvsBkos&9zHxcZEQvbY-;PVxYEQCKj_Y9`bXkz3T!C-g41XiNku9RCYY;Sq~I|I&3z z6v*Mzp`yT>sWM?%U}uDP#533p;h@&2JaIT34bpDQBaq~3%D z;tw~&c-w^f3m_~FeMXr`{BZ;%q0E<+M>n>KaAAzl2|aw$Ah+h=wv_NY>a}xV%;0!L z^yczx7Kw2|VRttI4KFS+cR^_#P|K(o*|myS5TY!t5X znC9e~6IcHu7Jx9Xp}JDlJUhR@5z7fDXc0QmuQ<3R=LbNosr6n`58`f2vo5*JH^!;a z`VtFU{4Rs8$ZpKL2=)@6lj}?*Ase@AM{xXm-$L(}=`r$X3Ra4LaLu6ES)}!`U1i&Q|pylMM-Je5A z3Y9oSR!)vK2{!0#80ERg^4#qOUCZ@5h%^XDOlky$r(l(M{p} zzL0{g*H>bi>9{HY0ZJy;A-IV_-hxZbmBDUcvSnN664XKO#DkFk%EK|(2~hP4?=r*g zp8%8g{{q%=Lk4eyi1fAEkId5Kq6TQ(CwwIU$Pl6|%e|5%x_47YRpd{I|N z{d%GgZ4<*Xf$i)sM5@zdvEu=SS;c0cmJ`P;M-_aIcnfxpPv%nDRfitT)Fn>mPn#&D zM=kIn)m4zf57bqnCj;^$MJC&ZAKLVV!)^+wgRHFvFLf;Gy_F5LPBvmbH1v9o7`{FE zG|e*(grs;Yd`7YT%(`FooL)1{e0E>}wkhr`9A*pBbx|2tYi27t8sO`;O1esu=)L#( z5+bV&RgfeQfZ~UPGyCSj<(8cGZ0!6jF#rc1+aqDJ30+_w9pOmTP7DB5?Sx&wpl=5d zaojVrt54?y$k3o*&C14Z1%;p<$H0>iVCc&y@G7}Y zgW6(s0siVD)E?}x0VEMN!sucS^f@?n1n3e@u)kwA0x<+pGweGvlrdU#{KO-cE+M5ZpG0t^0 zSjB%Vq|Om6q^6`q)=mzTXB_b?u;TDc+EZLIVY?;(_+`{^CrQ;l?`BnLYP{)+Q~8i1r~C`p#q3hPdyjW}y;tUd%8HlV|J4!RJJ4Le zWS|^JY%F>mCgjOjWHz8I@*``TId`|yw??!+CUIm z$|l!ka9@{L${IR}_&0`IfGtD1gy)nyn7C9L@gDm5C-r5E$u<_9!m<=^`o4}nNQ8?q z#Hn;d7(uj95Eb^|qXZSbFr`yd&EMI$Ig7aCBe&5$v^}!7`Oh@M>D6SoQZqz<6@v8^ zLyq`0HYtTYr{hwAx0!|Wr&;H%%J?XAoY&1udT*%_m!U};7AwWB^(8==_E2{j!gN69fv0Iy$&&IwSzU zPC4oi)szKPE5rtT0Ez!%dSTT3m|XBT=hhr$xLpY+iD8DX(Rs2DU36L6T_E-CqYdM| z&2m1vDq9omsZeu=4M`kKHI`jPmG$C|!bKbvxQ_7zTdi(l;5;=?0A&z?u=vsc{i_4CTe*MUXS$~mQKELyJr z0d^uix{D`L%&TQzRTn;~%^F>0uSVF5Pa(XQsWEDqw7X)CrR3Wq6Apl^jZ$XG*DmGX zIn=({ps$PESK=BKU};kX;y=hWpIQY1Z?_KMUi!`-Rslhv+c^a%7Gp1<+ z@2QTou_B1Y)6dhdvGRJ!#wT-ueH5kEOfxGO<9N*8PR+{f*#aMmLKQ;SRDS`#RZJ^x zQ|sjj*q8UKyf9=YC6OToU;1qUcHa&iYd*9Zx4fF(zIEZ7{xrtO(7i_uwi*BQjfk_t z13{5Cs!||aVU&1o)%IePc$~##D!`MgQiw)h0oeR;sQ6(JLTAUI*99@~v%jVZ`-hn0 z7vwe2KvZV3R+B@=C~Q|F@e^2O1aZh9pmt#kJ!gh{Ws3RP|kRPT!^S&7f;n z#D+)j0P;mu5Zr53CMujNqx4!}9it9@uevA&=g z>d5)-g@cIKG>1hzb309)RTa`0e|d__iRx0g9D4iFM;hWq;-`3TS(ZR97Qv_|)kKuy z)p;oz^VPjv@=}FE$KoYRg^%2>T}9&Y)K~UH9gYU>@hWGU*g62P-}|ZqRC7Yl-2FiB zrIZ@lAiP_r%A0MaAwy%gy0{AIu^@0q!|~;5wHoGM-zuPlhMtawKBv5pLREy^IKtnP z8$Xi&+h2f?rFx*R!;JnF;-m^fR-gT4++X) z#O!EwdK9%xATcP1JDTxr>4MQYAX{zDn4KjT3YfSkmv&X(+F6<;m}@RG^Y$_h50E=w zZOJPYwk?O~*K>R|e0SyUX}FJQd4>pj%f7zJo2BvieS-S_#S`6it!R`anwR*%(ihkE zDIPb$J-30i4Lz=Oei7f`HW=j{=cLYGv|%Ot)QrY^?>_~dId(d`_jlvJfOfOLfD#Wx z0>Qd`)T-jje9qG1*gA3Hjx3bHa5MisTzLy`Ya9Ea+V8CG(zr1EoS&l7A(m_I-X5K# z)(3jMYbTP@(f^#31xAQP*LCWhSWUTeF?r?0pNK4a2FFjMU9J(`O1A~azpkxS@vTiT zvDJph-f{Wh-j~D~s@b*IPT4uig>>!{PBpvp{{`sUUrYkgbNBDE%dI>om?-5`LKfIl zT(awbTAgnyXRZtkf%nWTe?;bPO@5&L-iaz6cIkoE59yLi2)ei?QIrmMY}j)$AY+Ca^k2Kr?V&op@Na?XQ3EMj zL*>=`>@TPh%7yqGNLq(m*KGDXn|p=Ow8c%ToRF;WCA5wU%sa5e@lu};u0TZY zbi*Nq-{1Xenw68G4Rgx|+xOL68$#f~4Kf}GH#cc=$84@qUI>5svLgfngHgF;LJ03A zIIE#xFn9z?d!$iF#NUvk&X9w#C`!vaXn4oob1PtVB=cqt4D!>;?_GAt#wm)A=#v{; z>Tuc`@-95+jygTvC1OOTxEIv~kgc{j_DQ_J<{fxs=#|?Dcp4H(@#PyGthLTA8}e*1 zv!Rt6yES~4e$pGP^^22%Mn#HmFz2;uy1lViklX`t&RCLDrw3YgdCCUuZ6DisV&;#` zkqr%^QHmiwCx16K))rn_M6uQTb4Q5HzvG6f*9rG zlS-+NA`RWSxowzDf)xaFkc7JiQwFZI82CPy=7n$?KnJnjbg#wc&h?j;tuCJuEH3{ue*;0(VBc4jI1Z`{u+xz9IrlHQ01;YwUaHXR9KIZaxL{0Fs66(dgc?6G z(PJB7b6v+z!h*2uCWOq@woUsjp3>+ zKMSX-9fM0N2Nv@BxdP>nT?o;f!!9BO_kj*(fjz6GuQ{s+dJ`#tPg^T0VO==ZqmA#( zs~z4Y@sZUc`bh%7BCztYP2?MRgtm_^(IJddT(J>VPLqDva->FvaHi5@!asRY`jg!f zC?~CgMzlxFM(P!mhk?7HwXTJiu(LyE`sq+xTc-W@72J6C)M2qi#ouIn7L;MUwHRf% zR?CPG4KyK2zy%$*?~bYd>(<9^yIhN>Sq!)^Y+`=D1ef2+K_}pX4)ni*Zs|WRqe@e42RYlvv3Ge3Q1gib<41gE7Q2hBnW#TYiax=+?0(_`gB)O^KDv^0TXDT<4m%?D zS(na-wGecXl8lWuxDENrWAXJRZGwzF;}m|#=^fH$==Ep01vvhm%iu&D{xvtT(R|5O zW*d#H$tkCKZDY>$lXWhtf(hq2xKOIpoqe9}VP|sJ;S%@7wO%4sp2atkG|omB_M?s| zFHd><7RuFlXT&_8nyD!IeK9)&L4h*FAkq=P@pc6GmUJtscgX+Spu>3!c^~PC~iA~XL zrr%3{(3V5b-=fS+P7rQk3~e4epK5`DcT~lzM+4kw&Ka^^#a9g z4RWsE!X*^n&J#&58Yk&WVKd&@`fHDwj)?qVhC<;u`hhGAi1x5-L23q5R6TQC?XE^a zAyE_DTm*DR1 z+PJ%G;|{^yolNI_@6F6VRoh{l>|39X%N-iWP#C58;5*McrcWer2c_li`wV9pgg+UDpy z+F|2h;y29QW%bT&i6n>U7bxjr8+e?mcQ~f^snHVujw=3!y%%L+_VOQfauTM2@8F!c z_46|Ye{cq0e4B;v$D+@g4OtGRNe!A6AM?%?C=CkJa+n))Z!ecNM8z5fx9IHrS6Ajb zr}T*;+g>U08@E2)yTY$~d=9bv3!t`KdTpydU)SByeVyj;)&Z>Im65L??`-}BaD4_I zk*!xghPU)xDr!qoU^fy;eIiXyGiB>t7r>D4kRX3Mdkk;NE$G=VLaFFKrrK|L04iGh za=ZA)vj2BK?pJEU?|~V7?bX{asHbkftgYw6rtq zH{PFP75kmYHho1eA_BgiXiE*Rxo^Bh@27dMeVAI06txzdKlt1J3#JNY=NGXh()!Ax z!#scb4m3L>dHXC@!{JNjsI1y~g$I&96ecg@J4~D&0y*5*TlCw^$pEjb4%R$NIsMMc z$L{T*T~Bv+1p6mpLM_jgHGKA31R)J9%QcVivWE>4m&PuIiytwG%%9FHx*qMHEb-98CK7ByZQry74@0}Bi~V!CUeo^^8x+Hhh=9E?DR`ioC@!twc4gO*E z=5)M0L*rl3>>O|$2uac8!*rQRYoFfMdr{tVH@78l?E7R*?P3NA-qBZUUOOCLKuXT< z#eV@KU;3^emdpMoO1ZQ50rN*NSL9Dxp+U-Aoz)(gGC60BmKpGesNB@UXR=Mx?dQT!I2J;8G7(?0ypw*MI$>}R=YL9kPI6Sd1dzU zW4k^oP}i_4%yt?^Y=iJf5ACH6IM)M=DV9#V?ro~C_}|Uh(A`*-ro8B>!ceN9Rcu17eWud%pje@`--N|S^)p4I?>eO z>-HTbi`Ybay?J$gWy4&qs_Exm(A!MLU%=5{z!UXot4aTh@XkG)YZb{NLFiWrNek>9 z>TeOIKgCb9`A^N?J0uQJN;yNO6@GqomKNG#uNN{{=`60GvhJ-Ze`CzP@_830lh-HD zin@9ECicB6-YBs79)SvpEIL7cTHkKAW!eC3jInXtrg#}nC$j*j%^gOY1Z^V=ToBrh zv?j;t#IO+lE_{a}o?jO2DuljW@RE^t=G=oDLzF{o(O4FqjuN`!s)D110P&kyMfyF{ zW%1AzW@aZNW8dB*IXbS0Zh|AT5M0M?J-l$D_m6-_6~rMC`ZIJGm@c!654da!+;g&* z62pmYn9QgRRIjkF$LU8~EknS!j9ad0RZ&(ntQ#Higc}}A;vcT7RpCO^p=8>yA7`-C zW|es+g-wD!2jc3Mx_V-!LzVq;WSf=PRABJV{=sM|aCMfa#4+lKP#G84 zb-x!DZ1o^5IypJfGS`;N0yM8GK|!73@&ADkP(Wd^T2<<@!VyDF*LWM@QWRB@9nmV* za-r{-VI$#koeP$pk~C_Z=$<`_YP|K^6-D;l6dI7Io9+x_7teB06nHWMT8d0G=fTL! z<0CS}Zbx-gN!Ik%b(#*PPHv~bC~k9w6+Mt=jg?nK1?VSWj&nv;q^U%em~YT8`K=dY z(TP%w4$^7e%Wr>yhk9AcH*_iRiaxKR(J zB~Ir(Fki+K~>R5TCa+Y0S^LZx>i(}OmQ{q5# z?nq|&nLGcqK(&sp@ucL(vomE%%DwQZ*>CdRKg$%>9i*eVq*u8zA zdbila;qX3LcbvbEe&%689=ICIp!if)VY(>fV)#muT{)H-j{*(WukmFgmM%NO-lVSW z`uu>yRw+{x-f-BhvnR~AiIt~fC(f7$5_ZxIr^ zwJ>ZLdkSe5*svl&p}vy0FBQVTaI33Q_&zZ6;Z6l7L<3I|MfX{M9w;e{sO|+x*odT z1|;zk_ifV_j{_Lqju`f;rK*`<7rK;ieEwmnaBxDiA;=A1EIE07N5cB``pjxSAC*%b zmgZMdq*@lPUSzi^Q%Q-qm(vV`qnbjMwB*`7z0IRGa;tP0#Zw@v#q z?d9>`5z#)DPF0d!PvBtQ$0mimXWv#?`6E{+{gN*pydlR40voNh4_i|2`kfmQTp~MH zVPMfTOA{hw+f(!K!OqS3;jQ9{My=?PZ*Z64`&wsR{{;}OpOyFO#{z*!013E<31E!i)z8uE>xkGXp(T9Ynk$rvrJhLD(=)_!|F%v<%*KLax@rQ?AfrPT z0%sUjxgVMnOzGbW%sk!-a#PAyF4cxp7I>pA0W)pHzTC9Cdpdz8LtnNtILTeWO?cIw z6=5xk@E%#8Y=)biL-8)&a`&Xc`_yTYrb^ODjP_{Sby_gzwksu6H_FQNLoBk=*pUyu z>^)fKq(gORY;JEN+W6q;aN-di!krIYvKYXrm_}zlc`bGJeIC|kSc{?o`&R1Dkx+jE@`7YoUxT<1oOLzyaKeX$UdH3jyce(0Huchgvy75urN z>*HnPC`*m&$D0_`uKVR}vI|gsg1%!7rFV@1jILp$%!F=J;sQZ<{1GNK%mEH+X*y}F%54aj3 zwK15UMi12l(3J2!wFD(tp`F*QRUD@yNPqO!edNSb55D#l<)sd6A+TmYN!IztaaB-Y zIra(of1n#CAF^2ER_4QgYs5me)nnT!5bG;)7D1Qw34|SM6KopJo)_vxIisuWndR-P zH!IEJr}oni@WPb^eO^}D>RT_^-FPi8G)@~w#U~+GF)F=M@5^*A;=K3n5DLCPEjv{^ zR%-4vNJgk+9WO+UN@}xsW7m#YMg-aJtW>RYJGdv~3}G)CIJOxYd1U%+(K{)A33@@E z6KuS4Dy$r3bK}7lFm{p6#!0uzIx@@v5Wxxd?Wqc(jzM1RyBhWHuUUmkEm5wQoE~h~ zWyC7+_)a!#RpC$&OOXhD{*j2oP0S0_iI0_^M}!>6ZCx$+KGE`FStMXNy+J2fl^|Dz zo9EQF>3jE8_i17f`Fn>~CMbV2r^+cagLZU8XxOZUiLDrYe&09Hd%NAd%sX$dHMC+! zgIz&W+Po~vOr_$VeuKI1`~L#)Y#)_8 zMLh}CQW#exhsjpjB5&aQc?3vpj38oAs+Td{u8;A~j};hKK#rPGYUV|2thomN^GXT1 zZ`?gJ|AP-0An?KZR@MY&b^^;w+y6_77&i8&N_$S(B$Eb%qL(SWKxcJT-o~Yt8M6oe zNYRDT(S-?fK-C@$AHr=+% zT&^QNUO1|3j<&GowEDLh=sIoS%<~M!IBlCTB$Z+Ty zh3L0WE-79_zn`bI<&|cX1*0Br&BjE-|I4 zQ5yKy;9&RAPY$?;aY+5OEs-m6y*8h+CC~+ zP&0m_GO{K>a#AL|x>kZ?wd}VFs(uf1IphD_mv_2cxmp+!IsB(UYHr0^gy!`u(XmJx;y9*>;LO zD${u~b}EjG-VZdnfcF0&MD3Y%WEb*JtEp~rze?tnPGq@?FXe|-Irm|6FPt<}`7#FU z*LH8~O3O2Kx$7q|uRa_q-M7&P+;)9=)$<8rf$S`Vwn|SVp`vAjxRsgtQt=~$=~=ht z|JH*->w;#Tvi^=?rFc~LM1gE}Wfcwj)Rq{f!X&FK^Qa!Ee|zqF9m{&gu7g{)r96BoAzRu0LNbwd_FCW%V50xD@Jz|HnWyTv*1iz!T2guTKSVqHDid76}_RN`KyKZsMDYK5^oR-* zdMI52@>8Tn`XRR6Z>b1&!KyZ9&N{3{MizTNGY)}_4A0N@R>Bj6O=%tz@8-aG=7Pn#E<^wyV&lh`#$^-}C_fgMyZTK)v!Xy0eJ7 zKa{UIyL_?vw`DwS~g{0+{aJ43!FKt&1(qeF{y+TKuDPam1oP#PDs#?vf z4GM>@!Ydfq3f-O=NUH9QbY#lp|e9q&fUQ*91C9|?mwYGyx z_|rR7v%XH&Wcaoae_74Qsw({B6%kMZPL6*>%5*xXZ9wd~8Gw{m`Bdi>;cp}K_dv0Mjfk&vO}8y8O15JlCg zV1-Y_#zHP>NEu$--*^SnubvMXpGqNlXk8PkTXX_^FgWl`Q@VV$-K9f>eZ&tc{#{N? z8t@v1DF(gAjn#dbX2lhr6%}1%8OVklV}2EfPtTA8bZoY?cb-B@50{!xIYA^rmbQbt zx#TMhX*qLSrU34C1vFfLpWpW!5aA_5b8t)wII)1C+LmCPa|mu_-H}S zvX*BrO5e@1IY>uv46!ikb+y0}_axod+SJlu3&moxjkhP=prrR;OpOiO6LoaCG>-=R9rMxniUAqF>eSpNT@JDu;1caWaN&^zYdUqHuSz&W+t+W*(5@S%ek zV*f+-e3BpE!O0NLx6@bB4S!<{YkZ~n83Xh=B}JLXKRjdigo`W|s~49sxssN3+MvGL zzGa1}%aUdtxNt)UJ{|_-vMLXlHR8xNQ;<5LtfQmrUc2HrhPCY08aDC>*ZYAXq{j{U zLM|vS64n1jjlTwmaHdN9lo= zje<#+ap{ScqQOW5b}eZm(~0t>L-JC}HEn*eaNi+czB%4)N&^T6CecK!~8oUeoNogODl zabYM}mGhE^x6;YKKRWa4j`mFGB6tDUwPyVKE#0Q|sH$)TgL#rPK{1xn$mqOMPfK(}+{bw&&{R-&w4RmlumCP`Z&Z|K+b`fGYk5nQESJ zy{D_MmYxS17j=K@-E#S&?=+}5`Flr;jSJyrec`xns--BE-jebybesrs%qZdOVwS9W z9>@55vzCAKQ!eKthfon6M)u7AJC3T@qGr8y?>a*@?KE)x0kvwHczb0TU$LzwS;=OiIbf!v`JHBiJw%lLbLcUZ z!GdU#eXWAto=jd5p^1#~4cGo@ar7zf<-D>}N4Tc#c&F@i%RVz*=tSp2jE}iCTw7`9xM7y%ZIwq9 z(K-%@>&886wx}d&6V{46(lG>krRzp;!&4KyMHPZS_WYRW{Z$c>Rj|6c|7hZ(R%)z% zccb|8v2ESsMcNxRtRV(KMA5oUYc=Dt>FPv%i?)HIJ|M63+oT)W?*rt=llHrc%XukO zmD^yCi$=*-Deu34vxG8@)IcQz^t*|81f!VJWn%c8ESlp;yhUCR9>7k-FOn2 zIrJ7vTLPW|nIThxA5`uGQFhqz8@MSNSt+UnRaO#oovB|KF>z7uOj*k+i^#n>APT!RxFlC(kV4T8#Jq^yjhig`+Y_ctTbOoEfy?ua@yR^ zyh7w@RXmn#zhiS8I`t09-Vqde*?zB9aP=Yfk_>mtAiMDEI2Sx>(bTncJGcw&A~1bS zvM5Ul3+0NYKKf#iz{QC`rw=t0?P)1Rl*)fSThka@lEaQxWwim00 z)H}cRR@YjB?r#+n@)5EMBVnKz2W;F~I^ON2U}ukdyanS@;kep9r&xHK8CVd}#gf3W zZDvp5B|Tnqb(K%Q=Dl|>amj=UNhvZ;{AVMGcec-maMrN7RyPP`7x6CV#2`7I-sbb#*nkTzG`f4d0&9LdI? zN~ye$U`Z|Z$2q3DUKb_R^ydQNSWp`*+8q2i$E>-okhL@D`b;#4bE4wp=0b-_zs;Y1fpYK+zP0MhTnjIwMR+JJ{v550pJc3!5Q;w zv^5B5q2DgXDB!4a+?7`MZsmWcVUrp$E(zx#sHe$-`s6a%G^g|VaZ5eHhbQJQ;2xqR z69&~edO-TR0(n6l@jq6~TOK6Usm{ZF4&l3o1NL)0ANA;Zz@-A-afo)WAXm#N53#Z- zh{aANA4RJ+`ApRXBkOnJ9ee}p6o7}EaJ z2F|ggc2BEl8e4=&LIx1FBgygD679&F4gb*c`*%RClo-pDAgx;B=Yixx9@_HXwFeB{Fe67{XF_G#fi5BVUMdw%nuzbY_M>qfTd81YQle+J89HaoAR(L59#+vJZ+j> z+}Wbvz@TK_TmJ>9Kyo*w`;lhR17_W&c8{x)zkuEdTXNka6W+&hpKXOs*QZv^oz3p>T_%Hv=x~N{XNg3{%HAiPqsp+GlS|iDtLWwLseK1f2|7-1J3!)*E$dpX@ zxPwRf)H568D`k)fvqoMBP6;Brjc?EzVnNX25fLrEPSDgAs$MO2VypGnmN{ug+6xh* z8V+rfNyZnGEQw+hT4v=4;vPXF5p5}2s8zXh3t+Nnp-#=sIBUrdh=v?e(^Rq)p6KPs z3Go|8>`fwrbg0XfYUliNE7^{58{i{2f_(c<_8DLHw;jaW8DW&|&IVPf|Bx6rv-13k zdX#614`Vxpz=rHXy#GnIq9Sr`F4izV@JBa`%^1}Wr>a=CM6o@b^cRbkExQRq|8vFf=^v2bQqc_l?Ge~Jo|J*tfC>&uU&y5u)cC(AdBB)GOJHvA8rt8vG_(@q;vDBf33Ko%-dH#VzCNdB^ zZd@9fjGt?!yT-$?Tq2H)cz3*TeoK4Of-!s&@()@W{*6| zF0$L_juvtbkK*P36e|(xgWo2_X(4%A&R>APPi=ks?YjIvwbn;kLUw)83~;J=(j-}Q z(dNcQlX8-Wu2c+rg4ive-YXqXxhZi2xBG8>t116! z9P&QK3i)_0ia{bpZmorohK6+5Xy{T8UKMGjn3dVLT0n<6=Ec@T3 z>9k>y1X)ZAdP+qo69bdRsJ>sfBNJSa*5(?&nwMm{tewm%<`CEPbjCoGa?16CfP}kv zrnoCB{5=q&#Hktt9l!P}9&N-nmSR$X?fN=E>@xE`;c7iVXI@ z+2F+S$ExNlX@^tRc`?x(HYDkyNjI7MRTfH5nr03iB~vIZdh+2*25 zFX0L7G~=6W)$_2rFSEL12y-+Lv(@Uk*RF?(uB0z^K2ccEUvrTs{PtCi_)zI~t{JcmlsCiJwhud2Elw%)rtlka%g#@_zXeCen(tlB@bU#aQRQ*O>QWWpD<7~XM`PT15-UzI5**3Xv-EaDvh$K7X#%l)$E zdny2N5(2+D54(EFE=uaT%L$+U=YwCvuFewg>LY<>QP~*tq)!Sl%b%;OTEuQig-qKz zi%$waXe-{$rnEv$=PbWpls+E`wUv3dZ>4O>M;DS$JwO)I3Y!O^7^WP3GRGt>WcJ5n zWAInDIs=!BMfm4QW1Rap&)#&$L-n&!UAIbEe4pGnmt7@T{R+KWtEfK$p>JPQ>GN{*qL`N=rAP z9+G(5$Y>}v>%ixvVM>O|MP>PVcviJhm`K(mP_qg+IRXdJUy6NN}4n(hPr39m{}6$ECQg!-chAA3($ zzv)%Soo5rYUZzaxQqI#R8w}o=VZko(;{Af`6emi*tzX#gqUo{Lpx6EtEqSU7wbWSk*4M6_etAZl6&rW19*=2Z?-M(f$?MHxIWXT?flybx_mtB zZ*pTBRyndYo~b7)(p&J#P|mLTn&2gnZT?)H_D>NVMMNqr_FqfB0cPL`J+vW4s9V5 z(7)@cx4v|o(OE@Bo-y7A1$jyH8qt@rVJNEpq=_69fTF9q_yMcEl{ElS4mvtxe=x>+ z<5tn%__UojcO6U@J!k%g^M5nqE8;kca>E5B(W%i~BgEWvn=@rucGL`a{sEU{ca*FK z31Id%0v0_!oY0Tk%RZ=eOvb;RN(Q<#(TZ< z;e!Y0I`d|wGnx}PdLCyw@@t*GZ?t`2GxC}+Nw z6c#-=l%$p$YqhYI=~c^_9pwWDBpIJ~9LOA$y!VeWkiQrxI<_|C3&MI!>xD+-yN`|D zzhWw#hIR%gHqYP+<7H>21Z&Hm{(GQ8qhWpIOuJJsKR7oMn0;EvzSRY;qM@?;DAWHK z`(nZ*bk2iz(j2nI2J`(V9^O43WSm7?@BZ9XBUa)kfq*NgDh97_;}ZG1u=2F%GJIhB zfcI^?r45KaI4$UucjY+v5cn$x>BYv66tTE#PQ$jxr&LpM+i6;!OT_?O&!ZNqHgv|V zQ)_!IpDN~WZAt%a$583r6vmk5B~9Z&$pa!RTjycrmvoGo|F2|n{ZGlnYnNBnA@rdZ;_^OBqPhR!Nf=CKaWovAY!U*I+p@5u*k&{zJdXyDH<=zANaE{iq> zp`h=bM_7zABR@u5)uo^^uE5h^-vGbMiq%;`SK6;E2Kgz9!U?_C$o*Rl1;GUUaPu@W zG0OR6QooXY(_>v~|9YY;&;asmedkrsBxGft3e~A|OrhLh)d3 z=d6SWR@9X-JAonuq!CvDiJ9Psf+mkP`6HvG3s(ymvdvN);osa-AUx=@gE!RwoB~y7VRTHCHU`@KF%EkTy%&Pg>dkFlT7v2)W zf^j2s474@x1r7PZQ@hOW({H~yrtVlC$Fo4Ao@N@y{PxE0xUJ1kIko9NANeCkPDCK9 zM){aSD$~;Vg%(Kw<i{qhv|3M)MbknO;UJJ;}jVm|W2tPM^a%@4G_A2#LTT939 zty#B~lOO_IRm(kyzx+0=_{$Dt%zV|N@&Z^LM}yH6LIv}c^4m471_`*yi~z%_S*vdO zZG z+*G4^PZIKsiFcpcDEFL7TVwRY~^`D3c1F`q98#f#Fm-nU?Uo_hQO3evp z{q~3 z|8PU%=A@KnDT1clm*s6;#k)mP>>zO>5j*)aus@zSN092GRzzDFU+Yf(d)u^-=?mog zDxtPxvFj=+jcv>hc&q=$>L_cWwEb2^16najV~p0{OFcE>@p1}HPk( z$qip-U2F|pQ3zsUSx-?_l0)Ps=LjNt^e=2%Pb2~jne>%z2Iwf9uqKd%;JqiucIipp zh|esSGQDk)9EF|8fFx3y3h~=IFS-c5z{48BWG~Xg%?Syp9Oo*H`=#P<9pDT_)NHJB zHniXfEhb28H78r0Rg@dD0i*8BlulcvnfTFi3uC%5%=~%LO|)i=6lnk(utY7)WagjC zi!{vat{`Ce6Ro0p<*jZ#W;@D-zGXXOdCD>quQq943@Dq4-y87ycs@cRso%dCi@&mE zTE;E17>bw0d!;R~>jODB5|714T5W6(cNk)p7FSRp>*qu^ym6>6)B$djmfy( z;-4$`DworZ8ec&*f5r&X){1wgtLvpx{rirw&ryYEpytPA;} z(PXahzw()8jvLy@#yW5r%@{wDeARTQ$ML~+4G1uxs7rk>*mdaC_X+UbDXvR=FN9YH zHOjDRIyBhGjjs-B4-6j{#Dim2qK)yc@9DYC$%sfkk3pn3Gs!iF@+>pyKZS`xWUO0L zw@`jmGE83y>`k{Sv4R{~xwyDeaa}P7#i@FN4a7vZ=R@k?+!H-^ct_*oYM+=xq9m|I zsl{enclfq06!`UPZ8(&DqT!wsy*1wQ_lsBPZiU=Ex7E^Jw-a-myDt<>)b@&9`e*nk zG+r3Y&2P&^%J~W{HX84UgJwiWOkBq0MyNo;h7wJ&JdCdb=Y7XhMlyGF`547u5?i$g z@~RLRVtuvT^hUS`w(!c!b^f*_L&?6KnBNHT33QNO z5STqGr6w_}q4zZUuqS`H!P{#{X9`Z^TK_g7*5LNhP0e2RGwy*+ZW&}&3|yNo?4beK zi87e(nRw~cl`0>hKf|fdQq~Ch?mHq826s*C?q9%%jY8R^Y>QX$i-=yG9iEK>Z|DHr zt+p$~d=N5NB4FEB4rfJwM->Um9>Fo^j~7QXl7R^XbvFbUz^}zSyP4JZ$hM9_Gy;~k z6DNbiDzMktD50|~#1TRli^g#Lvz_D5RQ>{}^e+a~*G{YQ^$dTGo21r>uR|0^T%(lT z*iX~%-mYhe-l*>A?IW|-ailNoahi8awcCwGLit<2cz?$#l~Z^vN-;xq$4b-G`q)W;&CxJiXT)Jyq+7_&AH4xP{ zaN`?>jy?7fSWo&&O$F<+4 zp-&KzST0kAlD3$0@j99`R(fqRKw4}<9x&{9R1#k618B#R(`X$@&M#zs+{GY^sW_N7hMQWL`;nxph<6uW8^Ic6{>p}mc0-J zy^|7^0`6r$z5rz3t3;%BW*;ykSbqz2o=G<2L>CYhE}8B~-BBAz#7@?L{RQw6y6bW( z`>3|)Dtceaq{~BY&W%Gv{{140puFr*{sQP_H6jEfCWJnPb4hZh$t-}u6R{f#=&>os zokRNBq4nS#7G3RNCBa&;pa-(tMP|oyufbNe$M*0x|C;K7{VHFP?*!;{$SV+|-8(7wGCHwaN=Dk$Jx-$|N}G)mzKDt#!#T&njvQ!BWRr+!P6%HlP8i}pXn~@Z z%}${l5`%Y8r^YJ~cD#sG*o=v`1J;V5GnlJUiVRn1csfNI2DjsXtlaQDkL%NO+KKv}9%BKsjtZ~+!A^oo zyeWr<_#@UWv2QQD9VA6&_h{HbjnnK{&;79eRcQ8$B2=Ss0OSolbL6vnmz_rA%leRC z>v~$_b4ke1b>hRS`oY$p8%z2xU;vToT>?cC>qK@sR9jny8YzdFRa_Q!Q#a8(3OKL1 zU0$3UV+}$qTBd7j+qiK_S~qZ?Lm~PTb*8lz6YX3io(_#U8yA;GZBAk(k6Th&+P5-2 z#KDnl?WWw21OQ3dMOpreEXM#vHEr)F-S11SC4cMZUur|8g`tq9}C~Sz9t>Ak`_1JN!ew zHdbz*c!MyQf=ul}rF$%SpPMRk+7Y37A;Bw787Y*DXZS%Izc3Z{wJpNQQi7tC^%NAt z(%W4Nyr1I-`*&2)Ts`>`yjx2)|-E0w| zis+KySpHh|jEIhJCTuHAoWq8MeS1Ej5z9T{mqFS`JXX|x@#a;1tn1PU;dhmY1ut>3 z1bZ>E$)#|1h%S8v7R7KjwhZOjlCeGkWV6O98ci_CGL5c7=vEr73I)tS=(Dnx&lWd0 z&dy57%&v8N6{FTY#5Af5hF3zr9qU~~J3ZMRtd{aUd?dPVLTsPbInONH& zG6-+v%(FgZ0Y$f!<#y6gd31$I4YQb!cwJT!_u14d+ia8mp^Sz~-~h8M8*yOhNk?-9 zJ*W?-@~y02onG~a52 zcIRHXEyJoHPRdt}Tl-#pK5xJ|y5y`55{-8;EnByHAi&E+1Ortzi<;A~eEv21fH6j;#*2 z@l719Am_Cn2$f(A`u!<=m*)57k!rSNH?-cxVw3h^jOfl6dCU}U1F>pJ23ZTnh;XU# z7ZMU)dI!^a6SRjpEVaGeV|EI!h5Bp%KTj;j^`Bn$LS|c==>G!bQ@PJU*$G(EK0W*| zkdpNIFW_+(ajlJi`~lj!c$_US4aY*yN|ZvJ-RxR`he5Boj~mPJDP7Zz1#VS@JnOWSW}Q(~HQixzM+c3d1YW3e!dDAc4Gmm->(vBkW~|@~s?vZJq|qisfVxn{$kG-(#P%UNubnqQ1P?MU;=oiDH6Ll2A{uBNh1G_r!hH0a-bvC<6OeA= zPSmCTq_1*QHkwMIoa%b4-mfCMhZku@m zj@Z)3$ktL`Y9(SQDczoDUXL_9AYiGlAUq~LC*vJx5STf^;DL+q6_~E76-?PwWTQhBJy2wtnO8d;`mQFm!^c#fP`+jfe@G%0%dlz$5J3UJRi z*ex+cjx1E8o!#6W7-e(w*i-nGwhA$6x2UZr;WZ=uh>%;=7Au0D7qdYj!o7VYP*^4> zwdv&Nx-kn&{yc?FDY3=Nmc}C3^|T@H}{SZChWl z6!Nl}78D<3REHa;dNy{)u`=t}F4}ekdG8=;0-X=c>(wsQk@3)K0ihD9c~fonO|kDD z!kbVYuO{iMIOer4`=8GYcyNyiIr7(uctLNGCzta;wscYbeyY5n6k~Qr&|Yr?oWFFF z7GcmY&?taNPU%OV_wd}iacZuMZZCB@CTa3|gv#&#hpxYjtE&0_$6-oPX%J941xb+( z=@cZSySt>D11R0y-CYug6zPsbcXxLjj`zmv^ZmbmPwr)v`*eZH|@7CAPm#v`+ic=q&NcmKfSh0gAI8kJ0czk7l-^`tk7i$IOQ2!*P zkNkE%u%!Lq^=Vhx<4PRJXlXx(U9aWty!uq52YKXoQ zdTv2r#5qUL?-4l9`dN=+Z{kla7U#d3XTWlS7(WR^ZI#aFh=~`xn4g>?L_e89wK&E* z#e>B~`q$&qE&So%wFOT_5|($Vr<>Oza-u(5=yXpj&mbTmi-TT|)6q4qa;r3dRl<6X z-zXPFwmK#jV!ywsULSq!4wHPSVgrG)khFP9nl%^x6zOCGN)pR|_+Q?Ipi{z+q(ln%7Nuop}OXF_ZC4S|DOZi4TO6V?R z!uX_j85Hp;`)O2_LK~h4VB#iI&_NS$$uYszWlzCFPspFuFIS@ zU^2kB8Xv#DJ2jGj_ zcP5KH3NV(}A4Nc9$3f+7kXYprc0l!4c~V$d+t@ehQ^%r6G+t!8qE{uMc7G^aLv#8y z*`SKjaLkOnu^BvJ8^x@V{TGh2vjfL)H`rEqyxoT<>!AVtE>0Dfu*a;YhCW;(r>4Op zMYamN(Ih+W_jkq9!Y#RfwZIN-n}l-*=5O%^uBNfqClsX?k~mH|uwF5W-|9JxM`}BA z!>oSzP*0B$j!)>rk-)#5KprF8)*>BN|0+SCf&8|g9uDK4TQ@h@o~n;|CBiC_Tawq1>5_lX)4IleZWECg_FS_KjLty*LTY@)H9P1d49LQ~5xizA)1c)g7<>Z{j4s3}G1 z#1mfD(KdxED8)TXIo8@=RG)yV;_%0^>tDDOlQacWpFvQ>A;)sn>+;l+>94Wxdkr!s z(BszO;87rZYS_IO+=az!1j{{IeYl#-{q#ElGrS2(swMF1qa{Z!u z4I)eZOJ8jm$Fvjp&xZY2N!YS(S}yMitUf^3Htak8bA$hWNNLIfn)Vltx{BN+=5hBA z>?s&Dia*D{LXoL4O|xgMMC?MMM~r4ICLlD#J$Khe|A$dKGqM7Y^OI2b?zs6eGZ$qc zpN?6M_b4-y4|ht?PAja=+WmcX`;GddAMqQD8vlu|-dvu1&fB%pgQcC79z8Og#PcF_ z513Sz)hqi&i(1Hrwqt@HY8@J`I4K+BG^AyCs?VZ;+fFu( ztnOyi;sDo4;FO@($i0lXT&Fje(~El+rJY6e9gKqE2L3p8?eMQN`wb;HhLOYwk^Ltt z^@PP5g*|QwhXgAPz`gm@C&?|xO+M;9{xFh38s)c<-?|&tLdGIL?(kRZ6q(x!aF}U6 z>h|fPa-?bNCD_|FJ!i6Qgxuc@xP^ESW8`>lhYqpy*TIh|*uWhp({NIixV&>j-RPmn zwMH?N0FTBlpxPn^$>%tbiiuxNslh6^x(U?dHI)`RRQB$yJlvhGSG3nN{y^qwvA!M` zA$8CF_}xCys3kx~EhP zlI}WXMPl<0BF?ROUcY_K?G2;jl?*S^s>GY%6bItvH;SgR;?=$Vo4BqO=GBBRC2|jFW>7_}x?bG!g=l1pgW2)1N1~;Nm&8X>xB7R1rC0D5g)T zGXl4BAmu zkzzw6@l?v97c^6sJp1Nh>!e0SXErI2ugS*=>JD27^yaG#2EN&$Uyx<6k}`^l-O(++ zGc)N|6P~^HB_R;${gi26@W=9?Mz(P&o>fAJeXVh+53!?gMP=;stNbG$j^lPQr>zzi z@8gSv4UXd#F>x@{&;p3_{tHEuuIYV6dzJ|hx?lpWZu`_aa;fDlF!UGBW9Z%h<;Aj- z)c6$zMwNI#3(p0fx7b+`k8rPH+pGkwOSA(vvq zwS;k7PNDDWU$N@wPV32k$ylV?oAz+}<8BPrPLN)-(xe zFq!>=qyCIDH`g2J1VNg3)PnPy0VwdE@j4MGw_a4L6kGKA%nbnpz z%Kp^n%VImro|dVz_pY)z^}fuTmz;CL$pQ1iL09v=4uXvG$1^2~RAS zL+g)cRV-NB_mHmm4-SZ4nLP2OqHRF-p) zU2}g_=3d-_Zs|q6MtJ7su}Cz!JP*@fxR+&v8s)B4OU=qa9L;smuuo1O+d!SP4D(?8 zeWx8JVS#_q*L{de;q|mNUq<^E`vvN4na<`Psl=GHO{Ytngx*ae7N zOw|3KtpirP&W{fu2mlhsX0{(_YpZMc3#XoRp(Yk_lYGG9{d$)_gUHl03mO8Vv2&?l zkt;g`#2fd{%-MtdRDI@MvSs!Di@?(DI4(1f0fnhV-wGm4p;d2!U2s#wiPs9BTx-$P z;Ifjk7;m9qBmPA(&UDg;x5kYnQOEu_%@U~MdA2ZO*{vX)vEAGKh^(7NsMY5^wfX%; zjjnfGkml9%Qkn-Jx@n3BRm}50T`xEjfnos4&FOs+>$|B1m@ z&`pk9MM=@k=NS25<;FDo@4k{QoV#wPLETmNHg^&?+sQUpeK=4P*e^+*9kN>Pq)nFV z;@mP!SUpz?0C6ha?IS@O)ep%>#jy;}xn z(t@uIf%f?n{TIsxwLbT4FZuSJIxBfPP2w7@ukyaf_J@!f{#RaA_GFMe>(GcppYU`pYwh3qYjAzX>bA z#CZY#UEJ8*+_ya3Jm?L|7dRZhL$N3a#FvySST8Z2=*k0*{NcDLjJe6Nkj$HIsE8FX zUcFer?PTz`*hWY_`BhUIiO~W%nj-(kgut%0;!DmuF0%LHBr5Pqml})kWs5>HqA)6@ zkU3C2r9A-tCbt>z{;d`usR_eJeADWyCz;eZZMO9@w|m)0(NzHyR$hx?WcgNK@ ziDPy?GF6W(V_eg{#UO|>jO!mpj&09XZCvIH=Us1eIZ`8q+>0XaOBhrifGTXXYw(T} z9d+b3fI0;{QEMMT&8OeUc!~SYsGtNMaWJ6kBlfdY0<5-p!J2nJ`hknd}6#UxOmJDzJ#eILbV^9?WQ69jRD>tyxL~Ulav+YT^NgJeq1rL)xOE3KF z?z4s2&M?R{M8(hbQ$ap|6k$cJSZ|JpWX3USkMkZ`iq3D*lv5aR?dNfM{V?l#pKLl8 z^(kzztwj&YvmO3JLr1IAMrw$R72O@Qp}TN)mF{c`zQ-rZzilq(u2HSeE_1TQS%^_3!4CN` z7F{)M>Pu*}@T^KDzfKi%@-f>sPRa6Zgg#idx~JIZiWtt%b1Dl#UPP+0lq|wM%Kzbpt(b+Yf*iZAnEl zJH0^XVI}Lh!ev9+os__UIP@r-AT>5?Yh})vIXgv5%M(nId*1V^rSn2FDd)+h4CnSl z2EkPHi%gcH3#tqMy0YlZ_8$2ZZSPXU1rR02UpO}wAWhTGCyC`{`uC21f}$_$GV>l6 z4EA(%UHurUCc(6nl?`s8y{q**cS-VPNgXavhc}}E*zAz;Cq<3qvzox1oMPqSSvGMc zlCObR4l3FtY8_|yilo&s0^iV5aKg$1NTRrYbCYc{Qoh8o&<(g|JgxE!l+R5H$S@?OrT@OsL`ot zrjcnGsYL`av3?X$=_~N|glWhT_?|c78z6%`!3QvI)A?VxtJ$9xPaL$p+kMP+>Gl>E zf9!j99S&D(S#S|$2?aV99Vnk-)D!>08RRvtIxvg3Va7;ys(@@Hb)RC~62?y0K@rdJ z8_F8N8Z@Y_cz?4ZZKu-BlnbrAXFFrNaKMC5*FtgU{ini@wj)cJ9F* zxw4`^(!8@4>elVnK=lH*=wtHzrcH~D-X>~1t4t0c1S}T6ib~Tc=kN9R95uTZUmT^( zHkNz1BSE8T66odb%|5absbPly=MkF6RoMoE{UT(sjv%+xH;! z%z82b!FrHm)bZZJsLH1Z8YZ#!F~!jno6hopM>%`)GhK~8g^^iAc_k^2te*;^9HZLI zod+9S-}AI*RL0!B5Y_yxEycu%*jwjHEA)z12nEkAxg%JYNvpeCre-Ml;wX-1q}RN` zE@yGI)Pu1nDeZ|v9MsILCp`c&Ef1&@^-~5%5m=C;MiIuZ$kch>n(RN++f_Ii?KIwDfRFXc#uF~n~x-SSRLv(E(=*ok)~jbnIXshUP;yW=?Rvuhziu$J*&&{hTw6lZw(b zKHOZyjkTRa&B<03SEG+!Jg9w4GfXd*4Fgr0#>54igCC8YS42EuOi{ZvGp~P0I!vvr zF=(=Bjs?HZj<%M=<~>oeQE^2^{F$S}$NtT1n!+KErOu?VkQ>u5P?vTpy}K2)4L`Pk z1*wY`k@!%=^psb+X;S1ZT-M;K=DpW4*R6ob^2oZu2;Ts60*2Ah2$@{5@MCT?n}F^k zm+-C{n;p$Oc(E3``g2uNeJhU}`&y6%*u18S2h+N{q@>SefCGe9%Eff3@4+@`l=g#T zq;^5{7pP@;U`8(CW1PwG7|pxipu9;K(Ps-XUg!d(QZMrfsEVm+`1JXFbc3dWG_5!P zq(Nwyqr8W;`C+dUEz`As+zmm+WzeNG(~>vDqLj+XQEa2{*Qr$?kVuYUJoKhFOIRwn zT#R;IP%Lp3Wn1-W&L|t(llwsn$2|slx_)2zPI7|gQKcY1$uyw+#xycX>ExRdK}^YJ ztqLJqZ}AfBv;}nSc&I^mgRKk`z-U-4(fKgC`naAW_#g_y`_W_Z7tT(KD~wHn$@@#P z$S#U|DAuZpjugwcHp09}eE$Xq;1$jz^C zvVnYBA34qwTvJH�P9hxm~mtv5Z=#`pQS=@-uenw39NWU&hD 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 G`2PS}gENBw From f638690095a0471b01f82415b61370f8362fb76c Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Tue, 17 Nov 2020 21:38:43 -0500 Subject: [PATCH 07/41] Traktor S3: fix enumeration --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index bb81c95d1c..7dbc91a3e8 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -152,10 +152,10 @@ actual edit only involves replacing a single word in a text file. 2. There will be a box labeled Preset Info, and that box will have a section labeled "Script Files". 3. Select "Traktor-Kontrol-S3-hid-scripts.js". -5. Either the file should open in an editor, or you should see a file +4. Either the file should open in an editor, or you should see a file browser window with that file selected. If you see a file browser, right click the file and select an option to edit it. -6. At the top of the file will be short instructions explaining how to edit +5. At the top of the file will be short instructions explaining how to edit the file. Changes you make will take effect as soon as you save the file. From a170c97df61982c3633ce1f84d29a4f8f3fe79b5 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Wed, 18 Nov 2020 09:12:28 -0500 Subject: [PATCH 08/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 7dbc91a3e8..9de25f65e4 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -143,10 +143,7 @@ There are two user-friendly customizations possible on the S3: 1. Toggle between Absolute and Relative pitch slider mode. 2. Customize the colors for decks A, B, C, and D. -Making these changes is still a little awkward and we will be making -controller preferences easier to change in the future. For now you'll -have to make a small change to the mapping script file. Don't worry, the -actual edit only involves replacing a single word in a text file. +To make these changes, you need to edit to the mapping script file. 1. Open Mixxx Preferences and select the Kontrol S3 in the side list. 2. There will be a box labeled Preset Info, and that box will have a section From 743e61aa85f769eb75dcd0b4b9dfca4a2b278010 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Wed, 18 Nov 2020 09:13:16 -0500 Subject: [PATCH 09/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 9de25f65e4..7c0ffd5dad 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -20,7 +20,7 @@ Compatibility Controller ~~~~~~~~~~ -The Kontrol S3 is a USB class compliant audio and HID device, +The Kontrol S3 is a USB class compliant audio and :term:`HID` device, so it is compatible with Mixxx without any proprietary drivers on GNU/Linux and Mac OS X. On Windows, it is recommended to install the `driver from Native From 38fe8237c9a1ac185e9415627c1cbb90c1afff0b Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Wed, 18 Nov 2020 09:13:21 -0500 Subject: [PATCH 10/41] Traktor S3: Address notes --- .../native_instruments_traktor_kontrol_s3.rst | 47 +++++++++---------- 1 file changed, 22 insertions(+), 25 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 7dbc91a3e8..05a8d1df45 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -14,6 +14,9 @@ The Kontrol S3 can run from USB bus power. Using the separate power supply increases the brightness of the LEDs, which is helpful for using it in daylight, and increases the volume of the headphone output. + - `Manufacturer's product + page `__ + Compatibility ------------- @@ -38,10 +41,10 @@ Mapping description ------------------- Note that Mixxx doesn't have the concept of a single "master" deck for -sync. Instead, push and hold the sync button to "lock" sync on for all -decks you want to remain in sync. Or you can push Shift + Sync to lock +sync. Instead, push and hold the :hwlabel:`SYNC` button to "lock" sync on for all +decks you want to remain in sync. Or you can push :hwlabel:`SHIFT` + :hwlabel:`SYNC` to lock sync on. Refer to `the Mixxx -manual `__ +manual <../../chapters/djing_with_mixxx.html#master-sync>`__ for details. Mixer @@ -49,21 +52,21 @@ Mixer - Gain, equalizer high/mid/low, and cue (headphones) behave as labelled. - - FX Enable buttons: See Effect section below. + - :hwlabel:`FX Enable` buttons: See Effect section below. - Filter: controls QuickEffect superknob. This controls the Filter effect by default, but a different effect can be chosen in the Equalizer section of Mixxs's Preferences. - - EXT: The EXT button changes the fourth channel pregain (knob), pfl, and volume (slider) adjustments to operate with the Microphone input. The microphone does not respond to EQ or effects. - - Shift + EXT: Switches input from Mic to Line and back again. + - :hwlabel:`EXT`: The :hwlabel:`EXT` button changes the fourth channel pregain (knob), pfl, and volume (slider) adjustments to operate with the Microphone input. The microphone does not respond to EQ or effects. + - :hwlabel:`SHIFT` + :hwlabel:`EXT`: Switches input from Mic to Line and back again. The Master Volume knob on the S3 controls the volume of the S3's master output in hardware, so it does not affect the software master gain knob -in Mixxx by default. You can hold shift and turn the knob to adjust Mixxx's +in Mixxx by default. You can hold :hwlabel:`SHIFT` and turn the knob to adjust Mixxx's master gain. Note that this will still also adjust the hardware gain, so -after you release shift you'll need to adjust the knob again. +after you release :hwlabel:`SHIFT` you'll need to adjust the knob again. Peak display is only generated from software. So if -you see clipping indicated, lower the gain of the playing decks or use Shift + Master Volume. +you see clipping indicated, lower the gain of the playing decks or use :hwlabel:`SHIFT` + Master Volume. Decks ~~~~~ @@ -73,7 +76,7 @@ Control ========================================== =========================================================================================================================================================================== Library knob press Load track selected in library to the deck. :hwlabel:`SHIFT` + Library knob press Eject track. -Small play button While held, plays the current track in the preview deck. If you rotate the library knob while you hold the play button, Mixxx will scan through the track being previewed. +Small play button While held, plays the current track in the preview deck. If you rotate the library knob while you hold the :hwlabel:`PLAY` button, Mixxx will scan through the track being previewed. Star button This button is not used. List-plus button Adds the current track to the Auto DJ list. :hwlabel:`VIEW` button Move focus of library control between left-hand tree and main list. @@ -114,24 +117,24 @@ There are two ways the rate sliders can be mapped: Absolute, and Relative. Abso - Absolute Mode: - - Keylock: Press to toggle keylock mode. - - Sync: Press to beatsync, or press and hold to activate Sync Lock Mode. + - :hwlabel:`KEYLOCK`: Press to toggle keylock mode. + - :hwlabel:`SYNC`: Press to beatsync, or press and hold to activate Sync Lock Mode. - Pitch slider: Adjusts playback speed. - - Shift + Pitch slider: Adjusts musical key + - :hwlabel:`SHIFT` + Pitch slider: Adjusts musical key - Relative Mode: - - Keylock: Press to toggle keylock mode. - - Sync: Press to beatsync, or press and hold to activate Sync Lock Mode. + - :hwlabel:`KEYLOCK`: Press to toggle keylock mode. + - :hwlabel:`SYNC`: Press to beatsync, or press and hold to activate Sync Lock Mode. - Pitch slider: Adjusts playback speed. - Keylock + Pitch Slider: adjusts musical key - - Shift + Pitch Slider: Allows the user to move the slider without any effect. + - :hwlabel:`SHIFT` + Pitch Slider: Allows the user to move the slider without any effect. Effects ~~~~~~~ The FX setup is unusual on this controller. Each deck has a single toggle button for effects, and on the right-hand side of the mixer there are five buttons that determine which effects are applied to every channel that has effects on. This means it is not possible to use the controller to select one effect for one deck, and another effect for another. You can still make these choices in the Mixxx UI, however. -When the Filter Enable button is off, the knob still controls the default QuickEffect, even if that button is not lit in the FX section. When the Filter Enable button is on, the QuickEffect is only enabled if the Filter FX Select button is on. This means the QuickEffect is available on channels that don't have any other effects active. +When the :hwlabel:`Filter Enable` button is off, the knob still controls the default QuickEffect, even if that button is not lit in the FX section. When the :hwlabel:`Filter Enable` button is on, the QuickEffect is only enabled if the Filter :hwlabel:`FX Select` button is on. This means the QuickEffect is available on channels that don't have any other effects active. When turning Filter Enable off, Mixxx will use soft takeover so the QuickEffect doesn't suddenly activate. @@ -150,8 +153,8 @@ actual edit only involves replacing a single word in a text file. 1. Open Mixxx Preferences and select the Kontrol S3 in the side list. 2. There will be a box labeled Preset Info, and that box will have a section - labeled "Script Files". -3. Select "Traktor-Kontrol-S3-hid-scripts.js". + labeled :guilabel:`Script Files`. +3. Select :guilabel:`Traktor-Kontrol-S3-hid-scripts.js`. 4. Either the file should open in an editor, or you should see a file browser window with that file selected. If you see a file browser, right click the file and select an option to edit it. @@ -159,9 +162,3 @@ actual edit only involves replacing a single word in a text file. the file. Changes you make will take effect as soon as you save the file. - -References ----------- - - - `Manufacturer's product - page `__ From ad6d3455068ad2ad4d7894898a2b5469712aab31 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Wed, 18 Nov 2020 09:16:06 -0500 Subject: [PATCH 11/41] Traktor S3: clarify a piece about shift buttons --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index cc63addf04..1bf43f9118 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -47,6 +47,10 @@ sync on. Refer to `the Mixxx manual <../../chapters/djing_with_mixxx.html#master-sync>`__ for details. +.. hint:: There are two :hwlabel:`SHIFT` buttons, one for each side of the + controller. Make sure you press the :hwlabel:`SHIFT` button on the + same side as the control you want to modify. + Mixer ~~~~~ From 710e7ff5901d56b3e4bdbbedbb9ed842ba2d9eb9 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Wed, 18 Nov 2020 09:17:20 -0500 Subject: [PATCH 12/41] Traktor S3: fix file label --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 1bf43f9118..bc858f71b5 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -155,7 +155,7 @@ To make these changes, you need to edit to the mapping script file. 1. Open Mixxx Preferences and select the Kontrol S3 in the side list. 2. There will be a box labeled Preset Info, and that box will have a section labeled :guilabel:`Script Files`. -3. Select :guilabel:`Traktor-Kontrol-S3-hid-scripts.js`. +3. Select :file:`Traktor-Kontrol-S3-hid-scripts.js`. 4. Either the file should open in an editor, or you should see a file browser window with that file selected. If you see a file browser, right click the file and select an option to edit it. From 812aa49a36e749dcc2eb7a13e9396f4f4c461244 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 21 Nov 2020 10:43:50 -0500 Subject: [PATCH 13/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Be --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index bc858f71b5..5e43455e33 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -27,7 +27,7 @@ The Kontrol S3 is a USB class compliant audio and :term:`HID` device, so it is compatible with Mixxx without any proprietary drivers on GNU/Linux and Mac OS X. On Windows, it is recommended to install the `driver from Native -Instruments `__ +Instruments `__ and select the ASIO sound API in the Sound Hardware section of Mixxx's Preferences. From 2d5f95a55538ecc6ef29f4c2a8fbbfa25e4e6be3 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 21 Nov 2020 10:45:31 -0500 Subject: [PATCH 14/41] Traktor S3: remove reference to midi --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index bc858f71b5..e84760ff75 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -31,7 +31,7 @@ Instruments Date: Sat, 21 Nov 2020 17:42:08 -0500 Subject: [PATCH 15/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index dc88228fad..63a1bc625d 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -40,7 +40,7 @@ side of Mixxx's Preferences. Mapping description ------------------- -Note that Mixxx doesn't have the concept of a single "master" deck for +Note that Mixxx doesn't have the concept of a single "leader" deck for sync. Instead, push and hold the :hwlabel:`SYNC` button to "lock" sync on for all decks you want to remain in sync. Or you can push :hwlabel:`SHIFT` + :hwlabel:`SYNC` to lock sync on. Refer to `the Mixxx From 7f9e186b7b77f0c24ccafbe9f13b3ac4eecdac8c Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 21 Nov 2020 17:42:20 -0500 Subject: [PATCH 16/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 63a1bc625d..45aea290bd 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -54,8 +54,7 @@ for details. Mixer ~~~~~ - - Gain, equalizer high/mid/low, and cue (headphones) - behave as labelled. + - The :hwlabel:`GAIN` and equalizer :hwlabel:`HIGH`/:hwlabel:`MID`/:hwlabel:`LOW` knobs and the :hwlabel:`CUE` (headphones) button behave as labelled. - :hwlabel:`FX Enable` buttons: See Effect section below. - Filter: controls QuickEffect superknob. This controls the Filter effect by default, but a different effect can be chosen in the From 9011ebcfa45bded7b0bfbe8964d7f1952bcc6441 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 21 Nov 2020 17:42:34 -0500 Subject: [PATCH 17/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 45aea290bd..e633309d19 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -56,9 +56,7 @@ Mixer - The :hwlabel:`GAIN` and equalizer :hwlabel:`HIGH`/:hwlabel:`MID`/:hwlabel:`LOW` knobs and the :hwlabel:`CUE` (headphones) button behave as labelled. - :hwlabel:`FX Enable` buttons: See Effect section below. - - Filter: controls QuickEffect superknob. This controls the Filter - effect by default, but a different effect can be chosen in the - Equalizer section of Mixxs's Preferences. + - The :hwlabel:`FILTER` knob controls the Quick Effect superknob. By default, this uses a high-/low-pass filter, but a different effect can be chosen in the :ref:`Equalizer section of Mixxx' Preferences `. - :hwlabel:`EXT`: The :hwlabel:`EXT` button changes the fourth channel pregain (knob), pfl, and volume (slider) adjustments to operate with the Microphone input. The microphone does not respond to EQ or effects. - :hwlabel:`SHIFT` + :hwlabel:`EXT`: Switches input from Mic to Line and back again. From ce5ae5fa4b258eaf56eb80292f7a9a0a1b162006 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 21 Nov 2020 17:42:54 -0500 Subject: [PATCH 18/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index e633309d19..06e16e22e2 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -60,10 +60,10 @@ Mixer - :hwlabel:`EXT`: The :hwlabel:`EXT` button changes the fourth channel pregain (knob), pfl, and volume (slider) adjustments to operate with the Microphone input. The microphone does not respond to EQ or effects. - :hwlabel:`SHIFT` + :hwlabel:`EXT`: Switches input from Mic to Line and back again. -The Master Volume knob on the S3 controls the volume of the S3's master -output in hardware, so it does not affect the software master gain knob -in Mixxx by default. You can hold :hwlabel:`SHIFT` and turn the knob to adjust Mixxx's -master gain. Note that this will still also adjust the hardware gain, so +The Main Volume knob on the S3 controls the volume of the S3's main +output in hardware, so it does not affect the software main output gain knob +in Mixxx by default. You can hold :hwlabel:`SHIFT` and turn the knob to adjust Mixxx' +main output gain. Note that this will still also adjust the hardware gain, so after you release :hwlabel:`SHIFT` you'll need to adjust the knob again. Peak display is only generated from software. So if From 72056e5efd22cda5abf3d83ef9e8d079af5d48cd Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 21 Nov 2020 17:43:05 -0500 Subject: [PATCH 19/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 06e16e22e2..29d3818d13 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -67,7 +67,7 @@ main output gain. Note that this will still also adjust the hardware gain, so after you release :hwlabel:`SHIFT` you'll need to adjust the knob again. Peak display is only generated from software. So if -you see clipping indicated, lower the gain of the playing decks or use :hwlabel:`SHIFT` + Master Volume. +you see clipping indicated, lower the gain of the playing decks or use :hwlabel:`SHIFT` + Main Volume knob. Decks ~~~~~ From 2742d6947d4d9442c304c9c91994dcf988d27754 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 21 Nov 2020 17:43:14 -0500 Subject: [PATCH 20/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 29d3818d13..407adccfe7 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -43,8 +43,7 @@ Mapping description Note that Mixxx doesn't have the concept of a single "leader" deck for sync. Instead, push and hold the :hwlabel:`SYNC` button to "lock" sync on for all decks you want to remain in sync. Or you can push :hwlabel:`SHIFT` + :hwlabel:`SYNC` to lock -sync on. Refer to `the Mixxx -manual <../../chapters/djing_with_mixxx.html#master-sync>`__ +sync on. Refer to :ref:`Sync Lock documentation ` for details. .. hint:: There are two :hwlabel:`SHIFT` buttons, one for each side of the From 0e2f83812dfaa08567adab26d5e9413189c9a57b Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 21 Nov 2020 17:46:34 -0500 Subject: [PATCH 21/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 407adccfe7..901a5c80b8 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -134,7 +134,7 @@ Effects The FX setup is unusual on this controller. Each deck has a single toggle button for effects, and on the right-hand side of the mixer there are five buttons that determine which effects are applied to every channel that has effects on. This means it is not possible to use the controller to select one effect for one deck, and another effect for another. You can still make these choices in the Mixxx UI, however. -When the :hwlabel:`Filter Enable` button is off, the knob still controls the default QuickEffect, even if that button is not lit in the FX section. When the :hwlabel:`Filter Enable` button is on, the QuickEffect is only enabled if the Filter :hwlabel:`FX Select` button is on. This means the QuickEffect is available on channels that don't have any other effects active. +When the :hwlabel:`FILTER ENABLE` button is off, the knob still controls the default Quick Effect, even if that button is not lit in the FX section. When the :hwlabel:`FILTER ENABLE` button is on, the Quick Effect is only enabled if the Filter :hwlabel:`FX SELECT` button is on. This means the Quick Effect is available on channels that don't have any other effects active. When turning Filter Enable off, Mixxx will use soft takeover so the QuickEffect doesn't suddenly activate. From a9beee1c35237aef8fbc26b83888cf9d4f1560a0 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 21 Nov 2020 17:47:10 -0500 Subject: [PATCH 22/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 901a5c80b8..34c718df9e 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -136,7 +136,7 @@ The FX setup is unusual on this controller. Each deck has a single toggle butto When the :hwlabel:`FILTER ENABLE` button is off, the knob still controls the default Quick Effect, even if that button is not lit in the FX section. When the :hwlabel:`FILTER ENABLE` button is on, the Quick Effect is only enabled if the Filter :hwlabel:`FX SELECT` button is on. This means the Quick Effect is available on channels that don't have any other effects active. -When turning Filter Enable off, Mixxx will use soft takeover so the QuickEffect doesn't suddenly activate. +When turning :hwlabrl:`FILTER ENABLE` off, Mixxx will use soft takeover so the Quick Effect doesn't suddenly activate. Mapping options ~~~~~~~~~~~~~~~ From b18ea77302c8b726a0798aa0fc7237dd254869cd Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 21 Nov 2020 17:47:19 -0500 Subject: [PATCH 23/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 34c718df9e..556d414e86 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -28,8 +28,7 @@ so it is compatible with Mixxx without any proprietary drivers on GNU/Linux and Mac OS X. On Windows, it is recommended to install the `driver from Native Instruments `__ -and select the ASIO sound API in the Sound Hardware section of Mixxx's -Preferences. +and select the ASIO :ref:`sound API ` in the :ref:`Sound Hardware section of Mixxx's Preferences `. With the S3 plugged in, the device is listed as an available controller in Mixxx's Preferences. The controller uses From 1482e1f0e659cc3293a7c48f2a3008ef2e40a929 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sun, 22 Nov 2020 11:11:24 -0500 Subject: [PATCH 24/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 556d414e86..390c8395a1 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -135,7 +135,7 @@ The FX setup is unusual on this controller. Each deck has a single toggle butto When the :hwlabel:`FILTER ENABLE` button is off, the knob still controls the default Quick Effect, even if that button is not lit in the FX section. When the :hwlabel:`FILTER ENABLE` button is on, the Quick Effect is only enabled if the Filter :hwlabel:`FX SELECT` button is on. This means the Quick Effect is available on channels that don't have any other effects active. -When turning :hwlabrl:`FILTER ENABLE` off, Mixxx will use soft takeover so the Quick Effect doesn't suddenly activate. +When turning :hwlabel:`FILTER ENABLE` off, Mixxx will use soft takeover so the Quick Effect doesn't suddenly activate. Mapping options ~~~~~~~~~~~~~~~ From 5ad94a71865647ac27e81bb6f0fe7d72b6e8deb5 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Wed, 2 Dec 2020 21:24:08 -0500 Subject: [PATCH 25/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 390c8395a1..6820376c34 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -71,7 +71,7 @@ Decks ~~~~~ ========================================== =========================================================================================================================================================================== -Control +Control Description ========================================== =========================================================================================================================================================================== Library knob press Load track selected in library to the deck. :hwlabel:`SHIFT` + Library knob press Eject track. From b4c1a4a622291b696c1fca8bb2b2f5b8b67df327 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Wed, 2 Dec 2020 21:24:17 -0500 Subject: [PATCH 26/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 6820376c34..125db47f29 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -98,7 +98,7 @@ Looping ~~~~~~~ ====================================== ================================================ -Control +Control Description ====================================== ================================================ Right Encoder Turn Double/halve loop size. Right Encoder Press Activate loop of set size from current position. From 7e345d9bcc3ec5d7204edc22392f75ef518dba1a Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Wed, 2 Dec 2020 21:24:31 -0500 Subject: [PATCH 27/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 125db47f29..d98942d94d 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -148,8 +148,8 @@ There are two user-friendly customizations possible on the S3: To make these changes, you need to edit to the mapping script file. 1. Open Mixxx Preferences and select the Kontrol S3 in the side list. -2. There will be a box labeled Preset Info, and that box will have a section - labeled :guilabel:`Script Files`. +2. There will be a box labeled :guilabel:`Mapping Info`, and that box will have a section + labeled :guilabel:`Mapping Files`. 3. Select :file:`Traktor-Kontrol-S3-hid-scripts.js`. 4. Either the file should open in an editor, or you should see a file browser window with that file selected. If you see a file browser, From b67c3d54ab728793469b0d7035b65efbab84e180 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Wed, 2 Dec 2020 21:24:38 -0500 Subject: [PATCH 28/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Co-authored-by: Jan Holthuis --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index d98942d94d..1d09ac795d 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -85,7 +85,7 @@ Transport Mode Buttons ~~~~~~~~~~~~~~~~~~~~~~ ================================= ========================================================== -Control +Control Description ================================= ========================================================== :hwlabel:`REV` Activates a reverse-roll (aka "censor") effect. :hwlabel:`SHIFT` + :hwlabel:`REV` Turns on reverse playback mode. From 89e54fe0129a6999521f67ef180d4c43cf8716b1 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Wed, 2 Dec 2020 21:24:54 -0500 Subject: [PATCH 29/41] Traktor S3: move versionadded --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index dc88228fad..512ca016d3 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -4,8 +4,6 @@ Native Instruments Traktor Kontrol S3 .. sectionauthor:: Owen Williams -.. versionadded:: 2.3.0 - The Kontrol S3 is an introductory 4 deck controller with good build quality and integrated sound card. This is the first controller released with the "S3" name. @@ -17,6 +15,8 @@ it in daylight, and increases the volume of the headphone output. - `Manufacturer's product page `__ +.. versionadded:: 2.3.0 + Compatibility ------------- From a78b1c3591a5ecb1171452d610d16689f9c9073b Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Mon, 7 Dec 2020 22:25:09 -0500 Subject: [PATCH 30/41] Traktor S3: Add information about sound mapping --- .../native_instruments_traktor_kontrol_s3.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index ff17b529db..962794348e 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -36,6 +36,19 @@ HID for the knobs, buttons, and other components on the device, so the mapping can only be loaded when you select the HID device on the left side of Mixxx's Preferences. +Audio Hardware setup +-------------------- + +The S3 has a standard 4 channel sound card. You should configure the channels +as follows: + +============ ===================== +Audio Output Channel Configuration +============ ===================== +Master Channel 1-2 +Headphones Channel 3-4 +============ ===================== + Mapping description ------------------- From 34a78b6eccd347d16f46f5a44283c822f5256665 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 30 Jan 2021 19:31:51 -0500 Subject: [PATCH 31/41] Traktor S3: Add information about pads and effects controls --- .../native_instruments_traktor_kontrol_s3.rst | 80 +++++++++++++++++-- 1 file changed, 75 insertions(+), 5 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 962794348e..716ed973da 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -141,22 +141,92 @@ There are two ways the rate sliders can be mapped: Absolute, and Relative. Abso - Keylock + Pitch Slider: adjusts musical key - :hwlabel:`SHIFT` + Pitch Slider: Allows the user to move the slider without any effect. +Button Pads +~~~~~~~~~~~ + +The grid of 8 buttons have two possible trigger modes: Hotcues, and Samplers. + +In Hotcues mode, pressing the number button will set the hotcue if none exists, and activate it if one does. +If you hold :hwlabel:`SHIFT` and press a button, it will clear that hotcue. + +In Samplers mode, the buttons on the left side of the controller correspond to Samplers 1-8. +The buttons on the right side of the controller correspond to Samplers 9-16. +By default, pressing a number button will activate a sample. +Pressing the button again will stop sample playback. + +You can change this behavior by editing the javascript file to set `TraktorS3.SamplerModePressAndHold = true;`. +In this mode, the sample will play while the button is held, and stop when you let go. + +In both modes, holding :hwlabel:`SHIFT` and pressing a button will eject the sample if it is not playing, and will rewind the sample back to the beginning if it was playing. + Effects -~~~~~~~ +------- + +Because the S3 is an entry-level controller, the FX setup is unusual and a little complex. +Each deck has a single effect toggle button and one knob, and on the right-hand side of the mixer there are five buttons, one for each effect chain and one for the QuickEffect. +These buttons and knobs are used in different ways depending on how they are pushed, and together allow the DJ to customize all of the effects. + +There are three modes that the effect controls can be in: +1. The initial mode is Filter Mode. + This mode is indicated when the :hwlabel:`FILTER ENABLE` buttons have the same colors as the individual decks. + This mode is used for adjusting QuickEffects. +1. The next mode is Effect Chain mode. + This mode is indicated when the :hwlabel:`FILTER ENABLE` buttons are all the same color as one of the effect buttons. + This mode is used for turning individual effects in a chain on and off, and adjusting each effect's meta knob. +1. The last mode is Effect Focus mode. + This mode is indicated when :hwlabel:`FILTER ENABLE` buttons are all the same color as one of the effects, and one of the :hwlabel:`FX SELECT` buttons is blinking. + This mode is used for tuning individual parameters in an effect. + +Switching Effect Modes +~~~~~~~~~~~~~~~~~~~~~~ + +At any time, you can push the :hwlabel:`FILTER` :hwlabel:`FX SELECT` button to return to Filter Mode. +If you get lost, try pusing the :hwlabel:`FILTER` button to start over. + +Press any :hwlabel:`FX SELECT` button to enter Effect Chain mode for that number chain. +If you press the same :hwlabel:`FX SELECT` button again, you'll return to Filter Mode. +Press a different :hwlabel:`FX SELECT` button to enter Effect Chain mode for that other chain. + +Press and hold an :hwlabel:`FX SELECT` button, then press a :hwlabel:`FILTER ENABLE` button to enter Effect Focus mode. +The :hwlabel:`FX SELECT` button will start blinking. +From left to right, the :hwlabel:`FILTER ENABLE` buttons will focus on the first through fourth effects in the chain. +If you press any :hwlabel:`FX SELECT` button, you'll return to Effect Chain mode. + +Soft Takeover +~~~~~~~~~~~~~ + +The knobs have Soft Takeover mode enabled, which means you need to turn the physical knob to match the current position of the UI knob before the value will change. +If you are wondering why it seems like the values aren't changing, you may need to rotate the knob more. + +Assigning Effects +~~~~~~~~~~~~~~~~~ + +You can assign effects to individual decks in Filter Mode. +Press and hold :hwlabel:`FILTER ENABLE`, then press the desired :hwlabel:`FX SELECT` button or buttons. +The :hwlabel:`FX SELECT` buttons that are bright are selected for that deck. + +Effect Chain Mode +~~~~~~~~~~~~~~~~~ -The FX setup is unusual on this controller. Each deck has a single toggle button for effects, and on the right-hand side of the mixer there are five buttons that determine which effects are applied to every channel that has effects on. This means it is not possible to use the controller to select one effect for one deck, and another effect for another. You can still make these choices in the Mixxx UI, however. +In Effect Chain Mode, the :hwlabel:`FILTER ENABLE` buttons change color to match the selected FX button. +The lights will be dim if the effect is disabled, and bright if it is enabled. +Tap the :hwlabel:`FILTER ENABLE` button to enable or disable the effect. +Turn the filter knobs to adjust the meta knob for each effect. +This is to prevent sudden changes in sound when navigating between modes. -When the :hwlabel:`FILTER ENABLE` button is off, the knob still controls the default Quick Effect, even if that button is not lit in the FX section. When the :hwlabel:`FILTER ENABLE` button is on, the Quick Effect is only enabled if the Filter :hwlabel:`FX SELECT` button is on. This means the Quick Effect is available on channels that don't have any other effects active. +Effect Focus Mode +~~~~~~~~~~~~~~~~~ -When turning :hwlabel:`FILTER ENABLE` off, Mixxx will use soft takeover so the Quick Effect doesn't suddenly activate. +In Effect Focus Mode, the :hwlabel:`FILTER ENABLE` buttons represent Effect checkboxes, while the four knobs adjust the first four parameters of the selected effect. Mapping options -~~~~~~~~~~~~~~~ +--------------- There are two user-friendly customizations possible on the S3: 1. Toggle between Absolute and Relative pitch slider mode. 2. Customize the colors for decks A, B, C, and D. + 3. Change the Sampler playback mode. To make these changes, you need to edit to the mapping script file. From d7f08ceaa16ce01c006fb525d4dd591309513c8e Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 30 Jan 2021 20:04:04 -0500 Subject: [PATCH 32/41] Traktor S3: Document JOG and SHIFT+Wheel behavior --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 716ed973da..62f79a0704 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -104,7 +104,8 @@ Control Description :hwlabel:`SHIFT` + :hwlabel:`REV` Turns on reverse playback mode. :hwlabel:`GRID` Turns on Quantize mode. :hwlabel:`FLUX` Turns on Slip mode. -:hwlabel:`JOG` Hold to use the wheels to quickly scroll through the track +:hwlabel:`JOG` Turns on Scratch mode. +:hwlabel:`SHIFT` + Wheels Hold to use the wheels to quickly scroll through the track. ================================= ========================================================== Looping From bbad7c625d67a3ff5a84a8d7ef73072e763042fd Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 30 Jan 2021 21:57:57 -0500 Subject: [PATCH 33/41] Traktor S3: Correction --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 62f79a0704..9ec7c6d80c 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -212,7 +212,8 @@ Effect Chain Mode In Effect Chain Mode, the :hwlabel:`FILTER ENABLE` buttons change color to match the selected FX button. The lights will be dim if the effect is disabled, and bright if it is enabled. Tap the :hwlabel:`FILTER ENABLE` button to enable or disable the effect. -Turn the filter knobs to adjust the meta knob for each effect. +Turn the first three filter knobs to adjust the meta knob for each effect. +The last filter knob adjusts the meta knob for the whole chain. This is to prevent sudden changes in sound when navigating between modes. Effect Focus Mode From 9282e5157863a6587909dafc92741fc5b0fece28 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Sat, 6 Feb 2021 15:38:06 -0500 Subject: [PATCH 34/41] Traktor S3: Add shift+right encoder --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 9ec7c6d80c..147e9104e9 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -115,7 +115,8 @@ Looping Control Description ====================================== ================================================ Right Encoder Turn Double/halve loop size. -Right Encoder Press Activate loop of set size from current position. +:hwlabel:`SHIFT` + Right Encoder Turn Move loop forward/backward by the beatjump size. +Right Encoder Press Activate loop of set size from current position, or disable active loop :hwlabel:`SHIFT` + Right Encoder Press Toggles the existing loop on and off. Left Encoder Turn Beatjump forward/backward. :hwlabel:`SHIFT` + Left Encoder Turn Adjust beatjump size. @@ -229,6 +230,7 @@ There are two user-friendly customizations possible on the S3: 1. Toggle between Absolute and Relative pitch slider mode. 2. Customize the colors for decks A, B, C, and D. 3. Change the Sampler playback mode. + 4. Enable wheel touch scratching. To make these changes, you need to edit to the mapping script file. From 8a766ac88eb92654053a94eaea9bf57804a9720f Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Mon, 15 Feb 2021 15:27:57 -0500 Subject: [PATCH 35/41] Traktor S3: Update manual for jog button change --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 147e9104e9..4dc81d1279 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -104,7 +104,7 @@ Control Description :hwlabel:`SHIFT` + :hwlabel:`REV` Turns on reverse playback mode. :hwlabel:`GRID` Turns on Quantize mode. :hwlabel:`FLUX` Turns on Slip mode. -:hwlabel:`JOG` Turns on Scratch mode. +:hwlabel:`JOG` When on, touching the jog wheels enables Scratch mode. :hwlabel:`SHIFT` + Wheels Hold to use the wheels to quickly scroll through the track. ================================= ========================================================== @@ -230,7 +230,7 @@ There are two user-friendly customizations possible on the S3: 1. Toggle between Absolute and Relative pitch slider mode. 2. Customize the colors for decks A, B, C, and D. 3. Change the Sampler playback mode. - 4. Enable wheel touch scratching. + 4. Whether wheel touch scratching is on by default. To make these changes, you need to edit to the mapping script file. From aa41ab73fb320e1eba9151745875164ebc903bef Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Mon, 15 Feb 2021 17:59:19 -0500 Subject: [PATCH 36/41] Traktor S3: various updates for notes -- clarify inputs --- .../native_instruments_traktor_kontrol_s3.rst | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 4dc81d1279..c70531c4cd 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -25,7 +25,7 @@ Controller The Kontrol S3 is a USB class compliant audio and :term:`HID` device, so it is compatible with Mixxx without any proprietary drivers on -GNU/Linux and Mac OS X. On Windows, it is recommended to install the +GNU/Linux and macOS. On Windows, it is recommended to install the `driver from Native Instruments `__ and select the ASIO :ref:`sound API ` in the :ref:`Sound Hardware section of Mixxx's Preferences `. @@ -49,6 +49,13 @@ Master Channel 1-2 Headphones Channel 3-4 ============ ===================== +Audio Inputs +~~~~~~~~~~~~ +The S3 has two sets of inputs, but only one can be active at a time. There is +a set of line-level RCA inputs on the back of the controller, and a combo +XLR / 1ΒΌ" mic jack on the front. Use :hwlabel:`SHIFT` + :hwlabel:`EXT` to switch +between these inputs. + Mapping description ------------------- @@ -69,7 +76,7 @@ Mixer - :hwlabel:`FX Enable` buttons: See Effect section below. - The :hwlabel:`FILTER` knob controls the Quick Effect superknob. By default, this uses a high-/low-pass filter, but a different effect can be chosen in the :ref:`Equalizer section of Mixxx' Preferences `. - :hwlabel:`EXT`: The :hwlabel:`EXT` button changes the fourth channel pregain (knob), pfl, and volume (slider) adjustments to operate with the Microphone input. The microphone does not respond to EQ or effects. - - :hwlabel:`SHIFT` + :hwlabel:`EXT`: Switches input from Mic to Line and back again. + - :hwlabel:`SHIFT` + :hwlabel:`EXT`: Switches input sensitivity for the input connectors from Mic to Line and back again. The Main Volume knob on the S3 controls the volume of the S3's main output in hardware, so it does not affect the software main output gain knob @@ -86,9 +93,9 @@ Decks ========================================== =========================================================================================================================================================================== Control Description ========================================== =========================================================================================================================================================================== -Library knob press Load track selected in library to the deck. -:hwlabel:`SHIFT` + Library knob press Eject track. -Small play button While held, plays the current track in the preview deck. If you rotate the library knob while you hold the :hwlabel:`PLAY` button, Mixxx will scan through the track being previewed. +Library encoder press Load track selected in library to the deck. +:hwlabel:`SHIFT` + Library encoder press Eject track. +Small play button While held, plays the current track in the preview deck. If you rotate the library encoder while you hold the :hwlabel:`PLAY` button, Mixxx will scan through the track being previewed. Star button This button is not used. List-plus button Adds the current track to the Auto DJ list. :hwlabel:`VIEW` button Move focus of library control between left-hand tree and main list. @@ -137,7 +144,7 @@ There are two ways the rate sliders can be mapped: Absolute, and Relative. Abso - :hwlabel:`SHIFT` + Pitch slider: Adjusts musical key - Relative Mode: - - :hwlabel:`KEYLOCK`: Press to toggle keylock mode. + - :hwlabel:`KEYLOCK`: Press to toggle keylock mode (toggles when releasing the button). - :hwlabel:`SYNC`: Press to beatsync, or press and hold to activate Sync Lock Mode. - Pitch slider: Adjusts playback speed. - Keylock + Pitch Slider: adjusts musical key From d75a6daeec23aa7bcacfd32a69f3e86a1a70c630 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Mon, 15 Feb 2021 21:57:04 -0500 Subject: [PATCH 37/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst call it a "limited effects" controller Co-authored-by: Be --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index c70531c4cd..a665f91eca 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -171,7 +171,7 @@ In both modes, holding :hwlabel:`SHIFT` and pressing a button will eject the sam Effects ------- -Because the S3 is an entry-level controller, the FX setup is unusual and a little complex. +Because the S3 has limited effects controls, the FX setup is unusual and a little complex. Each deck has a single effect toggle button and one knob, and on the right-hand side of the mixer there are five buttons, one for each effect chain and one for the QuickEffect. These buttons and knobs are used in different ways depending on how they are pushed, and together allow the DJ to customize all of the effects. From 4ea5264513caebe5ad8705717a1a41bedccc769f Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Mon, 15 Feb 2021 21:59:03 -0500 Subject: [PATCH 38/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Traktor S3: commit suggestion Co-authored-by: Be --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index a665f91eca..d5ff5fa813 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -227,7 +227,7 @@ This is to prevent sudden changes in sound when navigating between modes. Effect Focus Mode ~~~~~~~~~~~~~~~~~ -In Effect Focus Mode, the :hwlabel:`FILTER ENABLE` buttons represent Effect checkboxes, while the four knobs adjust the first four parameters of the selected effect. +In Effect Focus Mode, the :hwlabel:`FILTER ENABLE` buttons represent effect button parameters, while the four knobs adjust the first four parameters of the selected effect. Mapping options --------------- From 06873b703ac57ea80ce6bf2621ad33c9b218a6d4 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Mon, 15 Feb 2021 21:59:18 -0500 Subject: [PATCH 39/41] Update source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst Traktor S3: commit suggestion Co-authored-by: Be --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index d5ff5fa813..8b4e586671 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -220,7 +220,7 @@ Effect Chain Mode In Effect Chain Mode, the :hwlabel:`FILTER ENABLE` buttons change color to match the selected FX button. The lights will be dim if the effect is disabled, and bright if it is enabled. Tap the :hwlabel:`FILTER ENABLE` button to enable or disable the effect. -Turn the first three filter knobs to adjust the meta knob for each effect. +Turn the first three knobs to adjust the meta knob for each effect. The last filter knob adjusts the meta knob for the whole chain. This is to prevent sudden changes in sound when navigating between modes. From 2fed307991c2ceffaf6fdb689a9ff6a000cc9ac8 Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Mon, 15 Feb 2021 22:01:40 -0500 Subject: [PATCH 40/41] Traktor S3: Clarify some effect lanugage --- .../native_instruments_traktor_kontrol_s3.rst | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index c70531c4cd..bbe4a43368 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -177,14 +177,14 @@ These buttons and knobs are used in different ways depending on how they are pus There are three modes that the effect controls can be in: 1. The initial mode is Filter Mode. - This mode is indicated when the :hwlabel:`FILTER ENABLE` buttons have the same colors as the individual decks. - This mode is used for adjusting QuickEffects. -1. The next mode is Effect Chain mode. - This mode is indicated when the :hwlabel:`FILTER ENABLE` buttons are all the same color as one of the effect buttons. - This mode is used for turning individual effects in a chain on and off, and adjusting each effect's meta knob. -1. The last mode is Effect Focus mode. - This mode is indicated when :hwlabel:`FILTER ENABLE` buttons are all the same color as one of the effects, and one of the :hwlabel:`FX SELECT` buttons is blinking. - This mode is used for tuning individual parameters in an effect. +This mode is indicated when the :hwlabel:`FILTER ENABLE` buttons have the same colors as the individual decks. +This mode is used for adjusting QuickEffects and assigning Effect Chains to decks. +1. The next mode is Effect Chain Edit Mode. +This mode is indicated when the :hwlabel:`FILTER ENABLE` buttons are all the same color as one of the effect buttons. +This mode is used for turning individual effects in a chain on and off, and adjusting each effect chain's mix knob. +1. The last mode is Effect Focus Mode. +This mode is indicated when :hwlabel:`FILTER ENABLE` buttons are all the same color as one of the effects, and one of the :hwlabel:`FX SELECT` buttons is blinking. +This mode is used for tuning individual parameters in an effect and enabling or disabling effect toggle buttons. Switching Effect Modes ~~~~~~~~~~~~~~~~~~~~~~ @@ -210,18 +210,18 @@ If you are wondering why it seems like the values aren't changing, you may need Assigning Effects ~~~~~~~~~~~~~~~~~ -You can assign effects to individual decks in Filter Mode. +You can assign effect chains to individual decks in Filter Mode. Press and hold :hwlabel:`FILTER ENABLE`, then press the desired :hwlabel:`FX SELECT` button or buttons. -The :hwlabel:`FX SELECT` buttons that are bright are selected for that deck. +The :hwlabel:`FX SELECT` buttons that are bright are the effect chains that are selected for that deck. -Effect Chain Mode +Effect Chain Edit Mode ~~~~~~~~~~~~~~~~~ -In Effect Chain Mode, the :hwlabel:`FILTER ENABLE` buttons change color to match the selected FX button. +In Effect Chain Edit Mode, the :hwlabel:`FILTER ENABLE` buttons change color to match the selected FX button. The lights will be dim if the effect is disabled, and bright if it is enabled. Tap the :hwlabel:`FILTER ENABLE` button to enable or disable the effect. Turn the first three filter knobs to adjust the meta knob for each effect. -The last filter knob adjusts the meta knob for the whole chain. +The last filter knob adjusts the mix knob for the whole chain. This is to prevent sudden changes in sound when navigating between modes. Effect Focus Mode From fcf84831aa1cd8923329dc8cc114fea8edb1bf2a Mon Sep 17 00:00:00 2001 From: Owen Williams Date: Tue, 16 Feb 2021 11:35:15 -0500 Subject: [PATCH 41/41] Traktor S3: underline nit --- .../controllers/native_instruments_traktor_kontrol_s3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst index 5e6bfb1099..13b267bf68 100644 --- a/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst +++ b/source/hardware/controllers/native_instruments_traktor_kontrol_s3.rst @@ -215,7 +215,7 @@ Press and hold :hwlabel:`FILTER ENABLE`, then press the desired :hwlabel:`FX SEL The :hwlabel:`FX SELECT` buttons that are bright are the effect chains that are selected for that deck. Effect Chain Edit Mode -~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~ In Effect Chain Edit Mode, the :hwlabel:`FILTER ENABLE` buttons change color to match the selected FX button. The lights will be dim if the effect is disabled, and bright if it is enabled.