FLTK 1.3.4
mac.H
Go to the documentation of this file.
1 //
2 // "$Id: mac.H 12021 2016-10-08 05:59:14Z manolo $"
3 //
4 // Mac header file for the Fast Light Tool Kit (FLTK).
5 //
6 // Copyright 1998-2016 by Bill Spitzak and others.
7 //
8 // This library is free software. Distribution and use rights are outlined in
9 // the file "COPYING" which should have been included with this file. If this
10 // file is missing or damaged, see the license at:
11 //
12 // http://www.fltk.org/COPYING.php
13 //
14 // Please report all bugs and problems on the following page:
15 //
16 // http://www.fltk.org/str.php
17 //
18 
19 // Do not directly include this file, instead use <FL/x.H>. It will
20 // include this file if "__APPLE__" is defined. This is to encourage
21 // portability of even the system-specific code...
22 #ifndef FL_DOXYGEN
23 
24 #if !defined(Fl_X_H)
25 # error "Never use <FL/mac.H> directly; include <FL/x.H> instead."
26 #endif // !Fl_X_H
27 
28 #ifdef __OBJC__
29 @class FLWindow; // a subclass of the NSWindow Cocoa class
30 typedef FLWindow *Window;
31 #else
32 typedef class FLWindow *Window; // pointer to the FLWindow objective-c class
33 #endif // __OBJC__
34 
35 #if !(defined(FL_LIBRARY) || defined(FL_INTERNALS)) // this part is used when compiling an application program
36 # include <FL/Fl_Widget.H>
37 
38 typedef struct flCocoaRegion* Fl_Region;
39 typedef struct CGContext* CGContextRef;
40 typedef struct OpaquePMPrintSettings* PMPrintSettings;
41 typedef struct OpaquePMPageFormat* PMPageFormat;
42 typedef struct OpaquePMPrintSession* PMPrintSession;
43 typedef struct CGImage* CGImageRef;
44 typedef struct __CFData* CFMutableDataRef; // used in Fl_Copy_Surface.H
45 typedef CGContextRef Fl_Offscreen;
46 
47 #else // this part must be compiled when building the FLTK libraries
48 
49 // Standard MacOS C/C++ includes...
50 #include <ApplicationServices/ApplicationServices.h>
51 #undef check // because of Fl::check()
52 
53 #ifndef MAC_OS_X_VERSION_10_4
54 #define MAC_OS_X_VERSION_10_4 1040
55 #endif
56 #ifndef MAC_OS_X_VERSION_10_5
57 #define MAC_OS_X_VERSION_10_5 1050
58 #endif
59 #ifndef MAC_OS_X_VERSION_10_6
60 #define MAC_OS_X_VERSION_10_6 1060
61 #endif
62 #ifndef MAC_OS_X_VERSION_10_7
63 #define MAC_OS_X_VERSION_10_7 1070
64 #endif
65 #ifndef MAC_OS_X_VERSION_10_8
66 #define MAC_OS_X_VERSION_10_8 1080
67 #endif
68 #ifndef MAC_OS_X_VERSION_10_9
69 #define MAC_OS_X_VERSION_10_9 1090
70 #endif
71 #ifndef MAC_OS_X_VERSION_10_10
72 #define MAC_OS_X_VERSION_10_10 101000
73 #endif
74 #ifndef MAC_OS_X_VERSION_10_11
75 #define MAC_OS_X_VERSION_10_11 101100
76 #endif
77 #ifndef MAC_OS_X_VERSION_10_12
78 #define MAC_OS_X_VERSION_10_12 101200
79 #endif
80 
81 #ifndef NSINTEGER_DEFINED // appears with 10.5 in NSObjCRuntime.h
82 #if defined(__LP64__) && __LP64__
83 typedef long NSInteger;
84 typedef unsigned long NSUInteger;
85 #else
86 typedef int NSInteger;
87 typedef unsigned int NSUInteger;
88 #endif
89 #endif
90 
91 #ifdef __OBJC__
92 @class NSCursor;
93 @class NSOpenGLPixelFormat;
94 @class NSOpenGLContext;
95 #else
96 class NSCursor;
97 class NSOpenGLPixelFormat;
98 class NSOpenGLContext;
99 #endif // __OBJC__
100 
101 typedef CGContextRef Fl_Offscreen;
102 #if MAC_OS_X_VERSION_MAX_ALLOWED < MAC_OS_X_VERSION_10_4
103 typedef CGImageAlphaInfo CGBitmapInfo;
104 #endif
105 
106 typedef struct flCocoaRegion {
107  int count;
108  CGRect *rects;
109 } *Fl_Region; // a region is the union of a series of rectangles
110 
111 # include "Fl_Window.H"
112 # include "../src/Fl_Font.H"
113 
114 // Some random X equivalents
115 struct XPoint { int x, y; };
116 struct XRectangle {int x, y, width, height;};
117 #ifndef CGFLOAT_DEFINED //appears with 10.5 in CGBase.h
118 #if defined(__LP64__) && __LP64__
119 typedef double CGFloat;
120 #else
121 typedef float CGFloat;
122 #endif
123 #endif // CGFLOAT_DEFINED
124 
125 extern CGRect fl_cgrectmake_cocoa(int x, int y, int w, int h);
126 inline Fl_Region XRectangleRegion(int x, int y, int w, int h) {
127  Fl_Region R = (Fl_Region)malloc(sizeof(*R));
128  R->count = 1;
129  R->rects = (CGRect *)malloc(sizeof(CGRect));
130  *(R->rects) = fl_cgrectmake_cocoa(x, y, w, h);
131  return R;
132 }
133 inline void XDestroyRegion(Fl_Region r) {
134  if(r) {
135  free(r->rects);
136  free(r);
137  }
138 }
139 extern NSCursor *fl_default_cursor;
140 
141 // This object contains all mac-specific stuff about a window:
142 // WARNING: this object is highly subject to change!
143 class Fl_X {
144 
145 public:
146  Window xid; // pointer to the Cocoa window object (FLWindow*)
147  Fl_Offscreen other_xid; // pointer for offscreen bitmaps (overlay window)
148  Fl_Window *w; // FLTK window for
149  Fl_Region region;
150 #if FLTK_ABI_VERSION < 10304
151  Fl_Region subRegion; // for ABI compatibility, recycled to replace subRect_
152 #endif
153  Fl_X *next; // chain of mapped windows
154 #if FLTK_ABI_VERSION < 10304
155  Fl_X *xidChildren; // useless with true subwindows, recycled to replace mapped_to_retina_
156  Fl_X *xidNext; // useless with true subwindows
157 #endif
158  int wait_for_expose;
159  NSCursor *cursor;
160  static Fl_X* first;
161  static Fl_X* i(const Fl_Window* w) {return w->i;}
162  static int fake_X_wm(const Fl_Window*,int&,int&,int&,int&,int&);
163  static void make(Fl_Window*);
164  void flush();
165  static void set_high_resolution(bool);
166 #if FLTK_ABI_VERSION >= 10304
167  CGRect* subRect() { return subRect_; } // getter
168  void subRect(CGRect *r) { subRect_ = r; } // setter
169 #else
170  CGRect* subRect() { return (CGRect*)subRegion; } // getter
171  void subRect(CGRect *r) { subRegion = (Fl_Region)r; } // setter
172 #endif
173  bool mapped_to_retina(); // is window mapped to retina display?
174  void mapped_to_retina(bool); // sets whether window is mapped to retina display
175  bool changed_resolution(); // did window just moved to display with another resolution?
176  void changed_resolution(bool);// sets whether window just moved to display with another resolution
177  bool in_windowDidResize(); // is window performing windowDidResize?
178  void in_windowDidResize(bool); // sets whether window is performing windowDidResize
179  // Quartz additions:
180  CGContextRef gc; // graphics context (NULL when using QD)
181  static void q_fill_context(); // fill a Quartz context with current FLTK state
182  static void q_clear_clipping(); // remove all clipping from a Quartz context
183  static void q_release_context(Fl_X *x=0); // free all resources associated with fl_gc
184  static void q_begin_image(CGRect&, int x, int y, int w, int h);
185  static void q_end_image();
186  // Cocoa additions
187  static NSOpenGLPixelFormat *mode_to_NSOpenGLPixelFormat(int mode, const int*); // computes NSOpenGLPixelFormat from Gl window's mode
188  static NSOpenGLContext* create_GLcontext_for_window(NSOpenGLPixelFormat *pixelformat, NSOpenGLContext *shared_ctx, Fl_Window *window);
189  static void GLcontext_update(NSOpenGLContext*);
190  static void GLcontext_flushbuffer(NSOpenGLContext*);
191  static void GLcontext_release(NSOpenGLContext*);
192  static void GLcontext_makecurrent(NSOpenGLContext*);
193  static void GL_cleardrawable(void);
194  void destroy(void);
195  void map(void);
196  void unmap(void);
197  void collapse(void);
198  WindowRef window_ref(void); // useless with cocoa GL windows
199  void set_key_window(void);
200  // OS X doesn't have per window icons
201  static void set_default_icons(const Fl_RGB_Image*[], int) {};
202  void set_icons() {};
203  int set_cursor(Fl_Cursor);
204  int set_cursor(const Fl_RGB_Image*, int, int);
205  static CGImageRef CGImage_from_window_rect(Fl_Window *win, int x, int y, int w, int h);
206  static unsigned char *bitmap_from_window_rect(Fl_Window *win, int x, int y, int w, int h, int *bytesPerPixel);
207  static Fl_Region intersect_region_and_rect(Fl_Region current, int x,int y,int w, int h);
208  static void *get_carbon_function(const char *name);
209  static void screen_work_area(int &X, int &Y, int &W, int &H, int n); // compute work area of a given screen
210  static int next_marked_length; // next length of marked text after current marked text will have been replaced
211  static int insertion_point_location(int *px, int *py, int *pheight); // computes window coordinates & height of insertion point
212  static const int CoreText_threshold; // Mac OS version from which the Core Text API is used to display text
213  static Fl_Fontdesc* calc_fl_fonts(void); // computes the fl_fonts global variable
214  static int dnd(int use_selection); // call Fl_X::dnd(1) to support text dragging
215  static int calc_mac_os_version(void); // computes the fl_mac_os_version global variable
216  static void clip_to_rounded_corners(CGContextRef gc, int w, int h);
217  static void *get_titlebar_layer(Fl_Window *win);
218  static void draw_layer_to_context(void *layer, CGContextRef ctxt, int w, int h);
219 private:
220 #if FLTK_ABI_VERSION >= 10304
221  CGRect* subRect_; // makes sure subwindow remains inside its parent window
222  // stores 3 binary flags: whether window is mapped to retina display; whether resolution just changed;
223  // whether window is OpenGL and is currently being resized.
224  unsigned mapped_to_retina_;
225 #else
226  bool subwindow; // for ABI compatibility, useless with true subwindows
227 #endif
228 };
229 
230 extern Window fl_window;
231 
232 #endif // FL_LIBRARY || FL_INTERNALS
233 
234 typedef CGImageRef Fl_Bitmask;
235 
236 extern CGContextRef fl_gc;
237 
238 extern Window fl_xid(const Fl_Window*);
239 extern Fl_Window* fl_find(Window xid);
240 void fl_clip_region(Fl_Region);
241 
242 extern Fl_Bitmask fl_create_bitmask(int w, int h, const uchar *data);
243 extern Fl_Bitmask fl_create_alphamask(int w, int h, int d, int ld, const uchar *data);
244 extern void fl_delete_bitmask(Fl_Bitmask bm);
245 extern Fl_Offscreen fl_create_offscreen(int w, int h);
246 extern void fl_copy_offscreen(int x,int y,int w,int h, Fl_Offscreen gWorld, int srcx,int srcy);
247 extern void fl_delete_offscreen(Fl_Offscreen gWorld);
248 extern void fl_begin_offscreen(Fl_Offscreen gWorld);
249 extern void fl_end_offscreen();
250 
251 extern int fl_parse_color(const char* p, uchar& r, uchar& g, uchar& b);
252 extern void fl_open_display();
253 
254 #endif // FL_DOXYGEN
255 
268 extern void fl_open_callback(void (*cb)(const char *));
269 
278 extern void fl_mac_set_about( Fl_Callback *cb, void *user_data, int shortcut = 0);
279 
282 extern int fl_mac_os_version;
283 
286 extern class Fl_Sys_Menu_Bar *fl_sys_menu_bar;
287 
288 struct Fl_Menu_Item;
289 
291 public:
293  static const char *about;
298  static const char *print;
300  static const char *services;
302  static const char *hide;
304  static const char *hide_others;
306  static const char *show;
308  static const char *quit;
309  static void custom_application_menu_items(const Fl_Menu_Item *m);
310 };
311 
314 //
315 // End of "$Id: mac.H 12021 2016-10-08 05:59:14Z manolo $".
316 //
317 
This widget produces an actual window.
Definition: Fl_Window.H:57
Fl_Cursor
The following constants define the mouse cursors that are available in FLTK.
Definition: Enumerations.H:1048
void fl_clip_region(Fl_Region r)
Replaces the top of the clipping stack with a clipping region of any shape.
Definition: fl_draw.H:136
Mac OS-specific class allowing to customize and localize the application menu.
Definition: mac.H:290
static const char * services
Localizable text for the "Services" application menu item.
Definition: mac.H:300
void fl_delete_offscreen(Fl_Offscreen ctx)
Deletion of an offscreen graphics buffer.
Definition: Fl_Double_Window.cxx:328
void fl_open_callback(void(*cb)(const char *))
Register a function called for each file dropped onto an application icon.
static const char * show
Localizable text for the "Show All" application menu item.
Definition: mac.H:306
void fl_begin_offscreen(Fl_Offscreen ctx)
Send all subsequent drawing commands to this offscreen buffer.
Definition: Fl_Double_Window.cxx:345
The Fl_RGB_Image class supports caching and drawing of full-color images with 1 to 4 channels of colo...
Definition: Fl_Image.H:202
class Fl_Sys_Menu_Bar * fl_sys_menu_bar
The system menu bar.
Definition: Fl_Sys_Menu_Bar.mm:50
Fl_Offscreen fl_create_offscreen(int w, int h)
Creation of an offscreen graphics buffer.
Definition: Fl_Double_Window.cxx:287
void( Fl_Callback)(Fl_Widget *, void *)
Default callback type definition for all fltk widgets (by far the most used)
Definition: Fl_Widget.H:49
Fl_Window widget .
Fl_Widget, Fl_Label classes .
A class to create, modify and delete menus that appear on Mac OS X in the menu bar at the top of the ...
Definition: Fl_Sys_Menu_Bar.H:48
static void custom_application_menu_items(const Fl_Menu_Item *m)
Adds custom menu item(s) to the application menu of the system menu bar.
Definition: Fl_Sys_Menu_Bar.mm:516
static const char * about
Localizable text for the "About xxx" application menu item.
Definition: mac.H:293
static const char * hide_others
Localizable text for the "Hide Others" application menu item.
Definition: mac.H:304
The Fl_Menu_Item structure defines a single menu item that is used by the Fl_Menu_ class...
Definition: Fl_Menu_Item.H:112
static const char * print
Localizable text for the "Print Front Window" application menu item.
Definition: mac.H:298
Definition: Fl_Font.H:86
int fl_mac_os_version
The version number of the running Mac OS X (e.g., 100604 for 10.6.4)
void fl_mac_set_about(Fl_Callback *cb, void *user_data, int shortcut=0)
Attaches a callback to the "About myprog" item of the system application menu.
Definition: Fl_Sys_Menu_Bar.mm:198
void fl_copy_offscreen(int x, int y, int w, int h, Fl_Offscreen pixmap, int srcx, int srcy)
Copy a rectangular area of the given offscreen buffer into the current drawing destination.
Definition: Fl_Double_Window.cxx:94
unsigned char uchar
unsigned char
Definition: fl_types.h:30
static const char * quit
Localizable text for the "Quit xxx" application menu item.
Definition: mac.H:308
void fl_end_offscreen()
Quit sending drawing commands to the current offscreen buffer.
Definition: Fl_Double_Window.cxx:363
static const char * hide
Localizable text for the "Hide xxx" application menu item.
Definition: mac.H:302