CL - Research - Code Laboratories

Archive

Home
Research
View

The PS3Eye Multicam Driver
Author: AlexP Date: 12-20-2009
An overview of the long awaited CL-Eye/PS3Eye multicam driver... After a lot of testing and optimization of the internal driver code, we are ready to release the first version of the CL-Eye multicam driver. For your reference, below is the diagram of the internal components of the driver...
Note this article was depreciated on 12-29-2009 - Read about new version here... After a lot of testing and optimization of the internal driver code, we are ready to release the first version of the CL-Eye multicam driver. For your reference, below is the diagram of the internal components of the driver. For a single camera configuration the 'Image Stitching' component is bypassed.

The driver exports simple API that allows for full control of PS3Eye cameras. I chose a C style export functions this time to allow for easier integration with different programming languages such as C#. Here is the 'PS3EyeMulticam.h' file that you would normally include in your code: Included in the driver archive is a full source code of a simple 'PS3EyeMulticamTest' application that allows you to run and test the multicamera driver.

////////////////////////////////////////////////////////////////////////////////////////////
// CL-Eye Platform SDK Example
// This library allows you to use multiple PS3Eye cameras in your own applications.
//
// For updates, more information and downloads visit: eye.codelaboratories.com
//
// Copyright 2008,2009 (c) Code Laboratories, Inc. All rights reserved.
//
////////////////////////////////////////////////////////////////////////////////////////////
#pragma once
#include <windows.h>

#ifdef PS3EYEMULTICAM_EXPORTS
#define PS3EYEMULTICAM_API extern "C" __declspec(dllexport)
#else
#define PS3EYEMULTICAM_API extern "C" __declspec(dllimport)
#endif

////////////////////////////////////////////////////////////////////////////////////////////
// PS3EyeMulticam API
////////////////////////////////////////////////////////////////////////////////////////////

typedef enumResolution;

// Camera information
PS3EYEMULTICAM_API int PS3EyeMulticamGetCameraCount();

// Library initialization
PS3EYEMULTICAM_API bool PS3EyeMulticamOpen(int camCnt, Resolution res, int frameRate);
PS3EYEMULTICAM_API void PS3EyeMulticamClose();

// Capture control
PS3EYEMULTICAM_API bool PS3EyeMulticamStart();
PS3EYEMULTICAM_API void PS3EyeMulticamStop();

// Settings control
PS3EYEMULTICAM_API bool PS3EyeMulticamLoadSettings(char* fileName="settings.xml");
PS3EYEMULTICAM_API bool PS3EyeMulticamSaveSettings(char* fileName="settings.xml");
PS3EYEMULTICAM_API void PS3EyeMulticamShowSettings();

// Processed frame image data retrieval
PS3EYEMULTICAM_API bool PS3EyeMulticamGetFrameDimensions(int &width, int &height);
PS3EYEMULTICAM_API bool PS3EyeMulticamGetFrame(PBYTE pData, int waitTimeout=2000);

////////////////////////////////////////////////////////////////////////////////////////////

This code could also serve as a good starting point for writing your own OpenCV image processing apps. The PS3EyeMulticamTest app uses all of the API functions defined in 'PS3EyeMulticam.h' file. Here is the 'PS3EyeMulticamTest.cpp' file:

//
// PS3EyeMulticamTest.cpp
//
// This is a quick test application for the
// CL-Eye Multicam driver
//
// To build it, in VS2008 create en empty window app project
// and add all the files in this folder to it.
//
#include "stdafx.h"

#define WINDOW_NAME     "Capture Window"
bool bRunning = false;
int w, h;

// Capture thread
DWORD WINAPI Capture(LPVOID)
{
    IplImage *grayImage = cvCreateImage(cvSize(w, h), IPL_DEPTH_8U, 1);
    PS3EyeMulticamStart();
    while(bRunning)
    {
        PBYTE pBuffer = NULL;
        cvGetImageRawData(grayImage, &pBuffer);
        PS3EyeMulticamGetFrame(pBuffer);
        cvShowImage(WINDOW_NAME, grayImage);
    }
    PS3EyeMulticamStop();
    cvReleaseImage(&grayImage);
    return 0;
}

void Program()
{
    // Query driver for number of connected PS3Eye cameras
    int camCnt = PS3EyeMulticamGetCameraCount();
    printf("Found %d PS3Eye cameras\n", camCnt);
    if(camCnt == 0)
    {
        MessageBox(NULL,"No PS3Eye camera(s) found","PS3EyeMulticamTest", MB_ICONEXCLAMATION);
        return;
    }
    // Open cameras
    if(!PS3EyeMulticamOpen(camCnt, VGA, 30))
    {
        MessageBox(NULL,"Could not open PS3Eye camera(s)","PS3EyeMulticamTest", MB_ICONEXCLAMATION);
        return;
    }
    // Load the default camera settings 'settings.xml' file
    // If the file is not found it will be created
    PS3EyeMulticamLoadSettings("settings.xml");

    // Get output image dimensions
    PS3EyeMulticamGetFrameDimensions(w, h);
    printf("Image dimensions (%d, %d)\n", w, h);

    // Create OpenCV main window
    cvNamedWindow(WINDOW_NAME, CV_WINDOW_AUTOSIZE);
    cvMoveWindow(WINDOW_NAME, 0, 0);
    cvResizeWindow(WINDOW_NAME, w, h);

    // Start PS3Eye image capture thread
    HANDLE hThread = CreateThread(NULL, 0, Capture, NULL, 0, 0);
    if(hThread == NULL)
    {
        MessageBox(NULL,"Could not create capture thread","PS3EyeMulticamTest", MB_ICONEXCLAMATION);
        PS3EyeMulticamClose();
        return;
    }
    bRunning = true;
    // The 's' key will open camera settings dialog
    while(bRunning)
    {
        int key = cvWaitKey(0);
        switch(key)
        {
            case 's':
            case 'S':
                // Display settings
                PS3EyeMulticamShowSettings();
            break;
            case 0x1b:
                printf("Exiting...\n");
                // Stop the capture thread
                bRunning = false;
                // Wait for thread to exit
                WaitForSingleObject(hThread, 3000);
                printf("Thread exited\n");
            break;
        }
    }
    // Save camera settings
    printf("Saving settings\n");
    PS3EyeMulticamSaveSettings();
    printf("Closing OpenCV window\n");
    cvDestroyWindow(WINDOW_NAME);
    PS3EyeMulticamClose();
}

// This is the program entry if you link with /SUBSYSTEM:CONSOLE option
int main(int argc, char *argv[])
{
    Program();
    return 0;
}

// This is the program entry if you link with /SUBSYSTEM:WINDOWS option
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd)
{
    Program();
    return 0;
}
You can find more code examples in our downloads page: CL-Eye Platform SDK

Research Home
Related Resources
CL-Eye Platform Downloads CL-Eye Platform Documentation
Research Categories
- Code
- AS3
- C#
- C++
- Java
- Community
- Development
- Downloads
- Hardware
- Product
- CL NUI Platform
- CL Studio
- CL-Eye Driver
- CL-Eye SDK
- Research
- Security
- Software
- Tutorials
Related Tags

AS3 CL-Eye Multicam Flash

Home
Research
View