home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / fltk.zip / readme.txt < prev   
Text File  |  2001-12-09  |  4KB  |  81 lines
  1. Hello!
  2.  
  3. Welcome to the native OS/2 PM port of FLTK, in progress.  For the actual
  4. FLTK project's home page, see:
  5.   http://www.fltk.org
  6. Feel free to join the FLTK discussion on newsgroup fltk.general on the news
  7. server news.easysw.com.
  8.  
  9. I've hacked together makefiles that somewhat resemble FLTK's distribution,
  10. but have a few tweaks in them.  The goal is to get it working now, and make
  11. it pretty later.  The directory structure is a subset of the actual FLTK
  12. distribution; it's just been trimmed to the bare essentials to get a library
  13. built on OS/2.
  14.  
  15. The source has lots of #ifdefs peppered throughout for WIN32.  I added an
  16. #elif after each for OS2PM.  So if you grep for OS2PM, you'll see where I
  17. have been doing the porting work.  There a few files ending in "os2" that
  18. are particular to OS/2; you will find similar ones ending in "win32".  I've
  19. essentially followed the Win32 port's philosophy, naming schemes, etc.
  20.  
  21. The things you build are in ./src and ./test.  ./src is the main source code
  22. directory.  It contains Makefile (for gcc/pgcc) and Makefile.omf (for IBM
  23. Visual Age C++).  Invoke 'make' or 'nmake -f Makefile.omf' and you're off.
  24. You will eventually create the a.out library in ../lib/fltk.a (when using
  25. Makefile) or the OMF library ../lib/fltk.lib (when using Makefile.omf).
  26.  
  27. ./test is the directory containing test programs.  Depending on which 
  28. library you have built (the a.out verison using Makefile, or the OMF version
  29. using Makefile.omf) you will be using a similar makefile here.  The catch
  30. is... in ./test, both makefiles are in 'make' format.  So, even if you want
  31. to build OMF test programs, you still invoke 'make -f Makefile.omf'.  Many
  32. of the test programs actually work.  Ones that do not work at all are ones
  33. with Open GL support (I just don't have it installed on my machine; maybe
  34. they do after all!) and ones that contain bitmaps.  Programs that try to 
  35. use double-buffering don't actually do so yet.  And the keyboard support is
  36. still very raw and unfinished.
  37.  
  38. Test programs I've been running lately to work on things are:
  39.   arc.exe
  40.   boxtype.exe
  41.   clock.exe
  42.   label.exe
  43.   minimum.exe
  44.   pack.exe
  45.   valuators.exe
  46. These programs pretty much work.  Others likely have more or less severe
  47. problems yet.
  48.  
  49. Run 'em all and see what works... and see where all the bugs are!  I don't 
  50. need any help with reporting bugs, thanks... but if you've found where a
  51. bug actually is in the code, I want to know all about it!  Until we get
  52. this stuff in CVS, I'll provide and keep a 'master' copy of the code for
  53. anyone else interested.
  54.  
  55. Things that outright don't work yet:
  56.  - Double buffering
  57.  - Bitmaps
  58.  - Imbedded windows (see line_style.exe in test)
  59.  - Dismissing dialogs (see multiple windows, below)
  60.  
  61. Things that work partially:
  62.  - Keyboard
  63.  - Input fields (text highlighting)
  64.  - Clipping - I still need to work out how they push and pop clipping
  65.    rectangles on their stack... OS/2 doesn't let you modify the current
  66.    clipping rectangle
  67.  - Multiple windows (see clock.exe in test... you can't kill one of the
  68.    clocks until both are actually shut down)
  69.  - Fonts sometimes get clipped by one pixel on the right
  70.  
  71. Things that work pretty well:
  72.  - Drawing shapes (partial arcs still contain a little rounding error -
  73.    see FL_ROUND_UP_BOX and FL_ROUND_DOWN_BOX in boxtype.exe)
  74.  - Everything else
  75.  
  76. Send comments, suggestions, code fixes, etc. to david@attglobal.net
  77. or schmidtd@my-deja.com.  There's lots of easy bugs/missing functions 
  78. yet to go after - so get in there and have fun!
  79.  
  80. Thanks!
  81.