DS Cinder is a framework for interactive applications built on top of the fantastic Cinder framework. DS Cinder provides conveniences for getting graphics onscreen; loading data from a sqlite database; displaying PDFs, videos and web pages; providing touch interaction; and loading settings. The DS version also provides the ability to syncronize multiple clients to display the same graphics, as well as conveniences for touch handling.

Note: If you've been using DS Cinder before today (5/15/2015), you've been on the 0.8.4 branch in Visual Studio 2010, which is available under tags. This new master branch is based on Cinder 0.8.6, and requires Visual Studio 2013. You can continue using 0.8.4, but there will be no more development or updates of that version.

This version of DS Cinder requires Visual Studio 2013 installed.

• You'll need some environment variables set:

• CINDER_086 should point to the 0.8.6 cinder dist (Version 0.8.6 for VC 2013). e.g:

  setx "CINDER_086" "%USERPROFILE%\code\cinder_0.8.6_vc2013"

• DS_PLATFORM_086 should point to this repository. e.g:

  setx "DS_PLATFORM_086" "%USERPROFILE%\code\ds_cinder"

• [optional] DS_CINDER_GSTREAMER_1-0 should point to Gstreamer (if your project uses Gstreamer). e.g:

  setx "DS_CINDER_GSTREAMER_1-0" "c:/gstreamer/1.0/x86/"

• Use the project generator to create a new project. This will make a copy of the "full_starter" example project, which contains all the projects you'll need to get started (PDF, Video, etc) and a bare-bones app structure.

• If you get errors for xaudio.h: install latest DirectX SDK
• If you get errors of missing Boost cstdint headers: make sure your cinder distribution does include Boost! Be sure to use the download on the cinder home page, and not a release from the cinder github.
• If you get LNK1123: failure during conversion to COFF: file invalid or corrupt': Install latest update for your Visual Studio!
• SerialRunnable: You may need to pass an alloc function when initializing a SerialRunnbale.
• boost::mutex to std::mutex. In most cases for threading, the boost versions are supplanted with the STL version. Check stack overflow / google, there's plenty of upgrade examples
• Not defineds: Many STL elements now need to have #includes, most commonly <memory>, <cctype> and <sstring>.
• KeyEvent Not Defined: Since the removal of using namespace ci::* from ds_cinder files, you'll need to make sure everything is namespaced properly.

We are using Visual Studio property sheets to manage basic settings like libraries and include paths. The property sheets are located in ds_cinder/vs2013/PropertySheets, PlatformSetup.props (release config) and PlatformSetup_d.props (debug config). What this means is that in the future, all include paths, libraries, and library include paths should be added to these property sheets, so that apps will inherit any changes. All of these values are specified in the property sheets Common Properties->User Macros page.

1. Open the Property Manager (View -> Property Manager).
2. For each project, in the Debug config add PlatformSetup_d.props and in release add PlatformSetup.props (in both cases, right 3. click the config and select Add Existing Property Sheet...).
3. In C/C++ -> General set Additional Include Directories to $(platform_include_d)" (in debug) or "$(platform_include) (in release)
4. In Linker -> General set Additional Library Directories to $(platform_lib_include_d);%(AdditionalLibraryDirectories) (in debug) or $(platform_lib_include);%(AdditionalLibraryDirectories) (in release)
5. In Linker -> Input set Additional Dependencies to $(platform_lib_d);%(AdditionalDependencies) (in debug) or $(platform_lib);%(AdditionalDependencies) (in release)
6. In Linker -> Input set Ignore Specific to $(platform_lib_ignore_d) (in debug) or $(platform_lib_ignore) (in release)

We are currently making use of ZeroMQ, which requires a DLL to be located in the same folder as the executable. To automatically copy over the correct files, add a build step.

1. Open the properties on your project.
2. Go to Configuration Properties -> Build Events -> Post Build Event
3. Set Command line to: copy /Y "$(DS_PLATFORM)\lib\zmq\lib\*" "$(OutDir)"
4. Set Description to something like Copying ZMQ

Install Gstreamer 1.4.5 runtime and development files available from the gstreamer site and make sure you have Gstreamer's environment variable defined (refer to installation section of this document). Use the x86, not x64 versions.

• Runtime installer
• Development files installer