Add get/set auto property methods for stream properties

Author: doblon8

src/main/java/io/github/doblon8/openpnp/capture/CaptureStream.java

@@ -138,6 +138,43 @@ public void setProperty(CaptureProperty property, int value) {
         }
     }
 
+    /**
+     * Get the automatic flag of a camera/stream property (e.g. zoom, focus etc.).
+     *
+     * @param property the property to get the automatic flag for.
+     * @return true if the property is set to automatic, false if it is set to manual.
+     * @throws CaptureException if an error occurs while getting the auto property value.
+     */
+    public boolean getAutoProperty(CaptureProperty property) {
+        try (Arena arena = Arena.ofConfined()) {
+            MemorySegment valuePointer = arena.allocate(ValueLayout.JAVA_INT);
+            int result = Cap_getAutoProperty(context.getSegment(), id, property.value(), valuePointer);
+            CaptureResult captureResult = CaptureResult.values()[result];
+            return switch (captureResult) {
+                case OK -> valuePointer.get(ValueLayout.JAVA_INT, 0) == 1;
+                case PROPERTY_NOT_SUPPORTED -> throw new CaptureException("Property " + property + " is not supported by this stream.");
+                default -> throw new CaptureException("Error getting auto property value for property " + property + ": context, stream are invalid.");
+            };
+        }
+    }
+
+    /**
+     * Set the automatic flag of a camera/stream property (e.g. zoom, focus etc.).
+     *
+     * @param property the property to set the automatic flag for.
+     * @param enable   true to set the property to automatic, false to set it to manual.
+     * @throws CaptureException if an error occurs while setting the auto property value.
+     */
+    public void setAutoProperty(CaptureProperty property, boolean enable) {
+            int result = Cap_setAutoProperty(context.getSegment(), id, property.value(), enable ? 1 : 0);
+            CaptureResult captureResult = CaptureResult.values()[result];
+            switch (captureResult) {
+                case OK -> {}
+                case PROPERTY_NOT_SUPPORTED -> throw new CaptureException("Property " + property + " is not supported by this stream.");
+                default -> throw new CaptureException("Error setting auto property value for property " + property + ": context, stream are invalid.");
+            }
+    }
+
     /**
      * Check if a stream is open, i.e. is capturing data.
      *

src/test/java/Scratch.java

@@ -31,10 +31,16 @@ void main() {
             stream.setProperty(CaptureProperty.ZOOM, 200);
             System.out.println("Zoom value after setting to 200: " + stream.getPropertyValue(CaptureProperty.ZOOM));
 
-
-            var image = stream.capture();
-            ImageIO.write(image, "png", new File("/tmp/image.png"));
-            System.out.println("Captured image saved to /tmp/image.png");
+            var image1 = stream.capture();
+            ImageIO.write(image1, "png", new File("/tmp/image_manual_zoom.png"));
+            System.out.println("Captured image with manual zoom saved to /tmp/image_manual_zoom.png");
+
+            System.out.println("Current auto focus value: " + stream.getAutoProperty(CaptureProperty.FOCUS));
+            stream.setAutoProperty(CaptureProperty.FOCUS, false);
+            System.out.println("Auto focus after setting to false: " + stream.getAutoProperty(CaptureProperty.FOCUS));
+            var image2 = stream.capture();
+            ImageIO.write(image2, "png", new File("/tmp/image_auto_focus_disabled.png"));
+            System.out.println("Captured image with auto focus disabled saved to /tmp/image_auto_focus_disabled.png");
         } catch (InterruptedException e) {
             System.err.println("Interrupted while waiting for webcam: " + e.getMessage());
         }