Het snelkoppelingssysteem is het meest uitgebreid getest met de Behringer X-Touch Mini en bevat aangepaste code voor de specifieke functies van dit apparaat. Alle andere apparaten worden behandeld als “generieke midi” en kunnen al dan niet (goed) werken of moeten elke keer handmatig worden ingesteld. Een configuratieframework (mogelijk in lua) om aanvullende apparaatspecifieke functies te ondersteunen, staat op de takenlijst.
If you succeed in getting a midi device up and running that hasn’t been mentioned below, it would be greatly appreciated if you would provide feedback in order to assist others, if any special steps are required. You could do this either by submitting a documentation pull request to amend this page or by filing an issue containing the necessary information. Alternatively you could read or respond to any of the (closed) midi or “inputng” issues or pull requests in the main darktable repository if you need additional help or guidance yourself.
Behringer X-touch Mini
Het apparaat moet in de standaardmodus staan (niet in MC). Lagen A & B worden echter enigszins ondersteund, aangezien het apparaat geen melding verstuurt bij het schakelen tussen lagen, en aangezien de updates voor “verborgen” rotors en lichten (zowel onder knoppen als het patroon dat rond de rotors wordt gebruikt) worden genegeerd, alles wordt pas volledig bijgewerkt nadat je iets in de “nieuwe” laag hebt ingedrukt of gedraaid.
De lichtringen rond de rotors vertonen een ander patroon, afhankelijk van of de bijbehorende schuif een symmetrisch +/- bereik heeft gecentreerd rond 0, 0-100 (of 0-1) of iets anders. Indien gekoppeld aan een vervolgkeuzelijst (of sterclassificatie), zal de rotor één licht per keer doen. Als de vervolgkeuzelijst veel (meer dan 13) items heeft (zoals de vervolgkeuzelijst overvloeimodus), gaat de rotor twee keer rond; de eerste keer met één licht aan, en de tweede keer met twee aangrenzende lampen.
Arturia Beatstep
Individual rotors can be configured to send absolute (0-127) values or changes (+/- 1,2,3,… in different encodings). The recommended setting is Relative #1 for all knobs with Knob Acceleration set to Slow (Off) or Medium. This can be configured with Midi Control Center , available for Windows or MacOS. By default the darktable midi module assumes, for unknown devices, that rotors use absolute encodings. After startup it therefore needs to be told that the device is sending relative movements. You can do this by turning one of the encoders slowly left (down) 5 times. This allows the module to determine which of the several relative encodings is used. If you don’t succeed switching encodings on the first attempt, you can reinitialise the input modules by pressing Ctrl+Shift+Alt+I and try again. If you still have problems, you could try this .
Als je de Beatstep-knoppen toewijst aan beoordelingen, kleurlabels of schakelknoppen, moeten ze oplichten wanneer het bijbehorende element is ingeschakeld.
Behringer BCR2000
(en mogelijk BCF2000)
These machines are highly configurable so there are many settings that could complicate the interaction with darktable’s midi module. The BC Manager tool (available for Windows and MacOS) can be used to configure them. The easiest thing to do is to reset all encoders and buttons to their simplest settings, which can be done (for the BCR2000) using this file . You can send it to the machine with BC Manager or (under Linux) with amidi. There’s also a global setting called “Deadtime” that determines how long the BCR ignores arriving messages after sending out updates. This is to avoid feedback loops, but for darktable it means that it blocks the adjustments sent back immediately after each rotor move. So Deadtime needs to be set to 0.
Eenmaal op deze manier geconfigureerd, zouden de knop- en rotorlichten allemaal moeten werken. De bovenste rij rotors (of de enige rij voor de BCF2000) ondersteunt verschillende lichtpatronen (zoals de X-Touch Midi, met wat extra opties en heeft 15 in plaats van 13 leds). Het configureren hiervan is echter ingewikkelder en nog niet geïmplementeerd. Het lijkt ook langzamer te zijn, dus het is mogelijk niet voor elke update in realtime uitvoerbaar (zoals het wordt gedaan voor de X-touch). Dus op dit moment wordt alleen het 12-punts patroon gebruikt. Bij rotors gekoppeld aan drop-down lijsten gaat, net als bij de X-touch de rotor, het licht twee keer rond; voor de eerste 15 opties gaat slechts één lampje branden, voor de tweede 15 opties branden twee aangrenzende lampjes.
Loupedeck
(and Loupedeck+ but not the later non-midi devices)
Going by the information provided here , most of the functionality of the first two loupedeck models (both midi based) should be supported, with the following exceptions and caveats:
- the Hue/Sat/Lum buttons can be mapped to the notebook tabs in the color zones module but the little lights next to them may not respond to update messages sent when the user switches tabs using the mouse, so they might get out of sync
- the 8 sliders/wheels can be individually mapped to the elements of the graph in color zones
Afgezien daarvan, aangezien het loupedeck relatieve codering gebruikt (dus vergelijkbaar met de Beatstep), moet het de midi-module bij elke start vertellen (totdat een configuratiesysteem is geïmplementeerd). Dit doe je door een van de knoppen (of wieltjes) 5 keer langzaam naar beneden/links te draaien. Initialiseer de invoerlaag opnieuw met Ctrl+Shift+Alt+I als het de eerste keer niet werkte, zodat je het opnieuw kunt proberen.
Korg nanoKONTROL2
Het apparaat moet eerst worden geconfigureerd met behulp van de Korg Kontrol Editor-toepassing om in de CC-modus te staan en elke knop moet worden ingesteld op het notitietype en Momentary-knopgedrag. Om de verlichting in de knoppen te bedienen, moet de LED-modus worden ingesteld op Extern. Het is belangrijk op te merken dat de Track- en de Marker-knoppen geen leds hebben.
There is an Kontrol Editor profile available here which can be loaded using the Windows application to directly configure all these settings to correctly work with darktable.
extra midi-configuratie
If darktable is compiled with portmidi it will at startup try to open up to 10 midi devices in the order it finds them. On the command line you might see something like this:
Twee problemen kunnen zich voordoen:
- a device you don’t want to use might be opened anyway (and potentially cause inappropriate behavior, like starting a fireworks show prematurely (see this document , or
- devices might appear in a different order at the next startup (for example because they are plugged into a different usb port). Since configurations are stored with the device number only, reordering would cause an incorrect layout to be picked up.
U kunt specificeren welke apparaten expliciet op een specifieke locatie moeten worden geladen en welke moeten worden overgeslagen met behulp van de configuratieparameter voorkeuren > diversen > interface > toestaan of uitsluiten midi apparaten. Om het laden van de BCR2000 in het bovenstaande voorbeeld over te slaan en de andere twee apparaten in slot 0 en 2 te plaatsen, kunt u deze configuratieparameter instellen op “BeatStep;dontuse;X-TOUCH;-BCR2000”. Dit zou de BeatStep als midi0-apparaat laten, midi1 altijd ongebruikt laten en de BCR2000 helemaal niet laden, maar als er andere apparaten zijn aangesloten, verschijnen ze als midi3, midi4 enzovoort. Door “;-” aan het einde toe te voegen, wordt voorkomen dat verdere apparaten worden geladen. Of, als u de configuratieparameter opgeeft als een enkel minteken “-”, worden er helemaal geen apparaten geladen.
Midi-controller knoppen kunnen verschillende “coderingen” gebruiken. De standaard, absoluut, stuurt een waarde van 0 (helemaal links) tot 127 (helemaal rechts) – schuifregelaars kunnen ook absolute codering gebruiken. Relatieve encoders sturen een “omlaag”-waarde als u ze naar links draait en een “omhoog”-waarde als u ze naar rechts draait. Dus langzaam een van die “omhoog” draaien, zou bijvoorbeeld “1, 1, 1, 1” sturen. Maar afhankelijk van hoeveel bits er worden gebruikt en welke codering, kan een langzame draai naar links 127 (8 bits -1) of 63, 31 of 15 zijn. Of zelfs 65. Als er niets is gespecificeerd in deze voorkeursoptie, wordt aangenomen dat midi-apparaten absolute codering gebruiken. Maar als de eerste vijf ontvangen berichten identiek zijn, wordt aangenomen dat de gebruiker langzaam een knop naar links/omlaag heeft gedraaid en wordt de codering daaruit afgeleid en weergegeven in een toost. De codering wordt niet voor elk apparaat onthouden, dus deze manoeuvre moet bij iedere herstart worden herhaald. Om de afgeleide codering voor de volgende keer opstarten te definiëren, kunt u deze parameter toevoegen aan de instelling “toestaan of uitsluiten midi-apparaten”. Bijvoorbeeld “Loupdek:127”.
Some midi controllers have keys with a light beneath them. These can be used to toggle settings and show the current position by having the light on or off. In this case, darktable checks periodically (a few times a second) whether, say, the position of an on-screen toggle button has been changed, and sends messages to any linked midi device buttons to switch their light on or off. But if an unknown device has unintentionally been connected, this could be undesirable. So by default darktable waits until a “note” message is received from a midi button before sending any “note” light on/off messages back for that button. That way also no more buttons are addressed than exist on the device. If you immediately want all button lights to be used (rather than having to press the highest note once for each session) you can specify the number of buttons in the “order or exclude midi devices” preference, for example, “BeatStep:63:16”.