Developing Applications that use Vuo

Description

See the VuoCompiler and VuoRunner classes, and the example code under "Modules" below.

Using the Vuo API in a Cocoa Application with Xcode 4

• Create a new project:
  • Choose template OS X > Application > Cocoa Application.
• Modify the target's Build Phases:
  • Link Binary With Libraries
    • Use the + button and "Add Other..." to add Vuo.framework.
  • Add Build Phase > Add Copy Files
    • Destination: Frameworks
    • Uncheck "Copy only when installing"
    • Drag Vuo.framework from the Project Navigator to this Build Phase. (The + button doesn't work.)
• Modify the target's Build Settings:
  • C++ Language Dialect: C++98
  • C++ Standard Library: libstdc++
  • Runpath Search Paths: @loader_path/../Frameworks
• Modify <your project>-Prefix.pch:
  • Just before

    #import <Cocoa/Cocoa.h> 

    add

    #define __ASSERT_MACROS_DEFINE_VERSIONS_WITHOUT_UNDERSCORES 0 

    (This is a workaround for a bug in one of Vuo's dependencies that prevents Cocoa projects from compiling.)
• Set up one or more of your project's source files to be able to call Vuo API functions:
  • Name the source file with extension ".mm" (for Objective-C++) instead of ".m".
  • Add

    #include <Vuo/Vuo.h> 

Modules
	CompileAndRunInCurrentProcess.cc
	Example: Compile a composition and run it in the current process.
	CompileAndRunInNewProcess.cc
	Example: Compile a composition and run it in a new process.
	ListPublishedPorts.cc
	Example: List a composition's published input and output ports.
	RunImageFilter (Cocoa)
	Example: Set up a GL context using Cocoa and run a Vuo image filter.
	RunImageFilter (GLFW)
	Example: Set up a GL context using GLFW and run a Vuo image filter.
	RunImageFilter (Qt)
	Example: Set up a GL context using Qt and run a Vuo image filter.