<!--
{
  "availability" : [
    "iOS: 8.0.0 -",
    "iPadOS: 8.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.13.0 -",
    "tvOS: 10.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "PhotoKit",
  "identifier" : "/documentation/Photos/PHImageRequestOptions",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Photos"
    ],
    "preciseIdentifier" : "c:objc(cs)PHImageRequestOptions"
  },
  "title" : "PHImageRequestOptions"
}
-->

# PHImageRequestOptions

A set of options affecting the delivery of still image representations of Photos assets you request from an image manager.

```
class PHImageRequestOptions
```

## Topics

### Scheduling an Image Request

[`synchronous`](/documentation/Photos/PHImageRequestOptions/isSynchronous)

A Boolean value that determines whether Photos processes the image request synchronously.

### Specifying Image Request Options

[`version`](/documentation/Photos/PHImageRequestOptions/version)

The version of the image to be requested.

[`PHImageRequestOptionsVersion`](/documentation/Photos/PHImageRequestOptionsVersion)

Options for requesting an image asset with or without adjustments, used by the [`version`](/documentation/Photos/PHImageRequestOptions/version) property.

[`deliveryMode`](/documentation/Photos/PHImageRequestOptions/deliveryMode)

The requested image quality and delivery priority.

[`PHImageRequestOptionsDeliveryMode`](/documentation/Photos/PHImageRequestOptionsDeliveryMode)

Options for delivering requested image data, used by the [`deliveryMode`](/documentation/Photos/PHImageRequestOptions/deliveryMode) property.

[`resizeMode`](/documentation/Photos/PHImageRequestOptions/resizeMode)

A mode that specifies how to resize the requested image.

[`PHImageRequestOptionsResizeMode`](/documentation/Photos/PHImageRequestOptionsResizeMode)

Options for how to resize the requested image to fit a target size, used by the [`resizeMode`](/documentation/Photos/PHImageRequestOptions/resizeMode) property.

[`normalizedCropRect`](/documentation/Photos/PHImageRequestOptions/normalizedCropRect)

A rectangle for requesting a cropped version of the original image.

### Fetching Image Data from iCloud

[`networkAccessAllowed`](/documentation/Photos/PHImageRequestOptions/isNetworkAccessAllowed)

A Boolean value that specifies whether Photos can download the requested image from iCloud.

[`progressHandler`](/documentation/Photos/PHImageRequestOptions/progressHandler)

A block that Photos calls periodically while downloading the image.

[`PHAssetImageProgressHandler`](/documentation/Photos/PHAssetImageProgressHandler)

The signature for a block that Photos calls while downloading asset data from iCloud. Used by the [`progressHandler`](/documentation/Photos/PHImageRequestOptions/progressHandler) property.

## Relationships

### Conforms To

[`Hashable`](/documentation/Swift/Hashable)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`Equatable`](/documentation/Swift/Equatable)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`NSCopying`](/documentation/Foundation/NSCopying)

[`CVarArg`](/documentation/Swift/CVarArg)

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)