summaryrefslogtreecommitdiff
path: root/documentation/osissues.html
diff options
context:
space:
mode:
authorMatthias Melcher <fltk@matthiasm.com>2001-12-12 07:50:37 +0000
committerMatthias Melcher <fltk@matthiasm.com>2001-12-12 07:50:37 +0000
commit0ee1fb7b1b99bae2930c612fb2ac753c5ce9b468 (patch)
tree2dc3445067bc7ac3392ccada751b6accabd70df2 /documentation/osissues.html
parent96d499704a4ce48eb914054ccb2334fb5aaf8ccb (diff)
Added Carbon event handling for Mac OS X gaining support for the
Mose Wheel, Key Modifiers, etc. . Added some documentation (please check: English is not my native language) Changed line pattern to look a little nicer. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@1835 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'documentation/osissues.html')
-rw-r--r--documentation/osissues.html32
1 files changed, 32 insertions, 0 deletions
diff --git a/documentation/osissues.html b/documentation/osissues.html
index c52c1d615..f67016058 100644
--- a/documentation/osissues.html
+++ b/documentation/osissues.html
@@ -373,4 +373,36 @@ feature, not a bug. </P>
<P><TT>SetCapture</TT> (used by <TT>Fl::grab()</TT>) doesn't work, and
the main window title bar turns gray while menus are popped up. </P>
<P>FLUID does not support BMP files yet. </P>
+
+<H2>MacOS-specific interface</h2>
+FLTK supports MacOS 8.6, MacOS 9 and Mac OS X using the Apple Carbon library.
+When compiled with MPW or MetroWerks' CodeWarrior, application binaries in CFM format will
+run on all the above systems without changes.
+OS X's 'gcc' however creates Mach-O binaries which are not supported by
+MacOS 9 and earlier.
+<br>
+<PRE>#include &lt;FL/x.H&gt;</PRE>
+The <tt>&lt;FL/x.H&gt;</tt> header file defines the interface to FLTK's MacOS-specific
+functions. Be warned that some of the structures and calls in it are
+subject to change in future version of FLTK. Try to avoid doing this
+so your code is portable.
+<H4>WindowRef fl_xid(const Fl_Window *)</h4>
+Returns the window reference for an <tt>Fl_Window</tt>, or NULL if not shown.
+<h4>Fl_Window *fl_find(WindowRef xid)</h4>
+Return the <tt>Fl_Window</tt> that corresponds to the give window hande, or NULL if not found. FLTK Windows that are children of top-level windows share the WindowRef
+with the top-level window.
+<h3>Drawing Things Using QuickDraw</h3>
+When the virtual function <tt>Fl_Widget::draw()</tt> is called, FLTK has prepared
+the Window and CGrafPort for drawing. Clipping and offsets are prepared to allow
+correct subwindow drawing.
+<br><br>
+OS X doublebuffers all windows automatically. On OS X <tt>Fl_Window</tt> and
+<tt>Fl_Double_Window</tt> are handled internally in the same way.
+<h3>Mac File System Specifics</h3>
+<h4>Resource Forks</h4>
+FLTK does not access the resource fork of an application. However, a minimal
+resource fork must be created for OS 8 and OS X applications.
+<h4>Mac File Paths</h4>
+FLTK uses Unix-style filenames and paths.
+
</BODY></HTML>