| | 1 | wxMicroWindows port |
| | 2 | =================== |
| | 3 | |
| | 4 | Julian Smart 2001-07-02 |
| | 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.89pre7 |
| | 30 | - change 'config' to use X11 and any other options you feel fit, |
| | 31 | such as verbose compilation |
| | 32 | - cd to src/mwin and apply microwindows.patches (from wxWindows: |
| | 33 | docs/microwin/microwindows.patches) to fix PeekMessage |
| | 34 | - compile by typing 'make' from within the MicroWindows src directory |
| | 35 | |
| | 36 | wxMicroWindows: |
| | 37 | |
| | 38 | - untar the wxMicroWindows port/download from CVS |
| | 39 | - and change the TOP variable at the top of src/msw/makefile.mic |
| | 40 | to reflect where MicroWindows is installed |
| | 41 | - type 'make all' from src/msw. To clean, use cleanwx and NOT clean |
| | 42 | since that will clean MicroWindows itself |
| | 43 | - to make the sample, cd into samples/minimal, edit the TOP variable, |
| | 44 | and type 'make all' |
| | 45 | |
| | 46 | Running 'minimal' runs the virtual MicroWindows desktop |
| | 47 | and the minimal sample, since in a MicroWindows WIN32 application |
| | 48 | they are one and the same binary. |
| | 49 | |
| | 50 | Status |
| | 51 | ====== |
| | 52 | |
| | 53 | A frame comes up :-) The menus don't work properly just yet. |
| | 54 | |
| | 55 | Implementation Notes |
| | 56 | ==================== |
| | 57 | |
| | 58 | wxMicroWindows is essentially the wxMSW port + wxUniversal |
| | 59 | widgets. Lots of things in include/wx/univ/setup.h are switched |
| | 60 | off to allow the port to compile. There are also #ifdefs |
| | 61 | switching off further functionality, such as most wxBitmap |
| | 62 | functions, pending proper implementation. |
| | 63 | |
| | 64 | There are some WIN32 API functions not implemented by MicroWindows |
| | 65 | that are instead stubbed out in include/wx/msw/microwin.c, |
| | 66 | and 'implemented' in src/msw/microwin.c. Some of these functions |
| | 67 | are important, some less so. They will need to be implemented |
| | 68 | in due course. But implementing missing functionality in this way |
| | 69 | is preferably to proliferating many #ifdefs in the |
| | 70 | wxMSW/wxMicroWindows port itself. |
| | 71 | |
| | 72 | Things missing from MicroWindows that need to be worked around |
| | 73 | ============================================================== |
| | 74 | |
| | 75 | No ::GetKeyState (see include/wx/msw/private.h). Should probably use |
| | 76 | GdOpenKeyboard/GdCloseKeyboard/GdReadKeyboard. Could perhaps emulate |
| | 77 | GetKeyState this way. |
| | 78 | |
| | 79 | No ::CreateBitmap or BITMAPINFO. But BMPs can be converted |
| | 80 | to C using convbmp, then need to use Gr... functions. |
| | 81 | We MUST implement creation from XPMs, since wxUniversal |
| | 82 | makes use of XPMs, or else create our own bitmaps for |
| | 83 | drawing radioboxes, checkboxes etc.: see renderers |
| | 84 | in src/univ. |
| | 85 | |
| | 86 | No ::DestroyIcon, ::DestroyCursor - use ::DestroyObject instead? |
| | 87 | Also no LoadCursor, LoadImage. So how do we make cursors? No ::SetCursor. |
| | 88 | |
| | 89 | wxDC: no ::GetTextColor, ::GetBkColor, ::IntersectClipRect, |
| | 90 | ::GetClipBox |
| | 91 | |
| | 92 | No ::SetMenu, so no menus or menubars (now implemented by |
| | 93 | wxUniversal). |
| | 94 | |
| | 95 | No ::GetObject so we can't get LOGFONT from an HFONT |
| | 96 | in wxSystemSettings (worked around by passing HFONT to |
| | 97 | the wxFont constructor). |
| | 98 | |
| | 99 | No ::CreateDialog so how do we create dialogs? Simulate |
| | 100 | one with a frame... |
| | 101 | |
projects / wxWidgets.git / blame_incremental