User manual JAZZMUTANT LEMUR

The Lemur Owner's Manual Revision of 31 October 2005 © 2005 JazzMutant SAS and Cycling '74 -- All rights reserved Congratulations on your choice of the JazzMutant Lemur. This manual tells you: · · · · · Important safety information How to network your Lemur and your computer How to create interfaces for your Lemur using the JazzEditor application for Mac OS X and Windows XP How to use your Lemur to control software compatible with the Open Sound Control protocol How to use your Lemur to send MIDI messages to compatible software Before using this unit, carefully read the IMPORTANT SAFETY INFORMATION included in this manual, which provides important information concerning the proper operation of the unit. 1 To understand the features and possibilities of your new Lemur, we recommend that you read the Owner's Manual in its entirety and retain it for future reference. 2 Table of Contents Contact Information........................................................................................................ 7 For the United States and Canada................................................................................ 7 For all Other Countries................................................................................................ 7 Important Safety Information ......................................................................................... 8 What's Included in the Box?.......................................................................................... 11 Regulatory Information ................................................................................................. 12 For EU Countries ...................................................................................................... 12 For USA ................................................................................................................... 12 For Canada................................................................................................................ 12 Notes for Proper Operation .......................................................................................... 13 Power Supply ........................................................................................................... 13 Placement.................................................................................................................. 13 Maintenance.............................................................................................................. 13 Additional Precautions .............................................................................................. 14 Getting Started with the Lemur ..................................................................................... 15 Know Your Lemur .................................................................................................... 15 Lemur System Overview ........................................................................................... 16 Connect Up the Lemur.............................................................................................. 16 Lemur Networks ....................................................................................................... 17 Basic Setup Using the Lemur Settings Window ......................................................... 18 Connecting a Lemur Directly to Your Computer ....................................................... 19 Using a Lemur in a Local Area Network .................................................................... 25 Installing the JazzEditor Software ............................................................................. 26 Getting Your Lemur Connected to the JazzEditor...................................................... 27 Interfaces and Objects ................................................................................................... 31 JazzEditor Overview................................................................................................. 31 Creating Interfaces..................................................................................................... 32 Creating Objects ........................................................................................................ 33 Changing Object Properties ....................................................................................... 35 Navigating Interfaces ................................................................................................. 38 Projects......................................................................................................................... 40 Working with the Project Browser............................................................................. 40 Saving Your Project ................................................................................................... 41 More About the Lemur ­ JazzEditor Relationship .................................................... 41 Summary................................................................................................................... 46 3 Using the Lemur with Open Sound Control Applications ............................................. 48 Using the JazzEditor Settings Window...................................................................... 48 Connecting the Lemur to Max/MSP .......................................................................... 50 Understanding the Lemur's Open Sound Control Messages ...................................... 53 Controlling Max/MSP with the Lemur ...................................................................... 53 Controlling the Lemur from Max/MSP ...................................................................... 55 Lemur Object Reference ................................................................................................ 57 Guide to Object Reference Pages ............................................................................... 57 Fader............................................................................................................................. 58 Variables ................................................................................................................... 58 Dimensions ............................................................................................................... 58 General Properties..................................................................................................... 58 Properties Example ................................................................................................... 59 Behavior Properties................................................................................................... 60 OSC Data.................................................................................................................. 61 Monitor ........................................................................................................................ 62 Variables ................................................................................................................... 62 Dimensions ............................................................................................................... 62 General Properties..................................................................................................... 62 Behavior Properties................................................................................................... 62 OSC Data.................................................................................................................. 63 Multiball....................................................................................................................... 64 Variables ................................................................................................................... 64 Dimensions ............................................................................................................... 64 General Properties..................................................................................................... 64 Behavior Properties................................................................................................... 65 OSC Data.................................................................................................................. 67 MultiSlider.................................................................................................................... 68 Variables ................................................................................................................... 68 Dimensions ............................................................................................................... 68 General Properties..................................................................................................... 68 Behavior Properties................................................................................................... 68 OSC Data.................................................................................................................. 69 Pads .............................................................................................................................. 70 Variables ................................................................................................................... 70 Dimensions ............................................................................................................... 70 General Properties..................................................................................................... 70 Behavior Properties................................................................................................... 71 4 OSC Data.................................................................................................................. 72 RingArea....................................................................................................................... 73 Variables ................................................................................................................... 73 Dimensions ............................................................................................................... 73 General Properties..................................................................................................... 73 Behavior Properties................................................................................................... 73 OSC Data.................................................................................................................. 74 SignalScope ................................................................................................................... 75 Variables ................................................................................................................... 75 Dimensions ............................................................................................................... 75 General Properties..................................................................................................... 75 Behavior Properties................................................................................................... 75 Switches........................................................................................................................ 77 Variables ................................................................................................................... 77 General Properties..................................................................................................... 77 Behavior Properties................................................................................................... 78 OSC Data.................................................................................................................. 78 Variables and Expressions ............................................................................................. 79 Using Objects to Control Behavior............................................................................ 79 Scaling Output with Expressions............................................................................... 80 Using List Variables .................................................................................................. 84 Using Variables and Expressions to Display Data...................................................... 87 Advanced Expression Features...................................................................................... 90 Available Built-in Functions and Operators............................................................... 90 Local and Global Variables ........................................................................................ 90 Defining and Using Functions.................................................................................... 91 Operating on Vectors ................................................................................................ 92 Using the Time Variable ............................................................................................ 93 Using the Lemur with MIDI Applications .................................................................... 96 JazzEditor MIDI Settings ......................................................................................... 97 MIDI Mapping......................................................................................................... 97 Multiple MIDI Controllers ....................................................................................... 99 Updating the Firmware of Your Lemur........................................................................ 102 Downloading New Firmware................................................................................... 102 Connecting To Your Lemur and Updating the Firmware.......................................... 103 Index........................................................................................................................... 105 5 6 Contact Information For software updates, examples, and other supporting software, visit the JazzMutant web site at www.jazzmutant.com For the United States and Canada Cycling '74 (distributor for JazzMutant) 379A Clementina San Francisco, CA 94103 - USA + 1 (415) 974-1818 support@cycling74.com For all Other Countries JazzMutant SAS 2, allée du Doyen Georges Brus 33600 Pessac - FRANCE +33 (0)556 46 03 44 info@jazzmutant.com 7 Important Safety Information In order to prevent fire, electric shock, or injury to the user, always observe the following guidelines: · · · · Before using this unit, make sure to read the instructions below and the Owner's Manual. Do not open or modify the unit or its AC adaptor in any way. Do not attempt to repair the unit, or replace parts within it. Refer all servicing to your retailer or authorized JazzMutant distributor, as listed on the Information page. Never use or store the unit in places that are: · · · · · · · Subject to extreme temperature (e.g., direct sunlight, an enclosed vehicule, near a heating duct, on top of heat-generating equipment) Damp (e.g., baths washroom, on wet floors) Humid Exposed to rain or snow Dusty Subject to high levels of vibration Be sure to use only the AC adaptor supplied with the unit. Also, make sure the line voltage at the installation matches the input voltage specified on outside of the AC adaptor. Other AC adaptors may use a different polarity or be designed for a different voltage, so their use could result in damage, malfunction, or electric shock. Do not excessively twist or bend the power cord, nor place heavy objects on it. Doing so can damage the cord, producing severed elements and short circuits. Damaged electrical cords are fire and shock hazards! Do not allow any objects (e.g., flammable material, coins, pins) or liquid of any kind (water, soft drinks, etc.) to penetrate the unit. In the case of any of the following events, immediately switch off the unit, remove the AC adaptor from the outlet, and request service by your retailer or authorized JazzMutant distributor: · · The AC adaptor or the power-supply cord as been damaged; Smoke or unusual odours are observed; · · · 8 · · · · · · Objects have fallen into, or liquid has spilled onto the unit; The unit has been exposed to rain (or otherwise has become wet); The unit does not appear to operate normally or exhibits a marked change in performance. In households with small children, an adult should provide supervision until the child is capable of following all the rules essential for the safe operation of the unit. Protect the unit from strong impact. Do not drop it! Do not force the unit's power-supply cord to share an outlet with an unreasonable number of other devices. Be especially careful when using extension cords--the total power used by all devices you have connected to an extension chord must never exceed the cord's power rating (watts/amps). Excessive loads can cause the insulation on the cord to heat up or even melt down. The unit and the AC adaptor should be located so their location or position does not interfere with the proper ventilation of the unit. Always grasp only the output plug or the body of the AC adaptor when plugging or unplugging the unit. Any accumulation of dust between the AC adaptor and the power outlet can result in poor insulation and possibly cause a fire. Periodically wipe away such dust with a dry cloth. Also, disconnect the power plug from the outlet whenever the unit is to remain unused for an extended period of time. Try to prevent cords and cables from becoming entangled. Also, all cords and cables should be placed so they are out of the reach of children. Never step on, nor place heavy objects on the unit. Never handle the AC adaptor body, or its output plugs, with wet hands when plugging into, or unplugging from, an outlet or this unit. If you need to move the unit, make sure to have a firm grip, to protect yourself from injury and the unit from damage. Also, don't forget to disconnect all cords and cables! Before cleaning the unit, turn off the power and unplug the AC adaptor from the outlet. Whenever you suspect the possibility of lightning in your area, disconnect the AC adaptor from the outlet. · · · · · · · · · 9 · Should you remove security screws, make sure to put them in a safe place out of children's reach, so there is no chance of them being swallowed accidentally. 10 What's Included in the Box? · · · The main thing that's included, of course, is your Lemur multitouch control surface. Ethernet cable intended for direct connections between the Lemur and your computer. External power supply: switching, 100-240V, 50-60Hz AC input; 12V DC 2 Amp / 24W output. This is a fairly hefty output. Using a power supply with a lower output rating poses a serious fire hazard. CD containing the JazzEditor applications for Mac and Windows that you'll use to program the Lemur, a PDF version of this documentation, a demo of Max/MSP, and useful Max goodies for working with the Lemur. · 11 Regulatory Information For EU Countries CE This product complies with the requirements of European Directive 89/336/EEC. For USA FCC REGULATION WARNING This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communication. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct interference by one or more of the following measures: · · · · · Reorient or relocate the receiving antenna. Increase the separation between the equipment and receiver. Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. Consult the dealer or an experienced radio/TV technician for help. Unauthorized changes or modification to this system can void the user's authority to operate this equipment. For Canada NOTICE: This Class B digital apparatus meets all requirements of the Canadian Interference-Causing Equipment Regulation. AVIS: Cet appareil numérique de la classe B respecte toutes les exigences du Règlement sur le matériel brouilleur du Canada. 12 Notes for Proper Operation Power Supply · · · Do not use this unit on the same power circuit with any device that generates line noise (such as an electric motor or variable lightning system). The AC adaptor will generate heat after long hours of continuous use. This is normal and should not cause any alarm. Before connecting the unit to other devices, turn off the power to all units. This will help prevent malfunctions and/or damage to speakers or other devices. Placement · Using the unit near power amplifiers (or other equipment containing large power transformers) may induce "hum". To alleviate this problem, change the orientation of this unit, or move it farther away from the source of interference. This device may interfere with radio and television reception. Do not use this device in the vincinity of such receivers. Noise may be produced if wireless communications devices, such as cell phones, are operated in the vicinity of this unit. Such noise could occur when receiving or initiating a call, or while conversing. Should you experience such problems, try relocating the wireless devices so that they are further from this LEMUR, or switch them off. Do not expose the unit to direct sunlight, place it near devices that radiate heat, leave it inside an enclosed vehicle, or otherwise subject it to temperature extremes. When moved from one location to another where there is a major change in temperature and/or humidity, water droplets (condensation) may form inside the unit. Damage or malfunction may result if you attempt to use the unit in this condition. Therefore, before using the unit, you must leave it idle for several hours until the condensation has completely evaporated. · · · · Maintenance · 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 mild, non- 13 abrasive detergent. Afterwards, be sure to wipe the unit thoroughly with a soft, dry cloth. · Never use benzine, thinners, alcohol or solvents of any kind; such chemical may cause discoloration and/or deformation. Additional Precautions · · · 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 damage to the cable's internal elements. When transporting the unit, please ensure it is properly packed to protect it from shock and damage, using, for example, a sturdy laptop case (15" or 17" should fit). Place an additional protective layer over the display. Use the Ethernet cable supplied with the unit. If using some other cable, please ensure it is not a crossover Ethernet cable. · · 14 Getting Started with the Lemur Know Your Lemur The top of the Lemur includes a touchscreen and four buttons. · · · The Settings button displays the current Lemur network configuration and software version. The Interface List button displays a gallery of thumbnails corresponding to each interface currently stored on the unit. Touch the desired interface to display it. The two Navigation buttons allow you to move forward and backward among the interfaces currently stored on the unit. 15 The rear panel of the Lemur houses the power switch, power input jack, and Ethernet jack with status lights. Lemur System Overview To use the Lemur you will need · an network connection from the LEMUR to a computer (running Mac OS X 10.2 or later, or Windows XP). If you are connecting the Lemur directly to your computer, please use the Ethernet cable supplied in your Lemur box. You can also connect the LEMUR to your computer's network using routers and/or switches. See the Lemur Networks section below for details. · · the JazzEditor software, which lets you create interfaces consisting of graphic objects on your computer and store them in the LEMUR a software application compatible with the OpenSoundControl protocol, such as Max/MSP from Cycling '74 or Reaktor from Native Instruments, or a MIDIcompatible software application We'll take you step by step through the process of getting your LEMUR up and running. Please follow these instructions closely, especially if you are not experienced with computer networking concepts. Connect Up the Lemur · Plug in the Lemur using its supplied AC adaptor. 16 · Turn on the power switch on the back of the Lemur. You should see the four buttons on the top of the unit light up. After the startup sequence has finished, a yellow Lemur should be visible on the screen. If you don't see the yellow Lemur but you are sure the unit is turned on and plugged in, the unit may be malfunctioning. Please contact your JazzMutant retailer or distributor for technical support and/or repair service. Lemur Networks The Lemur uses an Ethernet-based network to communicate with your computer. This allows it to be connected directly to your computer with a single Ethernet cable, or placed on a local area network. So, first, you have to decide how you want to connect. You may want to use a local area network if any of the following are true: 17 · · · You use your computer's Ethernet port to connect to the internet, and you want to stay connected while you use your Lemur. You use a wireless connection to the internet with a wireless router, and you would like to access your Lemur wirelessly by connecting it to your router. You have several Lemur devices you would like to use to control your computer at the same time (lucky you!). You may want to connect your Lemur directly to you computer with a single cable if any of the following are true: · · 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) You are looking for the simplest possible configuration for live performance First, we'll discuss the Lemur Settings Window where you can setup the Lemur side of your configuration. Then we'll discuss how to configure your Lemur in the direct connection and router scenarios. Basic Setup Using the Lemur Settings Window · Press the Settings button on top of the Lemur. You'll see the following screen, although the details will be different for your setup. 18 · To check if you've successfully connected your Lemur to your computer or a router, check the Media display near the bottom of the screen. If connected, it will report the speed of the connection (in the screen shown, it is 10 Megabits per second). If there is a problem, the Media will be displayed as Disconnected. To use a fixed IP address to the Lemur (useful when you are connecting directly to the computer), touch the words Static IP. To use DHCP to assign the IP address automatically (best when using a router), touch Automatic using DHCP. · The current IP address is displayed to the right of the word IP. If DHCP is assigned and the unit is trying to find a DHCP server, the words Seeking DHCP will be displayed (as shown below). It is useful to keep the Lemur Settings Window open while configuring and troubleshooting your network connection. Connecting a Lemur Directly to Your Computer First, we'll configure the Lemur to use a fixed IP address. The instructions for doing this will be the same whether you're using a Mac or a Windows machine. · Turn on your Lemur and connect the Ethernet cable supplied with your Lemur to the Ethernet jack on the back of the unit. Then connect the other end of the cable to your computer's Ethernet jack. Check the Settings Window on the Lemur. If your computer is turned on and connected, the Media display should report the connection speed. If it says Disconnected, make sure your computer is turned on, then check the cable and connections. We'll configure the Lemur to use a fixed IP address. Touch the words Static IP and touch the Apply button at the bottom of the screen. Next, drag your finger over the IP address value. Use the "keypad" at the right of the screen to enter an IP address. If you don't need to use a particular address, use 169.254.0.2. Ensure that the NetMask is 255.255.255.0 (touch the NetMask value and use the keypad if it's necessary to change the current value). For Gateway, enter 0.0.0.0. 19 · · · · · Once you're finished, touch the Apply button. Your setting should look similar to this: Now you will need to configure your computer's network settings to work with this address as follows. First we'll talk about how to do this on Mac OS X, then on Windows XP. Mac OS X Direct Configuration These settings only apply to connecting your computer to your Lemur directly with a single Ethernet cable. For other configurations (which we recommend if you use a router), see the section below entitled Using a Lemur in a Local Area Network. · · Open the Network Preferences panel by choosing Location -> Network Preferences... from the Apple menu. Once the Network Preferences window appears, choose Built-in Ethernet from the Show menu. If Built-in Ethernet does not appear in the menu, choose Network Port Configurations from the Show menu, and make sure Built-in Ethernet is checked. If it is already checked, ensure that the cable is connected and the Lemur is turned on. We will only need to be concerned with the TCP/IP settings, which appear by default. You have two options for these changing these settings. 20