OSC CC

Table of Contents Overview Content Structure Usage Configure and build OSC-CC Use OSC-CC modules in your code

Overview

OSC-CC stands for "Open Source Camera - Code Collection" and is a container for the exchange of code related to machine vision or generally useful for development on the leanXcam. It can be downloaded here.

As the name suggests, OSC-CC comes in the form of independent modules, some of which depend on the Oscar Software Framework or on other modules in the collection. To allow for a maximum of flexibility, each function block is compiled into its own small library. The result is therefore a collection of small, single-purpose C libraries, each of which can have its own license attached. Most of them are published "as-is" under an open source license (LGPL) and free for anyone to reuse in their own projects.

Because of this open development model, no support or guarantees whatsoever can be provided by Supercomputing Systems AG or this site. If you found a bug or problem in existing code, we are happy to make patches, bug fixes or additional documentation you provide available to the community for you though. To ensure making contributions is as easy as possible, the development of OSC-CC is only loosely coordinated and the requirements for documentation and coding style are relaxed compared to the Oscar Software Framework.

Content

Currently, the following modules are available:

• LeanCV: A small vision library with OpenCV-like API.
• vchecker: Finds and labels continuous regions in a binary input image and calculates bounding boxes around them. Allows to calculate image moments like perimeter, compactness, balance point, number of holes and Fourier spectrum of contour from a labeled input image
• leanXoverlay: Overlay text, simple geometric primitives over existing images or plot arbitrary curves from vectors.

Structure

The structure of OSC-CC is quite simple:

osc-cc

• modules
  • <Module 1>
    • <Source files of Module 1>
    • <include>
      <Header files of Module 1>
  • <Module 2>
    • <Source files of Module 2>
    • <include>
      <Header files of Module 2>
  • ...
• library
  • <Library resulting from compilation of Module 1>
  • <Library resulting from compilation of Module 2>
  • ...

Each module lies in an own folder so that they are independent from each other.

All OSC-CC modules are self-contained, i.e. each individual library can be compiled by itself or all of them can be compiled at once.

Usage

Configure and build OSC-CC

Configure OSC-CC by specifying the path to the Oscar Software Framework and running the configuration utility of Oscar:

 xxx/osc-cc$ ./configure

Follow the questions in the dialog. Each module can be activated or deactivated.

Building is only possible after configuration. To build the chosen modules, type:

 xxx/osc-cc$ make

Use OSC-CC modules in your code

An exact descripton how to include an OSC-CC module in your code is given on the Web-View-Cpp documentation. In the section Compilation you find how to configure and compile the application and under your own project you get to know how to create a new project.