Functions


Assigning and Updating Style Runs

ATSUSetRunStyle Assigns or updates style runs.

Assigning and Updating Text

ATSUSetTextHandleLocation Assigns or updates text accessed with a handle.
ATSUSetTextPointerLocation Assigns or updates text accessed with a pointer.

Controlling Memory Allocation

ATSUCreateMemorySetting Creates a memory setting.
ATSUDisposeMemorySetting Disposes of a memory setting.
ATSUGetCurrentMemorySetting Returns the current memory allocation setting.
ATSUSetCurrentMemorySetting Makes a memory setting current.

Converting Font IDs and Font Family Numbers

ATSUFONDtoFontID Converts a font family number to an ATSUI font ID.
ATSUFontIDtoFOND Finds the font family number corresponding to an ATSUI font ID.

Copying Style Object Contents

ATSUCopyAttributes Copies the contents of a style object into an existing style object.
ATSUOverwriteAttributes Copies all previously set style run attributes, font features, and font variations in a source style object into a destination style object.
ATSUUnderwriteAttributes Copies style run attributes, font features, and font variations set in the source but not in the destination style object.

Creating and Disposing of Text Layout Objects

ATSUClearLayoutCache Clears the layout cache of a line or an entire text layout object.
ATSUCreateAndCopyTextLayout Creates a copy of a text layout object.
ATSUCreateTextLayout Creates an empty text layout object.
ATSUCreateTextLayoutWithTextHandle Creates a text layout object containing a handle to associated text and style runs.
ATSUCreateTextLayoutWithTextPtr Creates a text layout object containing a pointer to associated text and style runs.
ATSUDisposeTextLayout Disposes of the memory associated with a text layout object.
ATSUGetTextLayoutRefCon Obtains application-specific data for a text layout object.
ATSUSetTextLayoutRefCon Sets application-specific data for a text layout object.

Creating, Manipulating, and Disposing of Style Objects

ATSUClearStyle Removes all values other than the defaults from a style object.
ATSUCompareStyles Compares the contents of two style objects.
ATSUCreateAndCopyStyle Creates a copy of a style object.
ATSUCreateStyle Creates a style object.
ATSUDisposeStyle Disposes of the memory associated with a style object.
ATSUGetStyleRefCon Obtains application-specific data from a style object.
ATSUSetStyleRefCon Sets application-specific data for a style object.
ATSUStyleIsEmpty Indicates whether a style object contains only default values.

Determining Cursor Offsets

ATSULeftwardCursorPosition Obtains the edge offset corresponding to the left of the high caret position based on the type of cursor movement.
ATSUNextCursorPosition Obtains the edge offset corresponding to the next cursor position based on the type of cursor movement.
ATSUPreviousCursorPosition Obtains the edge offset corresponding to the previous cursor position based on the type of cursor movement.
ATSURightwardCursorPosition Obtains the edge offset corresponding to the right of the high caret position based on the type of cursor movement.

Drawing Text

ATSUDrawText Draws a range of text at a specified screen location.

Finding Compatible Fonts

ATSUFindFontFromName Finds the first font in a name table that matches given font name parameters.
ATSUFontCount Determines the number of fonts installed on a user’s system.
ATSUGetFontIDs Obtains a list of all the compatible fonts installed on the user’s system.

Flattening and Unflattening Style Objects

ATSUCopyToHandle Copies styled Unicode text data from a style object to a handle.
ATSUPasteFromHandle Pastes styled Unicode text data from a handle into a style object.

Handling Text Insertion and Deletion

ATSUTextDeleted Indicates the location in physical memory of deleted text.
ATSUTextInserted Indicates the location in physical memory of inserted text.

Highlighting and Unhighlighting Text

ATSUGetTextHighlight Obtains the highlight region for a range of text.
ATSUHighlightText Highlights a range of text.
ATSUUnhighlightText Removes highlighting from a range of text.

Hit-Testing

ATSUOffsetToPosition Determines the caret position(s) that correspond to an edge offset.
ATSUPositionToOffset Obtains the edge offset(s) that correspond to the glyph nearest a mouse-down event.

Manipulating Font Features

ATSUClearFontFeatures Removes font features from a style object.
ATSUGetAllFontFeatures Obtains font feature information from a style object.
ATSUGetFontFeature Obtains the font feature type and selector for an indexed font feature.
ATSUSetFontFeatures Sets font features in a style object.

Manipulating Font Variations

ATSUClearFontVariations Removes font variations from a style object.
ATSUGetAllFontVariations Obtains font variation information from a style object.
ATSUGetFontVariationValue Obtains the value corresonding a particular font variation axis.
ATSUSetVariations Sets font variations in a style object.

Manipulating Line Breaks

ATSUBreakLine Suggests and optionally sets a soft line break in a range of text.
ATSUClearSoftLineBreaks Removes soft line breaks from a range of text.
ATSUGetSoftLineBreaks Obtains all soft line breaks in a range of text.
ATSUSetSoftLineBreak Sets a soft line break.

Manipulating Style Run Attributes

ATSUCalculateBaselineDeltas Calculates the optimal baseline positions for glyphs in a line of text.
ATSUClearAttributes Removes style run attributes from a style object.
ATSUGetAllAttributes Obtains attribute information from a style object.
ATSUGetAttribute Obtains a style run attribute value from a style object.
ATSUSetAttributes Sets style run attribute values in a style object.

Manipulating Text Layout Attributes in a Line

ATSUClearLineControls Removes text layout attribute values from a line of text.
ATSUCopyLineControls Copies text layout attributes from a line of a text layout object.
ATSUGetAllLineControls Obtains text layout attribute information for a line of text.
ATSUGetLineControl Obtains a text layout attribute value from a line of text.
ATSUSetLineControls Sets text layout attributes for a line of text in a text layout object.

Manipulating Text Layout Attributes

ATSUClearLayoutControls Removes text layout attributes from a text layout object.
ATSUCopyLayoutControls Copies the text layout attributes from a text layout object into an existing one.
ATSUGetAllLayoutControls Obtains attribute information from a text layout object.
ATSUGetLayoutControl Obtains a text layout attribute value from a text layout object.
ATSUSetLayoutControls Sets text layout attributes in a text layout object.

Mapping Font Fallbacks

ATSUGetFontFallbacks Indicates the previously specified font list and search order to use when a font does not have all the glyphs for the characters it is trying to draw.
ATSUGetTransientFontMatching Indicates whether ATSUI will automatically perform font substitution when a character cannot be drawn with the assigned font.
ATSUMatchFontsToText Suggests a substitute font when a font does not have all the glyphs for the characters it is trying to draw.
ATSUSetFontFallbacks Enables you to indicate the font list and search order to use when a font does not have all the glyphs for the characters it is trying to draw.
ATSUSetTransientFontMatching Performs automatic font substitution when a character cannot be drawn with the assigned font.

Measuring Typographic and Image Bounds

ATSUGetGlyphBounds Obtains the typographic glyph bounds of a final laid-out line.
ATSUMeasureText Obtains the typographic bounding rectangle of a line of text prior to final line layout.
ATSUMeasureTextImage Obtains the standard bounding rectangle of a final laid-out line.

Obtaining Font Feature Information

ATSUCountFontFeatureSelectors Determines the number of feature selectors defined for a given feature type in a font.
ATSUCountFontFeatureTypes Determines the number of feature types defined in a font.
ATSUGetFontFeatureNameCode Obtains the name code of a feature selector or type.
ATSUGetFontFeatureSelectors Obtains a list of the available feature selectors for a given feature type in a font.
ATSUGetFontFeatureTypes Obtains a list of the available feature types in a font.

Obtaining Font Instance Data

ATSUCountFontInstances Counts the number of font instances in a font.
ATSUGetFontInstance Obtains information about a font instance.
ATSUGetFontInstanceNameCode Obtains the name code of a font instance.

Obtaining Font Tracking Information

ATSUCountFontTracking Counts the number of font trackings in a font.
ATSUGetIndFontTracking Determines the name code and value of an indexed font tracking.

Obtaining Font Variation Data

ATSUCountFontVariations Determines the number of font variations defined in a font.
ATSUGetFontVariationNameCode Obtains the name code of a font variation.
ATSUGetIndFontVariation Obtains information about a font variation.

Obtaining Style Run Information

ATSUGetContinuousAttributes Finds the style run information that is continuous over a range of text.
ATSUGetRunStyle Finds the previously set style run information for a given text location and the range of text that shares this information.

Obtaining and Updating Text Memory Location

ATSUGetTextLocation Determines the location of text in physical memory, the length of the range of text and text buffer, and whether the text is accessed by a pointer or handle.
ATSUTextMoved Updates the location of text in physical memory.

Performing Background Processing

ATSUIdle Enables ATSUI to perform background processing.

Searching a Font Name Table

ATSUCountFontNames Determines the number of font names in a font name table.
ATSUFindFontName Finds the index and font name of the first font in a name table matching given font name parameters.
ATSUGetIndFontName Finds the font name string and other font name parameters for an indexed font name.

Miscellaneous

ATSApplyBaselines
ATSApplyDevicePositioning
ATSApplyJustification
ATSApplyKerning
ATSApplyMorph
ATSApplyPositions
ATSApplyTracking
ATSCalculateBiDiLevels
ATSClearGlyphVector
ATSDrawGlyphs
ATSGetCubicGlyphPaths
ATSGetGlyphFractionalMetrics
ATSGetGlyphRenderingMetrics
ATSGetNativeCurveType
ATSGetQuadraticGlyphPaths
ATSGetStyleTransform
ATSGrowGlyphVector
ATSInitializeGlyphVector
ATSLayoutText
ATSSetStyleTransform
ATSUConvertCharToGlyphs
ATSUDisposeStyleGroup
ATSUDrawGlyphInfo
ATSUGetCubicGlyphPaths
ATSUGetFontTable
ATSUGetGlyphFractionalMetrics
ATSUGetGlyphInfo
ATSUGetGlyphRenderingMetrics
ATSUGetNativeCurveType
ATSUGetQuadraticGlyphPaths
ATSUGetQuadraticQuadPaths
ATSUGetStyleGroup
ATSUGetStyleIndex
ATSUGlyphGetCubicPaths
ATSUGlyphGetCurvePaths
ATSUGlyphGetIdealMetrics
ATSUGlyphGetQuadraticPaths
ATSUGlyphGetScreenMetrics
ATSUInvalidateTextLayoutCache
ATSULoadGlyphVector
ATSUReleaseFontTable
ATSUSetHighlightingMethod
DisposeATSCubicClosePathUPP
DisposeATSCubicCurveToUPP
DisposeATSCubicLineToUPP
DisposeATSCubicMoveToUPP
DisposeATSQuadraticClosePathUPP
DisposeATSQuadraticCurveUPP
DisposeATSQuadraticLineUPP
DisposeATSQuadraticNewPathUPP
DisposeCubicClosePathUPP
DisposeCubicCurveToUPP
DisposeCubicLineToUPP
DisposeCubicMoveToUPP
DisposeQuadraticClosePathUPP
DisposeQuadraticCurveUPP
DisposeQuadraticLineUPP
DisposeQuadraticNewPathUPP
DisposeRedrawBackgroundUPP
InvokeATSCubicClosePathUPP
InvokeATSCubicCurveToUPP
InvokeATSCubicLineToUPP
InvokeATSCubicMoveToUPP
InvokeATSQuadraticClosePathUPP
InvokeATSQuadraticCurveUPP
InvokeATSQuadraticLineUPP
InvokeATSQuadraticNewPathUPP
InvokeCubicClosePathUPP
InvokeCubicCurveToUPP
InvokeCubicLineToUPP
InvokeCubicMoveToUPP
InvokeQuadraticClosePathUPP
InvokeQuadraticCurveUPP
InvokeQuadraticLineUPP
InvokeQuadraticNewPathUPP
InvokeRedrawBackgroundUPP
NewATSCubicClosePathUPP
NewATSCubicCurveToUPP
NewATSCubicLineToUPP
NewATSCubicMoveToUPP
NewATSQuadraticClosePathUPP
NewATSQuadraticCurveUPP
NewATSQuadraticLineUPP
NewATSQuadraticNewPathUPP
NewCubicClosePathUPP
NewCubicCurveToUPP
NewCubicLineToUPP
NewCubicMoveToUPP
NewQuadraticClosePathUPP
NewQuadraticCurveUPP
NewQuadraticLineUPP
NewQuadraticNewPathUPP
NewRedrawBackgroundUPP

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)