Back to Aurora Vision Library website

You are here: Start » Function Reference » Camera Support » Ensenso » Ensenso_LoadSettings_Deprecated

Ensenso_LoadSettings_Deprecated


Header: ThirdPartySdk.h
Namespace: avl
Module: ThirdParty

Load parameters data from a file.

Syntax

void avl::Ensenso_LoadSettings_Deprecated
(
	Ensenso_State& ioState,
	const atl::Optional<atl::String> inDeviceID,
	const atl::File& inSettingsFile
)

Parameters

Name Type Default Description
Input will be modified ioState Ensenso_State& Object used to maintain state of the function.
Input value inDeviceID const Optional<String> NIL Device identifying number.
Input value inSettingsFile const File& JSON encoded parameters for camera.

Description

Loads Parameters node from settings file.

Remarks

Settings

To obtain settings from the camera:

  • From NxView Parameters window
    • Launch NxView
    • Open camera
    • Open Parameters window (menu Capture->Parameters...)
    • Adjust settings as wanted
    • Use Save... button
  • From NxTreeEdit application
    • Either:
      • Launch Aurora Vision Studio, add Ensenso_GrabPoint3DGrid_Deprecated filter, Run it
      • Launch NxView, open camera
    • Launch NxTreeEdit, connect to wanted instance
    • Adjust settings as wanted, either in NxView or NxTreeEdit
    • right click on /Cameras/BySerialNo/WantedSerialNumber and select Copy value as JSON string
    • save to a simple text file using an editor

The settings include all camera parameters, including Link, Calibration and Parameters The saved file can be then used in inCalibrationFile and inSettingsFile arguments.

Camera identification

When there is only one Ensenso camera connected, the field inDeviceID can be set to Auto. In this situation, the first available camera will be used.

inDeviceID can be used to pick one of multiple cameras connected to the computer. inDeviceID should be set to camera ID.

Camera driver software

This filter is intended to cooperate with cameras using their vendor's SDK. In order to connect with the camera, it is required to install Ensenso SDK software, and uEye driver (same as in IDS camera filters)

Ensenso SDK and uEye driver can be downloaded from the following website: https://www.optonic.com/en/support/download/ensenso-sdk/

Recommended Ensenso SDK version for Aurora Vision Studio usage is 3.5.1419 and uEye driver 4.96.1.

Multithreaded environment

This function is not guaranteed to be thread-safe. When used in multithreaded environment, it has to be manually synchronized.