Chameleon provides Qt components for event streams display.

Within a Git repository, run the commands:

mkdir -p third_party
cd third_party
git submodule add https://github.com/neuromorphic-paris/chameleon.git
git submodule update --init --recursive

An application using Chameleon must link to several Qt libraries, as described in the file qt.lua. The page use Qt in a premake project provides documentation for this file.

Open a terminal and run:

sudo apt install qtbase5-dev qtdeclarative5-dev qml-module-qtquick-controls qml-module-qtquick-controls2 # GUI toolkit

Open a terminal and run:

brew install qt # GUI toolkit

If the command is not found, you need to install Homebrew first with the command:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Download and install Qt. Select the latest 32-bits version when asked. You may want to restrict the installation to your platform, as the default setup will install pre-compiled versions for other platforms as well, and take up a lot of space. After the installation, open a command prompt as administrator and run:

mklink /D c:\Qt\opt c:\Qt\5.11.1\msvc2015

You may need to change 5.11.1 and msvc2015 to match your Qt version and platform.

Finally, add c:\Qt\opt\bin to your path and reboot your computer.

Code documentation is held in the wiki.

Open a terminal and run:

sudo apt install premake4 # cross-platform build configuration
sudo apt install clang-format # formatting tool

Open a terminal and run:

brew install premake # cross-platform build configuration
brew install clang-format # formatting tool

Download and install:

• Visual Studio Community. Select at least Desktop development with C++ when asked.
• git
• premake 4.x. In order to use it from the command line, the premake4.exe executable must be copied to a directory in your path. After downloading and decompressing premake-4.4-beta5-windows.zip, run in the command prompt:

copy "%userprofile%\Downloads\premake-4.4-beta5-windows\premake4.exe" "%userprofile%\AppData\Local\Microsoft\WindowsApps"

To test the library, run from the chameleon directory:

premake4 gmake
cd build
make
cd release

Windows users must run premake4 vs2010 instead, and open the generated solution with Visual Studio.

You can then run sequentially the executables located in the release directory.

After changing the code, format the source files by running from the chameleon directory:

for file in source/*.hpp; do clang-format -i $file; done;
for file in test/*.cpp; do clang-format -i $file; done;

Windows users must run Edit > Advanced > Format Document from the Visual Studio menu instead.

See the LICENSE file for license rights and limitations (GNU GPLv3).