IDS peak 2.15.0 / uEye+ firmware 3.54

Returns the status of the automatic exposure control (see BrightnessAutoControl). If the automatic brightness control does not reach the requested value, you can query the corresponding information via BrightnessAutoStatus.

Values description

•AecActive: Automatic exposure control is adjusting the exposure to reach the requested brightness.

•AgcActive: Automatic gain control is adjusting the gain to reach the requested brightness.

•AecStuckLow: Automatic exposure control is at the lower exposure limit, but cannot reach the requested brightness.

•AecStuckHigh: Automatic exposure control is at the upper exposure limit, but cannot reach the requested brightness.

•AgcStuckLow: Automatic gain control is at the lower gain limit, but cannot reach the requested brightness.

•AgcStuckHigh: Automatic gain control is at the upper gain limit, but cannot reach the requested brightness.

•Done: Automatic brightness control has reached the requested brightness.

•Off: Automatic brightness control is disabled.

Code example

C++

// Determine the current entry of BrightnessAutoStatus
std::string value = nodeMapRemoteDevice->FindNode<peak::core::nodes::EnumerationNode>("BrightnessAutoStatus")->CurrentEntry()->SymbolicValue();
// Get a list of all available entries of BrightnessAutoStatus
auto allEntries = nodeMapRemoteDevice->FindNode<peak::core::nodes::EnumerationNode>("BrightnessAutoStatus")->Entries();
std::vector<std::shared_ptr<peak::core::nodes::EnumerationEntryNode>> availableEntries;
for(const auto & entry : allEntries)
{
  if ((entry->AccessStatus()!=peak::core::nodes::NodeAccessStatus::NotAvailable)
          && (entry->AccessStatus()!=peak::core::nodes::NodeAccessStatus::NotImplemented))
  {
      availableEntries.emplace_back(entry);
  }
}

C#

// Determine the current entry of BrightnessAutoStatus
string value = nodeMapRemoteDevice.FindNode<peak.core.nodes.EnumerationNode>("BrightnessAutoStatus").CurrentEntry().SymbolicValue();
// Get a list of all available entries of BrightnessAutoStatus
allEntries = nodeMapRemoteDevice.FindNode<peak.core.nodes.EnumerationNode>("BrightnessAutoStatus").Entries();
List<string> availableEntries = new List<string>();
for(int i = 0; i < allEntries.Count(); ++i)
{
  if ((allEntries[i].AccessStatus() != peak.core.nodes.NodeAccessStatus.NotAvailable)
          && (allEntries[i].AccessStatus() != peak.core.nodes.NodeAccessStatus.NotImplemented))
  {
      availableEntries.Add(allEntries[i].SymbolicValue());
  }
}

Python

# Determine the current entry of BrightnessAutoStatus (str)
value = nodeMapRemoteDevice.FindNode("BrightnessAutoStatus").CurrentEntry().SymbolicValue()
# Get a list of all available entries of BrightnessAutoStatus
allEntries = nodeMapRemoteDevice.FindNode("BrightnessAutoStatus").Entries()
availableEntries = []
for entry in allEntries:
  if (entry.AccessStatus() != ids_peak.NodeAccessStatus_NotAvailable
          and entry.AccessStatus() != ids_peak.NodeAccessStatus_NotImplemented):
      availableEntries.append(entry.SymbolicValue())