| | 1 | wxMicroWindows port |
| | 2 | =================== |
| | 3 | |
| | 4 | Julian Smart 2001-12-08 |
| | 5 | |
| | 6 | This is a port of wxWindows to MicroWindows, under Linux. |
| | 7 | Widgets are supplied by the wxUniversal project, while the |
| | 8 | underlying port uses the Windows ports with small modifications |
| | 9 | 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 common dialogs (we will use generic ones), |
| | 15 | and only one WIN32 app may be run at a time. |
| | 16 | |
| | 17 | Note that you can gain confidence in the WIN32/wxUniversal |
| | 18 | combination by compiling wxUniversal under Windows using VC++, |
| | 19 | using src/wxvc_universal.dsp. You can compile the minimal |
| | 20 | and widgets samples in wxUniversal mode using the |
| | 21 | UnivDebug and UnivRelease targets. Most of the code is shared |
| | 22 | between this combination, and the wxMicroWindows port. |
| | 23 | |
| | 24 | Installation |
| | 25 | ============ |
| | 26 | |
| | 27 | MicroWindows: |
| | 28 | |
| | 29 | - unarchive MicroWindows 0.89pre8 |
| | 30 | |
| | 31 | - change 'config' to use X11 and any other options you feel fit. |
| | 32 | Suggestions for changes to the defaults: |
| | 33 | |
| | 34 | ERASEMOVE=N (otherwise moving windows will look messy) |
| | 35 | X11=Y |
| | 36 | OPTIMIZE=N |
| | 37 | DEBUG=Y |
| | 38 | VERBOSE=Y |
| | 39 | |
| | 40 | - apply microwindows.patches (from wxWindows: |
| | 41 | docs/microwin/microwindows.patches) to fix PeekMessage |
| | 42 | and other issues. If the patch doesn't apply automatically, |
| | 43 | you may need to apply it by hand |
| | 44 | |
| | 45 | - compile by typing 'make' from within the MicroWindows src directory |
| | 46 | |
| | 47 | wxMicroWindows: |
| | 48 | |
| | 49 | - Download wxMSW 2.3.2 or greater, or get it from CVS |
| | 50 | |
| | 51 | - Copy include/wx/msw/setup_microwin.h to include/wx/setup.h if |
| | 52 | include/wx/setup.h doesn't exist |
| | 53 | |
| | 54 | - change the TOP variable at the top of src/msw/makefile.mic |
| | 55 | to reflect where MicroWindows is installed |
| | 56 | |
| | 57 | - type 'make -f makefile.mic all' from src/msw. To clean, use |
| | 58 | cleanwx and NOT clean since that will clean MicroWindows itself |
| | 59 | |
| | 60 | - to make the sample, cd into samples/minimal, edit the TOP variable, |
| | 61 | and type 'make -f makefile.mic all' |
| | 62 | |
| | 63 | Running 'minimal' runs the virtual MicroWindows desktop |
| | 64 | and the minimal sample, since in a MicroWindows WIN32 application |
| | 65 | they are one and the same binary. |
| | 66 | |
| | 67 | Status |
| | 68 | ====== |
| | 69 | |
| | 70 | The minimal sample is almost fully-functional, apart from minor |
| | 71 | menu presentation issues (no borders, for example). |
| | 72 | |
| | 73 | Implementation Notes |
| | 74 | ==================== |
| | 75 | |
| | 76 | wxMicroWindows is essentially the wxMSW port + wxUniversal |
| | 77 | widgets. Lots of things in include/wx/univ/setup.h are switched |
| | 78 | off to allow the port to compile. There are also #ifdefs |
| | 79 | switching off further functionality, such as most wxBitmap |
| | 80 | functions, pending proper implementation. |
| | 81 | |
| | 82 | There are some WIN32 API functions not implemented by MicroWindows |
| | 83 | that are instead stubbed out in include/wx/msw/microwin.c, |
| | 84 | and 'implemented' in src/msw/microwin.c. Some of these functions |
| | 85 | are important, some less so. They will need to be implemented |
| | 86 | in due course. But implementing missing functionality in this way |
| | 87 | is preferably to proliferating many #ifdefs in the |
| | 88 | wxMSW/wxMicroWindows port itself. |
| | 89 | |
| | 90 | Things missing from MicroWindows that need to be worked around |
| | 91 | ============================================================== |
| | 92 | |
| | 93 | No ::GetKeyState (see include/wx/msw/private.h). Should probably use |
| | 94 | GdOpenKeyboard/GdCloseKeyboard/GdReadKeyboard. Could perhaps emulate |
| | 95 | GetKeyState this way. |
| | 96 | |
| | 97 | No ::CreateBitmap or BITMAPINFO. But BMPs can be converted |
| | 98 | to C using convbmp, then need to use Gr... functions. |
| | 99 | We MUST implement creation from XPMs, since wxUniversal |
| | 100 | makes use of XPMs, or else create our own bitmaps for |
| | 101 | drawing radioboxes, checkboxes etc.: see renderers |
| | 102 | in src/univ. |
| | 103 | |
| | 104 | No ::DestroyIcon, ::DestroyCursor - use ::DestroyObject instead? |
| | 105 | Also no LoadCursor, LoadImage. So how do we make cursors? No ::SetCursor. |
| | 106 | |
| | 107 | wxDC: no ::GetTextColor, ::GetBkColor, ::IntersectClipRect, |
| | 108 | ::GetClipBox |
| | 109 | |
| | 110 | No ::SetMenu, so no menus or menubars (now implemented by |
| | 111 | wxUniversal). |
| | 112 | |
| | 113 | No ::GetObject so we can't get LOGFONT from an HFONT |
| | 114 | in wxSystemSettings (worked around by passing HFONT to |
| | 115 | the wxFont constructor). |
| | 116 | |
projects / wxWidgets.git / blame_incremental