From 3335935ec6cc4b6580e5eee242cb4158ced7831e Mon Sep 17 00:00:00 2001
From: Piotr Mitkowski <piotr.mitkowski1@gmail.com>
Date: Tue, 3 May 2022 19:03:54 +0200
Subject: [PATCH 1/7] Implemented platform changes for optional gallery
 permissions

---
 .../CHANGELOG.md                              |   5 +
 .../method_channel_image_picker.dart          |  20 +-
 .../image_picker_platform.dart                |  30 ++
 .../lib/src/types/image_picker_options.dart   |  48 +++
 .../lib/src/types/types.dart                  |   1 +
 .../pubspec.yaml                              |   2 +-
 .../new_method_channel_image_picker_test.dart | 314 +++++++++++++++++-
 7 files changed, 400 insertions(+), 20 deletions(-)
 create mode 100644 packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart

diff --git a/packages/image_picker/image_picker_platform_interface/CHANGELOG.md b/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
index 9f6d1749c671..ed95f20fbeab 100644
--- a/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
+++ b/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
@@ -1,3 +1,8 @@
+## 2.5.0
+
+* Re-adds `requestFullMetadata` option, but as a parameter of a new `pickImageFromSource`
+  method.
+  
 ## 2.4.4
 
 * Internal code cleanup for stricter analysis options.
diff --git a/packages/image_picker/image_picker_platform_interface/lib/src/method_channel/method_channel_image_picker.dart b/packages/image_picker/image_picker_platform_interface/lib/src/method_channel/method_channel_image_picker.dart
index e1e6082c8047..ba5d60d7a677 100644
--- a/packages/image_picker/image_picker_platform_interface/lib/src/method_channel/method_channel_image_picker.dart
+++ b/packages/image_picker/image_picker_platform_interface/lib/src/method_channel/method_channel_image_picker.dart
@@ -87,6 +87,7 @@ class MethodChannelImagePicker extends ImagePickerPlatform {
     double? maxHeight,
     int? imageQuality,
     CameraDevice preferredCameraDevice = CameraDevice.rear,
+    bool requestFullMetadata = true,
   }) {
     if (imageQuality != null && (imageQuality < 0 || imageQuality > 100)) {
       throw ArgumentError.value(
@@ -108,7 +109,8 @@ class MethodChannelImagePicker extends ImagePickerPlatform {
         'maxWidth': maxWidth,
         'maxHeight': maxHeight,
         'imageQuality': imageQuality,
-        'cameraDevice': preferredCameraDevice.index
+        'cameraDevice': preferredCameraDevice.index,
+        'requestFullMetadata': requestFullMetadata,
       },
     );
   }
@@ -197,6 +199,22 @@ class MethodChannelImagePicker extends ImagePickerPlatform {
     return path != null ? XFile(path) : null;
   }
 
+  @override
+  Future<XFile?> getImageFromSource({
+    required ImageSource source,
+    ImagePickerOptions options = const ImagePickerOptions(),
+  }) async {
+    final String? path = await _getImagePath(
+      source: source,
+      maxHeight: options.maxHeight,
+      maxWidth: options.maxWidth,
+      imageQuality: options.imageQuality,
+      preferredCameraDevice: options.preferredCameraDevice,
+      requestFullMetadata: options.requestFullMetadata,
+    );
+    return path != null ? XFile(path) : null;
+  }
+
   @override
   Future<List<XFile>?> getMultiImage({
     double? maxWidth,
diff --git a/packages/image_picker/image_picker_platform_interface/lib/src/platform_interface/image_picker_platform.dart b/packages/image_picker/image_picker_platform_interface/lib/src/platform_interface/image_picker_platform.dart
index 8f02e1683267..4efbac7793aa 100644
--- a/packages/image_picker/image_picker_platform_interface/lib/src/platform_interface/image_picker_platform.dart
+++ b/packages/image_picker/image_picker_platform_interface/lib/src/platform_interface/image_picker_platform.dart
@@ -146,6 +146,8 @@ abstract class ImagePickerPlatform extends PlatformInterface {
     throw UnimplementedError('retrieveLostData() has not been implemented.');
   }
 
+  /// This method is deprecated in favor of [getImageFromSource] and will be removed in a future update.
+  ///
   /// Returns an [XFile] with the image that was picked.
   ///
   /// The `source` argument controls where the image comes from. This can
@@ -251,4 +253,32 @@ abstract class ImagePickerPlatform extends PlatformInterface {
   Future<LostDataResponse> getLostData() {
     throw UnimplementedError('getLostData() has not been implemented.');
   }
+
+  /// Returns an [XFile] with the image that was picked.
+  ///
+  /// The `source` argument controls where the image comes from. This can
+  /// be either [ImageSource.camera] or [ImageSource.gallery].
+  ///
+  /// The `options` argument controls additional settings that can be used when picking an image. See [ImagePickerOptions]
+  /// for more details.
+  ///
+  /// Where iOS supports HEIC images, Android 8 and below doesn't. Android 9 and above only support HEIC images if used
+  /// in addition to a size modification, of which the usage is explained in [ImagePickerOptions].
+  ///
+  /// In Android, the MainActivity can be destroyed for various reasons. If that happens, the result will be lost
+  /// in this call. You can then call [getLostData] when your app relaunches to retrieve the lost data.
+  ///
+  /// If no images were picked, the return value is null.
+  Future<XFile?> getImageFromSource({
+    required ImageSource source,
+    ImagePickerOptions options = const ImagePickerOptions(),
+  }) {
+    return getImage(
+      source: source,
+      maxHeight: options.maxHeight,
+      maxWidth: options.maxWidth,
+      imageQuality: options.imageQuality,
+      preferredCameraDevice: options.preferredCameraDevice,
+    );
+  }
 }
diff --git a/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart b/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
new file mode 100644
index 000000000000..74ebdd349f91
--- /dev/null
+++ b/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
@@ -0,0 +1,48 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'package:image_picker_platform_interface/src/types/types.dart';
+
+/// Specifies options for picking a single image from the device's camera or gallery.
+class ImagePickerOptions {
+  /// Creates an instance with the given [maxHeight], [maxWidth], [imageQuality],
+  /// [referredCameraDevice] and [requestFullMetadata]. Any of the params may be null.
+  const ImagePickerOptions({
+    this.maxHeight,
+    this.maxWidth,
+    this.imageQuality,
+    this.preferredCameraDevice = CameraDevice.rear,
+    this.requestFullMetadata = true,
+  });
+
+  /// If specified, the image will be at most `maxWidth` wide. Otherwise,
+  /// the image will be returned at its original width.
+  final double? maxWidth;
+
+  /// If specified, the image will be at most`maxHeight` tall.
+  /// Otherwise the image will be returned at its original height.
+  final double? maxHeight;
+
+  /// Modifies the quality of the image, ranging from 0-100 where 100 is the original/max
+  /// quality. If `imageQuality` is null, the image with the originalquality will
+  /// be returned. Compression is only supported for certain image types such as
+  /// JPEG. If compression is not supported for the image that is picked, a warning
+  /// message will be logged.
+  final int? imageQuality;
+
+  /// Used to specify the camera to use when the `source` is [ImageSource.camera].
+  /// The `preferredCameraDevice` is ignored when `source` is [ImageSource.gallery].
+  /// It is also ignored if the chosen camera is not supported on the device.
+  /// Defaults to [CameraDevice.rear]. Note that Android has no documented parameter
+  /// for an intent to specify if the front or rear camera should be opened, this
+  /// function is not guaranteed to work on an Android device.
+  final CameraDevice preferredCameraDevice;
+
+  /// `requestFullMetadata` defaults to `true`, so the plugin tries to get the
+  /// full image metadata which may require extra permission requests on certain platforms.
+  /// If `requestFullMetadata` is set to `false`, the plugin fetches the image
+  /// in a way that reduces permission requests from the platform (e.g. on iOS
+  /// the plugin won’t ask for the `NSPhotoLibraryUsageDescription` permission).
+  final bool requestFullMetadata;
+}
diff --git a/packages/image_picker/image_picker_platform_interface/lib/src/types/types.dart b/packages/image_picker/image_picker_platform_interface/lib/src/types/types.dart
index 7f2844230287..dad86c5d1ba1 100644
--- a/packages/image_picker/image_picker_platform_interface/lib/src/types/types.dart
+++ b/packages/image_picker/image_picker_platform_interface/lib/src/types/types.dart
@@ -3,6 +3,7 @@
 // found in the LICENSE file.
 
 export 'camera_device.dart';
+export 'image_picker_options.dart';
 export 'image_source.dart';
 export 'lost_data_response.dart';
 export 'picked_file/picked_file.dart';
diff --git a/packages/image_picker/image_picker_platform_interface/pubspec.yaml b/packages/image_picker/image_picker_platform_interface/pubspec.yaml
index 54fd17e47260..be6d5442d03b 100644
--- a/packages/image_picker/image_picker_platform_interface/pubspec.yaml
+++ b/packages/image_picker/image_picker_platform_interface/pubspec.yaml
@@ -4,7 +4,7 @@ repository: https://github.com/flutter/plugins/tree/main/packages/image_picker/i
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+image_picker%22
 # NOTE: We strongly prefer non-breaking changes, even at the expense of a
 # less-clean API. See https://flutter.dev/go/platform-interface-breaking-changes
-version: 2.4.4
+version: 2.5.0
 
 environment:
   sdk: ">=2.12.0 <3.0.0"
diff --git a/packages/image_picker/image_picker_platform_interface/test/new_method_channel_image_picker_test.dart b/packages/image_picker/image_picker_platform_interface/test/new_method_channel_image_picker_test.dart
index 79d971f217f0..aea3ed9fc5a0 100644
--- a/packages/image_picker/image_picker_platform_interface/test/new_method_channel_image_picker_test.dart
+++ b/packages/image_picker/image_picker_platform_interface/test/new_method_channel_image_picker_test.dart
@@ -40,14 +40,16 @@ void main() {
               'maxWidth': null,
               'maxHeight': null,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 1,
               'maxWidth': null,
               'maxHeight': null,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
           ],
         );
@@ -93,49 +95,56 @@ void main() {
               'maxWidth': null,
               'maxHeight': null,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': 10.0,
               'maxHeight': null,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': null,
               'maxHeight': 10.0,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': 10.0,
               'maxHeight': 20.0,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': 10.0,
               'maxHeight': null,
               'imageQuality': 70,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': null,
               'maxHeight': 10.0,
               'imageQuality': 70,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': 10.0,
               'maxHeight': 20.0,
               'imageQuality': 70,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
           ],
         );
@@ -196,6 +205,7 @@ void main() {
               'maxHeight': null,
               'imageQuality': null,
               'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
           ],
         );
@@ -215,6 +225,7 @@ void main() {
               'maxHeight': null,
               'imageQuality': null,
               'cameraDevice': 1,
+              'requestFullMetadata': true,
             }),
           ],
         );
@@ -509,14 +520,16 @@ void main() {
               'maxWidth': null,
               'maxHeight': null,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 1,
               'maxWidth': null,
               'maxHeight': null,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
           ],
         );
@@ -562,49 +575,56 @@ void main() {
               'maxWidth': null,
               'maxHeight': null,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': 10.0,
               'maxHeight': null,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': null,
               'maxHeight': 10.0,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': 10.0,
               'maxHeight': 20.0,
               'imageQuality': null,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': 10.0,
               'maxHeight': null,
               'imageQuality': 70,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': null,
               'maxHeight': 10.0,
               'imageQuality': 70,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
             isMethodCall('pickImage', arguments: <String, dynamic>{
               'source': 0,
               'maxWidth': 10.0,
               'maxHeight': 20.0,
               'imageQuality': 70,
-              'cameraDevice': 0
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
           ],
         );
@@ -664,6 +684,7 @@ void main() {
               'maxHeight': null,
               'imageQuality': null,
               'cameraDevice': 0,
+              'requestFullMetadata': true,
             }),
           ],
         );
@@ -683,6 +704,7 @@ void main() {
               'maxHeight': null,
               'imageQuality': null,
               'cameraDevice': 1,
+              'requestFullMetadata': true,
             }),
           ],
         );
@@ -979,5 +1001,261 @@ void main() {
         expect(picker.getLostData(), throwsAssertionError);
       });
     });
+
+    group('#getImageFromSource', () {
+      test('passes the image source argument correctly', () async {
+        await picker.getImageFromSource(source: ImageSource.camera);
+        await picker.getImageFromSource(source: ImageSource.gallery);
+
+        expect(
+          log,
+          <Matcher>[
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': null,
+              'maxHeight': null,
+              'imageQuality': null,
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
+            }),
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 1,
+              'maxWidth': null,
+              'maxHeight': null,
+              'imageQuality': null,
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
+            }),
+          ],
+        );
+      });
+
+      test('passes the width and height arguments correctly', () async {
+        await picker.getImageFromSource(source: ImageSource.camera);
+        await picker.getImageFromSource(
+          source: ImageSource.camera,
+          options: const ImagePickerOptions(maxWidth: 10.0),
+        );
+        await picker.getImageFromSource(
+          source: ImageSource.camera,
+          options: const ImagePickerOptions(maxHeight: 10.0),
+        );
+        await picker.getImageFromSource(
+          source: ImageSource.camera,
+          options: const ImagePickerOptions(
+            maxWidth: 10.0,
+            maxHeight: 20.0,
+          ),
+        );
+        await picker.getImageFromSource(
+          source: ImageSource.camera,
+          options: const ImagePickerOptions(
+            maxWidth: 10.0,
+            imageQuality: 70,
+          ),
+        );
+        await picker.getImageFromSource(
+          source: ImageSource.camera,
+          options: const ImagePickerOptions(
+            maxHeight: 10.0,
+            imageQuality: 70,
+          ),
+        );
+        await picker.getImageFromSource(
+          source: ImageSource.camera,
+          options: const ImagePickerOptions(
+            maxWidth: 10.0,
+            maxHeight: 20.0,
+            imageQuality: 70,
+          ),
+        );
+
+        expect(
+          log,
+          <Matcher>[
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': null,
+              'maxHeight': null,
+              'imageQuality': null,
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
+            }),
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': 10.0,
+              'maxHeight': null,
+              'imageQuality': null,
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
+            }),
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': null,
+              'maxHeight': 10.0,
+              'imageQuality': null,
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
+            }),
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': 10.0,
+              'maxHeight': 20.0,
+              'imageQuality': null,
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
+            }),
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': 10.0,
+              'maxHeight': null,
+              'imageQuality': 70,
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
+            }),
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': null,
+              'maxHeight': 10.0,
+              'imageQuality': 70,
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
+            }),
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': 10.0,
+              'maxHeight': 20.0,
+              'imageQuality': 70,
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
+            }),
+          ],
+        );
+      });
+
+      test('does not accept a invalid imageQuality argument', () {
+        expect(
+          () => picker.getImageFromSource(
+            source: ImageSource.gallery,
+            options: const ImagePickerOptions(imageQuality: -1),
+          ),
+          throwsArgumentError,
+        );
+
+        expect(
+          () => picker.getImageFromSource(
+            source: ImageSource.gallery,
+            options: const ImagePickerOptions(imageQuality: 101),
+          ),
+          throwsArgumentError,
+        );
+
+        expect(
+          () => picker.getImageFromSource(
+            source: ImageSource.camera,
+            options: const ImagePickerOptions(imageQuality: -1),
+          ),
+          throwsArgumentError,
+        );
+
+        expect(
+          () => picker.getImageFromSource(
+            source: ImageSource.camera,
+            options: const ImagePickerOptions(imageQuality: 101),
+          ),
+          throwsArgumentError,
+        );
+      });
+
+      test('does not accept a negative width or height argument', () {
+        expect(
+          () => picker.getImageFromSource(
+            source: ImageSource.camera,
+            options: const ImagePickerOptions(maxWidth: -1.0),
+          ),
+          throwsArgumentError,
+        );
+
+        expect(
+          () => picker.getImageFromSource(
+            source: ImageSource.camera,
+            options: const ImagePickerOptions(maxHeight: -1.0),
+          ),
+          throwsArgumentError,
+        );
+      });
+
+      test('handles a null image path response gracefully', () async {
+        picker.channel
+            .setMockMethodCallHandler((MethodCall methodCall) => null);
+
+        expect(await picker.getImageFromSource(source: ImageSource.gallery),
+            isNull);
+        expect(await picker.getImageFromSource(source: ImageSource.camera),
+            isNull);
+      });
+
+      test('camera position defaults to back', () async {
+        await picker.getImageFromSource(source: ImageSource.camera);
+
+        expect(
+          log,
+          <Matcher>[
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': null,
+              'maxHeight': null,
+              'imageQuality': null,
+              'cameraDevice': 0,
+              'requestFullMetadata': true,
+            }),
+          ],
+        );
+      });
+
+      test('camera position can set to front', () async {
+        await picker.getImageFromSource(
+          source: ImageSource.camera,
+          options: const ImagePickerOptions(
+            preferredCameraDevice: CameraDevice.front,
+          ),
+        );
+
+        expect(
+          log,
+          <Matcher>[
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': null,
+              'maxHeight': null,
+              'imageQuality': null,
+              'cameraDevice': 1,
+              'requestFullMetadata': true,
+            }),
+          ],
+        );
+      });
+
+      test('passes the full metadata argument correctly', () async {
+        await picker.getImageFromSource(
+          source: ImageSource.camera,
+          options: const ImagePickerOptions(requestFullMetadata: false),
+        );
+
+        expect(
+          log,
+          <Matcher>[
+            isMethodCall('pickImage', arguments: <String, dynamic>{
+              'source': 0,
+              'maxWidth': null,
+              'maxHeight': null,
+              'imageQuality': null,
+              'cameraDevice': 0,
+              'requestFullMetadata': false,
+            }),
+          ],
+        );
+      });
+    });
   });
 }

From 93874c034f9c9b20e84f0cd70753ef2764d646c2 Mon Sep 17 00:00:00 2001
From: Piotr Mitkowski <piotr.mitkowski1@gmail.com>
Date: Tue, 3 May 2022 19:18:20 +0200
Subject: [PATCH 2/7] Added PR remarks for documentation in platform interface

---
 .../lib/src/types/image_picker_options.dart   | 38 +++++++++----------
 1 file changed, 18 insertions(+), 20 deletions(-)

diff --git a/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart b/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
index 74ebdd349f91..46a0742f9a8b 100644
--- a/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
+++ b/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
@@ -7,7 +7,7 @@ import 'package:image_picker_platform_interface/src/types/types.dart';
 /// Specifies options for picking a single image from the device's camera or gallery.
 class ImagePickerOptions {
   /// Creates an instance with the given [maxHeight], [maxWidth], [imageQuality],
-  /// [referredCameraDevice] and [requestFullMetadata]. Any of the params may be null.
+  /// [referredCameraDevice] and [requestFullMetadata].
   const ImagePickerOptions({
     this.maxHeight,
     this.maxWidth,
@@ -16,33 +16,31 @@ class ImagePickerOptions {
     this.requestFullMetadata = true,
   });
 
-  /// If specified, the image will be at most `maxWidth` wide. Otherwise,
-  /// the image will be returned at its original width.
+  /// The maximum width of the image, in pixels. If null, the image will only
+  /// be resized if maxHeight is specified.
   final double? maxWidth;
 
-  /// If specified, the image will be at most`maxHeight` tall.
-  /// Otherwise the image will be returned at its original height.
+  /// The maximum height of the image, in pixels. If null, the image will only
+  /// be resized if maxWidth is specified.
   final double? maxHeight;
 
-  /// Modifies the quality of the image, ranging from 0-100 where 100 is the original/max
-  /// quality. If `imageQuality` is null, the image with the originalquality will
-  /// be returned. Compression is only supported for certain image types such as
-  /// JPEG. If compression is not supported for the image that is picked, a warning
-  /// message will be logged.
+  /// Modifies the quality of the image, ranging from 0-100 where 100 is the
+  /// original/max quality.
+  ///
+  /// If null, the image will be returned with the original quality. Compression
+  /// is only supported for certain image types such as JPEG. If compression is
+  /// not supported for the image that is picked, a warning message will be logged.
   final int? imageQuality;
 
   /// Used to specify the camera to use when the `source` is [ImageSource.camera].
-  /// The `preferredCameraDevice` is ignored when `source` is [ImageSource.gallery].
-  /// It is also ignored if the chosen camera is not supported on the device.
-  /// Defaults to [CameraDevice.rear]. Note that Android has no documented parameter
-  /// for an intent to specify if the front or rear camera should be opened, this
-  /// function is not guaranteed to work on an Android device.
+  ///
+  /// Ignored if the source is not [ImageSource.camera], or the chosen camera is not
+  /// supported on the device. Defaults to [CameraDevice.rear].
   final CameraDevice preferredCameraDevice;
 
-  /// `requestFullMetadata` defaults to `true`, so the plugin tries to get the
-  /// full image metadata which may require extra permission requests on certain platforms.
-  /// If `requestFullMetadata` is set to `false`, the plugin fetches the image
-  /// in a way that reduces permission requests from the platform (e.g. on iOS
-  /// the plugin won’t ask for the `NSPhotoLibraryUsageDescription` permission).
+  /// If true, requests full image metadata, which may require extra permissions
+  /// on some platforms, (e.g., NSPhotoLibraryUsageDescription on iOS).
+  //
+  // Defaults to true.
   final bool requestFullMetadata;
 }

From 2983b849feddaf87756b41a3661aa24ba700f14b Mon Sep 17 00:00:00 2001
From: Piotr Mitkowski <piotr.mitkowski1@gmail.com>
Date: Wed, 4 May 2022 09:09:28 +0200
Subject: [PATCH 3/7] PR remarks

---
 .../image_picker_platform_interface/CHANGELOG.md            | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/image_picker/image_picker_platform_interface/CHANGELOG.md b/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
index ed95f20fbeab..2d5920539e1d 100644
--- a/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
+++ b/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
@@ -1,7 +1,9 @@
 ## 2.5.0
 
-* Re-adds `requestFullMetadata` option, but as a parameter of a new `pickImageFromSource`
-  method.
+* Makes `getImage` deprecated in favor of a new method `getImageFromSource`
+* Adds `requestFullMetadata` option that allows disabling extra permission requests
+  on certain platforms
+* Moves optional image picking parameters to `ImagePickerOptions` class 
   
 ## 2.4.4
 

From 577f6bf74a4b8b7751f9e94ff6b2a46f9e91b351 Mon Sep 17 00:00:00 2001
From: Piotr Mitkowski <piotr.mitkowski1@gmail.com>
Date: Wed, 4 May 2022 18:10:26 +0200
Subject: [PATCH 4/7] Update
 packages/image_picker/image_picker_platform_interface/CHANGELOG.md

Co-authored-by: Chris Yang <ychris@google.com>
---
 .../image_picker_platform_interface/CHANGELOG.md            | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/image_picker/image_picker_platform_interface/CHANGELOG.md b/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
index 2d5920539e1d..1e0e74ac6d90 100644
--- a/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
+++ b/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
@@ -1,9 +1,9 @@
 ## 2.5.0
 
-* Makes `getImage` deprecated in favor of a new method `getImageFromSource`
+* Makes `getImage` deprecated in favor of a new method `getImageFromSource`.
 * Adds `requestFullMetadata` option that allows disabling extra permission requests
-  on certain platforms
-* Moves optional image picking parameters to `ImagePickerOptions` class 
+  on certain platforms.
+* Moves optional image picking parameters to `ImagePickerOptions` class.
   
 ## 2.4.4
 

From 1e94e07469deed41b82c0d6dba96140bfde26888 Mon Sep 17 00:00:00 2001
From: Piotr Mitkowski <piotr.mitkowski1@gmail.com>
Date: Wed, 4 May 2022 18:10:47 +0200
Subject: [PATCH 5/7] Update
 packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart

Co-authored-by: Chris Yang <ychris@google.com>
---
 .../lib/src/types/image_picker_options.dart                  | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart b/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
index 46a0742f9a8b..9ed5b2b797b4 100644
--- a/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
+++ b/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
@@ -16,8 +16,9 @@ class ImagePickerOptions {
     this.requestFullMetadata = true,
   });
 
-  /// The maximum width of the image, in pixels. If null, the image will only
-  /// be resized if maxHeight is specified.
+  /// The maximum width of the image, in pixels.
+  ///
+  /// If null, the image will only be resized if [maxHeight] is specified.
   final double? maxWidth;
 
   /// The maximum height of the image, in pixels. If null, the image will only

From ca7e4b4b97c1655e8baf81195a9ba1c084c0b888 Mon Sep 17 00:00:00 2001
From: Piotr Mitkowski <piotr.mitkowski1@gmail.com>
Date: Wed, 4 May 2022 18:13:07 +0200
Subject: [PATCH 6/7] PR remarks

---
 .../lib/src/types/image_picker_options.dart                  | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart b/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
index 9ed5b2b797b4..0399a110b7db 100644
--- a/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
+++ b/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
@@ -21,8 +21,9 @@ class ImagePickerOptions {
   /// If null, the image will only be resized if [maxHeight] is specified.
   final double? maxWidth;
 
-  /// The maximum height of the image, in pixels. If null, the image will only
-  /// be resized if maxWidth is specified.
+  /// The maximum height of the image, in pixels.
+  ///
+  /// If null, the image will only be resized if maxWidth is specified.
   final double? maxHeight;
 
   /// Modifies the quality of the image, ranging from 0-100 where 100 is the

From 816b59b1b649ae608cc6aacc5857f29614afbf25 Mon Sep 17 00:00:00 2001
From: Piotr Mitkowski <piotr.mitkowski1@gmail.com>
Date: Thu, 5 May 2022 08:34:40 +0200
Subject: [PATCH 7/7] PR remarks

---
 .../image_picker_platform_interface/CHANGELOG.md   |  8 ++++----
 .../platform_interface/image_picker_platform.dart  | 14 ++++++++------
 .../lib/src/types/image_picker_options.dart        | 10 ++++++----
 .../test/new_method_channel_image_picker_test.dart | 10 +++++-----
 4 files changed, 23 insertions(+), 19 deletions(-)

diff --git a/packages/image_picker/image_picker_platform_interface/CHANGELOG.md b/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
index 1e0e74ac6d90..98d6653313fc 100644
--- a/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
+++ b/packages/image_picker/image_picker_platform_interface/CHANGELOG.md
@@ -1,9 +1,9 @@
 ## 2.5.0
 
-* Makes `getImage` deprecated in favor of a new method `getImageFromSource`.
-* Adds `requestFullMetadata` option that allows disabling extra permission requests
-  on certain platforms.
-* Moves optional image picking parameters to `ImagePickerOptions` class.
+* Deprecates `getImage` in favor of a new method `getImageFromSource`.
+    * Adds `requestFullMetadata` option that allows disabling extra permission requests
+      on certain platforms.
+    * Moves optional image picking parameters to `ImagePickerOptions` class.
   
 ## 2.4.4
 
diff --git a/packages/image_picker/image_picker_platform_interface/lib/src/platform_interface/image_picker_platform.dart b/packages/image_picker/image_picker_platform_interface/lib/src/platform_interface/image_picker_platform.dart
index 4efbac7793aa..d1d06f904fe6 100644
--- a/packages/image_picker/image_picker_platform_interface/lib/src/platform_interface/image_picker_platform.dart
+++ b/packages/image_picker/image_picker_platform_interface/lib/src/platform_interface/image_picker_platform.dart
@@ -259,14 +259,16 @@ abstract class ImagePickerPlatform extends PlatformInterface {
   /// The `source` argument controls where the image comes from. This can
   /// be either [ImageSource.camera] or [ImageSource.gallery].
   ///
-  /// The `options` argument controls additional settings that can be used when picking an image. See [ImagePickerOptions]
-  /// for more details.
+  /// The `options` argument controls additional settings that can be used when
+  /// picking an image. See [ImagePickerOptions] for more details.
   ///
-  /// Where iOS supports HEIC images, Android 8 and below doesn't. Android 9 and above only support HEIC images if used
-  /// in addition to a size modification, of which the usage is explained in [ImagePickerOptions].
+  /// Where iOS supports HEIC images, Android 8 and below doesn't. Android 9 and
+  /// above only support HEIC images if used in addition to a size modification,
+  /// of which the usage is explained in [ImagePickerOptions].
   ///
-  /// In Android, the MainActivity can be destroyed for various reasons. If that happens, the result will be lost
-  /// in this call. You can then call [getLostData] when your app relaunches to retrieve the lost data.
+  /// In Android, the MainActivity can be destroyed for various reasons. If that
+  /// happens, the result will be lost in this call. You can then call [getLostData]
+  /// when your app relaunches to retrieve the lost data.
   ///
   /// If no images were picked, the return value is null.
   Future<XFile?> getImageFromSource({
diff --git a/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart b/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
index 0399a110b7db..cdc89a920178 100644
--- a/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
+++ b/packages/image_picker/image_picker_platform_interface/lib/src/types/image_picker_options.dart
@@ -23,15 +23,17 @@ class ImagePickerOptions {
 
   /// The maximum height of the image, in pixels.
   ///
-  /// If null, the image will only be resized if maxWidth is specified.
+  /// If null, the image will only be resized if [maxWidth] is specified.
   final double? maxHeight;
 
   /// Modifies the quality of the image, ranging from 0-100 where 100 is the
   /// original/max quality.
   ///
-  /// If null, the image will be returned with the original quality. Compression
-  /// is only supported for certain image types such as JPEG. If compression is
-  /// not supported for the image that is picked, a warning message will be logged.
+  /// Compression is only supported for certain image types such as JPEG. If
+  /// compression is not supported for the image that is picked, a warning
+  /// message will be logged.
+  ///
+  /// If null, the image will be returned with the original quality.
   final int? imageQuality;
 
   /// Used to specify the camera to use when the `source` is [ImageSource.camera].
diff --git a/packages/image_picker/image_picker_platform_interface/test/new_method_channel_image_picker_test.dart b/packages/image_picker/image_picker_platform_interface/test/new_method_channel_image_picker_test.dart
index aea3ed9fc5a0..72ed363ef7ae 100644
--- a/packages/image_picker/image_picker_platform_interface/test/new_method_channel_image_picker_test.dart
+++ b/packages/image_picker/image_picker_platform_interface/test/new_method_channel_image_picker_test.dart
@@ -150,7 +150,7 @@ void main() {
         );
       });
 
-      test('does not accept a invalid imageQuality argument', () {
+      test('does not accept an invalid imageQuality argument', () {
         expect(
           () => picker.pickImage(imageQuality: -1, source: ImageSource.gallery),
           throwsArgumentError,
@@ -331,7 +331,7 @@ void main() {
         );
       });
 
-      test('does not accept a invalid imageQuality argument', () {
+      test('does not accept an invalid imageQuality argument', () {
         returnValue = <dynamic>['0', '1'];
         expect(
           () => picker.pickMultiImage(imageQuality: -1),
@@ -630,7 +630,7 @@ void main() {
         );
       });
 
-      test('does not accept a invalid imageQuality argument', () {
+      test('does not accept an invalid imageQuality argument', () {
         expect(
           () => picker.getImage(imageQuality: -1, source: ImageSource.gallery),
           throwsArgumentError,
@@ -810,7 +810,7 @@ void main() {
         );
       });
 
-      test('does not accept a invalid imageQuality argument', () {
+      test('does not accept an invalid imageQuality argument', () {
         returnValue = <dynamic>['0', '1'];
         expect(
           () => picker.getMultiImage(imageQuality: -1),
@@ -1133,7 +1133,7 @@ void main() {
         );
       });
 
-      test('does not accept a invalid imageQuality argument', () {
+      test('does not accept an invalid imageQuality argument', () {
         expect(
           () => picker.getImageFromSource(
             source: ImageSource.gallery,

<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>pFad - Phonifier reborn</title>
<meta http-equiv='Content-Type' content='text/html; charset=utf-8' />
</head>
<body>
<h1>Pfad - The Proxy pFad of &#169; 2024 Garber Painting. All rights reserved.</h1>


<!-- Disclaimer -->
<p>Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.</p>
<br>
<p>Alternative Proxies:</p><p><a href="http://clevelandohioweatherforecast.com/php-proxy/index.php?q=https://patch-diff.githubusercontent.com/raw/flutter/plugins/pull/5603.patch" target="_blank">Alternative Proxy</a></p><p><a href="http://clevelandohioweatherforecast.com/pFad/index.php?u=https://patch-diff.githubusercontent.com/raw/flutter/plugins/pull/5603.patch" target="_blank">pFad Proxy</a></p><p><a href="http://clevelandohioweatherforecast.com/pFad/v3index.php?u=https://patch-diff.githubusercontent.com/raw/flutter/plugins/pull/5603.patch" target="_blank">pFad v3 Proxy</a></p><p><a href="http://clevelandohioweatherforecast.com/pFad/v4index.php?u=https://patch-diff.githubusercontent.com/raw/flutter/plugins/pull/5603.patch" target="_blank">pFad v4 Proxy</a></p></body>
</html>