CTFontCreateWithFontDescriptorAndOptions(_:_:_:_:)

Declaration

func CTFontCreateWithFontDescriptorAndOptions(_ descriptor: CTFontDescriptor, _ size: CGFloat, _ matrix: UnsafePointer<CGAffineTransform>?, _ options: CTFontOptions) -> 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.

• options:

  Options flags. See Ctfontoptions for values. This parameter is optional.

Return Value

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

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 and options). A best match font is always returned, and default values are used for any unspecified.

See Also

Creating Fonts

• CTFontCreateWithName(_:_:_:)
• CTFontCreateWithNameAndOptions(_:_:_:_:)
• CTFontCreateWithFontDescriptor(_:_:_:)
• CTFontCreateUIFontForLanguage(_:_:_:)
• CTFontCreateCopyWithAttributes(_:_:_:_:)
• CTFontCreateCopyWithSymbolicTraits(_:_:_:_:_:)
• CTFontCreateCopyWithFamily(_:_:_:_:)
• CTFontCreateForString(_:_:_:)
• CTFontCreateForStringWithLanguage(_:_:_:_:)