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)
159 typedef struct _XImage
161 int width
, height
; /* size of image */
162 char *data
; /* pointer to image data */
163 int bytes_per_line
; /* accelarator to next line */
164 int bits_per_pixel
; /* bits per pixel (ZPixmap) */
167 typedef GWorldPtr Pixmap
;
170 #define Cursor ThemeCursor
171 #define No_Cursor (-1)
173 #define FACE_DEFAULT (~0)
175 #if !TARGET_API_MAC_CARBON
176 #define GetPixDepth(pmh) ((*(pmh))->pixelSize)
180 /* Emulate XCharStruct. */
181 /* If the sum of ascent and descent is negative, that means some
182 special status specified by enum pcm_status. */
183 typedef struct _XCharStruct
185 short lbearing
; /* origin to left edge of raster */
186 short rbearing
; /* origin to right edge of raster */
187 short width
; /* advance to next char's origin */
188 short ascent
; /* baseline to top edge of raster */
189 short descent
; /* baseline to bottom edge of raster */
191 unsigned short attributes
; /* per char flags (not predefined) */
197 PCM_VALID
= 0, /* pcm data is valid */
198 PCM_INVALID
= -1, /* pcm data is invalid */
201 #define STORE_XCHARSTRUCT(xcs, w, bds) \
202 ((xcs).width = (w), \
203 (xcs).lbearing = (bds).left, \
204 (xcs).rbearing = (bds).right, \
205 (xcs).ascent = -(bds).top, \
206 (xcs).descent = (bds).bottom)
208 struct MacFontStruct
{
211 short mac_fontnum
; /* font number of font used in this window */
212 int mac_fontsize
; /* size of font */
213 short mac_fontface
; /* plain, bold, italics, etc. */
214 #if TARGET_API_MAC_CARBON
215 int mac_scriptcode
; /* Mac OS script code for font used */
217 short mac_scriptcode
; /* Mac OS script code for font used */
220 ATSUStyle mac_style
; /* NULL if QuickDraw Text is used */
221 #if USE_CG_TEXT_DRAWING
222 CGFontRef cg_font
; /* NULL if ATSUI text drawing is used */
223 CGGlyph
*cg_glyphs
; /* Likewise */
229 XExtData
*ext_data
; /* hook for extension to hang data */
230 Font fid
; /* Font id for this font */
231 unsigned direction
; /* hint about the direction font is painted */
233 unsigned min_char_or_byte2
;/* first character */
234 unsigned max_char_or_byte2
;/* last character */
235 unsigned min_byte1
; /* first row that exists */
236 unsigned max_byte1
; /* last row that exists */
238 Bool all_chars_exist
; /* flag if all characters have nonzero size */
239 unsigned default_char
; /* char to print for undefined character */
240 int n_properties
; /* how many properties there are */
241 XFontProp
*properties
; /* pointer to array of additional properties */
243 XCharStruct min_bounds
; /* minimum bounds over all existing char */
244 XCharStruct max_bounds
; /* maximum bounds over all existing char */
246 XCharStruct
*per_char
; /* first_char to last_char information */
247 XCharStruct
**rows
; /* first row to last row information */
249 int ascent
; /* logical extent above baseline for spacing */
250 int descent
; /* logical decent below baseline for spacing */
253 typedef struct MacFontStruct MacFontStruct
;
254 typedef struct MacFontStruct XFontStruct
;
256 /* Structure borrowed from Xlib.h to represent two-byte characters. */
263 #define STORE_XCHAR2B(chp, b1, b2) \
264 ((chp)->byte1 = (b1), (chp)->byte2 = (b2))
266 #define XCHAR2B_BYTE1(chp) \
269 #define XCHAR2B_BYTE2(chp) \
273 /* Emulate X GC's by keeping color and font info in a structure. */
274 typedef struct _XGCValues
276 unsigned long foreground
;
277 unsigned long background
;
283 /* Original value. */
286 /* Cached data members follow. */
288 /* QuickDraw foreground color. */
291 /* QuickDraw background color. */
294 #if USE_CG_DRAWING && MAC_OS_X_VERSION_MAX_ALLOWED >= 1030
295 /* Quartz 2D foreground color. */
296 CGColorRef cg_fore_color
;
298 /* Quartz 2D background color. */
299 CGColorRef cg_back_color
;
302 #define MAX_CLIP_RECTS 2
303 /* Number of clipping rectangles. */
306 /* QuickDraw clipping region. Ignored if n_clip_rects == 0. */
307 RgnHandle clip_region
;
309 #if defined (MAC_OSX) && (USE_ATSUI || USE_CG_DRAWING)
310 /* Clipping rectangles used in Quartz 2D drawing. The y-coordinate
311 is in QuickDraw's. */
312 CGRect clip_rects
[MAX_CLIP_RECTS
];
316 #define GCForeground (1L<<2)
317 #define GCBackground (1L<<3)
318 #define GCFont (1L<<14)
319 #define GCGraphicsExposures 0
323 #define ForgetGravity 0
324 #define NorthWestGravity 1
325 #define NorthGravity 2
326 #define NorthEastGravity 3
327 #define WestGravity 4
328 #define CenterGravity 5
329 #define EastGravity 6
330 #define SouthWestGravity 7
331 #define SouthGravity 8
332 #define SouthEastGravity 9
333 #define StaticGravity 10
335 #define NoValue 0x0000
336 #define XValue 0x0001
337 #define YValue 0x0002
338 #define WidthValue 0x0004
339 #define HeightValue 0x0008
340 #define AllValues 0x000F
341 #define XNegative 0x0010
342 #define YNegative 0x0020
345 long flags
; /* marks which fields in this structure are defined */
347 int x
, y
; /* obsolete for new window mgrs, but clients */
348 int width
, height
; /* should set so old wm's don't mess up */
350 int min_width
, min_height
;
352 int max_width
, max_height
;
354 int width_inc
, height_inc
;
357 int x
; /* numerator */
358 int y
; /* denominator */
359 } min_aspect
, max_aspect
;
361 int base_width
, base_height
; /* added by ICCCM version 1 */
363 int win_gravity
; /* added by ICCCM version 1 */
367 #define USPosition (1L << 0) /* user specified x, y */
368 #define USSize (1L << 1) /* user specified width, height */
370 #define PPosition (1L << 2) /* program specified position */
371 #define PSize (1L << 3) /* program specified size */
372 #define PMinSize (1L << 4) /* program specified minimum size */
373 #define PMaxSize (1L << 5) /* program specified maximum size */
374 #define PResizeInc (1L << 6) /* program specified resize increments */
375 #define PAspect (1L << 7) /* program specified min and max aspect ratios */
376 #define PBaseSize (1L << 8) /* program specified base for incrementing */
377 #define PWinGravity (1L << 9) /* program specified window gravity */
381 unsigned width
, height
;
384 #define NativeRectangle Rect
386 #define CONVERT_TO_XRECT(xr,nr) \
387 ((xr).x = (nr).left, \
389 (xr).width = ((nr).right - (nr).left), \
390 (xr).height = ((nr).bottom - (nr).top))
392 #define CONVERT_FROM_XRECT(xr,nr) \
393 ((nr).left = (xr).x, \
395 (nr).right = ((xr).x + (xr).width), \
396 (nr).bottom = ((xr).y + (xr).height))
398 #define STORE_NATIVE_RECT(nr,x,y,width,height) \
401 (nr).right = ((nr).left + (width)), \
402 (nr).bottom = ((nr).top + (height)))
404 /* Definitions copied from lwlib.h */
406 typedef void * XtPointer
;
415 /* This structure is based on the one in ../lwlib/lwlib.h, modified
417 typedef struct _widget_value
422 /* value (meaning depend on widget type) */
424 /* keyboard equivalent. no implications for XtTranslations */
427 /* Help string or nil if none.
428 GC finds this string through the frame's menu_bar_vector
429 or through menu_items. */
431 /* true if enabled */
433 /* true if selected */
435 /* The type of a button. */
436 enum button_type button_type
;
437 /* true if menu title */
440 /* true if was edited (maintained by get_value) */
442 /* true if has changed (maintained by lw library) */
444 /* true if this widget itself has changed,
445 but not counting the other widgets found in the `next' field. */
446 change_type this_one_change
;
448 /* Contents of the sub-widgets, also selected slot for checkbox */
449 struct _widget_value
* contents
;
450 /* data passed to callback */
452 /* next one in the list */
453 struct _widget_value
* next
;
455 /* slot for the toolkit dependent part. Always initialize to NULL. */
457 /* tell us if we should free the toolkit data slot when freeing the
458 widget_value itself. */
459 Boolean free_toolkit_data
;
461 /* we resource the widget_value structures; this points to the next
462 one on the free list if this one has been deallocated.
464 struct _widget_value
*free_list
;
472 #define EXTRA_STACK_ALLOC (256 * 1024)
474 #define ARGV_STRING_LIST_ID 129
475 #define RAM_TOO_LARGE_ALERT_ID 129
476 #define ABOUT_ALERT_ID 128
479 #define DIALOG_LEFT_MARGIN (112)
480 #define DIALOG_TOP_MARGIN (24)
481 #define DIALOG_RIGHT_MARGIN (24)
482 #define DIALOG_BOTTOM_MARGIN (20)
483 #define DIALOG_MIN_INNER_WIDTH (338)
484 #define DIALOG_MAX_INNER_WIDTH (564)
485 #define DIALOG_BUTTON_BUTTON_HORIZONTAL_SPACE (12)
486 #define DIALOG_BUTTON_BUTTON_VERTICAL_SPACE (12)
487 #define DIALOG_BUTTON_MIN_WIDTH (68)
488 #define DIALOG_TEXT_MIN_HEIGHT (50)
489 #define DIALOG_TEXT_BUTTONS_VERTICAL_SPACE (10)
490 #define DIALOG_ICON_WIDTH (64)
491 #define DIALOG_ICON_HEIGHT (64)
492 #define DIALOG_ICON_LEFT_MARGIN (24)
493 #define DIALOG_ICON_TOP_MARGIN (15)
495 #endif /* EMACS_MACGUI_H */
497 /* arch-tag: 5a0da49a-35e2-418b-a58c-8a55778ae849
498 (do not change this comment) */