---
title: "CTFontCollectionCreateCopyWithFontDescriptors(_:_:_:)"
framework: coretext
role: symbol
role_heading: Function
path: "coretext/ctfontcollectioncreatecopywithfontdescriptors(_:_:_:)"
---

# CTFontCollectionCreateCopyWithFontDescriptors(_:_:_:)

Returns a copy of the original collection augmented with the given new font descriptors.

## Declaration

```swift
func CTFontCollectionCreateCopyWithFontDescriptors(_ original: CTFontCollection, _ queryDescriptors: CFArray?, _ options: CFDictionary?) -> CTFontCollection
```

## Parameters

- `original`: The original font collection reference.
- `queryDescriptors`: An array of font descriptors to augment those of the original collection.
- `options`: The options dictionary. For possible values, see Constants.

## Return Value

Return Value A copy of the original font collection augmented by the new font descriptors and options.

## Discussion

Discussion The new font descriptors are merged with the existing descriptors to create a single set.

## See Also

### Creating Font Collections

- [CTFontCollectionCreateFromAvailableFonts(_:)](coretext/ctfontcollectioncreatefromavailablefonts(_:).md)
- [CTFontCollectionCreateWithFontDescriptors(_:_:)](coretext/ctfontcollectioncreatewithfontdescriptors(_:_:).md)
- [CTFontCollectionCreateMutableCopy(_:)](coretext/ctfontcollectioncreatemutablecopy(_:).md)