<!--
{
  "availability" : [
    "macCatalyst: -",
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreGraphics",
  "identifier" : "/documentation/CoreGraphics/CGWindowImageOption",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Core Graphics"
    ],
    "preciseIdentifier" : "c:@E@CGWindowImageOption"
  },
  "title" : "CGWindowImageOption"
}
-->

# CGWindowImageOption

The data type to use to specify the type of image to be generated for a window.

```
struct CGWindowImageOption
```

## Overview

This type is used in conjunction with the constants described in [Window Image Types](/documentation/CoreGraphics/window-image-types).

## Topics

### Initializers

[`init(rawValue:)`](/documentation/CoreGraphics/CGWindowImageOption/init(rawValue:))

### Type Properties

[`bestResolution`](/documentation/CoreGraphics/CGWindowImageOption/bestResolution)

When capturing the window, return the best image resolution. The returned image size may be different than the screen size.

[`boundsIgnoreFraming`](/documentation/CoreGraphics/CGWindowImageOption/boundsIgnoreFraming)

[`kCGWindowImageDefault`](/documentation/CoreGraphics/CGWindowImageOption/kCGWindowImageDefault)

[`nominalResolution`](/documentation/CoreGraphics/CGWindowImageOption/nominalResolution)

When capturing the window, return the nominal image resolution. The returned image size is the same as the screen size.

[`onlyShadows`](/documentation/CoreGraphics/CGWindowImageOption/onlyShadows)

[`shouldBeOpaque`](/documentation/CoreGraphics/CGWindowImageOption/shouldBeOpaque)


---

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)