IDS peak genericC++ v1.15.0
Loading...
Searching...
No Matches
peak_event_controller.hpp
Go to the documentation of this file.
1
10
11#pragma once
12
13
17#include <peak/dll_interface/peak_dll_interface_util.hpp>
19
20#include <cstddef>
21#include <cstdint>
22#include <memory>
23
24
25namespace peak
26{
27namespace core
28{
29
43{
44public:
48 EventController() = delete;
57 EventController(const EventController& other) = delete;
58 EventController& operator=(const EventController& other) = delete;
61
63 RawInformation Info(int32_t infoCommand) const;
64
74 size_t NumEventsInQueue() const;
75
85 uint64_t NumEventsFired() const;
86
96 size_t EventMaxSize() const;
97
107 size_t EventDataMaxSize() const;
108
128 std::unique_ptr<Event> WaitForEvent(Timeout timeout_ms);
129
151 void KillWait();
152
171
179 void FlushEvents();
180
189
190private:
191 friend ClassCreator<EventController>;
192 explicit EventController(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle);
193 PEAK_EVENT_CONTROLLER_HANDLE m_backendHandle;
194};
195
196} /* namespace core */
197} /* namespace peak */
198
199/* Implementation */
200namespace peak
201{
202namespace core
203{
204
206 : m_backendHandle(eventControllerHandle)
207{}
208
213
214inline RawInformation EventController::Info(int32_t infoCommand) const
215{
216 return QueryRawInformationFromCInterfaceFunction([&](int32_t* dataType, uint8_t* buffer, size_t* bufferSize) {
218 m_backendHandle, infoCommand, dataType, buffer, bufferSize);
219 });
220}
221
223{
224 return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* numEventsInQueue) {
225 return PEAK_C_ABI_PREFIX PEAK_EventController_GetNumEventsInQueue(m_backendHandle, numEventsInQueue);
226 });
227}
228
229inline uint64_t EventController::NumEventsFired() const
230{
231 return QueryNumericFromCInterfaceFunction<uint64_t>([&](uint64_t* numEventsFired) {
232 return PEAK_C_ABI_PREFIX PEAK_EventController_GetNumEventsFired(m_backendHandle, numEventsFired);
233 });
234}
235
236inline size_t EventController::EventMaxSize() const
237{
238 return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* eventMaxSize) {
239 return PEAK_C_ABI_PREFIX PEAK_EventController_GetEventMaxSize(m_backendHandle, eventMaxSize);
240 });
241}
242
244{
245 return QueryNumericFromCInterfaceFunction<size_t>([&](size_t* eventDataMaxSize) {
246 return PEAK_C_ABI_PREFIX PEAK_EventController_GetEventDataMaxSize(m_backendHandle, eventDataMaxSize);
247 });
248}
249
250inline std::unique_ptr<Event> EventController::WaitForEvent(Timeout timeout_ms)
251{
252 auto eventHandle = QueryNumericFromCInterfaceFunction<PEAK_EVENT_HANDLE>(
253 [&](PEAK_EVENT_HANDLE* _eventHandle) {
254 return PEAK_C_ABI_PREFIX PEAK_EventController_WaitForEvent(m_backendHandle, timeout_ms, _eventHandle);
255 });
256
257 return std::make_unique<ClassCreator<Event>>(eventHandle);
258}
259
261{
262 CallAndCheckCInterfaceFunction(
263 [&] { return PEAK_C_ABI_PREFIX PEAK_EventController_KillWait(m_backendHandle); });
264}
265
267{
268 CallAndCheckCInterfaceFunction(
269 [&] { return PEAK_C_ABI_PREFIX PEAK_EventController_FlushPendingKillWaits(m_backendHandle); });
270}
271
273{
274 CallAndCheckCInterfaceFunction(
275 [&] { return PEAK_C_ABI_PREFIX PEAK_EventController_FlushEvents(m_backendHandle); });
276}
277
279{
280 return static_cast<EventType>(
281 QueryNumericFromCInterfaceFunction<PEAK_EVENT_TYPE>([&](PEAK_EVENT_TYPE* controlledEventType) {
283 m_backendHandle, controlledEventType);
284 }));
285}
286
287} /* namespace core */
288} /* namespace peak */
void FlushEvents()
Discards all events in queue.
Definition peak_event_controller.hpp:272
EventType ControlledEventType() const
Returns the controlled event type.
Definition peak_event_controller.hpp:278
std::unique_ptr< Event > WaitForEvent(Timeout timeout_ms)
Blocking wait for an event.
Definition peak_event_controller.hpp:250
RawInformation Info(int32_t infoCommand) const
Delivers information based on the given GenTL info command.
Definition peak_event_controller.hpp:214
EventController()=delete
Can not be created on its own, instead use EnableEvents.
EventController & operator=(const EventController &other)=delete
void FlushPendingKillWaits()
Flushes the KillWait queue.
Definition peak_event_controller.hpp:266
size_t EventDataMaxSize() const
Returns the maximum size of the data of an event in bytes.
Definition peak_event_controller.hpp:243
~EventController()
Destroys the EventController and unregisters the event.
Definition peak_event_controller.hpp:209
void KillWait()
Cancels a pending WaitForEvent call.
Definition peak_event_controller.hpp:260
size_t NumEventsInQueue() const
Returns the number of events in queue.
Definition peak_event_controller.hpp:222
EventController(const EventController &other)=delete
EventController & operator=(EventController &&other)=delete
size_t EventMaxSize() const
Returns the maximum size of an event in bytes.
Definition peak_event_controller.hpp:236
uint64_t NumEventsFired() const
Returns the number of fired events.
Definition peak_event_controller.hpp:229
EventController(EventController &&other)=delete
Represents a timeout value in milliseconds.
Definition peak_timeout.hpp:32
EventType
Different types of events.
Definition peak_event.hpp:36
The "core" namespace contains the direct GenAPI and GenTL wrapper.
Definition peak_buffer.hpp:34
The "peak" namespace directly contains convenience functionality like the DeviceManager as well as th...
Definition peak_dynamic_loader.h:33
PEAK_C_API PEAK_EventController_FlushEvents(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle)
Tells the given event controller to flush all events in queue.
struct PEAK_EVENT * PEAK_EVENT_HANDLE
Definition peak_backend.h:485
int32_t PEAK_EVENT_TYPE
Definition peak_backend.h:185
PEAK_C_API PEAK_EventController_GetEventMaxSize(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, size_t *eventMaxSize)
Asks the event controller for the maximum size of an event.
struct PEAK_EVENT_CONTROLLER * PEAK_EVENT_CONTROLLER_HANDLE
Definition peak_backend.h:481
PEAK_C_API PEAK_EventController_GetEventDataMaxSize(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, size_t *eventDataMaxSize)
Asks the event controller for the maximum size of an event's data.
PEAK_C_API PEAK_EventController_GetInfo(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, int32_t infoCommand, int32_t *infoDataType, uint8_t *info, size_t *infoSize)
Asks the given event controller for an information based on a specific command.
PEAK_C_API PEAK_EventController_FlushPendingKillWaits(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle)
Flushes the KillWait queue.
PEAK_C_API PEAK_EventController_WaitForEvent(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, uint64_t timeout_ms, PEAK_EVENT_HANDLE *eventHandle)
Tells the given event controller to wait for an event with the given timeout.
PEAK_C_API PEAK_EventController_GetNumEventsInQueue(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, size_t *numEventsInQueue)
Asks the event controller for its number of events in queue.
PEAK_C_API PEAK_EventController_GetNumEventsFired(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, uint64_t *numEventsFired)
Asks the event controller for its number of fired events.
PEAK_C_API PEAK_EventController_GetControlledEventType(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle, PEAK_EVENT_TYPE *controlledEventType)
Asks the event controller for its controlled event type.
PEAK_C_API PEAK_EventController_KillWait(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle)
Cancels a pending PEAK_EventController_WaitForEvent call.
PEAK_C_API PEAK_EventController_Destruct(PEAK_EVENT_CONTROLLER_HANDLE eventControllerHandle)
Destroys the given event controller.
#define PEAK_C_ABI_PREFIX
Definition peak_dll_defines.h:16
The struct returned by all raw information functions.
Definition peak_common_structs.hpp:25