From 0ee1fb7b1b99bae2930c612fb2ac753c5ce9b468 Mon Sep 17 00:00:00 2001 From: Matthias Melcher Date: Wed, 12 Dec 2001 07:50:37 +0000 Subject: 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 --- documentation/drawing.html | 4 ++-- documentation/intro.html | 8 ++++---- documentation/osissues.html | 32 ++++++++++++++++++++++++++++++++ documentation/preface.html | 8 ++++++-- 4 files changed, 44 insertions(+), 8 deletions(-) (limited to 'documentation') diff --git a/documentation/drawing.html b/documentation/drawing.html index 30a359247..dee747871 100644 --- a/documentation/drawing.html +++ b/documentation/drawing.html @@ -141,7 +141,7 @@ values. These are mapped to the closest color supported by the screen, either from one of the 256 colors in the FLTK 1.0.x colormap or a direct RGB value on TrueColor screens. You can generate 24-bit RGB color values using the fl_rgb_color() +HREF="functions.html#fl_rgb_color">fl_rgb_color() function.

void fl_color(Fl_Color)

@@ -770,7 +770,7 @@ for example.

virtual void copy();
virtual void copy(int w, int h);

-

The copy() method creates a copy of the image. The second form +

The copy() method creates a copy of the image. The second form specifies the new size of the image - the image is resized using the nearest-neighbor algorithm. diff --git a/documentation/intro.html b/documentation/intro.html index 7cc70753a..ba1af584b 100644 --- a/documentation/intro.html +++ b/documentation/intro.html @@ -98,12 +98,12 @@ is now included with several Linux distributions.

  • The FLUID program (which includes every widget) is 538k.
    • -
  • Written directly atop Xlib (or WIN32) for maximum +
  • Written directly atop core libraries (Xlib, WIN32 or Carbon) for maximum speed, and carefully optimized for code size and performance.
    • -
  • Precise low-level compatability between the X11 and - WIN32 version - only about 10% of the code is +
  • Precise low-level compatability between the X11, + WIN32 and MacOS version - only about 10% of the code is different.
  • Interactive user interface builder program. Output is @@ -113,7 +113,7 @@ is now included with several Linux distributions.

    is available.
  • Very small & fast portable 2-D drawing library - to hide Xlib and WIN32.
    • + to hide Xlib, WIN32 or QuickDraw.
  • OpenGL/Mesa drawing area widget.
    • 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.

    SetCapture (used by Fl::grab()) doesn't work, and the main window title bar turns gray while menus are popped up.

    FLUID does not support BMP files yet.

    + +

    MacOS-specific interface

    +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. +
    +
    #include <FL/x.H>
    +The <FL/x.H> 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. +

    WindowRef fl_xid(const Fl_Window *)

    +Returns the window reference for an Fl_Window, or NULL if not shown. +

    Fl_Window *fl_find(WindowRef xid)

    +Return the Fl_Window 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. +

    Drawing Things Using QuickDraw

    +When the virtual function Fl_Widget::draw() is called, FLTK has prepared +the Window and CGrafPort for drawing. Clipping and offsets are prepared to allow +correct subwindow drawing. +

    +OS X doublebuffers all windows automatically. On OS X Fl_Window and +Fl_Double_Window are handled internally in the same way. +

    Mac File System Specifics

    +

    Resource Forks

    +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. +

    Mac File Paths

    +FLTK uses Unix-style filenames and paths. + diff --git a/documentation/preface.html b/documentation/preface.html index 11f10a245..c75012c47 100644 --- a/documentation/preface.html +++ b/documentation/preface.html @@ -11,7 +11,7 @@

    This manual describes the Fast Light Tool Kit ("FLTK") version 1.1.0, a C++ Graphical User Interface -("GUI") toolkit for UNIX and Microsoft Windows. Each +("GUI") toolkit for UNIX, Microsoft Windows and MacOS. Each of the chapters in this manual is designed as a tutorial for using FLTK, while the appendices provide a convenient reference for all FLTK widgets, functions, and operating system @@ -88,6 +88,9 @@ interfaces.

    WIN32
    The Microsoft Windows 32-bit Application Programmer's Interface.
    +
    MacOS
    +
    The Apple Macintosh OS 8.6 and later, including OS X.
    +

    Copyrights and Trademarks

    @@ -98,7 +101,8 @@ License, located in Appendix G.

    UNIX is a registered trademark of the X Open Group, Inc. Microsoft and Windows are registered trademarks of Microsoft Corporation. OpenGL -is a registered trademark of Silicon Graphics, Inc.

    +is a registered trademark of Silicon Graphics, Inc. . Apple, Macintosh, +MacOS and Mac OS X are registered trademarks of Apple Computer, Inc. .

    -- cgit v1.2.3