summaryrefslogtreecommitdiff
path: root/README.fltk118-utf
blob: 78001aa21a98ba330e0cd98ca11e7514cea848c6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
NOTES:
------
This is a cut down snapshot of fltk-1.1.x-r6041 merged in a somewhat
haphazard manner with the OksiD UTF-8 patch (for fltk-1.1.6)
Then some of the UTF functions from FLTK2 were back-ported into the
mix.

This code has also been modified to implement the XFT support on X
that was missing from the fltk-1.1.6 variant.

I have also introduced a number of extra test programs into the "demo"
directory - to test DnD operation, and to verify the behaviour Fl::add_fd()
on various platforms (this test also verifies some aspects of UDP multicast
operation that was causing issues on win32 with winsock-1.1.)
These two examples are accessed from the Demo program in the Events submenu.

There is also an extended font-chooser/unicode font display test, derived
from the utf8 test that OksiD had added to fltk-1.1.6-utf8.
This is accessed in the Demo program under the Other Tests/Font Tests 
submenu.


This code has been tested on linux (FC7), WinXP with mingw
and OSX 10.4.11.
The OSX port MUST HAVE the QUARTZ mode enabled in configure to
work (the older fltk QD code will not work.)


Linux
-----
This code has been built with the following configure options
on the linux platform:

./configure --enable-threads --enable-xft

At present the code also works without XFT enabled (as the original OksiD 
code did) but I can't count on that state of affairs being permanent!

./configure --enable-threads


WIN32
-----
On WinXP, the code was built with mingw in an Msys shell with the
following configure options:

./configure --enable-threads

Was used an a box that already has image libs installed.

./configure --enable-threads  --enable-localjpeg --enable-localzlib --enable-localpng

Was used an a box that does not have image libs installed.

Both cases function as expected.

I do not have access to the MS compler tools here, so the code is untested with
their compilers. I do not think I have introduced any incompatabilities but...
Feedback welcome.

NOTE: The "standard" FLTK-1.1 build uses the (deprecated) winsock-1.1 libs.
This revised code uses the (allegedly) better winsock-2 libs instead.
This means you will probably have to change the link options in any existing
projects to incorporate this change - the libs are *NOT* reliably inter-changeable!
(fltk-utf8-config will return the correct libs for use.)


OSX
---
The OSX build was configured with:

./configure --enable-threads --enable-quartz


Issues
------
At time of writing, the code seems to "work", but there are issues:

- The build is "noisy".

- The gl font handling is not ideal under XFT (but it always was
  anyway. We need a glXUseXftFont method really, but that doesn't seem
  to exist...I could try and write one, but time...)

- The xim stuff is still needing work - I'm pretty sure I have broken this

- Input methods under win32? I don't know.

- Input Methods under OSX? No idea.

- The code is now badly formatted in places from all my random
  cut'n'paste...

--
IMM: 24th Feb 2008