Opening a Camera and Setting Parameters

Navigation:  NxLib API > HowTo's >

Opening a Camera and Setting Parameters

 Previous pageReturn to chapter overviewNext page

Show/Hide Hidden Text

This example shows how to open a camera and modify some camera parameters thereafter.

Code Examples

hmtoggle_plus1C++

NxLibItem root; // References the tree's root item at path "/"
 
//replace "1234" with your camera's serial number:
NxLibItem camera = root[itmCameras][itmBySerialNo]["1234"]; // References the camera's item at path "/Cameras/BySerialNo/1234"
 
// Call the Open command to open the camera
NxLibCommand open(cmdOpen); // Note: the variable name 'open' does not matter; the constant 'cmdOpen' 
                            // specifies the name of the command to be executed when '.execute()' is called 
                            // on the object.
// Set parameters for the command
open.parameters()[itmCameras] = "1234"; // Insert the serial number of the camera to be opened into the Cameras parameter of Open
open.execute();
 
// At this point the parameter tree under /Cameras/BySerialNo/1234/Parameters contains the default values for all settings.
 
// Disable auto-exposure, auto-gain, and set exposure to 5ms and gain factor to 1.0 (i.e. no analog gain)
 
camera[itmParameters][itmCapture][itmAutoExposure] = false;
camera[itmParameters][itmCapture][itmAutoGain    ] = false;
camera[itmParameters][itmCapture][itmExposure] = 5.0;
camera[itmParameters][itmCapture][itmGain    ] = 1.0;
 
// You can now grab images and generate 3D point clouds with the new settings
...
hmtoggle_plus1Halcon/HDevelop

* Open the camera and reference the camera's item at path "/Cameras/BySerialNo/1234" 
* replace "1234" with your camera's serial number
open_framegrabber ('Ensenso-NxLib', 0, 0, 0, 0, 0, 0, 'default', 0, 'Raw', -1, 'false', 'Stereo', '1234', 0, 0, CameraHandle)
 
* At this point the parameter tree under /Cameras/BySerialNo/1234/Parameters contains the default values for all settings.
 
* Disable auto-exposure, auto-gain, and set exposure to 5ms and gain factor to 1.0 (i.e. no analog gain)
set_framegrabber_param (CameraHandle, 'Parameters/Capture/AutoExposure', 'false')
set_framegrabber_param (CameraHandle, 'Parameters/Capture/AutoGain', 'false')
set_framegrabber_param (CameraHandle, 'Parameters/Capture/Exposure', 5.0)
set_framegrabber_param (CameraHandle, 'Parameters/Capture/Gain', 1.0)
 
* You can now grab images and generate 3D point clouds with the new settings
...

An alternative, more compact version by creating another reference to the capture parameter subtree first:

hmtoggle_plus1C++

// Create an NxLibItem referencing the capture parameter subtree
NxLibItem captureParameters = camera[itmParameters][itmCapture];
 
captureParameters[itmAutoExposure] = false;
captureParameters[itmAutoGain    ] = false;
captureParameters[itmExposure] = 5.0;
captureParameters[itmGain    ] = 1.0;
hmtoggle_plus1Halcon/HDevelop

* Create an NxLibItem referencing the capture parameter subtree
get_framegrabber_param (CameraHandle, 'path', CameraPath)
open_framegrabber ('Ensenso-NxLib', 0, 0, 0, 0, 0, 0, 'default', 0, 'Raw', -1, 'false', 'Item', CameraPath + '/Parameters/Capture', 0, 0, CaptureParametersHandle)
 
set_framegrabber_param (CaptureParametersHandle, 'AutoExposure', 'false')
set_framegrabber_param (CaptureParametersHandle, 'AutoGain', 'false')
set_framegrabber_param (CaptureParametersHandle, 'Exposure', 5.0)
set_framegrabber_param (CaptureParametersHandle, 'Gain', 1.0)