---
title: "CTFontCreateWithFontDescriptor(_:_:_:)"
framework: coretext
role: symbol
role_heading: Function
path: "coretext/ctfontcreatewithfontdescriptor(_:_:_:)"
---

# CTFontCreateWithFontDescriptor(_:_:_:)

Returns a new font reference that best matches the given font descriptor.

## Declaration

```swift
func CTFontCreateWithFontDescriptor(_ descriptor: CTFontDescriptor, _ size: CGFloat, _ matrix: UnsafePointer<CGAffineTransform>?) -> CTFont
```

## Parameters

- `descriptor`: A font descriptor containing attributes that specify the requested font.
- `size`: The point size for the font reference. If 0.0 is specified, the default font size of 12.0 is used. This parameter is optional.
- `matrix`: The transformation matrix for the font. In most cases, set this parameter to be NULL. If NULL is specified, the identity matrix is used. This parameter is optional.

## Return Value

Return Value A CTFontRef that best matches the attributes provided with the font descriptor.

## Discussion

Discussion The size and matrix parameters override any specified in the font descriptor unless they are unspecified (0.0 for size and NULL for matrix). A best match font is always returned, and default values are used for any unspecified parameters.

## See Also

### Creating Fonts

- [CTFontCreateWithName(_:_:_:)](coretext/ctfontcreatewithname(_:_:_:).md)
- [CTFontCreateWithNameAndOptions(_:_:_:_:)](coretext/ctfontcreatewithnameandoptions(_:_:_:_:).md)
- [CTFontCreateWithFontDescriptorAndOptions(_:_:_:_:)](coretext/ctfontcreatewithfontdescriptorandoptions(_:_:_:_:).md)
- [CTFontCreateUIFontForLanguage(_:_:_:)](coretext/ctfontcreateuifontforlanguage(_:_:_:).md)
- [CTFontCreateCopyWithAttributes(_:_:_:_:)](coretext/ctfontcreatecopywithattributes(_:_:_:_:).md)
- [CTFontCreateCopyWithSymbolicTraits(_:_:_:_:_:)](coretext/ctfontcreatecopywithsymbolictraits(_:_:_:_:_:).md)
- [CTFontCreateCopyWithFamily(_:_:_:_:)](coretext/ctfontcreatecopywithfamily(_:_:_:_:).md)
- [CTFontCreateForString(_:_:_:)](coretext/ctfontcreateforstring(_:_:_:).md)
- [CTFontCreateForStringWithLanguage(_:_:_:_:)](coretext/ctfontcreateforstringwithlanguage(_:_:_:_:).md)