![]() |
FNSReferenceFlatten |
||||
Header: | FontSync.h | Carbon status: | Supported | |
Flattens a font reference.
OSStatus FNSReferenceFlatten ( FNSFontReference iReference, void *oFlatReference, ByteCount *oFlattenedSize );
The font reference that you want to flatten.
A pointer to the storage for the font reference to be flattened. Pass a NULL pointer if you wish to determine the size of the flattened reference without actually creating it.
On return, a pointer to the flattened size (in bytes) of the font reference.
A result code. The result code kFNSBadReferenceVersionErr indicates that a font reference has an unsupported format version. This may indicate that the reference is valid, but created by a later version of FontSync, or that the reference is truly invalid. The result code kFNSInvalidReferenceErr indicates that a font reference is invalid.
The FNSReferenceFlatten function flattens a font reference into a form which can be stored externally (for example, in a document or embedded in an Apple event), and returns the size of the flattened reference in the oFlattenedSize parameter. FNSReferenceFlatten assumes that the storage pointed to by iFlatReference is large enough to hold the data and will always contain a full flattened reference.
If you simply want to calculate the size of a flattened reference, you can pass a NULL pointer in the iFlatReference parameter or call the function FNSReferenceFlattenedSize.
Available beginning with FontSync 1.0.
Supported in Carbon. Available in Carbon 1.0.2 and later when Font Sync 1.0 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)