NAME
WeighTAMatch -- Get a measure of how well two fonts match. (V36)
SYNOPSIS
weight = WeighTAMatch(reqTextAttr, targetTextAttr, targetTags)
D0 A0 A1 A2
WORD WeighTAMatch(struct TTextAttr *, struct TextAttr *,
struct TagItem *);Links: TTextAttr TextAttr TagItem
FUNCTION
This function provides a metric to describe how well two fonts match. This metric ranges from MAXFONTMATCHWEIGHT (perfect match) through lower positive numbers to zero (unsuitable match).
INPUTS
reqTextAttr - the text attributes requested. targetTextAttr - the text attributes of a potential match. targetTags - tags describing the extended target attributes, or zero if not available.
The [t]ta_Name fields of the [T]TextAttr structures are not used.
The tags affect the weight only when both a) the reqTextAttr has the FSF_TAGGED bit set in ta_Style, and b) targetTags is not zero. To fairly compare two different weights, the inclusion or exclusion of tags in the weighing must be the same for both.
RESULTS
weight -- a positive weight describes suitable matches, in increasing desirability. MAXFONTMATCHWEIGHT is a perfect match. A zero weight is an unsuitable match.
SEE ALSO