# CTRubyAnnotationCreate(_:_:_:_:) Creates an immutable ruby annotation object. ``` func CTRubyAnnotationCreate(_ alignment: CTRubyAlignment, _ overhang: CTRubyOverhang, _ sizeFactor: CGFloat, _ text: UnsafeMutablePointer?>) -> CTRubyAnnotation ``` ## Parameters `alignment` An alignment value that specifies how the ruby text and the base text align relative to each other. `overhang` An overhang value that specifies how the ruby text overhangs adjacent characters. `sizeFactor` A size factor that specifies the annotation text size as a percentage of the base text size. `text` An array of objects, indexed by [`CTRubyPosition`](/documentation/CoreText/CTRubyPosition). Pass in `NULL` for any unused positions. ## Return Value A reference to a [`CTRubyAnnotation`](/documentation/CoreText/CTRubyAnnotation) object. ## Discussion Use this function to create a ruby annotation object in the most straightforward and efficient way. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)