kernel32: Add parentheses to clarify the precedence between '&' and '||'.
[wine/multimedia.git] / dlls / gdi32 / bidi.c
blob9b8f7581620ba555b8721184c46e5f8591bb3499
1 /*
2 * GDI BiDirectional handling
4 * Copyright 2003 Shachar Shemesh
5 * Copyright 2007 Maarten Lankhorst
6 * Copyright 2010 CodeWeavers, Aric Stewart
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 * Code derived from the modified reference implementation
23 * that was found in revision 17 of http://unicode.org/reports/tr9/
24 * "Unicode Standard Annex #9: THE BIDIRECTIONAL ALGORITHM"
26 * -- Copyright (C) 1999-2005, ASMUS, Inc.
28 * Permission is hereby granted, free of charge, to any person obtaining a
29 * copy of the Unicode data files and any associated documentation (the
30 * "Data Files") or Unicode software and any associated documentation (the
31 * "Software") to deal in the Data Files or Software without restriction,
32 * including without limitation the rights to use, copy, modify, merge,
33 * publish, distribute, and/or sell copies of the Data Files or Software,
34 * and to permit persons to whom the Data Files or Software are furnished
35 * to do so, provided that (a) the above copyright notice(s) and this
36 * permission notice appear with all copies of the Data Files or Software,
37 * (b) both the above copyright notice(s) and this permission notice appear
38 * in associated documentation, and (c) there is clear notice in each
39 * modified Data File or in the Software as well as in the documentation
40 * associated with the Data File(s) or Software that the data or software
41 * has been modified.
44 #include "config.h"
46 #include <stdarg.h>
47 #include "windef.h"
48 #include "winbase.h"
49 #include "wingdi.h"
50 #include "winnls.h"
51 #include "usp10.h"
52 #include "wine/unicode.h"
53 #include "wine/debug.h"
54 #include "gdi_private.h"
56 WINE_DEFAULT_DEBUG_CHANNEL(bidi);
58 /* HELPER FUNCTIONS AND DECLARATIONS */
60 #define odd(x) ((x) & 1)
62 /*------------------------------------------------------------------------
63 Bidirectional Character Types
65 as defined by the Unicode Bidirectional Algorithm Table 3-7.
67 Note:
69 The list of bidirectional character types here is not grouped the
70 same way as the table 3-7, since the numberic values for the types
71 are chosen to keep the state and action tables compact.
72 ------------------------------------------------------------------------*/
73 enum directions
75 /* input types */
76 /* ON MUST be zero, code relies on ON = N = 0 */
77 ON = 0, /* Other Neutral */
78 L, /* Left Letter */
79 R, /* Right Letter */
80 AN, /* Arabic Number */
81 EN, /* European Number */
82 AL, /* Arabic Letter (Right-to-left) */
83 NSM, /* Non-spacing Mark */
84 CS, /* Common Separator */
85 ES, /* European Separator */
86 ET, /* European Terminator (post/prefix e.g. $ and %) */
88 /* resolved types */
89 BN, /* Boundary neutral (type of RLE etc after explicit levels) */
91 /* input types, */
92 S, /* Segment Separator (TAB) // used only in L1 */
93 WS, /* White space // used only in L1 */
94 B, /* Paragraph Separator (aka as PS) */
96 /* types for explicit controls */
97 RLO, /* these are used only in X1-X9 */
98 RLE,
99 LRO,
100 LRE,
101 PDF,
103 /* resolved types, also resolved directions */
104 N = ON, /* alias, where ON, WS and S are treated the same */
107 /* HELPER FUNCTIONS */
109 /* Convert the libwine information to the direction enum */
110 static void classify(LPCWSTR lpString, WORD *chartype, DWORD uCount)
112 static const enum directions dir_map[16] =
114 L, /* unassigned defaults to L */
127 NSM,
129 PDF /* also LRE, LRO, RLE, RLO */
132 unsigned i;
134 for (i = 0; i < uCount; ++i)
136 chartype[i] = dir_map[get_char_typeW(lpString[i]) >> 12];
137 if (chartype[i] == PDF)
139 switch (lpString[i])
141 case 0x202A: chartype[i] = LRE; break;
142 case 0x202B: chartype[i] = RLE; break;
143 case 0x202C: chartype[i] = PDF; break;
144 case 0x202D: chartype[i] = LRO; break;
145 case 0x202E: chartype[i] = RLO; break;
151 /* Set a run of cval values at locations all prior to, but not including */
152 /* iStart, to the new value nval. */
153 static void SetDeferredRun(BYTE *pval, int cval, int iStart, int nval)
155 int i = iStart - 1;
156 for (; i >= iStart - cval; i--)
158 pval[i] = nval;
162 /* THE PARAGRAPH LEVEL */
164 /*------------------------------------------------------------------------
165 Function: resolveParagraphs
167 Resolves the input strings into blocks over which the algorithm
168 is then applied.
170 Implements Rule P1 of the Unicode Bidi Algorithm
172 Input: Text string
173 Character count
175 Output: revised character count
177 Note: This is a very simplistic function. In effect it restricts
178 the action of the algorithm to the first paragraph in the input
179 where a paragraph ends at the end of the first block separator
180 or at the end of the input text.
182 ------------------------------------------------------------------------*/
184 static int resolveParagraphs(WORD *types, int cch)
186 /* skip characters not of type B */
187 int ich = 0;
188 for(; ich < cch && types[ich] != B; ich++);
189 /* stop after first B, make it a BN for use in the next steps */
190 if (ich < cch && types[ich] == B)
191 types[ich++] = BN;
192 return ich;
195 /* REORDER */
196 /*------------------------------------------------------------------------
197 Function: resolveLines
199 Breaks a paragraph into lines
201 Input: Array of line break flags
202 Character count
203 In/Out: Array of characters
205 Returns the count of characters on the first line
207 Note: This function only breaks lines at hard line breaks. Other
208 line breaks can be passed in. If pbrk[n] is TRUE, then a break
209 occurs after the character in pszInput[n]. Breaks before the first
210 character are not allowed.
211 ------------------------------------------------------------------------*/
212 static int resolveLines(LPCWSTR pszInput, const BOOL * pbrk, int cch)
214 /* skip characters not of type LS */
215 int ich = 0;
216 for(; ich < cch; ich++)
218 if (pszInput[ich] == (WCHAR)'\n' || (pbrk && pbrk[ich]))
220 ich++;
221 break;
225 return ich;
228 /*------------------------------------------------------------------------
229 Function: resolveWhiteSpace
231 Resolves levels for WS and S
232 Implements rule L1 of the Unicode bidi Algorithm.
234 Input: Base embedding level
235 Character count
236 Array of direction classes (for one line of text)
238 In/Out: Array of embedding levels (for one line of text)
240 Note: this should be applied a line at a time. The default driver
241 code supplied in this file assumes a single line of text; for
242 a real implementation, cch and the initial pointer values
243 would have to be adjusted.
244 ------------------------------------------------------------------------*/
245 static void resolveWhitespace(int baselevel, const WORD *pcls, BYTE *plevel, int cch)
247 int cchrun = 0;
248 BYTE oldlevel = baselevel;
250 int ich = 0;
251 for (; ich < cch; ich++)
253 switch(pcls[ich])
255 default:
256 cchrun = 0; /* any other character breaks the run */
257 break;
258 case WS:
259 cchrun++;
260 break;
262 case RLE:
263 case LRE:
264 case LRO:
265 case RLO:
266 case PDF:
267 case BN:
268 plevel[ich] = oldlevel;
269 cchrun++;
270 break;
272 case S:
273 case B:
274 /* reset levels for WS before eot */
275 SetDeferredRun(plevel, cchrun, ich, baselevel);
276 cchrun = 0;
277 plevel[ich] = baselevel;
278 break;
280 oldlevel = plevel[ich];
282 /* reset level before eot */
283 SetDeferredRun(plevel, cchrun, ich, baselevel);
286 /*------------------------------------------------------------------------
287 Function: BidiLines
289 Implements the Line-by-Line phases of the Unicode Bidi Algorithm
291 Input: Count of characters
292 Array of character directions
294 Inp/Out: Input text
295 Array of levels
297 ------------------------------------------------------------------------*/
298 static void BidiLines(int baselevel, LPWSTR pszOutLine, LPCWSTR pszLine, const WORD * pclsLine,
299 BYTE * plevelLine, int cchPara, const BOOL * pbrk)
301 int cchLine = 0;
302 int done = 0;
303 int *run;
305 run = HeapAlloc(GetProcessHeap(), 0, cchPara * sizeof(int));
306 if (!run)
308 WARN("Out of memory\n");
309 return;
314 /* break lines at LS */
315 cchLine = resolveLines(pszLine, pbrk, cchPara);
317 /* resolve whitespace */
318 resolveWhitespace(baselevel, pclsLine, plevelLine, cchLine);
320 if (pszOutLine)
322 int i;
323 /* reorder each line in place */
324 ScriptLayout(cchLine, plevelLine, NULL, run);
325 for (i = 0; i < cchLine; i++)
326 pszOutLine[done+run[i]] = pszLine[i];
329 pszLine += cchLine;
330 plevelLine += cchLine;
331 pbrk += pbrk ? cchLine : 0;
332 pclsLine += cchLine;
333 cchPara -= cchLine;
334 done += cchLine;
336 } while (cchPara);
338 HeapFree(GetProcessHeap(), 0, run);
341 /*************************************************************
342 * BIDI_Reorder
344 * Returns TRUE if reordering was required and done.
346 BOOL BIDI_Reorder(
347 HDC hDC, /*[in] Display DC */
348 LPCWSTR lpString, /* [in] The string for which information is to be returned */
349 INT uCount, /* [in] Number of WCHARs in string. */
350 DWORD dwFlags, /* [in] GetCharacterPlacement compatible flags specifying how to process the string */
351 DWORD dwWineGCP_Flags, /* [in] Wine internal flags - Force paragraph direction */
352 LPWSTR lpOutString, /* [out] Reordered string */
353 INT uCountOut, /* [in] Size of output buffer */
354 UINT *lpOrder, /* [out] Logical -> Visual order map */
355 WORD **lpGlyphs, /* [out] reordered, mirrored, shaped glyphs to display */
356 INT *cGlyphs /* [out] number of glyphs generated */
359 WORD *chartype;
360 BYTE *levels;
361 unsigned i, done, glyph_i;
362 BOOL is_complex;
364 int maxItems;
365 int nItems;
366 SCRIPT_CONTROL Control;
367 SCRIPT_STATE State;
368 SCRIPT_ITEM *pItems;
369 HRESULT res;
370 SCRIPT_CACHE psc = NULL;
371 WORD *run_glyphs = NULL;
372 WORD *pwLogClust = NULL;
373 SCRIPT_VISATTR *psva = NULL;
374 DWORD cMaxGlyphs = 0;
375 BOOL doGlyphs = TRUE;
377 TRACE("%s, %d, 0x%08x lpOutString=%p, lpOrder=%p\n",
378 debugstr_wn(lpString, uCount), uCount, dwFlags,
379 lpOutString, lpOrder);
381 memset(&Control, 0, sizeof(Control));
382 memset(&State, 0, sizeof(State));
383 if (lpGlyphs)
384 *lpGlyphs = NULL;
386 if (!(dwFlags & GCP_REORDER))
388 FIXME("Asked to reorder without reorder flag set\n");
389 return FALSE;
392 if (lpOutString && uCountOut < uCount)
394 FIXME("lpOutString too small\n");
395 return FALSE;
398 chartype = HeapAlloc(GetProcessHeap(), 0, uCount * sizeof(WORD));
399 if (!chartype)
401 WARN("Out of memory\n");
402 return FALSE;
405 if (lpOutString)
406 memcpy(lpOutString, lpString, uCount * sizeof(WCHAR));
408 is_complex = FALSE;
409 for (i = 0; i < uCount && !is_complex; i++)
411 if ((lpString[i] >= 0x900 && lpString[i] <= 0xfff) ||
412 (lpString[i] >= 0x1cd0 && lpString[i] <= 0x1cff) ||
413 (lpString[i] >= 0xa840 && lpString[i] <= 0xa8ff))
414 is_complex = TRUE;
417 /* Verify reordering will be required */
418 if ((WINE_GCPW_FORCE_RTL == (dwWineGCP_Flags&WINE_GCPW_DIR_MASK)) ||
419 ((dwWineGCP_Flags&WINE_GCPW_DIR_MASK) == WINE_GCPW_LOOSE_RTL))
420 State.uBidiLevel = 1;
421 else if (!is_complex)
423 done = 1;
424 classify(lpString, chartype, uCount);
425 for (i = 0; i < uCount; i++)
426 switch (chartype[i])
428 case R:
429 case AL:
430 case RLE:
431 case RLO:
432 done = 0;
433 break;
435 if (done)
437 HeapFree(GetProcessHeap(), 0, chartype);
438 if (lpOrder)
440 for (i = 0; i < uCount; i++)
441 lpOrder[i] = i;
443 return TRUE;
447 levels = HeapAlloc(GetProcessHeap(), 0, uCount * sizeof(BYTE));
448 if (!levels)
450 WARN("Out of memory\n");
451 HeapFree(GetProcessHeap(), 0, chartype);
452 return FALSE;
455 maxItems = 5;
456 pItems = HeapAlloc(GetProcessHeap(),0, maxItems * sizeof(SCRIPT_ITEM));
457 if (!pItems)
459 WARN("Out of memory\n");
460 HeapFree(GetProcessHeap(), 0, chartype);
461 HeapFree(GetProcessHeap(), 0, levels);
462 return FALSE;
465 if (lpGlyphs)
467 cMaxGlyphs = 1.5 * uCount + 16;
468 run_glyphs = HeapAlloc(GetProcessHeap(),0,sizeof(WORD) * cMaxGlyphs);
469 if (!run_glyphs)
471 WARN("Out of memory\n");
472 HeapFree(GetProcessHeap(), 0, chartype);
473 HeapFree(GetProcessHeap(), 0, levels);
474 HeapFree(GetProcessHeap(), 0, pItems);
475 return FALSE;
477 pwLogClust = HeapAlloc(GetProcessHeap(),0,sizeof(WORD) * uCount);
478 if (!pwLogClust)
480 WARN("Out of memory\n");
481 HeapFree(GetProcessHeap(), 0, chartype);
482 HeapFree(GetProcessHeap(), 0, levels);
483 HeapFree(GetProcessHeap(), 0, pItems);
484 HeapFree(GetProcessHeap(), 0, run_glyphs);
485 return FALSE;
487 psva = HeapAlloc(GetProcessHeap(),0,sizeof(SCRIPT_VISATTR) * uCount);
488 if (!psva)
490 WARN("Out of memory\n");
491 HeapFree(GetProcessHeap(), 0, chartype);
492 HeapFree(GetProcessHeap(), 0, levels);
493 HeapFree(GetProcessHeap(), 0, pItems);
494 HeapFree(GetProcessHeap(), 0, run_glyphs);
495 HeapFree(GetProcessHeap(), 0, pwLogClust);
496 return FALSE;
500 done = 0;
501 glyph_i = 0;
502 while (done < uCount)
504 unsigned j;
505 classify(lpString + done, chartype, uCount - done);
506 /* limit text to first block */
507 i = resolveParagraphs(chartype, uCount - done);
508 for (j = 0; j < i; ++j)
509 switch(chartype[j])
511 case B:
512 case S:
513 case WS:
514 case ON: chartype[j] = N;
515 default: continue;
518 if ((dwWineGCP_Flags&WINE_GCPW_DIR_MASK) == WINE_GCPW_LOOSE_RTL)
519 State.uBidiLevel = 1;
520 else if ((dwWineGCP_Flags&WINE_GCPW_DIR_MASK) == WINE_GCPW_LOOSE_LTR)
521 State.uBidiLevel = 0;
523 if (dwWineGCP_Flags & WINE_GCPW_LOOSE_MASK)
525 for (j = 0; j < i; ++j)
526 if (chartype[j] == L)
528 State.uBidiLevel = 0;
529 break;
531 else if (chartype[j] == R || chartype[j] == AL)
533 State.uBidiLevel = 1;
534 break;
538 res = ScriptItemize(lpString + done, i, maxItems, &Control, &State, pItems, &nItems);
539 while (res == E_OUTOFMEMORY)
541 maxItems = maxItems * 2;
542 pItems = HeapReAlloc(GetProcessHeap(), 0, pItems, sizeof(SCRIPT_ITEM) * maxItems);
543 if (!pItems)
545 WARN("Out of memory\n");
546 HeapFree(GetProcessHeap(), 0, chartype);
547 HeapFree(GetProcessHeap(), 0, levels);
548 return FALSE;
550 res = ScriptItemize(lpString + done, i, maxItems, &Control, &State, pItems, &nItems);
553 if (lpOutString || lpOrder)
554 for (j = 0; j < nItems; j++)
556 int k;
557 for (k = pItems[j].iCharPos; k < pItems[j+1].iCharPos; k++)
558 levels[k] = pItems[j].a.s.uBidiLevel;
561 if (lpOutString)
563 /* assign directional types again, but for WS, S this time */
564 classify(lpString + done, chartype, i);
566 BidiLines(State.uBidiLevel, lpOutString + done, lpString + done,
567 chartype, levels, i, 0);
570 if (lpOrder)
572 int k, lastgood;
573 for (j = lastgood = 0; j < i; ++j)
574 if (levels[j] != levels[lastgood])
576 --j;
577 if (odd(levels[lastgood]))
578 for (k = j; k >= lastgood; --k)
579 lpOrder[done + k] = done + j - k;
580 else
581 for (k = lastgood; k <= j; ++k)
582 lpOrder[done + k] = done + k;
583 lastgood = ++j;
585 if (odd(levels[lastgood]))
586 for (k = j - 1; k >= lastgood; --k)
587 lpOrder[done + k] = done + j - 1 - k;
588 else
589 for (k = lastgood; k < j; ++k)
590 lpOrder[done + k] = done + k;
593 if (lpGlyphs && doGlyphs)
595 int j;
596 BYTE runOrder[maxItems];
597 int visOrder[maxItems];
598 SCRIPT_ITEM *curItem;
600 for (j = 0; j < nItems; j++)
601 runOrder[j] = pItems[j].a.s.uBidiLevel;
603 ScriptLayout(nItems, runOrder, visOrder, NULL);
605 for (j = 0; j < nItems; j++)
607 int k;
608 int cChars,cOutGlyphs;
609 curItem = &pItems[visOrder[j]];
611 cChars = pItems[visOrder[j]+1].iCharPos - curItem->iCharPos;
613 res = ScriptShape(hDC, &psc, lpString + done + curItem->iCharPos, cChars, cMaxGlyphs, &curItem->a, run_glyphs, pwLogClust, psva, &cOutGlyphs);
614 while (res == E_OUTOFMEMORY)
616 cMaxGlyphs *= 2;
617 run_glyphs = HeapReAlloc(GetProcessHeap(), 0, run_glyphs, sizeof(WORD) * cMaxGlyphs);
618 if (!run_glyphs)
620 WARN("Out of memory\n");
621 HeapFree(GetProcessHeap(), 0, chartype);
622 HeapFree(GetProcessHeap(), 0, levels);
623 HeapFree(GetProcessHeap(), 0, pItems);
624 HeapFree(GetProcessHeap(), 0, psva);
625 HeapFree(GetProcessHeap(), 0, pwLogClust);
626 HeapFree(GetProcessHeap(), 0, *lpGlyphs);
627 ScriptFreeCache(&psc);
628 *lpGlyphs = NULL;
629 return FALSE;
631 res = ScriptShape(hDC, &psc, lpString + done + curItem->iCharPos, cChars, cMaxGlyphs, &curItem->a, run_glyphs, pwLogClust, psva, &cOutGlyphs);
633 if (res)
635 if (res == USP_E_SCRIPT_NOT_IN_FONT)
636 TRACE("Unable to shape with currently selected font\n");
637 else
638 FIXME("Unable to shape string (%x)\n",res);
639 j = nItems;
640 doGlyphs = FALSE;
641 HeapFree(GetProcessHeap(), 0, *lpGlyphs);
642 *lpGlyphs = NULL;
644 else
646 if (*lpGlyphs)
647 *lpGlyphs = HeapReAlloc(GetProcessHeap(), 0, *lpGlyphs, sizeof(WORD) * (glyph_i + cOutGlyphs));
648 else
649 *lpGlyphs = HeapAlloc(GetProcessHeap(), 0, sizeof(WORD) * (glyph_i + cOutGlyphs));
650 for (k = 0; k < cOutGlyphs; k++)
651 (*lpGlyphs)[glyph_i+k] = run_glyphs[k];
652 glyph_i += cOutGlyphs;
657 done += i;
659 if (cGlyphs)
660 *cGlyphs = glyph_i;
662 HeapFree(GetProcessHeap(), 0, chartype);
663 HeapFree(GetProcessHeap(), 0, levels);
664 HeapFree(GetProcessHeap(), 0, pItems);
665 HeapFree(GetProcessHeap(), 0, run_glyphs);
666 HeapFree(GetProcessHeap(), 0, pwLogClust);
667 HeapFree(GetProcessHeap(), 0, psva);
668 ScriptFreeCache(&psc);
669 return TRUE;