Added microwin doc directory, readme and patches
[wxWidgets.git] / docs / microwin / readme.txt
1 wxMicroWindows port
2 ===================
3
4 Julian Smart 2001-07-02
5
6 This is a snapshot of my experimental port of wxWindows to
7 MicroWindows. Widgets are supplied by the wxUniversal project,
8 while the underlying port uses the Windows ports with small
9 modifications for the MicroWindows API.
10
11 There are many things missing from MicroWindows that will
12 make the port quite limited for the time being. I haven't
13 worked out how to create bitmaps, though there is a BMP to C
14 converter. There are no menus, no common dialogs, and only
15 one WIN32 app may be run at a time.
16
17 Some things can no doubt be worked around, and/or MicroWindows
18 itself tweaked. Lots of wxWin functionality is just switched off or
19 commented out.
20
21 Installation
22 ============
23
24 First install MicroWindows - untar it, change config to
25 use X11 and any other options you feel fit, apply
26 microwindows.patches to fix PeekMessage, and compile
27 (type 'make' from within the src directory).
28
29 Untar the wxMicroWindows port, and change the TOP variable at the
30 top of src/microwin/Makefile to reflect where MicroWindows is installed.
31 Type 'make all' from src/microwin. To clean, use cleanwx and NOT clean
32 since that will clean MicroWindows itself.
33
34 To make the sample, cd into samples/minimal, edit the TOP variable,
35 and type 'make all'.
36 Running 'minimal' runs the virtual MicroWindows desktop
37 and the minimal sample, since in a MicroWindows WIN32 application
38 they are one and the same binary.
39
40 Status
41 ======
42
43 A frame comes up :-)
44
45 Notes
46 =====
47
48 No ::GetKeyState (see microwin/private.h). Should probably use GdOpenKeyboard/GdCloseKeyboard/GdReadKeyboard. Could perhaps emulate GetKeyState this way.
49
50 No ::CreateBitmap or BITMAPINFO. But BMPs can be converted
51 to C using convbmp, then need to use Gr... functions.
52
53 No ::DestroyIcon, ::DestroyCursor - use ::DestroyObject instead?
54 Also no LoadCursor, LoadImage. So how do we make cursors? No ::SetCursor.
55
56 wxDC: no ::GetTextColor, ::GetBkColor, ::IntersectClipRect,
57 ::GetClipBox
58
59 No ::SetMenu, so no menus or menubars.
60
61 No ::GetObject so we can't get LOGFONT from an HFONT
62 in wxSystemSettings.
63
64 No ::CreateDialog so how do we create dialogs? Simulate
65 one with a frame I guess.