1 /* vim: set expandtab tabstop=4 softtabstop=4 shiftwidth=4: */
4 * Line breaking in a Unicode sequence. Designed to be used in a
5 * generic text renderer.
7 * Copyright (C) 2008-2012 Wu Yongwei <wuyongwei at gmail dot com>
9 * This software is provided 'as-is', without any express or implied
10 * warranty. In no event will the author be held liable for any damages
11 * arising from the use of this software.
13 * Permission is granted to anyone to use this software for any purpose,
14 * including commercial applications, and to alter it and redistribute
15 * it freely, subject to the following restrictions:
17 * 1. The origin of this software must not be misrepresented; you must
18 * not claim that you wrote the original software. If you use this
19 * software in a product, an acknowledgement in the product
20 * documentation would be appreciated but is not required.
21 * 2. Altered source versions must be plainly marked as such, and must
22 * not be misrepresented as being the original software.
23 * 3. This notice may not be removed or altered from any source
26 * The main reference is Unicode Standard Annex 14 (UAX #14):
27 * <URL:http://www.unicode.org/reports/tr14/>
29 * When this library was designed, this annex was at Revision 19, for
31 * <URL:http://www.unicode.org/reports/tr14/tr14-19.html>
33 * This library has been updated according to Revision 30, for
35 * <URL:http://www.unicode.org/reports/tr14/tr14-30.html>
37 * The Unicode Terms of Use are available at
38 * <URL:http://www.unicode.org/copyright.html>
44 * Header file for the line breaking algorithm.
46 * @version 2.2, 2012/10/06
59 #define LINEBREAK_VERSION 0x0202 /**< Version of the library linebreak */
60 extern const int linebreak_version;
62 #ifndef LINEBREAK_UTF_TYPES_DEFINED
63 #define LINEBREAK_UTF_TYPES_DEFINED
64 typedef unsigned char utf8_t; /**< Type for UTF-8 data points */
65 typedef unsigned short utf16_t; /**< Type for UTF-16 data points */
66 typedef unsigned int utf32_t; /**< Type for UTF-32 data points */
69 #define LINEBREAK_MUSTBREAK 0 /**< Break is mandatory */
70 #define LINEBREAK_ALLOWBREAK 1 /**< Break is allowed */
71 #define LINEBREAK_NOBREAK 2 /**< No break is possible */
72 #define LINEBREAK_INSIDEACHAR 3 /**< A UTF-8/16 sequence is unfinished */
74 void init_linebreak(void);
75 void set_linebreaks_utf8(
76 const utf8_t *s, size_t len, const char* lang, char *brks);
77 void set_linebreaks_utf16(
78 const utf16_t *s, size_t len, const char* lang, char *brks);
79 void set_linebreaks_utf32(
80 const utf32_t *s, size_t len, const char* lang, char *brks);
81 int is_line_breakable(utf32_t char1, utf32_t char2, const char* lang);
87 #endif /* LINEBREAK_H */