---
title: "CTFontCreateCopyWithSymbolicTraits(_:_:_:_:_:)"
framework: coretext
role: symbol
role_heading: Function
path: "coretext/ctfontcreatecopywithsymbolictraits(_:_:_:_:_:)"
---

# CTFontCreateCopyWithSymbolicTraits(_:_:_:_:_:)

Returns a new font in the same font family as the original with the specified symbolic traits.

## Declaration

```swift
func CTFontCreateCopyWithSymbolicTraits(_ font: CTFont, _ size: CGFloat, _ matrix: UnsafePointer<CGAffineTransform>?, _ symTraitValue: CTFontSymbolicTraits, _ symTraitMask: CTFontSymbolicTraits) -> CTFont?
```

## Parameters

- `font`: The original font reference on which to base the new font.
- `size`: The point size for the font reference. If 0.0 is specified, the original font’s size is preserved.
- `matrix`: The transformation matrix for the font. In most cases, set this parameter to be NULL. If NULL is specified, the original font’s matrix is preserved.
- `symTraitValue`: The value of the symbolic traits.
- `symTraitMask`: The mask bits of the symbolic traits.

## Return Value

Return Value A new font reference in the same family with the given symbolic traits. or NULL if none is found in the system.

## See Also

### Creating Fonts

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