<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVMutableCaption",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVMutableCaption"
  },
  "title" : "AVMutableCaption"
}
-->

# AVMutableCaption

A mutable caption subclass that you use to create new captions.

```
class AVMutableCaption
```

## Topics

### Configuring text and timing

[`text`](/documentation/AVFoundation/AVMutableCaption/text)

The caption text.

[`timeRange`](/documentation/AVFoundation/AVMutableCaption/timeRange)

The time range over which the system presents the caption.

### Configuring the region

[`region`](/documentation/AVFoundation/AVMutableCaption/region)

The region in which the caption exists.

### Configuring font styles

[`AVCaption.FontStyle`](/documentation/AVFoundation/AVCaption/FontStyle)

Font styles for caption text.

[`setFontStyle(_:in:)`](/documentation/AVFoundation/AVMutableCaption/setFontStyle(_:in:))

Sets the font style for a range of text.

[`removeFontStyle(in:)`](/documentation/AVFoundation/AVMutableCaption/removeFontStyle(in:))

Removes a font style from a range of text.

[`setFontStyle:inRange:`](/documentation/AVFoundation/AVMutableCaption/setFontStyle:inRange:)

Sets the font style for a range of text.

[`removeFontStyleInRange:`](/documentation/AVFoundation/AVMutableCaption/removeFontStyleInRange:)

Removes a font style from a range of text.

[`AVCaption.FontWeight`](/documentation/AVFoundation/AVCaption/FontWeight)

Font weights for a caption.

[`setFontWeight(_:in:)`](/documentation/AVFoundation/AVMutableCaption/setFontWeight(_:in:))

Sets the font weight for a range of text.

[`removeFontWeight(in:)`](/documentation/AVFoundation/AVMutableCaption/removeFontWeight(in:))

Removes a font weight from a range of text.

[`setFontWeight:inRange:`](/documentation/AVFoundation/AVMutableCaption/setFontWeight:inRange:)

Sets the font weight for a range of text.

[`removeFontWeightInRange:`](/documentation/AVFoundation/AVMutableCaption/removeFontWeightInRange:)

Removes a font weight from a range of text.

[`AVCaption.Decoration`](/documentation/AVFoundation/AVCaption/Decoration)

Text decorations for caption text.

[`setDecoration(_:in:)`](/documentation/AVFoundation/AVMutableCaption/setDecoration(_:in:))

Sets a decoration for a range of text.

[`removeDecoration(in:)`](/documentation/AVFoundation/AVMutableCaption/removeDecoration(in:))

Removes a decoration from a range of text.

[`setDecoration:inRange:`](/documentation/AVFoundation/AVMutableCaption/setDecoration:inRange:)

Sets a decoration for a range of text.

[`removeDecorationInRange:`](/documentation/AVFoundation/AVMutableCaption/removeDecorationInRange:)

Removes a decoration from a range of text.

### Configuring colors

[`setTextColor(_:in:)`](/documentation/AVFoundation/AVMutableCaption/setTextColor(_:in:))

Sets the text color for a range of text.

[`removeTextColor(in:)`](/documentation/AVFoundation/AVMutableCaption/removeTextColor(in:))

Removes the text color for a range of text.

[`setBackgroundColor(_:in:)`](/documentation/AVFoundation/AVMutableCaption/setBackgroundColor(_:in:))

Sets the background color for a range of text.

[`removeBackgroundColor(in:)`](/documentation/AVFoundation/AVMutableCaption/removeBackgroundColor(in:))

Removes a background color from a range of text.

[`setTextColor:inRange:`](/documentation/AVFoundation/AVMutableCaption/setTextColor:inRange:)

Sets the text color for a range of text.

[`removeTextColorInRange:`](/documentation/AVFoundation/AVMutableCaption/removeTextColorInRange:)

Removes the text color for a range of text.

[`setBackgroundColor:inRange:`](/documentation/AVFoundation/AVMutableCaption/setBackgroundColor:inRange:)

Sets the background color for a range of text.

[`removeBackgroundColorInRange:`](/documentation/AVFoundation/AVMutableCaption/removeBackgroundColorInRange:)

Removes a background color from a range of text.

### Configuring alignment

[`textAlignment`](/documentation/AVFoundation/AVMutableCaption/textAlignment)

The alignment of the caption text.

[`AVCaption.TextAlignment`](/documentation/AVFoundation/AVCaption/TextAlignment-swift.enum)

Text alignment options for a caption.

### Configuring animation

[`animation`](/documentation/AVFoundation/AVMutableCaption/animation)

Animations to apply to the caption text.

[`AVCaption.Animation`](/documentation/AVFoundation/AVCaption/Animation-swift.enum)

Animation options for a caption.

### Configuring advanced typography

[`AVCaption.Ruby`](/documentation/AVFoundation/AVCaption/Ruby)

An object that presents ruby characters.

[`setRuby(_:in:)`](/documentation/AVFoundation/AVMutableCaption/setRuby(_:in:))

Sets ruby text for a range.

[`removeRuby(in:)`](/documentation/AVFoundation/AVMutableCaption/removeRuby(in:))

Removes ruby text from a range.

[`setRuby:inRange:`](/documentation/AVFoundation/AVMutableCaption/setRuby:inRange:)

Sets ruby text for a range.

[`removeRubyInRange:`](/documentation/AVFoundation/AVMutableCaption/removeRubyInRange:)

Removes ruby text from a range.

[`AVCaption.TextCombine`](/documentation/AVFoundation/AVCaption/TextCombine)

The caption’s supported rendering policy options.

[`setTextCombine(_:in:)`](/documentation/AVFoundation/AVMutableCaption/setTextCombine(_:in:))

Sets text combine for a range.

[`removeTextCombine(in:)`](/documentation/AVFoundation/AVMutableCaption/removeTextCombine(in:))

Removes text combine from a range.

[`setTextCombine:inRange:`](/documentation/AVFoundation/AVMutableCaption/setTextCombine:inRange:)

Sets text combine for a range.

[`removeTextCombineInRange:`](/documentation/AVFoundation/AVMutableCaption/removeTextCombineInRange:)

Removes text combine from a range of text.


---

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)