Thermal Camera SDK 11.3.0
SDK for Optris Thermal Cameras
Loading...
Searching...
No Matches
FrameMetadata.h
Go to the documentation of this file.
1// Copyright (c) 2008-2026 Optris GmbH & Co. KG
2
10
11#pragma once
12
13#include <vector>
14
15#include "otcsdk/Api.h"
16#include "otcsdk/Exceptions.h"
19
20
21namespace optris
22{
23// Forward declaration
24struct FrameMetadata2;
25
26
33{
34public:
37
38
42 OTC_SDK_API void setFrom(const FrameMetadata2& raw) noexcept;
43
44
53 bool isThermalDataReliable() const noexcept;
54
55
61 unsigned int getCounter() const noexcept;
62
70 unsigned int getCounterHardware() const noexcept;
71
72
78 long long getTimestamp() const noexcept;
79
85 long long getTimestampMedia() const noexcept;
86
87
93 FlagState getFlagState() const noexcept;
94
100 void setFlagState(FlagState flagState) noexcept;
101
102
108 float getTemperatureFlag() const noexcept;
109
115 float getTemperatureBox() const noexcept;
116
122 float getTemperatureChip() const noexcept;
123
130
137
144
161
162
173 const RadiationParameters& radiation) noexcept;
174
175
190 OTC_SDK_API float getPifAiValue(int deviceIndex, int pinIndex) const;
191
206 OTC_SDK_API bool getPifDiValue(int deviceIndex, int pinIndex) const;
207
213 int getPifActualDeviceCount() const noexcept;
214
220 int getPifConfigurableDeviceCount() const noexcept;
221
227 int getPifAiCountPerDevice() const noexcept;
228
234 int getPifDiCountPerDevice() const noexcept;
235
236
237private:
239 unsigned int _counter;
241 unsigned int _counterHardware;
242
244 long long _timestamp;
246 long long _timestampMedia;
247
249 FlagState _flagState;
250
252 float _temperatureFlag;
254 float _temperatureBox;
256 float _temperatureChip;
257
259 RadiationParameters _radiation;
261 RadiationParameterSource _emissivitySource;
263 RadiationParameterSource _ambientTemperatureSource;
264
266 int _pifActualDeviceCount;
268 int _pifConfigurableDeviceCount;
269
271 int _pifAiCountPerDevice;
273 std::vector<float> _pifAiValues;
274
276 int _pifDiCountPerDevice;
278 std::vector<bool> _pifDiValues;
279};
280
281
282// Inline implementations
283inline bool FrameMetadata::isThermalDataReliable() const noexcept
284{
285 return (_flagState != FlagState::Initializing);
286}
287
288inline unsigned int FrameMetadata::getCounter() const noexcept
289{
290 return _counter;
291}
292
293inline unsigned int FrameMetadata::getCounterHardware() const noexcept
294{
295 return _counterHardware;
296}
297
298inline long long FrameMetadata::getTimestamp() const noexcept
299{
300 return _timestamp;
301}
302
303inline long long FrameMetadata::getTimestampMedia() const noexcept
304{
305 return _timestampMedia;
306}
307
309{
310 return _flagState;
311}
312
313inline void FrameMetadata::setFlagState(FlagState flagState) noexcept
314{
315 _flagState = flagState;
316}
317
318inline float FrameMetadata::getTemperatureFlag() const noexcept
319{
320 return _temperatureFlag;
321}
322
323inline float FrameMetadata::getTemperatureBox() const noexcept
324{
325 return _temperatureBox;
326}
327
328inline float FrameMetadata::getTemperatureChip() const noexcept
329{
330 return _temperatureChip;
331}
332
334{
335 return _radiation;
336}
337
339 const RadiationParameters& radiation) noexcept
340{
341 _radiation = radiation;
342}
343
345{
346 return _emissivitySource;
347}
348
353
355{
356 return _ambientTemperatureSource;
357}
358
359inline int FrameMetadata::getPifActualDeviceCount() const noexcept
360{
361 return _pifActualDeviceCount;
362}
363
365{
366 return _pifConfigurableDeviceCount;
367}
368
369inline int FrameMetadata::getPifAiCountPerDevice() const noexcept
370{
371 return _pifAiCountPerDevice;
372}
373
374inline int FrameMetadata::getPifDiCountPerDevice() const noexcept
375{
376 return _pifDiCountPerDevice;
377}
378
379} // namespace optris
Contains defines controlling the Windows DLL export and import of symbols.
#define OTC_SDK_API
Only needed when working with Windows DLLs.
Definition Api.h:65
Contains the exceptions raised by the SDK.
Contains an enum representing the different states of the shutter flag.
Contains a class holding the individual radiation parameters.
float getTemperatureChip() const noexcept
Returns the sensor chip temperature in °C at frame capturing time.
Definition FrameMetadata.h:328
OTC_SDK_API FrameMetadata() noexcept
Constructor.
RadiationParameters getRadiationParameters() const noexcept
Returns the standard radiation parameters.
Definition FrameMetadata.h:333
OTC_SDK_API void setFrom(const FrameMetadata2 &raw) noexcept
Sets the metadata from the raw metadata provided by the processing pipeline.
RadiationParameterSource getAmbientTemperatureSource() const noexcept
Returns the source of the standard ambient temperature value.
Definition FrameMetadata.h:354
unsigned int getCounter() const noexcept
Returns a consecutive number for each received frame.
Definition FrameMetadata.h:288
RadiationParameterSource getEmissivitySource() const noexcept
Returns the source of the standard emissivity value.
Definition FrameMetadata.h:344
bool isThermalDataReliable() const noexcept
Indicates whether the provided thermal data is reliable.
Definition FrameMetadata.h:283
OTC_SDK_API float getPifAiValue(int deviceIndex, int pinIndex) const
Returns the analog input value on the given PIF channel.
float getTemperatureBox() const noexcept
Returns the housing temperature in °C at frame capturing time.
Definition FrameMetadata.h:323
int getPifAiCountPerDevice() const noexcept
Returns the count of analog input channels per PIF device.
Definition FrameMetadata.h:369
FlagState getFlagState() const noexcept
Returns the state of the shutter flag at frame capturing time.
Definition FrameMetadata.h:308
int getPifConfigurableDeviceCount() const noexcept
Returns the count of configurable PIF devices.
Definition FrameMetadata.h:364
RadiationParameterSource getTransmissivitySource() const noexcept
Returns the source of the standard transmissivity value.
Definition FrameMetadata.h:349
int getPifDiCountPerDevice() const noexcept
Returns the count of digital input channels per PIF device.
Definition FrameMetadata.h:374
void setFlagState(FlagState flagState) noexcept
Sets the state of the shutter flag.
Definition FrameMetadata.h:313
long long getTimestampMedia() const noexcept
Returns the media timestamp.
Definition FrameMetadata.h:303
int getPifActualDeviceCount() const noexcept
Returns the count of actually connected PIF devices.
Definition FrameMetadata.h:359
OTC_SDK_API void setRadiationParameters(const RadiationParameters &radiation) noexcept
Sets the standard radiation parameters used to process the frame. Intended for code paths that recons...
Definition FrameMetadata.h:338
OTC_SDK_API bool getPifDiValue(int deviceIndex, int pinIndex) const
Returns the digital input value on the given PIF channel.
unsigned int getCounterHardware() const noexcept
Returns the frame number received from the device.
Definition FrameMetadata.h:293
float getTemperatureFlag() const noexcept
Returns the shutter flag temperature in °C at frame capturing time.
Definition FrameMetadata.h:318
long long getTimestamp() const noexcept
Returns the frame timestamp in UNITS (10000000 units per second).
Definition FrameMetadata.h:298
Main SDK namespace.
Definition AlarmChannel.h:21
RadiationParameterSource
Represents the different sources of radiation parameters.
Definition RadiationParameters.h:27
@ Sdk
The radiation parameter are/can be set via the SDK.
Definition RadiationParameters.h:28
FlagState
Represents the different states of the shutter flag.
Definition FlagState.h:33
@ Initializing
Flag state is beeing initialized/calibrated.
Definition FlagState.h:39
Holds the radiation parameters for a frame or a measurement field.
Definition RadiationParameters.h:35