/Oscilloscope

Oscilloscope for Mac/Windows written in OF

Primary LanguageC++MIT LicenseMIT

Oscilloscope

A software oscilloscope attempting to mimic the aesthetic of old school ray oscilloscopes.

Not a programmer?

This is the programming documentation. If you are not a programmer please

Project setup

Things are moving around a bit at the moment. Make sure to read these instructions before each build.

  1. Download and unzip Openframeworks 0.9.3 or newer
  2. Open the folder apps/myApps/
  3. Clone the repository with submodules: git clone --recursive https://github.com/kritzikratzi/Oscilloscope.git
  4. Download the binary release for ofxAvCodec from https://github.com/kritzikratzi/ofxAvCodec/releases/tag/0.1
  5. Replace the addons/ofxAvCodec/libs with the libs folder from the download

Compiling with XCode (OSX10.10+)

  1. (optional) run scripts/clean.sh
  2. (optional) run scripts/prepare.sh osx
  3. Open apps/myApps/oscilloscope/Oscilloscope.xcodeproject and then Build&Run
  4. (Optional) Code sign by running scripts/sign-mac.sh bin/Oscilloscope.app "Developer ID Application: Name of your certificate" (run security find-identity -v -p codesigning to get a list of installed certs)

You can also build with make && make run on the command line. The resulting build will have no icon/no proper name/no retina support.

Compiling with Visual studio 2015

**VS Project file is not up to date,

The shell commands can be run from a git bash, cygwin, msys, or any other shell emulator.

  1. run scripts/clean.sh
  2. run scripts/prepare.sh win32
  3. Open oscilloscope.sln and Build&Run

At this point audio should play through Asio (first choice), or Wasapi. You can follow these instructions to patch OF so you can pick at startup: http://pastebin.com/ZZLZ3jUm

Compiling with make in Linux

  1. run scripts/clean.sh
  2. run scripts/prepare.sh linux64
  3. run make && make run ? [subwolf knows, i haven't done this in ages!]

See scripts/readme.md for the full distribution process.

Package the software

  • for osx run scripts/dist.sh $platform $version
  • platform is one of osx linux linux64 win32 win64
  • version is whatever version you want, e.g. 1.0.6

License/Source code

  • Openframeworks. A creative coding library. The larger part of it is licensed as MIT/BSD.
  • FFmpeg and ofxAvCodec. FFmpeg is the encoder/decoder library and licensed under the gpl/lgpl 2.1. The binaries included here were compiled to comply with the lgpl. A copy of the LGPL together with instructions how the library was compiled for each platform can be found in the legal folder.
  • The sourcecode for this application is freely available on github.