ndk: Extend new flags

Author: MarijnS95

ndk/src/hardware_buffer.rs

@@ -128,15 +128,14 @@ bitflags::bitflags! {
         #[doc(alias = "AHARDWAREBUFFER_USAGE_GPU_MIPMAP_COMPLETE")]
         const GPU_MIPMAP_COMPLETE = ffi::AHardwareBuffer_UsageFlags::AHARDWAREBUFFER_USAGE_GPU_MIPMAP_COMPLETE.0;
 
-        // TODO: Only available in a newer NDK
-        // /// Usage: The buffer is used for front-buffer rendering. When front-buffering rendering
-        // /// is specified, different usages may adjust their behavior as a result. For example, when
-        // /// used as [`HardwareBufferFormat::GPU_COLOR_OUTPUT`] the buffer will behave similar to a
-        // /// single-buffered window. When used with [`HardwareBufferFormat::COMPOSER_OVERLAY`], the
-        // /// system will try to prioritize the buffer receiving an overlay plane & avoid caching it
-        // /// in intermediate composition buffers.
-        // #[doc(alias = "AHARDWAREBUFFER_USAGE_FRONT_BUFFER")]
-        // const USAGE_FRONT_BUFFER = ffi::AHardwareBuffer_UsageFlags::AHARDWAREBUFFER_USAGE_FRONT_BUFFER.0;
+        /// Usage: The buffer is used for front-buffer rendering. When front-buffering rendering
+        /// is specified, different usages may adjust their behavior as a result. For example, when
+        /// used as [`HardwareBufferFormat::GPU_COLOR_OUTPUT`] the buffer will behave similar to a
+        /// single-buffered window. When used with [`HardwareBufferFormat::COMPOSER_OVERLAY`], the
+        /// system will try to prioritize the buffer receiving an overlay plane & avoid caching it
+        /// in intermediate composition buffers.
+        #[doc(alias = "AHARDWAREBUFFER_USAGE_FRONT_BUFFER")]
+        const USAGE_FRONT_BUFFER = ffi::AHardwareBuffer_UsageFlags::AHARDWAREBUFFER_USAGE_FRONT_BUFFER.0;
 
         #[doc(alias = "AHARDWAREBUFFER_USAGE_VENDOR_0")]
         const VENDOR_0 = ffi::AHardwareBuffer_UsageFlags::AHARDWAREBUFFER_USAGE_VENDOR_0.0;

ndk/src/media/image_reader.rs

@@ -184,6 +184,13 @@ impl ImageReader {
         Ok(Self::from_ptr(inner))
     }
 
+    /// [`ImageReader`] constructor similar to [`ImageReader::new_with_usage()`] that takes two
+    /// additional parameters to build the format of the [`Image`]. All other parameters and the
+    /// return values are identical to those passed to [`ImageReader::new_with_usage()`].
+    ///
+    /// Instead of passing an [`ImageFormat`] parameter, this constructor accepts the combination
+    /// of [`HardwareBufferFormat`] and [`DataSpace`] for the format of the Image that the reader
+    /// will produce.
     #[cfg(feature = "api-level-34")]
     #[doc(alias = "AImageReader_newWithDataSpace")]
     pub fn new_with_data_space(
@@ -482,6 +489,7 @@ impl Image {
         std::mem::forget(self);
     }
 
+    /// Query the [`DataSpace`] of the input [`Image`].
     #[cfg(feature = "api-level-34")]
     #[doc(alias = "AImage_getDataSpace")]
     pub fn data_space(&self) -> Result<DataSpace> {