Home

Bome`s Midi Translator

1. ACTION STRING TYPE CHANNEL CONTROLLER VALUE OF 6F oo Note On 16 111 ANY BA ww 7F Controller 11 ANY 127 B4 xx pp Controller 5 ANY ANY C4 nn ane 5 ANY NONE Keystroke Keystroke based incoming translator actions are defined by single keys and can be separted either by complete keypress cycles down and up or by individual Key Down or Key Up events Having seperate key Up and Down events lets the user define separate translators that occur when a key is pressed down for example to c 2010 by Bome Software Page 27 57 Bome s Midi Translator Manual 6 Translators enable an audio effect and when the key is released disable previously activated effect Edit Translator Entry New Translator Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Incoming Trigger type Key Press Down and Up O Key Down event Enter Tab Key Up event Outgoing Keystroke Collate lt Lett alr translator incoming keystroke action Timer Incoming Timer actions are events that will trigger multiple times automatically depending on the Timer settings Incoming Timer actions must be tied to an already existing Outoing Timer Action in order to work properly Defining Incoming Timer actions is very simple the only option is the selection of which Timer to use Most of the Timer options are defined in the Outgoing Timer Action s
2. Key Press or Sequence CoA J ltiLeft JEsc Key Down event Enter Tab and Backspace Key Up event Incoming MIDIBFAEOD 0 translator outgoing keystroke emulation c 2010 by Bome Software Page 31 57 Bome s Midi Translator Manual 6 Translators E Mouse Included in Mouse type outgoing actions are multiple types of actions Movement Abs Position Button Clicks and Wheel Each of those type of mouse actions includes settings for a variety of different parameters that can be manipulated to control the system mouse Movement Movement events can be transmitted to the system mouse pointer using this mouse event type Move movement is defined in Mickeys which are the smallest measurement of mouse movement Movement is defined using two text boxes one for Up Down movement and the other for Left Right movement For Up and Left movement use negative numbers For Down and Right movement use positive numbers Abs Position Absolute positioning type movement allows for the mouse to be moved to a pre determined point on the screen Absolute positioning is measured in pixels similarly to how screen resolution is set Use your system s screen resolution as a guide for setting absolute positioning example if you have a 1024x768 screen the exact center of the screen would be absolute position 512x384 Button Clicks Left middle
3. c 2010 by Bome Software Page 55 57
4. Bottom Move currently selected translator to bottom of preset list Cut Remove currently selected translator and place in program clipboard c 2010 by Bome Software Page 53 57 Bome s Midi Translator Manual 9 Reference E E E MIDI E E O Copy Copy currently selected translator to program clipboard Paste Create a new translator identical to translator previously cut or copied to program clipboard Delete Remove currently selected translator from preset MIDI Ports Enable disable MIDI ports for your project Project Default Ports Select the default MIDI ports for your project Routing MIDI Thru Create MIDI Thru connections between MIDI interfaces Preset Default Ports Select distinct default ports for a specific preset Open Used Devices Open all MIDI devices that are used in the project and close all other ports Rescan MIDI Devices Rescan for open and closed MIDI ports Log Window Show program log windows which displays detailed information about incoming and outgoing actions as well as letting you display all global system variables Event Monitor Display Activity Monitor on the bottom of the program window to monitor MIDI and program activity Options O Supress outgoing keystroke when active Do not transmit keystroke messages when activated Ignore keystroke as Incoming Action when active Do not recognize keystroke input when activated Settings Open the Settings window for p
5. Click here to start the new rule wizard Click on the new rule and then edit the details on the right translator rules entry Note pretis hexadecimal numbers with Ox e g O54 c 2010 by Bome Software Page 14 57 Bome s Midi Translator Manual 2 Quickstart gt OUTGOING ACTIONS Now you need to specify what you want your outgoing action to be for the translator Select an action type from the dropdown box and then enter the action details in the detail area below Outgoing action types are varied and depend on the application you are working with and what you are trying to accomplish Keep in mind that you can use both local and global variables in your translator entries In the example we are duplicating the incoming MIDI signal s header information so the outgoing action will have identical MIDI channel and controller information Edit Translator Entry New Translator Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Outgoing Action type MIDI message Select your outgoing Outgoing MIDI message CC 16 General 1 LSB pp action type Capture MON rams pecme port rte MIDI message as a sequence of hexadecimal numbers You can also use variables pp th velocity pp then enter the outgoing MIDI message detail here MIDI BF 30 pp translator outgoing actions c 2010 by Bome Software Page 15 57 Bome s Midi Translator Manual 3 Midi Setup Guide 3 Midi Setup Guide gt VIRTUAL
6. Formatted 4 charas 805d poo o0107 decimal 5 digits O amp K ppe QO006B hex uppercase Parameters CAnotes tat Specifying a relative folder will base it on the folder fe pot gp See oreraa containing the project file bc poe ma ASCII character fou can also embed variables They are enclosed in characters and can include an optional formatting specication see examples at the right Incoming MIDI BF 4C po translator outgoing execute file c 2010 by Bome Software Page 35 57 Bome s Midi Translator Manual 6 Translators 6 3 Rules and Variables gt RULES AND VARIABLES OVERVIEW Translators are comprised of three main sections incoming actions outgoing actions and rules This part of the documentation covers Rules how to use and to be related to Variables and what they can be used for Rules are basically simplified programming steps that take data from the incoming actions or global variables and can affect what happens with the translator s outgoing action Rules use variables to pass data back and forth between the incoming action and the outgoing action of a translator Rules are normally processed from top to bottom the rule on the first line is processed first followed by the second and so on Rules can also use Labels and Jumps to direct programming flow Existing rules can be moved up and down in the rules box by first selecting the rule then clicking the Up
7. 3 ReMOTE ZeRO SL Port 3 MIDI IN ReMOTE ZeRQO SL Port 3 ReMOTE ZeRO SL Port 3 MIDI OUT ooooos ooo define midi ports c 2010 by Bome Software Page 10 57 Bome s Midi Translator Manual 2 Quickstart gt MIDI THRU Access the MIDI router by either clicking File Project Properties MIDI Router in the menu or by clicking MIDI Router in the Settings dialog and then clicking Open Project Properties Click and drag a MIDI IN connection on the left side of the screen to the desired MIDI OUT connection to enable a MIDI thru connection on the ports Any data NOT capture by Bome s MIDI Translator will be output to the designated output port Project Properties Author Info MIDI Router Default MIDI Ports Here you can create MIDI Thru connections i e connect MIDI IN to MIDI OUT MIDI Router ports by dragging from a left port to a right port Click on Aliases to set up the needed aliases Virtual In SeA P a Sem Virtual Qut Automap MIDI EJ A 8 S MIDI Mapper z d Pn Microsoft GS ReMOTE ZERO jy I Wavetable SW SL r Fort 1 i i Pat r k Ha j ale Synth ReMOTE ZeRO fer ee E C SL Port Z ad E automep MIDI Simply drag and drop from your MIDI source port to your destination to create a MIDI Thru connection allowing all non handled MIDI data to pass by uneffected define midi thru connections c 2010 by Bome Software Page 11 57 Bome s Midi Translator Manual 2 Quicks
8. IN LC MIDI Mapper MIDI Mapper MIDI OUT _ Microsoft GS Wavetable SW Synth Microsoft GS Wavetable SW Synth MIDI OUT C ReMOTE ZeRO SL Port 1 ReMOTE 7eRO SL Port 1 MIDI OUT ReMOTE ZeRO SL Port 2 ReMOTE 7eRO SL Port 2 MIDI IN C ReMOTE ZeRO SL Port 2 ReMOTE eRO SL Port 2 MIDI OUT C ReMOTE ZeRO SL Port 3 ReMOTE eRO SL Port 3 MIDI IN MIDI port assignment c 2010 by Bome Software Page 43 57 Bome s Midi Translator Manual 7 Settings gt MIDI ROUTER The MIDI Translator Router is a powerful but simple way for MIDI Thru connection to be made between MIDI Interfaces All detected MIDI IN interfaces are displayed on the left column of the screen while detected MIDI OUT interfaces are displayed on the right side Simply drag and drop a new line between the two interfaces you wish to create a THRU connection on and one will be created represented by a solid line between them MIDI THRU interface connections can span from one MIDI IN connection to many MIDI OUT connections Settings Bome s Midi Translator Pro i Start Up Virtual MIDI Ports b Appearance Here you can create virtual MIDI ports that you can use to send MIDI messages directly to other MIDI applications and receive MIDI messages from other applications Select the number of virtual MIDI ports you p MIDI Por ts need i MIDI Router Use virtual MIDI ports Number of vi
9. MIDI data simply select On Specific Port s from the radio button selector on the right and put a check next to the box for each MIDI OUT port you wish to use Also an optional Description can be entered for each Outgoing Action that will give a plain text description that can be viewed from the program main interface Edit Translator Entry Browser Preview Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Outgoing Action type MIDI message fae Outgoing MIDI message CC H16 Controller 111 xx Default ai BF6F s o C Capture MIDI On specific porfa Enter the MIDI message as a sequence of hexadecimal numbers You can also use variables pp Port Alias qq f Eg 944 pp will send a Note On message with key hex 44 and with velocity pp E Automap MIDI ReMOTE 2eRO SL Ports ReMOTE ZeRO SL Port Description of the MIDI message optional ReMOTE ZeRO SL Port Project OUT me MIDI EF 4C pp translator outgoing MIDI c 2010 by Bome Software Page 30 57 Bome s Midi Translator Manual 6 Translators E Keystroke Emulation Outgoing keystroke emulation actions are the cornerstone of Bomes MIDI Translator Incoming actions can be translated to any combination of keystrokes for use in complex macro routines to control 3rd party program functions The best place to start with prog
10. MIDI ports the program will ask the user to reassign the used ports in the project to different MIDI devices that are available on the computer Standalone aliases can also be created allowing you to create named ports in your projects to better organize MIDI communications For example it can be beneficial to create named ports in your project such as KEYBOARD IN and PROJECT OUT to make your projects more human readable Default MIDI Ports and or Aliases can be assigned to different elements of your Bome s project allowing flexibility in routing MIDI data to different devices Default ports can be assigned at the overall Project level which will dictate where newly created MIDI translators will receieve and transmit MIDI data After the Project level default ports aliases can be assigned at the Preset level allowing you to override the Project default ports and have entire Presets dedicated to managing the MIDI data coming from or going to a particular device or devices Lastly individual Presets can have default portassignments that override both the Preset and Project default ports Settings Bome s Midi Translator Pro n Start Up Setup MIDI Port and Port Aliases Appearance Inspect create and modify MIG A i MIDI translators Check or uncheck MIDI Ports TAE E EE MIDI Router oP L x i Virtual Ports Fort Alias MOevice Fort Type Devices r
11. Saves current project as a new file name Close Close Project Closes current project prompting for save if applicable Project Properties Opens the Project Properties screen Export Encrypted Export encrypted project file only used in Author edition Exit Exit Bomes MIDI Translator prompting for save if applicable Preset E E E E New Create a new preset in currently open program template Rename Rename currently selected preset Delete Delete currently selected preset Duplicate Create an identical copy of currently selected preset Move Submenu Move selected preset up down top bottom Save As Text File Save currently selected preset as a readable text file for easy display Properties Enter preset properties screen to specify always on default port properties Translator E E E E Add Add new blank translator to currently active preset Edit Edit currently selected translator Rename Rename currently selected translator Duplicate Create an identical copy of currently selected translator in current preset Activate Enable currently selected translator to process incoming and outgoing events Deactivate Disable currently selected translator from process incoming and outgoing events Move Up Move currently selected translator up one entry in preset list Down Move currently selected translator down one entry in preset list Top Move currently selected translator to top of preset list
12. and right button clicks can be emulated using this mouse outgoing action Button click events are usually positioned after mouse movement events allowing the user to position the mouse properly before clicking or dragging etc A Button Click event is comprised of a complete Mouse Up Mouse Down event unless otherwise selected in the checkboxes provided Wheel Mouse wheel events can also be transmitted Mouse wheel events can either be Forward away from you or Backward towards you c 2010 by Bome Software Page 32 57 Bome s Midi Translator Manual 6 Translators Edit Translator Entry M_Select Loop Bracket Options F5 Incoming F6 Rules F7 Gutgoing F8 Select the Outgoing Action type Mouse Movement Abs Position Button Clicks C Wheel Incoming Key down s translator outgoing mouse Timer There are two main types of Timer actions Activate Timer and Kill Timer Timers can be instantiated by selecting them as an outgoing action and setting their appropriate repeat times and other options Timers are usually associated with other translators that have the Timer name as their incoming action For instance if you wanted to repeat the Up arrow key as long as a condition is met you would first create an outgoing Timer action that set the repeat rate then you
13. installed icons Click Finish to exit Setup installation completion c 2010 by Bome Software Page 8 57 Bome s Midi Translator Manual 2 Quickstart gt STARTING MIDI TRANSLATOR Start Bome s MIDI Translator by double clicking the desktop icon Bome s Midi Translator Pro starting midi translator 2 3 MIDI Setup gt MIDI SETTINGS The first step in setting up Bome s MIDI Translator to work with your MIDI device is to define it in the program MIDI settings To access the MIDI settings simply press the settings icon in the toolbar or select Options and then Settings in the menu Bome s Midi Translator Pro Fie Preset Translator MIDI View Options Help Incoming Trigger Outgoing Action Options Click here to open the MIDI settings dialog window e MIDI In MIDI Time Code e Translating MIDI Out a Mouse Out e Kevin a Timerln Active Sensing Router Out a Key Out imer Out Closed MIDI IN ReMOTE ZeRO SL Port 3 midi settings c 2010 by Bome Software Page 9 57 Bome s Midi Translator Manual 2 Quickstart gt DEFINE MIDI PORTS Next specify the MIDI input and output ports you will be using The MIDI OUT port will be the port translated MIDI messages are sent to This is where your virtual MIDI port will be used if you are setting up a tranlator for a software sequencer or other audio application that interfaces with MIDI Select your virtual MIDI port as the output device and then specify it as t
14. or Down buttons next to the Rules list Variables can either be defined in an incoming action or through the Rules section of a translator Incoming actions defined with a varible as part of the action will pass the variable on to the rules section to be processed and potentially used as a global variable or passed on to the outgoing action Edit Translator Entry DualFilter 1 Options F5 i Incoming F6 Rules F7 Outgoing FS Rules Description Sree o m _ ji eu o wiic vss if oo lt 63 then Goto Left THEN Goto 1f oot 64 then Coto Right Label Left Jump xH O0 2 Go to xH HH 127 Left H 1 L XE XH EEH A jump serves to skip rules or to r execute rules The destination XX HH 127 of a jump iz identified by a Label Goto Exit Label Right xu o0 64 XX XX Note prefis hexadecimal numbers with Os e g 0x54 translator rules c 2010 by Bome Software Page 36 57 Bome s Midi Translator Manual 6 Translators gt RULE TYPES There are seven types of rules in Bomes MIDI Translator Three of these rules Assignment Expression and Conditional deal directly with variables changing their values and operating off of of conditionals determined by variable
15. s MIDI Translator 1 as the Out Port in the program preferences Device Default Generic MIDI Add Edit Make sure you have the program set to transmit the clock signal by going into the MIDI Clock category of the preferences dialog and making sure Send MIDI Clock is checkmarked Also make sure that you have MIDI clock playing by accessing the metronome section of the user interface and clicking the Play button in the MIDI CLOCK section 2 The next step is to configure Bome s MIDI Translator to activate the virtual ports we wish to use coming IN going OUT and then to link them via the program MIDI Router Activate the Virtual MIDI port OUT and IN devices by going into Settings MIDI Ports and putting a checkmark next to each MIDI device Setup MIDI Port and Port Aliases Inspect create and modify MIDI ports and Port Aliases An alias can be used for selecting specific ports in translators Check or uncheck to open close the device BB eras a i U Used in current project Port Alias Device Port Type ie Bome s Midi Translator 1 Virtual In Bome s Midi Translator 1 Virtual In MIDI IN l Bome s Midi Translator 1 Virtual Out Bome s Midi Translator 1 Virtual Out MIDI OUT l F Bardin A T Tr Avidia R MT Te RATTAT TRI c 2010 by Bome Software Page 48 57 Bome s Midi Translator Manual 8 Usage Examples Next you ll need to make a link between the IN device and the OUT device in the MIDI Router Open the MIDI Rout
16. translation of a single Incoming Action event through to a single Outgoing Action event Name The Name refers to the unique name given to an individual Translator gt Incoming Trigger ref trans ators incoming An Incoming Trigger event is an event that causes an associated Translator to start Incoming Trigger events can be one of the following MIDI message ref trans ators incoming midi Keystroke ref trans ators incoming keys Timer ref trans ators incoming timer Preset Change ref trans ators incoming preset Special ref trans ators incoming special gt Outgoing Action ref trans ators outgoing An Outgoing Action event is an event associated with a translator that has been activated Bomes MIDI Translator will generate an Outgoing Action event depending on the Trasnalator Rules and if certain criteria are met An Outgoing Action event may be one of the following MIDI message ref trans ators outgoing mid Key Stroke Emulation ref trans ators outgoing keys Mouse ref trans ators outgoing mouse Timer ref trans ators outgoing timer Preset Change ref trans ators outgoing preset Special ref trans ators outgoing special WM_Messages ref trans ators outgoing wm gt Execute File ref trans ators outgoing execute Timer A Timer is an internal function of Bome s MIDI Translator that will generate repeated Incoming Triggers depending on the Timer properties Options ref trans at
17. IRTUAL PORT INSTALLATION COMPLETE Press the Finish button to complete the installation of the virtual MIDI port Found New Hardware Wizard Completing the Found New Hardware Wizard The wizard has finished installing the software for Tou Bome s Virtual MIDI Port Device J Click Finish to close the wizard virtual port installation complete c 2010 by Bome Software Page 7 57 Bome s Midi Translator Manual 2 Quickstart gt RELEASE NOTES Please read the software release notes and then press Next ie setup Bome s Midi Translator Pro Information Please read the following important information before continuing When you are ready to continue with Setup click Next NEW PROJECT FILE bmtp FORMAT This version of Bome s Midi Translator uses a new Iversion of bmitp tiles Any project file that you jsave with this version CANNOT be opened with version 11 6 1 or earlier Keep that in mind before sharing your presets with DOCUMENTATION The documentation included in this release is Inot updated yet to the the new 1 7 features Well follow up with an update release when the release notes gt COMPLETION Congratulations You have installed Bome s MIDI Translator successfully ie setup Bome s Midi Translator Pro Completing the Bome s Midi Translator Pro Setup Wizard Setup has finished installing Bome s Midi Translator Pro on your computer The application may be launched by selecting the
18. MIDI PORTS Beginning with Bome s MIDI Translator v1 7 and above a virtual MIDI port driver is included as an optional install with the application Virtual MIDI ports are available for use as unidirectional MIDI ports requiring the MIDI Translator application on one end and any another MIDI device destination on the other Unlike loopback virtual MIDI ports which function as both IN and OUT ports simultaneously Bome s virtual MIDI ports only pass through the Windows API once rather than twice to route MIDI data This added efficiency makes Bome s MIDI Translator faster and more reliable with the end result of reduced latency and jitter when operating with MIDI data Bome s MIDI Translator also benefits from a high speed MIDI data processing engine at it s core delivering MIDI and translator action data at near realtime speeds As a result of the direct connection Bome s virtual MIDI ports have into the MIDI Translator s API one end of the virtual MIDI port MUST be connected to the MIDI Translator application via translators or the MT Router Direct use of the virtual MIDI ports between two applications is impossible Bome s MIDI Translator can communication directly with any MIDI device or application allowing it to serve as a powerful hub for MIDI information A common use for MIDI Translator s virtual ports would be to syncronize the MIDI clocks of two applications Using MIDI Translator s virtual ports this is a simple task of linki
19. Manual gt TOOLBAR 4 Program Interface The Toolbar enables easy access to the most commonly used menu items in Bomes MIDI Translator There is an equivalent menu item for each of these icons which can be accessed via the menu system or via keyboard shortcut Icon Name Description W New Project Start a new empty project Ti Open Project Open a Project file from disk Uy Save Project Save the current Project to disk New Preset Create a new Translator Preset Duplicate Preset Create a new Preset with the same Translators of the current Preset IR Rename Preset Rename selected Translator Preset Xi Delete Preset Delete selected Translator Preset dG New Translator Add a new Translator Ss Edit Translator Edit the selected Translator IR Rename Translator Rename the selected Translator Fg Copy Translator Copy the selected Translator s to the clipboard Ejo Cut Translator Cut the selected Translator s to the clipboard lt P Paste Translator Paste Translator s from the clipboard Xi Delete Translator Delete selected Translator s D Stop Reset the MIDI out device Panic E Settings Show the Settings dialog for program configuration P Help Show Help Topics gt ACTIVITY MONITOR This is the event activity area of the screen where you can quickly see what internal and external signals Bomes MIDI Translator is processing The virtual LEDs will flash when the noted action is being performed or the noted signal is being
20. be thought of as a MIDI Thru connection Any MIDI data that is received by a source device in a MIDI Router patch connection is retransmitted to all connected destination devices Project Properties pe Author Info x Default MIDI Ports MIDI Router In this configuration MIDI clock data from Traktor is being retransmitted to both Ableton s MIDI input and to an external hardware MIDI interface MIDI data is also being routed from an external hardware MIDI controller directly into Traktor with another patch connection midi router setup MIDI Router Here you can create MIDI Thru connections i e connect MIDI IN to MIDI OUT ports by dragging from a left port to aright port Click on Aliases to set up aeine needed aliases Automap er Propellerhead Waa roject Remote i Project Traktor es os me Translator 2 9 Virtual Tn c 2010 by Bome Software ol Port 2 al 0 ZERTU la REMOTE ZeRO wet SL Port 3 Audio 8 DJ Out R i Automap Wat Propellerhead T ee z Ni Project Traktor ed OUT Pex Bome s Midi 9 Translator 2 Se Viral Out Ta E Project Able ton Page 18 57 Bome s Midi Translator Manual 4 Program Interface 4 Program Interface gt TRANSLATOR INTERFACE From the main window of Bome s MIDI Translator a user can manage projects presets and translators from start to finsh The main interface
21. bome software Bome s Midi Translator USER MANUAL Bome s Midi Translator Manual 1 Welcome 1 Welcome Thank you for choosing Bome s Midi Translator This document contains Midi Translator Quick Start Midi Translator Manual Documentation Annoucement List Asa legal ower of this software you may get updates of this Software Sign up to the announcement list to get update notifications The volume on this list is very low one email per new version of Midi Translator User Support Discussion Forums get professional help for your questions Contact Bome Software user support for registered users We hope you enjoy our software The Bome Software Team Note These help documents were created for the Windows version of Midi Translator The concepts are the same but the screenshots look a little different Sorry for the inconvenience c 2010 by Bome Software Page 1 57 Bome s Midi Translator Manual 2 Quickstart 2 Quickstart 2 1 Before You Begin Install Bome s Midi Translator with the options that you require If you wish to transmit MIDI messages to another application make sure to install Bome s virtual MIDI port drivers during installation On Mac computers the virtual port is installed by default 2 2 Installation 2 2 1 General Installation gt INITIAL INSTALL SCREEN After double clicking the downloaded executable file the installation wizard will begin As stated it is r
22. checkboxes next to the MIDI IN and MIDI OUT ports you wish to use for the preset Also note that you can select Project Default Ports to use the default project ports as defined in the Settings screen Properties for Preset Main Properties Default MIDI Ports Default MIDI Ports Here you can assign default MIDI ports for this preset These ports will be used for incoming outgoing MIDI messages If you do not set any the project default ports will be used You can override these default ports in individual translator entries Presets can have _ Project Default Port Project Default Port specific input and Specific Ports Specific Ports output MIDI ports defined This can be useful for working Input Port Aliases Output Port Aliases a Bome s Midi Translator 1 Virtual In Microsoft GS Wavetable SW Synth with multiple devices H Automap MIDI Automap MIDI or programs Select F ReMOTE EeRO SL Port 1 C ReMOTE ZeRO SL Port 1 specific preset ports F ReMOTE ZERO SL Port 2 F ReMOTE eRO SL Port 2 by checking the box F ReMOTE ZERO SL Port 3 F ReMOTE eRO SL Fort 3 next to them in the Project IN W Project OUT Preset Properties dialog window Cancel default project MIDI ports c 2010 by Bome Software Page 23 57 Bome s Midi Translator Manual 6 Translators 6 Translators gt TRANSLATORS OVERVIEW Translators comprise the core functionality of Bomes MIDI Translator In si
23. coming action is to use the capture midi feature covered in the Quick Start guide to capture the incoming MIDI information while you are pressing a keyboard key turning a knob or otherwise If you need to assign multiple values to a single translator variables can be used Translators can be assigned to listen on a specific port if so required Select the MIDI ports you wish for the translator to listen on by clicking on the On Specific Port s radio button and putting a checkmark next to each port you would like your translator to listen on Translators also have two additional options regarding MIDI messages as Incoming Actions gt Swallow MIDI Message Do Not Route This option indicated that you wish NOT to retransmit the incoming MIDI message on to the MIDI Thru destinations specified in the Project Routing connection screen Description of MIDI Message This option allows you to write a short description of the Incoming Action for the translator that will show up in the main program interface This can make complex translator setups much easier to work with and navigate c 2010 by Bome Software Page 26 57 Bome s Midi Translator Manual 6 Translators Edit Translator Entry Browser Preview Options F5 Incoming FE Rules F7 Outgoing F8 C Capture MICI nbers You can aio use variables pp of key hex 44 with any velocity Then Incoming MIDI port selection Outgoing Keystroke Shift Flet
24. creen which is covered in the Outgoing Actions section below Edit Translator Entry New Translator Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Incoming Trigger type Timer Timer name Keyboard Repeat translator timer action Preset Change Preset change incoming actions are actions that are activated when the preset is changed through some means Preset Change Actions are useful for one off type of actions that only occur once at the very beginning of the preset change These actions are often reset actions that could either redefine global variables or reset controllers c 2010 by Bome Software Page 28 57 Bome s Midi Translator Manual 6 Translators to default values translator incoming preset change action Special Special Actions are actions that occur in response to program events Startup actions are best defined with Special actions such as when the project file is loaded Certain actions that need to take place first before any other actions and only once are best defined by using Special actions such as Full Screening your application and perhaps enabling recording Edit Translator Entry New Translator Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Incoming Trigger type EEs This special event is triggered wher the project file is opened This event will be triggered wheneve
25. ctiva ted or Select the Outgoing Action type Piesel Change a deactivated as an O Activate Next Preset This Outgoing Acton will activate or dee outacina action preset f you want to switch to one pres g g O Activate Previous Preset others select deactivate all other prese Activate by Mame E w the always active preset s O Deactivate by Name _ Changing to a preset by number is O bas Activate by number i selected with number 0 If the number Deactivate by number than the number of presets nothing hap e MIDI In a MIDI Time e Kevin e Timerln e Active Sens Opened MIDI IN ReMOTE ZeRO SL Port 1 Deactivate all other presets except the always active changing presets via translator c 2010 by Bome Software Page 22 57 Bome s Midi Translator Manual 5 Presets gt DEFAULT MIDI PORTS Individual presets can also have Default Ports defined Default Input MIDI ports are useful if you have multiple MIDI IN devices you wish to manage independantly from one another or you have MIDI hardware on the same MIDI channel that you wish to separate Default Output ports are useful if you are working with multiple software programs or outboard devices and you wish to devide and manage translator data amongst them Defining Default Ports for a preset is simple First right click on the preset you wish to change and select Properties to enter the Preset Properties screen again Select the Default MIDI Ports page and enable the
26. e imported and exported from Bome s MIDI Translator allowing you to backup and restore your program settings as well as allowing you to transport settings information to different computers running MIDI Translator gt STARTUP OPTIONS The Startup section deals with how Bome s MIDI Translator initially starts Many users may want Bome s to run seamlessly in the background of their computers without having to think about it Having the program start up automatically with the operating system and then run hidden in the background can be preferrable once you have all your Translators created Start Minimized If this option is enabled Bome s MIDI Translator will automatically start in it s minimized state when run Autostart with Windows This option causes MIDI Translator to automatically start when Windows is booted gt Show Splash Screen Enable or disable the showing of the program splash screen when MIDI Translator is run c 2010 by Bome Software Page 41 57 Bome s Midi Translator Manual 7 Settings gt APPEARANCE The Appearance section of the settings window deals with how the program behaves in the system tray and how MIDI incoming and outgoing action messages are displayed in the Translator interface Keep an eye on the program status icon in the system tray it can be used to diagnose problems with your setup quickly Show Tray Icon This option turns the program tray icon on and Off Animate Tray Icon Th
27. e s virtual MIDI ports however program functionality will be limited Virtual MIDI port devices allow Bome s MIDI Translator to communicate with software hosts that don t have direct MIDI port connections ie setup Bome s Midi Translator Pro Select Additional Tasks Which additional tasks should be performed Select the additional tasks you would like Setup to perform while installing Bome s Midi Translator Pro then click Next Virtual Driver Support Install support for Bome s virtual MIDI ports _ Remove the virtual driver first only in case of problems Additional icons Create a desktop icon _ Create a Quick Launch icon L Create an additional start menu icon Cancel menu options c 2010 by Bome Software Page 5 57 Bome s Midi Translator Manual 2 Quickstart 2 2 2 Virtual Port Installation gt INSTALL WARNING If you have chosen to install support for Bome s virtual MIDI ports you will be presented with a dialog box detailing their installation process Read the instructions carefully and then click OK Warning You have chosen to add virtual MIDI ports These ports are implemented as drivers so Windows may show the New Hardware dialog multiple times 1 Choose Wo not this time when prompted for Windows Update 2 Choose Install the software automatically 3 Choose Continue anyway when the unsigned driver warning appears Press OK to continue driver installation v
28. ecommended that you close any other applications before beginning the installation ie setup Bome s Midi Translator Pro Welcome to the Bome s Midi Translator Pro Setup Wizard This will install Bome s Midi Translator Pro 1 7 0 on your computer tis recommended that you close all other applications before continuing Click Next to continue or Cancel to eat Setup initial install screen c 2010 by Bome Software Page 2 57 Bome s Midi Translator Manual 2 Quickstart gt LICENSE AGREEMENT Please read the license agreement thouroughly After reading please select I accept the agreement and click Next to acknowledge the license agreement and continue with installation ie setup Bome s Midi Translator Pro License Agreement Please read the following important information before continuing Please read the following License Agreement You must accept the tems of this agreement before continuing with the installation Mou should carefully read the following terms and conditions before using this software SHAREWARE Bome s Midi Translator Pro in the following the SOFTWARE is Shareware You are expected after the evaluation period to purchase a license See the file purchase html for more details accept the agreement do not accept the agreement licsense agreement c 2010 by Bome Software Page 3 57 Bome s M
29. epresent Bome s Midi Translator 2 Virtual Out MIDI OUT actual hardware and ReMOTE ZeRO SL Port 1 MIDI IN software MIDI ports Bome s Midi Translator 2 Virtual In MIDI IN Bome s Midi Translator 1 Virtual Out MIDI OUT Aliases are pointers L Audio 8 DJ In Audio 8 DJ In MIDI IN to these devices that MIDI OUT can be reconfigured Adianap MIDI Automap MIDI MIDI IN on the fly F jiii 4 hilii iiini Aliases are automatically created for any detected MIDI devices Ifa device is changed or removed from your configuration you can reassign any Translators using it to another device easily by pointing the Port Alias to a new device in the MIDI Ports configuration settings screen Default aliases can be specified via project settings preset or individual translator devices and aliases c 2010 by Bome Software Page 17 57 Bome s Midi Translator Manual gt MIDI ROUTER 3 Midi Setup Guide By default MIDI Translator does NOT route ANY MIDI data For MIDI data to be processed either a Translator must be created for it or a MIDI Router connection must be made The MIDI Router is a patch panel type setup screen that allows for patch cords to be created between availble MIDI devices and aliases Multiple connections can be made from a single source MIDI IN device allowing MIDI data to be replicated and send to multiple devices concurrently A MIDI Router patch connection in Bome s MIDI Translator can effectively
30. er by clicking on Settings MIDI Router Project Properties Drag a link between Bome s MIDI Translator 1 Virutal IN and Bome s MIDI Translator 1 Virtual OUT This will tell MIDI Translator to pass all data from Traktor thru to our MIDI clock destination source Ableton Live MIDI Router Here you can create MIDI Thru connections ie connect MIDI IN to MIDI OUT ports by dragging from a left port to a right port Click on Aliases to set up the needed aliases Bome s Midi ee Bome s Midi A Translator 1 EJ 6 Y jTranslator 1 P Virtual Tn Virtual Orat 3 The final step is to activate our MIDI clock control in our destination application In Live s preferences dialog window select the MIDI Sync category and turn Sync on for Input From Bome s MIDI Translator 1 to tell Live to receive MIDI clock from MIDI Translator c 2010 by Bome Software Page 49 57 Bome s Midi Translator Manual 9 Reference 9 Reference gt TERMINOLOGY Project A Project is a collection of Presets grouped by a set of common attributes such as MIDI in out thru settings appearance settings and other common application wide attributes Preset ref presets A Preset is a collection of Translators There are individually named Presets which may be switched and activated separately as well as an always active preset which is perpetually active Translator ref trans ators A Translator is an individual rule defining the
31. ft GS Wavetable SW 5 Port 2 _ Automap MIDI ReMOTE ZERO S amp L Port 3 Project IN _ ReMOTE 7eRO SL Port 2 REMOTE ZeRO SL Port 3 Project OUT default MIDI ports c 2010 by Bome Software Page 46 57 Bome s Midi Translator Manual 7 Settings gt EXPORT IMPORT SETTINGS The MIDI Translator settings Export Import feature allows a user to backup their settings to a bmts file for restore at a later time Export With this function you export your settings to a bmts file These settings include gt Window size and position Selected translator preset All program options Import After saving your settings with the Export function you can restore the settings again with the Import settings function in the Settings menu This is particularly helpful if you want to transfer your settings to another computer give them to a friend or you have to reinstall your OS c 2010 by Bome Software Page 47 57 Bome s Midi Translator Manual 8 Usage Examples 8 Usage Examples 8 1 Traktor Ableton Live Sync Beginning with Bome s MIDI Translator v1 7 and above a virtual MIDI port system is included as an optional install with the application Virtual MIDI ports are available for use as unidirectional MIDI ports 1 The first step is to select the Bome s virtual port as the MIDI output in your MIDI clock source application In this example we re using Traktor to act as the MIDI clock master Select Bome
32. he MIDI input port in your 3rd party application in order to have Bomes Midi Translator control it The MIDI IN port will be used as the source of MIDI data typically connecting with an external USB controller or a MIDI interface on a sound card Select the appropriate MIDI input source and then move on to MIDI thru routing Settings Bome s Midi Translator Pro Start Up Setup MIDI Port and Port Aliases Appearance Inspect create and modify MIDI ports and Port Aliases An alias can be used for selecting specific ports in we MIDI translators Check or uncheck to open close the device MIDI Ports 2S Se a oo MIDI a PEP O open used Ports Virtual Ports are ees ee U Used in current project Port Alias Device Port Type U F Automap MIDI Automap MIDI MIDI IN Select the C Automap MIDI Automap MIDI MIDI OUT MIDI ports Bome s Midi Translator 1VirtualIn Bome s Midi Translator 1 Virtual In MIDI IN you wi sh the Bome s Midi Translator 1 Virtual Qut Bome s Midi Translator 1 Virtual Out MIDI OUT MIDI Mapper MIDI Mapper MIDI OUT program to Microsoft GS Wavetable SW Synth Microsoft GS Wavetable SW Synth s MIDI OUT use for ReMOTE ZeRO SL Port 1 ReMOTE ZeRO SL Port 1 MIDI IN incoming and ReMOTE ZeRO SL Port 1 REMOTE ZeRO SL Port 1 MIDI QUT O utgo j ng ReMOTE ZeRO SL Port 2 ReMOTE ZERO SL Port 2 MIDI IN translation ReMOTE ZERO SL Port 2 ReMOTE ZeRO SL Port 2 MIDI OUT ReMOTE ZeRO SL Port
33. idi Translator Manual 2 Quickstart gt CHOOSE INSTALL DIRECTORY Choose a directory to install Bome s MIDI Translator to If you would like to install Bome s MIDI Translator to another directory or disk drive click Browse and select the desired installation directory prior to clicking Next If you have no preference please click Next and continue with the installation process ie setup Bome s Midi Translator Pro Select Destination Location Where should Bome s Midi Translator Pro be installed iJ Setup will install Bome s Midi Translator Pro into the following folder To continue click Next F you would like to select a different folder click Browse Program Fle Bome Midi Tranelater Pro At least 6 0 MB of free disk space is required Cues choose install directory c 2010 by Bome Software Page 4 57 Bome s Midi Translator Manual 2 Quickstart gt ADDITIONAL INSTALLATION TASKS Choose whether or not you d like to allow the installation to create a desktop icon and start menu icons so that you may easliy start the program after it s installed Also choose whether or not to install the virtual MIDI port drivers If you choose not to install them please skip ahead to the Release Notes section Otherwise continue on to Virtual Port Installation Note Bome s MIDI Translator Pro CAN operate without Bom
34. ip Next Rule Skip Next 2 Rules Exit Rules Execute Outgoing Action Exit Rules Skip Outgoing Action EQUALS true example IF 10 10 THEN DOES NOT EQUAL true example IF 10 45 THEN gt GREATER THAN OR EQUAL TO true example IF 86 gt 45 THEN lt LESS THAN OR EQUAL TO true example IF 34 lt 34 THEN gt GREATER THAN true example IF 10 gt 4 THEN lt LESS THAN true example IF 24 lt 80 THEN c 2010 by Bome Software Page 38 57 Bome s Midi Translator Manual 6 Translators gt VARIABLE TYPES There are two main types of variables in Bomes MIDI Translator Local variables and Global variables Variables can be set either with incoming actions or with rules Once set a Local variable may be used for the duration of an active Translator losing it s value once the Translator has finished processing A Global variable however will retain it s value as long as Bomes MIDI Translator is running Local Variables Local Variables are defined by character combinations in the following range oo xx example pp ss ww etc Local variables retain their value as long as the Translator is processing Local variables are normally the most commonly used variables and are useful for holding temporary values Local variables can be used in incoming actions to pass for example a continuous controller value to the Rules section of a T
35. irtual port install warning gt VIRTUAL PORT INSTALL Bome s virtual MIDI ports are installed much like a real hardware device Click Install the software automatically and then click Next to continue Found New Hardware Wizard Welcome to the Found New Hardware Wizard This wizard helps you install sottware for Bome Virtual MIDI Port Device f your hardware came with an installation CD or floppy disk insert it now What do you want the wizard to do Install the software automatically Recommended Install from a list or specific location Advanced Click Next to continue virtual port hardware install c 2010 by Bome Software Page 6 57 Bome s Midi Translator Manual 2 Quickstart gt LOGO TESTING Be sure to click Continue Anyway when you are prompted about Windows Logo Testing Hardware Installation A The software you are installing for this hardware Bome s Virtual MIDI Port Device has not passed Windows Logo testing to verify its compatibility with Windows P Tell me why this testing is important Continuing your installation of this software may impair or destabilize the correct operation of your system either immediately or in the future Microsoft strongly recommends that you stop this installation now and contact the hardware vendor for software that has passed Windows Logo testing Continue Anyway STOP Installation logo testing warning gt V
36. is subdivided into four main sections the Menu System the Toolbar the Translator Interface and the Activity Monitor The translator interface defines which translator rules are available and activated as well as allowing you to switch between available presets Available presets are listed on the left pane window along with the always active preset if defined The right side of the Translator Interface contains the various rules that are defined in the template along with a checkbox for activating deactivating the translators and a brief rundown of the incoming and outgoing actions for each Each item in the translator interface has an appropriate context menu that is easily accessed by right clicking the object Also global level actions for either presets or translators can be accessed by right clicking the background of the appropriate pane you wish to work with example bmtp Bome s Midi Translator Pro File Preset Translator MIDI View Options Help Translators Translators capture MIDI Activity Monitor Incoming Triggers which can range Realtime status feedback Presets Collections from MIDI messages keystrokes or of incoming and outgoing of Translator objects even timers Captured data can then MIDI data and program that can be activated be manipulated and retransmitted as actions or deactivated easily a different MIDI signal or action interface elements c 2010 by Bome Software Page 19 57 Bome s Midi Translator
37. is options enabled the program tray icon to display basic input output routing information Please refer to the Reference for more detailed information on this Minimize To Tray Enables the program to minimize to the system tray instead of the taskbar freeing it from view on the system taskbar with any other programs Friendly Descriptions This enables or disables the display of friendly messages in the Translator user interface When Friendly Descriptions is disabled only MIDI hexidecimal codes are displayed in the incoming and outgoing actions of translators With this option enabled the Incoming and Outgoing action fields of each Translator are converted to decimal and have other helpful MIDI reference information inserted c 2010 by Bome Software Page 42 57 Bome s Midi Translator Manual 7 Settings gt MIDI PORTS AND ALIASES The MIDI Ports screen is where you set your incoming and outgoing MIDI ports as well as where you specify project aliases Simply mark the checkbox next to the MIDI IN and OUT ports you wish to use in your project and they will become available for use in translators All available MIDI ports are automatically assigned a same named alias when MIDI Translator is started Any project that is opened from another user with different MIDI hardware will STILL have entries for their unique MIDI incoming and outgoing settings Using the MIDI ports screen one can reassign the MIDI assignments of a pro
38. ject to point to any combination of hardware and or software MIDI ports To create a new MIDI port alias simply click on the Add Alias button above the MIDI port listing A new alias will be created which can be named anything and assigned to any hardware or software MIDI port MIDI Aliases are useful for working with multiple input and output MIDI sources such as connecting multiple hardware MIDI devices or connecting one or more hardware MIDI devices to multiple software inputs Settings Bome s Midi Translator Pro Start Up Setup MIDI Port and Port Aliases gt Appearance Inspect create and modify MIDI ports and Port Aliases An alias can be used for selecting specific ports in i MID translators Check or uncheck to open close the device MIDI Ports Penu a aes oF xy IR Open Used Ports Virtual Ports U Used in current project F Port Alias Device PortType U A EE Project IN ReMOTE ZeRO SL Port 1 mor m T Click here to P e E Project OUT Bome s Midi Translator 1 Virtual Out MIDIOUT U add a MIDI Bome s Midi Translator 1 Virtual Out Bome s Midi Translator 1 Virtual Out MIDI OUT u 0 rt 3 lias to ReMOTE ZeRO SL Port 1 ReMOTE eRO SL Port 1 MIDI IN U p i Automap MIDI Automap MIDI MIDI IN Your project C Automap MIDI Automap MIDI MIDI OUT Bome s Midi Translator 1VirtualIn Bome s Midi Translator 1 Virtual In MIDI
39. lator will effectively swallow any Note Off key release messages 2 The second translator has as incoming MIDI message e g 90 45 qq The outgoing action is the action that you want to do when pressing the key Here it does not matter if Stop Processing is checked or not With this trick you get a translator the 2nd one which only reacts on key down Note you can achieve the same with the Rules Edit Translator Entry New Translator Options F5 Incoming F6 Rules F7 Outgoing F8 Here You can define general options of this Translator Entry like name if itis currentl enabled and how to proceed after this Translator Entry successfully executed Mame Hew Translator Achve Stop processing with this translator Show Help Duplicate Revert Close Apply translator options screen c 2010 by Bome Software Page 25 57 Bome s Midi Translator Manual 6 Translators 6 1 Incoming Triggers gt INCOMING TRIGGERS Incoming Trigger actions are events that Bomes MIDI Translator can detect and act on Bomes MIDI Translator can recognize five different types of incoming actions MIDI Message MIDI Messages are defined as hexidecimal values in Bomes MIDI Translator The hex values are broken up into three parts the first being the associated MIDI channel the second being the controller number and the third being the controller CC value The most simple way of defining a new MIDI in
40. ling through presets Activate Deactivate By NameThis action will activate deactivate a preset that is selected by name from a drop down box This is useful for most simple preset setups involving few presets Features that involve key commands can be enabled disabled on the fly so as not to interfere with regular keyboard operation when not needed Activate Deactivate By NumberPresets can be enabled or disabled by number which can be specified by a unique local or global variable see the rules section for more information This outgoing preset change action is useful for more complex MIDI Translator scripts that have many presets and change them on the fly depending on other Translator settings and variable states Presets also have the checkbox option available to Deactivate all other presets except the always active This can be enabled in any Preset Change outgoing action to automatically disable all other presets except of course the always active preset example bmtp Bome s Midi Translator Pro SOURS BURRS DOA Preset Name Incoming Trigger Outgoing Action Options Main 1 Shift Button Dowr 1 COC HIE RPN LSE 127 activate only preset Shift _ Shift 2 Shift_ Button Up 2 CC HIE APN LSB O activate only preset Main always active 3 Edit Translator Entry Shift_Button_Down A preset may be Options F5 Incoming F6 Rules F7 Outgoing F8 a
41. mation to your Bome s MIDI Translator project file that will travel with the file if you decide to redistribute it This section is particularly of use if you are sharing project template files with other users Information collected in the Author Info page includes Author Name o Author Contact Info Comments c 2010 by Bome Software Page 45 57 Bome s Midi Translator Manual 7 Settings gt DEFAULT MIDI PORTS The Default MIDI Ports settings screen lets the user specify the incoming and outgoing MIDI ports that are used by the project when it is opened This functionality is useful when transporting project files between computers that may have different MIDI controllers Project MIDI port aliases can be created in the MIDI Ports Aliases screen and selected in the Default MIDI Ports screen to ensure that rules created for one MIDI device can be linked to another easily The Default MIDI Ports screen can be accessed via either the program menu by navigating to File Project Properties Default MIDI Ports Project Properties Author Info Default MIDI Ports PEE Here you can assign default MIDI ports for the entire project These ports willl i MIDI Router be used for incoming outgoing MIDI messages unless you override them with individual preset default ports or with specific ports settings in individual Input Port Aliases Output Port Aliases 7 Bome s Midi Translator 1 Virtu MIDI Mapper Port 1 _ Microso
42. mple descriptive property of the translator It does not have any value other than for reference in presets and activation rules The Translator name is not a unique value therefore multiple translators can have the same name It is recommened that the c 2010 by Bome Software Page 24 57 Bome s Midi Translator Manual 6 Translators Translator name be something simple that will make identifying multiple translators in large templates more easy Active This value determines whether the translator is actively being processed listening for defined incoming action or whether it is disabled and therefore ignoring incoming actions This parameter can also be changed from the main MIDI Translator interface Stop processing with this translator If this is enabled successful completion of this translator s Outgoing Action will cause the rest of the translators in the current preset to be ignored This is useful for multiple part presets that have different processes depending on different defined actions A simple and useful use case for Stop Processing is to ignore the Note Off MIDI Message from your MIDI keyboard For example if you want to trigger a translator only when pressing the key but not when releasing it then create two translators 1 In the first translator specify the Note On MIDI message with O velocity which is often used for Note Off e g 90 45 00 with Stop Processing checked and no outgoing action This trans
43. mple terms translators listen for an incoming action optionally do some processing on the incoming action see the Rules section of the manual and then optionally output an outgoing action Translators are limited to a Single incoming action and outgoing action but you can easily create multiple translators with identical incoming or outgoing actions depending on your needs Translators can however transmit and receive on multiple MIDI ports making interfacing with different devices easier Also the routing flexibility of outgoing actions and rules allow for a lot to be accomplished with a single translator example bmtp Bome s Midi Translator Pro Fie Preset Translator MIDI View Options Help AO ERs BVUROa Os Oae Preset Name Incoming Trigger Outgoing Action Browser Preview 4 CC 16 Controller 76 0 Keystroke Shift Returr This is a Translator object This translator listens for a signal on MIDI channel 16 continous controller channel 76 with a value of zero Once the incoming trigger signal is received the keystroke combination of Shitt Return is transmitted e MIDI In MIDI Time Code e Translating e MIDI Out e Mouse Out e Kkeyln Timerln Active Sensing Router Out e Key Out Timer Out Opened MIDI IN ReMOTE 7eRO SL Port 1 typical midi translator setup gt TRANSLATOR OPTIONS There are three main settings in the Options screen for individual translators Name This is the si
44. ng each application to a Bome s virtual MIDI ports then connecting them in the MIDI Router Bome s MIDI Translator Virtual MIDI Ports Virtual MIDI Ports can be used to allow MIDI communications between multiple external devices and multiple 3 party applications Linking one Bomes Virtual Port OUT applications IN port to another application s OUT port can be configured s Standard MIDI Port easily in the MIDI Router section of the program settings Borne s MT Virtual MIDI Ports are designed to be fast stable and highly configurable _ __ _ Bomes Virtual Port IN MIDI OUT MIDI Application 2 virtual port flow diagram c 2010 by Bome Software Page 16 57 Bome s Midi Translator Manual 3 Midi Setup Guide gt DEVICES AND ALIASES Devices and aliases represent the different MIDI sources and destinations available for MIDI Translator to send and receive MIDI data Devices are automatically assigned an identically named alias and are listed in the MIDI Ports configuration page in the program settings Aliases function as dynamic links to devices allowing a MIDI Translator project to be shared amongst users with different MIDI hardware and software When a Translator entry is created default input and ouput MIDI ports are assigned to it based on settings in the Project Preset and Translator default ports configuration pages When a project file is opened by a user that has different hardware and software
45. o editing Alt C Midi Capture for MIDI as Incoming or Outgoing Action Ctri PageDown Cycle to next tab Ctri PageUp Cycle to previous tab F5 Jump directly to the General tab F6 Jump directly to the Edit Incoming Action F7 Jump directly to the Edit Rules Pro version F8 Jump directly to the Edit Outgoing Action c 2010 by Bome Software Page 51 57 Bome s Midi Translator Manual 9 Reference gt COMMAND LINE SWITCHES debug debugging output through OutputDebugString nosilent more debugging output nodebug silent reverse the meaning settings lt filename gt load bmts file instead of loading settings from registry project lt filename gt load bmtp file at startup midiin lt MIDI dev gt select the named MIDI device on startup for input midiout lt MIDI dev gt select the named MIDI device on startup for output autostart add MT Player to hidden autostart group noautostart remove from hidden autostart bmidi lt num ports gt select the number of virtual MIDI ports you wish MIDI Translator to use c 2010 by Bome Software Page 52 57 Bome s Midi Translator Manual 9 Reference gt MENU REFERENCE File E Open Open Project Opens an existing MIDI Translator project file Open Merge Merge Project Opens an existing MIDI Translator project file and merges presets with open project Save Save Project Saves current project prompting for a name if first save Save As Save Project As
46. on ANY value of the control BF 29 MIDI Channel 16 Control 41 and then pass the velocity or continous control value on to the rules section of the translator for processing BF xx oo This Incoming MIDI event will activate the associated translator on ANY activity on MIDI channel 16 for ANY controller Rules like this are useful for effecting a whole controller range on a MIDI channel such as changing the velocity of a whole keyboard layout Sample Outgoing MIDI Actions 5 ga 29 xx This Outgoing MIDI event will output the xx value most of the time this will be a value calculated in the translator s rules section on the 41 controller on MIDI channel ga In this example the ga variable can be predetermined by another translator or tied to another MIDI control processed by Bomes MIDI Translator For example the ga variable can be set by a knob on your MIDI controller giving you the capability to select which MIDI channel the translator is actually transmitting to in real time c 2010 by Bome Software Page 40 57 Bome s Midi Translator Manual 7 Settings 7 Settings Settings for Bome s MIDI Translator allow the end user to modify the general behavior of the program Setup options for Bome s MIDI Translator are divided up into six general categories Startup Options Appearance MIDI Ports Aliases MIDI Router Virtual MIDI Ports Default MIDI Ports Oo Oo OO O g Also settings information can b
47. ors options The options available to change the behavior of a Translator object Options pertaining to a Translator event are comprised of the following Name ref trans ators options name Active ref trans ators options active Stop Processing ref trans ators options stop Oo 0 O Oo Oo 0 O O ODO c 2010 by Bome Software Page 50 57 Bome s Midi Translator Manual 9 Reference gt KEYBOARD SHORTCUTS Global Shift Esc MIDI Panic Stops all MIDI information immediately Ctrl O Open Project Opens an existing MIDI Translator project file Ctrl S Save Project Saves current project prompting for a name if first Save Ctrl F12 Save Project As Saves current project as a new file name Ctri F4 Close Project Closes current project prompting for save if applicable Ctri E Show Edit Window Shows the Translator edit window Preset Translator Interface Del Delete currently selected object F2 Rename currently selected object Ctri A Select All objects in active viewing area Ctri D Duplicate selected object Ctri Up Ctri Down move selected object up down in list view Translator Interface only Ctrl C Copy Translator to clipboard Ctri V Paste Translator from clipboard Ctri X Cut Translator to clipboard Edit Translator Window Ctri N Move to next Translator in preset Ctrl P Move to previous Translator in preset Ctri A Apply edits to Translator Ctri R Revert edits to state prior t
48. processing of the rules to a Label point A Label name may be typed in directly or an existing label jump destination may be picked from the drop down box Label jump destination This is the destination point in the rules processing that you would like a jump point to redirect to Labels are useful for defining functions in your rules sets Exit Rules and execute Outgoing Action This is a direct action Upon processing this rule the Translator will immediately stop processing the rules and execute the Translator s Outgoing Action These rules are commonly found coupled with Conditional rules and Labels to create complex processing statements Exit Rules and ignore Outgoing Action This is a direct action This rule will immediately stop processing the rules set but will NOT execute the outgoing action This is useful for making Translators that ONLY execute when certain conditions are met c 2010 by Bome Software Page 37 57 Bome s Midi Translator Manual 6 Translators Conditional example IF pp 10 THEN IF gc gt xx THEN Conditional rules allow you to specify that a rule will ONLY execute if certain conditions are met Conditional rules are constructed as follows IF value variable gt lt gt lt value variable THEN If the preceding conditional is true then one of the following actions is performed Conditional Rules Operator Table Assignment Expression Jump Sk
49. r a project file is opened You can Use it e g to initialize variables processing is disabled This event is tiggered when you press the panic button or when the disable processing outgoing action i executed processing is enabled This event is tiggered when you release the panic button or when the enable processing outgoing action is executed Outgoing none translator incoming special action c 2010 by Bome Software Page 29 57 Bome s Midi Translator Manual 6 Translators 6 2 Outgoing Actions gt OUTGOING ACTIONS Bomes MIDI Translator can natively output seven types of outgoing actions as well as function with translators that are composed solely of rules with no defined outgoing action The Outgoing Actions supported are MIDI Message Keystroke Emulation Mouse Timer Preset Change Special WM_Messages and None MIDI Message One of the most powerful features of Bomes MIDI Translator Pro is the capabiity to translate MIDI messages and apply rules to them In the screenshot below the output value of the translator s outgoing MIDI message includes an xx variable statement meaning that any number of rules could have been used to assign value to this variable depending on many factors Outgoing MIDI actions can be transmitted on the Project Default MIDI ports or on specific MIDI ports unique to the individual translator object To select specific MIDI ports for trasmitting outgoing
50. ramming keyboard combination macros is to consult your software s instruction manual and determine what keyboard shortcuts are available to you Keyboard Emulation outgoing actions can either be whole key press key combination events or individual Key Up Key Down events For outgoing keyboard commands that require the use of either the Tab or Backspace keys a checkbox is provided that overrides the default behavior of those keys and allows them to be entered into the sequence box If you want to execute a key event and have the key repeated as long as you press a key on your MIDI Keyboard you will need two translators 1 The first translator s incoming MIDI message is e g 90 45 00 i e it reacts on the Note Off event with Stop Processing activated As outgoing Key Stroke use Key Up Event Enter the letter to be typed in the text field e g X 2 The second translator s incoming MIDI message is e g 90 45 qq i e it will react on all Note On messages As outgoing action use Key Down Event Type the same letter in text field as for the Key Up event e g X Enable the Key Repeat box Now press the key on your MIDI Keyboard down As long as you press it the letter X will be typed Once you release the key the keystroke emulation stops too Edit Translator Entry Browser Open Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Outgoing Action type Key Stroke Emulation ae
51. ranslator where it can then be processed and resent to the outgoing action Global Variables Global variables are defined by character combinations in the following ranges ga gz g0 g9 ha hz hO h9 na nz nO n9 example h4 kd j0 nb etc Global variables retain their value indefinately Global variables are useful for passing information between translators One common use of global variables is to create a Shift button on your controller which can then control which translators are processed depending on the state of the shift control Another common use of global variables is to Hold a controller s value while a timer is running allowing you to re send that value when the timer is done processing c 2010 by Bome Software Page 39 57 Bome s Midi Translator Manual 6 Translators gt USING RULES AND VARIABLES One of the most useful way to use Rules and Variables in your Translator settings is in the translation of a velocity or cc value to another value Variables may utilized in the mapping of an incoming MIDI action in a translator by changing the last value to a variable setting instead of a static value Variables may be used in both incoming and outgoing translator actions allowing values input into translators to be processed and then sent on to the outgoing MIDI port while retaining full routing flexibility Sample Incoming MIDI Actions BF 29 oo This Incoming MIDI event will activate our translator
52. received or transmitted a MIDI Ir a Keln a MIDI Out a Router Out a Mouse Out Key Out MID Time Code e Translating Active Sensing a Timerln a Timer Out activity monitor c 2010 by Bome Software Page 20 57 Bome s Midi Translator Manual 5 Presets 5 Presets gt PRESETS OVERVIEW Bomes MIDI Translator includes the capabiltity to encapsulate Translator entries into Presets which can be managed at a more detailed level than a normal Global setup where every translator is active all the time A preset s active or inactive state can be determined by looking at the checkbox next to it s name If the checkbox is checked the preset is active and it s translators are being processed If the preset s checkbox is unchecked it is deactivated and no processing occurs Presets can be selected by clicking the preset s name and they can be activated and deactivated via the mouse by clicking the checkbox Presets can also be managed via the context menu accessed by right clicking either the preset itself copy rename delete etc or by right clicking the Preset area s background Presets activation and deactivation can also be manipulated via Outgoing Actions of normal Translators gt ALWAYS ACTIVE PRESETS Bomes MIDI Translator includes the capability to make a preset Always Active rendering it exempt from the rules of Preset Change Outgoing Actions from translators To make a preset Always Active simpl
53. rogram configuration Help Overview Index of help resources available for Bome s MIDI Translator Purchase Midi Translator Open web browser page detailing purchasing information Other Bome Products Open web browser page showing other products from Bome com About Show program license version and copyright information c 2010 by Bome Software Page 54 57 Bome s Midi Translator Manual 9 Reference gt SYSTEM TRAY ICON System Tray Right Click Menu Exit Exit the program MIDI MIDI Ports Shortcut to MIDI Ports Aliases screen Project Default Ports Shortcut to Project Default MIDI port assignment screen gt Routing MIDI Thru Shortcut to MT Router Open Used Devices This command tells Bome s MIDI Translator to attempt to open the MIDI devices used in the project for exclusive access Rescan MIDI Devices Rescan your system for new changed MIDI devices use if you plug in a new MIDI device while Bome s MIDI Translator is running 5 Presets Shows the current Activated Deactivated state of the presets available in your Project and allows you to selectively enable or disable them Show Minimize Minimizes or restores the main program interface System Tray Icon Incoming Event Translator Outgoing Action Detected Action Executed MIDI Triggered MIDI Keyboard Keyboard Preset Change Preset Change Timer Timer Special Wm_message Execute File Special system tray icon status
54. rtual MIDI ports 1 port 2 ports 3 ports 4 ports O 5 ports MIDI router MIDI THRU c 2010 by Bome Software Page 44 57 Bome s Midi Translator Manual 7 Settings gt VIRTUAL PORTS Starting with version 1 7 Bome s MIDI Translator now includes built in virtual MIDI port drivers that enable the end user to link up MIDI controllers and applications seamlessly without using any 3rd party software Up to five sets of virtual MIDI ports may be installed at any one time allowing expanded control and flexibilty of your MIDI routing Simply choose how many pairs of virtual MIDI ports you require in your processing 1 virtual MIDI port 1 MIDI IN 1 MIDI OUT select Apply and follow the on screen hardware installation instructions similar to the product installation covered in the Quickstart guide Settings Bome s Midi Translator Pro an Virtual MIDI Ports Appearance i Here you can create virtual MIDI ports that you can use to send MIDI messages directly to other MIDI To applications and receive MIDI messages from other applications Select the number of virtual MIDI ports you MIDI Ports need MIDI Router 2 F use virtual MIDI ports Number of virtual MIDI ports 1 port O 2 ports O 3 ports O 4 ports 5 ports virtual MIDI ports gt AUTHOR INFO The Author Info screen lets you attach infor
55. s wm_ messages The breadth of wm_ messages is beyond the scope of this manual Please consult your program or systems programming manual for a list of appropriate wm_ messages Edit Translator Entry New Translator Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Outgoing Action type atd Messages Target Window Message ID Parameters Match by class Numerical 0 wParam D Match by title By registering the following string LParam 0 Equal Substring Beginning End using Registerwindawshlessage Incoming MIDI translator outgoing wm_messages Execute File The Execute File outgoing action type lets you define an executeable file with parameters to run as a resultant outgoing action Enter the executable file name with path in the File Name text box along with any parameters you would like to pass to it in the Parameters text box usually surrounded by quotation marks You can use the Test button to test execute your program after entering in the required data Edit Translator Entry Browser Preview Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Qutgoing Action type Execute File a Start a program or open a document Examples for embedding variable pp with value 107 Filename C AWINDOWSSANOTEPAD EXE ha aha sio7 Z default decimal fd pph LOT decimal hed pp LAF
56. tart gt ADD TRANSLATOR You now should have the MIDI interface settings properly configured Test that they re working correctly by moving a controller on your MIDI device and checking to see if the corresponding light illuminates on the status bar Now you may begin adding translators Click the Add Translator button on the toolbar to add a new blank translator Name your translator something and then press the Enter key You can now begin working with the translator Double click the translator object to enter the Translator Edit screen Bome s Midi Translator Pro Fie Preset Translator MIDI View Seer Translator objects allow you to specifiy incoming and outgoing actions Add a new one by clicking here Move a control on your MIDI device to test communication The status bar lights will illimuniate when they sense any activity MIDI In WIDI Time Code Translating MID Out e Mouse Out e Kkeyln e Timerin Active Sensing FRouterOut e Key Out Timer Out Add a new translator adding translators c 2010 by Bome Software Page 12 57 Bome s Midi Translator Manual 2 Quickstart 2 4 Defining Translators gt INCOMING ACTIONS The Edit Translator screen is where you specify the incoming and outgoing actions that the translator operates with as well as the rules and processes that take place between those actions To start we ll need to specify an incoming action to work with Be sure the Incoming Trigger
57. tart gt TRANSLATOR RULES Next click on the Rules tab to view the rules entries for the translator In this screen you can specify rules that effect the values local to the translator or values stored in global variables Click on the Add Rule button to select the type of rule that you wish to enter After adding the basic rule edit the rule parameters on the right side of the Rules dialog screen Rules can also be entered directly into the text field of the Rules dialog In the example two rules have been entered that will reverse the controller value of a standard MIDI signal The first rule takes the variable value of the incoming MIDI signal for example the turning of a MIDI knob going from O to 127 and multiplies it by 1 The following rule takes the negative value of the incoming signal from the prior rule and adds 127 to it effectively reversing the signal Experiment with adding your own rules and editing the rules parameters Refer to the Translators section of the main manual to find out more about Rules Edit Translator Entry New Translator Options F5 Incoming F6 Rules F7 Outgoing F8 Rules Description gA EERE pp lw PP ieee pp pp 1 First the expression will be evaluated i e the mathematical ppepprle statement will be calculated You can use either fed values or i variables in either of the 2 arguments Then the variable you choose on the left side will be set to the resulting value
58. te all others select deactivate all other presets this is useful from Activate by Mame rey eT ea Sa the always active preset s Deactivate by Name Changing to a preset by number is 0 based i e the first preset 2 Activate by number is selected with number 0 If the number is negative or higher Deactivate by number than the number of presets nothing happens LL j ji ork ke ath e al ONE peset escept tne alna Incoming MIDI translator outgoing preset change Special The Special type outgoing action has only two functions disabling MIDI Translator Processing and enabling MIDI Translator Processing The program as a whole can be bypassed using the Disable Processing outgoing action preventing any of the translators from activating If MIDI Translator is disabled in this way the only way to re enable it is by using the Enable Processing outgoing action defined in a different translator Edit Translator Entry New Translator Options F5 Incoming FE Rules F7 Outgoing F8 Select the Outgoing Action type 5 Special Disable processing Only enable processing will work Enable processing when it was disabled with the action above Incoming MIDI translator outgoing special c 2010 by Bome Software Page 34 57 Bome s Midi Translator Manual 6 Translators E WM_Messages Bomes MIDI Translator is capable of outputting program specifiy window
59. type is set to MIDI message and click the Capture MIDI checkbox Assuming your MIDI settings are correct you should see a list of MIDI messages scroll by the screen as you move a controller or press a key or button on your MIDI device You may notice that a two letter variable has been inserted into your MIDI message This variable is added if the detected MIDI message have altering velocity messages as is the case with most continuous controllers such as sliders potentiometers keyboard keys etc This two letter variable can be used later in the rules section Uncheck the Capture MIDI checkbox once you have detected MIDI data from your selected MIDI controller Edit Translator Entry New Translator Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Incoming Trigger type MIDI message Ias MIDI message trigger CC 16 General 1 LSB pp Default portia BF 30 5p am be Capture MIDI On specific port s BF305 To A two letter variable is BF 30 56 automatically inserted BF 30 55 into the MIDI message Check the Capture MIDI box then move your MIDI control to capture data Outgoing none translator incoming midi capture Note Incoming MIDI messages are received and transmitted in their native hexidecimal values Variables can be assigned to any part of an incoming MIDI message trigger string c 2010 by Bome Software Page 13 57 Bome s Midi Translator Manual 2 Quicks
60. ur translator incoming MIDI action Select the Incoming Trigger type MIDI message MIDI message trigger CC 16 Controller r6 pp O Default port s On specific port s Port Alias Borne s Midi Translator 1 W Automap MIDI ReMOTE ZeRO SL Port 1 ReMOTE ZeR0 SL Port 2 ReMOTE ZeRO SL Port 3 Project IN BF 4C pp Enter the Mi n MIDI message string pp will be set to t Swallow incoming MIDI message and do not route to b Description of the MIDI message optional Local variables are automatically defined in incoming MIDI message actions if the capture midi checkbox is enabled and multiple values of any one control are detected Varibles are covered more completely in the Rules section You can use local variables defined as double letter pairs such as oo and xx in the rules section to modify the incoming values to fit your needs You can also use global variables defined as variables beginning with the letters g or h to pass variables back and forth between translators Bome s MIDI Translator s online help system click Show Help in the bottom left corner of the Translator window includes a useful HEX lt gt DECIMAL translator that will assist in making proper MIDI assignments The following are some sample incoming MIDI string examples along with description For further instructions on Using Variables go to Using Rules and Variables
61. values Two of the rules Jump and Label are used for directing the flow of the rules programming allowing you to make Functions for complex rule sets The other two rules Exit Rules and Execute Exit Rules and Ignore are especially useful for conditionals only enabling the outgoing action when a specific condition is met These seven rules are described in detail below gt Assignment example pp 20 ga oo This rule type allows a straight assignment of a variable s value to a specific number or another variable s value The variable you wish to assign is chosen on the left side of the equation from a drop down box while the source value or variable is selected or entered on the right side Assignment rules are useful for assigning an input local variable to a global variable They can also be used for assigning a specific value to an outgoing action depending on a conditional Expression example pp 30 qq hO 128 oo Expression rules use basic arithmetic plus minus multiply divide or binary operators AND amp OR XOR to enter a value into a variable A variable is selected from a drop down box on the left side of the equation while the two variables and or numbers and operator are selected on the right side of the equation Expression rules are usefule for doing basic operators on incoming values to for example increase them or decrease them parametrically Jump GOTO Redirects the
62. would create a new translator which would output the keyboard emulation for the Up arrow key using your existing Timer translator as the incoming action Timer parameters include repeat occurance once multiple times indefinitely initial delay repetition delay and testing functionality Edit Translator Entry M_Select Loop Bracket Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Outgoing Action type Timer Activate Timer Timer Name Once Initial Delay Test Kill Timer EE e O Mutiple Times 1900 eels w S Incoming Key down 3 translator outgoing timer c 2010 by Bome Software Page 33 57 Bome s Midi Translator Manual 6 Translators E Preset Change Preset change outgoing actions have the capability of managing project presets either by activating certain ones deactivating certain ones or cycling through them all as a set The always active preset is normally excluded from Preset Change outgoing action preset management Edit Translator Entry New Translator Options F5 Incoming F6 Rules F7 Outgoing F8 Select the Outgoing Action type Preset Change s Activate Next Preset This Outgoing Action will activate or deactivate the selected O Activate Previous Preset preset If you want to switch to one preset and deactiva
63. y right click it and select Properties then from the Preset Properties Menu enable the checkbox for Ignore for Next Previous Prest Switching Any presets with this property enabled will be processed by the program no matter what Properties for Preset always active Preset Properties Ignore for Next Previous Preset switching always active If you check this then this presetis not considered for the Next Preset and 4 Previous Preset outgoing actions This can be handy to have a sort of always active preset Default MIDI Ports Enable to make selected preset Always Active always active presets c 2010 by Bome Software Page 21 57 Bome s Midi Translator Manual 5 Presets gt CHANGING PRESETS Presets can be activated and deactivated by clicking the checkbox next to the preset name This is the most direct way of working with presets However mouse and GUI access is at many times at a premium so Bomes MIDI Translator features the capability to switch and work with Presets via the Preset Change outgoing Translator action Presets can be activated via Preset Change action by one of three primary methods Activate Previous Next PresetThis outgoing action will cycle through the available presets in order activating only one at a time Presets must be arranged in the order of which the user desires to cycle them on and off This is normally the preferred way of cyc

Bome`s Midi Translator

Contents

Download Pdf Manuals

Related Search

Related Contents