<!--
{
  "availability" : [
    "FxPlug: 4.2.9 -"
  ],
  "documentType" : "symbol",
  "framework" : "Professional Video Applications",
  "identifier" : "/documentation/professional_video_applications/FxProjectAPI_v2/projectAspectRatio(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Professional Video Applications"
    ],
    "preciseIdentifier" : "c:objc(pl)FxProjectAPI_v2(im)projectAspectRatio:error:"
  },
  "title" : "projectAspectRatio(_:)"
}
-->

# projectAspectRatio(_:)

Provides the aspect ratio of the host’s project.

```
func projectAspectRatio(_ aspectRatio: UnsafeMutablePointer<Float>!) throws
```

## Parameters

`aspectRatio`

A float value representing the project aspect ratio.

## Discussion

Use this method to get the aspect ratio of the current project. The clip that the user applies your plug-in to may not be the same aspect ratio as the project or sequence it’s a part of.

> Note:
> This method returns the document space aspect ratio, meaning the aspect ratio the project is displayed at after any non-square pixels or fields are accounted for. For example, a NTSC standard definition DV project that’s `720 x 480` with `10:11` pixel aspect ratio returns `(720 * 10/11) / 480 = ~1.36363636...` as the aspect ratio, not `1.5`.

---

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)