Multiscale configuration API (#21)

## Changes

### Added

- `acquire-device-properties`: A `uint8_t` member `multiscale` to
`StorageProperties`.
- `acquire-device-properties`: A corresponding entry in
`StoragePropertyMetadata`.
- `acquire-device-properties`: A convenience function for enabling multiscale storage, similar to the function for
  setting chunking properties.

CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- `acquire-device-properties`: A `uint8_t` member `enable_multiscale` of `StorageProperties`.
+- `acquire-device-properties`: A corresponding entry in `StoragePropertyMetadata`.
+- `acquire-device-properties`: A convenience function for enabling multiscale, similar to the function for
+  setting chunking properties.
+
 ## [0.1.3](https://github.com/acquire-project/acquire-core-libs/compare/v0.1.2...v0.1.3) - 2023-06-27
 
 ### Changed

src/acquire-device-properties/device/props/storage.c

@@ -93,6 +93,17 @@ storage_properties_set_chunking_props(struct StorageProperties* out,
     return 0;
 }
 
+int
+storage_properties_set_enable_multiscale(struct StorageProperties* out,
+                                         uint8_t enable)
+{
+    CHECK(out);
+    out->enable_multiscale = enable;
+    return 1;
+Error:
+    return 0;
+}
+
 int
 storage_properties_init(struct StorageProperties* out,
                         uint32_t first_frame_id,

src/acquire-device-properties/device/props/storage.h

@@ -31,6 +31,9 @@ extern "C"
                 uint32_t width, height, planes;
             } tile;
         } chunking;
+
+        /// Enable multiscale storage if true.
+        uint8_t enable_multiscale;
     };
 
     struct StoragePropertyMetadata
@@ -47,6 +50,11 @@ extern "C"
                 struct Property width, height, planes;
             } tile;
         } chunking;
+
+        struct storage_property_metadata_multiscale_s
+        {
+            uint8_t supported;
+        } multiscale;
     };
 
     /// Initializes StorageProperties, allocating string storage on the heap
@@ -117,6 +125,14 @@ extern "C"
                                               uint32_t tile_planes,
                                               uint64_t max_bytes_per_chunk);
 
+    /// @brief Set multiscale properties for `out`.
+    /// Convenience function to enable multiscale.
+    /// @returns 1 on success, otherwise 0
+    /// @param[in, out] out The storage properties to change.
+    /// @param[in] enable A flag to enable or disable multiscale.
+    int storage_properties_set_enable_multiscale(struct StorageProperties* out,
+                                                 uint8_t enable);
+
     /// Free's allocated string storage.
     void storage_properties_destroy(struct StorageProperties* self);