pynode-flow 0.2.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (227) hide show
  1. pynode/__init__.py +37 -0
  2. pynode/__main__.py +9 -0
  3. pynode/_perf.py +65 -0
  4. pynode/_version.py +24 -0
  5. pynode/api/__init__.py +15 -0
  6. pynode/api/helpers.py +79 -0
  7. pynode/api/nodes.py +423 -0
  8. pynode/api/services.py +124 -0
  9. pynode/api/sse.py +58 -0
  10. pynode/api/uploads.py +59 -0
  11. pynode/api/workflows.py +466 -0
  12. pynode/config.py +93 -0
  13. pynode/install_nodes.py +143 -0
  14. pynode/main.py +118 -0
  15. pynode/node_registry.py +156 -0
  16. pynode/nodes/AutoSyncNode/auto_sync_node.py +151 -0
  17. pynode/nodes/BBoxMetricsNode/__init__.py +3 -0
  18. pynode/nodes/BBoxMetricsNode/bbox_metrics_node.py +250 -0
  19. pynode/nodes/BBoxMetricsNode/requirements.txt +1 -0
  20. pynode/nodes/BatchNode/__init__.py +3 -0
  21. pynode/nodes/BatchNode/batch_node.py +86 -0
  22. pynode/nodes/BatchNode/requirements.txt +1 -0
  23. pynode/nodes/CameraNode/__init__.py +4 -0
  24. pynode/nodes/CameraNode/camera_node.py +204 -0
  25. pynode/nodes/CameraNode/requirements.txt +2 -0
  26. pynode/nodes/ChangeNode/__init__.py +1 -0
  27. pynode/nodes/ChangeNode/change_node.py +255 -0
  28. pynode/nodes/ChangeNode/requirements.txt +1 -0
  29. pynode/nodes/ConfidenceFilterNode/__init__.py +4 -0
  30. pynode/nodes/ConfidenceFilterNode/confidence_filter_node.py +208 -0
  31. pynode/nodes/ConfidenceFilterNode/requirements.txt +1 -0
  32. pynode/nodes/CounterNode/__init__.py +3 -0
  33. pynode/nodes/CounterNode/counter_node.py +191 -0
  34. pynode/nodes/CropNode/__init__.py +4 -0
  35. pynode/nodes/CropNode/crop_node.py +317 -0
  36. pynode/nodes/CropNode/requirements.txt +2 -0
  37. pynode/nodes/DebugNode/__init__.py +4 -0
  38. pynode/nodes/DebugNode/debug_node.py +169 -0
  39. pynode/nodes/DebugNode/requirements.txt +1 -0
  40. pynode/nodes/DelayNode/delay_node.py +218 -0
  41. pynode/nodes/DelayNode/requirements.txt +1 -0
  42. pynode/nodes/DrawPredictionsNode/__init__.py +3 -0
  43. pynode/nodes/DrawPredictionsNode/draw_predictions_node.py +365 -0
  44. pynode/nodes/DrawPredictionsNode/requirements.txt +2 -0
  45. pynode/nodes/ErrorNode/error_node.py +94 -0
  46. pynode/nodes/ErrorNode/requirements.txt +1 -0
  47. pynode/nodes/FilterNode/__init__.py +3 -0
  48. pynode/nodes/FilterNode/filter_node.py +102 -0
  49. pynode/nodes/FilterNode/requirements.txt +1 -0
  50. pynode/nodes/FrameSourceNode/__init__.py +4 -0
  51. pynode/nodes/FrameSourceNode/frame_source_node.py +319 -0
  52. pynode/nodes/FrameSourceNode/requirements.txt +1 -0
  53. pynode/nodes/FunctionNode/__init__.py +3 -0
  54. pynode/nodes/FunctionNode/function_node.py +168 -0
  55. pynode/nodes/FunctionNode/requirements.txt +1 -0
  56. pynode/nodes/GateNode/gate_node.py +60 -0
  57. pynode/nodes/GateNode/requirements.txt +1 -0
  58. pynode/nodes/GetiUploadNode/__init__.py +3 -0
  59. pynode/nodes/GetiUploadNode/geti_upload_node.py +278 -0
  60. pynode/nodes/GetiUploadNode/requirements.txt +1 -0
  61. pynode/nodes/ImageFormatNode/__init__.py +4 -0
  62. pynode/nodes/ImageFormatNode/image_format_node.py +310 -0
  63. pynode/nodes/ImageFormatNode/requirements.txt +2 -0
  64. pynode/nodes/ImageUploadNode/image_upload_node.py +96 -0
  65. pynode/nodes/ImageViewerNode/__init__.py +4 -0
  66. pynode/nodes/ImageViewerNode/image_viewer_node.py +162 -0
  67. pynode/nodes/ImageViewerNode/requirements.txt +2 -0
  68. pynode/nodes/ImageWriterNode/__init__.py +3 -0
  69. pynode/nodes/ImageWriterNode/imagewriter_node.py +352 -0
  70. pynode/nodes/ImageWriterNode/requirements.txt +1 -0
  71. pynode/nodes/InferenceNode/InferenceEngine/__init__.py +15 -0
  72. pynode/nodes/InferenceNode/InferenceEngine/device_detection.py +149 -0
  73. pynode/nodes/InferenceNode/InferenceEngine/engines/base_engine.py +155 -0
  74. pynode/nodes/InferenceNode/InferenceEngine/engines/example_engine_template.py +272 -0
  75. pynode/nodes/InferenceNode/InferenceEngine/engines/geti_engine.py +309 -0
  76. pynode/nodes/InferenceNode/InferenceEngine/engines/onnx_engine.py +346 -0
  77. pynode/nodes/InferenceNode/InferenceEngine/engines/pass_engine.py +86 -0
  78. pynode/nodes/InferenceNode/InferenceEngine/engines/ultralytics_engine.py +863 -0
  79. pynode/nodes/InferenceNode/InferenceEngine/inference_engine_factory.py +533 -0
  80. pynode/nodes/InferenceNode/InferenceEngine/readme.md +107 -0
  81. pynode/nodes/InferenceNode/InferenceEngine/result_converters.py +121 -0
  82. pynode/nodes/InferenceNode/inference_node.py +451 -0
  83. pynode/nodes/InferenceNode/requirements.txt +13 -0
  84. pynode/nodes/InjectNode/inject_node.py +245 -0
  85. pynode/nodes/InjectNode/requirements.txt +1 -0
  86. pynode/nodes/JoinNode/__init__.py +3 -0
  87. pynode/nodes/JoinNode/join_node.py +156 -0
  88. pynode/nodes/JoinNode/requirements.txt +1 -0
  89. pynode/nodes/LabelFilterNode/__init__.py +3 -0
  90. pynode/nodes/LabelFilterNode/label_filter_node.py +188 -0
  91. pynode/nodes/LabelFilterNode/requirements.txt +1 -0
  92. pynode/nodes/MQTTNode/__init__.py +8 -0
  93. pynode/nodes/MQTTNode/mqtt_in_node.py +148 -0
  94. pynode/nodes/MQTTNode/mqtt_out_node.py +157 -0
  95. pynode/nodes/MQTTNode/mqtt_service.py +367 -0
  96. pynode/nodes/MQTTNode/requirements.txt +1 -0
  97. pynode/nodes/MessageWriterNode/__init__.py +7 -0
  98. pynode/nodes/MessageWriterNode/messagereader_node.py +568 -0
  99. pynode/nodes/MessageWriterNode/messagewriter_node.py +505 -0
  100. pynode/nodes/OmronCameraNode/__init__.py +3 -0
  101. pynode/nodes/OmronCameraNode/omron_camera_node.py +652 -0
  102. pynode/nodes/OmronCameraNode/requirements.txt +4 -0
  103. pynode/nodes/OpenCV/__init__.py +1 -0
  104. pynode/nodes/OpenCV/arithmetic_node.py +376 -0
  105. pynode/nodes/OpenCV/bitwise_node.py +127 -0
  106. pynode/nodes/OpenCV/blend_node.py +127 -0
  107. pynode/nodes/OpenCV/blob_detector_node.py +233 -0
  108. pynode/nodes/OpenCV/blur_node.py +141 -0
  109. pynode/nodes/OpenCV/color_space_node.py +139 -0
  110. pynode/nodes/OpenCV/colormap_node.py +262 -0
  111. pynode/nodes/OpenCV/contours_node.py +258 -0
  112. pynode/nodes/OpenCV/denormalize_coords_node.py +365 -0
  113. pynode/nodes/OpenCV/draw_node.py +312 -0
  114. pynode/nodes/OpenCV/edge_detector_node.py +177 -0
  115. pynode/nodes/OpenCV/equirectangular_node.py +447 -0
  116. pynode/nodes/OpenCV/fft_node.py +102 -0
  117. pynode/nodes/OpenCV/focus_estimation_node.py +189 -0
  118. pynode/nodes/OpenCV/frequency_filter_node.py +241 -0
  119. pynode/nodes/OpenCV/histogram_node.py +160 -0
  120. pynode/nodes/OpenCV/hough_circles_node.py +224 -0
  121. pynode/nodes/OpenCV/hough_lines_node.py +243 -0
  122. pynode/nodes/OpenCV/in_range_node.py +186 -0
  123. pynode/nodes/OpenCV/morphology_node.py +136 -0
  124. pynode/nodes/OpenCV/normalize_coords_node.py +344 -0
  125. pynode/nodes/OpenCV/paste_node.py +244 -0
  126. pynode/nodes/OpenCV/perspective_node.py +174 -0
  127. pynode/nodes/OpenCV/realsense_depth_node.py +253 -0
  128. pynode/nodes/OpenCV/requirements.txt +2 -0
  129. pynode/nodes/OpenCV/resize_node.py +175 -0
  130. pynode/nodes/OpenCV/rotate_node.py +159 -0
  131. pynode/nodes/OpenCV/template_match_node.py +227 -0
  132. pynode/nodes/OpenCV/threshold_node.py +167 -0
  133. pynode/nodes/PointInShapeNode/__init__.py +3 -0
  134. pynode/nodes/PointInShapeNode/point_in_shape_node.py +313 -0
  135. pynode/nodes/PointInShapeNode/requirements.txt +2 -0
  136. pynode/nodes/PolygonMetricsNode/__init__.py +3 -0
  137. pynode/nodes/PolygonMetricsNode/polygon_metrics_node.py +331 -0
  138. pynode/nodes/PolygonMetricsNode/requirements.txt +2 -0
  139. pynode/nodes/QueueLengthProbeNode/__init__.py +3 -0
  140. pynode/nodes/QueueLengthProbeNode/queue_length_probe_node.py +116 -0
  141. pynode/nodes/Qwen3VLMNode/__init__.py +3 -0
  142. pynode/nodes/Qwen3VLMNode/qwen3_vlm_node.py +519 -0
  143. pynode/nodes/Qwen3VLMNode/requirements.txt +5 -0
  144. pynode/nodes/RESTEndpointNode/__init__.py +3 -0
  145. pynode/nodes/RESTEndpointNode/rest_endpoint_node.py +491 -0
  146. pynode/nodes/RangeNode/__init__.py +3 -0
  147. pynode/nodes/RangeNode/range_node.py +115 -0
  148. pynode/nodes/RangeNode/requirements.txt +1 -0
  149. pynode/nodes/RateProbeNode/__init__.py +3 -0
  150. pynode/nodes/RateProbeNode/rate_probe_node.py +183 -0
  151. pynode/nodes/RateProbeNode/requirements.txt +1 -0
  152. pynode/nodes/RoboflowUploadNode/__init__.py +3 -0
  153. pynode/nodes/RoboflowUploadNode/requirements.txt +1 -0
  154. pynode/nodes/RoboflowUploadNode/roboflow_upload_node.py +229 -0
  155. pynode/nodes/SliceNode/README.md +149 -0
  156. pynode/nodes/SliceNode/__init__.py +5 -0
  157. pynode/nodes/SliceNode/merge_predictions_node.py +444 -0
  158. pynode/nodes/SliceNode/requirements.txt +3 -0
  159. pynode/nodes/SliceNode/slice_collector_node.py +370 -0
  160. pynode/nodes/SliceNode/slice_image_node.py +380 -0
  161. pynode/nodes/SplitNode/__init__.py +3 -0
  162. pynode/nodes/SplitNode/requirements.txt +1 -0
  163. pynode/nodes/SplitNode/split_node.py +155 -0
  164. pynode/nodes/SwitchNode/requirements.txt +1 -0
  165. pynode/nodes/SwitchNode/switch_node.py +259 -0
  166. pynode/nodes/SyncNode/__init__.py +3 -0
  167. pynode/nodes/SyncNode/sync_node.py +287 -0
  168. pynode/nodes/TemplateNode/requirements.txt +1 -0
  169. pynode/nodes/TemplateNode/template_node.py +86 -0
  170. pynode/nodes/TrackerNode/__init__.py +2 -0
  171. pynode/nodes/TrackerNode/supervision_tracker_node.py +248 -0
  172. pynode/nodes/TrackerNode/tracker_node.py +745 -0
  173. pynode/nodes/UltralyticsNode/__init__.py +4 -0
  174. pynode/nodes/UltralyticsNode/requirements.txt +2 -0
  175. pynode/nodes/UltralyticsNode/ultralytics_node.py +364 -0
  176. pynode/nodes/UnknownNode/__init__.py +93 -0
  177. pynode/nodes/VLLMNode/__init__.py +3 -0
  178. pynode/nodes/VLLMNode/vllm_node.py +345 -0
  179. pynode/nodes/VideoReaderNode/__init__.py +3 -0
  180. pynode/nodes/VideoReaderNode/video_reader_node.py +425 -0
  181. pynode/nodes/VideoWriterNode/__init__.py +3 -0
  182. pynode/nodes/VideoWriterNode/video_writer_node.py +441 -0
  183. pynode/nodes/WebhookNode/__init__.py +3 -0
  184. pynode/nodes/WebhookNode/webhook_node.py +591 -0
  185. pynode/nodes/__init__.py +109 -0
  186. pynode/nodes/base_node.py +562 -0
  187. pynode/nodes/image_utils.py +291 -0
  188. pynode/nodes/info.py +109 -0
  189. pynode/nodes/mDNSNode/__init__.py +13 -0
  190. pynode/nodes/mDNSNode/mdns_broadcast_node.py +214 -0
  191. pynode/nodes/mDNSNode/mdns_discovery_node.py +362 -0
  192. pynode/nodes/mDNSNode/mdns_manager.py +399 -0
  193. pynode/nodes/mDNSNode/requirements.txt +1 -0
  194. pynode/nodes/messages.py +81 -0
  195. pynode/server.py +187 -0
  196. pynode/static/images/favicon4.png +0 -0
  197. pynode/static/index.html +200 -0
  198. pynode/static/js/README.md +139 -0
  199. pynode/static/js/auth.js +89 -0
  200. pynode/static/js/clipboard.js +152 -0
  201. pynode/static/js/config.js +14 -0
  202. pynode/static/js/connections.js +844 -0
  203. pynode/static/js/debug.js +524 -0
  204. pynode/static/js/events.js +775 -0
  205. pynode/static/js/history.js +199 -0
  206. pynode/static/js/main.js +55 -0
  207. pynode/static/js/minimap.js +242 -0
  208. pynode/static/js/nodes.js +995 -0
  209. pynode/static/js/palette.js +255 -0
  210. pynode/static/js/properties.js +1270 -0
  211. pynode/static/js/selection.js +241 -0
  212. pynode/static/js/state.js +211 -0
  213. pynode/static/js/ui-utils.js +28 -0
  214. pynode/static/js/viewport.js +204 -0
  215. pynode/static/js/workflow.js +469 -0
  216. pynode/static/js/workflows.js +344 -0
  217. pynode/static/style.css +2751 -0
  218. pynode/workflow_engine.py +483 -0
  219. pynode/workflow_manager.py +440 -0
  220. pynode_flow-0.2.0.dist-info/METADATA +520 -0
  221. pynode_flow-0.2.0.dist-info/RECORD +227 -0
  222. pynode_flow-0.2.0.dist-info/WHEEL +5 -0
  223. pynode_flow-0.2.0.dist-info/entry_points.txt +3 -0
  224. pynode_flow-0.2.0.dist-info/licenses/LICENSE +21 -0
  225. pynode_flow-0.2.0.dist-info/scm_file_list.json +270 -0
  226. pynode_flow-0.2.0.dist-info/scm_version.json +8 -0
  227. pynode_flow-0.2.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,96 @@
1
+ """
2
+ Image Upload Node - accepts image uploads via drag-and-drop on the node.
3
+ Sends the uploaded image downstream as a message.
4
+ """
5
+
6
+ import base64
7
+ import numpy as np
8
+ import cv2
9
+ from pynode.nodes.base_node import BaseNode, Info, MessageKeys
10
+
11
+ _info = Info()
12
+ _info.add_text("Accepts image files via drag-and-drop onto the node. "
13
+ "The uploaded image is sent downstream as a message.")
14
+ _info.add_header("Usage")
15
+ _info.add_bullets(
16
+ "Drag and drop an image file onto the node in the editor.",
17
+ "Supported formats: JPEG, PNG, BMP, TIFF, WebP.",
18
+ )
19
+ _info.add_header("Outputs")
20
+ _info.add_bullets(
21
+ ("Output 0:", "Message with the uploaded image in payload."),
22
+ )
23
+
24
+
25
+ class ImageUploadNode(BaseNode):
26
+ """Receives image uploads and sends them downstream."""
27
+
28
+ display_name = 'Image Upload'
29
+ icon = '📤'
30
+ category = 'input'
31
+ color = '#C0DEED'
32
+ border_color = '#87A9C1'
33
+ text_color = '#000000'
34
+ input_count = 0
35
+ output_count = 1
36
+ info = str(_info)
37
+
38
+ ui_component = 'image-drop'
39
+ ui_component_config = {
40
+ 'tooltip': 'Drop an image here',
41
+ }
42
+
43
+ properties = []
44
+
45
+ api_routes = [
46
+ {
47
+ 'route': 'upload_image',
48
+ 'methods': ['POST'],
49
+ 'handler': 'handle_upload_image',
50
+ 'type': 'file_upload',
51
+ 'allowed_extensions': {'.jpg', '.jpeg', '.png', '.bmp', '.tiff', '.tif', '.webp'},
52
+ },
53
+ ]
54
+
55
+ def __init__(self, node_id=None, name="image upload"):
56
+ super().__init__(node_id, name)
57
+
58
+ def receive_image(self, image_bytes: bytes, filename: str = ""):
59
+ """
60
+ Called by the server when an image is uploaded to this node.
61
+
62
+ Args:
63
+ image_bytes: Raw image file bytes.
64
+ filename: Original filename of the uploaded image.
65
+ """
66
+ # Decode image bytes to numpy array
67
+ nparr = np.frombuffer(image_bytes, np.uint8)
68
+ image = cv2.imdecode(nparr, cv2.IMREAD_COLOR)
69
+ if image is None:
70
+ self.report_error(f"Failed to decode uploaded image: {filename}")
71
+ return
72
+
73
+ # Encode as JPEG base64 for the standard image message format
74
+ ret, buffer = cv2.imencode('.jpg', image)
75
+ if not ret:
76
+ self.report_error("Failed to encode uploaded image as JPEG")
77
+ return
78
+
79
+ jpeg_base64 = base64.b64encode(buffer.tobytes()).decode('utf-8')
80
+
81
+ msg = self.create_message(payload={
82
+ 'image': {
83
+ 'format': 'jpeg',
84
+ 'encoding': 'base64',
85
+ 'data': jpeg_base64,
86
+ 'width': image.shape[1],
87
+ 'height': image.shape[0],
88
+ },
89
+ 'filename': filename,
90
+ })
91
+ self.send(msg)
92
+
93
+ def handle_upload_image(self, file_bytes, filename):
94
+ """API route handler for image upload. Called by the server."""
95
+ self.receive_image(file_bytes, filename)
96
+ return {'success': True, 'filename': filename}
@@ -0,0 +1,4 @@
1
+ from .image_viewer_node import ImageViewerNode
2
+
3
+ __all__ = ['ImageViewerNode']
4
+
@@ -0,0 +1,162 @@
1
+ """
2
+ Image Viewer node - displays images/frames in the web UI.
3
+ """
4
+
5
+ # import base64
6
+ # import cv2
7
+ # import numpy as np
8
+ from typing import Any, Dict
9
+ from pynode.nodes.base_node import BaseNode, Info, MessageKeys
10
+
11
+ _info = Info()
12
+ _info.add_text("Displays images and video frames directly in the web UI. Automatically converts incoming image data to a displayable format.")
13
+ _info.add_header("Inputs")
14
+ _info.add_bullets(
15
+ ("Input 0:", "Message with image data at the configured image path.")
16
+ )
17
+ _info.add_header("Supported Formats")
18
+ _info.add_bullets(
19
+ ("Numpy Array:", "OpenCV BGR image arrays."),
20
+ ("Base64:", "Base64 encoded JPEG/PNG strings."),
21
+ ("Dict:", "Image dict with 'data' and 'encoding' keys.")
22
+ )
23
+ _info.add_header("Configuration")
24
+ _info.add_bullets(
25
+ ("Width/Height:", "Display size in pixels (image is scaled to fit)."),
26
+ ("Image Path:", f"Dot-separated path to image data (e.g., {MessageKeys.PAYLOAD}.{MessageKeys.IMAGE.PATH}).")
27
+ )
28
+
29
+
30
+ class ImageViewerNode(BaseNode):
31
+ """
32
+ Image Viewer node - displays images/frames in the web UI.
33
+ """
34
+ display_name = 'Image Viewer'
35
+ icon = '🖼️'
36
+ category = 'output'
37
+ color = '#D8BFD8'
38
+ border_color = '#9370DB'
39
+ text_color = '#000000'
40
+ input_count = 1
41
+ output_count = 0
42
+ info = str(_info)
43
+
44
+ api_routes = [
45
+ {'route': 'frame', 'methods': ['GET'], 'handler': 'get_current_frame'},
46
+ {'route': 'stream', 'methods': ['GET'], 'handler': 'get_mjpeg_stream', 'type': 'stream'},
47
+ ]
48
+
49
+ sse_handlers = [
50
+ {'type': 'frame', 'handler': 'get_current_frame_sse'},
51
+ ]
52
+
53
+ DEFAULT_CONFIG = {
54
+ MessageKeys.IMAGE.WIDTH: 320,
55
+ MessageKeys.IMAGE.HEIGHT: 240,
56
+ 'image_path': f'{MessageKeys.PAYLOAD}.{MessageKeys.IMAGE.PATH}'
57
+ }
58
+
59
+ properties = [
60
+ {
61
+ 'name': MessageKeys.IMAGE.WIDTH,
62
+ 'label': 'Display Width (px)',
63
+ 'type': 'number',
64
+ 'default': DEFAULT_CONFIG[MessageKeys.IMAGE.WIDTH]
65
+ },
66
+ {
67
+ 'name': MessageKeys.IMAGE.HEIGHT,
68
+ 'label': 'Display Height (px)',
69
+ 'type': 'number',
70
+ 'default': DEFAULT_CONFIG[MessageKeys.IMAGE.HEIGHT]
71
+ },
72
+ {
73
+ 'name': 'image_path',
74
+ 'label': 'Image Data Path',
75
+ 'type': 'text',
76
+ 'default': DEFAULT_CONFIG['image_path'],
77
+ 'description': f'Dot-separated path to image data (e.g. {MessageKeys.PAYLOAD}.{MessageKeys.IMAGE.PATH})'
78
+ },
79
+ {
80
+ 'name': 'stream_url',
81
+ 'label': 'Stream URL',
82
+ 'type': 'streamUrl',
83
+ 'help': 'MJPEG stream URL - open in browser or use in other applications'
84
+ }
85
+ ]
86
+
87
+ def __init__(self, node_id=None, name="image viewer"):
88
+ super().__init__(node_id, name)
89
+ self.current_frame = None
90
+ self.frame_timestamp = 0
91
+ self.last_sent_timestamp = 0
92
+
93
+ def on_input(self, msg: Dict[str, Any], input_index: int = 0):
94
+ """
95
+ Receive image data and store it for display.
96
+ """
97
+ import time
98
+ image_path = self.config.get('image_path', MessageKeys.PAYLOAD)
99
+ image_data = self._get_nested_value(msg, image_path)
100
+
101
+ if image_data is not None:
102
+ # Decode image using base node helper
103
+ img, format_type = self.decode_image({MessageKeys.IMAGE.PATH: image_data})
104
+
105
+ if img is None:
106
+ self.report_error(f"ImageViewerNode: Failed to decode image")
107
+ return
108
+
109
+ # Always encode to base64 JPEG for browser display
110
+ encoded_image = self.encode_image(img, 'jpeg_base64_dict')
111
+ if encoded_image is None:
112
+ self.report_error(f"ImageViewerNode: Failed to encode image for display")
113
+ return
114
+
115
+ # Store the frame data for the UI to retrieve
116
+ self.current_frame = encoded_image
117
+ self.frame_timestamp = time.time()
118
+ else:
119
+ self.report_error(f"ImageViewerNode: No data found at path '{image_path}' in message.")
120
+
121
+ def on_input_direct(self, msg: Dict[str, Any], input_index: int = 0):
122
+ """
123
+ Direct input processing (bypasses queue for better performance).
124
+ """
125
+ self.on_input(msg, input_index)
126
+
127
+ def get_current_frame(self):
128
+ """
129
+ Get the current frame for display in the UI.
130
+ Only returns frames that haven't been sent yet.
131
+ """
132
+ if self.current_frame and self.frame_timestamp > self.last_sent_timestamp:
133
+ self.last_sent_timestamp = self.frame_timestamp
134
+ return self.current_frame
135
+ return None
136
+
137
+ def get_current_frame_sse(self):
138
+ """SSE handler: return frame wrapped in 'data' key for client compatibility."""
139
+ frame = self.get_current_frame()
140
+ if frame:
141
+ return {'data': frame}
142
+ return None
143
+
144
+ def get_mjpeg_stream(self):
145
+ """Generator for MJPEG streaming. Yields (content_type, image_bytes) tuples."""
146
+ import time
147
+ import base64
148
+ last_timestamp = 0
149
+ while True:
150
+ try:
151
+ if self.frame_timestamp > last_timestamp and self.current_frame:
152
+ last_timestamp = self.frame_timestamp
153
+ frame_data = self.current_frame
154
+ if isinstance(frame_data, dict) and 'data' in frame_data:
155
+ img_data = base64.b64decode(frame_data['data'])
156
+ yield img_data
157
+ else:
158
+ time.sleep(0.033)
159
+ else:
160
+ time.sleep(0.033)
161
+ except Exception:
162
+ time.sleep(0.1)
@@ -0,0 +1,2 @@
1
+ opencv-python>=4.5.0
2
+ numpy>=1.19.0
@@ -0,0 +1,3 @@
1
+ from .imagewriter_node import ImageWriterNode
2
+
3
+ __all__ = ['ImageWriterNode']
@@ -0,0 +1,352 @@
1
+ """
2
+ Image Writer Node - writes image frames or data to disk.
3
+ Supports dynamic filenames from messages or static configuration.
4
+ """
5
+
6
+ import os
7
+ import base64
8
+ import time
9
+ from datetime import datetime
10
+ from typing import Any, Dict
11
+ from pynode.nodes.base_node import BaseNode, Info, MessageKeys
12
+
13
+ _info = Info()
14
+ _info.add_text("Writes image frames or data to disk. Supports dynamic filenames with counter, timestamp, or datetime patterns.")
15
+ _info.add_header("Inputs")
16
+ _info.add_bullets(
17
+ ("Input 0:", "Message with payload containing data to write. Images should be base64 encoded or numpy arrays.")
18
+ )
19
+ _info.add_header("Outputs")
20
+ _info.add_bullets(
21
+ ("Output 0:", "Status message with path, filename, bytes written, and counter.")
22
+ )
23
+ _info.add_header("Message Properties")
24
+ _info.add_bullets(
25
+ ("msg.fname:", "Override filename from message."),
26
+ ("msg.extension:", "Override file extension from message.")
27
+ )
28
+ _info.add_header("Naming Modes")
29
+ _info.add_bullets(
30
+ ("Counter:", "frame_0001.jpg, frame_0002.jpg, ..."),
31
+ ("Timestamp:", "frame_1234567890.jpg (Unix timestamp)"),
32
+ ("DateTime:", "frame_2024-12-03_153045.jpg"),
33
+ ("Message:", "Use msg.fname from incoming message")
34
+ )
35
+
36
+
37
+ class ImageWriterNode(BaseNode):
38
+ """
39
+ Image Writer node - writes image frames or data to disk.
40
+ Supports dynamic filenames and extensions from messages or properties.
41
+ """
42
+ display_name = 'Image Writer'
43
+ icon = '💾'
44
+ category = 'output'
45
+ color = '#87A980'
46
+ border_color = '#5F7858'
47
+ text_color = '#000000'
48
+ input_count = 1
49
+ output_count = 1
50
+ info = str(_info)
51
+
52
+ DEFAULT_CONFIG = {
53
+ 'directory': './output',
54
+ 'filename': 'frame',
55
+ 'extension': 'jpg',
56
+ 'naming_mode': 'counter',
57
+ 'counter_digits': '4',
58
+ 'overwrite': 'false',
59
+ 'create_subdirs': 'true'
60
+ }
61
+
62
+ properties = [
63
+ {
64
+ 'name': 'directory',
65
+ 'label': 'Output Directory',
66
+ 'type': 'text',
67
+ 'default': DEFAULT_CONFIG['directory'],
68
+ 'help': 'Directory where files will be saved (created if doesn\'t exist)'
69
+ },
70
+ {
71
+ 'name': 'filename',
72
+ 'label': 'Filename/Prefix',
73
+ 'type': 'text',
74
+ 'default': DEFAULT_CONFIG['filename'],
75
+ 'help': 'Filename or prefix. Can be overridden by msg.fname. Supports {timestamp}, {counter}'
76
+ },
77
+ {
78
+ 'name': 'extension',
79
+ 'label': 'File Extension',
80
+ 'type': 'select',
81
+ 'options': [
82
+ {'value': 'jpg', 'label': '.jpg'},
83
+ {'value': 'png', 'label': '.png'},
84
+ {'value': 'bmp', 'label': '.bmp'},
85
+ {'value': 'txt', 'label': '.txt'},
86
+ {'value': 'json', 'label': '.json'},
87
+ {'value': 'bin', 'label': '.bin (binary)'}
88
+ ],
89
+ 'default': DEFAULT_CONFIG['extension'],
90
+ 'help': 'File extension. Can be overridden by msg.extension'
91
+ },
92
+ {
93
+ 'name': 'naming_mode',
94
+ 'label': 'Naming Mode',
95
+ 'type': 'select',
96
+ 'options': [
97
+ {'value': 'counter', 'label': 'Counter (frame_0001.jpg)'},
98
+ {'value': 'timestamp', 'label': 'Timestamp (frame_1234567890.jpg)'},
99
+ {'value': 'datetime', 'label': 'DateTime (frame_2024-12-03_153045.jpg)'},
100
+ {'value': 'message', 'label': 'From Message (msg.fname)'}
101
+ ],
102
+ 'default': DEFAULT_CONFIG['naming_mode'],
103
+ 'help': 'How to generate filenames'
104
+ },
105
+ {
106
+ 'name': 'counter_digits',
107
+ 'label': 'Counter Digits',
108
+ 'type': 'text',
109
+ 'default': DEFAULT_CONFIG['counter_digits'],
110
+ 'help': 'Number of digits for counter padding (e.g., 4 = 0001, 0002, ...)'
111
+ },
112
+ {
113
+ 'name': 'overwrite',
114
+ 'label': 'Overwrite Existing',
115
+ 'type': 'select',
116
+ 'options': [
117
+ {'value': 'false', 'label': 'No (skip if exists)'},
118
+ {'value': 'true', 'label': 'Yes (overwrite)'}
119
+ ],
120
+ 'default': DEFAULT_CONFIG['overwrite'],
121
+ 'help': 'Overwrite existing files or skip them'
122
+ },
123
+ {
124
+ 'name': 'create_subdirs',
125
+ 'label': 'Create Subdirectories',
126
+ 'type': 'select',
127
+ 'options': [
128
+ {'value': 'true', 'label': 'Yes'},
129
+ {'value': 'false', 'label': 'No'}
130
+ ],
131
+ 'default': DEFAULT_CONFIG['create_subdirs'],
132
+ 'help': 'Create directory structure if it doesn\'t exist'
133
+ }
134
+ ]
135
+
136
+ def __init__(self, node_id=None, name="image writer"):
137
+ super().__init__(node_id, name)
138
+ self._counter = 0
139
+ self._last_written = None
140
+
141
+ def on_input(self, msg: Dict[str, Any], input_index: int = 0):
142
+ """
143
+ Write data to disk. Expects msg.payload to contain the data to write.
144
+ For images, payload should be base64 encoded string or raw bytes.
145
+ """
146
+ try:
147
+ # Get directory from config
148
+ directory = self.config.get('directory', './output')
149
+
150
+ # Get filename/prefix - prioritize msg.fname over config
151
+ if 'fname' in msg:
152
+ filename = str(msg['fname'])
153
+ else:
154
+ filename = self.config.get('filename', 'frame')
155
+
156
+ # Get extension - prioritize msg.extension over config
157
+ if 'extension' in msg:
158
+ extension = str(msg['extension']).lstrip('.')
159
+ else:
160
+ extension = self.config.get('extension', 'jpg')
161
+
162
+ # Generate full filename based on naming mode
163
+ naming_mode = self.config.get('naming_mode', 'counter')
164
+ full_filename = self._generate_filename(filename, extension, naming_mode, msg)
165
+
166
+ # Build full path
167
+ full_path = os.path.join(directory, full_filename)
168
+
169
+ # Create directory if needed
170
+ create_subdirs = self.get_config_bool('create_subdirs', True)
171
+ if create_subdirs:
172
+ os.makedirs(directory, exist_ok=True)
173
+ elif not os.path.exists(directory):
174
+ self.report_error(f"Directory does not exist: {directory}")
175
+ return
176
+
177
+ # Check if file exists and handle overwrite setting
178
+ overwrite = self.get_config_bool('overwrite', False)
179
+ if os.path.exists(full_path) and not overwrite:
180
+ output_msg = self.create_message(
181
+ payload={
182
+ 'status': 'skipped',
183
+ 'reason': 'file_exists',
184
+ 'path': full_path
185
+ },
186
+ topic=msg.get(MessageKeys.TOPIC, 'ImageWriter')
187
+ )
188
+ self.send(output_msg)
189
+ return
190
+
191
+ # Get payload data
192
+ payload = msg.get(MessageKeys.PAYLOAD)
193
+ if payload is None:
194
+ self.report_error("No payload in message")
195
+ return
196
+
197
+ # Write data based on type
198
+ bytes_written = self._write_data(full_path, payload, extension)
199
+
200
+ # Track last written file
201
+ self._last_written = full_path
202
+
203
+ # Send success message
204
+ output_msg = self.create_message(
205
+ payload={
206
+ 'status': 'success',
207
+ 'path': full_path,
208
+ 'filename': full_filename,
209
+ 'bytes': bytes_written,
210
+ 'counter': self._counter
211
+ },
212
+ topic=msg.get(MessageKeys.TOPIC, 'ImageWriter')
213
+ )
214
+ self.send(output_msg)
215
+
216
+ except Exception as e:
217
+ self.report_error(f"Failed to write file: {str(e)}")
218
+ output_msg = self.create_message(
219
+ payload={
220
+ 'status': 'error',
221
+ 'error': str(e)
222
+ },
223
+ topic=msg.get(MessageKeys.TOPIC, 'ImageWriter/error')
224
+ )
225
+ self.send(output_msg)
226
+
227
+ def _generate_filename(self, base: str, extension: str, mode: str, msg: Dict[str, Any]) -> str:
228
+ """Generate filename based on naming mode."""
229
+
230
+ if mode == 'message':
231
+ # Use filename from message as-is (msg.fname already used for base)
232
+ return f"{base}.{extension}"
233
+
234
+ elif mode == 'counter':
235
+ # Increment counter
236
+ self._counter += 1
237
+ digits = self.get_config_int('counter_digits', 4)
238
+ counter_str = str(self._counter).zfill(digits)
239
+
240
+ # Replace {counter} placeholder if present, or append
241
+ if '{counter}' in base:
242
+ filename = base.replace('{counter}', counter_str)
243
+ else:
244
+ filename = f"{base}_{counter_str}"
245
+
246
+ return f"{filename}.{extension}"
247
+
248
+ elif mode == 'timestamp':
249
+ # Unix timestamp
250
+ timestamp = int(time.time() * 1000) # milliseconds
251
+
252
+ # Replace {timestamp} placeholder if present, or append
253
+ if '{timestamp}' in base:
254
+ filename = base.replace('{timestamp}', str(timestamp))
255
+ else:
256
+ filename = f"{base}_{timestamp}"
257
+
258
+ return f"{filename}.{extension}"
259
+
260
+ elif mode == 'datetime':
261
+ # Human-readable datetime
262
+ dt = datetime.now()
263
+ datetime_str = dt.strftime('%Y%m%d_%H%M%S_%f')[:-3] # Include milliseconds
264
+
265
+ # Replace {datetime} placeholder if present, or append
266
+ if '{datetime}' in base:
267
+ filename = base.replace('{datetime}', datetime_str)
268
+ else:
269
+ filename = f"{base}_{datetime_str}"
270
+
271
+ return f"{filename}.{extension}"
272
+
273
+ else:
274
+ # Default: just append extension
275
+ return f"{base}.{extension}"
276
+
277
+ def _write_data(self, path: str, payload: Any, extension: str) -> int:
278
+ """Write data to file based on payload type and extension."""
279
+
280
+ # Try to decode as image using BaseNode helper (handles msg.payload.image format)
281
+ if extension in ['jpg', 'jpeg', 'png', 'bmp']:
282
+ try:
283
+ import cv2
284
+ image, format_type = self.decode_image(payload)
285
+
286
+ if image is not None:
287
+ # Encode to requested format
288
+ if extension in ['jpg', 'jpeg']:
289
+ ret, buffer = cv2.imencode('.jpg', image)
290
+ elif extension == 'png':
291
+ ret, buffer = cv2.imencode('.png', image)
292
+ elif extension == 'bmp':
293
+ ret, buffer = cv2.imencode('.bmp', image)
294
+ else:
295
+ ret = False
296
+
297
+ if ret:
298
+ # Convert numpy array to bytes
299
+ buffer_bytes = buffer.tobytes()
300
+ with open(path, 'wb') as f:
301
+ f.write(buffer_bytes)
302
+ return len(buffer_bytes)
303
+ except ImportError:
304
+ pass # cv2 not available, fall through to other methods
305
+ except Exception as e:
306
+ # If decode fails, try other methods
307
+ pass
308
+
309
+ # Handle raw bytes
310
+ if isinstance(payload, bytes):
311
+ with open(path, 'wb') as f:
312
+ f.write(payload)
313
+ return len(payload)
314
+
315
+ # Handle text/string data
316
+ elif isinstance(payload, str):
317
+ if extension in ['txt', 'json', 'csv', 'log']:
318
+ with open(path, 'w', encoding='utf-8') as f:
319
+ f.write(payload)
320
+ return len(payload.encode('utf-8'))
321
+ else:
322
+ # Write as text for other extensions
323
+ with open(path, 'w', encoding='utf-8') as f:
324
+ f.write(payload)
325
+ return len(payload.encode('utf-8'))
326
+
327
+ # Handle JSON-serializable data (including dicts that aren't images)
328
+ else:
329
+ import json
330
+ if extension == 'json':
331
+ json_str = json.dumps(payload, indent=2)
332
+ with open(path, 'w', encoding='utf-8') as f:
333
+ f.write(json_str)
334
+ return len(json_str.encode('utf-8'))
335
+ else:
336
+ # For non-JSON extensions, convert to string
337
+ data_str = str(payload)
338
+ with open(path, 'w', encoding='utf-8') as f:
339
+ f.write(data_str)
340
+ return len(data_str.encode('utf-8'))
341
+
342
+ def get_counter(self) -> int:
343
+ """Get current counter value."""
344
+ return self._counter
345
+
346
+ def reset_counter(self):
347
+ """Reset counter to 0."""
348
+ self._counter = 0
349
+
350
+ def get_last_written(self):
351
+ """Get path of last written file."""
352
+ return self._last_written
@@ -0,0 +1 @@
1
+ # No external dependencies - uses only Python standard library
@@ -0,0 +1,15 @@
1
+ from .engines.base_engine import BaseInferenceEngine
2
+ from .inference_engine_factory import InferenceEngineFactory
3
+
4
+ # Don't import specific engines directly - let the factory auto-discover them
5
+ # This prevents import errors when optional dependencies (like geti_sdk) aren't installed
6
+
7
+ # Import result conversion utilities
8
+ # from .result_converters import (
9
+ # ultralytics_to_geti,
10
+ # geti_to_ultralytics,
11
+ # # normalize_result_format,
12
+ # extract_detections_summary,
13
+ # create_rectangle,
14
+ # GETI_SDK_AVAILABLE
15
+ # )