1a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/***************************************************************************/ 2a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* */ 3a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* cf2blues.h */ 4a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* */ 5a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* Adobe's code for handling Blue Zones (specification). */ 6a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* */ 7a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* Copyright 2009-2013 Adobe Systems Incorporated. */ 8a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* */ 9a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* This software, and all works of authorship, whether in source or */ 10a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* object code form as indicated by the copyright notice(s) included */ 11a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* herein (collectively, the "Work") is made available, and may only be */ 12a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* used, modified, and distributed under the FreeType Project License, */ 13a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* LICENSE.TXT. Additionally, subject to the terms and conditions of the */ 14a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* FreeType Project License, each contributor to the Work hereby grants */ 15a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* to any individual or legal entity exercising permissions granted by */ 16a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* the FreeType Project License and this section (hereafter, "You" or */ 17a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* "Your") a perpetual, worldwide, non-exclusive, no-charge, */ 18a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* royalty-free, irrevocable (except as stated in this section) patent */ 19a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* license to make, have made, use, offer to sell, sell, import, and */ 20a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* otherwise transfer the Work, where such license applies only to those */ 21a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* patent claims licensable by such contributor that are necessarily */ 22a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* infringed by their contribution(s) alone or by combination of their */ 23a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* contribution(s) with the Work to which such contribution(s) was */ 24a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* submitted. If You institute patent litigation against any entity */ 25a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* (including a cross-claim or counterclaim in a lawsuit) alleging that */ 26a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* the Work or a contribution incorporated within the Work constitutes */ 27a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* direct or contributory patent infringement, then any patent licenses */ 28a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* granted to You under this License for that Work shall terminate as of */ 29a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* the date such litigation is filed. */ 30a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* */ 31a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* By using, modifying, or distributing the Work you indicate that you */ 32a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* have read and understood the terms and conditions of the */ 33a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* FreeType Project License as well as those provided in this section, */ 34a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* and you accept them fully. */ 35a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* */ 36a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/***************************************************************************/ 37a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 38a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 39a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* 40a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * A `CF2_Blues' object stores the blue zones (horizontal alignment 41a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * zones) of a font. These are specified in the CFF private dictionary 42a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * by `BlueValues', `OtherBlues', `FamilyBlues', and `FamilyOtherBlues'. 43a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Each zone is defined by a top and bottom edge in character space. 44a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Further, each zone is either a top zone or a bottom zone, as recorded 45a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * by `bottomZone'. 46a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * 47a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * The maximum number of `BlueValues' and `FamilyBlues' is 7 each. 48a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * However, these are combined to produce a total of 7 zones. 49a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Similarly, the maximum number of `OtherBlues' and `FamilyOtherBlues' 50a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * is 5 and these are combined to produce an additional 5 zones. 51a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * 52a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Blue zones are used to `capture' hints and force them to a common 53a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * alignment point. This alignment is recorded in device space in 54a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * `dsFlatEdge'. Except for this value, a `CF2_Blues' object could be 55a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * constructed independently of scaling. Construction may occur once 56a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * the matrix is known. Other features implemented in the Capture 57a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * method are overshoot suppression, overshoot enforcement, and Blue 58a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Boost. 59a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * 60a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Capture is determined by `BlueValues' and `OtherBlues', but the 61a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * alignment point may be adjusted to the scaled flat edge of 62a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * `FamilyBlues' or `FamilyOtherBlues'. No alignment is done to the 63a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * curved edge of a zone. 64a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * 65a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang */ 66a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 67a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 68a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#ifndef __CF2BLUES_H__ 69a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#define __CF2BLUES_H__ 70a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 71a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 72a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#include "cf2glue.h" 73a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 74a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 75a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu WangFT_BEGIN_HEADER 76a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 77a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 78a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* 79a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * `CF2_Hint' is shared by `cf2hints.h' and 80a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * `cf2blues.h', but `cf2blues.h' depends on 81a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * `cf2hints.h', so define it here. Note: The typedef is in 82a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * `cf2glue.h'. 83a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * 84a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang */ 85a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang enum 86a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang { 87a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_GhostBottom = 0x1, /* a single bottom edge */ 88a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_GhostTop = 0x2, /* a single top edge */ 89a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_PairBottom = 0x4, /* the bottom edge of a stem hint */ 90a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_PairTop = 0x8, /* the top edge of a stem hint */ 91a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Locked = 0x10, /* this edge has been aligned */ 92a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* by a blue zone */ 93a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Synthetic = 0x20 /* this edge was synthesized */ 94a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang }; 95a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 96a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 97a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* 98a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Default value for OS/2 typoAscender/Descender when their difference 99a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * is not equal to `unitsPerEm'. The default is based on -250 and 1100 100a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * in `CF2_Blues', assuming 1000 units per em here. 101a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * 102a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang */ 103a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang enum 104a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang { 105a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_ICF_Top = cf2_intToFixed( 880 ), 106a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_ICF_Bottom = cf2_intToFixed( -120 ) 107a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang }; 108a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 109a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 110a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* 111a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * Constant used for hint adjustment and for synthetic em box hint 112a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang * placement. 113a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang */ 114a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#define CF2_MIN_COUNTER cf2_floatToFixed( 0.5 ) 115a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 116a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 117a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* shared typedef is in cf2glue.h */ 118a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang struct CF2_HintRec_ 119a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang { 120a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_UInt flags; /* attributes of the edge */ 121a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang size_t index; /* index in original stem hint array */ 122a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* (if not synthetic) */ 123a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed csCoord; 124a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed dsCoord; 125a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed scale; 126a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang }; 127a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 128a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 129a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang typedef struct CF2_BlueRec_ 130a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang { 131a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed csBottomEdge; 132a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed csTopEdge; 133a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed csFlatEdge; /* may be from either local or Family zones */ 134a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed dsFlatEdge; /* top edge of bottom zone or bottom edge */ 135a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* of top zone (rounded) */ 136a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang FT_Bool bottomZone; 137a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 138a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang } CF2_BlueRec; 139a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 140a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 141a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang /* max total blue zones is 12 */ 142a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang enum 143a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang { 144a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_MAX_BLUES = 7, 145a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_MAX_OTHERBLUES = 5 146a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang }; 147a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 148a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 149a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang typedef struct CF2_BluesRec_ 150a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang { 151a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed scale; 152a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_UInt count; 153a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang FT_Bool suppressOvershoot; 154a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang FT_Bool doEmBoxHints; 155a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 156a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed blueScale; 157a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed blueShift; 158a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed blueFuzz; 159a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 160a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Fixed boost; 161a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 162a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_HintRec emBoxTopEdge; 163a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_HintRec emBoxBottomEdge; 164a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 165a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_BlueRec zone[CF2_MAX_BLUES + CF2_MAX_OTHERBLUES]; 166a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 167a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang } CF2_BluesRec, *CF2_Blues; 168a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 169a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 170a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang FT_LOCAL( void ) 171a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang cf2_blues_init( CF2_Blues blues, 172a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Font font ); 173a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang FT_LOCAL( FT_Bool ) 174a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang cf2_blues_capture( const CF2_Blues blues, 175a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Hint bottomHintEdge, 176a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang CF2_Hint topHintEdge ); 177a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 178a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 179a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu WangFT_END_HEADER 180a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 181a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 182a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#endif /* __CF2BLUES_H__ */ 183a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 184a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang 185a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* END */ 186