1 /* Definitions and headers for communication on the Mac OS.
2 Copyright (C) 2000, 2001, 2002, 2003, 2004,
3 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 /* Contributed by Andrew Choi (akochoi@mac.com). */
24 #ifndef EMACS_MACGUI_H
25 #define EMACS_MACGUI_H
27 typedef struct _XDisplay Display
; /* opaque */
29 typedef Lisp_Object XrmDatabase
;
31 typedef unsigned long Time
;
36 #if ! HAVE_MKTIME || BROKEN_MKTIME
43 /* Macros max and min defined in lisp.h conflict with those in
44 precompiled header Carbon.h. */
48 #include <Carbon/Carbon.h>
49 #if ! HAVE_MKTIME || BROKEN_MKTIME
51 #define mktime emacs_mktime
54 #define free unexec_free
56 #define malloc unexec_malloc
58 #define realloc unexec_realloc
60 #define min(a, b) ((a) < (b) ? (a) : (b))
62 #define max(a, b) ((a) > (b) ? (a) : (b))
64 #define init_process emacs_init_process
66 #else /* not MAC_OSX */
70 #endif /* not MAC_OSX */
72 #define Z (current_buffer->text->z)
73 #else /* not HAVE_CARBON */
74 #include <Quickdraw.h> /* for WindowRef */
75 #include <QDOffscreen.h> /* for GWorldPtr */
76 #include <Appearance.h> /* for ThemeCursor */
80 #endif /* not HAVE_CARBON */
82 /* Whether to use ATSUI (Apple Type Services for Unicode Imaging) for
84 #if 0 /* Don't enable by default on the emacs-unicode-2 branch. */
92 /* Whether to use low-level Quartz 2D (aka Core Graphics) text drawing
93 in preference to ATSUI for ASCII and Latin-1 characters. */
94 #ifndef USE_CG_TEXT_DRAWING
95 #if USE_ATSUI && MAC_OS_X_VERSION_MAX_ALLOWED >= 1030
96 #define USE_CG_TEXT_DRAWING 1
100 /* Whether to use Quartz 2D routines for drawing operations other than
102 #ifndef USE_CG_DRAWING
103 #if MAC_OS_X_VERSION_MAX_ALLOWED >= 1020
104 #define USE_CG_DRAWING 1
108 /* Whether to use the standard Font Panel floating dialog. */
109 #ifndef USE_MAC_FONT_PANEL
110 #if USE_ATSUI && MAC_OS_X_VERSION_MAX_ALLOWED >= 1020
111 #define USE_MAC_FONT_PANEL 1
115 /* Whether to use Text Services Manager. */
117 #if TARGET_API_MAC_CARBON
118 #define USE_MAC_TSM 1
122 /* Whether to use HIToolbar. */
123 #ifndef USE_MAC_TOOLBAR
124 #if USE_CG_DRAWING && MAC_OS_X_VERSION_MAX_ALLOWED >= 1030 && MAC_OS_X_VERSION_MIN_REQUIRED != 1020
125 #define USE_MAC_TOOLBAR 1
129 #ifndef CGFLOAT_DEFINED
130 typedef float CGFloat
;
133 typedef WindowRef Window
;
134 #if TARGET_API_MAC_CARBON
135 typedef ScrapRef Selection
;
137 typedef int Selection
;
139 #define mac_set_window_title SetWindowTitleWithCFString
140 #define mac_set_window_modified SetWindowModified
141 #define mac_is_window_visible IsWindowVisible
142 #define mac_is_window_collapsed IsWindowCollapsed
143 #define mac_bring_window_to_front BringToFront
144 #define mac_send_window_behind SendBehind
145 #define mac_hide_window HideWindow
146 #define mac_show_window ShowWindow
147 #define mac_collapse_window CollapseWindow
148 #define mac_front_non_floating_window FrontNonFloatingWindow
149 #define mac_active_non_floating_window ActiveNonFloatingWindow
150 #define mac_activate_window ActivateWindow
151 #define mac_move_window_structure MoveWindowStructure
152 #define mac_move_window MoveWindow
153 #define mac_size_window SizeWindow
154 #define mac_get_global_mouse GetGlobalMouse
155 #define mac_is_window_toolbar_visible IsWindowToolbarVisible
156 #define mac_rect_make(f, x, y, w, h) CGRectMake (x, y, w, h)
157 typedef GWorldPtr Pixmap
;
159 #define Cursor ThemeCursor
160 #define No_Cursor (-1)
162 #define FACE_DEFAULT (~0)
164 #if !TARGET_API_MAC_CARBON
165 #define GetPixDepth(pmh) ((*(pmh))->pixelSize)
169 /* Emulate XCharStruct. */
170 /* If the sum of ascent and descent is negative, that means some
171 special status specified by enum pcm_status. */
172 typedef struct _XCharStruct
174 short lbearing
; /* origin to left edge of raster */
175 short rbearing
; /* origin to right edge of raster */
176 short width
; /* advance to next char's origin */
177 short ascent
; /* baseline to top edge of raster */
178 short descent
; /* baseline to bottom edge of raster */
180 unsigned short attributes
; /* per char flags (not predefined) */
186 PCM_VALID
= 0, /* pcm data is valid */
187 PCM_INVALID
= -1, /* pcm data is invalid */
190 #define STORE_XCHARSTRUCT(xcs, w, bds) \
191 ((xcs).width = (w), \
192 (xcs).lbearing = (bds).left, \
193 (xcs).rbearing = (bds).right, \
194 (xcs).ascent = -(bds).top, \
195 (xcs).descent = (bds).bottom)
197 struct MacFontStruct
{
200 short mac_fontnum
; /* font number of font used in this window */
201 int mac_fontsize
; /* size of font */
202 short mac_fontface
; /* plain, bold, italics, etc. */
203 #if TARGET_API_MAC_CARBON
204 int mac_scriptcode
; /* Mac OS script code for font used */
206 short mac_scriptcode
; /* Mac OS script code for font used */
209 ATSUStyle mac_style
; /* NULL if QuickDraw Text is used */
210 #if USE_CG_TEXT_DRAWING
211 CGFontRef cg_font
; /* NULL if ATSUI text drawing is used */
212 CGGlyph
*cg_glyphs
; /* Likewise */
218 XExtData
*ext_data
; /* hook for extension to hang data */
219 Font fid
; /* Font id for this font */
220 unsigned direction
; /* hint about the direction font is painted */
222 unsigned min_char_or_byte2
;/* first character */
223 unsigned max_char_or_byte2
;/* last character */
224 unsigned min_byte1
; /* first row that exists */
225 unsigned max_byte1
; /* last row that exists */
227 Bool all_chars_exist
; /* flag if all characters have nonzero size */
228 unsigned default_char
; /* char to print for undefined character */
229 int n_properties
; /* how many properties there are */
230 XFontProp
*properties
; /* pointer to array of additional properties */
232 XCharStruct min_bounds
; /* minimum bounds over all existing char */
233 XCharStruct max_bounds
; /* maximum bounds over all existing char */
235 XCharStruct
*per_char
; /* first_char to last_char information */
236 XCharStruct
**rows
; /* first row to last row information */
238 int ascent
; /* logical extent above baseline for spacing */
239 int descent
; /* logical decent below baseline for spacing */
242 typedef struct MacFontStruct MacFontStruct
;
243 typedef struct MacFontStruct XFontStruct
;
245 /* Structure borrowed from Xlib.h to represent two-byte characters. */
252 #define STORE_XCHAR2B(chp, b1, b2) \
253 ((chp)->byte1 = (b1), (chp)->byte2 = (b2))
255 #define XCHAR2B_BYTE1(chp) \
258 #define XCHAR2B_BYTE2(chp) \
262 /* Emulate X GC's by keeping color and font info in a structure. */
263 typedef struct _XGCValues
265 unsigned long foreground
;
266 unsigned long background
;
272 /* Original value. */
275 /* Cached data members follow. */
277 /* QuickDraw foreground color. */
280 /* QuickDraw background color. */
283 #if USE_CG_DRAWING && MAC_OS_X_VERSION_MAX_ALLOWED >= 1030
284 /* Quartz 2D foreground color. */
285 CGColorRef cg_fore_color
;
287 /* Quartz 2D background color. */
288 CGColorRef cg_back_color
;
291 #define MAX_CLIP_RECTS 2
292 /* Number of clipping rectangles. */
295 /* QuickDraw clipping region. Ignored if n_clip_rects == 0. */
296 RgnHandle clip_region
;
298 #if defined (MAC_OSX) && (USE_ATSUI || USE_CG_DRAWING)
299 /* Clipping rectangles used in Quartz 2D drawing. The y-coordinate
300 is in QuickDraw's. */
301 CGRect clip_rects
[MAX_CLIP_RECTS
];
305 #define GCForeground (1L<<2)
306 #define GCBackground (1L<<3)
307 #define GCFont (1L<<14)
308 #define GCGraphicsExposures 0
312 #define ForgetGravity 0
313 #define NorthWestGravity 1
314 #define NorthGravity 2
315 #define NorthEastGravity 3
316 #define WestGravity 4
317 #define CenterGravity 5
318 #define EastGravity 6
319 #define SouthWestGravity 7
320 #define SouthGravity 8
321 #define SouthEastGravity 9
322 #define StaticGravity 10
324 #define NoValue 0x0000
325 #define XValue 0x0001
326 #define YValue 0x0002
327 #define WidthValue 0x0004
328 #define HeightValue 0x0008
329 #define AllValues 0x000F
330 #define XNegative 0x0010
331 #define YNegative 0x0020
334 long flags
; /* marks which fields in this structure are defined */
336 int x
, y
; /* obsolete for new window mgrs, but clients */
337 int width
, height
; /* should set so old wm's don't mess up */
339 int min_width
, min_height
;
341 int max_width
, max_height
;
343 int width_inc
, height_inc
;
346 int x
; /* numerator */
347 int y
; /* denominator */
348 } min_aspect
, max_aspect
;
350 int base_width
, base_height
; /* added by ICCCM version 1 */
352 int win_gravity
; /* added by ICCCM version 1 */
356 #define USPosition (1L << 0) /* user specified x, y */
357 #define USSize (1L << 1) /* user specified width, height */
359 #define PPosition (1L << 2) /* program specified position */
360 #define PSize (1L << 3) /* program specified size */
361 #define PMinSize (1L << 4) /* program specified minimum size */
362 #define PMaxSize (1L << 5) /* program specified maximum size */
363 #define PResizeInc (1L << 6) /* program specified resize increments */
364 #define PAspect (1L << 7) /* program specified min and max aspect ratios */
365 #define PBaseSize (1L << 8) /* program specified base for incrementing */
366 #define PWinGravity (1L << 9) /* program specified window gravity */
370 unsigned width
, height
;
373 #define NativeRectangle Rect
375 #define CONVERT_TO_XRECT(xr,nr) \
376 ((xr).x = (nr).left, \
378 (xr).width = ((nr).right - (nr).left), \
379 (xr).height = ((nr).bottom - (nr).top))
381 #define CONVERT_FROM_XRECT(xr,nr) \
382 ((nr).left = (xr).x, \
384 (nr).right = ((xr).x + (xr).width), \
385 (nr).bottom = ((xr).y + (xr).height))
387 #define STORE_NATIVE_RECT(nr,x,y,width,height) \
390 (nr).right = ((nr).left + (width)), \
391 (nr).bottom = ((nr).top + (height)))
393 /* Definitions copied from lwlib.h */
395 typedef void * XtPointer
;
404 /* This structure is based on the one in ../lwlib/lwlib.h, modified
406 typedef struct _widget_value
411 /* value (meaning depend on widget type) */
413 /* keyboard equivalent. no implications for XtTranslations */
416 /* Help string or nil if none.
417 GC finds this string through the frame's menu_bar_vector
418 or through menu_items. */
420 /* true if enabled */
422 /* true if selected */
424 /* The type of a button. */
425 enum button_type button_type
;
426 /* true if menu title */
429 /* true if was edited (maintained by get_value) */
431 /* true if has changed (maintained by lw library) */
433 /* true if this widget itself has changed,
434 but not counting the other widgets found in the `next' field. */
435 change_type this_one_change
;
437 /* Contents of the sub-widgets, also selected slot for checkbox */
438 struct _widget_value
* contents
;
439 /* data passed to callback */
441 /* next one in the list */
442 struct _widget_value
* next
;
444 /* slot for the toolkit dependent part. Always initialize to NULL. */
446 /* tell us if we should free the toolkit data slot when freeing the
447 widget_value itself. */
448 Boolean free_toolkit_data
;
450 /* we resource the widget_value structures; this points to the next
451 one on the free list if this one has been deallocated.
453 struct _widget_value
*free_list
;
461 #define EXTRA_STACK_ALLOC (256 * 1024)
463 #define ARGV_STRING_LIST_ID 129
464 #define RAM_TOO_LARGE_ALERT_ID 129
465 #define ABOUT_ALERT_ID 128
468 #define DIALOG_LEFT_MARGIN (112)
469 #define DIALOG_TOP_MARGIN (24)
470 #define DIALOG_RIGHT_MARGIN (24)
471 #define DIALOG_BOTTOM_MARGIN (20)
472 #define DIALOG_MIN_INNER_WIDTH (338)
473 #define DIALOG_MAX_INNER_WIDTH (564)
474 #define DIALOG_BUTTON_BUTTON_HORIZONTAL_SPACE (12)
475 #define DIALOG_BUTTON_BUTTON_VERTICAL_SPACE (12)
476 #define DIALOG_BUTTON_MIN_WIDTH (68)
477 #define DIALOG_TEXT_MIN_HEIGHT (50)
478 #define DIALOG_TEXT_BUTTONS_VERTICAL_SPACE (10)
479 #define DIALOG_ICON_WIDTH (64)
480 #define DIALOG_ICON_HEIGHT (64)
481 #define DIALOG_ICON_LEFT_MARGIN (24)
482 #define DIALOG_ICON_TOP_MARGIN (15)
484 #endif /* EMACS_MACGUI_H */
486 /* arch-tag: 5a0da49a-35e2-418b-a58c-8a55778ae849
487 (do not change this comment) */