From Livid Wiki

Introduction

Welcome to Livid Cell and DNA

Livid Cell is the easiest way to create and perform real-time video on your laptop or desktop computer. Cell is designed for immediate playback and sampling of media files with an easy-to-use interface, easy image control and captions, and a sophisticated video engine for demanding performances. DNA adds a variety of powerful and easy to use effects to Cell, for expressive video performance. If there are any suggestions you have to help us enhance your experience with Cell, please drop by the Livid Support forums at http://blog.lividinstruments.com/forum/ and let us know.

System Requirements

Cell is designed for real-time media playback and manipulation. In general the more video memory and processing speed you have the better Cell will function. While we cannot support all computers and video cards, we have done our best to support a wide range of operating systems and dedicated video cards. We urge you to try the Cell Demo to determine how the program performs on your computer. Below is a list of the minimum requirements to run Cell. While we specify “minimum”, for best performance and recommended systems, please refer to the Livid Support Forums.

For live performance situations, we recommend you turn off all other applications and processes before running Cell including networks, anti-virus programs, and system applications.

Minimum Requirements

Macintosh

Macintosh (PowerPC or Intel) 1Ghz+
OS X 10.4.11 or above
Video card that supports dual displays and OpenGL 1.4+
2 GB of RAM
Quicktime 7.1+

Windows

1GHz Processor (2GHz+ recommended)
Windows XP SP3, Vista, or Windows 7
QuickTime 7.1+
Video card that supports OpenGL 1.4+, dual displays *
2 GB RAM
Java Runtime (installed from http://www.java.com)

Preferred System

Processor 2ghz or faster
2 GB RAM
Dedicated video card with 256GB of video RAM
Dedicated hard drives for media files

Known Issue

There is a problem on the windows version with unicode characters (characters with accents or diacritical marks) in the username (or anywhere in the pathname) can cause a freeze on startup. You'll need to make sure that there are no unicode characters in the paths to the video files or preferences. For example the character ü can cause a problem:
C:\Benutzer\lülz\AppData\Roaming
would need to be changed to
C:\Benutzer\lulz\AppData\Roaming
The fix for this is non-trivial and will take some time. However, the workaround is simple.

Installation and Authorization Procedure

To protect our software from piracy, Cell is protected with an anti-piracy registration system. We have made the registration system as simple as possible to ensure ease-of-use, while giving us the protection we need to continue developing quality applications. If you have any problems registering the software, please contact us through our support form.

Installing Cell

If Cell is not authorized, it will run in demo mode, allowing you to thoroughly test the software on your system. Demo mode has all the functionality of the purchased software but has a watermark over the output and limited full-screen output time. By proceeding with the registration with your serial number, the watermark will be removed.

Installation Instructions

Install Cell from an installation disc or if you have purchased Cell from our online store, download the installer from http://www.lividinstruments.com/support_downloads.php.
 Double-click on the INSTALL CELL application.  
Follow installer instructions 
After the installer finishes, quit installer and Cell will be located in a folder in your Applications folder (Macintosh) or Start folder (Windows)

Macintosh only: We strongly advise that you do not move the Cell.app or CellDNA.app file out of its folder into the Applications folder. It will start up much more slowly.

Running Cell

Locate the “Livid Cell” folder in your Applications or Programs folder
Double-click on the Cell icon to start the application
When the programs starts, sample videos (located in the "CellMedia" folder) will load to get you started. If you have imported your own media files, Cell will open with your files and retain all your settings.

Authorizing Full Version

Open the Cell installer by inserting the disc or downloading the full version from http://www.lividinstruments.com/support_downloads.php. Confirm that you have a connection to the Internet.
Run the “Install Livid Cell” File
Locate the Livid Cell folder in your Applications or program folders.
Open the Cell application. A dialog box will ask you to Register.
Click the Register button. This will take you to our online registration form.
Fill in your name, email address and serial number that can be found in your online receipt or on the CD install disc. *note- please use your current email address as your authorization number will also be sent to you via email for your records. We do not sell or share these emails with anyone, and will only be used, if at all, to notify you of a new version of Cell.
If all of the information from Step 6 is correct, press NEXT. You will then receive your Authorization Key number. Copy this number and past it in the Authorization window in the Cell registration window. This number will also be emailed to the address you supplied for your records. Please keep this number in a safe place, as you may need it in the future if you decide to reinstall it on the SAME computer with a new operating system. This number will only work on the computer you installed the application on. The license allows you to install Cell on three personal computers. Each computer will need a unique Authorization Key number and will need to follow all the steps above.

Authorization FAQ

Can I Install Cell on more then one of my computers?
The license you purchase for Cell allows you to run Cell on one computer at a time. We understand however that many of our users may have multiple computers such as studio desktop and performance laptop, or frequently upgrade their computers so we allow you to register it on three computers. If you need additional registrations you can fill out the request on the registration page requesting additional authorizations.

I registered Cell and received my authorization key, but it doesn’t work on my new laptop.
Each computer with a full installation of Cell will need a unique Authorization Key. This means you will need to register each computer by clicking on the "Register" button after you install it on your computer and follow the authorization instruction. To receive the proper key for your computer you will need to complete the entire registration process. The Authorization Key that you will receive will only work on the computer you registered it with.

My computer that I want to register isn't on the internet. How can I register?
The authorization is machine-specific, so the registration process is best performed on the machine you intend to register. However, since you don't have internet on this computer, you will have to workaround this issue. Start Cell on the machine you want run it on. Press Register. The browser will open, but obviously won't connect. Copy and paste the very long url and save it to a file on a removable disk. Transfer that url to another computer on the internet and enter it into a browser. Complete the registration process and generate an Authorization Key. Copy the Authorization Key to a file and transfer it to the computer you started with.

Getting Started

This chapter will get you started with Cell and introduce you to some of its basic concepts. We recommend reading this chapter even if you are familiar with other VJ applications to give you a better understanding of the unique features of Cell.

Quick Start Guide

Starting Cell for the first time

When you first open Cell, the program checks to see if it has ever been used. It does this by looking for the preferences folder (see Preferences Storage). If it is found, Cell assumes that the program is running for the first time and will copy its default settings and controller templates to the preferences. Once the defaults have copied and loaded, you will notice the 8x8 grid of 64 video clips in the “Clip Bank”. The Clip Bank is the area of the software interface that contains your video clips and their previews for quick triggering, playback, sequencing, and editing. The clips you first see are included with the program and provide immediate access to the functions and features of Cell.

Selecting a Video Clip

There are three ways to trigger a video clip in Cell.

Use your mouse to click on individual clips starting playback and display on the Output and Preview windows.
Press the QWERTY keys on your computer’s keyboard to select clips within a Clip Bank row. If you go to the Preferences/MIDI&Key, you can enable your computer keyboard default mapping. Use the keys "qwertyui" to change clips on a row, and use the 1-8 number keys to change the active row. You can also create your own, custom mapping.
Use a MIDI device such as a keyboard, generic MIDI controller, or a Livid controller for a more hands-on approach to presenting live video.

You can also direct a clip selection to either the A or B layer. See #F. Crossfader and Layer Controls

All of Livid’s software products can be completely controlled with MIDI devices, and we urge you to utilize a MIDI device for a more expressive video performance. For more info on MIDI, please visit the MIDI section of the manual.

For additional video clips please visit the Refills store at http://lividshop.com/clips.html, easily reached from the "Refills" link in the top Application menu.

Adding Effects

Cell DNA has over four dozen effects that can be mapped to the knob controls. Simply select an effect from the knob’s popup menu, and turn the knob to activate it. Many effects, depending on their style, can be blended with other effects by leaving the knob only partially turned. If you change the effect assignment of a knob when the knob is turned up, the previous effect will turn off, and the new effect will take its place, using the value of the knob.

Sets of knob assignments can be stored as Effect Presets. You can create up to 32 different sets.

If eight knobs is not enough, you can use the “More Effects” window, accessed in the Extras menu. These provide additional assignable knobs, as well as fixed controls for Contrast, Saturation, Brightness, Speed control, Volume, and Scrub.

Adjusting the Playback

Use Cell’s movie controls to change the direction, speed, loop method and image quality of your videos. Pause and play, slow or fast playback, reverse or forward play, loop on or off, and brightness, contrast, and saturation controls are provided. Advanced settings for these controls can be changed in the preferences.

Transitions

There are two ways to transition from one clip to another when a clip is triggered: "crossfade" or "cut," and a third "split" for a different presentation style. The default setting is "crossfade" - press the button to change to "cut" mode. The speed of the transition can also be set to a custom time in the General preferences pane. The "split" option is not a transition, but an alternative to crossfade or cut. In split mode, the A and B channels are displayed side by side, and the crossfader is disabled. Triggering clips in the grid works the same as in crossfade mode: the clips alternate placement on A and B. Using the A/B buttons, however, you can force the clip to display on the left or right side of the screen. Now that you understand the very basic functionality of Cell, we urge you to read the rest of the manual, and experiment with Cell to discover and understand all of its features and functions.

Quick Help

Cell has a section of the interface called “Quick Help” that will give you basic information about the program and its features while mousing over certain sections of the interface. This information will be displayed directly under Cell logo on the top right of the screen and can be activated by moving your mouse around the interface.

About MIDI

Cell may be controlled with your computer keyboard, track-pad and/or mouse. To get the most out of Cell as a “performance” product however, we urge you to try a MIDI device for playback and manipulation. Almost everything you can control with your mouse in Cell can be mapped to a MIDI device for a more expressive performance. You can control the triggering of clips, turning effects on and off, scrubbing the video playback, switching clip banks, and controlling the output.

MIDI Setup

Cell and CellDNA support up to five different MIDI controllers that can control a massive variety of functions in the program. There is also a "template" option that provides automatic mapping between a controller and Cell and special input and output communication to different controllers, including Livid's own OhmRGB, Ohm64, Code, and block controllers. To set up your MIDI input you will need to refer to your MIDI device manuals and have the proper installers. Most MIDI devices either have a built in USB port or require a MIDI to USB interface. Once you have the proper MIDI device and/or interface installed and connected, start Cell.

Make sure your MIDI device and/or interface is connected to the proper USB port on your computer.
Connect the MIDI OUT on your device and/or Livid Controller to send MIDI messages to Cell.
1. OSX: Macintosh OS X has a built in MIDI application called Audio MIDI Setup that gives complete control over your MIDI devices. To locate this application go to Applications/Utilities and click on Audio MIDI Setup. Find your device in the MIDI setup. Please refer the manuals that came with your MIDI device. You may also need to install drivers depending on the device you are using. Only for the more advanced setups would you likely need to visit this application.
2. WINDOWS: Depending on your MIDI device you may have to install hardware drivers for your device. Generally when you connect a new device through a USB MIDI interface it will be recognized by the operating system and prompt you to install the drivers. Please refer the manuals that came with you MIDI device.
To see if Cell recognizes your device, open up the Preferences window and select the MIDI tab. MIDI notes, controllers, and values will be visible in the MIDI Spy section if your system is properly configured.

For complete MIDI settings please refer to the Advanced MIDI section.

To Select a MIDI Device in Cell

Select Preferences from the Configure menu, and click on the MIDI tab.
Select your MIDI input from one of the five port menus

Enable the "in" button for the port. If the device listens to MIDI for interface feedback, then enable the "out" button.

To Select a MIDI template in the MIDI preferences

Select a template file: Cell will search for the device that matches the template on all MIDI ports
Enable the template: If the template is designed to send MIDI to the controller, it will update the interface to sync with the current states of Cell.

If your MIDI device is not in the not listed in the MIDI port list, you may need to:

check your AudioMIDI setup
check your USB connections
press the “refresh” buttons
restart Cell

MIDI Templates

Several popular controllers have had templates created to automatically map the controllers to CellDNA, as well as provide advanced interface feedback. These templates are simply JSON files that describe the controller and the input and output maps for MIDI. They can be modified with a text editor program. The template files are stored in the same folder as other settings files (see Preferences Storage, in a folder called "Controllers."

MIDI & Keyboard Learn

MIDI Learn mode makes it easy to assign computer keyboard keys and/or MIDI notes, controller, program changes, or pitch bend to most of Cell's features. Press the MIDI learn button in the main interface to put the software into “listen” mode and allow you to assign MIDI for remote control. While in learn mode, all MIDI-controllable functions are tinted green, and if already assigned a MIDI value, the number will be shown. To assign, click on a control (it will be surrounded by a yellow rectangle), and then send a note, control, pitchbend, or program change to assign it to that control. The number assigned is then displayed. The color of the text will match the color of the menu in the MIDI Preferences window. Continue in this manner until you are finished assigning. Click MIDI Learn button again to turn learn mode off.

In CellDNA, you'll find that many of the Extras are also MIDI mappable - just open the Extras window, select an extra that you want to control with MIDI, and then match parameters with MIDI controls. You'll notice that the button tabs will be half highlighted, too. You can use MIDI to control the tabs, but half of the buttons are left exposed so you can change the view and learn parameters for different Extras.

For more advanced mapping please refer to the Advanced MIDI section.

For more about working with the Livid Ohm64 and block controllers in CellDNA, see here

Using Media Files

To get the most of out Cell, it is important that you prepare your media files. Cell is designed to use QuickTime files including images, audio and video files. In general, Cell can play any file type that QuickTime does. This includes QuickTime movies, DV movies, mp4s, gif, jpeg, bmp, pict, png, flash and shockwave, and audio formats such as aiff, wav, and mp3. Flash movies will play as bitmaps, not vectors, and there is no support for programmed interactivity. Playback and performance will depend on your computer speed and the types of files you are using, this is why it is important to prepare your files before using them in Cell.

Resolutions

Cell supports all video resolutions, however higher resolutions will affect your frame rate and performance. Depending on your cpu speed and output specifications, you may want to test different resolutions and codecs to find out the best combination for you. For live performance, lower resolutions will give you more compositing flexibility with higher frame rates, while higher resolutions can be utilized for simple playback.

Preparing Content

For optimal results we strongly suggest preparing your media in the following video formats and codecs.

Video

PhotoJPEG Given all that flexibility, your best frame rates will occur with movies compressed with a codec that requires little calculation for decompression. PhotoJPEG has become the most common codec used for VJ performance due to its fast decompression and low data rates. MJPEG MJPEG codec is also a good option, and is preferred if converting clips with video interlacing.

DV DV is the standard video codec for editing applications such as Final Cut Pro and iMovie. Although it is not the most efficient codec choice, it is often convenient, since any clips captured from a DV camera will be in this format. Although Cell can playback DV files quite well, its slow decompression rate is CPU intensive and is generally not recommended for extremely responsive triggering or speed changes is needed.

Sorenson and Cinepak When disk space is a priority, Sorenson or Cinepak may be suitable for playback. While the high compression of these files may take up less disk space, it is good to note that it will require more processor speed to play these files back.

Audio

MP3 For Audio files MP3 is the most widely available format and it is suitable for playback in Cell.

Uncompressed Audio If you plan on playing video files with audio embedded in the .mov file, “uncompressed” is the best setting for your audio.

Images

JPEG JPEG is the best setting for images for playback in Cell. If you plan on using image files within Cell you may need to adjust the size or aspect ratio as Cell will stretch your file to fit the aspect ratio that the application is set to. For example if you have your second monitor output set to 640x480, you will need to adjust your images files to a 4:3 aspect ratio to display properly in your output window. Other image formats will work with varying degree. Some image formats, such as PNG, do not work at all unless Slide Show mode is enabled in the General Preferences.

Codecs Not Recommended

Codecs that use temporal compression such as MPEG, MPEG2, or MPEG4 are not recommended for use in Cell. These codec’s are CPU intensive and lossy, making it bad for playback adjustment, scratching, effects, and overall display quality. However, for simple clip playback, these codecs can be used.

To prepare your clips for playback you should use a compression program such as Media Cleaner, QuickTime Pro, MPEG Streamclip or Apple's Compressor (search the internet for more information about these products). Livid also provides a basic batch compression utility called “Batch Export Utility” to re-compress all of your QuickTime video files at once.

Saving States

When you add to or organize Clip Banks, change MIDI settings, or change Preferences, Cell saves this data as part of the software as its current “state”. This state - all of the settings that you have modified or media files you have added - will reappear every time you open the software. This makes it easy to recall your files and setting each time you use Cell. You can change the settings at anytime, and also “archive” a current state (see Saving).

MIDI Template Descriptions

When using the MIDI Templates feature, Cell automatically detects and maps to Livid's OhmRGB, Code, Ohm64, and Block controllers, and Akai's APC40 and APC20 controllers. This provides instant, hands-on control of your media files, and advanced LED feedback coloring on these devices. Be sure that your controller is first plugged into USB, then startup Cell. Cell will find the controller on the USB port and automatically map the hardware to the software, requiring no effort to use learn mode to map the controls. The maps are as follows. Larger versions of these graphics, for easy reference, are located in the Manuals folder of CellDNA:

CellDNA Templates

block

Code

Ohm64 & RGB

APC20

APC40

Cell Templates

block

Code

Ohm64 & RGB

Cell ohm64 midi map

APC20

APC40

Cell APC40 midi map

More information about the Livid controllers can be found on our website: http://www.lividinstruments.com/hardware_block.php http://www.lividinstruments.com/hardware_ohm64.php http://www.lividinstruments.com/hardware_code.php

Templates Formats and editing

This section can be skipped by the casual reader and user - it is fairly boring and technical, and only of interest if you want to customize or create your own MIDI templates. The templates are in JSON format, and can be edited with a text editor, or with a JSON editor. A JSON editor is recommended, as it is very easy to mess up the commas, brackets, and spacing and render the file useless. Search the internet for a JSON editor that works on your system. If you want to create a template for a controller, the best way is to simply use MIDI learn to latch MIDI messages to controls in Cell, then customize the resulting "MIDI_settings_01.json" file as desired. You can find this file in the Settings folder in the Preferences Storage.

That said, it's still important to document the details! There are 3 nodes to the template: "ID", "translate", and "messages." The ID node provides MIDI sysex strings that can be used to identify the controller, and automatically detect it on the computer's MIDI system. The "translate" node provides MIDI values to match with messages to control the program, and, inversely, the "messages" from Cell to match with MIDI messages to send out to the controller, if needed.

ID

The ID node has 4 elements.

name - the name of the controller, such as "Livid OhmRGB"
response - the sysex string that the controller will send out that CellDNA will look for to know the controller exists.
setup- any sysex data that needs to setup the controller. For example, the Livid templates send a sysex message to reset the controller to factory default settings.
cleanup- any sysex message that should be sent when closing CellDNA, such as "all notes off".

translate

The translate node consists of MIDI "keys" to look for from the controller to translate into messages that Cell will understand. These keys are created from MIDI status and data bytes by bitwise union (|) and rotation(<<). In other words,

key = status byte | data byte<<8

and, inversely,

status byte = key & 255
data byte = (key>>8) & 255

Perhaps this is more than you would like to know, but it explains how a key of "16784" corresponds note 65 on channel 1. Every key has properties that describe the nature of the message the MIDI is latched to. One of the most important properties is the "btype" which describes the type of control:

0: continuous controller, like a slider or knob
1: momentary button
2: toggle
3: message only (not used)
4: matrix (used for clip grid)

For example, in the Livid OhmRGB script:

              "16784": {
			"mess": "PlayPause",
			"rmin": 0,
			"rmax": 1,
			"btype": 2,
			"tog": true,
			"bval": false,
			"btnchange": false
		},

Means that the key 16784 (note 65, ch 1) will activate the PlayPause message to Cell. The important properties are the "mess" (message), "rmin" and "rmax" (range min and max), the "btype" (button type), and "tog" (toggle). The Play/Pause button in Cell is a toggle, with values ranging from 0 to 1. (There is redundancy in this: the "btype": 2 indicates that it is a toggle, but the "tog": true flag must also be set). A momentary button type is used for the FadeIn command:

              "18320": {
			"mess": "Mix::FadeIn",
			"rmin": 0,
			"rmax": 1,
			"btype": 1,
			"tog": false,
			"pcount": 0,
			"bval": false,
			"btnchange": false
		},

Another example for the first effect knob:

               "6064": {
			"mess": "EffectsMix::Effect[1]",
			"rmin": 0,
			"rmax": 1,
			"value": [
				0
			]
		},

The key "6064" is CC 23 on channel 1 - the far left fader on the Ohm64 and RGB. The MIDI values will be scaled from 0-127 to 0. to 1. and change the value of the effect knob. In this case btype can remain undeclared, since it is 0, which means it is a continuous controller (a knob or lever).

The Clips are handled a bit differently. Because only one clip in the grid is active at a time in a group of buttons, this is a "matrix" type (indicated by btype: 4):

             "144": {
			"mess": ["Clip",0],
			"rmin": 0,
			"rmax": 127,
			"btype": 4,
			"tog": false,
			"bval": false,
			"btnchange": false
		},

The key "144" is note 0 on channel 1. The message is "Clip" with a value of 0 (the top left clip in the grid). Ranges are default values of 0 to 127.

Ultimately, if you unsure (or even if you are really confident) on how to format the properties of a key or turn a MIDI message into a Key, you can simply use MIDI Learn to latch a MIDI message to a parameter in Cell, and then look at the MIDI_settings_01.json file in the Settings folder (Preferences Storage).

messages

For every item in translate, there needs to be a corresponding message. This makes it easy for Cell to keep your MIDI device and Cell interface in sync, as well as provide any updates for the MIDI device's interface. The messages are generally much simpler than the keys in translate. For example

               "PlayPause": {
			"key": 16784
		},

This means that when the PlayPause button is activated (by mouse, keyboard, MIDI device, network, or...), CellDNA will send out note 65 on channel 1 (corresponds to key 16784), along with the relevant value. For the OhmRGB, this means if PlayPause is turned on, it will send a note to the controller that will turn on the LED for note 65 (the far left slider button).

You may also see something like this in a template:

              "Extras::More_Controls::Effect[1]": {
			"key": 5040,
			"nomidiout": true
		},

The "nomidiout":true option means that Cell won't send any midi out to the controller. In this case, it's not really necessary, since the message is latched to a slider on the OhmRGB, so trying to update its value is meaningless. It won't hurt to send the CC, but there's no sense in clogging the MIDI stream with unnecessary data.

Things are a bit more complex with the "Clip" messages, since these are a matrix type. The matrix is assigned the message "Clip" which has up to 64 different values. As a result, you'll see the values nested within the brackets for "Clip", along with the extra item "matrix":true:

        "Clip": {
			"matrix": true,
			"0": {
				"key": 144
			},
			"1": {
				"key": 2192
			},

and so on, until the last item in the matrix

                      "63": {
				"key": 16272
				}
			}

Finally, there are some template options that allow for more exciting LED control on the OhmRGB (and other controllers like the Akai APC40 and APC20). For example, in the OhmRGB script, you'll see in the "Clip" message the "ctlUI" parameter, which provides some different options for the Clips for coloring the LEDs on the controller:

                       "0": {
				"key": 144,
				"ctlUI": {
					"option": 0,
					"0": {
						"optionname": "empty",
						"min": 0,
						"max": 4
					},
					"1": {
						"optionname": "populated",
						"min": 1,
						"max": 127
					}
				}
			},

The "ctlUI" property lets you use different velocity values for the different scenarios for Clip buttons. For empty items in the Clip Bank, the velocity value 0 is sent out to turn off the LED, and if the button is pressed, velocity value 4 is sent to turn the LED cyan color. If there is a Clip in the clip bank, then the velocity value of 1 is sent to the LED to turn it white, and when a clip is triggered, it will turn the LED green with a velocity of 127. The "optionname" property is, well, optional, and just makes the template a bit easier to edit and read.

If you wanted to make this work for the PlayPause button, for example, you could change the message element of PlayPause to light the LED red instead of the default blue:

              "PlayPause": {
			"key": 16784
			"ctlUI": {
				"option": 0,
				"0": {
					"optionname": "play",
					"min": 0,
					"max": 16
				}
			}
		},

Once you have finished writing or editing the template file, you can put it in the Controllers folder in the Preferences Storage.

Using the Software

The Interface

Cell (non DNA) effects:

A The Clip Bank
B Bank Controls
C File Browser
D Movie Controls
E Preview Window
F Crossfader and Layer Controls (DNA only)
G Function Buttons
H Effects (DNA only)
I Extended Interface tabs
J Database Entry

A. The Clip Bank

The Clip Bank is an interactive visual database of all the clips used in the program. There are 64 cells (or clips) in each Clip Bank. Clips can be played back using the mouse, QWERTY keys, and can be assigned to a MIDI controller. There are 32 Clip Banks available in Cell that can be changed using the Clip Bank selector buttons.

The Clip Bank is configured to trigger clips from your computer’s keyboard. In the MIDI & Keys preference panel, you can turn on the default keyboard map to use the QWERTYUI keys to trigger the clips horizontally and use the “12345678” keys to move up and down rows within the Clip Bank. You can also use "Learn" mode to assign keyboard keys to parameters in the same way MIDI can be assigned to controls.  For adding files to the clip bank see File Browser.

B. Bank Controls

Bank Selection

The Clip Bank can be changed with the Clip Bank selection menu or the left-right arrow buttons. The left/right buttons are MIDI and keyboard assignable.

Trigger/ Edit Mode

Use the Trigger/Edit button to put the Clip Bank in either Trigger or Edit mode. In Trigger mode, you can select or “trigger” the clips instantly by clicking directly on the cell. The orange indicator around the cell indicated the clip currently selected, while the blue indicator shows the active (or “hover state”) of the clip you are about to select. When in Edit mode you can move the clips to different cells within the Clip Bank. To move a clip simple click and drag on the cell you want to move, and drag it to a new location. If you drag a clip to a cell occupied by another clip, the clips will “shift” or move the to right to accommodate the new clip.

Sequence

The sequence button turns on the sequencer within Cell. When Sequence is on, the clips will play sequentially, starting from the currently playing clip. Note that when you change clip banks, the sequencer will start from the current location in the currently selected bank.

Crossfade/Cut/Split Mode

The Crossfade button allows to you to put Cell in either crossfade, cut or split mode. When highlighted blue, Cell is in crossfade mode. Clicking from clip to clip will crossfade the video (and/or audio) files. You can specify the length of the crossfade in the general preferences. In cut mode, your files will simply cut from one file to the next. In both cut and crossfade modes, if the crossfader is away from the far left or far right, the automatic cut or crossfade is canceled, leaving the blend intact. In split mode, the crossfader is disabled, and the clips are displayed side-by-side.

Clearing a Clip Bank

You can clear all clips from the Clip Bank by selecting Options>Clear Clip Bank from the top menu. This will clear all the clips from the currently selected bank.

C. File Browser (Loading the Clip Bank with media)

The File Browser consists of two main areas, the File Browser and Favorites. Use the File Browser to navigate your hard drive(s) and folders, and select files and/or folder to populate the Clip Bank. Use the Browse button to select folders and drives from your computer. Click the folder with up arrow icon to go up a directory. You can also double click on a file to preview playback in a popup window; additionally the small window next to the browse button will show you a thumbnail of clip. Click on th emain interface to close the small preview window.

Loading individual files from the browser

Select your files from the browser
Click on the filename to preview the clip
Drag the clip into the desired cell in the Clip Bank

Loading entire folders from the browser

Select folder in the File Browser
Drag the folder onto the desired starting cell in the Clip Bank
Use MIDI learn to set the Clip Bank cells to a MIDI note or controller.

D. Movie Controls

The Movie Controls give you control of the currently playing media file. In the top area of the Movie Controls, your current media file’s information is displayed. Information includes the filename, duration, and time remaining. Use the playback controls to play/pause, reverse, loop or play once, slow speed, and fast speed. You can adjust the default speed for fast and slow in the General Settings in Preferences. Use the playback head knob to scrub the file or jump to a new time in the file. Note that image files have default duration of five seconds for use in the sequencer. You can change the settings for stills in the General Setting in Preferences.

The Crossfader will let you mix the current video with the previously played video for blending and quick cuts.

E. Preview Window

The preview window will show you the output in real-time. If you are using an audio file, a Livid logo will be displayed (this can be changed by opening the Mac OS X .app package Contents folder or the support folder in Windows XP, and changing defaultlogo.jpg).
E1 - a still frame representing the content on Layer A.
E2 - a still frame representing the content on Layer B.

F. Crossfader and Layer Controls

The Crossfader gives you blending control over two layers of video. If the Crossfader is nearly full left or right, then it will move to the opposite side when a new clip is selected. If the “A” button is turned on, then all clip selections will be directed to Layer A, and the Crossfader will remain in its current position. If the “B” button is turned on, then all clip selections will go to the B Layer, and the Crossfader is unaffected. This allows you to select a movie to play on a "hidden" layer, and crossfade manually when you want to fade it. When the crossfader is controlled by MIDI, the crossfader will not move until the MIDI value is near the current value of the on-screen crossfader. This keeps the blend from “jumping” when the crossfader and MIDI controller are out of sync.

G. Functions Buttons

Function Buttons can be used for immediate access to essential functions within Cell. Press "Full screen" to present your video output on a second display (or the display specified in Display Preferences).
Use the MIDI learn button to activate MIDI (and keyboard) learn mode and assign functions to a MIDI device or your computer keyboard.
Use the "video in" button to activate a video input, such as a DV camera (this is specified in the Video Input Preferences). When video in is activated you can use the image controls and effects to change the look of the video input. Pressing "video in" again, or triggering a video clip from the bank, will deactivate the video feed. Use the "extras" button to open the extras panel and work with many of the extended functions in CellDNA.

H. Effects

CellDNA comes with dozens of openGL-based effects to stylize your video clips. Multiple effects may be active at a time, though depending on the settings and the amount of the knob , you may not see all the results of all effects. Use the knob’s menu to choose an effect that you can activate with the knob. If you select a new effect, or change the effect preset while an effect knob is turned to a value greater than 0, the new effect will not be active until you change the value of the effect's knob.

Instead of effects, Cell simplifies video mixing on presentation, and offers basic image controls in Bright, Contrast, and Saturation, and a master Volume control. Additionally, to allow for lyrics, public messages, or captions, there is an interface for providing text on top of any video or image displayed.

For details on effects, see Effect Details.

I. Extended Interface

These buttons will provide additional controls, viewable below. The default is the Browser.

Database

The database provides an interface to search for clips and populate your Clip Bank with clips that meet search criteria or matching tags. See the Database section for more details

Previews

Press "Previews" and you will see two viewers for the A and B channel. You can press the "play" buttons to animate the previews, or leave them off to conserve CPU. These provide, name, time, and duration information as well as a larger preview for the clips on A and B.

Captions

On CellDNA, press "Captions" to get an extended control panel for the captions effect. You can control caption opacity with Effects Knobs, but in this interface, you can also control color, placement, animation, typeface, and more. There are also controls for loading a text file and advancing line-by-line through the text file. This is great for lyrics or extended messages to your audience.

There are also a couple of other interesting effects. The "3d animate" effect will make a 3D version of the caption, and randomly rotate it to the BPM tempo in 3D space. The "wireframe" effect will render the letters as wireframes, rather than solid. This can be used in conjunction with the 3D animation effect.

Preferences

Cell’s preferences are located in a preference panel that can be accessed from the Configure>Preferences menu.

General

General preferences provide control over movies setting, the default full screen and the default folder for the File Browser.

Movie Settings

In the Movie settings panel you can set the speed of the crossfade, the fast and slow speeds in the movie module, the duration that stills appear during a sequence, limit the overall fps and set the master volume for the software.

File Browser default folder

Use the File Browser default media folder section to specify the default folder that will appear when you first set the program. This is useful if you have a dedicated drive or folder where you store your media.

Slide Display Mode (YUV/RGB)

The “Slide Display Mode” selector will change the color mode of Cell. Normally, for greater efficiency, Cell uses YUV color sampling, however, this impacts the quality of still images. If you want the best quality, turn Slide Display Mode on, which will change the color sampling to RGB.

BPM Clip Sync

BPM Clip Sync will sync clip playback to the current BPM. If Rate is selected, then Cell will adjust the playback speed of the clip to best meet the BPM. For example, if a clip is 10 seconds long, and the tempo is set to 100 BPM, then the speed will increase to better match a measure's worth of 100bpm (2.4 seconds). In this example, because the clip would need to speed up over 4x (to be precise, 4.16=10/2.4 ), the rate adjustment is halved again so the adjustment is < 4x. The final adjustment to this 10 second clip is a speed increase of 2.08333 so the clip will take 4.8 seconds to go from start to finish, fitting within 2 measures of the tempo. All of this calculation, of course, is done instantly and automatically, and is of little concern to the performer!
If "Selection" is turned on, then the clip's speed will remain unchanged, but only a portion of the clip will play to fit the duration of the tempo's measure. So, for example, with a 10 second clip and a 100 BPM tempo, only the first 2.4 seconds of the clip will play.

MIDI

MIDI Spy lets you monitor your MIDI device’s input and set the port to receive MIDI messages from your MIDI device or interface. If your device does not show up in the menu, try using the refresh button or restarting the program. The MIDI thru port will pass MIDI data from interaction in Cell. This way, the mere act of working in Cell can trigger other events. This is particularly useful when working with controllers such as the Livid Block, Ohm64, Akai APC40, and Novation Launchpad.

MIDI Sync can be used to sync effects to a BPM.

Video input

With a video digitizer, webcam, or a Firewire DV camera, you can easily add effects to a live video streams (or any digitizable source, such as a video cassette). The Video Input preferences allow you specify the settings for your video input. Depending on your device or digitizer you can specify image quality, crop the image and change the resolution.

Displays

The display preferences let you set the RGB values as well as brightness and contrast for connected displays. There are controls to scale (zoom) the output, as well as specifically place size the output window to a given position and size, if you do not want it to simply fill the output window. For example, you may want to stretch the output over two monitor outputs. The “vertical sync” setting reduces the possibility of “tearing” the image when outputting to a monitor or projector. The “anti-aliasing” setting will turn on anti-aliased edges for video cards that support this feature. Some video cards on Windows machines may also need the “doublebuffer” feature turned off to operate properly.

Preferences Storage

Preference files are stored here: W7: C:/Users/username/AppData/Roaming/Livid/CellDNA/Defaults/ XP: C:\Documents and Settings\{user}\Application Data\Livid\CellDNA\Defaults OS X: <hd>:/Users/username/Library/Application Support/Livid/CellDNA/Defaults If you want to start with "factory default" settings, you can navigate to the CellDNA folder described above and move the Defaults folder to a new location or the trash.

Effects Details

Cell comes with over four dozen OpenGL-based effects to stylize your video clips. Each effect has its own look and function and can be modified by using the effect slider located directly to the right of the effects buttons. To activate an effect on a video clip, image file, or live camera feed press the corresponding effects button. Multiple effects can be used at once, however, different effects will often change what effects show through. Effects that share a name and underscore (such as “scatter_break” and “scatter_slabs”) in the name share the same effect engine, and cannot be blended together. Chromakey, Lumakey, and Feedback all use an alpha channel on the source videos, and cannot be mixed toether.

It is also worth noting that Max/MSP/Jitter users can customize and create new effects. To add an effect patch, in the Mac version, you can ctl-click on the .app icon and select “Show Package Contents.” Navigate to “CellFX” and you will see the max patches that make up the effects. On windows, navigate to the folder that contains the .exe, and go to support/CellFX. Just drop the max patch in that folder and it will appear when you start CellDNA.

bend – bends the video as if projected on the inside of a sphere.
binoculars – creates a twin circle mask, like on shows with private detectives.
BPM_... – The following effects will modulate the knob to the BPM Tempo. This Tempo can be tapped in with the Tab key, a MIDI Note, or using MIDI Time Code. Turning the effect knob will speed up the rate, with a choice of four divisions, usually 1/8, 1/4, 1/2, and 1 measure. The result is a BPM-sync'ed automated effect.
BPM_black – pulses the fade–to–black control.
BPM_Effect1 – pulses the Effect1 knob, and, therefore whatever effects is assigned to knob 1.
BPM_Effect2 – as above.
BPM_Effect3 – as above.
BPM_Effect4 – as above.
BPM_jump – sequentially jumps through eight even divisions of the movie.
BPM_jumprnd – jumps to a random frame in the movie< BPM_reverse – toggles the REV button's state.
BPM_rndclip – randomly changes the clip according to tempo.
BPM_rndclipbank – randomly changes the clip bank.
BPM_rndEffect – randomly turns on one of the first four effect knobs.
BPM_transform – switches between the movies at A and B.
BPM_xfade – crossfades between A and B to the beat.
burst – video is mapped to a spikey surface that increases in roughness as you turn the knob.
captions – a small window pops up that allows you to type captions onto the video output. For best quality, make sure anti-aliasing is on in the Display Preferences.
chromakey – makes a color of your choice transparent, showing the previously selected video. Just click on the Preview window to select a color. Turning the knob adjust the amount of sensitivity the key has.
cubed - maps video onto a cube and rotates it every four beats. Slightly cheesy, but with the right content, a pretty cool effect. darkfog - black blobs obscure random areas of the image. Turning the knob increases the density of the fog. explode – creates a burst of tiles with the video on them, rotating and arranging randomly.
extrude – prisms of video pop out, deforming the video with pulsing rectangles.
feedback_0 – using a luminance key, dark areas are made transparent, and the video is fed back on itself for a psychedelic effect.
NOTE: some graphics cards with older drivers, for an as-yet undetermined reason will not display the feedback effect properly. We will continue to investigate.
feedback_1 – feedback is so great, we had to provide multiple versions…
feedback_2
feedback_3
feedback_4
feedback_5
freeframe – if you have FreeFrame effects loaded on your computer, you can use the knobs to control different effects and parameters. A popup window appears when you turn this on, letting you select an effect and parameter to alter the video. FreeFrame effects need to be installed in (OSX) <hard drive>:/Library/ApplicationSupport/Freeframe/ or (XP/Vista) <boot drive>:\Program Files\Common Files\Freeframe. If you have a non-english language installation of the OS, the words will be different, for example, in German "C:\Programme\Gemeinsame Dateien\Freeframe"
funhouse - distorts the image like a funhouse mirror.
glitch – warps and breaks the movie randomly.
hallofmirrors - a variety of planes at right angles are distributed in 3D space, with the video mapped on each one.
invert – inverts all colors.
jumbotron_0 – pixelizes the image on large tiles, as if on a very large display.
jumbotron_1 – variant of above.
jumbotron_2 - variant of above.
leds – reduces the image to a matrix of red circles, as if displayed on a low-resolution LED display.
leds_color - like leds, but turning the knob will change the colors of the circles.
lumakey – makes a brightness level transparent. Turning the knob chooses the brightness level.
melt – warps the image as if looking through a melting piece of glass.
meshtronic – makes a flexible mesh of lines, where the bright areas warp the mesh.
NOTE: due to the differences in graphics cards, there are differences in how the “mx_” effects will display on some machines.
mx_kburns – pan and scan effect.
mx_rotate – rotates the image. The knob will change the speed of rotation.
mx_stretch_x – stretches the image on the x axis.
mx_stretch_y – stretches the image on the y axis.
mx_zoom – zooms out from the image, creating a tiled effect.
metropolis – video is mapped to a city-like surface in which you fly around.
mirror – the left half of the movie is copied and flipped for symmetry.
panes – black squares occlude the image. Increase the knob value increase the density. peu_d'etra – a simple emulation of the classic rutt-etra video effect.
pipes – draws a complex cubic-like structure, colored by the video.
remix – short samples of the video are repeated 4 times, then a new short sample is captured.
repeat_x - repeats the image horizontally. As the value is increased, the image will be repeated up to 8 times.
repeat_x - repeats the image vertically. As the value is increased, the image will be repeated up to 8 times.
rgb_blue - controls the blue channel of the image.
rgb_green - controls the green channel of the image.
rgb_red - controls the red channel of the image.
ripple – a watery ripple effect.
scanline – a horizontal line scans from bottom to top. Increasing the value of the knob increases the speed of the scan. scatter_break – breaks up the image into tiles.
scatter_slabs – a variation of scatter.
scatter_slicer - a variation of scatter.
scatter_strip - a variation of scatter.
scatter_vert - a variation of scatter.
scatter_zoom - a variation of scatter.
scroll_x - scrolls the movie horizontally, locked to BPM.
scroll_y - scrolls the movie vertically, locked to BPM.
separate - offsets the RGB channels spatially for colorful effects.
sine_anim - like the sine effect, but animates the frequency of the sine wave distortion.
sine - distorts the x-axis along a sine wave. The distortion increases as the knob is turned.
sphere – video is mapped onto a rotating sphere.
spots – three circles scan and mask the video.
tag – a random line is drawn, as if a fat tip pen is “revealing” the video.
tiles – video is broken into squares and randomized.
tint_darks – tint the dark areas with different colors.
tint_duo – duo tone color effect.
tint_whites – tint the white areas with different colors.
twine – a ribbon of twine is drawn in 3D space and rotated.
warp – video is mapped to the inside of a rectangular prism and stretched.
windows – animated rectangles mask much of the image and fade from view zeerocks – a harsh black and white effect.

MIDI Learn

Cell takes advantage of the possibilities that MIDI has to offer by fully integrating MIDI messages into its interface. MIDI liberates the user from a computer keyboard and mouse replacing them with the more appropriate interfaces of MIDI controllers. To fully utilize MIDI, you must first understand the different types of MIDI messages. The most popular MIDI message you will need to know about are continuous controller (or cc) and note messages. Note messages generally correspond to the notes on the keyboards keys or buttons on keypads (some buttons also send out cc messages). The other message type that you will need to understand is the cc message and its corresponding controller data.

The controller number is the number of the physical controller that can be a knob, slider, or foot pedal. Each controller number will send out variable controller data generally ranging from 0-127. For instance most volume knobs or sliders on a keyboard is controller number 7. When the slider is at the bottom or the lowest level the controller value is 0, when it is all the way up or at the highest level the Controller Data is 127. The numbers in between 0 and 127 make up the variations of volume levels. Both types of MIDI messages can be assigned to almost any parameter within Cell.

MIDI learn allows you to remote control Cell by providing you with an easy way to map external controllers to almost any function within Cell. To configure your MIDI device or Livid controller to be used in Cell you must first follow the connecting a MIDI device section above.

Learn Mode

Cell MIDI and Keyboard Learn

Press the MIDI learn button in the main interface to enter learn mode. When in MIDI learn mode you will notice certain areas of the interface are shaded green: this is called the “learn” state. When you press on any of the learn state buttons on the item that you want to map to a MIDI function it get a yellow highlight around it, also know as “listen” mode. When in listen mode the software will listen for a MIDI message, allowing you to easily map a control to a function. Moving a slider or knob, or pressing a button or key will enable the map for that function. When the function is assigned you will see a label that indicates the computer key or MIDI function, and colored to match the colors of the port menus in the MIDI Preferences panel.

For example if you wanted to map a knob to the "Fade to Black" knob in CellDNA, you would press MIDI learn, press the fade to black knob in the software and move your controller’s knob. This would enable that knob to control the fade to black. Individual Clip Bank cells can also be assigned to individual MIDI notes or controller numbers. Once you deactivate MIDI learn mode your MIDI and keyboard mapping takes immediate effect.

MIDI settings are always saved in their last state when quitting the program and can be archived by archiving a project.

Video Input

Using a video digitizer, USB or Firewire webcam, or a Firewire DV camera, you can easily add effects to a live video streams (or any digitizable source, such as a video cassette).

To access the video input options you need to open the Preferences and select video input. The video in digitizer contains controls for selecting the input source and has a list of digitizing devices. If you only have a DV camera connected to your computer's firewire (1394) port, then there will only be one item in this menu - DV Video. If you have other digitizers, such as a PCI-based video card or USB digitizer, you will see these in the menu as well. The second menu is the list of inputs available for a given digitizer. If you have a DV camera and a Firewire webcam (such as a Unibrain Fire-i, Apple iSight, or Orange Micro iBot) attached, you will have two inputs - DV Video and IIDC Video. Choose DV Video for the DV camera, or IIDC for the webcam. Usually, you can switch between cameras and digitizers quite seamlessly, so multiple camera angles are possible for a live performance.

Just below the digitizer panel there is a preview window where you can preview your video input. If the Digitizer is on (activate it by pressing the on button next to the input menu), you will see at least a still frame preview of any attached and active video device.

The Crop Input area of the video in Preferences allows you to crop the video input. Image Quality allows you to change the color and image quality of the video input. Not all digitizers support these controls.

To use the Video in for your output, click on the Video In button in the main interface. All effects can be used with the video input to manipulate the live feed. Although there are a variety of camera types that Cell will recognize, the best frame performance and lowest latency will be achieved with IIDC uncompressed FireWire video streams. Cameras such as the Unibrain fire-i, OrangeMicro iBot, and apple iSight provide this type of input. Products exist that will convert an analog video signal to IIDC video - search IIDC firewire uncompressed conversion on the Internet for more information. DV Cameras provide a compressed stream of video.

Presenting Video

Cell is designed to be a real-time video presentation and effects tool. Ultimately this will mean that you are probably using it for presentation with some kind of projector, display, LED wall, or video presentation device. There are a few things you may want to consider before simply pressing the “fullscreen” button to present your video.

If you have followed all the steps above you have probably prepared your media, setup you display preferences, adjusted the color settings, and tested your video input. If you have not done all of this, now would be the time to do it. While pressing the fullscreen button may work in most settings, depending on the computer, video input, presentation device, and video interface you may need to go back and change a few settings in the preferences, or in your system settings to get the best possible playback and performance from Cell.

Database

The Database feature makes it easier to keep track of all your video clips and find clips that you need for a show. While the Clip Bank does a good job of presenting clip content, and the Browser can provide small thumbnails of clips, the database takes it a step further. With the ability to add descriptive comments and "tags" to clips, as well as the ability to search filenames, related clips in the database can be retrieved and easily added to the Clip Bank. For example, if you tag several clips according to the main colors in the video, you could at a later date, immediately pull up all your "red" clips, add them to the bank, and better create a mood and work with existing lighting designs. Other tags could indicate a particular style ("dreamy") or content ("cityscape"). It's also very easy to tag clips as they are playing, so if you are mixing video to an act for the first time, and you notice that a particular clip goes well with a certain type of music, you could add that genre as a tag to the clip.

The first time you use Cell 2.5, the database will be empty. As you add clips to the Clip Bank, the paths to the clips will be added to the database. When you click on the clips in the grid, to play them, you can also use the database entry fields on the lower left to add comments and tags. You can also click on clips in the Browser and add comments and tags without adding the file to the ClipBank. Finally, you can click on a folder of media clips in the Browser, and the database can guide you through the three steps to tag all clips in the folder with the same comment and tags. You can opt out of adding any comments or tags, and just add the paths so you can add tags later, or find the clips by searching for file name. Once you have entered the comment and tag, press "go":

In this example, the highlighted clip has had a description and tags added:

that will be displayed every time the clip is selected, and can be easily searched for in the Database interface

Click on the "Database" button in the Extended Interface area of Cell. This will display the Database search form. You can use the "search" field to find results that match a word or phrase. Continuing the previous example, if you searched for "Miami", the livid_22.mov clip would be shown in the "select results" table, since it has the word "Miami" in the comment.

You can use the "tags" list to immediately pull up results for clips with the selected tags. Just click on a tag to show the results. Click it again to take those results out of the results table.

You can then selectively choose from the results by clicking on the filenames. Then click the "load selected to grid" button and drag the button to the desired cell in the Clip Bank to populate the Bank with the database results.

Saving

Cell will save all of your MIDI settings, Clip Banks and preferences every time you make a change, so in general there is no need to “save” a project. Cell does however give you two options to save projects, “save as” and save with media.

Save As

You can use the Save As from the file menu to save copies of project to recall later. Cell projects will save as with the .lcp extension, which stands for Livid Cell Project. This option is particularly useful if you have files associated with different projects or uses. Saving As will save your clip locations, MIDI setting and preferences to recall at a later time. To open a saved project choose File>Open from the open menu after you open the Cell application. Note that this will not save your media files, so if you move your media files to a different folder or harddrive, or change the name of any folders, you will need to reload them into the project.

Save with Media

You can also archive a project to move to another computer for later use. Use the “Save with Media” option under the file menu to save your project setting and media in one central location. Make sure you have enough drive space to do this, as video can take many gigabytes of your drive!

Import old version clips

This feature makes it easy to load the clips from your old version into 2.5+. The file format of Cell 2.5 is different than previous versions. You can import the clips and thumbnails from your last session in an old version of Cell into Cell 2.5+. Go to the File menu and select "Import old version clips." You'll be asked to confirm. All the filepaths from the old version of Cell will be imported and saved into Cell 2.5.

Key Guide

This is the default Keyboard mapping, and can be enabled or disabled in the MIDI & Key Preferences panel. You can use the Learn feature to create your own custom keyboard map.

Extras (DNA only)

DNA has an additional top menu called Extras. The items in this menu extend the functions of DNA with extra controls. Users of Max/MSP can easily add their own extras to this menu, following similar steps as adding effects (please refer to section "Effect Details"). The only difference is that patches go into the “Extras” folder, rather than “CellFX.”

Audio Route

This provides explicit controls to allow you to route audio from CellDNA to other applications with Rewire or SoundFlower.

More Controls

Provides additional knobs for control of basic video and image functions, plus eight more programmable effect knobs. All knobs can be MIDI learned, expanding your hardware control.

Networking

Provides controls for remote control of other computers running DNA over a local-area or wide-area network. Use the “Fetch” buttons to seek out other computers in your local network that are running DNA. This will populate the selection menu, so you can select a machine to send the commands, such as play/pause, fullscreen, clip selection, or effect controls. Use “broadcasthost” to send commands to ALL machines simultaneously. For Networking to function properly, you need to make sure that your local network and computers will allow messages on the port specified in the Network interface, which is 8000 by default. If you want to control a computer on a wide area network, you need to make sure that the router ports are open and forwarded to the proper computer on the network. Visit http://www.portforward.com/ for more information on what that means! NOTE: Many network security systems will warn you that DNA is trying to connect to a network. This is a safe operation.

Record

The record function provides a utility to record a performance, exporting it to a Quicktime Movie file. All recordings are set to a user defined resolution and frame rate, and, in render mode, no frames are dropped during recording. It is worth noting that you need to specify the FPS (frame per second) in the recording preferences to the FPS of your source media. Failure to set the proper FPS may result in file being recorded too fast or slow.

Recording your output

Press the browse button to select a destination folder for your recordings. If this section is skipped your recordings will be saved into the same folder as the CellDNA application
Use the recording preferences for specifying settings such as compression, size, timer and record mode.
Press the record button and to start the recording process.
When you are done recording, press the record button again to stop.

It is worth noting that your recording performance will be faster if you record when not in fullscreen mode. When in fullscreen mode, you can increase performance by reducing the resolution of your second screen output monitor. The "render" mode, when on, will record frames as they are processed, and results in the best quality recording. However, the results are not in real time, and while recording, playback may seem extra fast or extra slow. When off, the recorder will record everything in real-time, however, you may get some dropped frames.

Recording with sound

The small speaker button turns on sound recording. When record with sound is enabled, this turns on a system in which audio from video files is copied and decompressed into a cache folder, when the video is played. This allows the audio from clips to route into the recording. The other thing this does is switch the recording preference to realtime mode, rather than render mode. This process can be a bit cumbersome, especially for longer files and video with compressed audio. We recommend using uncompressed audio in your clips as a result. This decompression only happens the first time you play a video. After that, the cache file for that video is permanently available on that computer. As a result, you may want to do some prep work before hand and manually trigger each file with audio (or just turn on sequencer!) so the audio can be properly cached, and the recording and playback will be more precise. If for some reason you need to free up harddrive space, since, with a lot of clips, this cache could get several GB in size, you can manually delete the cache files. The uncompressed audio files are located at: OSX: /<username>/Library/Application Support/Cycling '74/spigot-cache/ Windows: C:/Documents and Settings/Owner/Local Settings/Application Data/Cycling '74/ spigot-cache/ so you can just navigate there and delete as desired.

Layers

The Layers extra provides four additional movie players whose output can be mixed with the A and B channels (two layers for each channel). The knobs provide opacity controls for your layers. This can provide additional depth and complexity to your mix. There are also several OpenGL blend modes that will change how the Layers blend with the A and B channels. All parameters in this Extra can be controlled with MIDI or your computer keyboard.

MultiScreen

Divides the output window into multiple sections, and provides an interface allowing you to direct movie selections to different screens.

SoundWave

Displays a waveform of audio input, with controls to change the look of the wave. All parameters can be controlled with MIDI or computer keyboard. Source: Select an input source that is available to your system. This could be an external microphone, a stereo input from a live soundboard, or a virtual input from other software. Input Channels: select the source for stereo input that will be summed to make the waveform. Configure Audio: opens a DSP Status window for more detailed configuration. Stroke: The Stroke dial changes the width of the waveform drawing. Zoom: Zoom in on the waveform to show a smaller window of time. Zoom out to show a larger window of time and more detail. Opacity: Blend the image with your videos Color selector and Saturation: Change the color of the waveform. Autocolor: Turn on to randomly change colors according to the BPM.

Syphon

For Mac OS X 10.6+ - Syphon uses the Syphon frame sharing system for inter-application video sharing. You can serve frames from DNA to other applications and receive frames from other applications and blend them in with your existing content. A complete list of applications can be found at the Syphon web site, but it includes Quartz Composer, Max/MSP, FreeFrameGL, and UnityPro.

Top Mask

Provides a masking overlay for the final output of CellDNA. You can use movies or still images. Shift-click on the Clip Grid to load a movie from the Grid into Top Mask.

Open Sound Control Messages

These are the messages that CellDNA will listen to for remote, network control of its interface.

-
message	type	range	comment
/Effect1	int	0-127
/Effect2	int	0-127
/Effect3	int	0-127
/Effect4	int	0-127
/Effect5	int	0-127
/Effect6	int	0-127
/Effect7	int	0-127
/Effect8	int	0-127
/Opacity	int	0-127
/Tempo	float	10.-400.
/MovieRandom	int	0	range of "0" in all cases means "just send a 0".
/ToB	int	0-1
/ToA	int	0-1
/PlayPause	int	0-1
/Fast	int	0-1
/Slow	int	0-1
/Loop	int	0-1
/Sequence	int	0-1
/CrossOrCut	int	0-1
/VideoIn	int	0-1
/FullScreen	int	0-1
/MovieSelect	int	0-63
/BankSelect	int	0-32
/ClipsDec	int	0
/ClipsInc	int	0
/EffectsBank	int	0-32
/EffectsInc	int	0
/EffectsDec	int	0
/Crossfade	list	0-127 0	yes, a list. Yes, I realize it's weird. Second int is always 0
/fetchEffectsNames	int	0	CellDNA will reply with the names of the effects currently assigned to the 8 knobs with something like /names EffectSelect[1] effectname

Cell DNA 25

From Livid Wiki

Contents

Introduction

Welcome to Livid Cell and DNA

System Requirements

Minimum Requirements

Preferred System

Known Issue

Installation and Authorization Procedure

Installing Cell

Installation Instructions

Running Cell

Authorizing Full Version

Authorization FAQ

Getting Started

Quick Start Guide

Starting Cell for the first time

Selecting a Video Clip

Adding Effects

Adjusting the Playback

Transitions

Quick Help

About MIDI

MIDI Setup

MIDI Templates

MIDI & Keyboard Learn

Using Media Files

Resolutions

Preparing Content

Video

Audio

Images

Codecs Not Recommended

Saving States

MIDI Template Descriptions

CellDNA Templates

block

Code

Ohm64 & RGB

APC20

APC40

Cell Templates

block

Code

Ohm64 & RGB

APC20

APC40

Templates Formats and editing

ID

translate

messages

Using the Software

The Interface

A. The Clip Bank

B. Bank Controls

Bank Selection

Trigger/ Edit Mode

Sequence

Crossfade/Cut/Split Mode

Clearing a Clip Bank

C. File Browser (Loading the Clip Bank with media)

Loading individual files from the browser

Loading entire folders from the browser

D. Movie Controls

E. Preview Window

F. Crossfader and Layer Controls

G. Functions Buttons

H. Effects

I. Extended Interface

Database

Previews

Captions

Preferences

General

Movie Settings

File Browser default folder

Slide Display Mode (YUV/RGB)

BPM Clip Sync

MIDI