Lightdiction KB2D User Manual

Interactive device laser harp midi controller
Hide thumbs Also See for KB2D:

Advertisement

Quick Links

Lightdiction
05/09/2015
User Manual
KB2D
Page 1/32
KB2D Interactive Device
Laser Harp MIDI controller
The KB2D Interactive Device is a detection system working as a MIDI controller. It enables to send customizable
MIDI messages just by touching / interacting with lasers, and can be used with any scanning laser projector system
in order to create an interactive projection.
With the various detection modes available, it can be adapted to any show, from the easiest laser Harp system to
the most complete Interactive laser show. It also features laser tracking modes for laser Theremin for instance.
Thanks to an exclusive and innovative patented detection system and powerful algorithms, it is actually the most
compact, stable, competitive and versatile Laser interactive device on the market.
Footswitches or other external MIDI controllers can be used to improve the flexibility of the device during shows.
Lightdiction SAS
KB2D User Manual
March 2022 rev 2.0

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the KB2D and is the answer not in the manual?

Questions and answers

Summary of Contents for Lightdiction KB2D

  • Page 1 Laser Harp MIDI controller The KB2D Interactive Device is a detection system working as a MIDI controller. It enables to send customizable MIDI messages just by touching / interacting with lasers, and can be used with any scanning laser projector system in order to create an interactive projection.
  • Page 2 ➢ V IGH DETECTION RANGE WITH PROGRAMMABLE AMPLIFICATION FOR LONG DISTANCE INTERACTIVE SHOWS TYPICAL APPLICATIONS ➢ L ASER ➢ L ASER TRACKING ➢ I NTERACTIVE LASER SHOWS ➢ I NTERACTIVE GAMES Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
  • Page 3: Table Of Contents

    HOW TO QUICKLY SET A LASER HARP SYSTEM ....................28 Install The KB2D User Interface ........................28 Place the KB2D ..............................28 Connect the KB2D and start the interface ...................... 28 Start your favorite DAW............................. 29 Select the notes you want ..........................29 Calibrate detection parameters ........................
  • Page 4: Presentation Of The Device

    (*) When interacting with a Lambertian white target with ~80% reflectance (1) With a 3W laser projector. Maximum is obtained using the x16 software amplification. (2) With a 20W laser projector. Maximum is obtained using the x16 software amplification. Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
  • Page 5: Setup Of The Kb2D

    ➢ A laser projector to project the pattern you want to interact with. ➢ The KB2D interactive device with a USB (A – B) cable. ➢ A computer with Windows 10 or above with the KB2D Laser Harp Interface. The last KB2D setup can be downloaded at https://lightdiction.com/Ressources/...
  • Page 6: How Does It Work

    The KB2D also detects the width of each interaction, and can send a MIDI signal varying in function of the width. As the KB2D is measuring the angle and not just detecting light (or laser) interactions, it does not have to be synchronized with the scanning system of the laser source.
  • Page 7: Kb2D Laser Harp Interface

    The KB2D Laser Harp interface is an open-source software. The code can be found here: https://github.com/Lightdiction/KB2D_Interface_V3 It is recommended to always use the latest version of the Firmware and of the KB2D Laser Harp Interface, to benefit from all the performances and options available. If the computer running the KB2D Laser Harp Interface is connected to the internet, all available firmware and software updates will be automatically proposed at the start of the software.
  • Page 8: First Start

    Fig. 3: Information window when we start the interface with the KB2D connected If for some reason the KB2D is detected but the ports are not available, you will see this kind of warning window: Fig. 4: Warning window if MIDI ports are detected but are not available This generally happens when another software took the control of the KB2D.
  • Page 9 KB2D Page 9/32 Fig. 5: KB2D Laser Harp Interface when the device is detected and successfully connected If no device is found, the interface is almost empty like this: Fig. 6: KB2D Laser Harp Interface when no device is found...
  • Page 10: Description Of The Interface

    Fig. 7: Button bar Button Description Enable or disable the detection of the KB2D. When the KB2D is started, we see a light Start / Pause on the button next to the USB connector on the KB2D. We can also manually go to Start state by pressing this same button on the KB2D device.
  • Page 11: Midi Ports Settings

    KB2D). Changing this may result in an incorrect communication with the KB2D. Select the MIDI port corresponding to the KB2D for the commands sent to KB2D (MIDI Out Commands) the device. By default, it Is the 1 output port of the KB2D.
  • Page 12: Kb2D Ports

    KB2D Ports Enabled lets you select the number of Ports you want to use for the KB2D. By default, the KB2D uses 2 In / 2 Out. Indeed, 1 In and 1 Out is used for the feedback + command. One other Output of the KB2D is used to send the MIDI signals corresponding to the interaction and effects.
  • Page 13: Beam Angles Configuration

    For the Position variable, the minimum and maximum of the Position correspond to the angle of the first beam and last beam. Click to learn Click to learn a beam (just like the “Learn One Angle” of the Button bar). Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
  • Page 14: Midi Effects Configuration

    KB2D. There is one tab for MIDI Effects Configuration for each port of the KB2D you have activated (1 in 2/2 mode, 2 in 3/3 mode, 3 in 4/4 mode, since 1 port In and Out is reserved for the control and feedback).
  • Page 15 Variable called “N° beam”. By selecting this variable, you indicate to the KB2D that you want the value to change in function of the beam you interact with. When you interact with the first beam, it will be channel 1. If you have 16 beams and you interact with beam number 16, It will send 16.
  • Page 16 This section is shown only if the “Keyboard” variable is used. A keyboard is displayed. The keys currently used are colored in yellow, and the corresponding beam number is indicated on the key. We also have a few options and buttons: Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
  • Page 17 By clicking on a key of the keyboard, this will send the note. This is also a way to check if your KB2D is correctly connected to your DAW or synth. [Click on a key] Also, clicking on the Key will let you choose the beam you want to assign to this note.
  • Page 18: Generic Settings

    At the top of this panel, we have the preset modes: Fig. 19: Preset modes This section lets you switch quickly between some preset modes. This also helps at the beginning to show you some examples, if you do not know how to set the KB2D. Variable Description...
  • Page 19 This is the minimum value (arbitrary unit) of lighting power that the sensor needs to receive to consider an interaction as potentially valid. If this value is too low, the KB2D can detection other elements in the environment, Detection threshold like the background (ceiling if you project your laser vertically indoor).
  • Page 20 It is recommended to not set it too low, or you could have brutal variation when removing your hand for instance. This sets the minimum number of frames before the KB2D starts modulating. It Attack filter avoids to have incorrect values at the start of the interaction, you should keep it quite high preferably.
  • Page 21 When uncheck, the position varies from the first beam angle to last beam angle. The width varies from small interaction to large interaction. Substitute values can be activated independently on each MIDI effect of each KB2D Activate Substitute port. By default, default values are disabled.
  • Page 22 Page 22/32 Main Config The main config section can be found on the right od the KB2D ports settings. Fig. 23: Main Config section In this section, you can create presets of all your parameters, to switch quickly from one configuration to another.
  • Page 23 Include Height settings in your configuration. Include Angles + N Beams Include the Beam Angles configuration section in your configuration. Include Notes and Effects Include the parameters in MIDI Effects configuration. Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
  • Page 24: External Midi Mapping

    This is where you choose the MIDI controller you want to use to control the interface (MIDI In). You can also select a MIDI Out port as a MIDI Thru. All incoming MIDI messages will be automatically transmitted to the MIDI Out port. Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
  • Page 25 When a command is used for mapping, its color turns yellow. All values entered in this section are in hexadecimal! Load, Save File and Reset to Default Fig. 29: Load, save Files and reset to default for mapping Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
  • Page 26: Firmware Updater

    Firmware Updater The Firmware Updater is used to update the firmware inside the KB2D. When activated, the KB2D will restart in this mode. The interface will automatically detect the KB2D in this mode and change the user interface to match the firmware updater needs.
  • Page 27 Fig. 31: Menu to start the Firmware Updater manually If for some reason, the loading fails, and you are unable to start the KB2D anymore, you can force the KB2D to restart in Firmware Updater mode, so you load the firmware again. To do so, unplug your KB2D. Then press the start button on your KB2D device, next to the USB connector, and plug the KB2D while pressing the button.
  • Page 28: How To Quickly Set A Laser Harp System

    Else, just place the KB2D in front of your laser projector to have a position similar to the one on the picture above. The window of the detection system should be centered (approximatively) relatively to your laser emission point.
  • Page 29: Start Your Favorite Daw

    5. SELECT THE NOTES YOU WANT Select the MIDI Notes you want the KB2D to send by clicking on a key on the keyboard and assign it to a beam number. This will also force the KB2D to send the note you selected to its MIDI Out. If you cannot hear anything, check that “KB2D Interactive”...
  • Page 30: Precautions And Recommandations On Use

    • The KB2D device is able to detect variations on 2 dimensions: angle X (in the plane aligned with the length of KB2D box), and distance (height) Z. Place your device accordingly (see Fig. 2). •...
  • Page 31: Common Issues

    The Notes are not stable / Angles parameters are not correct Calibrate each beam independently with the KB2D does not detect for every all notes / The KB2D has “Learn One Angle”. correctly (Not all notes) been roughly calibrated. Is the background is close, increase the...
  • Page 32: Please Read Carefully

    All Lightdiction products are sold pursuant to Lightdiction’s terms and conditions of sale. Purchasers are solely responsible for the choice, selection and use of the Lightdiction products and services described herein, and Lightdiction assumes no liability whatsoever relating to the choice, selection or use of the Lightdiction products and services described herein.

Table of Contents