Carbon


ATSUSetVariations

Header: ATSUnicode.h Carbon status: Supported

Sets font variations in a style object.

OSStatus ATSUSetVariations (
    ATSUStyle iStyle, 
    ItemCount iVariationCount, 
    ATSUFontVariationAxis iAxes[], 
    ATSUFontVariationValue iValue[]
);
Parameter descriptions
iStyle

A reference to a valid style object whose font variations you want to set. You cannot pass NULL for this parameter.

iVariationCount

The number of font variations you want to set. This value should correspond to the number of elements in the iAxes and iValue arrays.

iAxes

An array of font variation axes. Each element in the array must represent a valid variation axis. You cannot pass NULL for this parameter.

iValue

An array of font variation axes values. Each element in the array must contain a value that is valid for the corresponding variation axis in the iAxes parameter. You cannot pass NULL for this parameter.

function result

A result code.

DISCUSSION

The ATSUSetVariations function sets multipele font variation values. Unset font variations retain their font-defined default values. If the font does not support the specified variation axis, the variations will have no visual effect.

ATSUSetVariations may allocate memory in your application heap, unless you designate a different heap by calling the function ATSUCreateMemorySetting.

VERSION NOTES

Available beginning with ATSUI 1.0.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.


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