Mac OS X Reference Library Data Management: Strings, Text, & Fonts CGFont ReferenceA function identified as deprecated has been superseded and may become unsupported in the future.
Creates a font object from an Apple Type Services (ATS) font. (Deprecated in Mac OS X v10.6. Use Core Text, documented in Core Text Reference Collection, instead.)
CGFontRef CGFontCreateWithPlatformFont ( void *platformFontReference );
A generic pointer to a font object. The font should be of a type appropriate to the platform on which your program is running. For Mac OS X, you should pass a pointer to an ATS font.
The font object, or NULL if the platform font could not be located. You are responsible for releasing this object using CGFontRelease.
Before drawing text in a Quartz context, you must set the font in the current graphics state. For ATS Fonts, call this function to create a Quartz font, and pass it to CGContextSetFont.
This function is deprecated because it takes a pointer to an ATSFontRef object—itself deprecated—and is used almost solely by QuickDraw-based applications. There's no direct one-to-one replacement for the function; however, Apple recommends that clients using ATSUI and QuickDraw move to Core Text and Core Graphics instead.
CGFont.h© 2003, 2009 Apple Inc. All Rights Reserved. (Last updated: 2009-07-23)
