IDS peak IPL  v1.7.0
peak_ipl_histogram.hpp
Go to the documentation of this file.
1 
11 #pragma once
12 
17 
18 #include <cstddef>
19 #include <cstdint>
20 #include <utility>
21 #include <vector>
22 
26 namespace peak
27 {
28 namespace ipl
29 {
30 
34 class Histogram final
35 {
36 public:
41  {
42  uint64_t PixelSum;
43  uint64_t PixelCount;
44  std::vector<uint64_t> Bins;
45  };
46 
47 public:
48  Histogram() = delete;
59  explicit Histogram(const Image& image);
60  ~Histogram();
61  Histogram(const Histogram& other) = delete;
62  Histogram& operator=(const Histogram& other) = delete;
63  Histogram(Histogram&& other) noexcept;
64  Histogram& operator=(Histogram&& other) noexcept;
65 
76 
86  std::vector<HistogramChannel> Channels() const;
87 
88 private:
89  PEAK_IPL_HISTOGRAM_HANDLE m_backendHandle{};
90 };
91 
92 inline Histogram::Histogram(const Image& image)
93 {
96  ImageBackendAccessor::BackendHandle(image), &m_backendHandle);
97  });
98 }
99 
101 {
102  if (m_backendHandle)
103  {
104  (void)PEAK_IPL_C_ABI_PREFIX PEAK_IPL_Histogram_Destruct(m_backendHandle);
105  }
106 }
107 
108 inline Histogram::Histogram(Histogram&& other) noexcept
109 {
110  *this = std::move(other);
111 }
112 
113 inline Histogram& Histogram::operator=(Histogram&& other) noexcept
114 {
115  if (this != &other)
116  {
117  (void)PEAK_IPL_C_ABI_PREFIX PEAK_IPL_Histogram_Destruct(m_backendHandle);
118  m_backendHandle = other.m_backendHandle;
119  other.m_backendHandle = nullptr;
120  }
121 
122  return *this;
123 }
124 
126 {
127  PixelFormatName pixelFormatName = PixelFormatName::Invalid;
128 
131  m_backendHandle, reinterpret_cast<PEAK_IPL_PIXEL_FORMAT*>(&pixelFormatName));
132  });
133 
134  return peak::ipl::PixelFormat{ pixelFormatName };
135 }
136 
137 inline std::vector<Histogram::HistogramChannel> Histogram::Channels() const
138 {
139  std::vector<HistogramChannel> channels;
140 
141  size_t numChannels = 0;
143  [&] { return PEAK_IPL_C_ABI_PREFIX PEAK_IPL_Histogram_GetNumChannels(m_backendHandle, &numChannels); });
144 
145  for (size_t ch = 0; ch < numChannels; ++ch)
146  {
147  uint64_t pixelSum = 0;
149  return PEAK_IPL_C_ABI_PREFIX PEAK_IPL_Histogram_GetPixelSumForChannel(m_backendHandle, ch, &pixelSum);
150  });
151 
152  uint64_t pixelCount = 0;
154  return PEAK_IPL_C_ABI_PREFIX PEAK_IPL_Histogram_GetPixelCountForChannel(m_backendHandle, ch, &pixelCount);
155  });
156 
157  size_t binListSize = 0;
159  return PEAK_IPL_C_ABI_PREFIX PEAK_IPL_Histogram_GetBinsForChannel(m_backendHandle, ch, nullptr, &binListSize);
160  });
161  std::vector<uint64_t> binList(binListSize);
164  m_backendHandle, ch, binList.data(), &binListSize);
165  });
166 
167  channels.emplace_back(HistogramChannel{ pixelSum, pixelCount, std::move(binList) });
168  }
169 
170  return channels;
171 }
172 
173 } /* namespace ipl */
174 } /* namespace peak */
uint64_t PixelSum
Definition: peak_ipl_histogram.hpp:42
struct PEAK_IPL_HISTOGRAM * PEAK_IPL_HISTOGRAM_HANDLE
Definition: peak_ipl_backend.h:330
#define PEAK_IPL_C_ABI_PREFIX
Definition: peak_ipl_dll_defines.h:16
PixelFormatName
Enum holding the possible pixel format names.
Definition: peak_ipl_simple_types.hpp:38
The "peak::ipl" namespace contains the whole image processing library.
Definition: peak_ipl_binning.hpp:22
std::vector< uint64_t > Bins
Definition: peak_ipl_histogram.hpp:44
PEAK_IPL_C_API PEAK_IPL_Histogram_GetPixelFormat(PEAK_IPL_HISTOGRAM_HANDLE histogramHandle, PEAK_IPL_PIXEL_FORMAT *pixelFormat)
Queries the pixel format of the given histogram.
void ExecuteAndMapReturnCodes(const CallableType &callableObject)
Definition: peak_ipl_exception.hpp:182
PEAK_IPL_C_API PEAK_IPL_Histogram_GetNumChannels(PEAK_IPL_HISTOGRAM_HANDLE histogramHandle, size_t *numChannels)
Queries the number of the given histogram&#39;s channels.
Stores the pixel format, width and height of an image and the pointer to the image buffer...
Definition: peak_ipl_image.hpp:39
Stores the values of the histogram.
Definition: peak_ipl_histogram.hpp:40
~Histogram()
Definition: peak_ipl_histogram.hpp:100
PEAK_IPL_C_API PEAK_IPL_Histogram_GetBinsForChannel(PEAK_IPL_HISTOGRAM_HANDLE histogramHandle, size_t channelIndex, uint64_t *bins, size_t *binsSize)
Queries the bin list of the channel with the given index.
PEAK_IPL_C_API PEAK_IPL_Histogram_Destruct(PEAK_IPL_HISTOGRAM_HANDLE histogramHandle)
Destroys the histogram associated with the given handle.
PEAK_IPL_C_API PEAK_IPL_Histogram_GetPixelSumForChannel(PEAK_IPL_HISTOGRAM_HANDLE histogramHandle, size_t channelIndex, uint64_t *pixelSum)
Queries the pixel sum for the channel with the given index.
Histogram & operator=(const Histogram &other)=delete
std::vector< HistogramChannel > Channels() const
Returns a vector containing the bin list of each channel.
Definition: peak_ipl_histogram.hpp:137
PEAK_IPL_C_API PEAK_IPL_Histogram_GetPixelCountForChannel(PEAK_IPL_HISTOGRAM_HANDLE histogramHandle, size_t channelIndex, uint64_t *pixelCount)
Queries the pixel count for the channel with the given index.
Stores the histogram values.
Definition: peak_ipl_histogram.hpp:34
PEAK_IPL_C_API PEAK_IPL_Histogram_Construct(PEAK_IPL_IMAGE_HANDLE imageHandle, PEAK_IPL_HISTOGRAM_HANDLE *histogramHandle)
Creates a histogram from image data.
peak::ipl::PixelFormat PixelFormat() const
Returns the pixel format of the histogram.
Definition: peak_ipl_histogram.hpp:125
uint64_t PixelCount
Definition: peak_ipl_histogram.hpp:43
Represents a pixel format and its specific properties.
Definition: peak_ipl_pixel_format.hpp:31