You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/source/components/device.rst
+6-3Lines changed: 6 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -66,6 +66,8 @@ The watchdog is a crucial component in the operation of POE (Power over Ethernet
66
66
67
67
.. note::
68
68
This process is necessary to make the camera available for reconnection and typically takes about 10 seconds, which means the fastest possible reconnection time is 10 seconds.
69
+
70
+
69
71
Customizing the Watchdog Timeout
70
72
--------------------------------
71
73
@@ -229,7 +231,7 @@ Two examples would be:
229
231
- encoding (most prominently H264/H265 as frame drops can lead to artifacts).
230
232
231
233
Blocking behaviour
232
-
******************
234
+
------------------
233
235
234
236
By default, queues are **blocking** and their size is **30**, so when the device fills up a queue and when the limit is
235
237
reached, any additional messages from the device will be blocked and the library will wait until it can add new messages to the queue.
@@ -242,7 +244,8 @@ It will wait for the host to consume (eg. :code:`queue.get()`) a message before
242
244
to be empty again.
243
245
244
246
Non-Blocking behaviour
245
-
**********************
247
+
----------------------
248
+
246
249
Making the queue non-blocking will change the behavior in the situation described above - instead of waiting, the library will discard
247
250
the oldest message and add the new one to the queue, and then continue its processing loop (so it won't get blocked).
248
251
:code:`maxSize` determines the size of the queue and it also helps to control memory usage.
@@ -251,7 +254,7 @@ For example, if a message has 5MB of data, and the queue size is 30, this queue
251
254
up to 150MB of data in the memory on the host (the messages can also get really big, for instance, a single 4K NV12 encoded frame takes about ~12MB).
252
255
253
256
Some additional information
254
-
***************************
257
+
---------------------------
255
258
256
259
- Decreasing the queue size to 1 and setting non-blocking behavior will effectively mean "I only want the latest packet from the queue".
257
260
- Queues are thread-safe - they can be accessed from any thread.
0 commit comments