DS Cinder is a framework for interactive applications built on top of the fantastic Cinder framework
DS Cinder is a fully featured windows framework for rapid production of multimedia OpenGl applications. And applications built on it are running in hundreds of locations 24/7 around the globe. It provides media handling (Images, PDF, Video, Streams, Web views, Fonts), extensive configuration, a suite of UI and rendering components, and integration with our CMS backend for rapid prototyping and developemnt.
This version of DS Cinder is Windows only, and targeted at Windows 10 & 11
Install Visual Studio 2022 - Community Edition
- Download here: https://www.visualstudio.com/
- Install it!
- Make sure to select C++ development and ensure you have the latest windows SDK and visual studio updates!
- Go to https://boost.org
- DS Cinder currently uses version 1.74.0
- You can download the binary package installer from here: boost 1.74.0 for vs2019
- Run the installer
- Make a new environment variable
- Open the Start menu and type "Advanced System Settings"
- Click "Environment Variables"
- Under "Sytem variables", select "New..."
- Variable name: BOOST_PATH
- Variable value: the path of the installed boost (e.g C:\local\boost_1_74_0)
- Ok, Ok, Ok
- Go to https://gstreamer.freedesktop.org/data/pkg/windows/
- As of this writing, the 1.18.5 version is what you want. Even-number minor versions (the "18" in this case) are the stable releases and the ones to use.
- Download gstreamer-1.0-devel-msvc-x86_64-1.18.5.msi
- Download gstreamer-1.0-msvc-x86-1.18.5.msi
- Note: the version numbers will be different if you've selected something else. You want both the "devel" and regular installers, and the x86_64 versions
- Install both msi installers with the "complete" option
- If you have any Visual Studio windows open, close them now so they can get the new environment variables set by the gstreamer installers
- See the gstreamer read me for more info
- Download and install Git and ensure you have git-lfs available
- Run
git clone https://github.com/Unispace365/ds_cinder.git
cd ds_cinder
- Run:
git lfs install
- Run:
git lfs fetch --all
- Run:
git submodule init
&git submodule update --recursive
to create & update the Cinder submodule.- If you're upgrading from a previous version, you may need to run
git submodule sync
first
- If you're upgrading from a previous version, you may need to run
- Add platform environment variable
- Open the Start menu and type "Advanced System Settings"
- Click "Environment Variables"
- Under "Sytem variables", select "New..."
- Variable name:
DS_PLATFORM_093
- Variable value: the path of this downloaded repo (e.g C:\Users\YourNameHere\Documents\ds_cinder)
- Ok, Ok, Ok
- Open the Cinder project in visual studio (ds_cinder/Cinder/proj/vc2019/Cinder.sln) and compile for Debug-x64 & Release-x64
- Open an example project in the example folder and compile
- Check out the Getting Started Example - it's a handy quick intro for basic concepts in ds_cinder. It also has a good number of common ds_cinder components in the app so you can mess with the pieces and see what's what.
- Read the docs in doc/basics Particularly good ones:
DsCinder is documented using the doxygen syntax. The documentation can be generated by running the following from the root of the ds_cinder project directory
doxygen ./doc/doxygen/ds_cinder_Doxyfile
The documentation is generated in doc/doxygen/generated/html/
and index.html is the main page.
There's a project cloner in utility/project_cloner.ps1. Right-click that file and Run with Powershell. That applet will duplicate the full_starter example project with a name and namespace of your choice. From there, you can customize the app as you see fit. The full starter example comes with most of the extention projects (web, pdf, video, etc) already added, so you can start developing right away without messing with property sheets or compilation settings.
Linux was breifly supported in the past, but had insufficient usage to stay up to date.