User Set Control

Features in the User Set Control category allow you to save camera settings to non-volatile memory so that they can be restored to a known state at any time (after the camera has been restarted).

Types of User Sets

You can select which user set to configure, save, or load with the UserSetSelector feature. There are two classes of user sets.

  • User-defined settings
  • Factory-defined settings. A factory-defined Default user set is always available. It represents a typical use case for the camera.

If the factory-defined settings are not ideal, they can be used as a starting point. From there, only a few features may need to be modified to achieve the desired configuration. The UserSetSave feature saves the current camera settings so that they can be recreated later. Once saved, these new custom settings can be loaded at any time.

The UserSetLoad feature loads the specified user set. Note that one can load a set without first saving. In this situation, the user set contents are the factory-defined default settings.

Start-up User Set

The UserSetDefault feature is used to configure a camera automatically at start-up. This loads the selected user set at start-up time. By default, it applies the factory-defined Default settings. However, you can change it to any user set so that the next time the camera restarts, it comes up with the selected user set.

User Set Managed Features

Due to limited on-board non-volatile memory, not all features are supported by user sets. See UserSetFeatureSelector for the list of all features that are supported. Features that are not listed are either of single session nature or are managed explicitly via other features, such as Defect Table Save.

User Set Conversion

The exact list of features managed by user sets may change between different versions of firmware. Consequently, there may not be a perfect match between the set of features saved to non-volatile memory and the set of features handled by the current version of firmware. In this situation, the camera performs any necessary conversions on all saved user sets. This happens automatically the first time the camera is restarted after a firmware update. The conversion performed depends on the nature of the feature discrepancy:

  • Obsolete features - Saved features that are no longer supported in the current firmware. These features are ignored and removed from all subsequently saved user sets.
  • Missing features - Saved user sets do not have features that are supported in the current firmware. These missing feature values are filled in using one of the factory-defined sets. If UserSetDefault points to a user-defined set, then the missing feature values are copied from the factory-defined Default set.

Summary Table

Name Interface Access Visibility Description
User Set Selector IEnumeration RW Beginner Selects the feature User Set to load, save or configure.
User Set Load [User Set Selector] ICommand RW Expert Loads the User Set specified by UserSetSelector to the device and makes it active.
User Set Save [User Set Selector] ICommand RW Beginner Saves the User Set specified by UserSetSelector to the non-volatile memory of the device.
User Set Default IEnumeration RW Beginner Selects the feature User Set to load and make active by default when the device is restarted.
User Set Feature Selector IEnumeration RW Expert List of features that are saved to user sets.
User Set Feature Enable IBoolean RO Expert Whether or not the selected feature is saved to user sets.

User Set Control Features


User Set Selector

Selects the feature User Set to load, save or configure.

Property Value
Name UserSetSelector
Interface IEnumeration
Access RW
Visibility Beginner

Enumeration Values
Default
UserSet0
UserSet1

User Set Load

Loads the User Set specified by UserSetSelector to the device and makes it active.

Property Value
Name UserSetLoad [User Set Selector]
Interface ICommand
Access RW
Visibility Expert

User Set Save

Saves the User Set specified by UserSetSelector to the non-volatile memory of the device.

Property Value
Name UserSetSave [User Set Selector]
Interface ICommand
Access RW
Visibility Beginner

User Set Default

Selects the feature User Set to load and make active by default when the device is restarted.

Property Value
Name UserSetDefault
Interface IEnumeration
Access RW
Visibility Beginner

Enumeration Values
Default
UserSet0
UserSet1

User Set Feature Selector

List of features that are saved to user sets.

Property Value
Name UserSetFeatureSelector
Interface IEnumeration
Access RW
Visibility Expert

Enumeration Values
AasRoiEnableAe
AasRoiEnableAwb
AasRoiHeightAe
AasRoiHeightAwb
AasRoiOffsetXAe
AasRoiOffsetXAwb
AasRoiOffsetYAe
AasRoiOffsetYAwb
AasRoiWidthAe
AasRoiWidthAwb
AcquisitionBurstFrameCount
AcquisitionFrameCount
AcquisitionFrameRate
AcquisitionFrameRateEnable
AcquisitionLineRate
AcquisitionMode
AdcBitDepth
AutoExposureControlLoopDamping
AutoExposureControlPriority
AutoExposureEVCompensation
AutoExposureExposureTimeLowerLimit
AutoExposureExposureTimeUpperLimit
AutoExposureGainLowerLimit
AutoExposureGainUpperLimit
AutoExposureGreyValueLowerLimit
AutoExposureGreyValueUpperLimit
AutoExposureLightingMode
AutoExposureMeteringMode
AutoExposureTargetGreyValue
AutoExposureTargetGreyValueAuto
BalanceRatioBlue
BalanceRatioRed
BalanceWhiteAuto
BalanceWhiteAutoDamping
BalanceWhiteAutoLowerLimit
BalanceWhiteAutoProfile
BalanceWhiteAutoUpperLimit
BinningHorizontalAll
BinningHorizontalMode
BinningVerticalAll
BinningVerticalMode
BlackLevelAll
ChunkEnableAll
ChunkModeActive
ColorTransformationEnable
CounterDelayCounter0
CounterDelayCounter1
CounterDurationCounter0
CounterDurationCounter1
CounterEventActivationCounter0
CounterEventActivationCounter1
CounterEventSourceCounter0
CounterEventSourceCounter1
CounterResetActivationCounter0
CounterResetActivationCounter1
CounterResetSourceCounter0
CounterResetSourceCounter1
CounterTriggerActivationCounter0
CounterTriggerActivationCounter1
CounterTriggerSourceCounter0
CounterTriggerSourceCounter1
DecimationHorizontalAll
DecimationVerticalAll
DefectCorrectStaticEnable
DefectCorrectionMode
DeviceIndicatorMode
DeviceLinkBandwidthReserve
DeviceLinkThroughputLimit
EvCompensationRaw
EventNotificationError
EventNotificationExposureEnd
EventNotificationSerialPortReceive
ExposureAuto
ExposureMode
ExposureTime
GainAll
GainAuto
Gamma
GammaEnable
Height
IspEnable
LUTEnable
LineFilterWidthLine0Debounce
LineFilterWidthLine0Deglitch
LineFilterWidthLine1Debounce
LineFilterWidthLine1Deglitch
LineFilterWidthLine2Debounce
LineFilterWidthLine2Deglitch
LineFilterWidthLine3Debounce
LineFilterWidthLine3Deglitch
LineInverterLine0
LineInverterLine1
LineInverterLine2
LineInverterLine3
LineModeLine0
LineModeLine1
LineModeLine2
LineModeLine3
LineSourceLine0
LineSourceLine1
LineSourceLine2
LineSourceLine3
LogicBlockLUTInputActivationLogicBlock0Input0
LogicBlockLUTInputActivationLogicBlock0Input1
LogicBlockLUTInputActivationLogicBlock0Input2
LogicBlockLUTInputActivationLogicBlock0Input3
LogicBlockLUTInputActivationLogicBlock1Input0
LogicBlockLUTInputActivationLogicBlock1Input1
LogicBlockLUTInputActivationLogicBlock1Input2
LogicBlockLUTInputActivationLogicBlock1Input3
LogicBlockLUTInputSourceLogicBlock0Input0
LogicBlockLUTInputSourceLogicBlock0Input1
LogicBlockLUTInputSourceLogicBlock0Input2
LogicBlockLUTInputSourceLogicBlock0Input3
LogicBlockLUTInputSourceLogicBlock1Input0
LogicBlockLUTInputSourceLogicBlock1Input1
LogicBlockLUTInputSourceLogicBlock1Input2
LogicBlockLUTInputSourceLogicBlock1Input3
LogicBlockLUTOutputValueAllLogicBlock0Enable
LogicBlockLUTOutputValueAllLogicBlock0Value
LogicBlockLUTOutputValueAllLogicBlock1Enable
LogicBlockLUTOutputValueAllLogicBlock1Value
OffsetX
OffsetY
PixelFormat
ReverseX
ReverseY
RgbTransformLightSource
Saturation
SaturationEnable
SensorShutterMode
SerialPortBaudRateSerialPort0
SerialPortDataBitsSerialPort0
SerialPortParitySerialPort0
SerialPortSourceSerialPort0
SerialPortStopBitsSerialPort0
Sharpening
SharpeningAuto
SharpeningEnable
SharpeningThreshold
TestPatternPipelineStart
TestPatternSensor
TransferBlockCount
TransferControlMode
TransferOperationMode
TriggerActivationAcquisitionStart
TriggerActivationFrameBurstStart
TriggerActivationFrameStart
TriggerDelayAcquisitionStart
TriggerDelayFrameBurstStart
TriggerDelayFrameStart
TriggerModeAcquisitionStart
TriggerModeFrameBurstStart
TriggerModeFrameStart
TriggerOverlapAcquisitionStart
TriggerOverlapFrameBurstStart
TriggerOverlapFrameStart
TriggerSourceAcquisitionStart
TriggerSourceFrameBurstStart
TriggerSourceFrameStart
UserOutputValueAll
V3_3EnableLine0
V3_3EnableLine1
V3_3EnableLine2
V3_3EnableLine3
Width

User Set Feature Enable

Whether or not the selected feature is saved to user sets.

Property Value
Name UserSetFeatureEnable
Interface IBoolean
Access RO
Visibility Expert