IRImager.h

Go to the documentation of this file.

// Copyright (c) 2008-2025 Optris GmbH & Co. KG

 
#pragma once
 
#include <memory>
#include <vector>
 
#include "otcsdk/Exceptions.h"
#include "otcsdk/ProcessInterface.h"
#include "otcsdk/IRImagerClient.h"
#include "otcsdk/IRImagerConfig.h"
#include "otcsdk/common/DeviceType.h"
#include "otcsdk/common/DeviceInfo.h"
#include "otcsdk/common/OperationMode.h"
#include "otcsdk/common/RadiationParameters.h"
#include "otcsdk/common/TemperaturePrecision.h"
#include "otcsdk/communication/net/DeviceNetworkConfig.h"
 
 
namespace optris
{

class IRImager
{
public:
  IRImager() = default;

  IRImager(const IRImager&) = delete;
  IRImager& operator=(const IRImager&) = delete;

  IRImager(IRImager&&) = delete;
  IRImager& operator=(IRImager&&) = delete;

  virtual ~IRImager() = default;
 
 
  // Device connection
  virtual void connect(IRImagerConfig config) = 0;

  virtual void connect(const DeviceInfo& deviceInfo) = 0;

  virtual void connect(unsigned long serialNumber) = 0;
  
  virtual void disconnect() = 0;

  virtual bool isConnected() const noexcept = 0;
 
 
  // Client/Observer management
  virtual void addClient(IRImagerClient* client) = 0;

  virtual bool removeClient(IRImagerClient* client) = 0;
 
 
  // Processing controls
  virtual void run() = 0;

  virtual bool runAsync() = 0;

  virtual void stopRunning() = 0;

  virtual bool isRunning() const noexcept = 0;
 
 
  // Device information
  virtual DeviceType getDeviceType() const = 0;

  virtual unsigned long getSerialNumber() const = 0;

  virtual unsigned int getHardwareRevision() const = 0;

  virtual unsigned int getFirmwareRevision() const = 0;
 
  
  // Connection details
  virtual std::string getConnectionInterface() const noexcept = 0;

  virtual IpAddress getIpAddress() const noexcept = 0;

  virtual Port getPort() const noexcept = 0;
 
 
  // Operation modes
  virtual std::vector<std::shared_ptr<OperationMode>> getOperationModes() = 0;

  virtual void setActiveOperationMode(const std::shared_ptr<OperationMode>& mode) = 0;

  virtual void setActiveOperationMode(int                opticsFieldOfView, 
                                      const std::string& opticsText, 
                                      float              temperatureLowerLimit,
                                      float              temperatureUpperLimit, 
                                      int                width,
                                      int                height,
                                      int                framerate) = 0;

  virtual std::shared_ptr<OperationMode> getActiveOperationMode() = 0;
 
 
  // Optics options
  virtual void setSoSCorrectionEnabled(bool enable) = 0;

  virtual bool isSoSCorrectionEnabled() const = 0;
 
  
  // Temperature range options
  virtual void setTemperatureRangeExtensionEnabled(bool enabled) = 0;
  
  virtual bool isTemperatureRangeExtensionEnabled() const noexcept = 0;

  virtual void setTemperatureHighPrecisionEnabled(bool enabled) = 0;

  virtual bool isTemperatureHighPrecisionEnabled() const noexcept = 0;
 
 
  // Thermal frame
  virtual int getWidth() const = 0;

  virtual int getHeight() const = 0;
 
 
  // Measurement fields
  virtual int addMeasurementField(const MeasurementFieldConfig& config) = 0;
 
 
  // Shutter flag
  virtual void setAutoFlagEnabled(bool enable) = 0;

  virtual bool isAutoFlagEnabled() const = 0;

  virtual void setFlagInterval(float minInterval, float maxInterval) = 0;

  virtual float getFlagMinInterval() const = 0;

  virtual float getFlagMaxInterval() const = 0;

  virtual void forceFlagEvent(float time = 0.F) = 0;

  virtual bool isFlagOpen() const = 0;

  virtual void setFlagForecastEnabled(bool enable) = 0;

  virtual bool isFlagForecastEnabled() const = 0;
 
 
  // Internal temperature probes
  virtual float getTemperatureFlag() const = 0;

  virtual float getTemperatureBox() const = 0;

  virtual float getTemperatureChip() const = 0;
 
 
  // Sensor chip heating
  virtual void setChipHeatingEnabled(bool enable) = 0;

  virtual bool isChipHeatingEnabled() const = 0;

  virtual void setTemperatureChipReference(float temperature) = 0;

  virtual float getTemperatureChipReference() const = 0;
 
 
  // Radiation parameters
  virtual RadiationParameterSource getEmissivitySource() const noexcept = 0;

  virtual RadiationParameterSource getTransmissivitySource() const noexcept = 0;

  virtual RadiationParameterSource getAmbientTemperatureSource() const noexcept = 0;

  virtual void setRadiationParameters(const RadiationParameters& radiation) = 0;

  virtual RadiationParameters getRadiationParameters() const = 0;
 
  
  // Focus motor
  virtual void setFocusMotorPosition(float position) = 0;

  virtual float getFocusMotorPosition() const = 0;
 
 
  // Reference temperature
  virtual void setReferenceTemperature(float referenceTemperature, float measuredTemperature, float ambientTemperature = INVALID_TEMPERATURE) = 0;

  virtual void resetReferenceTemperature() = 0;
 
 
  // Device network configuration
  virtual void setDeviceNetworkConfig(const DeviceNetworkConfig& networkConfig) = 0;

  virtual DeviceNetworkConfig getDeviceNetworkConfig() = 0;
 
 
  // Process Interface
  virtual ProcessInterface& getPif() = 0;

  virtual const ProcessInterface& getPif() const = 0;
 
 
  // Fail safe
  virtual void interruptFailSafe(bool active, const std::string& reason) = 0;
};
 
} // namespace optris