src/w32term.h

   1 /* Definitions and headers for communication on the Microsoft W32 API.
   2    Copyright (C) 1995 Free Software Foundation, Inc.
   3
   4 This file is part of GNU Emacs.
   5
   6 GNU Emacs is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2, or (at your option)
   9 any later version.
  10
  11 GNU Emacs is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 GNU General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GNU Emacs; see the file COPYING.  If not, write to
  18 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  19 Boston, MA 02111-1307, USA.  */
  20
  21 /* Added by Kevin Gallo */
  22
  23 #include <w32gui.h>
  24
  25 /* The class of this X application.  */
  26 #define EMACS_CLASS "Emacs"
  27 \f
  28 #define BLACK_PIX_DEFAULT(f) PALETTERGB(0,0,0)
  29 #define WHITE_PIX_DEFAULT(f) PALETTERGB(255,255,255)
  30
  31 #define FONT_WIDTH(f)       \
  32   ((f)->bdf ? (f)->bdf->width : (f)->tm.tmAveCharWidth)
  33 #define FONT_HEIGHT(f)      \
  34    ((f)->bdf ? (f)->bdf->height : (f)->tm.tmHeight)
  35 /* No idea why 5 seems to work in here, but it does */
  36 #define FONT_BASE(f)        \
  37   ((f)->bdf ? (f)->bdf->ury : (f)->tm.tmAscent)
  38 #define FONT_MAX_WIDTH(f)   \
  39   ((f)->bdf ? (f)->bdf->width : (f)->tm.tmMaxCharWidth)
  40
  41 #define CHECK_W32_FRAME(f, frame)               \
  42   if (NILP (frame))                             \
  43     f = selected_frame;                         \
  44   else                                          \
  45     {                                           \
  46       CHECK_LIVE_FRAME (frame, 0);              \
  47       f = XFRAME (frame);                       \
  48     }                                           \
  49   if (! FRAME_W32_P (f))
  50
  51 /* Indicates whether we are in the readsocket call and the message we
  52    are processing in the current loop */
  53
  54 extern MSG CurMsg;
  55 extern BOOL bUseDflt;
  56
  57 extern struct frame *x_window_to_frame ();
  58
  59 enum text_cursor_kinds {
  60   filled_box_cursor, hollow_box_cursor, bar_cursor
  61 };
  62
  63 /* Structure recording bitmaps and reference count.
  64    If REFCOUNT is 0 then this record is free to be reused.  */
  65
  66 struct w32_bitmap_record
  67 {
  68   Pixmap pixmap;
  69   char *file;
  70   HINSTANCE hinst; /* Used to load the file */
  71   int refcount;
  72   /* Record some info about this pixmap.  */
  73   int height, width, depth;
  74 };
  75
  76 /* Palette book-keeping stuff for mapping requested colors into the
  77    system palette.  Keep a ref-counted list of requested colors and
  78    regenerate the app palette whenever the requested list changes. */
  79
  80 extern Lisp_Object Vw32_enable_palette;
  81
  82 struct w32_palette_entry {
  83   struct w32_palette_entry * next;
  84   PALETTEENTRY entry;
  85 #if 0
  86   unsigned refcount;
  87 #endif
  88 };
  89
  90 extern void w32_regenerate_palette(struct frame *f);
  91
  92 \f
  93 /* For each display (currently only one on w32), we have a structure that
  94    records information about it.  */
  95
  96 struct w32_display_info
  97 {
  98   /* Chain of all w32_display_info structures.  */
  99   struct w32_display_info *next;
 100   /* This is a cons cell of the form (NAME . FONT-LIST-CACHE).
 101      The same cons cell also appears in x_display_name_list.  */
 102   Lisp_Object name_list_element;
 103   /* Number of frames that are on this display.  */
 104   int reference_count;
 105   /* Number of planes on this screen.  */
 106   int n_planes;
 107   /* Number of bits per pixel on this screen.  */
 108   int n_cbits;
 109   /* Dimensions of this screen.  */
 110   int height, width;
 111   int height_in,width_in;
 112   /* Mask of things that cause the mouse to be grabbed.  */
 113   int grabbed;
 114   /* The root window of this screen.  */
 115   Window root_window;
 116   /* The cursor to use for vertical scroll bars.  */
 117   Cursor vertical_scroll_bar_cursor;
 118
 119   /* color palette information.  */
 120   int has_palette;
 121   struct w32_palette_entry * color_list;
 122   unsigned num_colors;
 123   HPALETTE palette;
 124
 125   /* deferred action flags checked when starting frame update.  */
 126   int regen_palette;
 127
 128   /* Keystroke that has been faked by Emacs and will be ignored when
 129      received; value is reset after key is received.  */
 130   int faked_key;
 131
 132   /* A table of all the fonts we have already loaded.  */
 133   struct font_info *font_table;
 134
 135   /* The current capacity of font_table.  */
 136   int font_table_size;
 137
 138   /* These variables describe the range of text currently shown
 139      in its mouse-face, together with the window they apply to.
 140      As long as the mouse stays within this range, we need not
 141      redraw anything on its account.  */
 142   int mouse_face_beg_row, mouse_face_beg_col;
 143   int mouse_face_end_row, mouse_face_end_col;
 144   int mouse_face_past_end;
 145   Lisp_Object mouse_face_window;
 146   int mouse_face_face_id;
 147
 148   /* 1 if a mouse motion event came and we didn't handle it right away because
 149      gc was in progress.  */
 150   int mouse_face_deferred_gc;
 151
 152   /* FRAME and X, Y position of mouse when last checked for
 153      highlighting.  X and Y can be negative or out of range for the frame.  */
 154   struct frame *mouse_face_mouse_frame;
 155   int mouse_face_mouse_x, mouse_face_mouse_y;
 156
 157   /* Nonzero means defer mouse-motion highlighting.  */
 158   int mouse_face_defer;
 159
 160   char *w32_id_name;
 161
 162   /* The number of fonts actually stored in w32_font_table.
 163      font_table[n] is used and valid iff 0 <= n < n_fonts.
 164      0 <= n_fonts <= font_table_size.  */
 165   int n_fonts;
 166
 167   /* Pointer to bitmap records.  */
 168   struct w32_bitmap_record *bitmaps;
 169
 170   /* Allocated size of bitmaps field.  */
 171   int bitmaps_size;
 172
 173   /* Last used bitmap index.  */
 174   int bitmaps_last;
 175
 176   /* The frame (if any) which has the window that has keyboard focus.
 177      Zero if none.  This is examined by Ffocus_frame in w32fns.c.  Note
 178      that a mere EnterNotify event can set this; if you need to know the
 179      last frame specified in a FocusIn or FocusOut event, use
 180      w32_focus_event_frame.  */
 181   struct frame *w32_focus_frame;
 182
 183   /* The last frame mentioned in a FocusIn or FocusOut event.  This is
 184      separate from w32_focus_frame, because whether or not LeaveNotify
 185      events cause us to lose focus depends on whether or not we have
 186      received a FocusIn event for it.  */
 187   struct frame *w32_focus_event_frame;
 188
 189   /* The frame which currently has the visual highlight, and should get
 190      keyboard input (other sorts of input have the frame encoded in the
 191      event).  It points to the focus frame's selected window's
 192      frame.  It differs from w32_focus_frame when we're using a global
 193      minibuffer.  */
 194   struct frame *w32_highlight_frame;
 195 };
 196
 197 /* This is a chain of structures for all the displays currently in use.  */
 198 extern struct w32_display_info one_w32_display_info;
 199
 200 /* This is a list of cons cells, each of the form (NAME . FONT-LIST-CACHE),
 201    one for each element of w32_display_list and in the same order.
 202    NAME is the name of the frame.
 203    FONT-LIST-CACHE records previous values returned by x-list-fonts.  */
 204 extern Lisp_Object w32_display_name_list;
 205
 206 /* Regexp matching a font name whose width is the same as `PIXEL_SIZE'.  */
 207 extern Lisp_Object Vx_pixel_size_width_font_regexp;
 208
 209 /* A flag to control how to display unibyte 8-bit character.  */
 210 extern int unibyte_display_via_language_environment;
 211
 212 extern struct w32_display_info *x_display_info_for_display ();
 213 extern struct w32_display_info *x_display_info_for_name ();
 214
 215 extern struct w32_display_info *w32_term_init ();
 216 \f
 217 extern Lisp_Object w32_list_fonts ();
 218 extern struct font_info *w32_get_font_info (), *w32_query_font ();
 219 extern void w32_find_ccl_program();
 220 \f
 221 /* Each W32 frame object points to its own struct w32_display object
 222    in the output_data.w32 field.  The w32_display structure contains all
 223    the information that is specific to W32 windows.  */
 224
 225 struct w32_output
 226 {
 227   /* Menubar "widget" handle.  */
 228   HMENU menubar_widget;
 229
 230   /* Original palette (used to deselect real palette after drawing) */
 231   HPALETTE old_palette;
 232
 233   /* Position of the W32 window (x and y offsets in root window).  */
 234   int left_pos;
 235   int top_pos;
 236
 237   /* Border width of the W32 window as known by the window system.  */
 238   int border_width;
 239
 240   /* Size of the W32 window in pixels.  */
 241   int pixel_height, pixel_width;
 242
 243   /* Height of a line, in pixels.  */
 244   int line_height;
 245
 246   /* Width of the internal border.  This is a line of background color
 247      just inside the window's border.  When the frame is selected,
 248      a highlighting is displayed inside the internal border.  */
 249   int internal_border_width;
 250
 251   /* The window used for this frame.
 252      May be zero while the frame object is being created
 253      and the window has not yet been created.  */
 254   Window window_desc;
 255
 256   /* The window that is the parent of this window.
 257      Usually this is a window that was made by the window manager,
 258      but it can be the root window, and it can be explicitly specified
 259      (see the explicit_parent field, below).  */
 260   Window parent_desc;
 261
 262   /* Default ASCII font of this frame. */
 263   XFontStruct *font;
 264
 265   /* The baseline position of the default ASCII font.  */
 266   int font_baseline;
 267
 268   /* If a fontset is specified for this frame instead of font, this
 269      value contains an ID of the fontset, else -1.  */
 270   int fontset;
 271
 272   /* Pixel values used for various purposes.
 273      border_pixel may be -1 meaning use a gray tile.  */
 274   unsigned long background_pixel;
 275   unsigned long foreground_pixel;
 276   unsigned long cursor_pixel;
 277   unsigned long border_pixel;
 278   unsigned long mouse_pixel;
 279   unsigned long cursor_foreground_pixel;
 280
 281   /* Descriptor for the cursor in use for this window.  */
 282   Cursor text_cursor;
 283   Cursor nontext_cursor;
 284   Cursor modeline_cursor;
 285   Cursor cross_cursor;
 286
 287   /* Flag to set when the window needs to be completely repainted.  */
 288   int needs_exposure;
 289
 290   /* What kind of text cursor is drawn in this window right now?
 291      (If there is no cursor (phys_cursor_x < 0), then this means nothing.)  */
 292   enum text_cursor_kinds current_cursor;
 293
 294   /* What kind of text cursor should we draw in the future?
 295      This should always be filled_box_cursor or bar_cursor.  */
 296   enum text_cursor_kinds desired_cursor;
 297
 298   /* Width of bar cursor (if we are using that).  */
 299   int cursor_width;
 300
 301   DWORD dwStyle;
 302
 303   /* The size of the extra width currently allotted for vertical
 304      scroll bars, in pixels.  */
 305   int vertical_scroll_bar_extra;
 306
 307   /* Table of parameter faces for this frame.  Any resources (pixel
 308      values, fonts) referred to here have been allocated explicitly
 309      for this face, and should be freed if we change the face.  */
 310   struct face **param_faces;
 311   int n_param_faces;
 312
 313   /* Table of computed faces for this frame.  These are the faces
 314      whose indexes go into the upper bits of a glyph, computed by
 315      combining the parameter faces specified by overlays, text
 316      properties, and what have you.  The resources mentioned here
 317      are all shared with parameter faces.  */
 318   struct face **computed_faces;
 319   int n_computed_faces;         /* How many are valid */
 320   int size_computed_faces;      /* How many are allocated */
 321
 322   /* This is the gravity value for the specified window position.  */
 323   int win_gravity;
 324
 325   /* The geometry flags for this window.  */
 326   int size_hint_flags;
 327
 328   /* This is the Emacs structure for the display this frame is on.  */
 329   /* struct w32_display_info *display_info; */
 330
 331   /* Nonzero means our parent is another application's window
 332      and was explicitly specified.  */
 333   char explicit_parent;
 334
 335   /* Nonzero means tried already to make this frame visible.  */
 336   char asked_for_visible;
 337
 338   /* Nonzero means menubar is currently active.  */
 339   char menubar_active;
 340
 341   /* Nonzero means menubar is about to become active, but should be
 342      brought up to date first.  */
 343   volatile char pending_menu_activation;
 344 };
 345
 346 /* Get at the computed faces of an X window frame.  */
 347 #define FRAME_PARAM_FACES(f) ((f)->output_data.w32->param_faces)
 348 #define FRAME_N_PARAM_FACES(f) ((f)->output_data.w32->n_param_faces)
 349 #define FRAME_DEFAULT_PARAM_FACE(f) (FRAME_PARAM_FACES (f)[0])
 350 #define FRAME_MODE_LINE_PARAM_FACE(f) (FRAME_PARAM_FACES (f)[1])
 351
 352 #define FRAME_COMPUTED_FACES(f) ((f)->output_data.w32->computed_faces)
 353 #define FRAME_N_COMPUTED_FACES(f) ((f)->output_data.w32->n_computed_faces)
 354 #define FRAME_SIZE_COMPUTED_FACES(f) ((f)->output_data.w32->size_computed_faces)
 355 #define FRAME_DEFAULT_FACE(f) ((f)->output_data.w32->computed_faces[0])
 356 #define FRAME_MODE_LINE_FACE(f) ((f)->output_data.w32->computed_faces[1])
 357
 358 /* Return the window associated with the frame F.  */
 359 #define FRAME_W32_WINDOW(f) ((f)->output_data.w32->window_desc)
 360
 361 #define FRAME_FOREGROUND_PIXEL(f) ((f)->output_data.w32->foreground_pixel)
 362 #define FRAME_BACKGROUND_PIXEL(f) ((f)->output_data.w32->background_pixel)
 363 #define FRAME_FONT(f) ((f)->output_data.w32->font)
 364 #define FRAME_FONTSET(f) ((f)->output_data.w32->fontset)
 365 #define FRAME_INTERNAL_BORDER_WIDTH(f) ((f)->output_data.w32->internal_border_width)
 366
 367 /* This gives the w32_display_info structure for the display F is on.  */
 368 #define FRAME_W32_DISPLAY_INFO(f) (&one_w32_display_info)
 369
 370 /* This is the 'font_info *' which frame F has.  */
 371 #define FRAME_W32_FONT_TABLE(f) (FRAME_W32_DISPLAY_INFO (f)->font_table)
 372
 373 /* These two really ought to be called FRAME_PIXEL_{WIDTH,HEIGHT}.  */
 374 #define PIXEL_WIDTH(f) ((f)->output_data.w32->pixel_width)
 375 #define PIXEL_HEIGHT(f) ((f)->output_data.w32->pixel_height)
 376 #define FRAME_LINE_HEIGHT(f) ((f)->output_data.w32->line_height)
 377
 378 #define FRAME_DESIRED_CURSOR(f) ((f)->output_data.w32->desired_cursor)
 379
 380 \f
 381 /* W32-specific scroll bar stuff.  */
 382
 383 /* We represent scroll bars as lisp vectors.  This allows us to place
 384    references to them in windows without worrying about whether we'll
 385    end up with windows referring to dead scroll bars; the garbage
 386    collector will free it when its time comes.
 387
 388    We use struct scroll_bar as a template for accessing fields of the
 389    vector.  */
 390
 391 struct scroll_bar {
 392
 393   /* These fields are shared by all vectors.  */
 394   EMACS_INT size_from_Lisp_Vector_struct;
 395   struct Lisp_Vector *next_from_Lisp_Vector_struct;
 396
 397   /* The window we're a scroll bar for.  */
 398   Lisp_Object window;
 399
 400   /* The next and previous in the chain of scroll bars in this frame.  */
 401   Lisp_Object next, prev;
 402
 403   /* The window representing this scroll bar.  Since this is a full
 404      32-bit quantity, we store it split into two 32-bit values.  */
 405   Lisp_Object w32_window_low, w32_window_high;
 406
 407   /* The position and size of the scroll bar in pixels, relative to the
 408      frame.  */
 409   Lisp_Object top, left, width, height;
 410
 411   /* The starting and ending positions of the handle, relative to the
 412      handle area (i.e. zero is the top position, not
 413      SCROLL_BAR_TOP_BORDER).  If they're equal, that means the handle
 414      hasn't been drawn yet.
 415
 416      These are not actually the locations where the beginning and end
 417      are drawn; in order to keep handles from becoming invisible when
 418      editing large files, we establish a minimum height by always
 419      drawing handle bottoms VERTICAL_SCROLL_BAR_MIN_HANDLE pixels below
 420      where they would be normally; the bottom and top are in a
 421      different co-ordinate system.  */
 422   Lisp_Object start, end;
 423
 424   /* If the scroll bar handle is currently being dragged by the user,
 425      this is the number of pixels from the top of the handle to the
 426      place where the user grabbed it.  If the handle isn't currently
 427      being dragged, this is Qnil.  */
 428   Lisp_Object dragging;
 429 };
 430
 431 /* The number of elements a vector holding a struct scroll_bar needs.  */
 432 #define SCROLL_BAR_VEC_SIZE                                     \
 433   ((sizeof (struct scroll_bar)                                  \
 434     - sizeof (EMACS_INT) - sizeof (struct Lisp_Vector *))       \
 435    / sizeof (Lisp_Object))
 436
 437 /* Turning a lisp vector value into a pointer to a struct scroll_bar.  */
 438 #define XSCROLL_BAR(vec) ((struct scroll_bar *) XVECTOR (vec))
 439
 440
 441 /* Building a 32-bit C integer from two 16-bit lisp integers.  */
 442 #define SCROLL_BAR_PACK(low, high) (XINT (high) << 16 | XINT (low))
 443
 444 /* Setting two lisp integers to the low and high words of a 32-bit C int.  */
 445 #define SCROLL_BAR_UNPACK(low, high, int32) \
 446   (XSETINT ((low),   (int32)        & 0xffff), \
 447    XSETINT ((high), ((int32) >> 16) & 0xffff))
 448
 449
 450 /* Extract the window id of the scroll bar from a struct scroll_bar.  */
 451 #define SCROLL_BAR_W32_WINDOW(ptr) \
 452   ((Window) SCROLL_BAR_PACK ((ptr)->w32_window_low, (ptr)->w32_window_high))
 453
 454 /* Store a window id in a struct scroll_bar.  */
 455 #define SET_SCROLL_BAR_W32_WINDOW(ptr, id) \
 456   (SCROLL_BAR_UNPACK ((ptr)->w32_window_low, (ptr)->w32_window_high, (int) id))
 457
 458
 459 /* Return the outside pixel height for a vertical scroll bar HEIGHT
 460    rows high on frame F.  */
 461 #define VERTICAL_SCROLL_BAR_PIXEL_HEIGHT(f, height) \
 462   ((height) * (f)->output_data.w32->line_height)
 463
 464 /* Return the inside width of a vertical scroll bar, given the outside
 465    width.  */
 466 #define VERTICAL_SCROLL_BAR_INSIDE_WIDTH(width) \
 467   ((width) - VERTICAL_SCROLL_BAR_LEFT_BORDER - VERTICAL_SCROLL_BAR_RIGHT_BORDER)
 468
 469 /* Return the length of the rectangle within which the top of the
 470    handle must stay.  This isn't equivalent to the inside height,
 471    because the scroll bar handle has a minimum height.
 472
 473    This is the real range of motion for the scroll bar, so when we're
 474    scaling buffer positions to scroll bar positions, we use this, not
 475    VERTICAL_SCROLL_BAR_INSIDE_HEIGHT.  */
 476 #define VERTICAL_SCROLL_BAR_TOP_RANGE(height) \
 477   (VERTICAL_SCROLL_BAR_INSIDE_HEIGHT (height) - VERTICAL_SCROLL_BAR_MIN_HANDLE)
 478
 479 /* Return the inside height of vertical scroll bar, given the outside
 480    height.  See VERTICAL_SCROLL_BAR_TOP_RANGE too.  */
 481 #define VERTICAL_SCROLL_BAR_INSIDE_HEIGHT(height) \
 482   ((height) - VERTICAL_SCROLL_BAR_TOP_BORDER - VERTICAL_SCROLL_BAR_BOTTOM_BORDER)
 483
 484
 485 /* Border widths for scroll bars.
 486
 487    Scroll bar windows don't have any borders; their border width is
 488    set to zero, and we redraw borders ourselves.  This makes the code
 489    a bit cleaner, since we don't have to convert between outside width
 490    (used when relating to the rest of the screen) and inside width
 491    (used when sizing and drawing the scroll bar window itself).
 492
 493    The handle moves up and down/back and forth in a rectangle inset
 494    from the edges of the scroll bar.  These are widths by which we
 495    inset the handle boundaries from the scroll bar edges.  */
 496 #define VERTICAL_SCROLL_BAR_LEFT_BORDER (0)
 497 #define VERTICAL_SCROLL_BAR_RIGHT_BORDER (0)
 498 #define VERTICAL_SCROLL_BAR_TOP_BORDER (vertical_scroll_bar_top_border)
 499 #define VERTICAL_SCROLL_BAR_BOTTOM_BORDER (vertical_scroll_bar_bottom_border)
 500
 501 /* Minimum lengths for scroll bar handles, in pixels.  */
 502 #define VERTICAL_SCROLL_BAR_MIN_HANDLE (vertical_scroll_bar_min_handle)
 503
 504
 505 \f
 506 /* Manipulating pixel sizes and character sizes.
 507    Knowledge of which factors affect the overall size of the window should
 508    be hidden in these macros, if that's possible.
 509
 510    Return the upper/left pixel position of the character cell on frame F
 511    at ROW/COL.  */
 512 #define CHAR_TO_PIXEL_ROW(f, row) \
 513   ((f)->output_data.w32->internal_border_width \
 514    + (row) * (f)->output_data.w32->line_height)
 515 #define CHAR_TO_PIXEL_COL(f, col) \
 516   ((f)->output_data.w32->internal_border_width \
 517    + (col) * FONT_WIDTH ((f)->output_data.w32->font))
 518
 519 /* Return the pixel width/height of frame F if it has
 520    WIDTH columns/HEIGHT rows.  */
 521 #define CHAR_TO_PIXEL_WIDTH(f, width) \
 522   (CHAR_TO_PIXEL_COL (f, width) \
 523    + (f)->output_data.w32->vertical_scroll_bar_extra \
 524    + (f)->output_data.w32->internal_border_width)
 525 #define CHAR_TO_PIXEL_HEIGHT(f, height) \
 526   (CHAR_TO_PIXEL_ROW (f, height) \
 527    + (f)->output_data.w32->internal_border_width)
 528
 529
 530 /* Return the row/column (zero-based) of the character cell containing
 531    the pixel on FRAME at ROW/COL.  */
 532 #define PIXEL_TO_CHAR_ROW(f, row) \
 533   (((row) - (f)->output_data.w32->internal_border_width) \
 534    / (f)->output_data.w32->line_height)
 535 #define PIXEL_TO_CHAR_COL(f, col) \
 536   (((col) - (f)->output_data.w32->internal_border_width) \
 537    / FONT_WIDTH ((f)->output_data.w32->font))
 538
 539 /* How many columns/rows of text can we fit in WIDTH/HEIGHT pixels on
 540    frame F?  */
 541 #define PIXEL_TO_CHAR_WIDTH(f, width) \
 542   (PIXEL_TO_CHAR_COL (f, ((width) \
 543                           - (f)->output_data.w32->internal_border_width \
 544                           - (f)->output_data.w32->vertical_scroll_bar_extra)))
 545 #define PIXEL_TO_CHAR_HEIGHT(f, height) \
 546   (PIXEL_TO_CHAR_ROW (f, ((height) \
 547                           - (f)->output_data.w32->internal_border_width)))
 548 \f
 549 /* Interface to the face code functions.  */
 550
 551 /* Create the first two computed faces for a frame -- the ones that
 552    have GC's.  */
 553 extern void init_frame_faces (/* FRAME_PTR */);
 554
 555 /* Free the resources for the faces associated with a frame.  */
 556 extern void free_frame_faces (/* FRAME_PTR */);
 557
 558 /* Given a computed face, find or make an equivalent display face
 559    in face_vector, and return a pointer to it.  */
 560 extern struct face *intern_face (/* FRAME_PTR, struct face * */);
 561
 562 /* Given a frame and a face name, return the face's ID number, or
 563    zero if it isn't a recognized face name.  */
 564 extern int face_name_id_number (/* FRAME_PTR, Lisp_Object */);
 565
 566 /* Return non-zero if FONT1 and FONT2 have the same size bounding box.
 567    We assume that they're both character-cell fonts.  */
 568 extern int same_size_fonts (/* XFontStruct *, XFontStruct * */);
 569
 570 /* Recompute the GC's for the default and modeline faces.
 571    We call this after changing frame parameters on which those GC's
 572    depend.  */
 573 extern void recompute_basic_faces (/* FRAME_PTR */);
 574
 575 /* Return the face ID associated with a buffer position POS.  Store
 576    into *ENDPTR the next position at which a different face is
 577    needed.  This does not take account of glyphs that specify their
 578    own face codes.  F is the frame in use for display, and W is a
 579    window displaying the current buffer.
 580
 581    REGION_BEG, REGION_END delimit the region, so it can be highlighted.  */
 582 extern int compute_char_face (/* FRAME_PTR frame,
 583                                  struct window *w,
 584                                  int pos,
 585                                  int region_beg, int region_end,
 586                                  int *endptr */);
 587 /* Return the face ID to use to display a special glyph which selects
 588    FACE_CODE as the face ID, assuming that ordinarily the face would
 589    be BASIC_FACE.  F is the frame.  */
 590 extern int compute_glyph_face (/* FRAME_PTR, int */);
 591
 592 extern void w32_fill_rect ();
 593 extern void w32_clear_window ();
 594
 595 #define w32_fill_area(f,hdc,pix,x,y,nx,ny) \
 596 { \
 597     RECT rect; \
 598     rect.left = x; \
 599     rect.top = y; \
 600     rect.right = x + nx; \
 601     rect.bottom = y + ny; \
 602     w32_fill_rect (f,hdc,pix,&rect); \
 603 }
 604
 605 #define w32_clear_rect(f,hdc,lprect) \
 606 w32_fill_rect (f,hdc,f->output_data.w32->background_pixel,lprect)
 607
 608 #define w32_clear_area(f,hdc,x,y,nx,ny) \
 609 w32_fill_area (f,hdc,f->output_data.w32->background_pixel,x,y,nx,ny)
 610
 611 extern struct font_info *w32_load_font ();
 612 extern void w32_unload_font ();
 613
 614 /* Define for earlier versions of Visual C */
 615 #ifndef WM_MOUSEWHEEL
 616 #define WM_MOUSEWHEEL                  (WM_MOUSELAST + 1)
 617 #endif /* WM_MOUSEWHEEL */
 618 #ifndef MSH_MOUSEWHEEL
 619 #define MSH_MOUSEWHEEL                 "MSWHEEL_ROLLMSG"
 620 #endif /* MSH_MOUSEWHEEL */
 621
 622 #define WM_EMACS_START                 (WM_USER + 1)
 623 #define WM_EMACS_KILL                  (WM_EMACS_START + 0)
 624 #define WM_EMACS_CREATEWINDOW          (WM_EMACS_START + 1)
 625 #define WM_EMACS_DONE                  (WM_EMACS_START + 2)
 626 #define WM_EMACS_CREATESCROLLBAR       (WM_EMACS_START + 3)
 627 #define WM_EMACS_SHOWWINDOW            (WM_EMACS_START + 4)
 628 #define WM_EMACS_SETWINDOWPOS          (WM_EMACS_START + 5)
 629 #define WM_EMACS_DESTROYWINDOW         (WM_EMACS_START + 6)
 630 #define WM_EMACS_TRACKPOPUPMENU        (WM_EMACS_START + 7)
 631 #define WM_EMACS_SETFOCUS              (WM_EMACS_START + 8)
 632 #define WM_EMACS_SETFOREGROUND         (WM_EMACS_START + 9)
 633 #define WM_EMACS_SETLOCALE             (WM_EMACS_START + 10)
 634 #define WM_EMACS_SETKEYBOARDLAYOUT     (WM_EMACS_START + 11)
 635 #define WM_EMACS_REGISTER_HOT_KEY      (WM_EMACS_START + 12)
 636 #define WM_EMACS_UNREGISTER_HOT_KEY    (WM_EMACS_START + 13)
 637 #define WM_EMACS_TOGGLE_LOCK_KEY       (WM_EMACS_START + 14)
 638 #define WM_EMACS_END                   (WM_EMACS_START + 15)
 639
 640 #define WND_FONTWIDTH_INDEX    (0)
 641 #define WND_LINEHEIGHT_INDEX   (4)
 642 #define WND_BORDER_INDEX       (8)
 643 #define WND_SCROLLBAR_INDEX    (12)
 644 #define WND_BACKGROUND_INDEX   (16)
 645 #define WND_LAST_INDEX         (20)
 646
 647 #define WND_EXTRA_BYTES     (WND_LAST_INDEX)
 648
 649 extern DWORD dwWindowsThreadId;
 650 extern HANDLE hWindowsThread;
 651 extern DWORD dwMainThreadId;
 652 extern HANDLE hMainThread;
 653
 654 typedef struct W32Msg {
 655     MSG msg;
 656     DWORD dwModifiers;
 657     RECT rect;
 658 } W32Msg;
 659
 660 /* Structure for recording message when input thread must return a
 661    result that depends on lisp thread to compute.  Lisp thread can
 662    complete deferred messages out of order.  */
 663 typedef struct deferred_msg
 664 {
 665   struct deferred_msg * next;
 666   W32Msg                w32msg;
 667   LRESULT               result;
 668   int                   completed;
 669 } deferred_msg;
 670
 671 extern CRITICAL_SECTION critsect;
 672
 673 extern void init_crit ();
 674 extern void delete_crit ();
 675
 676 extern void signal_quit ();
 677
 678 #define enter_crit() EnterCriticalSection (&critsect)
 679 #define leave_crit() LeaveCriticalSection (&critsect)
 680
 681 extern void select_palette (struct frame * f, HDC hdc);
 682 extern void deselect_palette (struct frame * f, HDC hdc);
 683 extern HDC get_frame_dc (struct frame * f);
 684 extern int release_frame_dc (struct frame * f, HDC hDC);
 685
 686 extern void drain_message_queue ();
 687
 688 extern BOOL get_next_msg ();
 689 extern BOOL post_msg ();
 690 extern void complete_deferred_msg (HWND hwnd, UINT msg, LRESULT result);
 691 extern void wait_for_sync ();
 692
 693 extern BOOL parse_button ();
 694
 695 /* Keypad command key support.  W32 doesn't have virtual keys defined
 696    for the function keys on the keypad (they are mapped to the standard
 697    fuction keys), so we define our own.  */
 698 #define VK_NUMPAD_BEGIN         0x92
 699 #define VK_NUMPAD_CLEAR         (VK_NUMPAD_BEGIN + 0)
 700 #define VK_NUMPAD_ENTER         (VK_NUMPAD_BEGIN + 1)
 701 #define VK_NUMPAD_PRIOR         (VK_NUMPAD_BEGIN + 2)
 702 #define VK_NUMPAD_NEXT          (VK_NUMPAD_BEGIN + 3)
 703 #define VK_NUMPAD_END           (VK_NUMPAD_BEGIN + 4)
 704 #define VK_NUMPAD_HOME          (VK_NUMPAD_BEGIN + 5)
 705 #define VK_NUMPAD_LEFT          (VK_NUMPAD_BEGIN + 6)
 706 #define VK_NUMPAD_UP            (VK_NUMPAD_BEGIN + 7)
 707 #define VK_NUMPAD_RIGHT         (VK_NUMPAD_BEGIN + 8)
 708 #define VK_NUMPAD_DOWN          (VK_NUMPAD_BEGIN + 9)
 709 #define VK_NUMPAD_INSERT        (VK_NUMPAD_BEGIN + 10)
 710 #define VK_NUMPAD_DELETE        (VK_NUMPAD_BEGIN + 11)
 711
 712 #ifndef VK_LWIN
 713 /* Older compiler environments don't have these defined.  */
 714 #define VK_LWIN                 0x5B
 715 #define VK_RWIN                 0x5C
 716 #define VK_APPS                 0x5D
 717 #endif
 718
 719 /* Support for treating Windows and Apps keys as modifiers.  These
 720    constants must not overlap with any of the dwControlKeyState flags in
 721    KEY_EVENT_RECORD.  */
 722 #define LEFT_WIN_PRESSED       0x8000
 723 #define RIGHT_WIN_PRESSED      0x4000
 724 #define APPS_PRESSED           0x2000