src/macterm.h

   1 /* Display module for Mac OS.
   2    Copyright (C) 2000, 2001, 2002, 2003, 2004,
   3                  2005, 2006, 2007, 2008 Free Software Foundation, Inc.
   4
   5 This file is part of GNU Emacs.
   6
   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)
  10 any later version.
  11
  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.
  16
  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.  */
  21
  22 /* Contributed by Andrew Choi (akochoi@mac.com).  */
  23
  24 #include "macgui.h"
  25 #include "frame.h"
  26
  27 #define RGB_TO_ULONG(r, g, b) (((r) << 16) | ((g) << 8) | (b))
  28 #define ARGB_TO_ULONG(a, r, g, b) (((a) << 24) | ((r) << 16) | ((g) << 8) | (b))
  29
  30 #define ALPHA_FROM_ULONG(color) ((color) >> 24)
  31 #define RED_FROM_ULONG(color) (((color) >> 16) & 0xff)
  32 #define GREEN_FROM_ULONG(color) (((color) >> 8) & 0xff)
  33 #define BLUE_FROM_ULONG(color) ((color) & 0xff)
  34
  35 /* Do not change `* 0x101' in the following lines to `<< 8'.  If
  36    changed, image masks in 1-bit depth will not work. */
  37 #define RED16_FROM_ULONG(color) (RED_FROM_ULONG(color) * 0x101)
  38 #define GREEN16_FROM_ULONG(color) (GREEN_FROM_ULONG(color) * 0x101)
  39 #define BLUE16_FROM_ULONG(color) (BLUE_FROM_ULONG(color) * 0x101)
  40
  41 #define BLACK_PIX_DEFAULT(f) RGB_TO_ULONG(0,0,0)
  42 #define WHITE_PIX_DEFAULT(f) RGB_TO_ULONG(255,255,255)
  43
  44 #define FONT_WIDTH(f)   ((f)->max_bounds.width)
  45 #define FONT_HEIGHT(f)  ((f)->ascent + (f)->descent)
  46 #define FONT_BASE(f)    ((f)->ascent)
  47 #define FONT_DESCENT(f) ((f)->descent)
  48
  49 /* Structure recording bitmaps and reference count.
  50    If REFCOUNT is 0 then this record is free to be reused.  */
  51
  52 struct mac_bitmap_record
  53 {
  54   char *bitmap_data;
  55   char *file;
  56   int refcount;
  57   int height, width;
  58 };
  59
  60
  61 /* For each display (currently only one on mac), we have a structure that
  62    records information about it.  */
  63
  64 struct mac_display_info
  65 {
  66   /* Chain of all mac_display_info structures.  */
  67   struct mac_display_info *next;
  68
  69   /* This is a cons cell of the form (NAME . FONT-LIST-CACHE).
  70      The same cons cell also appears in x_display_name_list.  */
  71   Lisp_Object name_list_element;
  72
  73   /* Number of frames that are on this display.  */
  74   int reference_count;
  75
  76   /* Dots per inch of the screen.  */
  77   double resx, resy;
  78
  79   /* Number of planes on this screen.  */
  80   int n_planes;
  81
  82   /* Whether the screen supports color */
  83   int color_p;
  84
  85   /* Dimensions of this screen.  */
  86   int height, width;
  87
  88   /* Mask of things that cause the mouse to be grabbed.  */
  89   int grabbed;
  90
  91 #if 0
  92   /* Emacs bitmap-id of the default icon bitmap for this frame.
  93      Or -1 if none has been allocated yet.  */
  94   int icon_bitmap_id;
  95
  96 #endif
  97   /* The root window of this screen.  */
  98   Window root_window;
  99
 100   /* The cursor to use for vertical scroll bars.  */
 101   Cursor vertical_scroll_bar_cursor;
 102
 103   /* Resource data base */
 104   XrmDatabase xrdb;
 105
 106   /* A table of all the fonts we have already loaded.  */
 107   struct font_info *font_table;
 108
 109   /* The current capacity of font_table.  */
 110   int font_table_size;
 111
 112   /* Minimum width over all characters in all fonts in font_table.  */
 113   int smallest_char_width;
 114
 115   /* Minimum font height over all fonts in font_table.  */
 116   int smallest_font_height;
 117
 118   /* Reusable Graphics Context for drawing a cursor in a non-default face. */
 119   GC scratch_cursor_gc;
 120
 121   /* These variables describe the range of text currently shown in its
 122      mouse-face, together with the window they apply to.  As long as
 123      the mouse stays within this range, we need not redraw anything on
 124      its account.  Rows and columns are glyph matrix positions in
 125      MOUSE_FACE_WINDOW.  */
 126   int mouse_face_beg_row, mouse_face_beg_col;
 127   int mouse_face_beg_x, mouse_face_beg_y;
 128   int mouse_face_end_row, mouse_face_end_col;
 129   int mouse_face_end_x, mouse_face_end_y;
 130   int mouse_face_past_end;
 131   Lisp_Object mouse_face_window;
 132   int mouse_face_face_id;
 133   Lisp_Object mouse_face_overlay;
 134
 135   /* 1 if a mouse motion event came and we didn't handle it right away because
 136      gc was in progress.  */
 137   int mouse_face_deferred_gc;
 138
 139   /* FRAME and X, Y position of mouse when last checked for
 140      highlighting.  X and Y can be negative or out of range for the frame.  */
 141   struct frame *mouse_face_mouse_frame;
 142   int mouse_face_mouse_x, mouse_face_mouse_y;
 143
 144   /* Nonzero means defer mouse-motion highlighting.  */
 145   int mouse_face_defer;
 146
 147   /* Nonzero means that the mouse highlight should not be shown.  */
 148   int mouse_face_hidden;
 149
 150   int mouse_face_image_state;
 151
 152   char *mac_id_name;
 153
 154   /* The number of fonts actually stored in the font table.
 155      font_table[n] is used and valid if 0 <= n < n_fonts.  0 <=
 156      n_fonts <= font_table_size and font_table[i].name != 0.  */
 157   int n_fonts;
 158
 159   /* Pointer to bitmap records.  */
 160   struct mac_bitmap_record *bitmaps;
 161
 162   /* Allocated size of bitmaps field.  */
 163   int bitmaps_size;
 164
 165   /* Last used bitmap index.  */
 166   int bitmaps_last;
 167
 168   /* The frame (if any) which has the window that has keyboard focus.
 169      Zero if none.  This is examined by Ffocus_frame in macfns.c.  Note
 170      that a mere EnterNotify event can set this; if you need to know the
 171      last frame specified in a FocusIn or FocusOut event, use
 172      x_focus_event_frame.  */
 173   struct frame *x_focus_frame;
 174
 175   /* The last frame mentioned in a FocusIn or FocusOut event.  This is
 176      separate from x_focus_frame, because whether or not LeaveNotify
 177      events cause us to lose focus depends on whether or not we have
 178      received a FocusIn event for it.  */
 179   struct frame *x_focus_event_frame;
 180
 181   /* The frame which currently has the visual highlight, and should get
 182      keyboard input (other sorts of input have the frame encoded in the
 183      event).  It points to the focus frame's selected window's
 184      frame.  It differs from x_focus_frame when we're using a global
 185      minibuffer.  */
 186   struct frame *x_highlight_frame;
 187
 188   /* Cache of images.  */
 189   struct image_cache *image_cache;
 190 };
 191
 192 /* This checks to make sure we have a display.  */
 193 extern void check_mac P_ ((void));
 194
 195 #define x_display_info mac_display_info
 196
 197 /* This is a chain of structures for all the X displays currently in use.  */
 198 extern struct x_display_info *x_display_list;
 199
 200 /* This is a chain of structures for all the displays currently in use.  */
 201 extern struct mac_display_info one_mac_display_info;
 202
 203 /* This is a list of cons cells, each of the form (NAME . FONT-LIST-CACHE),
 204    one for each element of x_display_list and in the same order.
 205    NAME is the name of the frame.
 206    FONT-LIST-CACHE records previous values returned by x-list-fonts.  */
 207 extern Lisp_Object x_display_name_list;
 208
 209 extern struct x_display_info *x_display_info_for_name P_ ((Lisp_Object));
 210
 211 extern struct mac_display_info *mac_term_init P_ ((Lisp_Object, char *, char *));
 212
 213 extern Lisp_Object x_list_fonts P_ ((struct frame *, Lisp_Object, int, int));
 214 extern struct font_info *x_get_font_info P_ ((struct frame *f, int));
 215 extern struct font_info *x_load_font P_ ((struct frame *, char *, int));
 216 extern struct font_info *x_query_font P_ ((struct frame *, char *));
 217 extern void x_find_ccl_program P_ ((struct font_info *));
 218 \f
 219 /* When Emacs uses a tty window, tty_display in frame.c points to an
 220    x_output struct .  */
 221 struct x_output
 222 {
 223   unsigned long background_pixel;
 224   unsigned long foreground_pixel;
 225 };
 226
 227 /* The collection of data describing a window on the Mac.  */
 228 struct mac_output
 229 {
 230   /* Placeholder for things accessed through output_data.x.  Must
 231      appear first.  */
 232   struct x_output x_compatible;
 233
 234   /* Menubar "widget" handle.  */
 235   int menubar_widget;
 236
 237   FRAME_PTR mFP;                /* points back to the frame struct */
 238
 239   /* Here are the Graphics Contexts for the default font.  */
 240   GC normal_gc;                         /* Normal video */
 241   GC reverse_gc;                        /* Reverse video */
 242   GC cursor_gc;                         /* cursor drawing */
 243
 244   /* The window used for this frame.
 245      May be zero while the frame object is being created
 246      and the window has not yet been created.  */
 247   Window window_desc;
 248
 249   /* The window that is the parent of this window.
 250      Usually this is a window that was made by the window manager,
 251      but it can be the root window, and it can be explicitly specified
 252      (see the explicit_parent field, below).  */
 253   Window parent_desc;
 254
 255   /* Default ASCII font of this frame. */
 256   XFontStruct *font;
 257
 258   /* The baseline offset of the default ASCII font.  */
 259   int baseline_offset;
 260
 261   /* If a fontset is specified for this frame instead of font, this
 262      value contains an ID of the fontset, else -1.  */
 263   int fontset;
 264
 265   /* Pixel values used for various purposes.
 266      border_pixel may be -1 meaning use a gray tile.  */
 267   unsigned long cursor_pixel;
 268   unsigned long border_pixel;
 269   unsigned long mouse_pixel;
 270   unsigned long cursor_foreground_pixel;
 271
 272 #if 0
 273   /* Foreground color for scroll bars.  A value of -1 means use the
 274      default (black for non-toolkit scroll bars).  */
 275   unsigned long scroll_bar_foreground_pixel;
 276
 277   /* Background color for scroll bars.  A value of -1 means use the
 278      default (background color of the frame for non-toolkit scroll
 279      bars).  */
 280   unsigned long scroll_bar_background_pixel;
 281 #endif
 282
 283   /* Descriptor for the cursor in use for this window.  */
 284   Cursor text_cursor;
 285   Cursor nontext_cursor;
 286   Cursor modeline_cursor;
 287   Cursor hand_cursor;
 288   Cursor hourglass_cursor;
 289   Cursor horizontal_drag_cursor;
 290 #if 0
 291   /* Window whose cursor is hourglass_cursor.  This window is temporarily
 292      mapped to display a hourglass-cursor.  */
 293   Window hourglass_window;
 294
 295   /* Non-zero means hourglass cursor is currently displayed.  */
 296   unsigned hourglass_p : 1;
 297
 298   /* Flag to set when the window needs to be completely repainted.  */
 299   int needs_exposure;
 300
 301 #endif
 302
 303 #if TARGET_API_MAC_CARBON
 304   /* The Mac control reference for the hourglass (progress indicator)
 305      shown at the upper-right corner of the window.  */
 306   ControlRef hourglass_control;
 307 #endif
 308
 309   /* This is the Emacs structure for the display this frame is on.  */
 310   /* struct w32_display_info *display_info; */
 311
 312   /* Nonzero means our parent is another application's window
 313      and was explicitly specified.  */
 314   char explicit_parent;
 315
 316   /* Nonzero means tried already to make this frame visible.  */
 317   char asked_for_visible;
 318
 319   /* Relief GCs, colors etc.  */
 320   struct relief
 321   {
 322     GC gc;
 323     unsigned long pixel;
 324     int allocated_p;
 325   }
 326   black_relief, white_relief;
 327
 328   /* The background for which the above relief GCs were set up.
 329      They are changed only when a different background is involved.  */
 330   unsigned long relief_background;
 331
 332   /* Width of the internal border.  */
 333   int internal_border_width;
 334
 335   /* Hints for the size and the position of a window.  */
 336   XSizeHints *size_hints;
 337
 338 #if USE_MAC_TOOLBAR
 339   /* This variable records the gravity value of the window position if
 340      the window has an external tool bar when it is created.  The
 341      position of the window is adjusted using this information when
 342      the tool bar is first redisplayed.  Once the tool bar is
 343      redisplayed, it is set to 0 in order to avoid further
 344      adjustment.  */
 345   int toolbar_win_gravity;
 346 #endif
 347
 348 #if USE_CG_DRAWING
 349   /* Quartz 2D graphics context.  */
 350   CGContextRef cg_context;
 351 #endif
 352 };
 353
 354 typedef struct mac_output mac_output;
 355
 356 /* Return the X output data for frame F.  */
 357 #define FRAME_X_OUTPUT(f) ((f)->output_data.mac)
 358
 359 /* Return the Mac window used for displaying data in frame F.  */
 360 #define FRAME_MAC_WINDOW(f) ((f)->output_data.mac->window_desc)
 361 #define FRAME_X_WINDOW(f) ((f)->output_data.mac->window_desc)
 362
 363 #define FRAME_FOREGROUND_PIXEL(f) ((f)->output_data.x->foreground_pixel)
 364 #define FRAME_BACKGROUND_PIXEL(f) ((f)->output_data.x->background_pixel)
 365
 366 #define FRAME_FONT(f) ((f)->output_data.mac->font)
 367 #define FRAME_FONTSET(f) ((f)->output_data.mac->fontset)
 368
 369 #define FRAME_BASELINE_OFFSET(f) ((f)->output_data.mac->baseline_offset)
 370
 371 #define FRAME_SIZE_HINTS(f) ((f)->output_data.mac->size_hints)
 372
 373 /* This gives the mac_display_info structure for the display F is on.  */
 374 #define FRAME_MAC_DISPLAY_INFO(f) (&one_mac_display_info)
 375 #define FRAME_X_DISPLAY_INFO(f) (&one_mac_display_info)
 376
 377 /* This is the `Display *' which frame F is on.  */
 378 #define FRAME_MAC_DISPLAY(f) (0)
 379 #define FRAME_X_DISPLAY(f) (0)
 380
 381 /* This is the 'font_info *' which frame F has.  */
 382 #define FRAME_MAC_FONT_TABLE(f) (FRAME_MAC_DISPLAY_INFO (f)->font_table)
 383
 384 /* Value is the smallest width of any character in any font on frame F.  */
 385
 386 #define FRAME_SMALLEST_CHAR_WIDTH(F) \
 387      FRAME_MAC_DISPLAY_INFO(F)->smallest_char_width
 388
 389 /* Value is the smallest height of any font on frame F.  */
 390
 391 #define FRAME_SMALLEST_FONT_HEIGHT(F) \
 392      FRAME_MAC_DISPLAY_INFO(F)->smallest_font_height
 393
 394 /* Return a pointer to the image cache of frame F.  */
 395
 396 #define FRAME_X_IMAGE_CACHE(F) FRAME_MAC_DISPLAY_INFO ((F))->image_cache
 397
 398 \f
 399 /* Mac-specific scroll bar stuff.  */
 400
 401 /* We represent scroll bars as lisp vectors.  This allows us to place
 402    references to them in windows without worrying about whether we'll
 403    end up with windows referring to dead scroll bars; the garbage
 404    collector will free it when its time comes.
 405
 406    We use struct scroll_bar as a template for accessing fields of the
 407    vector.  */
 408
 409 struct scroll_bar {
 410
 411   /* These fields are shared by all vectors.  */
 412   EMACS_INT size_from_Lisp_Vector_struct;
 413   struct Lisp_Vector *next_from_Lisp_Vector_struct;
 414
 415   /* The window we're a scroll bar for.  */
 416   Lisp_Object window;
 417
 418   /* The next and previous in the chain of scroll bars in this frame.  */
 419   Lisp_Object next, prev;
 420
 421   /* The Mac control reference of this scroll bar.  Since this is a
 422      pointer value, we store it split into two Lisp integers.  */
 423   Lisp_Object control_ref_low, control_ref_high;
 424
 425   /* The position and size of the scroll bar in pixels, relative to the
 426      frame.  */
 427   Lisp_Object top, left, width, height;
 428
 429   /* The starting and ending positions of the handle, relative to the
 430      handle area (i.e. zero is the top position, not
 431      SCROLL_BAR_TOP_BORDER).  If they're equal, that means the handle
 432      hasn't been drawn yet.
 433
 434      These are not actually the locations where the beginning and end
 435      are drawn; in order to keep handles from becoming invisible when
 436      editing large files, we establish a minimum height by always
 437      drawing handle bottoms VERTICAL_SCROLL_BAR_MIN_HANDLE pixels below
 438      where they would be normally; the bottom and top are in a
 439      different co-ordinate system.  */
 440   Lisp_Object start, end;
 441
 442   /* If the scroll bar handle is currently being dragged by the user,
 443      this is the number of pixels from the top of the handle to the
 444      place where the user grabbed it.  If the handle is pressed but
 445      not dragged yet, this is a negative integer whose absolute value
 446      is the number of pixels plus 1.  If the handle isn't currently
 447      being dragged, this is Qnil.  */
 448   Lisp_Object dragging;
 449
 450 #ifdef MAC_OSX
 451   /* t if the background of the fringe that is adjacent to a scroll
 452      bar is extended to the gap between the fringe and the bar.  */
 453   Lisp_Object fringe_extended_p;
 454 #endif
 455
 456   /* t if redraw needed in the next XTset_vertical_scroll_bar call.  */
 457   Lisp_Object redraw_needed_p;
 458
 459 #ifdef USE_TOOLKIT_SCROLL_BARS
 460   /* The position and size of the scroll bar handle track area in
 461      pixels, relative to the frame.  */
 462   Lisp_Object track_top, track_height;
 463
 464   /* Minimum length of the scroll bar handle, in pixels.  */
 465   Lisp_Object min_handle;
 466 #endif
 467 };
 468
 469 /* The number of elements a vector holding a struct scroll_bar needs.  */
 470 #define SCROLL_BAR_VEC_SIZE                                     \
 471   ((sizeof (struct scroll_bar)                                  \
 472     - sizeof (EMACS_INT) - sizeof (struct Lisp_Vector *))       \
 473    / sizeof (Lisp_Object))
 474
 475 /* Turning a lisp vector value into a pointer to a struct scroll_bar.  */
 476 #define XSCROLL_BAR(vec) ((struct scroll_bar *) XVECTOR (vec))
 477
 478
 479 /* Building a C long integer from two lisp integers.  */
 480 #define SCROLL_BAR_PACK(low, high) (XINT (high) << 16 | XINT (low))
 481
 482 /* Setting two lisp integers to two parts of a C unsigned long.  */
 483 #define SCROLL_BAR_UNPACK(low, high, ulong) \
 484   (XSETINT ((low),  (ulong) & 0xffff), \
 485    XSETINT ((high), (ulong) >> 16))
 486
 487
 488 /* Extract the Mac control handle of the scroll bar from a struct
 489    scroll_bar.  */
 490 #define SCROLL_BAR_CONTROL_REF(ptr)                             \
 491   ((ControlRef) SCROLL_BAR_PACK ((ptr)->control_ref_low,        \
 492                                  (ptr)->control_ref_high))
 493
 494 /* Store a Mac control handle in a struct scroll_bar.  */
 495 #define SET_SCROLL_BAR_CONTROL_REF(ptr, ref)                            \
 496   (SCROLL_BAR_UNPACK ((ptr)->control_ref_low,                           \
 497                       (ptr)->control_ref_high, (unsigned long) (ref)))
 498
 499 /* Return the inside width of a vertical scroll bar, given the outside
 500    width.  */
 501 #define VERTICAL_SCROLL_BAR_INSIDE_WIDTH(f, width) \
 502   ((width) \
 503    - VERTICAL_SCROLL_BAR_LEFT_BORDER \
 504    - VERTICAL_SCROLL_BAR_RIGHT_BORDER \
 505    - VERTICAL_SCROLL_BAR_WIDTH_TRIM * 2)
 506
 507 /* Return the length of the rectangle within which the top of the
 508    handle must stay.  This isn't equivalent to the inside height,
 509    because the scroll bar handle has a minimum height.
 510
 511    This is the real range of motion for the scroll bar, so when we're
 512    scaling buffer positions to scroll bar positions, we use this, not
 513    VERTICAL_SCROLL_BAR_INSIDE_HEIGHT.  */
 514 #define VERTICAL_SCROLL_BAR_TOP_RANGE(f,height) \
 515   (VERTICAL_SCROLL_BAR_INSIDE_HEIGHT (f, height) \
 516    - VERTICAL_SCROLL_BAR_MIN_HANDLE - UP_AND_DOWN_ARROWS)
 517
 518 /* Return the inside height of vertical scroll bar, given the outside
 519    height.  See VERTICAL_SCROLL_BAR_TOP_RANGE too.  */
 520 #define VERTICAL_SCROLL_BAR_INSIDE_HEIGHT(f,height) \
 521   ((height) - VERTICAL_SCROLL_BAR_TOP_BORDER \
 522    - VERTICAL_SCROLL_BAR_BOTTOM_BORDER)
 523
 524
 525 /* Border widths for scroll bars.
 526
 527    Scroll bar windows don't have any borders; their border width is
 528    set to zero, and we redraw borders ourselves.  This makes the code
 529    a bit cleaner, since we don't have to convert between outside width
 530    (used when relating to the rest of the screen) and inside width
 531    (used when sizing and drawing the scroll bar window itself).
 532
 533    The handle moves up and down/back and forth in a rectangle inset
 534    from the edges of the scroll bar.  These are widths by which we
 535    inset the handle boundaries from the scroll bar edges.  */
 536 #define VERTICAL_SCROLL_BAR_LEFT_BORDER (0)
 537 #define VERTICAL_SCROLL_BAR_RIGHT_BORDER (0)
 538 #define VERTICAL_SCROLL_BAR_TOP_BORDER (0)
 539 #define VERTICAL_SCROLL_BAR_BOTTOM_BORDER (0)
 540
 541 /* Minimum lengths for scroll bar handles, in pixels.  */
 542 #define VERTICAL_SCROLL_BAR_MIN_HANDLE (16)
 543
 544 /* Combined length of up and down arrow boxes in scroll bars, in pixels.  */
 545 #define UP_AND_DOWN_ARROWS (32)
 546
 547 /* Trimming off a few pixels from each side prevents
 548    text from glomming up against the scroll bar */
 549 #define VERTICAL_SCROLL_BAR_WIDTH_TRIM (0)
 550
 551 /* Variations of possible Aqua scroll bar width.  */
 552 #define MAC_AQUA_VERTICAL_SCROLL_BAR_WIDTH (15)
 553 #define MAC_AQUA_SMALL_VERTICAL_SCROLL_BAR_WIDTH (11)
 554
 555 /* Size of hourglass controls */
 556 #define HOURGLASS_WIDTH (15)
 557 #define HOURGLASS_HEIGHT (15)
 558
 559 /* Some constants that are used locally.  */
 560 /* Creator code for Emacs on Mac OS.  */
 561 enum {
 562   MAC_EMACS_CREATOR_CODE        = 'EMAx'
 563 };
 564
 565 /* Apple event descriptor types */
 566 enum {
 567   TYPE_FILE_NAME                = 'fNam'
 568 };
 569
 570 /* Keywords for Apple event attributes */
 571 enum {
 572   KEY_EMACS_SUSPENSION_ID_ATTR  = 'esId' /* typeUInt32 */
 573 };
 574
 575 /* Carbon event parameter names.  */
 576 enum {
 577   EVENT_PARAM_TEXT_INPUT_SEQUENCE_NUMBER = 'tsSn' /* typeUInt32 */
 578 };
 579
 580 /* Some constants that are not defined in older versions.  */
 581 #if MAC_OS_X_VERSION_MAX_ALLOWED < 1030
 582 /* Keywords for Apple event attributes */
 583 enum {
 584   keyReplyRequestedAttr         = 'repq'
 585 };
 586 #endif
 587
 588 #if 0
 589 /* We can't determine the availability of these enumerators by
 590    MAC_OS_X_VERSION_MAX_ALLOWED, because they are defined in
 591    MacOSX10.3.9.sdk for Mac OS X 10.4, but not in Mac OS X 10.3.  */
 592 #if MAC_OS_X_VERSION_MAX_ALLOWED < 1040
 593 /* Gestalt selectors */
 594 enum {
 595   gestaltSystemVersionMajor     = 'sys1',
 596   gestaltSystemVersionMinor     = 'sys2',
 597   gestaltSystemVersionBugFix    = 'sys3'
 598 };
 599 #endif
 600 #endif
 601
 602 #ifdef MAC_OSX
 603 #if MAC_OS_X_VERSION_MAX_ALLOWED < 1020
 604 /* Apple event descriptor types */
 605 enum {
 606   typeUTF8Text                  = 'utf8'
 607 };
 608
 609 /* Carbon event parameter names */
 610 enum {
 611   kEventParamWindowMouseLocation = 'wmou'
 612 };
 613 #endif
 614
 615 /* kCGBitmapByteOrder32Host is defined in Universal SDK for 10.4 but
 616    not in PPC SDK for 10.4.0.  */
 617 #if MAC_OS_X_VERSION_MAX_ALLOWED < 1050 && !defined (kCGBitmapByteOrder32Host)
 618 #define kCGBitmapByteOrder32Host 0
 619 #endif
 620 #endif  /* MAC_OSX */
 621
 622 struct frame;
 623 struct face;
 624 struct image;
 625
 626 Lisp_Object display_x_get_resource P_ ((struct x_display_info *,
 627                                         Lisp_Object, Lisp_Object,
 628                                         Lisp_Object, Lisp_Object));
 629 struct frame *check_x_frame P_ ((Lisp_Object));
 630 EXFUN (Fx_display_color_p, 1);
 631 EXFUN (Fx_display_grayscale_p, 1);
 632 EXFUN (Fx_display_planes, 1);
 633 extern void x_free_gcs P_ ((struct frame *));
 634 extern int XParseGeometry P_ ((char *, int *, int *, unsigned int *,
 635                                unsigned int *));
 636
 637 /* Defined in macterm.c.  */
 638
 639 extern void x_set_window_size P_ ((struct frame *, int, int, int));
 640 extern void x_set_mouse_position P_ ((struct frame *, int, int));
 641 extern void x_set_mouse_pixel_position P_ ((struct frame *, int, int));
 642 extern void x_raise_frame P_ ((struct frame *));
 643 extern void x_lower_frame P_ ((struct frame *));
 644 extern void x_make_frame_visible P_ ((struct frame *));
 645 extern void x_make_frame_invisible P_ ((struct frame *));
 646 extern void x_iconify_frame P_ ((struct frame *));
 647 extern void x_free_frame_resources P_ ((struct frame *));
 648 extern void x_destroy_window P_ ((struct frame *));
 649 extern void x_wm_set_size_hint P_ ((struct frame *, long, int));
 650 extern void x_delete_display P_ ((struct x_display_info *));
 651 extern void mac_initialize P_ ((void));
 652 extern Pixmap XCreatePixmap P_ ((Display *, Window, unsigned int,
 653                                  unsigned int, unsigned int));
 654 extern Pixmap XCreatePixmapFromBitmapData P_ ((Display *, Window, char *,
 655                                                unsigned int, unsigned int,
 656                                                unsigned long, unsigned long,
 657                                                unsigned int));
 658 extern void XFreePixmap P_ ((Display *, Pixmap));
 659 extern GC XCreateGC P_ ((Display *, void *, unsigned long, XGCValues *));
 660 extern void XFreeGC P_ ((Display *, GC));
 661 extern void XSetForeground P_ ((Display *, GC, unsigned long));
 662 extern void XSetBackground P_ ((Display *, GC, unsigned long));
 663 extern void XDrawLine P_ ((Display *, Pixmap, GC, int, int, int, int));
 664 extern void mac_clear_area P_ ((struct frame *, int, int,
 665                                 unsigned int, unsigned int));
 666 extern void mac_unload_font P_ ((struct mac_display_info *, XFontStruct *));
 667 extern OSStatus mac_post_mouse_moved_event P_ ((void));
 668 extern int mac_quit_char_key_p P_ ((UInt32, UInt32));
 669
 670 #define FONT_TYPE_FOR_UNIBYTE(font, ch) 0
 671 #define FONT_TYPE_FOR_MULTIBYTE(font, ch) 0
 672
 673 #if USE_MAC_IMAGE_IO
 674 extern CGColorSpaceRef mac_cg_color_space_rgb;
 675 #endif
 676
 677 /* Defined in macselect.c */
 678
 679 extern void x_clear_frame_selections P_ ((struct frame *));
 680 EXFUN (Fx_selection_owner_p, 1);
 681
 682 /* Defined in macfns.c */
 683
 684 extern int have_menus_p P_ ((void));
 685
 686 extern void x_real_positions P_ ((struct frame *, int *, int *));
 687 extern void x_set_menu_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
 688 extern int x_pixel_width P_ ((struct frame *));
 689 extern int x_pixel_height P_ ((struct frame *));
 690 extern int x_char_width P_ ((struct frame *));
 691 extern int x_char_height P_ ((struct frame *));
 692 extern void x_sync P_ ((struct frame *));
 693 extern void x_set_tool_bar_lines P_ ((struct frame *, Lisp_Object, Lisp_Object));
 694 extern void mac_update_title_bar P_ ((struct frame *, int));
 695 extern Lisp_Object x_get_focus_frame P_ ((struct frame *));
 696
 697 /* Defined in mac.c.  */
 698
 699 extern void mac_clear_font_name_table P_ ((void));
 700 extern Lisp_Object mac_aedesc_to_lisp P_ ((const AEDesc *));
 701 extern OSErr mac_ae_put_lisp P_ ((AEDescList *, UInt32, Lisp_Object));
 702 #if TARGET_API_MAC_CARBON
 703 extern OSErr create_apple_event P_ ((AEEventClass, AEEventID, AppleEvent *));
 704 extern Lisp_Object mac_event_parameters_to_lisp P_ ((EventRef, UInt32,
 705                                                      const EventParamName *,
 706                                                      const EventParamType *));
 707 extern CFStringRef cfstring_create_with_utf8_cstring P_ ((const char *));
 708 extern CFStringRef cfstring_create_with_string P_ ((Lisp_Object));
 709 extern Lisp_Object cfdata_to_lisp P_ ((CFDataRef));
 710 extern Lisp_Object cfstring_to_lisp_nodecode P_ ((CFStringRef));
 711 extern Lisp_Object cfstring_to_lisp P_ ((CFStringRef));
 712 extern Lisp_Object cfnumber_to_lisp P_ ((CFNumberRef));
 713 extern Lisp_Object cfdate_to_lisp P_ ((CFDateRef));
 714 extern Lisp_Object cfboolean_to_lisp P_ ((CFBooleanRef));
 715 extern Lisp_Object cfobject_desc_to_lisp P_ ((CFTypeRef));
 716 extern Lisp_Object cfproperty_list_to_lisp P_ ((CFPropertyListRef, int, int));
 717 extern void mac_wakeup_from_rne P_ ((void));
 718 #endif
 719 extern void xrm_merge_string_database P_ ((XrmDatabase, const char *));
 720 extern Lisp_Object xrm_get_resource P_ ((XrmDatabase, const char *,
 721                                          const char *));
 722 extern XrmDatabase xrm_get_preference_database P_ ((const char *));
 723 EXFUN (Fmac_get_preference, 4);
 724
 725 /* Defined in mactoolbox.c.  */
 726
 727 extern void mac_alert_sound_play P_ ((void));
 728 extern OSStatus install_application_handler P_ ((void));
 729 extern void mac_get_window_bounds P_ ((struct frame *, Rect *, Rect *));
 730 extern Rect *mac_get_frame_bounds P_ ((struct frame *, Rect *));
 731 extern void mac_get_frame_mouse P_ ((struct frame *, Point *));
 732 extern void mac_convert_frame_point_to_global P_ ((struct frame *, int *,
 733                                                    int *));
 734 #if TARGET_API_MAC_CARBON
 735 extern void mac_update_proxy_icon P_ ((struct frame *));
 736 #endif
 737 extern void mac_set_frame_window_background P_ ((struct frame *,
 738                                                  unsigned long));
 739 extern void mac_update_begin P_ ((struct frame *));
 740 extern void mac_update_end P_ ((struct frame *));
 741 extern void mac_frame_up_to_date P_ ((struct frame *));
 742 extern void x_flush P_ ((struct frame *));
 743 extern void mac_create_frame_window P_ ((struct frame *, int));
 744 extern void mac_dispose_frame_window P_ ((struct frame *));
 745 #if USE_CG_DRAWING
 746 extern CGContextRef mac_begin_cg_clip P_ ((struct frame *, GC));
 747 extern void mac_end_cg_clip P_ ((struct frame *));
 748 #endif
 749 extern void mac_begin_clip P_ ((struct frame *, GC));
 750 extern void mac_end_clip P_ ((struct frame *, GC));
 751 extern void mac_create_scroll_bar P_ ((struct scroll_bar *, const Rect *,
 752                                        Boolean));
 753 extern void mac_dispose_scroll_bar P_ ((struct scroll_bar *));
 754 extern void mac_set_scroll_bar_bounds P_ ((struct scroll_bar *, const Rect *));
 755 extern void mac_redraw_scroll_bar P_ ((struct scroll_bar *));
 756 #ifdef USE_TOOLKIT_SCROLL_BARS
 757 extern void x_set_toolkit_scroll_bar_thumb P_ ((struct scroll_bar *,
 758                                                 int, int, int));
 759 #else
 760 extern void x_scroll_bar_set_handle P_ ((scroll_bar *, int, int, int));
 761 #endif
 762 #if USE_MAC_FONT_PANEL
 763 extern int mac_font_panel_visible_p P_ ((void));
 764 extern OSStatus mac_show_hide_font_panel P_ ((void));
 765 extern OSStatus mac_set_font_info_for_selection P_ ((struct frame *, int, int));
 766 #endif
 767 #ifdef MAC_OSX
 768 extern Boolean mac_run_loop_run_once P_ ((EventTimeout));
 769 #endif
 770 #if USE_MAC_TOOLBAR
 771 extern void update_frame_tool_bar P_ ((FRAME_PTR f));
 772 extern void free_frame_tool_bar P_ ((FRAME_PTR f));
 773 #endif
 774 #if TARGET_API_MAC_CARBON
 775 extern void mac_show_hourglass P_ ((struct frame *));
 776 extern void mac_hide_hourglass P_ ((struct frame *));
 777 extern void mac_reposition_hourglass P_ ((struct frame *));
 778 extern Lisp_Object mac_file_dialog P_ ((Lisp_Object, Lisp_Object, Lisp_Object,
 779                                         Lisp_Object, Lisp_Object));
 780 #endif
 781 extern void x_activate_menubar P_ ((struct frame *));
 782 extern void free_frame_menubar P_ ((struct frame *));
 783 extern void mac_fill_menubar P_ ((widget_value *, int));
 784 extern void create_and_show_popup_menu P_ ((FRAME_PTR, widget_value *,
 785                                             int, int, int));
 786 #if TARGET_API_MAC_CARBON
 787 extern void create_and_show_dialog P_ ((FRAME_PTR, widget_value *));
 788 #else
 789 extern int mac_dialog P_ ((widget_value *));
 790 #endif
 791 extern OSStatus mac_get_selection_from_symbol P_ ((Lisp_Object, int,
 792                                                    Selection *));
 793 extern int mac_valid_selection_target_p P_ ((Lisp_Object));
 794 extern OSStatus mac_clear_selection P_ ((Selection *));
 795 extern Lisp_Object mac_get_selection_ownership_info P_ ((Selection));
 796 extern int mac_valid_selection_value_p P_ ((Lisp_Object, Lisp_Object));
 797 extern OSStatus mac_put_selection_value P_ ((Selection, Lisp_Object,
 798                                              Lisp_Object));
 799 extern int mac_selection_has_target_p P_ ((Selection, Lisp_Object));
 800 extern Lisp_Object mac_get_selection_value P_ ((Selection, Lisp_Object));
 801 extern Lisp_Object mac_get_selection_target_list P_ ((Selection));
 802 #if TARGET_API_MAC_CARBON
 803 extern Lisp_Object mac_dnd_default_known_types P_ ((void));
 804 #endif
 805
 806 /* arch-tag: 6b4ca125-5bef-476d-8ee8-31ed808b7e79
 807    (do not change this comment) */