Home

Lemur Monitors Jazzmutant Lemur User's Manual

1. ccccccsssssseeeeeeceeeessseeeeeeeesaaeesees 9 eZ ODECE ameekoo a 2 atest et ett et 11 MB MUO SS re ce ack Sa ks ad Se NE ak Si le i he he el a cee ak gly at 12 Aas VarapleS aree a ee a A eee 12 kaa a e a E r asa cubaduataackaautasieey 13 1 3 The daily life with your LE MUP cceccccscssseeeeeeseeeeeeeseaeeeseeesseeaseeeesaeeseees 13 Wels Cuading your LC MOU eec siete cteuatiauaioenadbexdenatoutiuncbacteuatoedes 13 I2 INITIO WALI YOUR LC UIs scomtncancccnetencm ae a e 13 t2 Walking yonr LeMIUr croisiere A sine D ieee 13 t322 YOUR Lemurs Hygiene sereine a a aa ae ae Bae ay 13 Chapter 2 installing your EmU erreseina renee KESAEN KEO NE ERENER KOS ISES 15 2 1 Software INS ta UlaUlOIkcscssnadtecndes cocecaadtoandse coceancdceaniosacnananaieniadseabepaoncaiaiaaces 15 2 1 1 Mac OS Software Installation nvccitcne aun iti avin 15 2 1 2 Windows XP Software Installation snscacet is etcetera cats 15 2 2 Network configuration direct connection sssssssssssssrrrrrrrrrreeesssserrrrrrrrrne 18 2R WA Gol STEDS Sees cee ee ee Oe ee ee ee oe ee 18 Chapter 3 Working With Your LOMUP ccccccceeecneeeeeeeeeeeeeeeeaeeeceeesaeeeaeeesees 20 Sale TheJazzEditor VVORKSDACS cokceis ick Si ls al Sy a el oe te el ts ole ie leeds Od 20 Selek Tne Too Dar me eee ee ante tee ee ne nee armen tee 21 Sheki MEGUMI Geil G sirean 21 Opiate TCOMMIGUIa MO i lOONS a ran tesossnatntcom iia a a a 21 31 2 FINCH ROLE CUS O
2. 76 Host gt Lemur The Lemur User Manual The x Light and ADSR H variables are received by the Lemur as a list of numbers representing the brightness of each pad ObjectName x lt pad value 1 gt lt pad value 2 gt etc ObjectName light lt pad value 1 gt lt pad value 2 gt etc ObjectName attack lt pad value 1 gt lt pad value 2 gt etc ObjectName decay lt pad value 1 gt lt pad value 2 gt etc ObjectName sustain lt pad value 1 gt lt pad value 2 gt etc ObjectName release lt pad value 1 gt lt pad value 2 gt etc ObjectName hold lt pad value 1 gt lt pad value 2 gt etc 77 Object Reference 4 1 9 RingArea Color Capture Attraction Friction The RingArea tracks your finger inside a circular space It reports the X and Y coordinates of a ball that can be programmed to have a variable degree of attraction toward a central point You can specify the location of the attraction point within the circular space Variables x The horizontal position of the ball y The vertical position of the ball Dimensions Default 128 x 128 pixels Minimum 128 x 128 pixels General Properties Name The name of the RingArea Object that s also used as Its address Label If checked the Object s name is displayed above the circular Space Drag the color bar to change the background color of the circular space The ball and attraction point are lighter variants of this color Behavior P
3. MIDI Yoke NT 2 AMIDI Yoke NT 1 gt MIDI Yoke NT 4 MIDI Yoke NT 3 gt Here we have set up two MIDI Targets via the MIDI Yoke virtual MIDI driver in Windows XP Again we will take Ableton Live as an example for the Target side If you want to route MIDI data from the Lemur to a Live track choose the appropriate virtual MIDI port from the MIDI input menu in Live MIDI From MIDI Yoke Nv SR Oerit tialre OFF A 32 The Lemur User Manual 3 2 3 Creating an interface Now that the Lemur and JazzEditor are connected together let s create our very first interface To do so just click on the New Interface button located below the project browser Create Interface MyfirstInterFacel This opens a small dialog asking for the name of the new Interface You can type in any name you like Click OK and your new Interface is created Both the Editing Window and the Lemur screen suddenly turn black There is nothing to worry about we just created a blank interface The yellow sit lemur you were familiar with is kept in a safety place you will see it again next time you power on the device or you create a new project You will also notice that the new interface appears on the project browser as shown below Project Browser F MyInterFace E gt Global gt Internal 3 2 4 Creating Objects Although empty screens might be of a great interest from an aesthetical point of view they happen to be ra
4. This means that the Atk Variable will use the value of the first slider with the index of 0 of the MultiSlider we just created Create similar Expressions for Dec decay which will use Env x 1 5 0 Sus sustain which will use Env x 2 and Rel release which will 06 The Lemur User Manual use Env x 3 5 0 Note that we do not scale the value for Sustain since this is just a value between 0 and 1 When you re done your Project Browser should look like this FS 1 Demo g v Container g v Envy em G NV Friction G V Multiball g v Switches g v Trig F 2 v Atk Env x 0 5 0 3 v Dec Env x 1 5 0 v 2 v Sus Env x 2 The final step is to enter these Variable names in the Behavior Properties of the Trig Object Enter Atk for Attack Dec for Decay Sus for Sustain and Rel for Release as shown below As the Variables are local to the Trig Object you don t have to write out the complete addresses which would be Trig Atk Trig Dec etc Now you can test your envelope by hitting the Pads Object You don t even need an attached Synthesizer to see what s going on Dial in the envelope values via the MultiSlider and you will see how the changes of the sliders affect the brightness envelope of the pad 3 4 4 Using Custom MIDI Messages Custom MIDI messages provide simple means to generate very complex MIDI data by entering Expressions for all the parameters of the chosen MIDI message With n
5. 5 1 8 1 Arithmetic abs x absolute value abs 2 2 ceil x rounded value to higher integer ceil 1 2 2 ceil 1 8 2 floor x rounded value to the lower integer floor 1 2 1 floor 1 8 1 max a b max ofa and b 89 Parser Reference max 0 1 0 8 0 8 min a b min ofa and b min 0 1 0 8 0 1 powla b a at the power of b pow 2 4 16 round a rounded value to the closest integer round 1 2 1 round 1 8 2 sign a 1 if a lt 0 1 if a gt 0 sign 12 1 sign 0 1 sign 12 1 sqrt a square root ofa sqrt 64 8 operators a a b a b a b a b a b a b note a b powla b 5 1 8 2 Logic When using logic and conditions in the parser not 0 is true and 0 is false la nota 1 when a 0 0 when a 0 al b 1 if al b i e a 2 b 4 0 if a b a amp amp b logical OR 1 amp amp 1 1 90 The Lemur User Manual 1 amp amp 0 0 a lt b 1ifa lt b 0 otherwise a gt b 1 if a gt b 0 otherwise b 1 if a b 0 otherwise a gt b 1 if a gt b 0 otherwise a lt b 1 if a lt b 0 otherwise a llb logical OR 1 0 1 1111 1 a b c This one is a conditional statement It translates as if a is true then b else c You can put anything Ina b and c Example Creating an Expression e in a MultiBall and setting its value to Pad x x y will mean that if Pad x 0 i e Pad is pressed e x if Pad x 0 i e Pad is not pressed e y You could fo
6. In short the Lemur requires that you own at least one computer running at least one compatible application in order to work In case you dont the Lemur is ultimately worthless e How to use this manual This manual aims at leading you through the process of getting to grip with the Lemur and providing you with any technical information you might need to integrate it smoothly into your workflow This manual is split into four main parts The first part gives a brief overview describing the major features and concepts of your new controller and its software e The second parts deals with all things Installation andsetup The third part holds the main information needed to work with the Lemur and to create your own interface layouts with the JazzEditor software You ll find an overview of all features including a reference for the available Interface Objects and the Parser In the last part you find several appendices covering things like the keyboard shortcuts of the JazzEditor upgrade procedures troubleshooting tips and documentation of special network configurations Considering the great variety of applications that can be controlled by the Lemur it would be nearly impossible to exhaustively detail here all the interfacing possibilities you get from this product Therefore instead of providing step by step tutorials for every single piece of software you might use this manual focuses on the general features and concepts on
7. Sometimes it s a good idea to display the name of your Objects on the Interface Click into the Name field of the MultiBall s General Properties and change it Then check the label checkbox 36 The Lemur User Manual 3 2 7 Basic Interface Work 3 2 7 1 Copy Paste amp Co Now we want two Faders We can do this with a simple copy and paste Cue Paste Copy Delete Cuk Import Delete Export Import Right click Command click for Mac on the Fader and choose Copy from the context menu Then right click on the background of the Edit Area and choose Paste from the menu Those commands are also available on the Toolbar The Fader is duplicated Grab it with your mouse and position it to the right of the first Fader Have a look at the General Properties of your Faders The JazzEditor automatically named the new Fader MyFader2 to avoida name conflict This is important as the names are also used as addresses of the Objects for OSC mapping and variable accessing As a consequence there cannot be any identical names in any Lemur Project except by protecting objects inside containers which we ll cover later in this manual Of course you can also change the names by entering one of your choice into the name field of the Properties 3 2 7 2 Multi selection and Grouping 37 Working with your Lemur We now want to change the colour of the two Faders As we already Saw we could do it by changing every Fa
8. Variables are the mathematical basis of the Object s output Any Object has its own set of Variables that change when you touch it with your fingers Most object properties are also variables They can be changed by external software or by the status of other Lemur Objects dwelling in the Project Those variables are called built in Variables because you always find them with the respective Object You can also create your own uSer defined Variables that you can fill with your own Expressions Variables can be Local living in a specific Object and accessed from the outside through its address You can also define them globally enabling multiple Objects to use their values directly Variables can be Multi dimensional too A Fader for example has only one Variable defining its output with a single number A MultiBall Object has three Variables for the X Y position and the lightness of the balls The MultiBall Variables are Vectors with as many components as there are balls defined for the Object In combination with the built in Functions and Operators and the user definable Expressions the Variables become a powerful tool for refining Object behaviour scaling and shaping responses and setting up interactions between Objects Please refer to the section about Interface building and the respective reference chapters for more information The global Time Variable deserves a special mention It presents the time in milliseconds sinc
9. bar x Add all elements of two vectors The size of the result is the smaller of the two input vectors Returns 0 45 0 8 moo x 0 The first index 0 element of moo x returns 0 2 bar x 1 The second element of bar x return 0 5 moo x 0 5 Interpolated value between bar x 0 and bar x 1 returns 0 3 moo x bar x Concatenates moo x and bar x returns 0 2 0 3 0 6 0 25 0 5 moo x 0 bar x 1 5 Creates a new vector consisting of the first element of moo x and the average of the second and third elements of bar x returns 0 2 0 625 Please have a look at the Parser Reference for a complete overview of the possibilities 62 The Lemur User Manual Chapter 4 OBJECT REFERENCE The Lemur contains eleven Objects and the utility Object Container you can use to build interfaces This section explains the features options and OSC message format of each Object The Object names appear in the picker window you see when clicking the Object button at the bottom of the JazzEditor window Make sure to periodically check the JazzMutant website for updates as the number of available Objects will grow in the future 4 1 1 Guide to Object Reference Pages Variables Lists the built in Variable names of the Object and what they represent All built in Variables range from 0 1 unless otherwise noted Dimensions Lists the default and minimum dimensions height and width of the Object in pixels General Properties Describes the properties
10. The Control Change data is used to produce pseudo continuous data ranging from 0 to 127 BO Control Change D o o EC aD oo ir EED i controller Dial in the MIDI controller number If the value is a vector the second field will be extrapolated automatically You can always override this setting by putting in your own value Possible values range from 0 to 127 value The Variable chosen from the Variable menu that is converted to the controller values is shown here Scale Type in the desired target scaling for the MIDI messages Possible values range from 0 to 127 Channel Dial in the MIDI channel If the value is a vector the second field will be extrapolated automatically Possible values range from 0 to 16 6 1 1 5 C0 Program Change Used to change the patch number of synthesizers 77 MIDI Message Reference CO Program Change D EC aD CE preset The variable chosen from the Variable menu that is converted to program change values is shown here Scale Type in the desired target scaling for the MIDI messages Possible values range from 0 to 127 Channel Dial in the MIDI channel If the value is a vector the second field will be extrapolated automatically Possible values range from 0 to 16 6 1 1 6 DO Channel Pressure Another continuous controller used on a per MIDI channel basis DO Channel Pressure D EC a CH pressure The Variable chosen from the Variable menu that is converted
11. e Appearance Desktop amp Expose international Security Screen Saver Hardware A a gt OG E yV w 4a CDs amp OVDs Displays Energy Keyboard amp Print amp Fax Saver Mouse Internet amp Network Mac Network QuickTime System Accounts Classic Date amp Time prener Speech Startup Disk praag 900 Network ah mae Show All Displays Sound Network Startup Disk Location Automatic a Show Built in Ethernet ey PPPoE AppleTalk Proxies Ethernet Configure IPv4 Using DHCP ey IP Address 10 0 0 2 Subnet Mask 255 255 255 0 DHCP Client ID if required Router DNS Servers Optional Search Domains Optional IPv6 Address Configure IPv6 Fi Click the lock to prevent further changes Apply Now e Change the Show pop up option to Built in Ethernet 107 Appendices e Under Location choose Automatic or give this connection a name e Under Show Select Built in Ethernet e Change to the TCP IP tab e SetConfigure IPv4toUsing DHCP e Click the Apply Now button and quit the System Preferences application 7 1 6 Windows XP Network Setup e Onthe Desktop click right onthe My Network Places icon and select Properties My Computer js aa My Network Places Open Explore Search For Computers Map Network Drive Disconnect Network Drive Create Shortcut Delete Rename Properties e Select yourLAN connection and double click on it 108 The Lemur Use
12. 3 Upgrade your Lemur The Lemur is fully reprogrammabDle by upgrading its firmware You will always find the most recent upgrade on our Website An upgrade can contain bug corrections or new features An upgrade is presented as a bin file Lemur bin To upgrade your Lemur be sure that your network configuration is correct If you need more information about network configuration please read the Appendix about network configuration To upgrade your Lemur you need to format the Lemur s flash memory LEMUR UPGRADE PROCESS Upgrade your Lemur with the latest Lemur bin file amp Lemur Settings Alt 5 e Launch the JazzEditor application e Connect tothe Lemur e Click the Settings button on the upper right corner of the JazzEditor e You are now presented with the Settings panel Click onthe Lemur tab Settings Lemur OS MIOT 192 168 1 4 192 168 1 6 v1 5 0 re e Click on the Upgrade Firmware button a dialog box pops up for you to select the Lemur bin file you want to upload to the Lemur e When the Upload is complete the Lemur is programming its new firmware 113 Appendices e When the process is complete the Lemur reboots with the new firmware If you run into any kind of problem during the procedure start all over again 7 3 1 Lemur hardware settings Network Settings The leftmost button on your Lemur opens the Hardware Settings Choose between Network Settings discussed in Chap
13. Goaelat e a 37 Gl da HOD Ab ASLO Ge Oiga a a a 37 IA hae SCE OU DING swash sitesesesaciaoe E tae 37 3 2 8 Configuring ODIECt SsDENiAVIOUN sc focnimcsanianddorienaeriuitacatenanmiagaaantayete 39 329 Usmg Container Serie i te ted dipal atc co a Syren 42 3 2 10 Import and Export of Modules icici ice nciecitce Mieildehidieds 43 Bde WISE VOUT LCI ACC seisus a E 44 Gronks PNESCM AMO CC nisema naa a E A ented 44 3 3 2 Setting up OSC Wie iO DINOS weuseshet iss Gessuee de saa benteees Se ioe dapdunns de icenaGensness 45 3 3 3 Setting Up MIDI MESSAGES ics ccssisictasts vunessvesannsinetenetantnocereaevonedeteeenesens 46 Jgls USING IS MIDI AWM OW saseces aceteresssttuseuasadaveapeetcamtninadaid toeamiadetanee 46 B62 OM PLE MID IIMA BIN GO areire a 47 3 3 3 3 Multiple Controller Mappings scciic sce eects iethcckew ele 47 3 3 3 4 Mapping MIDI Note Messages ccceccceeececeeeeeeeeeeeeeeeeeeeeeees 48 3 3 3 5 Using the Midi Mapping WINdOW sssssssssssessssssnnnrnrrrrrrrreeeessenenn 49 ore Agger ModE S a a Pre rcrey weitere 50 34 Adyanced TCOUUN CS urugiari Ani Eiei na 51 3 4 1 Control your Objects with your ObjectS sssssssnrrrrressrrrrrereessnrnr 51 3 4 2 Making your own Vala DLC sicsuastacnsamntesuianactedsduaaivesebuamenrtoutiueeertauntonar 52 34 3 USING Vector VatiaDles sraseinp eea a tetenonlemat vial Sodhemiagunuesh 90 3 4 4 Using Custom MIDI Messages oii isiiariviiWcevimatinpnidl anus einnwalecnaut
14. Now switch to the Properties and set the value field to cubed x 10 You are now using the Function we just created to raise the x value which is multiplied by 10 beforehand to the power of three The variable argument of the Function is replaced by the Expression X 10 Move the Fader and you will see that it displays an exponential range from 0 to 1000 61 Working with your Lemur 3 4 7 Vector Datacrunching Avector also known as an array or list is a variable that holds more than one element number The Lemur expression syntax allows operations on vectors and individual access to their elements You can access the data In certain Lemur Objects MultiSlider MultiBall Pads Switches as vectors Typically each sub object is an element of a vector For example the x coordinates of the balls in a Multiball object are accessed as myball x 0 myball x 1 etc Let s look at some of the operations you can perform on vectors Assume we have a MultiSlider object called moo and a MultiBall object called bar Below we have listed some expressions involving vectors and the results they would produce Assume moo x contains 0 2 0 3 0 6 and bar x contains 0 25 0 5 moo x 3 Multiply all elements of moo x by 3 returns 0 6 0 9 1 8 moo x 2 Add 2 to all elements of moo x returns 2 2 2 3 2 6 moo x gt 0 5 Return a vector consisting of 1 or 0 depending on whether moo x is greater than 0 5 returns 0 0 1 moo x
15. Returns the size of an vector lor 1 if applied on a singleton 93 Parser Reference stretch a size Stretches a value or a range and returns a vector sumofla 94 Explanation If a is a single value lor a vector with a single item the function returns a vector with size items containing that value stretch 0 12 0 0 0 0 0 0 0 0 0 0 0 0 After that you could do set stretch 0 12 1 time 12 This returns 1 0 0 0 0 0 0 0 0 0 0 0 when time lt 1 0 1 0 0 0 0 0 0 0 0 0 0 when time lt 2 0 0 1 0 0 0 0 0 0 0 0 0 when time lt 3 etc If a is a vector with more than one value the function stretches the range over size items stretch 1 4 4 1 2 3 4 stretch 0 10 11 0 1 2 3 4 5 6 7 8 9 10 11 Sums all the items of an array The Lemur User Manual Chapter 6 MIDI MESSAGE REFERENCE Depending on the Message type you choose from the Message menu on the MIDI panel you get a different set of parameters 6 1 1 The MIDI Messages The descriptions given below are the standard definitions as given by the MIDI specifications Of course it is up to you to use the various messages to your liking In a world of flexible software the MIDI messages tend to lose their original meanings In modular software like Reaktor or Max MSP you can use any MIDI message to trigger or change anything you want We only give the standard MIDI panels as examples here Please note that with Custom MIDI message
16. area About the Pads ADSR H The four behavior properties of a Pads Object relate to its brightness or x variable envelope You specify time values for the Attack Decay and Release in seconds as well as a Sustain level between 0 and 1 Unlike a keyboard ADSR the Pads ADSR goes through its entire cycle when you touch the surface to trigger it If your finger is still down on a pad when the envelope reaches the end of its Decay portion the x value brightness will remain at the sustain level until you lift your finger off the surface At the release point lor before if your finger has already left the surface the Release portion of the envelope will be triggered and the x variable will return to 0 To implement an immediate response trigger set the Attack Decay and Release to 0 and the Sustain to 1 Attack Decay Sustain Release Hold Lemur gt Host The Attack value specifies the number of seconds over which the x variable pad brightness increases from its initial value of 0 to a maximum of 1 after you touch the screen As an example if the Attack value is 0 the pad will be at full brightness the moment you touch the screen An attack value of 10 means the pad will take 10 seconds to reach the full value The Decay value specifies the number of seconds over which the x variable pad brightness will decrease after the initial Attack portion of the envelope has completed During the Decay portion of the enve
17. at 57 J4 BIPGICECEION al CONTO carieni a e a 59 3 4 6 Defining and Using FunctionS ssssseseessssesssssesrrrrrrrrrrrtrreeesserrrrrnrrenn 60 SG Nector Datacr nchiN Oerset aaa 62 Chapter 4 Object Reference 63 4 1 1 Guide to Object Reference Pages cccceceeeeeeceeeeeeeaeeeeeeeeeeeeeeeeeeeeees 63 A P AM EE o eg Re ON ER ORR ae ee Oe Le eee RAT ee ee eee 64 Aas WROD eenn e Usaduavedasuaautiedonsdeie ended eataaiaadess 66 Des Meg ME CUS ah Sete hee et cl Dect Seg at cl tele bik Dace lt el alt lc al Dye ata 68 MeO MOTOT aao et ec aE tena eel Cena N as 69 Akos MultiB ea oi csssitens earth ct ceil aaa aa iota ena eee 70 LEN 7 IVES TELCO T senicstinsonsiietoaau siapelsasancpnoasse sia nonaiiotna aed eae neha iobetaneeanbaguaonpaaesaaseonek 73 Ro AE Pad Ls tree eee Te ere erent ener enter Pre rtcey cer er ere re eet or en crey cee cert tee ere ntey tr errr etree 79 l ROAT liane scales a tei aaalaae a 78 ANI SIGMA SCOP ncnden csanianidacainn cana a acinaidncaiepsan ierinenadenete 80 kkl SuraceLCD nee are tert fer eee een a ree er ee ee ee 82 ALIZ SWEN Sia es So Nak ee E a ae Sleek nae Saal eco 82 Chapter 5 Parser Reference 85 SMe Vauc te OLOLIFING aanren a a i iamisacenaniaadeenmieheiocaiaanteaceds 85 9 1 2 Vectors Singletons and Operators cccccccceeeeeeeeeeeeeeeeeeeaeeeeeeeeeeees 85 SLS MPIC TV ONS aena e as Sp ch ld Sa gk Saale gs Ce ake ee 86 eles ERIS SSO Sian Seca onre a ae cree a toe S
18. can place it on top of Objects and still interact with them Variables None Dimensions Default 100 x 100 pixels Minimum 32 x 32 pixels General Properties Name The name of the SignalScope Object that s also used as its address Mode XY Color Time base Label If checked the Object s name is displayed in the scope area If checked the signal scope shows both an X and Y value plotted against each other If unchecked the X value Is time shifting Y values to the left Drag the bar to change the color of the scope and its frame Behavior Properties If Mode XY is enabled X can be the value of a variable or a constant otherwise it is assigned to time against which the Y value will be plotted A variable or constant expression that will be periodically evaluated and plotted against X For example to plot the x variable of a Fader Object called chan enter chan1 x in the text field Corresponds to the time in seconds displayed on the scope As the Time base increases individual elements of the graph will decrease in width as more of the past is shown The picture below shows a SignalScope displaying a tenth of a second of history It is set to time base of 0 1 80 The Lemur User Manual to 2 0 Lemur gt Host none Host gt Lemur The x yand timebase Variebls can be received via OSC ObjectName x lt value gt ObjectName y lt value gt ObjectName timebase lt value gt 81 O
19. devices including the Lemur to use the DHCP mode 7 1 3 2 Network without DHCP Server If you have multiple devices connected through a hub or switch you may have to configure them individually with a unique static IP sharing the same network mask Use IPs like 192 168 0 X or 10 0 0 X Mask 255 209 0 0 7 1 4 Lemur Network Setup You open the Network Settings via the Settings button which is the left most hardware button on top of the Lemur DHCP IP Configuration Select Automatic using DHCP If a DHCP server is available the Lemur will obtain a DHCP IP address automatically If there is no DHCP server available the Lemur will switch to Static IP configuration Settings Network Settings Static IP Configuration 103 Appendices e Select Static IP e Enter assigned static IP address into the IP field e Enter NetMask 255 255 255 0 Settings Network Settings 169 254 0 254 7 1 5 MacOS Network Setup Static IP Configuration using Mac OS X e GototheApple menu and select System Preferences File Edit View Go About This Mac Software Update Mac OS X Software Location Recent Items Force Quit Finder e UnderlInternet and Network select Network 104 The Lemur User Manual 000 System Preferences lt E 9 O Show All Displays Sound Network Startup Disk E m Df Appearance Desktop amp Expose international Security Screen Saver Hardware C
20. individual light and value parameters Remember that those properties can be set to vectors when dealing with several columns or rows of Leds The Bar Graph mode makes a matrix or vector of Leds act as your typical bar graph the Leds work together to graphically display the current value The Leds are transparent to touch but not transparent in terms of display This means you can implement switch or pad functionality by placing a hidden Switches or Pads Object underneath the Leds Variables value In Bargraph mode this value represents the percentage of the Leds being switched on If Bargraph mode is off only 1 and 0 are accepted as values If you send a single value 0 1 it will switch all Leds to their on or off colors If you have multiple rows columns you can use a vector to individually address the Leds General Properties Name The name of the Leds Object that s also used as its address Leds Columns Rows Label If checked the Object s name is displayed above all of the The number of columns of Leds contained in the Object Only 16 columns of Leds can be set The number of rows of Leds contained in the Object Only 16 rows of Leds can be set Color Off Drag the colour bar to change the colour for the off state of the Leds ColorOn Drag the colour bar to change the colour for the on state of the Leds Light none Host gt Lemur Can be a constant a vector or any mathematical expression a
21. it 12 columns and one row 48 The Lemur User Manual Create a new MIDI assignment Choose the X Variable and Note On as the MIDI message type Set the first pitch field to 60 and the second will automatically be expanded to 71 reflecting your 12 Pads Your MIDI assignment should resemble the one shown below Midi 0 30 Note Onn CE Sat CD CE Click the MIDI Map icon to look at the MIDI Mapping window You see the 12 Pads nicely laid out working as a MIDI keyboard Pads x 90 1 Note On 60 Midi 0 Pads x 90 1 Note On 61 Midi 0 Pads x 90 1 Note On 62 x Midi 0 Pads x 90 1 Note On 63 w Midi 0 Pads x 90 1 Note On 64 x Midi 0 Pads x 90 1 Note On 65 X Midi 0 Pads x 90 1 Note On 66 x Midi 0 Pads x 90 1 Note On 67 7 Midi 0 Pads x 90 1 Note On 68 x Midi 0 Pads x 90 1 Note On 69 x Midi 0 Pads x 90 1 Note On 70 x Midi 0 Pads x 90 1 Note On Zi x Midi 0 You can use more than 12 pads to create a bigger keyboard if you wish 3 3 3 5 Using the Midi Mapping window The table consists of seven columns The Name column shows the name of the Variables used The Msg Message column displays the numbers of the different MIDI messages used for the individual mappings In the Ch mappings Channel column you find the associated MIDI channel for the individual The Message Name column writes out the full name of the different MIDI messages The two Parameter columns show the MIDI para
22. new value more quickly As the Attraction value is lowered the Knob takes longer to arrive at the finger position When Attraction is set to 0 the Knob cannot be moved by your finger If Physics is set to Mass Spring Attraction and Friction are both active Attraction works as described above under Interpolation Friction ranges between 0 and 1 Lower values of friction mean that the Knob will tend to keep moving With a value of 0 the Knob will essentially never stop moving Values of 1 for Attraction and Friction are essentially the same as if Physics is set to Interpolate See the discussion of Interpolation and Mass Spring modes under Physics above Friction See the discussion of Mass Spring mode under Physics above Lemur gt Host Host gt Lemur OSC Data The x variable is transmitted from the Lemur followed by one value representing the Knobs position ObjectName x lt value gt The x Attraction and Friction and value Variables can be received by the Lemur Please note that if you have an expression working in the value field the Lemur will always use the value of the expression and not the data received via OSC ObjectName x lt value gt ObjectName attraction lt value gt 67 4 1 4 Object Reference ObjectName friction lt value gt ObjectName value lt value gt Leds The Leds Object is a two dimensional array of Leds It can be a single led or a whole matrix of them all with their
23. of floating point digits that appear A precision of 0 displays only the integer part of numbers the monitor receives Color Drag the color bar to change the color of the label text The numerical value display is always white Behavior Properties None OSC Data Lemur gt Host The value variable is transmitted when the Monitor s value changes ObjectName value lt value gt Host gt Lemur The value Variable can be received by the Lemur ObjectName value lt value gt 69 Object Reference 4 1 6 MultiBall The MultiBall Object assigns each finger to track one of a number of balls up to 10 in a rectangular space Balls can either always be visible or only appear when you touch the space the latter is called ephemeral mode The brightness of the balls is sent as the z variable in the Object Variables X Alist of the horizontal positions of all the balls y Alst of the vertical positions of all the balls Z A list of the brightness values of all the balls Brightness values change only when the MultiBall Object is in ephemeral mode Dimensions Default 128 x 128 pixels Minimum 128 x 128 pixels General Properties Name The name of the MultiBall Object that s also used as its address Label If checked the Object s name is displayed above the balls Numbers If checked a running number is displayed inside of each ball see picture below Balls Number of balls 1 to 10 Color Drag the color bar to change t
24. on singletons can adapt to vectors as well For instance round 1 2 1 round 1 2 3 8 0 1 1 4 0 5 1 4 Expressions Using all those bricks you can create named Expressions Variables or use Expressions as Objects parameters attraction etc When entering a vector as a parameter for a multi state Object Switches MultiBall Leds Pads the parser will do its best to map each item in the vector to each sub object For instance entering 0 1 0 5 1 0 as the attraction for a Multiball that has 3 balls sets attraction for Ball 0 0 1 attraction for Ball 1 0 5 attraction for Ball 2 1 0 When mapping a vector Variable to MIDI the x parameter of a Multiball with 10 balls or a user created Expression that evaluates as a vector the parser will try to stretch the mapping to all the items For example A custom Expression called vec with value set to Ball x Ball y Ball x Ball y If you know go into the MIDI panel and want to map the Expression to a MIDI controller you just have to put controller 10 into the first controller field and the second field will automatically be set to 11 86 The Lemur User Manual 5 1 5 Accessing Variables An Expression that is local to an Object can access the x parameter of the Object just by its name x scaled x x If the Expression is created outside of the Object local to another Object or in the global folder or at root level of a Container
25. shown in the General tab of the Properties inspector Properties marked with a checkbox XJ are on off properties typically check boxes Otherwise the properties can accept constants Variables or Expressions Behavior Properties Documents the behavior properties of the Object generally these are related to physical modelling features Properties marked with a checkbox XJ are on off properties typically checkboxes Otherwise the properties can accept constants Variables or Expressions OSC Data Describes the format of the data the object receives and transmits via OSC MIDI Data Shows the format of the data the object receives and transmits via MIDI 63 Object Reference 4 1 2 Fader Value Unit Precision Colour The Fader tracks your finger with a virtual cap and transmits one value corresponding to the position of the cap on the fader The Fader can be oriented vertically and horizontally Just grab a corner and drag it to change orientation Variables The location of the cap When the cap Is at the top or right most position of the fader depending on orientation the value is 1 by default When it is at the bottom or at the left most position respectively the value is 0 Dimensions Default 60 pixels wide by 200 pixels high Minimum 53 pixels wide by 200 pixels high General Properties Name The name of the Fader that s also used as its address Label If checked the Object s name is displa
26. the Variable s script field Now switch to the MIDI panel choose the new Variable and switch the Trigger Mode menu to For Scale you fillin O and 64 That s it 87 Parser Reference chance oD G0 Control Change 7 hangero ts O 6 64 n ae When the Pad is on the Variable will have the value 64 when the Pad is off it will be 0 it always changes The Trigger Mode only allows transmission for a change from 0 to positive so only the value 64 will get transmitted via MIDI 5 1 7 Lemur Time If you look at the Internal folder in the Project Browser you will see a pre defined Variable called time amp Internal fH Arithmetic an Logic ES others The time Variable is a millisecond value you can use for creating time varying behaviour in your Lemur It represents the number of milliseconds since your Lemur was turned on and it resets to 0 every hour The time value is intended to be manipulated by mathematical Operators particularly by multiplication division and by the modulo operator By multiplying time by a value greater than 1 you produce a sequence of values that increase faster than clock time By multiplying time by a value less than 1 you will produce a sequence of values that increase more slowly than clock time You can use the modulo Operator to create a repeating sequence of values that resembles a sawtooth wave For example time 1 produces a ramp from 0 to 999 that occurs ove
27. the connected Lemurs should be listed with their IP addresses and port numbers You can select a Lemur on the list and click Connect to establish a connection A double click on the list entry does the same trick If you just connected your Lemur or had it switched on shortly before wait a few seconds for the list to update Note Be careful If you have a Project residing on your Lemur and connect to it with a different Project open in the JazzEditor the one on the Lemur will be overwritten A connection always automatically transfers the currently opened Project to the Lemur The IP and Port fields below the list allow manual entry and remember the last setting of the Lemur connection They also can be handy for connecting through a proxy 28 The Lemur User Manual The current connection status can be seen from the displayed Connection icon A Play button means there is no Lemur currently connected If you connect to a Lemur the Stop button appears and a click leads to a disconnection of the Lemur 3 2 2 The Settings window 3 2 2 1 Editor setting The first panel of the Setting Windows deals with JazzEditor settings you only have a checkbox for the display of mouse over hints When active the description of the interface item alongside with the eventual keyboard shortcut is displayed when you hover with your mouse pointer over the various interface elements Settings Editor Lemur OS MIOT 192 168 1 1 D 192 1
28. the fader s 0 1 floating point values mapped to 0 127 e Verify the MIDI assignment by clicking on the MIDI Map icon at the top of the JazzEditor window al The MIDI Mapping window will appear It displays the assignment we just configured Midi Mapping Fader x BO 1 Control Change 5 Midi 0 3 3 3 3 Multiple Controller Mappings In the next example we ll use a MultiSlider object and automatically assign different control change messages for each slider e Create a MultiSlider object Using the General Properties tab set the number of sliders to 16 47 Working with your Lemur Properties MultiSlider Midi oly G0 Control Change w CECE D CH n On the MIDI panel choose BO Control Change and MIDI 0 as Target for the x Variable Type controller number 10 into the first controller field The second controller field is automatically set to 25 to extrapolate for the 16 sliders Click the MIDI Map icon to open the MIDI Map window Since the MultiSlider has sixteen values instead of just one the JazzEditor automatically assigns each slider to successive MIDI controller values The same thing happens for other multi value Lemur variables such as Multiballs parameters 3 3 3 4 Mapping MIDI Note Messages The following example uses the same automatic mapping feature to create a chromatic one octave MIDI pad on your Lemur that will send MIDI note messages Create a Pads object Give
29. their appearance eg size color brightness and their behaviour ie the way they respond to your fingers Object applications One object can even be used to modify in real time the properties of another object JazzEditor provides a set of handy tools to easily map objects output to the software you wish to control and to create ultimate interactions between different objects s can send and or receive a plurality of Midi or OSC messages from your For more information about the different Interface Objects and how to work with them please have a look at chapter Interface Building and at the Object Reference further down the text 11 Knowing Your Lemur 1 2 3 Modules Additionally you can import pre built parts of projectas Modules A Module is a set of reusable interface elements A module can feature objects containers and even interfaces A library of modules Is provided on the Installation CD and more modules are available from JazzMutant s website You can also create your own user library of reusable items Indeed any part of a Lemur Interface can be exported as a Module for future use in other Projects Due to this feature you never have to develop the same thing twice Just save your building blocks as Modules to produce a growing library of re useable object oriented Interface parts The User Library on the JazzMutant website also is a great resource for stacking up on handy Interface elements 1 2 4 Variables
30. unit thoroughly with a soft dry cloth Never use gasoline thinners alcohol or solvents of any kind Chemicals may cause fading of colors and or deformation of the surface When working with the unit s buttons display or other controls or when using its cords and cables try to be reasonably gentle Rough handling can lead to malfunctions Never strike or apply strong pressure to the display When connecting disconnecting all cables grasp the connector itself Never pull on the cable This way you will avoid causing shorts or damaging the cable s internals Use the Ethernet cable supplied with the unit If using some other cable please make Sure it is of the correct type When you connect the Lemur directly to a computer it has to be a crossover Ethernet cable The JazzMutant Ethernet cable you received with your Lemur is of that type If you connect your Lemur to a hub or switch please use a high quality non crossover Ethernet cable CAT5 or better 14 The Lemur User Manual Chapter 2 INSTALLING YOUR LEMUR 2 1 Software Installation For the Lemur to become functional you have to install the JazzEditor software that enables you to create custom interfaces and that also manages the connection to the Lemur You find the JazzEditor Installer on the provided Installation CD 2 1 1 Mac OS Software Installation Software amp Hardware Requirements Mac e Power G3 or earlier based computer e CD DVD drive to install from th
31. value for ball 1 gt lt value for ball 2 gt etc ObjectName sustain lt value for ball 1 gt lt value for ball 2 gt etc ObjectName release lt value for ball 1 gt lt value for ball 2 gt etc ObjectName hold lt value for ball 1 gt lt value for ball 2 gt etc 4 1 7 MultiSlider The MultiSlider Object tracks movement across an array of sliders You can wipe all the faders to a set value with one horizontal gesture This is pretty hard to do with real or virtual faders Variables x A list of the vertical positions of all the individual sliders Dimensions Default 100 x 100 pixels Minimum 64 pixels wide x 40 pixels high General Properties Name The name of the MultiSlider Object that s also used as its address Label If checked the Object s name is displayed above the sliders in the lower left hand corner 73 Color Light Capture Physics Tension Friction Height Lemur gt Host Host gt Lemur Object Reference Slider Number of sliders 1 to 64 Drag the color bar to change the thematic color of the sliders The foreground uses a gradient based on this color and the background is a darker version of the color Can be a constant a vector or any mathematical expression and controls the luminosity of your Objects 2 means black 2 means white and you get to choose any decimal number in between Behavior Properties If Capture is checked an Object will only r
32. via using the corresponding keyboard shortcut Control Shift S for PC and Command Shift S for Mac The Import Library and Export Selection commands are for import and export of Modules Any imported Module is incorporated into the currently opened Interface at the level of hierarchy you choose and you can select any group of Objects for export as a Module to the file system Please note that you can also import and export Interface elements via contextual menus that can be triggered in many parts on the user interface Use the Copy Cut and Paste commands as you know them from other applications They are also available via contextual menus The last two commands on the left side of the Toolbar are the Undo Redo buttons You can roll back an unlimited number of JazzEditor commands with this system 3 1 1 2 Configuration tools The Toolbar also contains commands for configuring the Lemur To the left you have the Memory Display showing you the percentage of the Lemurs memory that is occupied by your Project This is for reference only The MIDI Mapping button opens a window with all MIDI mappings used in the current Project 21 Working with your Lemur If you activate the Lemur Synchronization button any changes to Objects states on the Lemur will also be reflected in the JazzEditor This can be very handy for saving a Project including the state of all Objects One shot synchronization can be achieved through the F5 short
33. when it comes to building Lemur Interfaces It consists of four major areas e The Toolbar on top of the Workspace provides typical items you might find in an application s File and Edit menus The Editing Area is the place where the actual Interface Objects are placed to design Lemur Interfaces e The Selection specific Panels allow you to edit details and mappings of selected interfaces objects variables etc e The Project Browser provides a hierarchical view of your current project Interfaces Objects and Variables 20 The Lemur User Manual A lot of the commands and functions of the Workspace can also be controlled via keyboard shortcuts The shortcuts are displayed in the Tooltips that pop up when you hover with your mouse pinter above the respective command Please have a look at the corresponding appendix for a complete list 3 1 1 The Toolbar Bee JOC AX O 3 1 1 1 Editing and file i O On top of the JazzEditor you find the elements of the Toolbar To the left you see buttons dealing with Project creation in and output to disk and the undo system The New Project Button creates an empty Project With the Open Project command you are presented with a dialog allowing to open existing Projects from your file system The Save Project button opens a dialog for saving your current Project to the file system Choose an appropriate folder to store the Project Please note that the Save AS command is reachable
34. 5 New Project 27 Non crossover Ethernet cable 6 Note Off 100 Note On 57 101 Object 23 Object Reference 71 Objects 24 Fader 72 Hierarchy 67 71 Interaction 58 Layout 48 Leds 76 Monitor 77 Multiball 78 MultiSlider 81 Overlap 36 Pads 83 Resize 36 RingArea 86 SignalScope 88 Switches 90 Transparency 37 Open Project 27 Open Sound Control 66 Operators 25 92 Operators Reference 95 120 OSC 66 Bi directional 67 Custom Address 32 Port 32 Slashes 67 Use 32 Variables menu 54 OSC address 45 OSC Data Fader 74 Leds 75 76 Monitor 77 Multiball 80 MultiSlider 82 Pads 84 RingArea 87 SignalScope 89 Switches 91 OSC mappings 54 OSC messages 66 OSC panel 54 OSC Panel 39 OSC Targets 25 32 Pads 57 83 Pads ADSR 84 Parameter 28 Parser Reference 92 Paste 27 37 Physics 51 Attraction 51 Friction 51 Tension 52 Physics menu 51 Interpolate 51 Mass Spring 51 None 51 The Lemur User Manual Pitch 66 Pitch Bend 103 Play 30 Polyphonic Aftertouch 101 Port 32 Positional data enabling 50 Power Cable 8 Power Input 9 Power Supply 5 Power Switch 5 Precision 61 Program Change 102 Project 23 hierarchy 49 Transfer to Lemur 43 Project Browser Checkboxes 34 Functions 36 Global Variables 36 Objects 34 Operators 36 Scripts 34 Variables 34 Project Browser 34 Interfaces 34 Project Browser Colors 35 Project transfer 23 Properties 37 45 modifying 51 Precision 61 value 61 Properties pan
35. 6 Create commands 36 Create Expression 64 68 Create Interface 49 Crossover Ethernet cable 6 14 Cursor Mode menu 25 Cursors 24 Custom Address 32 54 Custom MIDI Messages 65 Cut 27 37 Delete 37 DHCP IP Configuration 107 DHCP Server 106 Dimensions Monitor 77 Multiball 78 MultiSlider 81 Appendices Pads 83 RingArea 86 SignalScope 88 Disclosure triangles 34 49 50 Display Hints 30 Edit mode 37 Editing Area 36 Ephemeral 24 54 Ethernet cable 5 Ethernet jack 5 Export 37 Export Selection 27 Expression 60 Expressions 25 93 Fader 46 72 firmware 119 Frame 94 Friction 51 59 Functions 25 68 92 Arguments 68 Arithmetic 95 Logic 96 Name 68 Script 68 Trigonometric 98 Vector 98 Functions Reference 95 Gateway 16 106 General Properties Fader 72 Leds 74 76 Monitor object 77 Multiball 78 MultiSlider 81 Pads 83 RingArea 86 118 RingArea 86 SignalScope object 88 Switches 90 Global 61 68 Group 37 47 Hardware Configuration 5 Hardware Settings 7 Hierarchy 49 67 Hold 53 Import 37 Import Library 27 Interacting Objects 58 Interface 23 42 Name 50 Order 50 Interface building 42 Interface List button 6 Interfaces 23 Interface List 23 Navigation buttons 23 Switch via OSC 23 Internal clock 94 Interpolate 51 IP address 16 IP Address 106 JazzEditor Enabling Position data 50 MIDI Settings 21 Toolbar 27 Workspace 26 JazzEditor Output 21 JazzEditor dmg 9 JazzEditor_setup exe 9 jzlib 23 jzml 23 Key Press
36. 68 1 6 v1 5 0 S lene 3 2 2 2 Lemur Settings On the second panel of the Settings window called Lemur you can choose which of the Local IP addresses of your computer is used by the JazzEditor for connecting to the Lemur The IP of the currently connected Lemur is also displayed The use of the Upgrade Firmware button will be discussed in the Appendices 3 2 2 3 OSC settings 29 Working with your Lemur Settings Editor Lemur Ose MIOT 192 168 1 4 192 168 1 55 192 168 1 4 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Soe aga ag aa a 0 0 0 0 The Open Sound Control protocol specifies the transmission of messages between two devices Rather than attaching specific meanings to these messages as it is done with MIDI Open Sound Control allows you to define your own system of messages With the Lemur for example the names of objects you create and their path in the Project hierarchy constitute their default address for OSC messages The third panel of the Settings window deals with the eight OSC Targets OSC Targets can be software applications on your local computer somewhere on the network or OSC enabled hardware connected to the network They are called Targets because they are what the Lemur targets its messages at Always remember that OSC is bi directional and the OSC Targets can also control your Lemur s Objects Just fill in the IP addresses of the Targets you want to communicate with If i
37. Ds amp DVDs Displays Energy sa Re amp Print amp Fax Saver Internet amp Network e eap Network QuickTime ve H A Accounts Classic Date amp Time tains Speech Startup Disk Universal Access ean Network oO Network Startup Disk m Ae Show All Displays Sound I Location Automatic ww Show Built in Ethernet PPPoE AppleTalk Proxies Ethernet Configure IPv4 Manually B IP Address 10 0 0 2 Subnet Mask 255 255 255 0 Router ONS Servers Search Domains Optional IPv6 Address if Click the lock to prevent further changes Appty Now 105 Appendices e Change the Show pop up option to Built in Ethernet e Under Location choose Automatic or name the new connection e Under Show Select Built in Ethernet e Change to the TCP IP tab e SetConfigure IPv4 to Manually e Enter assigned static P Address e EnterSubnet Mask 255 255 255 0 e Click the Apply Now button and quit the System Preferences application DHCP Configuration using Mac OS X e Goto the Apple menu and select System Preferences Finder File Edit View Go About This Mac Software Update Mac OS X Software System Preferences Dock Location Recent items Force Quit Finder Sleep Restart Shut Down e Under Internet and Network select Network 106 The Lemur User Manual 6900 System Preferences 5 mae Show All Displays Sound Network Startup Disk E m D a
38. W SEM aeea E ARa geeumaeinecbasewusheneenmuseacannceonaes 22 Gila MEME OIG ALO ac cacncsadaantrasiancnancccnatanniee a E 20 31 4 lhe General Properties csciacnsi actin wie nolan ied W notes 25 3 15 The Behavior Properties isrenceccuniean cede Goel dw oe cits eel Sie eed da tt 26 glos TASES OEP ANG oe ane teccssdvte eee antes deco ae eee 26 Fes ey oem MEO dO cra merece te nem De a an te cn nO a nee oe 27 Seos go 3 10 a 92 eit eee ome eet o a AS 27 3 1 9 Workspace Configuration s sssssssssssreressseeesssrrrrnnrrtrtrrttteeresrrrnnnnnttnne 27 92 Mer aco DUING LG seene a casein 28 The Lemur User Manual d2 Connecting YOU lemur UDP scccior sak ocnn ec ue taeda Neate natenentaee 28 322s THESeTUAOS WINGO Weines EE 29 eZee Ns Editor SeN tis ie ed tt a a al Dae Sat 29 C2225 Lemur o NGS unico iarns unis aerate tte en 29 S229 OSC SEHN Soa a eeenees 29 3224 Midi SOU OS enee aan aietnaneaetasaaeneaaeaaaeetece 31 3 amp 2 20 Virtua MIN Ports 0m MaC neroian i i 31 3 2 2 6 Virtual MIDI Ports on Windows XP cccccccssesccsceeseesseseeseeeeestens 32 JA Creating NaN Ile FlaCe s sigairias anrnancatoardam coatiodidbsnian deainadacaieddactiedinonadanete 33 32A Creating ODO CES itis sae adres a aa a 33 De Oe DAVIN SV OUN DO CCU ik ies Sh Sa oh aac rr eek 35 3 2 6 Changing Object appearance cccccccsssseeeeeeeeeeeeeseeeeeeeeeeaesseeeeeeeeseaas 36 LAT Basie MLCTLaCe VOW isi auasescacuniees Outen ie a taal
39. a Meta acta tan a 86 Di leds PACES SING Vat lel DU CS xan itincwashtnesavesy duvancnettetonnsn de eartuslens a aa tenancies 87 Silo MBS MMU IGS Fila ClO CK sins tassel Gens laGatuien tGaniuens tenses saniunie tals ameduenigeus tenes 87 Skk emir TM sete te tuce acre ake eceabsaseene lee ete seeabacce iste eeraee bac anes enueecbecaees tone 88 Sl JIVE NG OGG Xa DUG nccrne a es 88 Deel Le LONE MST OC ica Sala ee Stet a a eed a da 89 9 1 8 Operators and Functions Reference ccccccceeccccssssseeeeeeeeeseaesseeeeeees 89 DeleOelle SARITMIMGUIC fata cae tees eeke E daeies tae E neta itera 89 eL LOGIE jagiaeue ceca cceua aa reatenath meu rma e aan aeuatonat ee apeee neta ere 90 ao feo eso eam OE ahs ae rere Reeea cee emcena ieee ae Coren st erren cere at Cree a erree er eeeeae 91 Doss LOO POM Mc TIC aree N 92 2d es ho VEO E E nsec stent 92 Chapter 6 MIDI Message Reference s 1iccuccasct estes sedecciuatdeieesitauietaatdaseneancaiens lm 95 Gall ANE MIDEMESS SIJES engi a a haaentnn tei aenaheneuens 95 kL SUSEN EO a E T 96 Olek ZOS NOTE ON ee a E coctaceseeandnaces 96 6 1 1 3 A0 Key Pressure Polyphonic Aftertouch cccceccceeesseeeeees 96 ilt BOS Control Change inse a a Seickeesgei Soleo a 97 Olt C0 Programi Change cren a tea taeena ee 97 Okelo DO Channel PreSSuUt E einna A aie iceman 98 Orleans Osiris ei asiialansamasetshaasatsarnstiaisanaansemaasanamaiiaiciuss 98 6 1 1 8 FO System ECU SIVS sosnnncssaanecceedantoncta
40. acs the Container and choose Paste from the menu This puts the two Objects we have cut out Into the Container 42 The Lemur User Manual Now it s time to have a look at how all of this is mirrored in the Project Browser The Container can be opened in the Project Browser by clicking on the disclosure triangle in front of the Container You see that the two Objects in the Container are grouped on a lower level in the Project hierarchy Cp iv MyFader G V mMyFader2 Cp v RatherInteresting p iv ILoveButtons Cp iv SoFunny sotovely Please note that the use of Containers also has implications for the Variable addresses of Objects living inside of the Container Indeed within the Container the local names of both objects are still the same From the outside however there are now known as ARather nteresting LoveButtons and Rather nteresting SoFunny respectively Do you feel a little bit lost Well that s normal at this point but don t worry we will come back to this later 3 2 10 Import and Export of Modules Let s suppose now that you would like to reuse later some portions of the interface in another project For that purpose the JazzEditor provides the quite useful Import Library and Export Selection commands of the Toolbar for creation and integration of Modules Any imported Module is incorporated into the currently opened Interface and you can select any group of Objects for export as a Module to the
41. ad to Sustain x so the Switch gets the ability to freeze the current lightness OSC Data The x y and z variables are transmitted from the Lemur with a list of values representing the positions of each of the balls The number of items in the list of values is equal to the number of balls the Object is using The x variable is 72 Host gt Lemur The Lemur User Manual horizontal position the y variable is vertical position and the z variable is brightness which only changes when using ephemeral mode ObjectName x lt value for ball 1 gt lt value for ball 2 gt etc ObjectName y lt value for ball 1 gt lt value for ball 2 gt etc ObjectName z lt value for ball 1 gt lt value for ball 2 gt etc The x y and z variables can be set by sending the Lemur a list of values representing the positions of each of the balls The number of items in the list of values should be equal to the number of balls the Object is using The x variable is horizontal position the y variable is vertical position and the z variable is brightness which only changes when using ephemeral mode ObjectName x lt value for ball 1 gt lt value for ball 2 gt etc ObjectName y lt value for ball 1 gt lt value for ball 2 gt etc ObjectName z lt value for ball 1 gt lt value for ball 2 gt etc The ADSR H values can also be received by the Lemur ObjectName attack lt value for ball 1 gt lt value for ball 2 gt etc ObjectName decay lt
42. and won t work either Just practice a bit with your Lemur and you will quickly find the right balance that combines precision with tactile feedback The best technique is using the fingertips and not the flat underside It leads to a maximum of precision and ensures good agility for the various multi finger gestures you will develop when working with the Lemur 1 3 2 Living with your Lemur There are a few elementary rules that need respecting carefully if one want to have a pleasant and durable life with one s Lemur 1 3 2 1 Walking your Lemur When transporting the Lemur please ensure it is properly packed to protect it from shock and damage A good idea is using a sturdy laptop case 15 or 17 should fit Place an additional protective layer over the display There are two types of power cables enclosed with your Lemur One is of the European type and one works in the USA If you take your Lemur abroad to other countries please make sure you get the appropriate power cable for the respective country 1 3 2 2 Your Lemur s Hygiene The Lemur is a sturdy creature If you follow some basic guidelines concerning care and feeding it will be your companion for years and years to come For everyday cleaning wipe the unit with a soft dry cloth or one that has been slightly dampened with water To remove stubborn dirt use a cloth with a 13 Knowing Your Lemur mild non abrasive detergent Afterwards be sure to wipe the
43. aves the circular area but as the Object grows larger in size the attraction points can be located outside the circular area when Attractor X and Attractor Y are given very large or very small values Lemur gt Host Host gt Lemur OSC Data The x variable is transmitted from the Lemur followed by one value representing the horizontal position of the ball in the RingArea ObjectName x lt value gt The y variable is transmitted from the Lemur followed by one value representing the vertical position of the ball in the RingArea ObjectName y lt value gt The visual location of the ball can be set via messages from the host The horizontal and vertical positions are set via separate messages ObjectName x lt value gt ObjectName y lt value gt Note that the ball will remain fixed in a specific location after being set via an OSC message from the host whereas when moving the ball with your finger the ball will move toward the attraction point The Attraction Attractor X Attractor Y and Friction Variables can also be received by the Lemur ObjectName attraction lt value gt ObjectName attractor_x lt value gt ObjectName attractor_y lt value gt 79 Object Reference 4 1 10 SignalScope The SignalScope displays values of other Objects and variables on your Lemur The trace shows a recent history of the value of what you are monitoring The SignalScope is transparent to touch meaning that you
44. bject Reference 4 1 11 SurfaceLCD The SurfaceLCD Object emulates traditional control surfaces LCD by making use of the MIDI input capabilities of the Lemur With his Object you can display track names parameter changes timecode all updated in real time by your Digital Audio Workstation DAW The SurfaceLCD Object is compatible with the Mackie Control surface protocol Variables None This Object has no value to be mapped to MIDI and OSC It displays information coming from a DAW General Properties Name The name of the SurfaceLCD Object that s also used as its address Transparent If checked the background of the SurfaceLCD disappears to obtain a see through appearance If unchecked the background color is set by the Top color slider Target This lets you select the MIDI Target number for information display First setup a MIDI target with an input of your liking inside the JazzEditor settings Then configure your DAW to send Mackie Control surface data to this MIDI input Refer to the bundled examples for mappings of control Objects compatible with control surfaces protocols known by your DAW Display This lets you select one of three LCD modes common to conventional control surfaces In Main LCD mode the Object displays Track information In Timecode mode the Object displays up to date Timecode information In ASSignment mode the Object displays a three character code describing the current assignment of other mappe
45. bles vectors andsingletons a vector 0 2 0 5 a singleton 3 If you want to access the items of a vector separately use brackets a 1 3 4 al0 1 al2 4 This also works for multiple items al0 2 1 4 At the heart of the Lemur s parser lie the Operators and Functions They are used to construct expressions that make the Lemur such a versatile animal The operators are basic mathematical critters that you should know from your Maths classes you do remember your Maths classes do you T g a S is the modulo operator used to calculate the remainder of a division 10 3 1 85 Parser Reference This can be very useful to derive clean values from the time variable see below for a definition of Lemur time time 1 0 25 if time 2043 25 5 1 3 Functions Functions are the other founding stone of expressions in the Lemur There is a variety of internal pre defined Functions but you can also define your Own Function You can create a Function by setting up a variable named xxx a b and set its value as something like a b 2 The Functions can then be taken as the value for other Variables where they receive real Lemur values as arguments You could use the above function by making a Variable named yyy with the value xxx Fader x Multiball y In this case a and b are substitutes by the current values of Fader xX and MultiBall y Please note that most Functions that can act
46. cut The Lemur Synchronization of course only works if you have the same Project running on your computer and on the connected Lemur The Connection button opens a window listing all the accessible Lemurs on the network This is the place where you create a connection between the JazzEditor and a Lemur The Settings button opens a window that let you configure your MIDI and OSC targets as well as upgrade a connected Lemur 3 1 2 The Project Browser Project Browser ma g Deck A g DeckB g v Sync Pad V x g Syncs g v SyncBPad g SyncB g v XFader em Global Internal Arithmetic Logic Others time Trigonometric UF oR Vector In the lower left part of the Workspace you find the Project Browser It displays all elements of the current Project in a hierarchical tree structure If you need more space to see all levels of your Project just grab the top or right border of the Project Browser and drag it to resize the browser Click on the small disclosure triangles in front of the symbols or double click on a symbol to expand or collapse the next deeper level of the tree 22 The Lemur User Manual The upper part of the tree display the Interfaces of the Project Inside the Interfaces are Objects and their Variables The small checkboxes play an important role in Lemur Projects If a box is checked it means that the respective Variable is transmitted via OSC or MIDI If
47. d control Objects Refer to your DAW s manual for more information on specific display functions Behavior Properties None 4 1 12 Switches The Switches Object is a two dimensional array of toggle switches Their values reverse when you touch them Switches can be used to represent and transmit one or more on off states Variables X A list of the on off values of the switches in the Object The list starts with the top left corner and traverses the first row before starting at the beginning of the second row see diagram under OSC Data General Properties 82 Numbers Radio Columns Rows Light Capture Paint Lemur gt Host The Lemur User Manual Name The name of the Switches Object that s also used as its address Label If checked the Object s name Is displayed above all of the switches If checked each switch is labelled with a number corresponding to the order in which its value is transmitted starting with 0 as shown below In Radio mode only one switch can be turned on at any particular time Turning on any switch turns all the others off The number of columns of switches contained in the Object There does not appear to bea maximum number of columns but only 16 columns of pads can be seen on the screen at once The minimum width of a pad is 32 pixels and the Object will be resized if necessary to maintain the minimum pad height The number of rows of switches contained in the Obj
48. d you are done 2 2 Network configuration direct connection The Lemur uses standard Ethernet to communicate with your computer or with other devices on the network You can connect it directly to your computer with a single crossover Ethernet cable or place it on a local area network via a hub or switch and a non crossover Ethernet cable You may want to use a local area network if any of the following are true e You are using your computer s Ethernet port to connect to the internet and you want to keep the connection while working with your Lemur e You use a WLAN connection to the internet via a wireless router and you would like to access your Lemur wirelessly by connecting it to your router e You have several Lemurs you would like to use in parallel Lemurs are very social creatures one is never enough You may want to connect your Lemur directly to you computer with a single cable if any of the following are true e Your Lemur is the only Ethernet device you have either because you don t own any others or you connect wirelessly to other Ethernet network devices e You are looking for the simplest possible configuration for live performance To get in business rapidly we ll only cover the latter configuration in this section It should suffice on most systems Should it not work out of the box or if you seek more details on OS tinkering and connection to hubs and switches please have a look at the Appendix on Ne
49. dCustom MIDI mappings 24 The Lemur User Manual 3 1 3 The Editing Area The Editing Area is where you actually construct the Interfaces It always displays the Interface that is currently selected in the Project Browser Any freshly created Objects appear in the upper left corner of the current Interface Fetch them with your mouse and MOVE them to the spot you want If you hover with your mouse over an Object its Corners highlight Grab a corner and move the mouse to resize the Object Objects can overlap on the Interface The rule of thumb is that the Object created last will cover older Objects Some Objects like the Monitor can be transparent leading to various possibilities for labels and captions When the Transparency flag is activated only parts of the Object will remain opaque and any Objects lying underneath can be seen Multiple Objects can be selected by holding the Shift key and clicking on them one after the other You can also drag a Square around them to get the same effect By clicking an Object again while still holding the Shift key you remove it from the selection There are two different modes available concerning interaction with Objects in the JazzEditor In default Edit mode you cannot interact with Objects In Run mode you can use them with your mouse as you would do it with your fingers on the Lemur Simply press e on your computer keyboard and hold it to switch to Run mode As long as you hold th
50. der on its own But it s tough to hit the exact same colour twice so we select them both and change their colour to a same one Import Export Drag a square with your mouse that touches both Faders Now they both are selected and you can change the properties for both Objects at the same time Objects can also be grouped permanently via the context menu by right clicking command clicking for Macs on the selected Objects and choosing Group Properties Behavior Script OS MIOT This group command is also available on the Properties panel if several Objects are selected Do this for your Faders and every time you click on one of them both will be selected Double click on your new Group to display the General Properties panel Note since different kind of objects can grouped together only the properties common to all objects are displayed Now dial in a nice purple on the color swatch Both Faders now have the exact same color If you want to ungroup the Faders click on the Ungroup in the properties panel When you select several Objects or have them grouped you ll notice additional commands appearing on the Properties Panel that deal with layout and 1IzZ of the Objects The commands are e Align to Left Align to Right e Align to Top Align to Bottom 38 The Lemur User Manual e Make same Width e Make same Height They always refer to the Object you selected first in the group These c
51. ding to the order in which its value is transmitted starting with 0 as shown below The number of columns of pads contained in the Object There does not appear to be a maximum number of columns but only 25 columns of pads can be seen on the screen at once The minimum width of a pad is 32 pixels and the Object will be resized if necessary to maintain the minimum pad height The number of rows of pads contained in the Object There does not appear to be a maximum number of rows but only 19 rows of pads can be seen on the screen at once The minimum height of a pad is 32 pixels and the Object will be resized if necessary to maintain the minimum pad height Color Off Drag the colour bar to change the colour for the off state of the ColorOn Drag the colour bar to change the colour for the on state of the Can be a constant a vector or any mathematical expression and controls the luminosity of your Objects 2 means black 2 means white and you get to choose any decimal number in between 79 Capture Object Reference Behavior Properties If Capture is checked an Object will only react to cursors that were created inside its area Even if the cursor later leaves the Object for another position it will remain in control of the original Object until it is destroyed eventually When Capture is off the old school way from previous versions is restored meaning an Object will react to whatever cursor is present at any moment in its
52. dy have noticed the different colors for the Variables in the menu Red stands for the Object s main parameters x for a Fader x y z for a MultiBall etc Orange depicts a properties behaviour parameter like friction attraction value etc Green entries are Expressions created by the user Have a look at Chapter 3 3 2 for more information about the Trigger Mode menu It allows for choosing when and how often the messages are actually transmitted triggered 46 The Lemur User Manual 3 3 3 2 Simple MIDI Mapping In order to generate MIDI messages from the objects you touch on the Lemur you have to establish a Mapping between the 0 1 values transmitted by the Lemur and MIDI values which are typically integers whole numbers between 0 and 127 This is done on a per Variable basis on the MIDI panel of the Object We ll start with a simple example e Select a Fader in your project To assign a MIDI message to this fader click the MIDI panel of the Fader Properties Behavior Script OSC MIDI o ieee mici 0 Go Control Change vs CO CD C e Change the settings of the dialog to those shown above Message is Control Change controller number is 7 and value is x The Scale fields should be set from 0 to 127 Set the MIDI channel according to the channel of the desired Target which is chosen via the Target Menu to the upper left These settings configure the Fader to transmit MIDI controller 7 volume with
53. e velocity The Variable chosen from the Variable menu that is converted to velocity values is shown here Scale Type in the desired target scaling for the MIDI messages Possible values range from 0 to 127 Channel Dial in the MIDI channel If the value is a vector the second field will be extrapolated automatically You can always override this setting by putting in your own value Possible values range from Oto 16 6 1 1 3 A0 Key Pressure Polyphonic Aftertouch The Key Pressure also called polyphonic aftertouch gives the keyboarder a continuous controller for every key he had on his keyboard It is used via pressing down on the different keys This works great for spreading out vector values to multiple key pressure values 96 The Lemur User Manual 4 amp 0 Key Pressure D EC a CE key Dial in the MIDI note number If the value is a vector the second field will be extrapolated automatically You can always override this setting by putting in your own value pressure The Variable chosen from the Variable menu that is converted to key pressure values is shown here Scale Type in the desired target scaling for the MIDI messages Possible values range from 0 to 127 Channel Dial in the MIDI channel If the value is a vector the second field will be extrapolated automatically You can always override this setting by putting in your own value Possible values range from Oto 16 6 1 1 4 B0 Control Change
54. e Lemur network display and touchpanel configuration It also displays the version number of the firmware running on your Lemur e The Interface List button displays a gallery of thumbnails depicting each interface currently stored on the unit Touch the desired interface to display it full screen e The two Navigation buttons allow you to move forwards and backwards through the Interfaces currently stored on the unit Settings Interface List Navigation Buttons The Lemur User Manual On the rear panel of the Lemur you find the power switch and the power input jack Only connect the original power supply that came with your unit as it is perfectly verified for providing the correct currents Next to the adapter input there is an Ethernet jack with two status lights This is the Lemur s door to communication with the outside world Out of all the existing manners to connect the Lemur to your computer the easiest one consist in plugging the provided network cable between the Lemur Ethernet Input and your computer Ethernet interface NOTE The Ethernet jack can be used with any network cable Please use CAT5 or better quality Lower grades will not work properly Depending on the situation you will either need a crossover network cable for direct connection to the computer that s the cable that came with your Lemur or a non crossover network cable for connecting the Lemur to a hub or switch this situation is described i
55. e for synchronization purposes Build your own MIDI clock Co D trigger The Variable chosen from the Variable menu that is used to trigger timing tick messages is shown here 6 1 1 14 FA Start Song Used to start the song or sequence from the beginning Co aD trigger The Variable chosen from the Variable menu that used to trigger start song messages is shown here 6 1 1 15 FB Continue Song Used to start the song or sequence from where it was stopped Fe Continue Song aes Op trigger The Variable chosen from the Variable menu that is used to trigger tune request messages Is shown here 100 The Lemur User Manual 6 1 1 16 FC Stop Song Used to stop the song or sequence FC Stop Song D EC D trigger The Variable chosen from the Variable menu that is used to trigger stop song messages is shown here 6 1 1 17 FE Active Sensing When initially sent the receiver will expect to receive another Active Sensing message each 300ms max or it will be assume that the connection has been terminated At termination the receiver will turn off all voices and return to normal non active sensing operation FE Active Sensing 7 trigger The Variable chosen from the Variable menu that is used to trigger active sensing messages is shown here 6 1 1 18 FF System Reset Resets all receivers in the MIDI chain to power up status FF System Reset D EC D trigger The Variable chosen from the Variable menu
56. e key you can use your Interface This comes very handy when debugging your Setup without having your Lemur connected The Editing Area also features a contextual menu Open it with a right click command click for Macs It offers an additional way for executing the following commands for working with Objects or groups of them Copy Cut Paste Delete Group Ungroup Import Export 3 1 4 The General Properties The Properties panel provides access to the basic properties of the Lemur s Objects As the parameters vary from Object to Object the details are given in the Object Reference chapter 29 Working with your Lemur The General Properties deal with appearance and Variables You ll find there numerical fields for positionning and resizing objects Depending on the Object the additional parameters may vary Please look at the Object reference for information on Object specific parameters 3 1 5 The Behavior Properties Barycentric Interpolate D The Behavior panel circles around the physical characteristics of the Objects Here you find parameters like friction and tension and the different physics modes of the Object We ll cover those in the chapter Using your Lemur and inthe Object reference 3 1 6 The Script Panel FxControl on FxControl x 0 FxCont The Script panel is for defining expressions for Variables and Functions be it globally or locally Have a look at Chapters 3 3 2 and 3 5 for details on
57. e needs to master in order to work with the Lemur Beside the manual you will find a host of external material including additional documentation templates and didactical workshops meant to make your introduction to Lemur Work as smooth as possible Some of it is available on the provided CD ROM and much more can be download from www jazzmutant com Last another great characteristic of the Lemur is the constant evolution of its software fitting always better the user community s needs For that purpose JazzMutant regularly releases new updates to both software and documentation Consequently the manual you are reading might be already out of date The version covered by this manual is mentioned on its cover Before getting deeper into the documentation please make sure that the present documentation matches the software version installed on your Lemur In general we suggest you to keep both your Lemur and the above documentation up to date by checking the Product section on www jazzmutant com Table of Contents About the Lemur and this Manual vesccs ccs edeccdsccdecesas citeciecseeeieeideei eisedei cassis 2 Table of Contents 4 Chapter TANOwWING X OUT Pioicg 0 aaenreraneraee ner ar ean iE nae nan ners ner TAR 8 ti TheAnatomy of your TG IU eases charred cd actaante Aarne araatcnle dara Si Dae beste ancl 8 1 2 Inside your Lemur s brain scx sonics ince Oreste Savas eed Se Seen Sea ee Sees 9 1 2 1 Projects Interfaces and Containers
58. e provided CD e MacOS 10 3 Panther minimum e Network Adapter Ethernet Wifi Airport USB Firewire Double click on the JazzEditor dmg file located on the provided CD JazzEditor_v1 14 dmg You can now open the Disk Image jazzeaitor This Disk Image contains the JazzEditor Application witch can be safely copied anywhere on your Mac like any other application Uninstall can be done by just trashing the JazzEditor application 2 1 2 Windows XP Software Installation Software amp Hardware Requirements Windows e P3800 Mhz or greater 64 Mo SD RAM e Windows XP SP 2 e CD Rom Drive e Ethernet Interface 15 Installing Your Lemur To install the software open the CD in the Windows Explorer and double click the JazzEditor_setup exe B Setup JazzEditor J x Welcome to the JazzEditor Setup Wizard This will install JazzE ditor version 1 5 Beta on your computer It is recommended that you close all other applications before continuing Click Next to continue or Cancel to exit Setup Click on Next to start the Installation B Setup JazzEditor X Select Destination Location Where should JazzE ditor be installed taal Setup will install JazzE ditor into the following folder To continue click Next If pou would like to select a different folder click Browse C Programme J azzMutant At least 1 1 MB of free disk space is required We recommend using the default instal
59. e the Lemur was switched on Combined with the Lemur s mathematical operators it can produce a great variety of time varying number sequences 12 The Lemur User Manual 1 2 5 Targets The networkability of the Lemur endows it with the unique capacity to control simultaneously several applications running on the same computer and even to control several pieces of software launched on different computers Each application or device controlled by the Lemur is called a Target Each of Object s Variables can be mapped to any of the eight available MIDI Targets and to any of the eight OSC Targets A MIDI Target is a pair of MIDI In and Outputs and an OSC Target is characterized by its IP address and its port number This means a Target can be software on a networked computer or a piece of MIDI kit you have sitting in your rack No matter how complex your setup may be you can control everything from a single Interface on your Lemur by individually assigning the different Variables to different Targets 1 3 The daily life with your Lemur 1 3 1 Cuddling your Lemur The Lemur loves to be touched After all it is its main purpose in life But as It s the case with all primates the nature of the touch will affect the outcome The multitouch technology used in the Lemur combines high resolution with high sensitivity You don t have to use excessive force to control the objects on your interfaces Extremely light touch on the other h
60. eact to cursors that were created inside its area Even if the cursor later leaves the Object for another position it will remain in control of the original Object until it is destroyed eventually When Capture is off the old school way from previous versions is restored meaning an Object will react to whatever cursor is present at any moment in its area If checked the MultiSlider emulates the physics of an Object similar to a plucked string anchored at the left and right sides of the array of sliders Your fingers pluck the string by lifting it up in one or more places The values of the sliders ramp up to meet your fingers and track them as they move Lifting your fingerl s from the surface releases the string and its subsequent behavior is determined by the Tension Friction and Height values A value between 0 and 1 corresponding to the tension on a string As tension increases the frequency of oscillation of the string increases Increasing the tension is something like turning the tuning peg of a guitar to raise the pitch of a string A value between 0 and 1 corresponding to the damping on a string As friction increases the damping on the oscillation increases With large friction values the string returns to its resting position quickly With smaller friction values the string may oscillate for a long time When Gravity mode is enabled the height 0 to 1 is the value of the initial and resting position of the string Wh
61. eatecedsauelawcoiaccsdssueies 103 A19 IMacOSINCIWOrK Set oni hota Maur ote a a ave a ahaa vec 104 LA Windows XP Network StU cise seis ct ca tec nnana cates race 108 7 1 7 Lemur Computer network COMMUNICATION cceeeeeeeeeeteeeeeeeeees 111 ee 8 9 el Bcc mere eee ree Ce a oe aa ee a 112 Tas Upgrade your aa lO erence ererren se cerencerrrreres crete emer ener Terre eer creer a errr ner errr 113 7 3 1 Lemur hardware settings tscisapascassigsccpeinenenpanpaneseaemansneananen 114 T oubleshooting esisin a N 115 Lado Warn anty ancen E coca 115 Jio Warranty ana Liapiltity rsen E SN 115 Loe OUr RIOM Siae a a eee eT Ge 115 7 9 3 Applicable laws and court of jurisdiction ccccccssesseeeeeeeeeeeesseeeeeees 116 Knowing Your Lemur Chapter 1 KNOWING YOUR LEMUR Not only does the Lemur look unlike any controller out there it also introduces new ways of describing human machine interaction This chapter will put you In acquaintance with your new pet and the way it thinks 1 1 The Anatomy of your Lemur Let s first have a look at your Lemur s anatomy The top of the Lemur obviously features the Multitouch screen which is laid on a ultra bright TFT Display The first allows you to manipulate colourful user interface objects displayed on the latter with all your ten fingers independently Above the display there are four buttons which have different utility functions e The Settings button gives your access to th
62. ect There does not appear to be a maximum number of rows but only 16 rows of pads can be seen on the screen at once The minimum height of a pad is 32 pixels and the Object will be resized if necessary to maintain the minimum pad height Color Off Drag the colour bar to change the colour for the off state of the Switches ColorOQn Drag the colour bar to change the colour for the on state of the Switches Can be a constant a vector or any mathematical expression and controls the luminosity of your Objects 2 means black 2 means white and you get to choose any decimal number in between Behavior Properties If Capture is checked an Object will only react to cursors that were created inside its area Even if the cursor later leaves the Object for another position it will remain in control of the original Object until it is destroyed eventually When Capture is off the old school way from previous versions Is restored meaning an Object will react to whatever cursor is present at any moment in its area If this flag is active you can paint on an array of switches by dragging your finger around If paint is inactive a touch only toggles the switch you hit first and dragging the finger around has no further effect OSC Data The x variable is transmitted by the Lemur as a list of numbers representing the state of each switch ObjectName x lt switch value 1 gt lt switch value 2 gt etc The switches are reported in the fo
63. ed when the Variable rises In our case only when we hit the Pad as the value rises from 0 to 65 For velocity we use the value of Fader3 scaled to the MIDI range of 0 to 127 viathe Scale fields Now we can trigger notes with the Pad and control the velocity with Faders3 As a playful addition we assign the other Fader s value to the MIDI channel Here we use range function to get values between 1 and 16 Now you can choose the MIDI Channel for the outgoing note messages This might be an exotic application but it s fun stack up a pile of sounds in multimode in your favourite synth and trigger different sounds by moving the channel fader on your Lemur Have a look at the different Trigger Modes we use Velocity and Channel are set to None Only a change in the Pads x value will trigger transmission of the MIDI message Note that unlike usual variables Custom MIDI messages cannot be controlled via OSC or MIDI They only provide outgoing data 3 4 5 Bi directional Control All Variables of a Lemur Project can also be easily controlled by external software or hardware via MIDI and OSC If you want to control a Variable via MIDI just set up the necessary MIDI Input fora Target in the MIDI settings Then choose that MIDI Target for the Variable on the MIDI panel CD CED Bo Control Change T TH CC a CES If you have for example a Fader s x value set up for transmission of MIDI controller 1 on MIDI Target 0 i
64. el 37 Range Function 66 Rear Panel 5 121 Redo 27 Resize 36 RingArea 86 Run mode 37 Save As 27 Save Project 27 Scale 66 Script 38 Script panel 38 Settings button 6 15 Shortcuts 118 SignalScope 88 Singletons 92 Slashes 67 Slider 52 Software amp Hardware Requirements Mac 9 Software Installation 9 Song Position 103 Song Select 104 Speed 52 Start Song 104 Static IP 16 106 Static IP Configuration 107 Stop 30 Stop Song 105 Switches object 90 Switching Interfaces 68 Synchronization 29 System Exclusive 103 System Reset 105 Target 28 Targets 23 25 Tension 52 Time 94 Time Code 95 Timing Tick 104 Appendices Toolbar 21 27 TouchScreen Filtering 7 Transparency 37 Trigger Mode 65 Trigger Modes 41 66 Trigonometric 98 Troubleshooting 120 Tune Request 104 Undo 27 Ungroup 37 47 Upgrade 119 Upgrade Firmware 31 119 Use 32 67 Value Coloring 92 Value flag 61 Variable 23 59 Variables 25 Color Code 39 40 Global 25 Hierarchy 67 Leds Object 74 76 Local 25 Monitor 77 Multiball 78 Multi dimensional 25 MultiSlider 81 Pads 83 122 RingArea 86 SignalScope 88 Switches 90 Variables menu 40 54 Vector 63 98 Vector Variables 63 Vectors 70 92 Velocity 66 Virtual MIDI driver 22 Virtual MIDI Ports 21 Warranty 120 Windows Internet Protocol TCP IP 19 LAN or High Speed Internet 17 Local Area Connection 18 MIDI Setup 22 My Network Places 17 Network Connection settings 17 Network Setu
65. en Gravity mode is not enabled the height is the initial value of the MultiSlider after it is initialized OSC Data The x variable is transmitted by the Lemur as a list of numbers representing the height of each slider ObjectName x lt slider value 1 gt lt slider value 2 gt etc The x variable can be received by the Lemur as a list of numbers representing the height of each slider ObjectName x lt slider value 1 gt lt slider value 2 gt etc The friction height tension and light variables can also be received by the MultiSlider ObjectName friction lt value gt ObjectName height lt value gt ObjectName tension lt value gt ObjectName light lt value gt 74 4 1 8 touch The Lemur User Manual Pads The Pads Object is a two dimensional array of buttons that are triggered by They are intended to trigger events instead of represent state since they eventually return to an off value after you touch them Variables x A list of the envelope brightness values of the pads in the Object Dimensions Default 100 x 100 pixels Minimum 32 x 32 pixels times the number of rows and columns General Properties Name The name of the Pads Object that s also used as its address Label Numbers Columns Rows Pads Pads Light If checked the Object s name is displayed above the pads which are squished to accommodate the text If checked each pad is labelled with a number correspon
66. f variables Only a few of them are useful when it comes to controlling your application most are only meant to change objects properties Also as we will see later there might be at least two reasons for not sending the output value of a particular object One would be if you were using an Object merely to display information coming from your computer The MultiBall object could represent the state of something happening in different application The other reason could be that you transmit the data from the Object to your computer via a Variable containing a mathematical expression In this case the original Variable e g the x is only referenced by the Expression in another Variable This is often used to scale values into a more appropriate range We ll learn more about this technique later Since it s not worth overloading the network with useless data we provided an option that let you decide whether or not a variable shall be sent Let s have a look at the project browser window Myinterface Cp iv MyFader iv x The checkboxes next to MyFader and x are what we re interested in The checkbox in front of the Fader must be checked for enabling any data transmission from this Object Also the checkbox next to the X must be checked in order for the Lemur to send fader positional data when you touch the Object We want the Fader to transmit its position to our setup so we should check MyFader as wellas x While checkbo
67. file system Please note that you can also import and export Interface elements via the context menu of the Project Browser right click command click on the Editing Area The file extension for Modules is JZLIb There are some caveats concerning Object hierarchy when it comes to exporting parts of your Projects Make sure that you do not destroy any dependencies in terms of variables and expressions It is good practice to encapsulate the exported Module in a Container and have the variables and 43 Working with your Lemur functions that are important for the Module s functionality created Locally to that Container If you define them globally they will not get exported and the functionality of the Module will be broken 3 3 Use your Interface Now that we have set up our Interfaces and know how to modify the Objects it is time to put all this to use You already know how to set up MIDI and OSC Targets by using the Lemur Settings from the Toolbar see Chapter 3 2 We assume in this section that you have your Targets sorted out For every Variable of your various Objects you can decide to which Target its value is transmitted and from which Target its variables and parameters are controlled You can choose MIDI and OSC Targets independently This ensures maximum flexibility in terms of routing values across your software and hardware setup 3 3 1 The send mode As we said before a project can be comprised of a great number o
68. forging your own expressions The Lemur User Manual 3 1 7 The OSC Panel ex oy cp Deck FXScope x On the OSC Panel you can define the routing of the different Variables to OSC Targets You have a menu for the Variables and one for the eight possible OSC Targets 3 1 8 The MIDI Panel CD ss CED So NoteOn COs Cop o i n es The MIDI panel presents all things you need for transforming the Variables of your Objects into MIDI messages and routing them to the MIDI Targets This panel also serve for controlling Lemur Objects via MIDI 3 1 9 Workspace Configuration The layout of the JazzEditor Workspace can be customized to suit your preferences Just grab a panel by its titile bar be it the Project Browser the Object Panels or the Editing Area and drag it to another spot on the Workspace Everything can be rearranged 27 Working with your Lemur 3 2 Interface building Now that you know your way around the Workspace it is time to get your feet wet and mess around with a little Project 3 2 1 Connecting your lemur up The first step naturally consists in opening the connection between JazzEditor and the Lemur To do so click on the Connect button on the toolbar which should result in opening the following window Connection lemur 192 168 1 6 8000 192 168 1 6 sO00 If you have your network set up correctly see the chapters about network configuration and the respective appendix
69. from the Lemur OSC messages Without the slash unchecked checkbox the messages look like Container1 Container2 Fader x Including the slash checkbox checked the outgoing messages will look like Container1 Container2 Fader x Which option will work depends on the Target Please look at the Target s documentation if you are unsure or test it empirically The Lemur is able to read both forms when parsing incoming messages 3 2 2 4 Midi Settings Settings Editor Lemur OS MIDI MIDI Yoke NT 2 ve MIDI Yoke NT 1 gt PHASE 24 FW 0 Midi In 1 v PHASE 24 FW O Midi Out1 C E D The MIDI panel of the Settings window displays the currently defined MIDI Targets There can be up to eight of them The MIDI communication is bi directional meaning you can choose a MIDI input port incoming to the JazzEditor and a MIDI output port outgoing from the JazzEditor Which ports are present on the menu depends on the installed MIDI drivers on your system Please have a look at the chapter about MIDI setup at the beginning of this manual for further detail The JazzEditor has to run for working with MIDI as the MIDI data is not generated on the Lemur itself the JazzEditor works as a bridge translating between MIDI and OSC protocols in real time 3 2 2 5 Virtual MIDI Ports on Mac On the Mac the JazzEditor creates two virtual MIDI ports called JazzEditor Output and JazzEditor Input These can be used to establish b
70. ght already have noticed the different colors for the Variables in the menu Red stands for the Object s main parameters x for a Fader x y z for a MultiBall etc Orange depicts a properties behaviour parameter like friction attraction value etc Green entries are Expressions created by the user 45 Working with your Lemur Have a look at Chapter 3 3 4 for more information about the Trigger Mode menu It allows for choosing when and how often the messages are actually transmitted triggered 3 3 3 Setting up MIDI messages 3 3 3 1 Using the MIDI window On the top of the MIDI panel you ll find two menus The left one is the Variables menu and the right one is for choosing one of the MIDI Targets defined in the MIDI Settings Choose any of the MIDI messages from the Message Menu You find a great variety ranging from Note messages over Controllers to System Realtime messages like Song Start Stop or Active Sensing They are preceded by their MIDI status byte Depending on the message type you get various parameters to tweak Please have a look at the MIDI Message reference appendix for details The communication with MIDI Targets is bi directional You define the pairing for both incoming and outgoing MIDI data with the various parameters of your Objects on the MIDI panel That s why you also find Variables on the menu that do not output values Friction f height light tension You might alrea
71. h device 7 1 2 Computer directly connected to a Lemur as known as P2P Using a simple crossover RJ45 cable you can directly connect your Lemur to any computer 7 1 2 1 Computer configured as a DHCP Server Connection Sharing If your computer is configured as a DHCP Server it will attribute dynamically an IP address to the Lemur Most of the time your computer forces its IP address to 169 254 X 1 and the Lemur will obtain an IP like 169 254 X X 7 1 2 2 Computer and Lemur using DHCP When the Lemur and the computer are set up as DHCP clients they both wait for a DHCP server until the OS gives a default IP address like 169 254 X X 7 1 2 3 Computer and Lemur using Static IP The most common way to configure a network without a DHCP server is to set up each device with different but compatible IPs using the same network mask Most people use IP addresses like 192 168 0 X or 10 0 0 X Eventually when using connection sharing the computer can share its internet connection and give the Lemur access to another sub network by using the Gateway Address 102 The Lemur User Manual 7 1 3 Computers and Lemur connected to a Network 7 1 3 1 Network with a DHCP Server Most network sharing devices allow multiple connections and manage the attribution of IP addresses through the DHCP protocol These devices include WIFI Ethernet Routers Airport Base Stations and ADSL Cable Modems with routers You only need to configure all your
72. he color of the outline around the MultiBall s rectangular space The colors of the balls are fixed as follows Ephemeral Capture Cursor Mode Physics Attraction The Lemur User Manual E faded purple 2 lime green 3 lemur yellow orange see screen shot above 4 lemon yellow 2 red 6 teal blue 7 deep blue 8 sea green 9 intense purple 10 white grey Behavior Properties If checked the MultiBall behaves in a mode where the balls disappear until you touch it with one or more fingers The brightness of the balls becomes the value of the z variable of the Object and the way the brightness changes over time is controlled by an ADSR envelope described below When Ephemeral is not checked the balls are always visible and their z values are constantly 1 If Capture is checked an Object will only react to cursors that were created inside its area Even if the cursor later leaves the Object for another position it will remain in control of the original Object until it is destroyed eventually When Capture is off the old school way from previous versions is restored meaning an Object will react to whatever cursor is present at any moment in its area If set to Limited the Balls will respond to a new cursor only if the original one has been destroyed i e finger is raised In Barycentric mode each cursor old and new has the same amount of influence on the Object Get Oldest Ball If all the balls are curren
73. he discussion of Mass Spring mode under Physic above This value multiplies the balls speed after Physics computation by a user defined expression Input a singleton for the same effect on all balls otherwise input a vector Experiment with negative values for crazy effects About the MultiBall ADSR H The next four properties relate to the brightness or z variable envelope that can be used in ephemeral mode You specify time values for the Attack Decay and Release in seconds as well as a Sustain level between 0 and 1 Unlike a keyboard ADSR the MultiBall ADSR goes through its entire cycle when you touch the surface to trigger the appearance of a ball If the ball is still tracking your finger when it reaches the end of the Decay portion of the envelope the z value brightness will remain at the sustain level until you lift your finger off the surface At that point or before if your finger has already left the surface the Release portion of the envelope will be triggered and the z variable will return to 0 Attack Decay Sustain Release Hold Lemur gt Host Applies only when using ephemeral mode The Attack value specifies the number of seconds over which the z variable brightness of a ball increases from its initial value of 0 to a maximum of 1 after you touch the screen As an example if the Attack value is 0 the ball will be at full brightness the moment you touch the screen Applies only when using ep
74. hemeral mode The Decay value specifies the number of seconds over which the brightness will decrease after the initial Attack portion of the envelope has completed During the Decay portion of the envelope the z variable brightness of a ball will decrease from 1 to the level set by the Sustain value Applies only when using ephemeral mode The sustain value is the level between 0 and 1 at which the brightness of the ball will remain as long the MultiBall Object is tracking your finger within its space The Sustain level is reached after the Attack and Decay portion of the envelope have completed If your finger lifts up from the touch surface before the completion of the Attack and or Decay portion of the envelope the Release portion of the envelope is triggered immediately after the Decay portion completes and the brightness ultimately goes to 0 Applies only when using ephemeral mode The Release value specifies the number of seconds over which the brightness of a ball will decrease from its Sustain level to 0 starting at the moment that you lift up release your finger from the touch surface Its effect is similar to a sustain pedal freezing the Object s state as long as its value is 1 When set to 0 if has no effect This means this parameter should be used with a mathematical expression depending on other Objects For instance if you have a Switch Object named Sustain in your interface you can set the hold parameter of a P
75. idirectional MIDI connections to applications running on your system Choose the Jazz Editor Output as MIDI input in the application you want to control with the Lemur As an example the following image shows the MIDI input menu in Ableton Live 31 Working with your Lemur Computer Keyboard For control of the Lemur via software you have to choose the JazzEditor Input in the controlling software to route MIDI to the JazzEditor If you need additional ports please use your Audio MIDI setup utility and create additional IAC Bus ports 3 2 2 6 Virtual MIDI Ports on Windows XP On Windows you ll need a third party software virtual MIDI interface such as LoopBe or MidiYoke Both drivers are freeware and easily downloadable from the internet The virtual MIDI drivers offer multiple MIDI ports that you can use to define a variety of Targets in the JazzEditor If all things fail you can route MIDI from the JazzEditor to a physical MIDI interface and back into your computer In the software application you want to control with the Lemur choose the virtual or hardware MIDI port which is connected to the JazzEditor s MIDI output As you can also have bi directional communication via MIDI i e the MIDI enabled software can also control Lemur Objects use a second virtual port to make the reverse connection to the Lemur In the JazzEditor MIDI settings this might look similar to the following image Settings Temir OSS MIDI
76. it s unchecked it is only used internally e g as a reference for other Variables Global send boxes on Objects and Containers let the user activate deactivate OSC and MIDI mappings for a whole hierachical level of a project Project Browser vj x gt amp v Fader gt amp v Fader2 PF 2 New And Shiny gt O v Fader3 9 v Fader4 em O Y multiball em TE em g v Pads Tor V MyMIDI 30 NoteOn 9 v Pads2 gt g Vv wiggle B amp B Global 23 o Y giggle sndi amp Internal B Arithmetic abs a Working with your Lemur Project Browser Internal PS Arithmetic abs a ceilfa Floorfa maxf a b minfa b pow a b round a signa sqrt a a b a b a b Below the Interfaces you find the Global Variables and the internal Operators and Functions These are just for your reference and you cannot interact with them using your mouse Find out more about Operators and Functions in the Parser Reference section The various entries in the Project Browser are color coded Red dots stand for the Object s main parameters x for a Fader x y z for a MultiBall etc Orange dots depict a Custom MIDI message Green dots show Expressions created by the user Blue dots show Functions defined by the user Grey stands for internal Functions Black dots are the Operators Use the four Create commands to create new Interfaces Objects Expressions an
77. lation path on English systems it is C Program Files JazzMutant If you have your own way of organizing things you can also choose a different folder 16 The Lemur User Manual j5 Setup JazzEditor mi xX Select Start Menu Folder Where should Setup place the program s shortcuts re fi Setup will create the program s shortcuts in the following Start Menu folder To continue click Next If pou would like to select a different folder click Browse JazzMutant In this step you can choose the name of the Start Menu folder where Windows will put the shortcut for starting the JazzEditor 5 Setup JazzEditor Ready to Install Setup is now ready to begin installing JazzEditor on your computer Click Install to continue with the installation or click Back if you want to review or change any settings Destination location C Programme azz utant Start Menu folder JazzMutant Install Cancel The next screen summarizes the settings you chose before If you click on Install the software is transferred to your hard disk and all necessary are made automatically 17 Installing Your Lemur is Setup JazzEditor mx Completing the JazzEditor Setup A Wizard Setup has finished installing JazzE ditor on your computer The application may be launched by selecting the installed icons Click Finish to exit Setup Just click Finish on the last screen of the installation procedure an
78. llowing order 83 Object Reference Host gt Lemur The x and the light Variables are received by the Lemur as a list of numbers representing the state of each switch ObjectName x lt switch value 1 gt lt switch value 2 gt etc ObjectName light lt switch value 1 gt lt switch value 2 gt etc 84 The Lemur User Manual Chapter 5 PARSER REFERENCE The parser is the part of the Lemur s brain that crunches away on the Math you throw at it It is used to do simple stuff like scaling an internal value or adding some Variables But there s more Due to a set of internal Operators and Functions and the possibility to create your own custom Functions you can construct very complex Projects They may include a lot of internal calculation and interdependences between Objects helping in building the perfect interactive Interface 5 1 1 Value Colouring There is a colour code for showing the type of value in a variable or expression The colour changes automatically when you start typing into the respective fields e Black meansa standard expression that is evaluates 60 times a second every 16ms e Red indicated an invalid expression e Blue isa constant like 10 2 This is useful to check whether an expression is well formed If it goes black you know it can be calculated which of course still doesn t mean it does what you want it to 5 1 2 Vectors Singletons and Operators The Parser handles two kinds of varia
79. lope the x variable pad brightness will decrease from 1 to the level set by the Sustain value The Sustain value is the level between 0 and 1 at which the x variable pad brightness will remain as long your finger is touching the pad The Sustain level is reached after the Attack and Decay portion of the envelope have completed If your finger lifts up from the touch surface before the completion of the Attack and or Decay portion of the envelope the Release portion of the envelope is triggered immediately after the Decay portion completes and the brightness ultimately goes to 0 The Release value specifies the number of seconds over which the x variable pad brightness will decrease from its Sustain level to 0 starting at the moment that you lift up release your finger from the touch surface Its effect is similar to a sustain pedal freezing the Object s state as long as its value is 1 When set to 0 if has no effect This means this parameter should be used with a mathematical expression depending on other Objects For instance if you have a Switch Object named Sustain in your interface you can set the hold parameter of a Pad to Sustain x so the Switch gets the ability to freeze the current lightness OSC Data The x variable is transmitted by the Lemur as a list of numbers representing the brightness of each pad ObjectName x lt pad value 1 gt lt pad value 2 gt etc The pads are reported in the following order
80. meters associated with the chosen message type i e the CC number and the CC value for a MIDI controller message The Target column shows which of the MIDI Targets that are defined on the Settings window have been chosen for the respective mapping 49 Working with your Lemur The individual MIDI mappings can be selected with a mouse click The Send MIDI button sends a single instant of the MIDI message associated with the currently selected mapping to the respective Target Should the MIDI message of that mapping be a Note On event a Note On will be sent to the apppropriate target This turns in handy when configuring an external software s MIDI mapping The Refresh button updates the list of MIDI mappings and you can close the window by hitting the Close button or the escape key on your computer keyboard 3 3 4 Trigger Modes Common to the OSC and MIDI parameters that can change over time is the Trigger Mode Menu The Trigger Mode is set for every parameter individually via a dedicated menu and it decides when a message should be transmitted Let s look at the trigger mode for one parameter of a MIDI message let s say the velocity of a note on message or the value of a control change any The message is sent whenever the parameter changes up The message is sent each time the parameter rises from 0 into the positive value range down The message is sent each time the parameter reaches 0 from the positive value
81. n the Appendix Network Configuration Guide 1 2 Inside your Lemur s brain The Lemur introduces a new paradigm in the realm of media control and along with this brand new approach its usage might slightly differ from the way you are used to deal with conventional controllers Therefore before you start working with your new controller we felt it was worth making you familiar with the core concepts of the system 1 2 1 Projects Interfaces and Containers As you might have noticed the main characteristic of the Lemur is that it doesnt feature any physical control object such as real pads keyboard bulky faders or joysticks Instead there is a blank touchpanel that your can populate with as many different virtual objects as you need This way you can design the interface layouts that will perfectly fit both your application and your hands For that purpose the Lemur is provided with a dual platform MacOSX and Windows XP interface design utility the mighty JazzZEditor This application lets you import or create complete control templates for the Lemur which we call Projects All Project files the JazzEditor produces are stored somewhere on your computer s hard drive as XML files A Project can contain many Interfaces You can think of them as pages in your Project containing multiple Objects that can be organized in Containers The number of Interfaces and Objects is limited only by the Knowing Your Lemur internal memory of
82. nate Configuration You can get IP settings assigned automatically if your network supports this capability Otherwise you need to ask your network administrator for the appropriate IP settings Use the following IP address Obtain DNS server address automatically Use the following DNS server addresses N Select Obtain an IP address automatically to use DHCP configuration or select Use the following IP address to use static IP configuration Enter assigned static IP address and Subnet Mask Click OK to confirm changes 7 1 7 Lemur Computer network communication To confirm that your network setup is correct power on the Lemur and open the JazzEditor Click the Connect button You must see the Lemur on the list 111 Appendices Connection lemur 192 168 1 6 8000 192 168 1 6 6000 7 2 Shortcuts Command Keyboard shortcut New Project Control N Save Project Control S Import Library Control l Copy Control C Paste Control V Redo Control Y Lemur Synchro Control R Lemur Settings Alt S Create Object Control Shift 0O Create Custom MIDI Control Shift M Open Project Control O Save Project As Control Shift S Export Module Control E Cut Control X Undo Control Z MIDI Map Alt M Lemur Connection Alt C Create Interface Control Shift Create Expression Control Shift E Create Custom MIDI Control Shift M Toggle to Run Mode Hold E 112 The Lemur User Manual 7
83. nd controls the luminosity of your Objects 2 means black 2 means white and you can choose any decimal number in between Behavior Properties OSC Data Lemur gt Host none The x and the light Variables are received by the Lemur as a list of numbers representing the state of each Led 68 The Lemur User Manual ObjectName x lt Leds value 1 gt lt Leds value 2 gt etc ObjectName light lt Leds value 1 gt lt Leds value 2 gt etc 4 1 5 Monitor The Monitor produces no data when you touch it Its purpose is to display information sent to the Lemur by your computer Variables value Represents the value of the Monitor to be displayed You can use a constant or any expression Dimensions Minimum 50 pixels wide and 22 pixels high The font size of the monitor is adjusted as the Object is resized General Properties Name The name of the Monitor that s also used as its address Label If checked the Object s name is displayed above the value Value The checkbox is not functional The text field next to Value represents the monitor s default value Since any value can be sent to the monitor there is no 0 1 limitation x Transparent If checked only the Label and the value is displayed and the Monitors background becomes transparent This also makes it possible to use the Monitor as a text label anywhere on the Interface Unit Appends arbitrary text to the end of the value display Precision Number
84. nd oscillate around a centre value that s defined by the height parameter Again we are only scratching the surface here Please have a look at the Object Reference for details about all Object Properties Properties Behavior P Let s come back to our MultiBall Object The Capture parameter on the Behavior panel has great influence on the possible finger actions When you are inside of the Object s boundaries the Capture mode doesn t make any difference But if you move the ball and leave the borders of the Object the control of the ball will stop when Capture is Off If Capture is ON the ball will continue being tied to your actions No matter if you move your finger across other Objects and even if you switch to a different Interface the ball will still cling to your finger and the finger has no effect on other Objects Just experiment a bit with the two modes and you will quickly get the hang of it The MultiBall Object is a complex critter It also sports an ADSR H envelope for its brightness parameter that is accessible as a numerical value inside its z parameter You might be familiar with envelopes from using synthesizers They represent an easy way to produce defined parameter changes over time The MultiBall ADSR acts just like It s cousins from the synthesis world When you touch the Lemur the brightness of the ball will be faded in according to the Attack value decay down to the sustain level and fade o
85. ny damages were caused with intent or gross negligence by us or one of our affiliates Neither our affiliates nor we are liable in any case not described above In case of culpable breach of cardinal obligations without intent or negligence on our part our affiliates or we will be liable only to the extent of typically foreseeable damages and not for damage not incurred to the delivered merchandise itself The risk of loss is transferred to you once the merchandise has been sent to you This also applies with part deliveries If you are buying software via electronic delivery Instant Delivery we carry the risk of loss until the software has been fully transferred to your computer 7 5 2 Your Rights The customer s rights concerning refunds of all or part of a payment are valid only when such rights were legally confirmed or were accepted by us In writing The orderer s right to retention is valid only provided claims are based on the same contract The preferred method of written communication is email and is held to be equal in status to letters transmitted through the postal service The term correspondence below is taken to Include email Deadlines are taken Insofar as is not otherwise mutually agreed to always mean the date of receipt by the recipient As far as email is concerned the date of receipt is considered to be the 115 Appendices date of dispatch If there is disagreement about the date of dispatch the time of recei
86. o Lemur The multitouch surface User Manual Version 1 5 999 JAZZMUTANT www jazzmutant com About the Lemur and this manual Congratulations for choosing JazzMutant s Lemur The Lemur is a groundbreaking Input device for controlling music and media applications There is no doubt its unprecedented modularity combined with its unigue multitouch sensing technology will change forever the way you compose perform produce and speaking more generally interact with your work environment e What the Lemur is The Lemur is a computer peripheral in other words a device that you connect to a computer The Lemur is a controller its only purpose in life is to provide hands on control over software running on a computer or other devices connected to It such as samplers synthetizers etc To interact with them the Lemur uses two communication protocols MIDI and OpenSoundControl To be controlled by the Lemur software must comply with at least one of those protocols e and what it is not The Lemur is neither a tablet PC nor a display monitor That means that you cannot write your emails with it or watch a movie The Lemur does not produce any sound by itself There are plenty of wonderful software and hardware out there that do that job perfectly The Lemur is there to make their use more efficient and playful The Lemur is not a Midi Interface you cannot connect a master keyboard or any other MIDI device on it
87. ommands are of great help when it comes to tidying up your Interfaces Experiment a bit with those to get the hang And always remember that you have the Undo command to roll back changes 3 2 8 Configuring Object s behaviour Now let s glance at one of the most powerful feature of the Lemur s objects their configurable behaviour Select the MultiBall object with the mouse and look at the Behavior panel The following display will appear Barycentric Interpolate D The Physics menu has three modes defining the behaviour of the balls When Physics is set to None the ball moves immediately to the position of your finger and stays there It also follows your finger around as you move it on the touch screen and immediately stops when you lift up your finger Make sure the Physics menu is set to Interpolate which should be the default setting Interpolate D Touch the Lemur screen somewhere in the MultiBall but not on top of a ball The ball will not move to your finger immediately but according to the setting of the Attraction property Let s modify Attraction to make the ball react more Slowly Enter a value of 0 1 Experiment again with the Ball s reaction It should follow your finger Slowly Now let s try the last behavior mode Choose Mass Spring from the Physics menu Change the Attraction value to 1 0 and the Friction to 0 2 Working with your Lemur Try moving the ball now It bounces off the wall
88. ons 3 4 6 Defining and Using Functions In addition to built in functions and operators you may define your OWN mathematical functions to use in other Lemur variables and expressions Here s how to do it Click the Create Expression button to create a new Expression The Expression is created at the level of the hierarchy you have currently selected If you have an Object selected it will be an Expression local to that Object If you have the Global folder selected the Expression will go there Type the name of the function and its arguments in parentheses For example to define a function named cubed that takes one argument you would type Create Expression cubed a ok Cancel Mi Click OK and click on the Script panel of the new Expression Type in the definition of your function as an expression You can reference other variables if desired The example below just multiplies the function argument a by itself twice to raise the Input to the third power 60 The Lemur User Manual How to use the new function We are running out of space with our Interfaces but there s still an empty spot on the first one Switch to the 1 Demo Interface and create a new Fader in the Container Make it a vertical one change the colour to something different in our case it s red Also name the Fader Cubic and check both the Label and the value checkboxes Properties Behavior Stripe OSO cm cubed x 10
89. or by creating an empty Project the connection to the Lemur is dropped If you connect the Lemur again the Project loaded in JazzEditor will automatically be transferred to the Lemur overwriting the one on the Lemur There s currently no way to recover a Project residing on the Lemur Make sure to save your work in the JazzEditor before closing the Project Once your Project is transferred to the Lemur you can close the JazzEditor and use the Lemur to produce OSC data It will happily connect to all defined OSC Targets If you use MIDI in your Project the JazzEditor has to run as it is needed to translate the OSC data from the Lemur into MIDI messages As a note for technical nerds the Lemur and JazzEditor read projects as XML formatted files leaving you endless possibilities for algorithmical interface generation and other fancy geeky stuff That s another story though 3 2 6 Changing Object appearance First we are going to resize the Fader to have some more travel for our fingers Grab the lower right corner of the Fader and drag it down to make the Fader longer and maybe a bit wider too Note how the Width and Height Parameters in the Properties change as you do it and vice versa if you type a value in one of the dimension fields the fader will move and resize accordingly Talking about the properties tab what about changing the colour of our fader Sure a yellowish green can be nice but what about a deep blue
90. ormal MIDI assignments you can only assign the selected variable to one parameter of the message With Custom MIDI messages you gain complete freedom to assign any value or expression to any one of the different parameters of the message And remember that expressions can use all values of all Objects in your Project For a Note On message the parameters would be e Pitch e Velocity 57 Working with your Lemur e MIDI Channel Also there is a Trigger Mode menu for all the parameters Please read chapter 3 3 4 for details As a small example try adding a Pads Object and two Faders Fader3 and Fader4 to the second Interface of our Project Next create a Custom MIDI message local to the Pads Object and call it MyMIDI PF 2 New And Shiny g Fader3 g Fader4 GW multiball g Pads 9 4 9 MyMIDI 90 NoteOn g wiggle Now look at the MIDI panel of the Custom Midi message and choose Note On from the message menu Properties Behavior Script OSC MIDI mymio R Can adersi range Fader4 x 1 16 __ As we want a fixed pitch for the generated note messages we set pitch to the value of the Pad which is one when triggered and multiply it with 65 to get a note centrally in the keyboard range As we want the Pad to 08 The Lemur User Manual only transmit a Note On message when we hit it fand not when we raise our finger set the Trigger mode to This means that the Note On message is only generat
91. oups of parameters Let s use a MultiSlider to produce values for an envelope working somewhere in a Synthesizer and trigger them with a Pads Object Switch to the 1 Demo Interface and click into the Container There s some space left Click the Create Object button and choose the Pads Name the Object Trig and click OK Click the Create Object button again choose MultiSlider from the list of objects name the object ENV and click OK Click the Behavior panel of the MultiSlider and set the number of sliders to 4 Move and resize the MultiSlider so you can control each slider easily Maybe something like this or a little bigger We re going to use the first slider for Attack the second for Decay the third for Sustain and the fourth for Release As with the x variables of all Lemur objects the MultiSlider x variable ranges between 0 and 1 This is not really enough of a range for the time values of our envelope so we need to scale these values We ll also need to create three Expressions one for each of the envelope s time values Click on the Trig Object Pads in the Project Browser so that its name is selected Click the Create Expression button to create a new local Expression Name the expression Atk and press return Click on the new expression in the Project Browser and change to its Script panel In the script field enter the Expression shown below Properties Behavior Script OS MIOT Eny x 0 5 0
92. p 112 TCP IP Properties 19 Windows XP Network Configuration 17 Windows XP Software Installation 9 WLAN 14 Workspace 26 Workspace Configuration 42 x Variable 54
93. possible SysEx messages 6 1 1 9 F2 Song Position A 14 bit value that holds the number of MIDI beats 1 beat six MIDI Timing Tick since the start of the song F2 Song Position D EC aD oR 16383 position The Variable chosen from the Variable menu that is converted to song position values is shown here Scale Type in the desired target scaling for the position pointer Note that song position pointer values range from 0 to 16383 6 1 1 10 F3 Song Select The Song Select specifies which sequence or song is to be played C Cop CEED CESS song The Variable chosen from the Variable menu that is converted to song number values is shown here Scale Type in the desired target scaling for the song number Possible values range from 0 to 127 6 1 1 11 F5 Bus Select The Bus Select message specifies to which MIDI output further data should be sent 99 MIDI Message Reference FS Bus Select D EC aD CES bus The Variable chosen from the Variable menu that is converted to bus number values is shown here Scale Type in the desired target scaling for the bus number Possible values range from 0 to 127 6 1 1 12 F6 Tune Request Used to trigger the tuning of oscillators in analog synthesizers Fe Tune Request i Cc D trigger The Variable chosen from the Variable menu that is used to trigger tune request messages is shown here 6 1 1 13 F8 Timing Tick Sent 24 times per quarter not
94. pt is taken as the receipt of the message on the target email server 7 5 3 Applicable laws and court of jurisdiction The law of France applies in exclusion of UN buying law even when the order is placed in another country or the order is to be delivered into another country If you are resident outside France or if your usual place of abode Is outside France the court of jurisdiction for all claims in relation to your order is in Bordeaux France In the event of a legal dispute the official address is JAZZMUTANT 45 cours Alsace Lorraine 33000 BORDEAUX France 116 The Lemur User Manual Index jzub 23 71 Jzml 23 10 Mbits s 16 Accessing variables 93 Active Sensing 105 ADSR H 53 Align to Bottom 38 Align to Left 38 Align to Right 38 Align to Top 38 Arithmetic 95 Attraction 51 Auto Speed 16 Behavior 38 51 63 Behavior panel 38 63 Behavior Properties Fader 73 Leds 75 76 Monitor 77 Multiball 79 MultiSlider 82 Pads 83 SignalScope 88 Switches 91 Bi directional Control 67 Brightness ADSR 54 Bus Select 104 Capture 25 53 Ch 28 Channel Pressure 102 Checkbox 60 Checkboxes 34 Color 46 Connect 29 117 Connection 29 Connection Sharing 106 Constant controller values 94 Container 23 48 Containers 24 Continue Song 105 Control Change 102 Controller 56 Controller Mappings 55 Controlling sub objects 59 Copy 27 37 Copy and Paste 44 Create Custom MIDI mappings 36 Expressions 36 Objects 36 Create Interfaces 3
95. r Manual Network Connections File Edit View Favorites Tools Advanced Help Beck Bp search Folders Ey Address Network Connections LAN or High Speed Internet Local Area Connection fF nabled L a Realtek RTLE139 Family PCI F Network Tasks Create a new connection a Disable this network device xX Repair this connection ci Rename this connection View status of this connection Change settings of this connection e Click onthe Properties button Local Area Connection Status Connection Status Connected Duration 6 days 01 39 45 Speed 100 0 Mbps Activity Sent a Received Packets 2 244 445 2 425 622 e Select Internet Protocol TCP IP and click the Properties button 109 Appendices Local Area Connection Properties General Authentication Advanced Connect using E9 Realtek RTL9139 Family PCI Fast Ethernet NIC This connection uses the following items z Client for Microsoft Networks File and Printer Sharing for Microsoft Networks JE QoS Packet Scheduler Internet Protocol TCP IP Uninstall Description Transmission Control Protocol Internet Protocol The default wide area network protocol that provides communication across diverse interconnected networks Show icon in notification area when connected 110 The Lemur User Manual Internet Protocol ICP IP Properties General Alter
96. r example map the e Expression to a control change that will be mapped to the x axis when pad is pressed and y axis when pad Is released 5 1 8 3 Others clampla min max Constrain a between min max clamp Fader x 0 2 0 3 0 2 if Fader x lt 0 2 91 Parser Reference 0 3 if Fader x gt 0 3 Fader x otherwise rand Returns a random value between 0 and lat each frame one frame is 16ms the parser evaluates every Expression at each frame and send out MIDI or OSC if a mapped value has changed rangela min max Stretch a Variable that normally goes from 0 to 1 to range min max range Fader x 10 100 10 if Fader x 100 if Fader x 100 between 10 and 100 otherwise 5 1 8 4 Trigonometric acos asin atan cos sin tan log log10 exp are the same as their mathematical counterparts angle x y Returns the angle in radians formed by a vector of coordinates x y to the positive X axis Example Create a RingArea Create a variable inside a angle x 0 5 y 0 5 this returns the angle position of the ball from the centre of the RingArea normIx y Length of a vector of coordinates x y Example create a Multiball with 2 balls variable inside distance normal x 1 x 0 y 1 y 0 this returns the distance between ball 0 and ball 1 5 1 8 5 Vector fillla value size Returns a vector with size items the vector is filled from the left with n items value the number of items
97. r the course of a second Here are some example Expressions created using the time variable 5 1 7 1 Time Code Example Use Monitor Objects to display the values of the following expressions Frames time 0 25 100 Hours floor time 3600 Minutes floor time 60 60 Seconds floor time 60 Create global Variables for each of these Expressions Then you can use the Variables in other Lemur Objects For example here is the Properties Browser view for a monitor Object that would display a global Seconds variable 88 The Lemur User Manual Even if you are not connected to a Lemur the resulting Monitor Object will begin changing immediately after you enter a time based variable 5 1 7 2 LFO Example This is an Expression using the time Variable that generates an LFO LFO sin time 2 0 5 0 5 You can display this in a SignalScope You can assign time based variables to properties in Lemur Objects such as Friction or the ADSR envelopes to create Objects that change over time However you can t assign them to the values of Objects other than the Monitor and SignalScope so you can t use the time variable to animate the purple ball in an Area 5 1 8 Operators and Functions Reference The following is a list of all internal Functions and Operators the Lemur parser understands Try them out by creating a monitor Object and enter an Expression using the Functions and Operators in the value field
98. range up and down The message is sent each time the parameter reaches 0 OR rises from 0 The message is sent each time the parameter increases above its previous value a The message is sent each time the parameter decreases below its previous value For Custom MIDI Messages see Chapter 3 4 4 for an explanation there is an additional item on the Trigger Mode Menu 00 The Lemur User Manual The first entry None means that a change in the attached value or expression will not trigger a transmission of the MIDI message It might however still get triggered by values or expressions associated with other parameters of the Custom MIDI message that don t have their Trigger Mode set to None 3 4 Advanced features 3 4 1 Control your Objects with your Objects It s easy to control the behaviour of your Objects via other Objects on the Interface Let s add an additional Fader to our original Container Call it Friction Now switch to the Behavior panel of the MultiBall Object and change the Physics parameter to Mass Spring Also enter Friction x as the value for friction 51 Working with your Lemur Properties Behavior Script OS MIOT a v Barycentric Now you can control the friction of the MultiBall via the new Fader It s as simple as that Use any value of any of the Objects dwelling on your Lemur Interface to control any of the parameters This can lead to very interactive In
99. riable in the Project Browser Type x Fader2 x 100 into the Script field of the Variable Make sure that the checkbox in front of the local Variable is checked This ensures that the Variable is actually transmitted via OSC and MIDI It should look like this Properties Behavior Script OSC MIOT x Fader2 x 100 Project Browser amp 1 Demo gt g Vv Container P g Vv Fader V x Qo MEs EPER FT P de v gt y n siilo aad _ vr SY yr MPader x Fader2 100 You might wonder why we addressed the Fader s value with x directly and not via Fader x This is possible because the Expression we created is Local to the Fader so that it knows the address of its parent If we would have created the Expression globally we would have used the full address Fader x Of course you want to see the output of the Variable Open the General Properties of the first Fader and check the value flag Type MFader into the value field As we don t care about decimal places this time set the Precision toQ 03 Working with your Lemur Properties Behavior Script For the second Fader also check the value checkbox and type x 100 into the value field The Precision can also be set to Q Properties Behavior Script Fader2 If you now Move the Faders you will see the relevant values displayed above Move the second Fader and the value of the Variable will change because it gets mul
100. ribed above we re going to create a Switch then a MultiBall 34 The Lemur User Manual Create Object ILoveButtons Container Fader Knob Leds MackieDisplay Monitor Multiball MultiSlider Pads RingAarea SignalScope Switches SoFunny Container Fader Knob Leds MackieDisplay Monitor Multiball MultiSlider Pads RingArea SignalScope Switches a Not surprisingly these will appear on both the editing window and the Lemur screen And as a good news never comes alone the two objects are also listed in the project browser sorted by alphabetical order 3 2 5 Saving your project MylInterface g ILoveButtons g MyFader g SoFunny You might want to keep this work of art ready for future loading and editing Just hit the Save button in the toolbar and give a name to your project Save As MyProjectjzml 35 amp Working with your Lemur When you do that all the interfaces objects and variables contained in your work session are saved ina single jzml file All files the JazzEditor produces be it Project files or Modules reside on your hard disk The Project files have the extension jZMl and Modules have the file extension JZLIb Now let s open our project again by hitting the Open button You might have noticed that the Connect Button has changed is status That s a normal behaviour When opening a new Project in JazzEditor either by loading an existing one from disk
101. roperties If Capture is checked an Object will only react to cursors that were created inside its area Even if the cursor later leaves the Object for another position it will remain in control of the original Object until it is destroyed eventually When Capture is off the old school way from previous versions is restored meaning an Object will react to whatever cursor is present at any moment in its area A value from 0 1 representing the speed of the ball from its attraction point to your finger when you touch the Object and from your finger to the attraction point when you release your finger A value from 0 1 representing the stickiness of the movement to either your finger or the attraction point Lower values of friction make the ball overshoot the attraction point when it approaches causing bouncing and or oscillation 78 Attractor X Attractor Y The Lemur User Manual A value from 0 1 representing the horizontal location of the attraction point within the Object s rectangle A zero value of Attractor X is at the left edge anda value of 1 is at the right edge A value from 0 1 representing the vertical location of the attraction point within the Object s rectangle A zero value of Attractor Y is at the bottom edge and a value of 1 is at the top edge The exact position values transmitted by the Lemur when the ball arrives at the attraction point is partially dependent on the size of the RingArea The ball never le
102. rsesadaeentenamertesonigentoramaenenesens 99 Glide PZ SONG FOSO Nease A 99 The Lemur User Manual bde klos a SO MGs ClO Chex sla scieis Sirk oonhen a iter enmeaey 99 Schl Fos BUS Selehna edna elated eitcanede 99 6 11 12 OP Tune Requestor a a a aod Daal ee 100 ory fre a EEN TICE a E era ne ere een eae 100 Gell PA Slat SONG ra 100 blka FD Continue SOM Gicas esessacnesnsseuasiiaaveonicieteanipebainian eas aanbeneds 100 og Pk Hd oe FCO OR keener rer mmert teeter reer ra Tre 101 Gels RE ACUVE SENSING harek b 101 6 1 1 18 FF Systeri RESET sss cencansidnsncancanahdaes Soaniaa shed ded enandane ancndadidnaedie 101 Chapter 7 Appendices 102 7 1 Network Configuration Guide sa x25 ccs denvsevedenchane donthavedeaduanadaneeaeatanekanntontianeds 102 Pelli MGWOSSALYS eann i soos Sk ots ge sous Se sais a aia sated eit a a Sey heed 102 7 1 2 Computer directly connected to a Lemur as known as P2P 102 7 1 2 1 Computer configured as a DHCP Server Connection Sharing 102 7 1 2 2 Computer and Lemur using DM CP acnnsi nea ais 102 7 1 2 3 Computer and Lemur using Static IP nara iaidsinmesiininwedes 102 7 1 3 Computers and Lemur connected to a Network cccccssseeeeeeeeees 103 7 1 3 1 Network with a DHCP Server vessucehcccsdies sadeutehaacstenstatsueed sande sadtes 103 7 1 3 2 Network without DHCP Server ceeccceccccsssssseeeeeeesseaesseeeeeees 103 7 1 4 Lemur Network Setup ccciciscscsccccdcacs iocdeancecndesvadocis
103. s and eventually slows down The Mass Spring mode is something like Interpolation except that the ball has friction or a lack of it can bounce off of things and in certain cases the ball may oscillate before coming to a complete rest You can also control the speed of the ball via the Speed parameter Physics parameters are nice to produce complex time varying values with little effort We will see later in this chapter that we can obtain even more enjoyable effects by controlling the Physics properties with other objects As another example we create a MultiSlider Object Create Object SoLovely Container Fader Knob Leds MackieDisplay Monitor Multiball MultiSlider Pads RingAarea SignalScope Switches ok Cancel In the General Properties we enter 9 in the Slider field for having you guessed it 5 sliders Also we drag the MultiSlider to a free spot on the Interface and make it bigger so that we can interact easily with the individual sliders SoLovely The default MultiSlider Object displays no physical behaviour The sliders simply follow your finger and stay where you leave them 40 The Lemur User Manual Now change to the Behavior panel and activate the Physic checkbox Also change the tension to 0 1 and the friction to 0 Now it s a completely different story If you move the sliders they will continue to wiggle forever They behave as if they are connected with springs a
104. s of Attraction and Friction in Mass Spring mode Attraction The amount of attraction the cursor your finger has on the Fader Friction See Mass Spring above OSC Data Lemur gt Host The x variable is transmitted from the Lemur followed by one value representing the Fader s position ObjectName x lt value gt Host gt Lemur The x Attraction and Friction and value Variables can be received by the Lemur Please note that if you have an expression working in the value field the Lemur will always use the value of the expression and not the data received via OSC ObjectName x lt value gt ObjectName attraction lt value gt ObjectName friction lt value gt ObjectName value lt value gt 4 1 3 Knob The Knob Object emulates two types of knobs Classic knobs which are constrained between a min and max value 0 and 1 by default and endless encoders which can reach any value through multiple successive turns Variables X The current value of the knob based on absolute angle position in Classic mode or rotation count in Endless mode General Properties Name The name of the Knob Object that s also used as its address Label If checked the Object s name is displayed above the Knob Endless If checked the knob switches to endless mode Value If checked the current value of the Knob is displayed on the Interface In addition you can enter a formula for how the value is displayed This does not affect the act
105. s the different parameters of the MIDI messages like pitch velocity and MIDI channel can be controlled by any expression you want Please read chapter 3 4 4 for details 80 Note OFF i 80 Note OFF 30 Note On A0 Key Pressure B0 Control Change CO Program Change DO Channel Pressure EQ Pitch Bend FO System Exclusive F2 Song Position F3 Song Select Bus Select Tune Request Timing Tick Start Song 99 MIDI Message Reference 6 1 1 1 80 Note Off The Note Off message is sent when a key Is released 80 Note Off D pitch Dial in the MIDI note number If the value is a vector the second field will be extrapolated automatically You can always override this setting by putting in your own value velocity The Variable chosen from the Variable menu that is converted to velocity values is shown here Scale Type in the desired target scaling for the MIDI messages Possible values range from 0 to 127 Channel Dial in the MIDI channel If the value is a vector the second field will be extrapolated automatically You can always override this setting by putting in your own value Possible values range from Oto 16 6 1 1 2 90 Note On The Note On is sent when a key Is depressed Go NoteOn Od aryl as pitch Dial in the MIDI note number If the value is a vector the second field will be extrapolated automatically You can always override this setting by putting in your own valu
106. set to value depends on the a argument a threshold between 0 and 1 when a 0 there s no filling at all and the vector is full of zeros 92 The Lemur User Manual when a 1 the vector is completely filled with items value when a 0 5 the vector is half filled Examples fill 1 0 524 4 0 524 0 524 0 524 0 524 fill O 0 524 4 0 0 0 0 fill 0 5 0 524 4 0 524 0 524 0 0 firstof a Returns the position of the first non null item in a vector this is often used with switches in radio mode firstof x returns the position of the enabled switch in the matrix Examples firstof 0 0 1 2 firstof 1 0 0 0 if the vector only contains null items the function returns the size of the vector firstof 0 0 0 3 replace a b position Takes an array and replace the items starting at position with b b can be an array or a singleton Examples replace 0 0 0 0 12 2 0 12 2 0 0 replace 0 0 0 0 0 15 3 0 0 0 0 15 If position is not an integer the parser converts it using the floor function next lower integer set a value position Takes an array and change the item at position to value position can be an array ora singleton Examples set 0 0 0 0 12 0 12 0 0 0 set 0 0 0 0 12 0 2 12 0 12 0 If position is not an Integer the parser converts it using the floor function next lower integer sizeof a
107. set to Limited the Fader will respond to a new cursor only if the original one has been destroyed i e finger is raised Get Newer means that whenever a new cursor appears inside the Object s area it gains full control of the Object In Barycentric mode each cursor old and new has the same amount of influence on the Object In Cap Only mode the Object acts like a conventional fader that doesn t react to cursors outside of the cap area Can be one of three settings None Interpolate or Mass Spring If Physics is set to None the Fader cap tracks one finger immediately If other fingers touch the fader they are ignored 65 Object Reference If Physics is set to Interpolate the cap moves according to the value of Attraction from its current location to the location of your finger Larger values for attraction up to 1 cause the cap to move to the new finger location more quickly When Attraction is set to 0 the cap cannot be moved by your finger If Physics is set to Mass Spring Attraction and Friction are both active Friction ranges between 0 and 1 Lower values of friction mean that if the cap Is moving it will tend to keep moving With a value of 0 the cap will never stop moving At a value of 1 the cap exactly follows your finger Values of 1 for Attraction and Friction are essentially the same as if Physics is set to None Please consider that the Lemur will send the Fader s position constantly with lower value
108. t s a piece of software running on the same computer as the JazzEditor click the My IP button This will automatically fill in the IP of the currently used interface The Port setting is dependent on the corresponding setting in the Target Ports are something like channel selectors that allow multiple applications to share the same IP address without conflicts The choice of port number is determined by what software you are using Port 8001 should not be used because the JazzEditor uses this port to establish connection with the Lemur If you try to use another application while the JazzEditor is open the application will not be able to access port 8001 Similarly if you launch the JazzEditor while another application is using port 8001 it will be unable to connect to the Lemur For Max MSP the port number can be anything 8000 is the typical value used For Reaktor 5 the port number must be higher than 10000 For other OSC compatible software or hardware consult the Target s documentation for details on port settings Once you have loaded a Project from the JazzEditor onto the Lemur which is automatically done on connect the OSC messages are handled by the Lemur This means you can close the JazzEditor and let the Lemur comunicate with OSC Targets On the other hand the JazzEditor has to be running for MIDI work 30 The Lemur User Manual The Use checkboxes offer two different formatting options for the outgoing
109. t will also be controllable via incoming controller 1 data on the Input port chosen for that MIDI Target Similarly you can control all values via OSC The different values are controlled via their OSC addresses you already know 59 Working with your Lemur For controlling a Fader via OSC just set up the OSC Target for the x value on the OSC panel and produce the OSC messages on the Target side In the Fader s case you would send values between 0 and 1 to the OSC address Fader x to the current IP and port of the Lemur The exact message format depends on the Use slashes checkbox Please make sure that you think about the hierarchy of Objects on the Lemur If the Fader is inside of a Container the address would be Container Fader x Note that it s also possible to switch Interfaces via OSC Just send an OSC message in the format interface InterfaceName to the Lemur In our case this would look like interface 1 Demo for switching to the first one For names that include Spaces there is an additional consideration to be made The OSC software has to send the name asa single string This might involve putting it in quotes in the software This is the case for Max MSP For more about working with OSC MIDI and bi directional control please have a look at the extensive workshop chapters we offer on our website There you ll learn everything about how the Lemur loves Max MSP Reaktor and other OSC enabled applicati
110. ter 2 and in the Appendix about Network Configuration and the Screen Settings The Screen Settings are opened by touching the Settings Button on the Hardware Settings Window There are two sliders for controlling you Lemur s screen hardware 114 The Lemur User Manual e LCD Brightness controls the brightness of your Lemur s screen It may be useful to dim the display if you want to work under dark stage conditions where too much light may not be desirable e The TouchScreen Filtering is for controlling the sensitivity of the Lemur s touch screen If you experience multiple triggering or other touch artefacts try a higher Filtering level 7 4 Troubleshooting 7 5 Warranty 7 5 1 Warranty and Liability Please check the delivered products for obvious defects By opening the original packaging or downloading the product you accept all copyrights as well as the warranty restrictions Should you find any defect of the merchandise during the one year warranty period JAZZMUTANT will at its sole discretion either replace the merchandise or remove any defects Should we be unable to do so within an acceptable period of time you are entitled to cancel your order We are liable for the culpable breach of fundamental contractual obligations so called cardinal obligations and the absence of any promised qualities Otherwise we are liable only within the limits set by applicable liability laws or for whatever legal reason when a
111. terfaces If you have SUb objects you can address their behaviour properties Individually by using a vector or list instead of a singleton If you have three balls in a MultiBall Object and use a vector with three components to denote say friction all balls will get their individual friction value Of course this also works with attraction and speed and any other parameter of objects with multiple sub objects 3 4 2 Making your own Variable Now let s say you have that special Reaktor patch with a custom parameter having an extra wide range You want fine grained control with a Fader in the lower range but you also need the possibility to control it over the complete range How would you do that Simply take a second Fader and use it as a Multiplier for the Value of the first one This is best done via the creation of a local Variable that gets transmitted via OSC and MIDI Go back to our two originals faders from the beginning of this chapter and select the first one gt amp 1 Demo 4 g v Container 99 em amp Vv Fader2 Now click on the Create Variable button below the Project Browser Type in the name M Fader into the dialog and click OK You should see the Variable named Mfader in the Project Browser being Local to the Fader 52 The Lemur User Manual amp 1 Demo gt g Vv Container We want to scale the output of the first Fader with the value of the second Do this by clicking on the fresh Va
112. that is used to trigger system reset messages is shown here 101 Appendices Chapter 7 APPENDICES 7 1 Network Configuration Guide The Lemur control surface is a network device using the Ethernet protocol to connect and communicate with other devices on the network Computers routers DHCP servers Thus you have to setup your Lemur and your network devices properly Generally a device can have multiple network adapters like Ethernet WIFI Airport USB Network Adapters Firewire and others Each adapter can have its own IP settings and it is highly recommended to set different sub networks to avoid network problems 7 1 1 Glossary IP Address a unique sequence of 4 numbers witch identify each device on a network An IP address can be setup in static mode or attributed dynamically by a DHCP server An IP address is composed by 4 numbers between 0 and 255 as follows 192 168 2 2 or 10 0 0 35 Network Mask an IP like sequence witch defines a sub network of compatible IP addresses Most of the time we use 255 259 255 0 or 255 255 0 0 which means that only the 3 or 2 first IP numbers should be equal to be compatible Gateway the IP address of the machine giving you access to IPs which are not included in the sub network In brief a Gateway enables you to gain access to the Internet from an intranet MAC Address a sequence of 6 numbers identifying each network adapter on a network The MAC Address Is unique and constant for eac
113. the Lemur which gives you plenty of room for your creations The figure below shows a typical Lemur project comprised of three different interfaces Ny Illl liu il Min TT e CSE Once a project is loaded on the Lemur the different Interfaces can be browsed through via the Interface List button or switched to with the Navigation buttons The Interface List button presents them as an array of small icons that you can activate by touch Use the Navigation buttons to step through the Interfaces one by one as shown below Comm The Containers let you organize the Objects on an Interface Containers have a frame around them leading to tidy looks and easy structuring of your control surface They can contain multiple Containers themselves building a hierarchy of Interface elements The picture below shows an interface featuring three different containers 10 chapter 3 The Lemur User Manual All details regarding projects interfaces and containers are disclosed in Working With Your Lemur 1 2 2 Objects Objects are the main message generators of the Lemur they provide the values you control with your fingers There is a multitude of different Objects available t Fader Leds Knob Monitor MultiBall MultiSlider Pads RingArea SurfaceLCD SignalScope Switches hat all have their special capabilities Each particular object comes along with a set of specific options enabling you to customise
114. the parent of the x Variable must be included in the address scaled_x Fader x WARNING Containers are taken into account in the hierarchy If the Fader is inside container Cont all Expressions outside of the container must access it with Cont Fader x Expressions inside of the same container can omit the first part and access it directly via Fader x 5 1 6 Lemur internal clock The Lemur works with a clock speed of 60 ticks per second This means that every 16 MS all states of Objects Expressions and Functions are evaluated These 16 ms constitute one Lemur frame There are some special considerations though as the Lemur s brain tries to avoid unnecessary work When it comes to deciding whether the value of a Variable is going to be transmitted via MIDI or OSC the Lemur first checks if the Variable has changed since the last frame If it hasn t changed it s not going to be transmitted This has implications if you want to transmit constant controller values via MIDI or OSC e g via a Pads Object It does not work to just put in a constant for your controller value as the Lemur will refuse to send it after the first activation of the Pads Object The value didn t change so It is not worth sending it Let s assume you want to transmit the value 64 every time you hit the Pad g Pads eo J changer 64 Simply create a Variable we called it changer local to the Pads Object and fill in 64 xX in
115. ther boring and useless when they come to controlling software To start filling this empty space let s click on the New Object button which is supposed to open the Object List Window as shown below 33 Working with your Lemur Create Object Container Knob Leds MackieDisplay Monitor Multiball MultiSlider Pads RingArea SignalScope Switches As its name may suggest the object list window displays all available objects sorted by alphabetical order To create a new object we just have to choose one among the list to give it a name of our liking then to click the Ok button For our first experience with interface building would suggest to start with the most common the Fader Once created our newbie Fader appears on the upper left corner of both the editing window and the Lemur s screen It s also referenced in the project browser Project Browser MyInterface gt O m As a reward of our effort let s have some fun with the fader When you touch the Fader on the Lemur you will notice that the actions are not mirrored in JazzEditor Click the Synchronization button to change this Now everything you do on the Lemur will be reflected on your Computer This helps if you have to save a Project in a defined state for future use Are you already bored with your lonely fader That s no problem let s provide him with a few fellow objects By repeating the very same procedure than desc
116. tiplied by a factor between 0 and 100 depending on the value of the second Fader Fader2 x 100 04 The Lemur User Manual Please note that the displayed values are not those actually produced by the Faders They both still produce values between O and 1 Those values are combined in the calculation of the local Variable MFader that is displayed above the first Fader The factor that s used for multiplication is displayed above Fader 2 We want to transmit the local Variable MFader via MIDI This is easily done via the MIDI panel of the first Fader The Variables menu contains the Variable MFader and we can choose it to be transmitted to MIDI Target 0 for any other Target we want Choose Control Change as Message and Controller 10 as controller Make sure that you uncheck the Scale checkbox as we want the values to be transmitted as is and not extrapolated to values between 0 and 127 G0 Control Change v areder o emi o Ai Now the JazzEditor will output values between 0 and 100 to MIDI Target 0 depending on the state of the two Faders 3 4 3 Using Vector Variables The Lemur doesn t only know data structures containing single values There are also vector list variables that consist of more than one value Vectors are used by the MultiSlider MultiBall Pads and Switches Objects D9 Working with your Lemur This can be convenient when you need controls for ADSR envelopes or other tightly interrelated gr
117. tly possessed by your fingers and a new cursor comes in it will take control of the oldest ball the one that lived the longest in Ephemeral mode or the first ball in normal mode Get Closest Ball In the same situation the new cursor gets attributed the ball that is the closest in distance Can be one of three settings None Interpolate or Mass Spring If Physics is set to None balls move to finger positions immediately and the settings of Attraction and Friction are ignored If Physics is set to Interpolate balls move toward finger positions according to the value of Attraction Larger values for attraction up to 1 cause a ball to move to a finger position more quickly As the Attraction value is lowered the balls take longer to arrive at the finger position When Attraction is set to 0 balls cannot be moved by your finger If Physics is set to Mass Spring Attraction and Friction are both active Attraction works as described above under Interpolation Friction ranges between 0 and 1 Lower values of friction mean that if a ball is moving it will tend to keep moving With a value of 0 the balls will essentially never stop moving At a value of 1 a ball will move only where you touch with your finger Values of 1 for Attraction and Friction are essentially the same as if Physics is set to Interpolate The amount of attraction the cursors your fingers have on the Balls 71 Speed Object Reference Friction See t
118. to channel pressure values is shown here Scale Type in the desired target scaling for the MIDI messages Possible values range from 0 to 127 Channel Dial in the MIDI channel If the value is a vector the second field will be extrapolated automatically Possible values range from 0 to 16 6 1 1 7 E0 Pitch Bend Used to indicate a change in the pitch wheel It is a 14 bit value providing a higher resolution than control changes EQ Pitch Bend D CO D 0 o eh 16383 bend The Vvariable chosen from the Variable menu that is converted to program change values is shown here Scale Type in the desired target scaling for the MIDI messages Note that pitch bend values range from 0 to 16383 98 The Lemur User Manual Channel Dial in the MIDI channel If the value is a vector the second field will be extrapolated automatically Possible values range from 0 to 16 6 1 1 8 FO System Exclusive Used for custom data that is not covered by normal MIDI messages The first part is usually a 7 bit value representing an ID If the device or software recognizes the ID as its own it will listen to the rest of the message Otherwise the message will be ignored FO System Exclusive EC D trigger The Variable chosen from the Variable menu that is converted to SysEx messages is shown here data Type in the desired SysEx string you want to send Please have a look at the MIDI Target s documentation for details about
119. twork Configuration 2 2 1 Three steps The direct connection procedure basically boils down to three steps e Connect the Lemur s Ethernet port to your computer s one using the provided crossover cable 18 The Lemur User Manual e Make sure any firewall software Is deactivated on your computer e Turn your Lemur on and press the settings button On the appearing panel just select the Automatic Using DHCP mode Settings Settings 19 Working with your Lemur Chapter 3 WORKING WITH YOUR LEMUR We are now ready to start working with the Lemur This chapter will guide you through the use of the JazzEditor application and introduce you to the workflow involved with designing Lemur control interfaces 3 1 The JazzEditor Workspace All editing and building of Interfaces is done via the JazzEditor Software Here you create modify and save your Projects as well as manage connection to your Lemur and to external gear via Ethernet and MIDI This section will walk you through the different parts of the Workspace Please read the section about Interface building for details on how to actually use them and refer to the Object Reference for complete documentation of all parameters xmo JazzEditor Sunshine Funk DJ remot 883 jzml Bee JSC AvS OO Properties Behavior Stripe OSC MID Temar ES D Chong DJ Mixer amp Fx ES keyboard amp cmp BS Global amp Internal The JazzEditor Workspace is your home
120. ual value sent by the Knob which remains between 0 and 1 Unit This user specified text is appended at the end of the value display Use it to specify the type of value as in dB or ms 66 Precision Color Cursor Mode Control Physics Attraction The Lemur User Manual Specifies the number of decimal places for the value display The default value is 3 and the maximum number is 6 This setting has no influence on the actual output of the Object You have to scale the output using expressions or on the Target side Drag the colour bar to change the colour of the Knob Behavior Properties If set to Limited the Knob will respond to a new cursor only if the original one has been destroyed i e finger is raised Get Newer means that whenever a new cursor appears inside the Object s area it gains full control of the Object In Barycentric mode each cursor old and new has the same amount of influence on the Object In Polar mode the Knob respond to the polar position of cursors relative to its center point In Linear mode the Knob responds to cursor drag on the vertical axis Can be one of three settings None Interpolate or Mass Spring If Physics is set to None the Knob jumps instantly to the value dictated by the cursors positions If Physics is set to Interpolate the Knob rotates toward new values according to the value of Attraction Larger values for attraction up to 1 cause the Knob to reach a
121. ure 101 The Lemur User Manual Keyboard Shortcuts 118 Layout 48 LCD Brightness 7 Leds 76 Lemur Connection 23 Lemur Network Setup 107 Lemur Settings 21 Lemur Synchronization 29 Lemur bin 119 LFO 95 Local IP 31 Local Variable 59 Logic 96 LoopBe 22 Mac Built in Ethernet 16 DHCP 110 Network Preferences 16 Network Setup 108 Show menu 16 Static IP 108 TCP IP settings 16 Virtual MIDI Ports 21 MAC Address 106 Mac OS Software Installation 9 Mac OS X Network Configuration 16 Maintenance 8 Make same Height 38 Make same Width 38 Mass Spring 51 Media display 16 Memory Display 27 Message Menu 40 Message Name 28 MIDI Bi directional 67 119 Input port 33 Output port 33 Targets 33 MIDI assignment 57 MIDI channel 66 MIDI Channel 28 MIDI configuration 21 MIDI input port 21 MIDI Map window 59 MIDI Mapping 28 55 Ch 28 Message Name 28 Msg 28 Name 28 Parameter 28 Refresh 28 Send MIDI 28 Target 28 MIDI Message Reference 99 MIDI Messages 99 MIDI Note Messages 57 MIDI output port 21 MIDI panel 55 Automatic mapping 57 Controller 56 Message 55 MIDI Panel 40 MIDI Setup 22 MIDI Targets 21 25 33 40 MidiYoke 22 Modules 23 26 70 Import Export 70 Monitor 77 Msg 28 MultiBall 50 53 78 Speed 92 Appendices Multiball ADSR 80 MultiSlider 52 81 Name conflict 45 Navigation 6 NetMask 16 Network configuration 14 Network Configuration 105 Network configuration direct connection 14 Network Mask 106 Network Settings 1
122. ut with the release time when you lift your finger from the surface Objects supporting ADSR envelopes MultiBall and Pads for the time being also have ahold parameter Its effect is similar to a sustain pedal freezing the object s state as long as its value is 1 When set to 0 if has no effect Interesting effects can be achieved when setting the hold parameter to an expression depending on other objects state Well cover such methods later on 41 Working with your Lemur Limited o O Interpolate D The above picture is an example of brightness ADSR Please note that the Ephemeral mode has to be active for the envelope to work In Ephemeral mode the balls appear when you touch the surface and they vanish when you lift your finger 3 2 9 Using Containers The next thing we want to do is put some of the Objects into a Container to separate them visually from our Faders To do this drag a square around the MultiBall and the Switch Object to select them Now right click Ctrl click on Mac on the selection and choose Cut from the menu The Objects disappear They are not gone though but just got copied into the clipboard of the JazzEditor Create Object RatherInteresting Container Fader Click the New Object button and create a Container from the displayed list Position the Container to the right of the Faders and resize it to encompass the complete right part of the Interface Right click Command click for M
123. xes are enabled by default when creating objects and variables remember to uncheck the variables you don t want to be sent out to reduce network overload 44 The Lemur User Manual 3 3 2 Setting up OSC mappings If you are unsure about basic OSC setup please have a look at chapter 3 1 7 Make sure our Fader is selected and have a look at the OSC panel On the left you see the Variables menu and to the right the Targets menu We want to transmit the Fader s x Variable via OSC If you have a look at the Variables menu of the OSC panel you see that it lists all available Variables of the Fader Choose the x From the OSC Targets menu choose the Target that you have set up in the general OSC Settings If you now move your Fader it will send the value of X to the OSC address Fader x Use whatever OSC software you have to check it If you want to change the OSC address use the Custom Address flag and type in whatever address you need This may be useful in case of naming conflicts between Lemur Projects and projects running on the Target side The communication with OSC Targets is bi directional You define the pairing for both Incoming and outgoing OSC data with the various parameters of your Objects on the OSC panel That s why you also find Variables on the menu that do not output values they can be remoted from the displayed OSC address Friction height light tension Atk Dec Rel Sus You mi
124. yed on the Interface If checked the current value of the Fader is displayed on the Interface In addition you can enter a formula for how the value is displayed This does not affect the actual value sent by the Fader which remains between Qand 1 This user specified text is appended at the end of the value display Use it to specify the type of value as in dB or ms Specifies the number of decimal places for the value display The default value is 3 and the maximum number is 6 This setting has no influence on the actual output of the Object You have to scale the output using expressions or on the Target side Drag the colour bar to change the background colour of the fader The cap always keeps a pink outline Properties Example This collection of General properties can be used to configure a fader that displays values in decibels where 0 dB Is considered the maximum 64 Capture Cursor Mode Physics The Lemur User Manual The resulting Fader Object looks like this ch 1 2 986dB Behavior Properties If Capture is checked an Object will only react to cursors that were created inside its area Even if the cursor later leaves the Object for another position it will remain in control of the original Object until it is destroyed eventually When Capture is off the old school way from previous versions is restored meaning an Object will react to whatever cursor is present at any moment in its area If

Lemur Monitors Jazzmutant Lemur User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents