SUMMARY:
This article helps developers get started in migrating their FlyCapture 1.x applications to the FlyCapture 2.0 interface.
| APPLICABLE PRODUCTS :
|
|
FlyCapture 1.0 SDK •
FlyCapture 2.0 SDK •
|
ANSWER:
Transitioning to FlyCapture 2.0
With the release of version 2.0 of the FlyCapture SDK, users can now program Point Grey cameras using a single cross-platform interface that supports both Microsoft Windows and Linux Ubuntu operating systems. Other key features include support for new IIDC 1.32 features, such as frame buffering and lookup table functionality, and a simplified object-oriented interface aimed to produce a cleaner, more robust code base for developers.
In most cases, a translation layer allows FlyCapture 1.x applications to run against a FlyCapture 2.0 installation. For information about FlyCapture 1.x functions that are not supported in FlyCapture 2.0, refer to the topic Backward Compatibility with FlyCapture 1.x in the FlyCapture 2.0 SDK Help. Any future FlyCapture 1.x releases will provide maintenance enhancements only. New features will be added to FlyCapture 2.x releases exclusively. We encourage FlyCapture 1.x users to upgrade their applications to the new FlyCapture 2.0 class libraries. To assist in this transition, all of the sample applications provided with the FlyCapture 1.x SDK have been re-written to show parallel functionality using the 2.0 interface. An easy way to locate a FlyCapture 1.x sample application and its corresponding version using the 2.0 libraries is to access the FlyCapture SDK Example Source Code page, and perform a comparison for the examples that are of interest.
As a first step, we've provided a side-by-side comparison of the primary library calls in the FlyCapture 1.x example program PGRFlyCaptureTest, and its corresponding example in FlyCapture 2.0, FlyCapture2Test.
| FlyCaptureTest Task |
FlyCapture 1.x Library Call |
FlyCapture 2.x Library Call |
|
Create a camera context. |
flycaptureCreateContext() |
Construct a Camera() object and invoke Connect() against it. |
| Initialize the camera. |
flycaptureInitialize() |
| Retrieve basic camera information. |
flycaptureGetCameraInfo() |
GetCameraInfo() |
| Start the camera and begin streaming images to image buffers. |
flycaptureStart() |
StartCapture() |
| Create an image variable containing image data and metadata. |
struct FlyCaptureImage |
Construct an Image() object |
| Grab images from the image buffer. |
flycaptureGrabImage2() |
RetrieveBuffer() |
| Convert the last grabbed image to a format for display, such as BGRU. |
flycaptureConvertImage() |
Convert() |
| Save the image in a specified format. |
flycaptureSaveImage() |
Save() |
| Stop the camera. |
flycaptureStop() |
StopCapture() |
| Destroy the camera context. |
flycaptureDestroyContext() |
Disconnect() |
Example programs can also be accessed either from the Windows Start Menu (All Programs > Point Grey Research Inc. > PGR FlyCapture or FlyCapture2 > Examples) or in the \src folder of the PGR FlyCapture or FlyCapture2 installation directory.
ARTICLE INFO:
Article ID: |
342 |
Published: |
1/12/2010 2:34:36 PM |
Last Modified: |
1/12/2010 2:54:34 PM |
Keywords: |
FlyCapture, migrate |
Issue Type: |
Normal Use |
|
