Subversion Repositories Kolibri OS

Rev

Blame | Last modification | View Log | RSS feed

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