DMDX Help.


Unicode notes.

   

   The Unicode code path in DMDX can either be turned on with the Unicode check box in the main DMDX dialog or a command line switch.  Use of the -unicode command line switch overrides the Unicode check box.  With the Unicode code path enabled DMDX uses any Unicode \u control words in the RTF file that may be present instead of the ANSI equivalents and marks all regular ANSI characters up by putting \'00 after them so they become Unicode 16 bit characters.

   While the Unicode code path through DMDX was initially added to see if we could get DMDX to handle a Tamil font it's also useful with double code page Asian fonts that have MS Word smart quotes in them.  Because DMDX when run with the Unicode code path on is now using the Unicode RTF keywords it can differentiate between Word's smart quotes and normal characters so the smart quote detection is permanently off when the Unicode code path is on.  Once the Unicode path was added the problem with the Tamil font then became that Windows GDI didn't render the vowel modifiers in the correct places until we went to the Control Panel Regional and Language options and checked both the Complex right to left font handling and East Asian boxes (so you might need to do this as well).  (In passing we also noticed in another instance a machine rendering a Hebrew font (so right to left text) where Unicode was off and it was rendering the Hebrew backwards until we installed the right to left language option, no other changes made to DMDX, the Unicode option or the RTF file).   Once these options were installed DMDX's displayed output matched Word's and while Word's output is not technically correct (certain glyphs are not displayed) I figure once DMDX's output matches Word's my responsibility is pretty much over.  There is another whole Windows Unicode module called Uniscribe that has a couple of new APIs that maybe some day we'll delve into but that day isn't today.

   The key indicator that you need to turn the Unicode code path on is getting question marks rendered instead of the desired characters as that's what the Tamil initially looked like.  In the past Asian fonts have had ANSI double code page alternatives to the Unicode characters, not so the Tamil.  From what I've read using a ? as an alternative to Unicode characters instead of some ANSI code page alternative would appear to be a wide spread practice so perhaps others will come across this as well.  Note that you don't want to use Unicode regardless, not the way DMDX is currently designed anyway as there are files that contain double code page font references without any Unicode alternative.  Here, when you force DMDX to use the Unicode path it takes the double code page references as Unicode references and you'll get gibberish rendered.  No doubt I'll come up with some solution but for now it's caveat emptor.

   Macros will require a little extra attention when the Unicode code path is on.  This is because regions outside of text segments are still ANSI coded 8 bit characters just like they ever were, only inside text segments is Unicode found and it's not real Unicode but instead marked up RTF hex sequences.  So the text segment "~M" with the Unicode path turned on gets marked up to "~\'00M\'00".  The macro code is smart enough that it will detect macros used outside of quotes and leave them as ANSI sequences and also detect if a macro is used within quotes and mark the macro body up with \'00 correctly.  The problem comes if you want to have special Unicode characters in the macro body as the RTF parser is going to strip them out as they won't be in quotes.  And you can't use the double quote as a macro delimiter if there's already another text segment as it will get flagged as a frame with multiple text segments.  So this would fail:

+1 "this will fail" mU"வேறுபாடு";

   The solution is to use the keyword version of the macro definition (that I suspect never worked till I fixed it in 4.0.0.0) where the text segment is within the keyword and won't get flagged as multiple text segments: 

+1 "this will work" <md U"வேறுபாடு">;

   But care is still needed as use of macro U outside any text segment will freak things out totally as there's no code that strips Unicode sequences out of a macro body when used outside quotes (if it's a real problem I'll add the code but I can't see someone wanting it and only mention it for completeness' sake).

   NOTE:- When the Unicode code path is active text in frame text segments displayed in the diagnostics will be marked up Unicode.  So the example on the DMDX How to Use It page would be look like this:





DMDX Index.