<!--
{
  "availability" : [
    "iOS: 7.0.0 -",
    "iPadOS: 7.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.9.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreMedia",
  "identifier" : "/documentation/CoreMedia/kCMTextMarkupAttribute_TextPositionPercentageRelativeToWritingDirection",
  "metadataVersion" : "0.1.0",
  "role" : "Global Variable",
  "symbol" : {
    "kind" : "Global Variable",
    "modules" : [
      "Core Media"
    ],
    "preciseIdentifier" : "c:@kCMTextMarkupAttribute_TextPositionPercentageRelativeToWritingDirection"
  },
  "title" : "kCMTextMarkupAttribute_TextPositionPercentageRelativeToWritingDirection"
}
-->

# kCMTextMarkupAttribute_TextPositionPercentageRelativeToWritingDirection

The placement of the block of text as a percentage in the writing direction.

```
let kCMTextMarkupAttribute_TextPositionPercentageRelativeToWritingDirection: CFString
```

## Discussion

This attribute’s value must be a non-negative `CFNumber` that expresses the position of the center of the text in the writing direction as a percentage of the video dimensions in the writing direction. For horizontal cues, this is the horizontal position. For vertical, it’s the vertical position. The system calculates the percentage from the edge of the frame where the text begins (for left-to-right English, it’s the left edge).

If you use this attribute, apply it to the entire attributed string.

---

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)