fltk/README.mac
Matthias Melcher 1fceb8ac2c MacOS: added opaque window resizing,
all events except Mac menus are now handled using Carbon,
window activation fixed,
GL_SWAP_TYPE default changed to make gl_overlay work.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@1874 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
2001-12-19 09:10:00 +00:00

144 lines
3.9 KiB
Plaintext

README.mac - 12/03/2001 - Building FLTK under MacOS and OS X
------------------------------------------------------------
CONTENTS
--------
- Introduction
- gcc (Carbon) - how to build
- scripts
- known MacFLTK bugs
- test suite status
- other stuff
- FLTK 1.0.x for Mac
INTRODUCTION
------------
FLTK for Mac OS X is in beta stage. Expect rapid changes to the
source code and build environment.
FLTK currently supports the following development environment on the
Mac OS X platform:
- gcc (Carbon)
- (Metrowerks CodeWarrior - future releases)
- (Apple Project Builder - future releases)
- (MPW - future releases)
FLTK for Mac is carbonized, i.e. all applications should run on Mac
OS 8.1 and higher and OS X without changes.
gcc (Carbon) - how to build
--------------------------
Since the Max OS X command line build environment is based on BSD
Unix, the normal Unix build procedure as described in 'README'
applies.
A 'resource fork' will be attached to applications to make
them visible in the Finder. Thedefault resource file is ./FL/mac.r .
A possible way to add a resource fork is:
> Rez -t APPL -c Fltk ../FL/mac.r -o hello
scripts
-------
When using Finder applications on source files (i.e. FileMerge)
I found the following script very useful. It adds resource forks to
all text files.
#!/bin/tcsh
setenv SET_MAC_TYPE "SetFile -t TEXT -c ttxt "
setenv F1MAC_N 7
echo "Setting Mac File Types. Please wait..."
echo "[1/"$F1MAC_N"]"
find . -name '*.H' -exec $SET_MAC_TYPE {} \;
echo "[2/"$F1MAC_N"]"
find . -name '*.h' -exec $SET_MAC_TYPE {} \;
echo "[3/"$F1MAC_N"]"
find . -name '*.c' -exec $SET_MAC_TYPE {} \;
echo "[4/"$F1MAC_N"]"
find . -name '*.cxx' -exec $SET_MAC_TYPE {} \;
echo "[5/"$F1MAC_N"]"
find . -name '*.fl' -exec $SET_MAC_TYPE {} \;
echo "[6/"$F1MAC_N"]"
find . -name 'make*' -exec $SET_MAC_TYPE {} \;
echo "[7/"$F1MAC_N"]"
find . -name 'Make*' -exec $SET_MAC_TYPE {} \;
echo "done."
known MacFLTK bugs
------------------
- file handles not supported
- timing not fully supported
- line styles not fully supported
- cut, copy, paste
- sub-sub-subwindow not tested
- modal windows are not modal
- overlay not complete
- image transparency not implemented
- 'shiny' needs work (flush/aglFlush)
- threads not implemented
test suite status
-----------------
OS X:
CubeView(++), adjuster(++), arc(++), ask(++), bitmap(++),
boxtype(++), browser(++), button(++), buttons(++), checkers(++),
clock(++), colbrowser(++), color_chooser(++), cube(++), cursor(++),
curve(++), demo(++), doublebuffer(++), editor(++), fast_slow(++),
file_chooser(++), fonts(++), forms(++), fractals(++), fullscreen(++),
gl_overlay(++), glpuzzle(++), hello(++), help(++), iconize(++), image(+),
inactive(++), input(++), keyboard(+), label(++), line_style(+),
mandelbrot(++), menubar(++), message(++), minimum(++), navigation(++),
output(++), overlay(-), pack(++), pixmap(++), pixmap_browser(++),
radio(++), resizebox(++), scroll(++), shape(++), shiny(-), subwindow(++),
symbols(++), tabs(++), tile(++), tiled_image(++), valuators(++),
fluid(++)
(o)=minor bugs, (+)=usable, (++)=running perfectly, (-)=major
bugs, (--)=crashes
other stuff
-----------
The following creator ID's 'FLTK', 'Fltk', 'FLID' and 'Flid' are
officially registered with Apple Computers and can be used for
FLTK applications ('FLTK') and fluid files ('Flid').
All applications should be ended with exit(0); or they might
hang until killed.
Under OS X, all windows are doublebuffered anyway. Using Fl_Window
has the same effect as using Fl_Double_Window on OS X.
FLTK 1.0.x for Mac
------------------
FLTK 1.0.6 for Mac OS 8.x and OS 9.x is in beta stage and can be
downloaded from http://www.matthiasm.com/fltk/mac.shtml. The
archive contains build files for Metrowerks CodeWarrior 5 and 6.
FLTK 1.0.6 for Mac is not supported by the FLTK team and will not
be further developed by the author. Instead it will be replaced
by FLTK 1.1.x for Mac in the near future.