Personal tools
The Open Lighting Project has moved!

We've launched our new site at This wiki will remain and be updated with more technical information.

Using OLA with Xcode


Revision as of 04:34, 26 January 2010 by Chatchavan (talk | contribs) (Configure your project: corrected library search path)
Jump to: navigation, search

You can use OLA to implement your application in Objective-C++, a bridge between Objective-C and C++. This page explains how to integrate OLA client into your program. The content of this page is based on OLA 0.6.0 Universal Mac Binaries

What you'll need

Configure your project

  1. Select menu: "Project" -> "Edit Project Settings". All settings below are referred in a "Build" tab
  2. Set "Architectures" to 32-bit Universal
  3. Set "Header Search Paths" to

Add dylib

  1. In your project tree, right-click on a group that contain frameworks (e.g. "External Frameworks and Libraries", "Fromeworks/Linked Frameworks"), select "Add" -> "Existing Frameworks"
  2. Select following frameworks:
    • libprotobuf.dylib
    • libola.dylib
    • libolacommon.dylib

Example code

The following code sends value 255 to channel 0 in universe 0. First, it creates a client from a SimpleClient object. Then, it creates a DMX data array and pack the array to a buffer. In the end, it sends the buffer to a server.

#import <Foundation/Foundation.h>
#include <errno.h>
#import <ola/DmxBuffer.h>
#import <ola/SimpleClient.h>

// define type for DMX message
typedef unsigned char dmx_t ;

// maximum number of channels

int main (int argc, const char * argv[]) {
    NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];

    // get a client
	ola::SimpleClient simpleClient;
	if (!simpleClient.Setup()) {
		NSLog(@"Client setup failed %s", strerror(errno));
		return -1;
	ola::OlaClient *client = simpleClient.GetClient();
	// prepare data
	int channel = 0;
	dmx_t *dmx = (dmx_t *)calloc(MAXCHANNELS + 10, sizeof(dmx_t));
	dmx[channel] = 255;
	ola::DmxBuffer buffer(dmx, MAXCHANNELS);

	// send DMX message
	int universe = 0;
	if (!client->SendDmx(universe, buffer)) {
		NSLog(@"Sending DMX failed %s", strerror(errno));
    [pool drain];
    return 0;

Notice that DMX API is changed since the last documented client API. You can find more information by browsing the source file of DMX example. For me, the src/ola-client.cpp is quite useful.