Spinnaker C++
2.6.0.0
Compression.cpp

Compression.cpp shows how to utilize the compression features on a supported camera and in the Spinnaker SDK. It relies on information provided in the Acquisition, Enumeration, ChunkData, and NodeMapInfo examples.

This example covers all of the following: the preparation of a camera to acquire compressed images (or compressed chunk images), image retrieval, image saving, loading compressed images from disk, reconstructing compressed images, and converting compressed images.

//=============================================================================
// Copyright (c) 2001-2021 FLIR Systems, Inc. All Rights Reserved.
//
// This software is the confidential and proprietary information of FLIR
// Integrated Imaging Solutions, Inc. ("Confidential Information"). You
// shall not disclose such Confidential Information and shall use it only in
// accordance with the terms of the license agreement you entered into
// with FLIR Integrated Imaging Solutions, Inc. (FLIR).
//
// FLIR MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF THE
// SOFTWARE, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
// PURPOSE, OR NON-INFRINGEMENT. FLIR SHALL NOT BE LIABLE FOR ANY DAMAGES
// SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR DISTRIBUTING
// THIS SOFTWARE OR ITS DERIVATIVES.
//=============================================================================
#include "Spinnaker.h"
#include <iostream>
#include <sstream>
#include <fstream>
using namespace Spinnaker;
using namespace Spinnaker::GenApi;
using namespace Spinnaker::GenICam;
using namespace std;
// Use the following global constant to select whether to stream with compressed
// chunk images along with other compressed related data
const bool enableChunkData = false;
{
string fileName;
size_t compressedImageSize;
size_t imageWidth;
size_t imageHeight;
size_t imageXOffset;
size_t imageYOffset;
PixelFormatEnums imagePixelFormat;
const string& fileName,
size_t imageSize,
size_t width,
size_t height,
size_t xOffset,
size_t yOffset,
PixelFormatEnums pixelFormat)
: fileName(fileName), compressedImageSize(imageSize), imageWidth(width), imageHeight(height),
imageXOffset(xOffset), imageYOffset(yOffset), imagePixelFormat(pixelFormat)
{
}
};
#ifdef _DEBUG
// Disables heartbeat on GEV cameras so debugging does not incur timeout errors
bool DisableHeartbeat(INodeMap& nodeMap, INodeMap& nodeMapTLDevice)
{
cout << "Checking device type to see if we need to disable the camera's heartbeat..." << endl << endl;
//
// Write to boolean node controlling the camera's heartbeat
//
// *** NOTES ***
// This applies only to GEV cameras and only applies when in DEBUG mode.
// GEV cameras have a heartbeat built in, but when debugging applications the
// camera may time out due to its heartbeat. Disabling the heartbeat prevents
// this timeout from occurring, enabling us to continue with any necessary debugging.
// This procedure does not affect other types of cameras and will prematurely exit
// if it determines the device in question is not a GEV camera.
//
// *** LATER ***
// Since we only disable the heartbeat on GEV cameras during debug mode, it is better
// to power cycle the camera after debugging. A power cycle will reset the camera
// to its default settings.
//
CEnumerationPtr ptrDeviceType = nodeMapTLDevice.GetNode("DeviceType");
if (!IsAvailable(ptrDeviceType) || !IsReadable(ptrDeviceType))
{
cout << "Error with reading the device's type. Aborting..." << endl << endl;
return false;
}
else
{
if (ptrDeviceType->GetIntValue() == DeviceType_GigEVision)
{
cout << "Working with a GigE camera. Attempting to disable heartbeat before continuing..." << endl << endl;
CBooleanPtr ptrDeviceHeartbeat = nodeMap.GetNode("GevGVCPHeartbeatDisable");
if (!IsAvailable(ptrDeviceHeartbeat) || !IsWritable(ptrDeviceHeartbeat))
{
cout << "Unable to disable heartbeat on camera. Continuing with execution as this may be non-fatal..."
<< endl
<< endl;
}
else
{
ptrDeviceHeartbeat->SetValue(true);
cout << "WARNING: Heartbeat on GigE camera disabled for the rest of Debug Mode." << endl;
cout << " Power cycle camera when done debugging to re-enable the heartbeat..." << endl << endl;
}
}
else
{
cout << "Camera does not use GigE interface. Resuming normal execution..." << endl << endl;
}
}
return true;
}
#endif
// This function acquires and saves 10 images from a device.
// Please see Acquisition example for more in-depth comments on acquiring,
// converting and saving images from a device.
CameraPtr pCam,
INodeMap& nodeMap,
INodeMap& nodeMapTLDevice,
vector<CompressedImageInfo>& compressedImageInfos)
{
int result = 0;
cout << endl << endl << "*** IMAGE ACQUISITION ***" << endl << endl;
try
{
// Set acquisition mode to continuous
// Retrieve enumeration node from nodemap
CEnumerationPtr ptrAcquisitionMode = nodeMap.GetNode("AcquisitionMode");
if (!IsAvailable(ptrAcquisitionMode) || !IsWritable(ptrAcquisitionMode))
{
cout << "Unable to set acquisition mode to continuous (enum retrieval). Aborting..." << endl << endl;
return -1;
}
// Retrieve entry node from enumeration node
CEnumEntryPtr ptrAcquisitionModeContinuous = ptrAcquisitionMode->GetEntryByName("Continuous");
if (!IsAvailable(ptrAcquisitionModeContinuous) || !IsReadable(ptrAcquisitionModeContinuous))
{
cout << "Unable to set acquisition mode to continuous (entry retrieval). Aborting..." << endl << endl;
return -1;
}
// Retrieve integer value from entry node
const int64_t acquisitionModeContinuous = ptrAcquisitionModeContinuous->GetValue();
// Set integer value from entry node as new value of enumeration node
ptrAcquisitionMode->SetIntValue(acquisitionModeContinuous);
cout << "Acquisition mode set to continuous..." << endl;
#ifdef _DEBUG
cout << endl << endl << "*** DEBUG ***" << endl << endl;
// If using a GEV camera and debugging, should disable heartbeat first to prevent further issues
if (!DisableHeartbeat(nodeMap, nodeMapTLDevice))
{
return -1;
}
cout << endl << endl << "*** END OF DEBUG ***" << endl << endl;
#endif
// Begin acquiring images
pCam->BeginAcquisition();
cout << "Acquiring images..." << endl;
// Retrieve device serial number for filename
gcstring deviceSerialNumber("");
CStringPtr ptrStringSerial = nodeMapTLDevice.GetNode("DeviceSerialNumber");
if (IsAvailable(ptrStringSerial) && IsReadable(ptrStringSerial))
{
deviceSerialNumber = ptrStringSerial->GetValue();
cout << "Device serial number retrieved as " << deviceSerialNumber << "..." << endl;
}
cout << endl;
// Retrieve, convert, and save images
const unsigned int k_numImages = 10;
for (unsigned int imageCnt = 0; imageCnt < k_numImages; imageCnt++)
{
try
{
// Retrieve next received image
ImagePtr pResultImage = pCam->GetNextImage(1000);
// Ensure image completion
if (pResultImage->IsIncomplete())
{
// Retrieve and print the image status description
cout << "Image incomplete: " << Image::GetImageStatusDescription(pResultImage->GetImageStatus())
<< "..." << endl
<< endl;
}
else
{
//
// Print image information
//
// *** NOTES ***
// IsCompressed() can be used to verify if the grabbed images indeed have compression enabled.
//
const size_t width = pResultImage->GetWidth();
const size_t height = pResultImage->GetHeight();
const bool isCompressed = pResultImage->IsCompressed();
cout << "Grabbed image " << imageCnt << ", width = " << width << ", height = " << height
<< ", IsCompressed = " << (isCompressed ? "true" : "false");
//
// Here we utilize the chunk data feature to retrieve the compression ratio of
// each compressed image. For more in-depth comments about using chunk data,
// please see the ChunkData example.
//
{
ChunkData chunkData = pResultImage->GetChunkData();
const double compressionRatio = static_cast<double>(chunkData.GetCompressionRatio());
const int64_t chunkImageCRC = chunkData.GetCRC();
cout << ", compression ratio = " << compressionRatio << ", CRC = " << chunkImageCRC;
}
cout << endl;
//
// If chunk data is enabled, chunk image CRC will be available by default and we could
// check if the library computed checksum of the image payload matches with chunk
// data provided image checksum. Note that mismatching CRC could lead to decompression
// errors and image integrity issues.
//
if (pResultImage->HasCRC())
{
if (!pResultImage->CheckCRC())
{
cout << "WARNING: CRC mismatch could lead to image decompression failures" << endl;
}
}
// Create a unique filename
ostringstream filename;
filename << "Compression-";
if (!deviceSerialNumber.empty())
{
filename << deviceSerialNumber.c_str() << "-";
}
filename << imageCnt;
// Save image
//
// *** NOTES ***
// In this example, we are demonstrating how to save compressed images to disk
// and later, how to load the saved images for post processing.
//
// In order to save the images in their compressed form, we must save with the .raw
// format because saving in other file formats automatically performs decompression
// and color processing. Regardless of whether chunk data is enabled or not, only the
// image data will be saved in the raw file and none of the other chunk data enabled
// will be preserved when the raw file is loaded back in memory.
//
// Note that in the CompressedImageInfo, we are saving all the information required
// to reconstruct this image when we load it back from disk later.
// Also note that GetImageSize() here returns the size of the image data in its
// compressed form.
//
pResultImage->Save(filename.str().c_str(), RAW);
cout << "Image saved at " << filename.str() << ".raw" << endl;
const CompressedImageInfo imageInfo(
filename.str(),
pResultImage->GetImageSize(),
width,
height,
pResultImage->GetXOffset(),
pResultImage->GetYOffset(),
pResultImage->GetPixelFormat());
compressedImageInfos.push_back(imageInfo);
}
// Release image
pResultImage->Release();
cout << endl;
}
{
cout << "Error: " << e.what() << endl;
result = -1;
}
}
// End acquisition
pCam->EndAcquisition();
}
{
cout << "Error: " << e.what() << endl;
return -1;
}
return result;
}
// This function prints the device information of the camera from the transport
// layer. Please see NodeMapInfo example for more in-depth comments on printing
// device information from the nodemap.
{
int result = 0;
cout << endl << "*** DEVICE INFORMATION ***" << endl << endl;
try
{
FeatureList_t features;
const CCategoryPtr category = nodeMap.GetNode("DeviceInformation");
if (IsAvailable(category) && IsReadable(category))
{
category->GetFeatures(features);
for (auto it = features.begin(); it != features.end(); ++it)
{
const CNodePtr pfeatureNode = *it;
cout << pfeatureNode->GetName() << " : ";
CValuePtr pValue = static_cast<CValuePtr>(pfeatureNode);
cout << (IsReadable(pValue) ? pValue->ToString() : "Node not readable");
cout << endl;
}
}
else
{
cout << "Device control information not available." << endl;
}
}
{
cout << "Error: " << e.what() << endl;
result = -1;
}
return result;
}
// This function configures the necessary features to enable image chunk data on the camera.
{
try
{
cout << endl << "Configuring camera settings to enable image chunk data..." << endl;
//
// Enable chunk mode and image chunk data for compression ratio
//
// *** NOTES ***
// Enabling chunk data for compression ratio allows us to inspect the compression ratio of
// each individual image. This is not a requirement for using the image compression features.
//
// For more in-depth comments about using chunk data, see the ChunkData example
//
bool chunkAvailableAndEnabled = false;
// Activate chunk mode
CBooleanPtr ptrChunkModeActive = nodeMap.GetNode("ChunkModeActive");
if (IsAvailable(ptrChunkModeActive) && IsWritable(ptrChunkModeActive))
{
ptrChunkModeActive->SetValue(true);
// Retrieve the selector node
CEnumerationPtr ptrChunkSelector = nodeMap.GetNode("ChunkSelector");
if (IsReadable(ptrChunkSelector) && IsWritable(ptrChunkSelector))
{
CEnumEntryPtr ptrCompressionRatioEntry = ptrChunkSelector->GetEntryByName("CompressionRatio");
if (IsAvailable(ptrCompressionRatioEntry) && IsReadable(ptrCompressionRatioEntry))
{
ptrChunkSelector->SetIntValue(ptrCompressionRatioEntry->GetValue());
// Retrieve corresponding boolean
CBooleanPtr ptrChunkEnable = nodeMap.GetNode("ChunkEnable");
// Enable the boolean, thus enabling the chunk data
if (IsAvailable(ptrChunkEnable) && IsWritable(ptrChunkEnable))
{
ptrChunkEnable->SetValue(true);
chunkAvailableAndEnabled = true;
}
}
}
}
cout << "CompressionRatio chunk data " << (chunkAvailableAndEnabled ? "enabled" : "not enabled") << endl;
}
{
cout << "Unexpected error while configuring image chunk data: " << e.what() << endl;
return false;
}
return true;
}
// This function shows how to disable image chunk data
{
try
{
cout << endl << "Disabling image chunk data..." << endl;
// Disable image compression on the camera
CEnumerationPtr ptrChunkSelector = nodeMap.GetNode("ChunkSelector");
if (IsReadable(ptrChunkSelector) && IsWritable(ptrChunkSelector))
{
CEnumEntryPtr ptrCompressionRatioEntry = ptrChunkSelector->GetEntryByName("CompressionRatio");
if (IsAvailable(ptrCompressionRatioEntry) && IsReadable(ptrCompressionRatioEntry))
{
ptrChunkSelector->SetIntValue(ptrCompressionRatioEntry->GetValue());
// Retrieve corresponding boolean
CBooleanPtr ptrChunkEnable = nodeMap.GetNode("ChunkEnable");
// Disable the boolean, thus disabling the CompressionRatio chunk data
if (IsAvailable(ptrChunkEnable) && IsWritable(ptrChunkEnable))
{
ptrChunkEnable->SetValue(false);
}
}
}
// De-activate chunk mode
CBooleanPtr ptrChunkModeActive = nodeMap.GetNode("ChunkModeActive");
if (IsAvailable(ptrChunkModeActive) && IsWritable(ptrChunkModeActive))
{
ptrChunkModeActive->SetValue(false);
}
cout << "Disabled image chunk data..." << endl;
}
{
cout << "Unexpected error while disabling image chunk data: " << e.what() << endl;
return false;
}
return true;
}
// This function configures the necessary features to enable image compression on the camera.
{
try
{
cout << endl << "Configuring camera settings to enable image compression..." << endl;
// Select supported pixel format
//
// *** NOTES ***
// Currently, only the BayerRG8 and Mono8 pixel formats support image compression.
// User must first select one of these pixel formats for the image compression features to be available.
//
CEnumerationPtr ptrPixelFormat = nodeMap.GetNode("PixelFormat");
if (!IsAvailable(ptrPixelFormat) || !IsWritable(ptrPixelFormat))
{
cout << "Unable to set pixel format. Aborting..." << endl << endl;
return false;
}
// Disable ISP
//
// *** NOTES ***
// The image signal processor (ISP) has to be disabled before any compression features can be configured.
//
// Note that we recommend setting the pixel format before disabling ISP because sometimes selecting
// a pixel format may result in the ISP being enabled again.
//
CBooleanPtr ptrIspEnable = nodeMap.GetNode("IspEnable");
if (IsAvailable(ptrIspEnable) && IsWritable(ptrIspEnable))
{
ptrIspEnable->SetValue(false);
cout << "IspEnable set to false..." << endl;
}
CEnumEntryPtr ptrPixelFormatBayerRG8 = ptrPixelFormat->GetEntryByName("BayerRG8");
if (!IsAvailable(ptrPixelFormatBayerRG8) || !IsReadable(ptrPixelFormatBayerRG8))
{
CEnumEntryPtr ptrPixelFormatMono8 = ptrPixelFormat->GetEntryByName("Mono8");
if (!IsAvailable(ptrPixelFormatMono8) || !IsReadable(ptrPixelFormatMono8))
{
cout << "Unable to set pixel format to BayerRG8 or Mono8. Aborting..." << endl << endl;
return false;
}
ptrPixelFormat->SetIntValue(ptrPixelFormatMono8->GetValue());
cout << "Pixel format set to " << ptrPixelFormatMono8->GetSymbolic() << "..." << endl;
}
else
{
ptrPixelFormat->SetIntValue(ptrPixelFormatBayerRG8->GetValue());
cout << "Pixel format set to " << ptrPixelFormatBayerRG8->GetSymbolic() << "..." << endl;
}
// Select the lossless compression feature
//
// *** NOTES ***
// The lossless image compression allows the camera to achieve higher acquisition frame rate by reducing
// the image size. However, the compression ratio can vary significantly depending on the image complexity.
//
CEnumerationPtr ptrCompressionMode = nodeMap.GetNode("ImageCompressionMode");
if (!IsAvailable(ptrCompressionMode) || !IsWritable(ptrCompressionMode))
{
cout << "Unable to set image compression mode to Lossless (enum retrieval). Aborting..." << endl << endl;
return false;
}
CEnumEntryPtr ptrCompressionModeLossless = ptrCompressionMode->GetEntryByName("Lossless");
if (!IsAvailable(ptrCompressionModeLossless) || !IsReadable(ptrCompressionModeLossless))
{
cout << "Unable to set image compression mode to Lossless (entry retrieval). Aborting..." << endl << endl;
return false;
}
ptrCompressionMode->SetIntValue(ptrCompressionModeLossless->GetValue());
cout << "Compression mode set to " << ptrCompressionModeLossless->GetSymbolic() << "..." << endl;
// Print the current compression configurations
cout << endl << "*** COMPRESSION SETTINGS ***" << endl << endl;
cout << "Compression Mode: "
<< (IsReadable(ptrCompressionMode) ? ptrCompressionMode->ToString() : "Node not readable") << endl;
// Number of bytes in each block of compressed data that can be decoded independently of other blocks
CIntegerPtr ptrCompressionBlockSize = nodeMap.GetNode("LosslessCompressionBlockSize");
cout << "Compression Block Size: "
<< (IsReadable(ptrCompressionBlockSize) ? ptrCompressionBlockSize->ToString() : "Node not readable")
<< endl;
// The ratio between the uncompressed image size and compressed image size
CFloatPtr ptrCompressionRatio = nodeMap.GetNode("CompressionRatio");
cout << "Compression Ratio: "
<< (IsReadable(ptrCompressionRatio) ? ptrCompressionRatio->ToString() : "Node not readable") << endl;
// Determines how the camera handles situations where the datarate of the compressed frames exceeds the datarate
// of the interface.
string compressionSaturationPriority = "Node not readable";
CEnumerationPtr ptrCompressionSaturationPriority = nodeMap.GetNode("CompressionSaturationPriority");
if (IsReadable(ptrCompressionSaturationPriority))
{
CEnumEntryPtr ptrCompressionSaturationPriorityEntry = ptrCompressionSaturationPriority->GetCurrentEntry();
if (IsReadable(ptrCompressionSaturationPriorityEntry))
{
compressionSaturationPriority = ptrCompressionSaturationPriorityEntry->GetSymbolic();
}
}
cout << "Compression Saturation Priority: " << compressionSaturationPriority << endl;
}
{
cout << "Unexpected error while configuring image compression: " << e.what() << endl;
return false;
}
return true;
}
// This function shows how to disable image compression
{
try
{
cout << endl << "Disabling image compression..." << endl;
// Disable image compression on the camera
//
// *** NOTES ***
// Disabling image compression on the camera is as easy as setting the ImageCompressionMode to "Off"
//
CEnumerationPtr ptrCompressionMode = nodeMap.GetNode("ImageCompressionMode");
if (!IsAvailable(ptrCompressionMode) || !IsWritable(ptrCompressionMode))
{
cout << "Unable to set image compression mode to Off (enum retrieval). Aborting..." << endl << endl;
return false;
}
CEnumEntryPtr ptrCompressionModeOff = ptrCompressionMode->GetEntryByName("Off");
if (!IsAvailable(ptrCompressionModeOff) || !IsReadable(ptrCompressionModeOff))
{
cout << "Unable to set image compression mode to Off (entry retrieval). Aborting..." << endl << endl;
return false;
}
ptrCompressionMode->SetIntValue(ptrCompressionModeOff->GetValue());
cout << "Compression mode set to " << ptrCompressionModeOff->GetSymbolic() << "..." << endl;
}
{
cout << "Unexpected error while disabling image compression: " << e.what() << endl;
return false;
}
return true;
}
// This function loads compressed images from file, performs post-processing on them and
// saves the resulting images
int ProcessCompressedImagesFromFile(const vector<CompressedImageInfo>& compressedImageInfos)
{
int result = 0;
// Set the number of decompression threads to use
//
// *** NOTES ***
// The number of threads used by Spinnaker when performing image decompression is
// defaulted to be equal to one less than the number of concurrent threads
// supported by the system. This should already result in the fastest
// decompression speed.
//
// However, this can be configured through the SetNumDecompressionThreads() function,
// and this setting will persist for all future calls to Convert().
//
// A higher thread count will result in faster decompression but higher CPU usage, whereas
// a lower thread count will result in slower decompression but lower CPU usage.
//
unsigned int kNumDecompressionThreads = 4;
try
{
Image::SetNumDecompressionThreads(kNumDecompressionThreads);
cout << "Number of decompression threads set to " << kNumDecompressionThreads << endl << endl;
}
{
cout << "Unexpected error when setting the number of decompression threads to " << kNumDecompressionThreads
<< endl;
cout << "Error: " << se.what() << endl;
result = -1;
}
for (auto imageInfo = compressedImageInfos.begin(); imageInfo != compressedImageInfos.end(); ++imageInfo)
{
// Load previously saved compressed images from disk
ifstream file(imageInfo->fileName + ".raw", ios::binary | ios::in);
if (!file)
{
cout << "Failed to load image " << imageInfo->fileName << endl;
result = -1;
continue;
}
cout << "Loading compressed image from '" << imageInfo->fileName << ".raw'" << endl;
std::shared_ptr<char> imageBuffer(new char[imageInfo->compressedImageSize], std::default_delete<char[]>());
file.read(imageBuffer.get(), imageInfo->compressedImageSize);
file.close();
// Reconstruct the Spinnaker ImagePtr
//
// *** NOTES ***
// Using the Create() function allows us to construct a Spinnaker ImagePtr with our
// own image data pointers. Later, we will utilize the Spinnaker SDK to perform
// image post processing on the newly constructed Spinnaker ImagePtr.
//
// Note that it is especially important to use this overloaded Create() function
// because it allows us to specify the image payload type as one of the input
// parameters. Spinnaker will require this information to correctly process
// this image as a lossless compressed image. As mentioned previously, regardless
// of whether chunk data is enabled or not, only the image data is saved to disk
// so the non-chunk payload type needs to be specified when loading the image back
// to memory.
//
// Also note that we are using the compressed image size (saved from earlier) as an input
// parameter instead of calculating an image size based on the image width, height and
// pixel format.
//
ImagePtr loadedCompressedImage;
try
{
loadedCompressedImage = Image::Create(
imageInfo->imageWidth,
imageInfo->imageHeight,
imageInfo->imageXOffset,
imageInfo->imageYOffset,
imageInfo->imagePixelFormat,
imageBuffer.get(),
PAYLOAD_TYPE_LOSSLESS_COMPRESSED, // Note: Chunk data is not preserved when saved to disk
// therefore the non-chunk payload type is specified
imageInfo->compressedImageSize);
//
// Perform decompression and image processing
//
// *** NOTES ***
// When converting a compressed image, Spinnaker will first decompress the image
// before performing other conversion steps such as debayering. As noted above,
// the decompression portion of the operation may be multi-threaded depending on
// the number of threads set by the most recent call to SetNumDecompressionThreads().
//
// Note that if we only wanted Spinnaker to perform decompression without further image
// processing, we could call Convert with the same pixel format as the compressed image.
//
ImagePtr convertedImage = loadedCompressedImage->Convert(PixelFormat_RGB8, HQ_LINEAR);
// Save converted image
convertedImage->Save(imageInfo->fileName.c_str(), JPEG);
cout << "Image saved at " << imageInfo->fileName << ".jpg" << endl;
}
{
cout << "Unexpected error when processing " << imageInfo->fileName << endl;
cout << "Error: " << se.what() << endl;
result = -1;
continue;
}
}
return result;
}
// This function acts as the body of the example; please see NodeMapInfo example
// for more in-depth comments on setting up cameras.
{
int result = 0;
try
{
// Retrieve TL device nodemap and print device information
INodeMap& nodeMapTLDevice = pCam->GetTLDeviceNodeMap();
result = PrintDeviceInfo(nodeMapTLDevice);
// Initialize camera
pCam->Init();
// Retrieve GenICam nodemap
INodeMap& nodeMap = pCam->GetNodeMap();
// Enable chunk data features
{
cout << "Failed to enable image chunk data. Please check if image chunk data is supported on this camera"
<< endl;
return -1;
}
// Enable compression features
if (!EnableImageCompression(nodeMap))
{
cout << "Failed to enable image compression. Please check if image compression is supported on this camera"
<< endl;
return -1;
}
// Acquire images
vector<CompressedImageInfo> compressedImageInfos;
result = result | AcquireImages(pCam, nodeMap, nodeMapTLDevice, compressedImageInfos);
// Load compressed images from file and perform post-processing
result = result | ProcessCompressedImagesFromFile(compressedImageInfos);
// Disable image compression
if (!DisableImageCompression(nodeMap))
{
cout << "Failed to disable image compression." << endl;
result = -1;
}
// Disable chunk data
{
cout << "Failed to disable image chunk data." << endl;
result = -1;
}
// Deinitialize camera
pCam->DeInit();
}
{
cout << "Error: " << e.what() << endl;
result = -1;
}
return result;
}
// Example entry point; please see Enumeration example for more in-depth
// comments on preparing and cleaning up the system.
int main(int /*argc*/, char** /*argv*/)
{
// Since this application saves images in the current folder
// we must ensure that we have permission to write to this folder.
// If we do not have permission, fail right away.
FILE* tempFile = fopen("test.txt", "w+");
if (tempFile == nullptr)
{
cout << "Failed to create file in current folder. Please check "
"permissions."
<< endl;
cout << "Press Enter to exit..." << endl;
getchar();
return -1;
}
fclose(tempFile);
remove("test.txt");
// Print application build information
cout << "Application build date: " << __DATE__ << " " << __TIME__ << endl << endl;
// Retrieve singleton reference to system object
// Print out current library version
const LibraryVersion spinnakerLibraryVersion = system->GetLibraryVersion();
cout << "Spinnaker library version: " << spinnakerLibraryVersion.major << "." << spinnakerLibraryVersion.minor
<< "." << spinnakerLibraryVersion.type << "." << spinnakerLibraryVersion.build << endl
<< endl;
// Retrieve list of cameras from the system
CameraList camList = system->GetCameras();
const unsigned int numCameras = camList.GetSize();
cout << "Number of cameras detected: " << numCameras << endl << endl;
// Finish if there are no cameras
if (numCameras == 0)
{
// Clear camera list before releasing system
camList.Clear();
// Release system
system->ReleaseInstance();
cout << "Not enough cameras!" << endl;
cout << "Done! Press Enter to exit..." << endl;
getchar();
return -1;
}
// Create shared pointer to camera
CameraPtr pCam = nullptr;
int result = 0;
// Run example on each camera
for (unsigned int i = 0; i < numCameras; i++)
{
// Select camera
pCam = camList.GetByIndex(i);
cout << endl << "Running example for camera " << i << "..." << endl;
// Run example
result = result | RunSingleCamera(pCam);
cout << "Camera " << i << " example complete..." << endl << endl;
}
// Release reference to the camera
pCam = nullptr;
// Clear camera list before releasing system
camList.Clear();
// Release system
system->ReleaseInstance();
cout << endl << "Done! Press Enter to exit..." << endl;
getchar();
return result;
}
Contact Support Spinnaker® SDK Programmer's Guide and API Reference