WebSVN – Kolibri OS – Blame – /contrib/sdk/sources/freetype/src/cff/cf2blues.h

Rev	Author	Line No.	Line
4349	Serge	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 */

Subversion Repositories Kolibri OS

(root)/contrib/sdk/sources/freetype/src/cff/cf2blues.h – Rev 4349