---
title: "CTFontDescriptorCreateCopyWithVariation(_:_:_:)"
framework: coretext
role: symbol
role_heading: Function
path: "coretext/ctfontdescriptorcreatecopywithvariation(_:_:_:)"
---

# CTFontDescriptorCreateCopyWithVariation(_:_:_:)

Creates a copy of the original font descriptor with a new variation instance.

## Declaration

```swift
func CTFontDescriptorCreateCopyWithVariation(_ original: CTFontDescriptor, _ variationIdentifier: CFNumber, _ variationValue: CGFloat) -> CTFontDescriptor
```

## Parameters

- `original`: The original font descriptor.
- `variationIdentifier`: The variation axis identifier. This is the four-character code of the variation axis as a CFNumber object.
- `variationValue`: The value corresponding with the variation instance.

## Return Value

Return Value A copy of the original font descriptor with a new variation instance.

## Discussion

Discussion This is a convenience method for easily creating new variation font instances.

## See Also

### Creating Font Descriptors

- [CTFontDescriptorCreateWithNameAndSize(_:_:)](coretext/ctfontdescriptorcreatewithnameandsize(_:_:).md)
- [CTFontDescriptorCreateWithAttributes(_:)](coretext/ctfontdescriptorcreatewithattributes(_:).md)
- [CTFontDescriptorCreateCopyWithAttributes(_:_:)](coretext/ctfontdescriptorcreatecopywithattributes(_:_:).md)
- [CTFontDescriptorCreateCopyWithFeature(_:_:_:)](coretext/ctfontdescriptorcreatecopywithfeature(_:_:_:).md)
- [CTFontDescriptorCreateCopyWithFamily(_:_:)](coretext/ctfontdescriptorcreatecopywithfamily(_:_:).md)
- [CTFontDescriptorCreateCopyWithSymbolicTraits(_:_:_:)](coretext/ctfontdescriptorcreatecopywithsymbolictraits(_:_:_:).md)
- [CTFontDescriptorCreateMatchingFontDescriptors(_:_:)](coretext/ctfontdescriptorcreatematchingfontdescriptors(_:_:).md)
- [CTFontDescriptorCreateMatchingFontDescriptor(_:_:)](coretext/ctfontdescriptorcreatematchingfontdescriptor(_:_:).md)