Retired Document
Important: ATSUI is a legacy technology in Mac OS X v10.6 and later. Please use Core Text, described in Core Text Programming Guide, instead.
ATSUI Glossary
- absolute position
A specific position, given in coordinates, for the origin of each character or glyph in a line of text. Compare relative position.
- active end
When selecting text, the point at which the user releases the mouse button. See also anchor point.
- advance delta
The distance between the end of one glyph’s advance and the next glyph’s real position.
- advance height
The distance from the top of a glyph to the bottom of the glyph, including the top-side bearing and bottom-side bearing.
- advance width
The full horizontal width of a glyph as measured from its origin to the origin of the next glyph on the line, including the side bearings on both sides.
- alignment
The process of placing text in relation to one or both margins. Also referred to as flushness.
- anchor point
The position in the text at which the user positions the pointer and presses the mouse button. See also active end.
- angled caret
A caret whose angle in relation to the baseline of the display text is equivalent to the slant of the glyphs making up the text.
- anti-aliasing
The smoothing of jagged edges on a displayed glyph by modifying the transparencies of individual pixels along the glyph’s edge.
- ascent line
An imaginary horizontal line that corresponds approximately to the tops of the uppercase letters in the font. Uppercase letters are chosen because, among the regularly used glyphs in a font, these are generally the tallest.
- backing store
A file in which the Virtual Memory Manager stores the contents of unneeded pages of memory.
- baseline
An imaginary line used to align glyphs in a line of text.
- baseline delta
The distance (in points) between a baseline and y = 0; sometimes referred to as delta-y. See also baseline type.
- baseline type
The classification of baseline used with a particular kind of text. See, for example, Roman baseline.
- Bézier curve
A cubic equation originally developed by Pierre Bézier. In typography, used to define the shape of a glyph.
- bidi
- bidirectional script system
A script system in which text is generally right-aligned with most characters written from right to left, but with some left-to-right text as well. Arabic and Hebrew are bidirectional script systems.
- blit
Slang for copying an image from memory to the screen.
- bottom-side bearing
The white space between the bottom of the glyph and the visible ending of the glyph.
- bounding box
The smallest rectangle that entirely encloses the pixels or outline of a glyph.
- byte offset
The numbering of character codes in source text. Compare edge offset.
- caret
A vertical or slanted blinking bar, appearing at a caret position in the display text, that marks the point at which text is to be inserted or deleted. Compare dual caret.
- caret angle
The angle of a caret or of the edges of a highlight. The caret angle can be perpendicular to the baseline or parallel to the angle of the style run’s text.
- caret position
A location on screen, typically between glyphs, that relates directly to a caret offset in the source text.
- caret type
A designation of the behavior of the caret at direction boundaries in text. See also dual caret.
- character
A symbol standing for a sound, syllable, or notion used in writing; one of the simple elements of a written language, for example, the lowercase letter “a” or the number “1”. Compare character code, glyph.
- character clusters
A collection of characters treated as individual components of a whole, including a principal character plus attachments in memory. For example, in Hebrew, a cluster may be composed of a consonant, a vowel, a dot to soften the pronunciation of the consonant, and a cantillation mark.
- character code
A numerical representation of a character. Each writing system or language has one or more character encodings—tables that relate character codes to the characters they represent.
- character encoding
An internal conversion table for interpreting a specific character set.
- contextual features
Features that are applied to a glyph depending on the glyph’s position relative to adjacent glyphs. Compare noncontextual features.
- contextual form
An alternate form of a glyph whose use depends on the glyph’s placement in a word.
- contiguous highlighting
Highlighting that consists of a single, contiguous shape across direction boundaries, even when it does not exactly match the selection range to which it corresponds. Compare discontinuous highlighting.
- counter
The oval in glyphs such as “p” or “d”.
- cross-stream kerning
The automatic movement of glyphs perpendicular to the line orientation of the text.
- cross-stream shift
A type of positional shift that applies equally to all glyphs in a style run by raising or lowering the entire style run (or shifts it sideways if it’s vertical text). Compare with-stream shift.
- cubic curve
A curve defined by a cubic equation. See also B�zier curve.
- cursor
A small icon, often an arrow or an I-beam shape, that moves with the mouse or other pointing device. Compare caret.
- descent line
An imaginary horizontal line that usually corresponds with the bottoms of the descenders in a font. The descent line is the same distance from the baseline for all glyphs in the font, whether or not they have descenders.
- device delta
A value used to adjust truncated factional values for cases in which fractional positioning can’t be used; for example, to compensate for integer drawing in QuickDraw. Device delta values are usually used when anti-aliasing is turned off. However, these values can be used when anti-aliasing is on, to assure that the glyphs in a connected script (such as one that uses the Zapfino font) are connected smoothly.
- device advance
The number of pixels of the advance for the glyph as actually drawn on the screen.
- device space
The coordinate system that defines the position and scale (pixel size) of a specific view device.
- diacritical marks
A mark, such as an accent, that is used in conjunction with a character to indicate phonetic value.
- direct-access functions
ATSUI functions that allow you to manipulate glyph data directly.
- direction boundary
A point, between offsets in memory or glyphs in a display, at which the direction of stored or displayed text changes.
- discontinuous highlighting
Highlighting that exactly matches the selection range it corresponds to. It may consist of discontinuous areas when the selection range crosses direction boundaries. Compare contiguous highlighting.
- display order
The left-to-right order in which ATSUI displays glyphs. Display order determines the glyph index of each glyph in a line and may differ from the input order of the text. Compare input order.
- display text
The visual representation of the text of a text layout object. Display text consists of a sequence of glyphs, arranged in display order. Compare source text.
- drop capital
A large uppercase letter that drops below the main line of text for aesthetic reasons.
- dual caret
A type of caret that, at the boundary between text of opposite directions, divides into two parts: a high caret and a low caret, each measuring half the line’s height. The two separate half-carets merge into one in unidirectional text.
- edge offset
A byte offset into the source text associated with a text layout object that specifies a position between byte values. Edge offsets in source text are related to caret positions in display text. Compare byte offset.
- exclusive feature type
A feature for which you can choose only one of the available feature selectors, such as whether numbers are to be proportional or fixed-width. Compare nonexclusive feature type.
- feature selectors
A means of defining particular font features in a feature type. See also feature type.
- feature type
A group of font features in a style object that are applied to each style run based on font defaults. See also feature selectors.
- flushness
See alignment.
- font
A collection of glyphs that usually have some element of design consistency such as the shapes of the counters, the design of the stem, stroke thickness, or the use of serifs.
- font family
A group of fonts that share certain characteristics and a common family name.
- font features
The set of typographic and layout capabilities that create a specific appearance for the text associated with a text layout object.
- font ID
A value that identifies a font to the font management system. The font ID is assigned to a font at system startup; the specific value does not persist across system startups.
- font instance
A setting identified by the font’s designer that matches specific values along the available variation axes and gives those values a name.
- font name
A set of specific information in a font object about a font, such as its family name, style, copyright date, version, and manufacturer. Some font names are used to build menus in an application, whereas other names are used to identify the font uniquely.
- font variation
An algorithmic way to produce a range of typestyles along a particular variation axis.
- glyph
The distinct visual representation of a character in a form that a screen or printer can display. A glyph may represent one character (the lowercase a), more than one character (the fi ligature), part of a character (the dot over an i), or a nonprinting character (the space character). See also character.
- glyph code
A number that specifies a particular glyph in a font. Fonts map character codes to glyph codes, which in turn specify individual glyphs.
- glyph direction
The direction in which successive glyphs are read.
- glyph index
The order of a glyph in a line of display text. The leftmost glyph in a line of text has a glyph index of 0; each succeeding glyph to the right has an index one greater than the previous glyph. Compare edge offset.
- glyph orientation
A value that specifies which direction (vertical or horizontal) glyphs should be drawn.
- glyph origin
The point used to position a glyph when drawing.
- glyph outline
The curves that make up the shape of the glyph.
- hanging baseline
The baseline used by Devanagari and similar scripts, where most of the glyph is below the baseline.
- hanging glyphs
A set of glyphs, usually punctuation, that typically extend beyond the left and right margins of the text area and whose widths are not counted when line length is measured.
- Hangul
A Korean subscript that consists of blocks of component glyphs called Jamo that are characters different from typical character clusters in that they are treated as singular units in memory; there are no principal characters and attachments.
- highlighting
The display of text in inverse video or with a colored background. Highlighting in display text corresponds to a selection range in source text.
- hints
Information provided with a font that can be used to scale glyphs to various sizes.
- hit-testing
The process of converting a location within a line of display text into a caret offset in the source text of that line.
- hyphenation point
An entry in an array of edge offsets in the source text at which it is appropriate to break a line of display text.
- ideal metrics
Resolution-independent measurements used to describe how a glyph is drawn. Compare screen metrics.
- image bounding rectangle
The smallest rectangle that completely encloses the filled or framed parts of a block of text. See also typographic bounding rectangle.
- imposed width
A control feature that forces a specific width onto the glyphs of a style run, regardless of its text content or other style properties.
- index
See glyph index.
- input order
The order in which characters are written or entered from a keyboard. The input order of a line of text can differ from its display order. Compare display order.
- insertion point
The point in the source text at which text is to be inserted or deleted. An insertion point is specified by a single caret position. Compare caret position.
- Jamo
An individual phonetic glyph in the Korean script that is transformed and combined into clusters called Hangul.
- justification
The process of typographically expanding or compressing a line of text to fit a text width.
- justification gap
The difference in the length of a line before and after justification.
- justification override
The degree to which ATSUI should override justification behavior for glyphs in a style run.
- justification priority
The priority order in which classes of glyphs are processed during justification.
- kashida
An extension-bar glyph that is added to certain Arabic glyphs during justification.
- kerning
An adjustment to the normal spacing that occurs between two or more specifically named glyphs, known as the kerning pair.
- kerning pair
Two specifically named glyphs that are kerned together by a set amount. See also kerning.
- language
The written and spoken methods of combining words to create meaning used by a particular group of people.
- Last Resort font
A collection of glyphs that represent types of Unicode characters. These glyphs can be used as a backup to any other font; if the font cannot represent any particular Unicode character, the appropriate “missing” glyph from the Last Resort font can be used instead.
- layout cache
A cache that contains all the information ATSUI needs to draw a range of text associated with a text layout object. This includes caret positions, the memory locations of glyphs, and other information needed to lay out the glyphs.
- leading edge
The edge of a glyph that is encountered first when reading text of that glyph’s language. For glyphs of left-to-right text, the leading edge is the left edge; for glyphs of right-to-left text, the leading edge is the right edge.
- left-side bearing
The white space between the glyph origin and the visible beginning of the glyph.
- ligature
Two or more glyphs connected to form a single new glyph.
- ligature decomposition
The breaking up of a ligature into its component glyphs during justification so that the individual glyphs may more evenly occupy the space allotted to the ligature.
- ligature splitting
The division of a ligature for hit-testing purposes into regions corresponding to each of its component glyphs.
- line breaking
The process of determining the proper location at which to truncate a line of text so that it fits within a given text width.
- line and layout attributes
Attributes that specify how the lines of text associated with the text layout object are displayed and formatted. Line attributes control an individual line of text; layout attributes control all of the text associated with a text layout object.
- line direction
The overall direction in which a line of text is read. The line direction is the lowest nested level of dominant direction on a line.
- line length
The distance, in points, from the origin of the first glyph on a line through the advance width of the last glyph.
- margins
The left, right, top, and bottom sides of the text area.
- metamorphosis
The process by which glyphs are rearranged, substituted, deleted, and inserted based upon their properties and contextual states.
- native curve type
The curve type—cubic or quadratic—used by a font designer to specify a font.
- negative justification
A layout in which the glyphs on a line do not naturally fit within the line width set by the developer.
- noncontextual features
Features that are applied in the same manner to a glyph regardless of the adjacent glyphs. See also contextual features.
- nonexclusive feature type
A feature for which you can enable any number of feature selectors at once. Compare exclusive feature type.
- offsets
Monotonically increasing or decreasing values. In ATSUI, offsets are in
Unichars
units and are typically used to specify starting and ending points for a string of text. - optical alignment
The fine adjustment of glyph positions at the ends of lines to give a more even visual appearance to margins.
- point size
The size of a font’s glyphs as measured from the baseline of one line of text to the baseline of the next line of single-spaced text. In the United States, point size is measured in typographic points.
- postcompensation action
The extra processing, such as addition of kashidas and ligature decomposition, that occurs after glyphs have been repositioned during justification.
- quadratic curve
A curve specified by a quadratic equation.
- real position
The actual drawing position on the x-axis for the origin of each character or glyph in a line of text given in coordinates relative to the preceding character or glyph.
- relative position
A position for the origin of each character or glyph in a line of text given in coordinates relative to the preceding character or glyph. Compare absolute position.
- right-side bearing
The white space on the right side of the glyph; this value may or may not be equal to the value of the left-side bearing.
- Roman baseline
The baseline used in most Roman scripts and in Arabic and Hebrew.
- ruby text
Text usually used to provide annotations or indicate pronunciation for Asian languages. Ruby text is displayed using a smaller font size than the text it annotates.
- run
A sequence of glyphs that are contiguous in memory and share a set of common attributes.
- screen metrics
Resolution-dependent measurements used to describe how a glyph is drawn. Compare ideal metrics.
- script
A method for depicting words visually.
- selection range
The contiguous sequence of characters in the source text that mark where the next editing operation is to occur. The glyphs corresponding to those characters are commonly highlighted on screen.
- serif
The fine lines stemming from and at an angle to the upper and lower ends of the main strokes of a letter—for example, the little “feet” on the bottom of the vertical strokes in the uppercase letter “M” in Times Roman typeface.
- smart swash
A variation of an existing glyph (often ornamental) that is contextual. Compare swash.
- source text
A stored sequence of character codes that represents a line of text. Characters in source text are stored in input order. Compare display text.
- split caret
See dual caret.
- storage order
See input order, display order.
- style run
A sequence of glyphs (contiguous in memory backing store) that share the same style.
- surrogates
Values that allow additional characters to be mapped to the Unicode 16-bit character set.
- swash
A variation of an existing glyph (often ornamental) that is noncontextual. Compare smart swash.
- style attributes
A collection of values and settings that override the font-specified behavior for displaying and formatting text in a style run.
- style object
An opaque object that contains a collection of stylistic attributes. Style objects can be applied to runs within a text layout object.
- text
A set of specific symbols that, when displayed in a meaningful order, conveys information.
- text area
The space on the display device within which the text should fit.
- text direction
The direction in which reading proceeds. Roman text has a left-to-right direction; Hebrew and Arabic have a (predominantly) right-to-left direction; Chinese and Japanese can have a vertical direction.
- text face
An algorithmic way for your application to produce typestyles.
- text layout object
An opaque object that contains information to control the display and formatting of the text to which the object is associated.
- text run
A complete unit of text made up of character codes or glyph codes.
- text styles
The visual attributes, other than size, applied as a systematic variation to the plain (unstyled) characteristics of a font’s glyphs. Some typical text styles include plain, bold, italic, underline, outline, shadow, condensed, and extended.
- text width
The area between the margins; it is the length available for displaying a line of text.
- top-side bearing
The white space between the top of the glyph and the visible beginning of the glyph.
- tracking
Kerning between all glyphs in a line of text, not just the kerning pairs already defined by the font. You can increase or decrease interglyph spacing by adjusting the tracking setting. See tracking setting; compare kerning.
- tracking setting
A value that specifies the relative tightness or looseness of interglyph spacing.
- trailing edge
The edge of a glyph that is encountered last when reading text of that glyph’s language. For glyphs of left-to-right text, the trailing edge is the right edge; for glyphs of right-to-left text, the trailing edge is the left edge.
- triple
Three values that consist of an attribute tag, a value for that tag, and the size of the value. In ATSUI, triples are used to specify style, line, and layout attributes.
- typestyle
See text styles.
- typographic bounding rectangle
The smallest rectangle that encloses the full span of the glyphs from the ascent line to the descent line. See also image bounding rectangle.
- typographic point
A unit of measurement describing the size of glyphs in a font. There are 72.27 typographic points per inch, as opposed to 72 points per inch in the Mac OS.
- Unicode
A character encoding system designed to support the interchange, processing, and display of all the written texts of the diverse languages of the modern world.
- Unicode decomposition
Splitting a composite glyph into its component parts, such as a base character and a combining mark.
- variation axis
A range included in a font by the font designer that allows a font to produce different typestyles.
- with-stream shift
A uniform shift parallel to the baseline of the positions of individual pairs or sets of glyphs in the style run. Compare cross-stream shift.
Copyright © 2002, 2008 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2008-09-30