user32/tests: Add the trailing '\n' to an ok() call.
[wine] / include / usp10.h
1 /*
2  * Copyright (C) 2005 Steven Edwards
3  * Copyright (C) 2005 Vijay Kiran Kamuju
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2.1 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public
16  * License along with this library; if not, write to the Free Software
17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
18  */
19
20 #ifndef __USP10_H
21 #define __USP10_H
22
23 #ifndef __WINESRC__
24 # include <windows.h>
25 #endif
26 /* FIXME: #include <specstrings.h> */
27
28 #ifdef __cplusplus
29 extern "C" {
30 #endif
31
32 /** ScriptStringAnalyse */
33 #define  SSA_PASSWORD         0x00000001
34 #define  SSA_TAB              0x00000002
35 #define  SSA_CLIP             0x00000004
36 #define  SSA_FIT              0x00000008
37 #define  SSA_DZWG             0x00000010
38 #define  SSA_FALLBACK         0x00000020
39 #define  SSA_BREAK            0x00000040
40 #define  SSA_GLYPHS           0x00000080
41 #define  SSA_RTL              0x00000100
42 #define  SSA_GCP              0x00000200
43 #define  SSA_HOTKEY           0x00000400
44 #define  SSA_METAFILE         0x00000800
45 #define  SSA_LINK             0x00001000
46 #define  SSA_HIDEHOTKEY       0x00002000
47 #define  SSA_HOTKEYONLY       0x00002400
48 #define  SSA_FULLMEASURE      0x04000000
49 #define  SSA_LPKANSIFALLBACK  0x08000000
50 #define  SSA_PIDX             0x10000000
51 #define  SSA_LAYOUTRTL        0x20000000
52 #define  SSA_DONTGLYPH        0x40000000 
53 #define  SSA_NOKASHIDA        0x80000000 
54
55 /** StringIsComplex */
56 #define  SIC_COMPLEX     1
57 #define  SIC_ASCIIDIGIT  2
58 #define  SIC_NEUTRAL     4
59
60 /** ScriptGetCMap */
61 #define SGCM_RTL  0x00000001
62
63 /** ScriptApplyDigitSubstitution */
64 #define SCRIPT_DIGITSUBSTITUTE_CONTEXT      0
65 #define SCRIPT_DIGITSUBSTITUTE_NONE         1
66 #define SCRIPT_DIGITSUBSTITUTE_NATIONAL     2
67 #define SCRIPT_DIGITSUBSTITUTE_TRADITIONAL  3
68
69 #define SCRIPT_UNDEFINED  0
70
71 #define USP_E_SCRIPT_NOT_IN_FONT MAKE_HRESULT(SEVERITY_ERROR,FACILITY_ITF,0x200)
72
73 typedef enum tag_SCRIPT_JUSTIFY {
74   SCRIPT_JUSTIFY_NONE           = 0,
75   SCRIPT_JUSTIFY_ARABIC_BLANK   = 1,
76   SCRIPT_JUSTIFY_CHARACTER      = 2,
77   SCRIPT_JUSTIFY_RESERVED1      = 3,
78   SCRIPT_JUSTIFY_BLANK          = 4,
79   SCRIPT_JUSTIFY_RESERVED2      = 5,
80   SCRIPT_JUSTIFY_RESERVED3      = 6,
81   SCRIPT_JUSTIFY_ARABIC_NORMAL  = 7,
82   SCRIPT_JUSTIFY_ARABIC_KASHIDA = 8,
83   SCRIPT_JUSTIFY_ARABIC_ALEF    = 9,
84   SCRIPT_JUSTIFY_ARABIC_HA      = 10,
85   SCRIPT_JUSTIFY_ARABIC_RA      = 11,
86   SCRIPT_JUSTIFY_ARABIC_BA      = 12,
87   SCRIPT_JUSTIFY_ARABIC_BARA    = 13,
88   SCRIPT_JUSTIFY_ARABIC_SEEN    = 14,
89   SCRIPT_JUSTIFY_RESERVED4      = 15,
90 } SCRIPT_JUSTIFY;
91
92 typedef struct tag_SCRIPT_CONTROL {
93   DWORD uDefaultLanguage        :16;
94   DWORD fContextDigits          :1;
95   DWORD fInvertPreBoundDir      :1;
96   DWORD fInvertPostBoundDir     :1;
97   DWORD fLinkStringBefore       :1;
98   DWORD fLinkStringAfter        :1;
99   DWORD fNeutralOverride        :1;
100   DWORD fNumericOverride        :1;
101   DWORD fLegacyBidiClass        :1;
102   DWORD fReserved               :8;
103 } SCRIPT_CONTROL;
104
105 typedef struct {
106   DWORD langid                  :16;
107   DWORD fNumeric                :1;
108   DWORD fComplex                :1;     
109   DWORD fNeedsWordBreaking      :1;     
110   DWORD fNeedsCaretInfo         :1;
111   DWORD bCharSet                :8;
112   DWORD fControl                :1;
113   DWORD fPrivateUseArea         :1;
114   DWORD fNeedsCharacterJustify  :1;
115   DWORD fInvalidGlyph           :1;
116   DWORD fInvalidLogAttr         :1;
117   DWORD fCDM                    :1;
118   DWORD fAmbiguousCharSet       :1;
119   DWORD fClusterSizeVaries      :1;
120   DWORD fRejectInvalid          :1;
121 } SCRIPT_PROPERTIES;
122
123 typedef struct tag_SCRIPT_STATE {
124   WORD uBidiLevel               :5;
125   WORD fOverrideDirection       :1;
126   WORD fInhibitSymSwap          :1;
127   WORD fCharShape               :1;
128   WORD fDigitSubstitute         :1;
129   WORD fInhibitLigate           :1;
130   WORD fDisplayZWG              :1;
131   WORD fArabicNumContext        :1;
132   WORD fGcpClusters             :1;
133   WORD fReserved                :1;
134   WORD fEngineReserved          :2;
135 } SCRIPT_STATE;
136
137 typedef struct tag_SCRIPT_ANALYSIS {
138   WORD eScript                  :10;
139   WORD fRTL                     :1;
140   WORD fLayoutRTL               :1;
141   WORD fLinkBefore              :1;
142   WORD fLinkAfter               :1;
143   WORD fLogicalOrder            :1;
144   WORD fNoGlyphIndex            :1;
145   SCRIPT_STATE  s;
146 } SCRIPT_ANALYSIS;
147
148 typedef struct tag_SCRIPT_ITEM {
149   int iCharPos;
150   SCRIPT_ANALYSIS a;
151 } SCRIPT_ITEM;
152
153 typedef struct tag_SCRIPT_DIGITSUBSTITUTE {
154   DWORD NationalDigitLanguage           :16;
155   DWORD TraditionalDigitLanguage        :16;
156   DWORD DigitSubstitute                 :8;
157   DWORD dwReserved;
158 } SCRIPT_DIGITSUBSTITUTE;
159
160 typedef struct tag_SCRIPT_FONTPROPERTIES {
161   int   cBytes;
162   WORD wgBlank;
163   WORD wgDefault;
164   WORD wgInvalid;
165   WORD wgKashida;
166   int iKashidaWidth;
167 } SCRIPT_FONTPROPERTIES;
168
169 typedef struct tag_SCRIPT_TABDEF {
170   int cTabStops;
171   int iScale;
172   int *pTabStops;
173   int iTabOrigin;
174 } SCRIPT_TABDEF;
175
176 typedef struct tag_SCRIPT_VISATTR {
177   WORD uJustification   :4;
178   WORD fClusterStart    :1;
179   WORD fDiacritic       :1;
180   WORD fZeroWidth       :1;
181   WORD fReserved        :1;
182   WORD fShapeReserved   :8;
183 } SCRIPT_VISATTR;
184
185 typedef struct tag_SCRIPT_LOGATTR {
186   BYTE    fSoftBreak      :1;
187   BYTE    fWhiteSpace     :1;
188   BYTE    fCharStop       :1;
189   BYTE    fWordStop       :1;
190   BYTE    fInvalid        :1;
191   BYTE    fReserved       :3;
192 } SCRIPT_LOGATTR;
193
194 typedef void *SCRIPT_CACHE;
195 typedef void *SCRIPT_STRING_ANALYSIS; 
196
197 #ifndef LSDEFS_DEFINED
198 typedef struct tagGOFFSET {
199   LONG  du;
200   LONG  dv;
201 } GOFFSET;
202 #endif
203
204 /* Function Declarations */
205
206 HRESULT WINAPI ScriptApplyDigitSubstitution(const SCRIPT_DIGITSUBSTITUTE* psds, 
207                                             SCRIPT_CONTROL* psc, SCRIPT_STATE* pss);
208 HRESULT WINAPI ScriptApplyLogicalWidth(const int *piDx, int cChars, int cGlyphs, const WORD *pwLogClust,
209                                        const SCRIPT_VISATTR *psva, const int *piAdvance,
210                                        const SCRIPT_ANALYSIS *psa, ABC *pABC, int *piJustify);
211 HRESULT WINAPI ScriptRecordDigitSubstitution(LCID Locale, SCRIPT_DIGITSUBSTITUTE *psds);
212 HRESULT WINAPI ScriptItemize(const WCHAR *pwcInChars, int cInChars, int cMaxItems, 
213                              const SCRIPT_CONTROL *psControl, const SCRIPT_STATE *psState, 
214                              SCRIPT_ITEM *pItems, int *pcItems);
215 HRESULT WINAPI ScriptGetCMap(HDC hdc, SCRIPT_CACHE *psc, const WCHAR *pwcInChars, int cChars,
216                              DWORD dwFlags, WORD *pwOutGlyphs);
217 HRESULT WINAPI ScriptGetFontProperties(HDC hdc, SCRIPT_CACHE *psc, SCRIPT_FONTPROPERTIES *sfp);
218 HRESULT WINAPI ScriptGetGlyphABCWidth(HDC hdc, SCRIPT_CACHE *psc, WORD wGlyph, ABC *pABC);
219 HRESULT WINAPI ScriptGetLogicalWidths(const SCRIPT_ANALYSIS *psa, int cChars, int cGlyphs,
220                                       const int *piGlyphWidth, const WORD *pwLogClust,
221                                       const SCRIPT_VISATTR *psva, int *piDx);
222 HRESULT WINAPI ScriptGetProperties(const SCRIPT_PROPERTIES ***ppSp, int *piNumScripts);
223 HRESULT WINAPI ScriptStringAnalyse(HDC hdc, 
224                                    const void *pString, 
225                                    int cString, 
226                                    int cGlyphs,
227                                    int iCharset,
228                                    DWORD dwFlags,
229                                    int iReqWidth,
230                                    SCRIPT_CONTROL *psControl,
231                                    SCRIPT_STATE *psState,
232                                    const int *piDx,
233                                    SCRIPT_TABDEF *pTabdef,
234                                    const BYTE *pbInClass,
235                                    SCRIPT_STRING_ANALYSIS *pssa);
236 HRESULT WINAPI ScriptStringValidate(SCRIPT_STRING_ANALYSIS ssa);
237 HRESULT WINAPI ScriptStringFree(SCRIPT_STRING_ANALYSIS *pssa);
238 HRESULT WINAPI ScriptFreeCache(SCRIPT_CACHE *psc);
239 HRESULT WINAPI ScriptIsComplex(const WCHAR* pwcInChars, int cInChars, DWORD dwFlags);
240 HRESULT WINAPI ScriptJustify(const SCRIPT_VISATTR *psva, const int *piAdvance, int cGlyphs,
241                              int iDx, int iMinKashida, int *piJustify);
242 HRESULT WINAPI ScriptLayout(int cRuns, const BYTE *pbLevel, int *piVisualToLogical, int *piLogicalToVisual);
243 HRESULT WINAPI ScriptShape(HDC hdc, SCRIPT_CACHE *psc, const WCHAR *pwcChars, int cChars, int cMaxGlyphs,
244                            SCRIPT_ANALYSIS *psa, WORD *pwOutGlyphs, WORD *pwLogClust, SCRIPT_VISATTR *psva, int *pcGlyphs);
245 HRESULT WINAPI ScriptPlace(HDC hdc, SCRIPT_CACHE *psc, const WORD *pwGlyphs, int cGlyphs, const SCRIPT_VISATTR *psva,
246                            SCRIPT_ANALYSIS *psa, int *piAdvance, GOFFSET *pGoffset, ABC *pABC );
247 HRESULT WINAPI ScriptBreak(const WCHAR *pwcChars, int cChars, const SCRIPT_ANALYSIS *psa, SCRIPT_LOGATTR *psla);
248 HRESULT WINAPI ScriptCacheGetHeight(HDC hdc, SCRIPT_CACHE *psc, LONG *tmHeight);
249 HRESULT WINAPI ScriptCPtoX(int iCP, BOOL fTrailing, int cChars, int cGlyphs, const WORD *pwLogClust, const SCRIPT_VISATTR *psva,
250                            const int *piAdvance, const SCRIPT_ANALYSIS *psa, int *piX);
251 HRESULT WINAPI ScriptXtoCP(int iX, int cChars, int cGlyphs, const WORD *pwLogClust, const SCRIPT_VISATTR *psva,
252                            const int *piAdvance, const SCRIPT_ANALYSIS *psa, int *piCP, int *piTrailing);
253 HRESULT WINAPI ScriptStringCPtoX(SCRIPT_STRING_ANALYSIS ssa, int icp, BOOL fTrailing, int *pX);
254 HRESULT WINAPI ScriptStringXtoCP(SCRIPT_STRING_ANALYSIS ssa, int iX, int *piCh , int *piTrailing);
255 HRESULT WINAPI ScriptStringGetLogicalWidths(SCRIPT_STRING_ANALYSIS ssa, int *piDx);
256 HRESULT WINAPI ScriptStringGetOrder(SCRIPT_STRING_ANALYSIS ssa, UINT *puOrder);
257 HRESULT WINAPI ScriptStringOut(SCRIPT_STRING_ANALYSIS ssa, int iX, int iY, UINT uOptions, const RECT *prc,
258                                int iMinSel, int iMaxSel, BOOL fDisabled);
259 HRESULT WINAPI ScriptTextOut(const HDC hdc, SCRIPT_CACHE *psc, int x, int y, UINT fuOptions, const RECT *lprc,
260                              const SCRIPT_ANALYSIS *psa, const WCHAR *pwcReserved, int iReserved, const WORD *pwGlyphs,
261                              int cGlyphs, const int *piAdvance, const int *piJustify, const GOFFSET *pGoffset);
262 const int* WINAPI ScriptString_pcOutChars(SCRIPT_STRING_ANALYSIS ssa);
263 const SCRIPT_LOGATTR* WINAPI ScriptString_pLogAttr(SCRIPT_STRING_ANALYSIS ssa);
264 const SIZE* WINAPI ScriptString_pSize(SCRIPT_STRING_ANALYSIS ssa);
265
266 #ifdef __cplusplus
267 } /* extern "C" */
268 #endif
269
270 #endif /* __USP10_H */