VControl Demos

VControl comes with four demos that demonstrate how to use the API and which give a basic example of a configuration file.

Building instructions

To build the demos, follow these directions, based on system:

Building under Unix (presumably including OS X)

From the VControl top level directory, simply type make, and it should build a libvcontrol.a in lib and the four executables in bin. The test.cfg sample configuration file should also be copied there.

Building under Windows

Go to the msvc directory and open VControl.dsw in Visual Studio. This workspace has four projects (one for each demo, naturally). Ensure that you've got your SDL directories properly set in Visual Studio (if you've been doing SDL development before, this should be done already) and perform a batch build of the demos you want. They will go into the bin directory, along with a copy of the test.cfg sample configuration file.

Demo Descriptions

The available demos are as follows:

• Basic Demo: A simple C program that loads the configuration file, dumps what it was able to bind to standard output, then reports on the input state as it changes until you close the SDL window.
• C++ Demo: As per the basic demo, but this binds VControl into a traditional observer class.
• Multithreaded Demo: Uses a one-writer many-readers thread model to handle input handling in a multithreaded environment without locks. Note that the input update isn't quite atomic here, so truly simultaneous input actions are not guaranteed to register as such.
• Locking Demo: As per the multithreaded demo, but uses locks to ensure that truly simultaneous input actions are properly registered.