|
765
|
1 /* Define frame-object for GNU Emacs.
|
|
64770
|
2 Copyright (C) 1993, 1994, 1999, 2000, 2001, 2002, 2003, 2004,
|
|
|
3 2005 Free Software Foundation, Inc.
|
|
261
|
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
|
|
732
|
9 the Free Software Foundation; either version 2, or (at your option)
|
|
261
|
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
|
|
64084
|
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
|
20 Boston, MA 02110-1301, USA. */
|
|
261
|
21
|
|
35802
|
22 /* Don't multiply include: dispextern.h includes macterm.h which
|
|
|
23 includes frame.h some emacs source includes both dispextern.h and
|
|
|
24 frame.h */
|
|
|
25
|
|
35803
|
26 #ifndef EMACS_FRAME_H
|
|
|
27 #define EMACS_FRAME_H
|
|
35799
|
28
|
|
1776
|
29
|
|
|
30 /* Miscellanea. */
|
|
261
|
31
|
|
25029
|
32 /* Nonzero means don't assume anything about current contents of
|
|
|
33 actual terminal frame */
|
|
|
34
|
|
1776
|
35 extern int frame_garbaged;
|
|
|
36
|
|
|
37 /* Nonzero means FRAME_MESSAGE_BUF (selected_frame) is being used by
|
|
|
38 print. */
|
|
25029
|
39
|
|
1776
|
40 extern int message_buf_print;
|
|
|
41
|
|
|
42
|
|
16051
|
43 /* The structure representing a frame. */
|
|
261
|
44
|
|
|
45 enum output_method
|
|
25029
|
46 {
|
|
|
47 output_termcap,
|
|
|
48 output_x_window,
|
|
|
49 output_msdos_raw,
|
|
25524
|
50 output_w32,
|
|
|
51 output_mac
|
|
25029
|
52 };
|
|
261
|
53
|
|
16270
|
54 enum vertical_scroll_bar_type
|
|
25029
|
55 {
|
|
|
56 vertical_scroll_bar_none,
|
|
|
57 vertical_scroll_bar_left,
|
|
|
58 vertical_scroll_bar_right
|
|
|
59 };
|
|
16270
|
60
|
|
47133
|
61 enum text_cursor_kinds
|
|
|
62 {
|
|
|
63 DEFAULT_CURSOR = -2,
|
|
|
64 NO_CURSOR = -1,
|
|
|
65 FILLED_BOX_CURSOR,
|
|
|
66 HOLLOW_BOX_CURSOR,
|
|
|
67 BAR_CURSOR,
|
|
|
68 HBAR_CURSOR
|
|
|
69 };
|
|
|
70
|
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
diff
changeset
|
71 #if !defined(MSDOS) && !defined(WINDOWSNT) && !defined(MAC_OS)
|
|
26729
|
72
|
|
|
73 #if !defined(HAVE_X_WINDOWS)
|
|
|
74
|
|
26781
|
75 #define PIX_TYPE int
|
|
|
76
|
|
26729
|
77 /* A (mostly empty) x_output structure definition for building Emacs
|
|
|
78 on Unix and GNU/Linux without X support. */
|
|
|
79 struct x_output
|
|
|
80 {
|
|
|
81 PIX_TYPE background_pixel;
|
|
|
82 PIX_TYPE foreground_pixel;
|
|
|
83 };
|
|
|
84
|
|
|
85 #endif /* ! HAVE_X_WINDOWS */
|
|
|
86
|
|
26791
|
87
|
|
|
88 #define FRAME_FOREGROUND_PIXEL(f) ((f)->output_data.x->foreground_pixel)
|
|
|
89 #define FRAME_BACKGROUND_PIXEL(f) ((f)->output_data.x->background_pixel)
|
|
|
90
|
|
26729
|
91 /* A structure describing a termcap frame display. */
|
|
|
92 extern struct x_output tty_display;
|
|
|
93
|
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
diff
changeset
|
94 #endif /* ! MSDOS && ! WINDOWSNT && ! MAC_OS */
|
|
26729
|
95
|
|
765
|
96 struct frame
|
|
261
|
97 {
|
8826
9f5965fe4f6b
(struct frame, selected_frame, last_nonminibuf_frame): Use EMACS_INT.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
98 EMACS_INT size;
|
|
261
|
99 struct Lisp_Vector *next;
|
|
|
100
|
|
10208
|
101 /* All Lisp_Object components must come first.
|
|
|
102 Only EMACS_INT values can be intermixed with them.
|
|
|
103 That ensures they are all aligned normally. */
|
|
261
|
104
|
|
14215
|
105 /* Name of this frame: a Lisp string. It is used for looking up resources,
|
|
|
106 as well as for the title in some cases. */
|
|
261
|
107 Lisp_Object name;
|
|
|
108
|
|
12274
|
109 /* The name to use for the icon, the last time
|
|
|
110 it was refreshed. nil means not explicitly specified. */
|
|
|
111 Lisp_Object icon_name;
|
|
|
112
|
|
14215
|
113 /* This is the frame title specified explicitly, if any.
|
|
|
114 Usually it is nil. */
|
|
|
115 Lisp_Object title;
|
|
|
116
|
|
3591
|
117 /* The frame which should receive keystrokes that occur in this
|
|
1710
|
118 frame, or nil if they should go to the frame itself. This is
|
|
|
119 usually nil, but if the frame is minibufferless, we can use this
|
|
|
120 to redirect keystrokes to a surrogate minibuffer frame when
|
|
|
121 needed.
|
|
|
122
|
|
|
123 Note that a value of nil is different than having the field point
|
|
|
124 to the frame itself. Whenever the Fselect_frame function is used
|
|
|
125 to shift from one frame to the other, any redirections to the
|
|
|
126 original frame are shifted to the newly selected frame; if
|
|
|
127 focus_frame is nil, Fselect_frame will leave it alone. */
|
|
765
|
128 Lisp_Object focus_frame;
|
|
357
|
129
|
|
765
|
130 /* This frame's root window. Every frame has one.
|
|
|
131 If the frame has only a minibuffer window, this is it.
|
|
|
132 Otherwise, if the frame has a minibuffer window, this is its sibling. */
|
|
261
|
133 Lisp_Object root_window;
|
|
|
134
|
|
765
|
135 /* This frame's selected window.
|
|
|
136 Each frame has its own window hierarchy
|
|
|
137 and one of the windows in it is selected within the frame.
|
|
|
138 The selected window of the selected frame is Emacs's selected window. */
|
|
261
|
139 Lisp_Object selected_window;
|
|
|
140
|
|
765
|
141 /* This frame's minibuffer window.
|
|
|
142 Most frames have their own minibuffer windows,
|
|
|
143 but only the selected frame's minibuffer window
|
|
261
|
144 can actually appear to exist. */
|
|
|
145 Lisp_Object minibuffer_window;
|
|
|
146
|
|
765
|
147 /* Parameter alist of this frame.
|
|
|
148 These are the parameters specified when creating the frame
|
|
|
149 or modified with modify-frame-parameters. */
|
|
261
|
150 Lisp_Object param_alist;
|
|
|
151
|
|
49600
|
152 /* List of scroll bars on this frame.
|
|
1776
|
153 Actually, we don't specify exactly what is stored here at all; the
|
|
1994
|
154 scroll bar implementation code can use it to store anything it likes.
|
|
1776
|
155 This field is marked by the garbage collector. It is here
|
|
|
156 instead of in the `display' structure so that the garbage
|
|
|
157 collector doesn't need to look inside the window-system-dependent
|
|
|
158 structure. */
|
|
1994
|
159 Lisp_Object scroll_bars;
|
|
|
160 Lisp_Object condemned_scroll_bars;
|
|
1776
|
161
|
|
15098
|
162 /* Vector describing the items to display in the menu bar.
|
|
|
163 Each item has four elements in this vector.
|
|
|
164 They are KEY, STRING, SUBMAP, and HPOS.
|
|
|
165 (HPOS is not used in when the X toolkit is in use.)
|
|
|
166 There are four additional elements of nil at the end, to terminate. */
|
|
2148
|
167 Lisp_Object menu_bar_items;
|
|
|
168
|
|
2396
|
169 /* Alist of elements (FACE-NAME . FACE-VECTOR-DATA). */
|
|
|
170 Lisp_Object face_alist;
|
|
|
171
|
|
10208
|
172 /* A vector that records the entire structure of this frame's menu bar.
|
|
|
173 For the format of the data, see extensive comments in xmenu.c.
|
|
|
174 Only the X toolkit version uses this. */
|
|
|
175 Lisp_Object menu_bar_vector;
|
|
|
176 /* Number of elements in the vector that have meaningful data. */
|
|
|
177 EMACS_INT menu_bar_items_used;
|
|
|
178
|
|
|
179 /* Predicate for selecting buffers for other-buffer. */
|
|
|
180 Lisp_Object buffer_predicate;
|
|
|
181
|
|
17222
|
182 /* List of buffers viewed in this frame, for other-buffer. */
|
|
|
183 Lisp_Object buffer_list;
|
|
|
184
|
|
25029
|
185 /* A dummy window used to display menu bars under X when no X
|
|
|
186 toolkit support is available. */
|
|
|
187 Lisp_Object menu_bar_window;
|
|
|
188
|
|
25544
|
189 /* A window used to display the tool-bar of a frame. */
|
|
|
190 Lisp_Object tool_bar_window;
|
|
25029
|
191
|
|
25544
|
192 /* Desired and current tool-bar items. */
|
|
33759
|
193 Lisp_Object tool_bar_items;
|
|
25029
|
194
|
|
25544
|
195 /* Desired and current contents displayed in tool_bar_window. */
|
|
|
196 Lisp_Object desired_tool_bar_string, current_tool_bar_string;
|
|
25029
|
197
|
|
17222
|
198 /* beyond here, there should be no more Lisp_Object components. */
|
|
10208
|
199
|
|
25029
|
200 /* Cache of realized faces. */
|
|
|
201 struct face_cache *face_cache;
|
|
10208
|
202
|
|
25029
|
203 /* A buffer to hold the frame's name. We can't use the Lisp
|
|
|
204 string's pointer (`name', above) because it might get relocated. */
|
|
11493
|
205 char *namebuf;
|
|
|
206
|
|
25029
|
207 /* Glyph pool and matrix. */
|
|
|
208 struct glyph_pool *current_pool;
|
|
|
209 struct glyph_pool *desired_pool;
|
|
|
210 struct glyph_matrix *desired_matrix;
|
|
|
211 struct glyph_matrix *current_matrix;
|
|
10208
|
212
|
|
25029
|
213 /* 1 means that glyphs on this frame have been initialized so it can
|
|
|
214 be used for output. */
|
|
|
215 unsigned glyphs_initialized_p : 1;
|
|
|
216
|
|
49322
|
217 #if defined (USE_GTK)
|
|
|
218 /* Nonzero means using a tool bar that comes from the toolkit. */
|
|
|
219 int external_tool_bar;
|
|
|
220 #endif
|
|
|
221
|
|
25544
|
222 /* Margin at the top of the frame. Used to display the tool-bar. */
|
|
|
223 int tool_bar_lines;
|
|
25029
|
224
|
|
33759
|
225 int n_tool_bar_items;
|
|
49600
|
226
|
|
25029
|
227 /* A buffer for decode_mode_line. */
|
|
|
228 char *decode_mode_spec_buffer;
|
|
10208
|
229
|
|
|
230 /* See do_line_insertion_deletion_costs for info on these arrays. */
|
|
|
231 /* Cost of inserting 1 line on this frame */
|
|
|
232 int *insert_line_cost;
|
|
|
233 /* Cost of deleting 1 line on this frame */
|
|
|
234 int *delete_line_cost;
|
|
|
235 /* Cost of inserting n lines on this frame */
|
|
|
236 int *insert_n_lines_cost;
|
|
|
237 /* Cost of deleting n lines on this frame */
|
|
|
238 int *delete_n_lines_cost;
|
|
|
239
|
|
51195
|
240 /* Size of this frame, excluding fringes, scroll bars etc.,
|
|
|
241 in units of canonical characters. */
|
|
|
242 EMACS_INT text_lines, text_cols;
|
|
|
243
|
|
|
244 /* Total size of this frame (i.e. its native window), in units of
|
|
|
245 canonical characters. */
|
|
|
246 EMACS_INT total_lines, total_cols;
|
|
|
247
|
|
|
248 /* New text height and width for pending size change.
|
|
|
249 0 if no change pending. */
|
|
|
250 int new_text_lines, new_text_cols;
|
|
|
251
|
|
|
252 /* Pixel position of the frame window (x and y offsets in root window). */
|
|
|
253 int left_pos, top_pos;
|
|
|
254
|
|
|
255 /* Size of the frame window in pixels. */
|
|
|
256 int pixel_height, pixel_width;
|
|
10208
|
257
|
|
51195
|
258 /* These many pixels are the difference between the outer window (i.e. the
|
|
|
259 left and top of the window manager decoration) and FRAME_X_WINDOW. */
|
|
|
260 int x_pixels_diff, y_pixels_diff;
|
|
|
261
|
|
|
262 /* This is the gravity value for the specified window position. */
|
|
|
263 int win_gravity;
|
|
|
264
|
|
|
265 /* The geometry flags for this window. */
|
|
|
266 int size_hint_flags;
|
|
|
267
|
|
|
268 /* Border width of the frame window as known by the (X) window system. */
|
|
|
269 int border_width;
|
|
|
270
|
|
|
271 /* Width of the internal border. This is a line of background color
|
|
|
272 just inside the window's border. When the frame is selected,
|
|
|
273 a highlighting is displayed inside the internal border. */
|
|
|
274 int internal_border_width;
|
|
|
275
|
|
|
276 /* Canonical X unit. Width of default font, in pixels. */
|
|
|
277 int column_width;
|
|
|
278
|
|
59203
|
279 /* Widht of space glyph of default font, in pixels. */
|
|
|
280 int space_width;
|
|
|
281
|
|
51195
|
282 /* Canonical Y unit. Height of a line, in pixels. */
|
|
|
283 int line_height;
|
|
10208
|
284
|
|
765
|
285 /* The output method says how the contents of this frame
|
|
261
|
286 are displayed. It could be using termcap, or using an X window. */
|
|
|
287 enum output_method output_method;
|
|
|
288
|
|
|
289 /* A structure of auxiliary data used for displaying the contents.
|
|
12665
|
290 struct x_output is used for X window frames;
|
|
49600
|
291 it is defined in xterm.h.
|
|
16588
|
292 struct w32_output is used for W32 window frames;
|
|
13411
|
293 it is defined in w32term.h. */
|
|
25029
|
294 union output_data
|
|
|
295 {
|
|
|
296 struct x_output *x;
|
|
|
297 struct w32_output *w32;
|
|
25524
|
298 struct mac_output *mac;
|
|
31900
|
299 EMACS_INT nothing;
|
|
25029
|
300 }
|
|
|
301 output_data;
|
|
261
|
302
|
|
51195
|
303 /* Total width of fringes reserved for drawing truncation bitmaps,
|
|
|
304 continuation bitmaps and alike. The width is in canonical char
|
|
|
305 units of the frame. This must currently be the case because window
|
|
|
306 sizes aren't pixel values. If it weren't the case, we wouldn't be
|
|
|
307 able to split windows horizontally nicely. */
|
|
|
308 int fringe_cols;
|
|
|
309
|
|
|
310 /* The extra width (in pixels) currently allotted for fringes. */
|
|
|
311 int left_fringe_width, right_fringe_width;
|
|
|
312
|
|
11005
|
313 #ifdef MULTI_KBOARD
|
|
|
314 /* A pointer to the kboard structure associated with this frame.
|
|
|
315 For termcap frames, this points to initial_kboard. For X frames,
|
|
|
316 it will be the same as display.x->display_info->kboard. */
|
|
11351
|
317 struct kboard *kboard;
|
|
11005
|
318 #endif
|
|
|
319
|
|
51195
|
320 /* See FULLSCREEN_ enum below */
|
|
|
321 int want_fullscreen;
|
|
|
322
|
|
2148
|
323 /* Number of lines of menu bar. */
|
|
|
324 int menu_bar_lines;
|
|
|
325
|
|
49322
|
326 #if defined (USE_X_TOOLKIT) || defined (HAVE_NTGUI) || defined (MAC_OS) \
|
|
|
327 || defined (USE_GTK)
|
|
5657
|
328 /* Nonzero means using a menu bar that comes from the X toolkit. */
|
|
|
329 int external_menu_bar;
|
|
|
330 #endif
|
|
|
331
|
|
765
|
332 /* Nonzero if last attempt at redisplay on this frame was preempted. */
|
|
261
|
333 char display_preempted;
|
|
|
334
|
|
1653
|
335 /* visible is nonzero if the frame is currently displayed; we check
|
|
|
336 it to see if we should bother updating the frame's contents.
|
|
1710
|
337 DON'T SET IT DIRECTLY; instead, use FRAME_SET_VISIBLE.
|
|
1653
|
338
|
|
1776
|
339 Note that, since invisible frames aren't updated, whenever a
|
|
|
340 frame becomes visible again, it must be marked as garbaged. The
|
|
|
341 FRAME_SAMPLE_VISIBILITY macro takes care of this.
|
|
|
342
|
|
19696
|
343 On Windows NT/9X, to avoid wasting effort updating visible frames
|
|
|
344 that are actually completely obscured by other windows on the
|
|
|
345 display, we bend the meaning of visible slightly: if greater than
|
|
|
346 1, then the frame is obscured - we still consider it to be
|
|
|
347 "visible" as seen from lisp, but we don't bother updating it. We
|
|
|
348 must take care to garbage the frame when it ceaces to be obscured
|
|
|
349 though. Note that these semantics are only used on NT/9X.
|
|
|
350
|
|
1653
|
351 iconified is nonzero if the frame is currently iconified.
|
|
|
352
|
|
|
353 Asynchronous input handlers should NOT change these directly;
|
|
|
354 instead, they should change async_visible or async_iconified, and
|
|
|
355 let the FRAME_SAMPLE_VISIBILITY macro set visible and iconified
|
|
|
356 at the next redisplay.
|
|
261
|
357
|
|
1653
|
358 These should probably be considered read-only by everyone except
|
|
|
359 FRAME_SAMPLE_VISIBILITY.
|
|
|
360
|
|
6183
|
361 These two are mutually exclusive. They might both be zero, if the
|
|
1653
|
362 frame has been made invisible without an icon. */
|
|
|
363 char visible, iconified;
|
|
|
364
|
|
|
365 /* Asynchronous input handlers change these, and
|
|
|
366 FRAME_SAMPLE_VISIBILITY copies them into visible and iconified.
|
|
|
367 See FRAME_SAMPLE_VISIBILITY, below. */
|
|
29439
|
368 volatile char async_visible, async_iconified;
|
|
261
|
369
|
|
765
|
370 /* Nonzero if this frame should be redrawn. */
|
|
29439
|
371 volatile char garbaged;
|
|
261
|
372
|
|
765
|
373 /* True if frame actually has a minibuffer window on it.
|
|
|
374 0 if using a minibuffer window that isn't on this frame. */
|
|
261
|
375 char has_minibuffer;
|
|
49600
|
376
|
|
765
|
377 /* 0 means, if this frame has just one window,
|
|
261
|
378 show no modeline for that window. */
|
|
|
379 char wants_modeline;
|
|
|
380
|
|
1710
|
381 /* Non-zero if the hardware device this frame is displaying on can
|
|
1994
|
382 support scroll bars. */
|
|
|
383 char can_have_scroll_bars;
|
|
1710
|
384
|
|
1994
|
385 /* If can_have_scroll_bars is non-zero, this is non-zero if we should
|
|
1710
|
386 actually display them on this frame. */
|
|
16270
|
387 enum vertical_scroll_bar_type vertical_scroll_bar_type;
|
|
1710
|
388
|
|
47133
|
389 /* What kind of text cursor should we draw in the future?
|
|
|
390 This should always be filled_box_cursor or bar_cursor. */
|
|
|
391 enum text_cursor_kinds desired_cursor;
|
|
|
392
|
|
|
393 /* Width of bar cursor (if we are using that). */
|
|
|
394 int cursor_width;
|
|
|
395
|
|
|
396 /* What kind of text cursor should we draw when the cursor blinks off?
|
|
|
397 This can be filled_box_cursor or bar_cursor or no_cursor. */
|
|
|
398 enum text_cursor_kinds blink_off_cursor;
|
|
|
399
|
|
|
400 /* Width of bar cursor (if we are using that) for blink-off state. */
|
|
|
401 int blink_off_cursor_width;
|
|
|
402
|
|
765
|
403 /* Non-0 means raise this frame to the top of the heap when selected. */
|
|
261
|
404 char auto_raise;
|
|
|
405
|
|
765
|
406 /* Non-0 means lower this frame to the bottom of the stack when left. */
|
|
261
|
407 char auto_lower;
|
|
|
408
|
|
765
|
409 /* True if frame's root window can't be split. */
|
|
261
|
410 char no_split;
|
|
|
411
|
|
998
|
412 /* If this is set, then Emacs won't change the frame name to indicate
|
|
|
413 the current buffer, etcetera. If the user explicitly sets the frame
|
|
|
414 name, this gets set. If the user sets the name to Qnil, this is
|
|
|
415 cleared. */
|
|
|
416 char explicit_name;
|
|
|
417
|
|
10665
|
418 /* Nonzero if size of some window on this frame has changed. */
|
|
|
419 char window_sizes_changed;
|
|
|
420
|
|
765
|
421 /* Storage for messages to this frame. */
|
|
261
|
422 char *message_buf;
|
|
|
423
|
|
|
424 /* Nonnegative if current redisplay should not do scroll computation
|
|
|
425 for lines beyond a certain vpos. This is the vpos. */
|
|
|
426 int scroll_bottom_vpos;
|
7094
b473ea5a3473
(struct frame): New fields menu_bar_vector and menu_bar_items_used.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
427
|
|
51195
|
428 /* Configured width of the scroll bar, in pixels and in characters.
|
|
|
429 config_scroll_bar_cols tracks config_scroll_bar_width if the
|
|
|
430 latter is positive; a zero value in config_scroll_bar_width means
|
|
|
431 to compute the actual width on the fly, using config_scroll_bar_cols
|
|
|
432 and the current font width. */
|
|
|
433 int config_scroll_bar_width;
|
|
|
434 int config_scroll_bar_cols;
|
|
|
435
|
|
|
436 /* The size of the extra width currently allotted for vertical
|
|
|
437 scroll bars in this frame, in pixels. */
|
|
|
438 int scroll_bar_actual_width;
|
|
10120
|
439
|
|
|
440 /* The baud rate that was used to calculate costs for this frame. */
|
|
|
441 int cost_calculation_baud_rate;
|
|
12543
|
442
|
|
|
443 /* Nonzero if the mouse has moved on this display
|
|
|
444 since the last time we checked. */
|
|
|
445 char mouse_moved;
|
|
25527
|
446
|
|
|
447 /* Exponent for gamma correction of colors. 1/(VIEWING_GAMMA *
|
|
|
448 SCREEN_GAMMA) where viewing_gamma is 0.4545 and SCREEN_GAMMA is a
|
|
|
449 frame parameter. 0 means don't do gamma correction. */
|
|
|
450 double gamma;
|
|
28691
|
451
|
|
|
452 /* Additional space to put between text lines on this frame. */
|
|
|
453 int extra_line_spacing;
|
|
40511
|
454
|
|
|
455 /* Set to non-zero in change_frame_size when size of frame changed
|
|
|
456 Clear the frame in clear_garbaged_frames if set. */
|
|
|
457 unsigned resized_p : 1;
|
|
51665
|
458
|
|
53883
|
459 /* Set to non-zero in when we want for force a flush_display in
|
|
|
460 update_frame, usually after resizing the frame. */
|
|
|
461 unsigned force_flush_display_p : 1;
|
|
|
462
|
|
51665
|
463 /* Set to non-zero if the default face for the frame has been
|
|
|
464 realized. Reset to zero whenever the default face changes.
|
|
|
465 Used to see the difference between a font change and face change. */
|
|
|
466 unsigned default_face_done_p : 1;
|
|
64477
|
467
|
|
|
468 /* Set to non-zero if this frame has already been hscrolled during
|
|
|
469 current redisplay. */
|
|
|
470 unsigned already_hscrolled_p : 1;
|
|
65373
|
471
|
|
|
472 /* Set to non-zero when current redisplay has updated frame. */
|
|
|
473 unsigned updated_p : 1;
|
|
261
|
474 };
|
|
|
475
|
|
16051
|
476 #ifdef MULTI_KBOARD
|
|
11005
|
477 #define FRAME_KBOARD(f) ((f)->kboard)
|
|
|
478 #else
|
|
|
479 #define FRAME_KBOARD(f) (&the_only_kboard)
|
|
|
480 #endif
|
|
|
481
|
|
765
|
482 typedef struct frame *FRAME_PTR;
|
|
261
|
483
|
28417
4b675266db04
* lisp.h (XCONS, XSTRING, XSYMBOL, XFLOAT, XPROCESS, XWINDOW, XSUBR, XBUFFER):
Ken Raeburn <raeburn@raeburn.org>
diff
changeset
|
484 #define XFRAME(p) (eassert (GC_FRAMEP(p)),(struct frame *) XPNTR (p))
|
|
10288
|
485 #define XSETFRAME(a, b) (XSETPSEUDOVECTOR (a, b, PVEC_FRAME))
|
|
261
|
486
|
|
21814
|
487 /* Given a window, return its frame as a Lisp_Object. */
|
|
765
|
488 #define WINDOW_FRAME(w) (w)->frame
|
|
261
|
489
|
|
21814
|
490 /* Test a frame for particular kinds of display methods. */
|
|
|
491 #define FRAME_TERMCAP_P(f) ((f)->output_method == output_termcap)
|
|
13411
|
492 #define FRAME_X_P(f) ((f)->output_method == output_x_window)
|
|
16588
|
493 #define FRAME_W32_P(f) ((f)->output_method == output_w32)
|
|
15390
|
494 #define FRAME_MSDOS_P(f) ((f)->output_method == output_msdos_raw)
|
|
25524
|
495 #define FRAME_MAC_P(f) ((f)->output_method == output_mac)
|
|
13411
|
496
|
|
|
497 /* FRAME_WINDOW_P tests whether the frame is a window, and is
|
|
|
498 defined to be the predicate for the window system being used. */
|
|
25029
|
499
|
|
13411
|
500 #ifdef HAVE_X_WINDOWS
|
|
|
501 #define FRAME_WINDOW_P(f) FRAME_X_P (f)
|
|
|
502 #endif
|
|
|
503 #ifdef HAVE_NTGUI
|
|
16588
|
504 #define FRAME_WINDOW_P(f) FRAME_W32_P (f)
|
|
13411
|
505 #endif
|
44890
01b93e5e53a7
Patch for building Emacs on Mac OS X. April 26, 2002. See ChangeLog,
Andrew Choi <akochoi@shaw.ca>
diff
changeset
|
506 #ifdef MAC_OS
|
|
25524
|
507 #define FRAME_WINDOW_P(f) FRAME_MAC_P (f)
|
|
|
508 #endif
|
|
13568
|
509 #ifndef FRAME_WINDOW_P
|
|
|
510 #define FRAME_WINDOW_P(f) (0)
|
|
|
511 #endif
|
|
13411
|
512
|
|
21814
|
513 /* Nonzero if frame F is still alive (not deleted). */
|
|
12665
|
514 #define FRAME_LIVE_P(f) ((f)->output_data.nothing != 0)
|
|
21814
|
515
|
|
|
516 /* Nonzero if frame F is a minibuffer-only frame. */
|
|
765
|
517 #define FRAME_MINIBUF_ONLY_P(f) \
|
|
|
518 EQ (FRAME_ROOT_WINDOW (f), FRAME_MINIBUF_WINDOW (f))
|
|
21814
|
519
|
|
|
520 /* Nonzero if frame F contains a minibuffer window.
|
|
|
521 (If this is 0, F must use some other minibuffer window.) */
|
|
979
|
522 #define FRAME_HAS_MINIBUF_P(f) ((f)->has_minibuffer)
|
|
51195
|
523
|
|
|
524 /* Pixel height of frame F, including non-toolkit menu bar and
|
|
|
525 non-toolkit tool bar lines. */
|
|
|
526 #define FRAME_PIXEL_HEIGHT(f) ((f)->pixel_height)
|
|
|
527
|
|
|
528 /* Pixel width of frame F. */
|
|
|
529 #define FRAME_PIXEL_WIDTH(f) ((f)->pixel_width)
|
|
21814
|
530
|
|
51195
|
531 /* Height of frame F, measured in canonical lines, including
|
|
|
532 non-toolkit menu bar and non-toolkit tool bar lines. */
|
|
|
533 #define FRAME_LINES(f) (f)->text_lines
|
|
|
534
|
|
|
535 /* Width of frame F, measured in canonical character columns,
|
|
21814
|
536 not including scroll bars if any. */
|
|
51195
|
537 #define FRAME_COLS(f) (f)->text_cols
|
|
21814
|
538
|
|
|
539 /* Number of lines of frame F used for menu bar.
|
|
|
540 This is relevant on terminal frames and on
|
|
|
541 X Windows when not using the X toolkit.
|
|
51195
|
542 These lines are counted in FRAME_LINES. */
|
|
2148
|
543 #define FRAME_MENU_BAR_LINES(f) (f)->menu_bar_lines
|
|
21814
|
544
|
|
49322
|
545 /* Nonzero if this frame should display a tool bar
|
|
|
546 in a way that does not use any text lines. */
|
|
|
547 #if defined (USE_GTK)
|
|
|
548 #define FRAME_EXTERNAL_TOOL_BAR(f) (f)->external_tool_bar
|
|
|
549 #else
|
|
|
550 #define FRAME_EXTERNAL_TOOL_BAR(f) 0
|
|
|
551 #endif
|
|
|
552
|
|
25544
|
553 /* Number of lines of frame F used for the tool-bar. */
|
|
25029
|
554
|
|
25544
|
555 #define FRAME_TOOL_BAR_LINES(f) (f)->tool_bar_lines
|
|
25029
|
556
|
|
49322
|
557
|
|
25029
|
558 /* Lines above the top-most window in frame F. */
|
|
|
559
|
|
|
560 #define FRAME_TOP_MARGIN(F) \
|
|
25544
|
561 (FRAME_MENU_BAR_LINES (F) + FRAME_TOOL_BAR_LINES (F))
|
|
25029
|
562
|
|
21814
|
563 /* Nonzero if this frame should display a menu bar
|
|
|
564 in a way that does not use any text lines. */
|
|
49322
|
565 #if defined (USE_X_TOOLKIT) || defined (HAVE_NTGUI) || defined (MAC_OS) \
|
|
|
566 || defined (USE_GTK)
|
|
5657
|
567 #define FRAME_EXTERNAL_MENU_BAR(f) (f)->external_menu_bar
|
|
8233
|
568 #else
|
|
|
569 #define FRAME_EXTERNAL_MENU_BAR(f) 0
|
|
|
570 #endif
|
|
1710
|
571 #define FRAME_VISIBLE_P(f) ((f)->visible != 0)
|
|
21814
|
572
|
|
|
573 /* Nonzero if frame F is currently visible but hidden. */
|
|
19696
|
574 #define FRAME_OBSCURED_P(f) ((f)->visible > 1)
|
|
21814
|
575
|
|
|
576 /* Nonzero if frame F is currently iconified. */
|
|
|
577 #define FRAME_ICONIFIED_P(f) (f)->iconified
|
|
|
578
|
|
1710
|
579 #define FRAME_SET_VISIBLE(f,p) \
|
|
|
580 ((f)->async_visible = (p), FRAME_SAMPLE_VISIBILITY (f))
|
|
765
|
581 #define SET_FRAME_GARBAGED(f) (frame_garbaged = 1, f->garbaged = 1)
|
|
|
582 #define FRAME_GARBAGED_P(f) (f)->garbaged
|
|
21814
|
583
|
|
|
584 /* Nonzero means do not allow splitting this frame's window. */
|
|
765
|
585 #define FRAME_NO_SPLIT_P(f) (f)->no_split
|
|
21814
|
586
|
|
|
587 /* Not really implemented. */
|
|
765
|
588 #define FRAME_WANTS_MODELINE_P(f) (f)->wants_modeline
|
|
21814
|
589
|
|
|
590 /* Nonzero if a size change has been requested for frame F
|
|
|
591 but not yet really put into effect. This can be true temporarily
|
|
|
592 when an X event comes in at a bad time. */
|
|
10665
|
593 #define FRAME_WINDOW_SIZES_CHANGED(f) (f)->window_sizes_changed
|
|
21814
|
594
|
|
|
595 /* The minibuffer window of frame F, if it has one; otherwise nil. */
|
|
765
|
596 #define FRAME_MINIBUF_WINDOW(f) (f)->minibuffer_window
|
|
21814
|
597
|
|
|
598 /* The root window of the window tree of frame F. */
|
|
765
|
599 #define FRAME_ROOT_WINDOW(f) (f)->root_window
|
|
21814
|
600
|
|
|
601 /* The currently selected window of the window tree of frame F. */
|
|
765
|
602 #define FRAME_SELECTED_WINDOW(f) (f)->selected_window
|
|
21814
|
603
|
|
49600
|
604 #define FRAME_INSERT_COST(f) (f)->insert_line_cost
|
|
|
605 #define FRAME_DELETE_COST(f) (f)->delete_line_cost
|
|
765
|
606 #define FRAME_INSERTN_COST(f) (f)->insert_n_lines_cost
|
|
|
607 #define FRAME_DELETEN_COST(f) (f)->delete_n_lines_cost
|
|
|
608 #define FRAME_MESSAGE_BUF(f) (f)->message_buf
|
|
|
609 #define FRAME_SCROLL_BOTTOM_VPOS(f) (f)->scroll_bottom_vpos
|
|
|
610 #define FRAME_FOCUS_FRAME(f) (f)->focus_frame
|
|
21814
|
611
|
|
|
612 /* Nonzero if frame F supports scroll bars.
|
|
|
613 If this is zero, then it is impossible to enable scroll bars
|
|
|
614 on frame F. */
|
|
1994
|
615 #define FRAME_CAN_HAVE_SCROLL_BARS(f) ((f)->can_have_scroll_bars)
|
|
21814
|
616
|
|
|
617 /* This frame slot says whether scroll bars are currently enabled for frame F,
|
|
|
618 and which side they are on. */
|
|
16270
|
619 #define FRAME_VERTICAL_SCROLL_BAR_TYPE(f) ((f)->vertical_scroll_bar_type)
|
|
|
620 #define FRAME_HAS_VERTICAL_SCROLL_BARS(f) \
|
|
|
621 ((f)->vertical_scroll_bar_type != vertical_scroll_bar_none)
|
|
|
622 #define FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT(f) \
|
|
|
623 ((f)->vertical_scroll_bar_type == vertical_scroll_bar_left)
|
|
|
624 #define FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT(f) \
|
|
|
625 ((f)->vertical_scroll_bar_type == vertical_scroll_bar_right)
|
|
21814
|
626
|
|
|
627 /* Width that a scroll bar in frame F should have, if there is one.
|
|
|
628 Measured in pixels.
|
|
|
629 If scroll bars are turned off, this is still nonzero. */
|
|
51195
|
630 #define FRAME_CONFIG_SCROLL_BAR_WIDTH(f) ((f)->config_scroll_bar_width)
|
|
21814
|
631
|
|
|
632 /* Width that a scroll bar in frame F should have, if there is one.
|
|
|
633 Measured in columns (characters).
|
|
|
634 If scroll bars are turned off, this is still nonzero. */
|
|
51195
|
635 #define FRAME_CONFIG_SCROLL_BAR_COLS(f) ((f)->config_scroll_bar_cols)
|
|
21814
|
636
|
|
|
637 /* Width of a scroll bar in frame F, measured in columns (characters),
|
|
35798
|
638 but only if scroll bars are on the left. If scroll bars are on
|
|
|
639 the right in this frame, or there are no scroll bars, value is 0. */
|
|
|
640
|
|
51195
|
641 #define FRAME_LEFT_SCROLL_BAR_COLS(f) \
|
|
35798
|
642 (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f) \
|
|
51195
|
643 ? FRAME_CONFIG_SCROLL_BAR_COLS (f) \
|
|
35798
|
644 : 0)
|
|
|
645
|
|
51195
|
646 /* Width of a left scroll bar in frame F, measured in pixels */
|
|
|
647
|
|
|
648 #define FRAME_LEFT_SCROLL_BAR_AREA_WIDTH(f) \
|
|
|
649 (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f) \
|
|
|
650 ? (FRAME_CONFIG_SCROLL_BAR_COLS (f) * FRAME_COLUMN_WIDTH (f)) \
|
|
|
651 : 0)
|
|
|
652
|
|
35798
|
653 /* Width of a scroll bar in frame F, measured in columns (characters),
|
|
|
654 but only if scroll bars are on the right. If scroll bars are on
|
|
|
655 the left in this frame, or there are no scroll bars, value is 0. */
|
|
|
656
|
|
51195
|
657 #define FRAME_RIGHT_SCROLL_BAR_COLS(f) \
|
|
35798
|
658 (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f) \
|
|
51195
|
659 ? FRAME_CONFIG_SCROLL_BAR_COLS (f) \
|
|
16270
|
660 : 0)
|
|
21814
|
661
|
|
51195
|
662 /* Width of a right scroll bar area in frame F, measured in pixels */
|
|
|
663
|
|
|
664 #define FRAME_RIGHT_SCROLL_BAR_AREA_WIDTH(f) \
|
|
|
665 (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_RIGHT (f) \
|
|
|
666 ? (FRAME_CONFIG_SCROLL_BAR_COLS (f) * FRAME_COLUMN_WIDTH (f)) \
|
|
|
667 : 0)
|
|
|
668
|
|
|
669 /* Actual width of a scroll bar in frame F, measured in columns. */
|
|
|
670
|
|
|
671 #define FRAME_SCROLL_BAR_COLS(f) \
|
|
|
672 (FRAME_HAS_VERTICAL_SCROLL_BARS (f) \
|
|
|
673 ? FRAME_CONFIG_SCROLL_BAR_COLS (f) \
|
|
16270
|
674 : 0)
|
|
21814
|
675
|
|
51195
|
676 /* Actual width of a scroll bar area in frame F, measured in pixels. */
|
|
|
677
|
|
|
678 #define FRAME_SCROLL_BAR_AREA_WIDTH(f) \
|
|
|
679 (FRAME_HAS_VERTICAL_SCROLL_BARS (f) \
|
|
|
680 ? (FRAME_CONFIG_SCROLL_BAR_COLS (f) * FRAME_COLUMN_WIDTH (f)) \
|
|
|
681 : 0)
|
|
|
682
|
|
21814
|
683 /* Total width of frame F, in columns (characters),
|
|
|
684 including the width used by scroll bars if any. */
|
|
51195
|
685
|
|
|
686 #define FRAME_TOTAL_COLS(f) ((f)->total_cols)
|
|
21814
|
687
|
|
|
688 /* Set the width of frame F to VAL.
|
|
|
689 VAL is the width of a full-frame window,
|
|
51195
|
690 not including scroll bars and fringes. */
|
|
|
691
|
|
|
692 #define SET_FRAME_COLS(f, val) \
|
|
|
693 (FRAME_COLS (f) = (val), \
|
|
|
694 (f)->total_cols = FRAME_TOTAL_COLS_ARG (f, FRAME_COLS (f)))
|
|
21814
|
695
|
|
|
696 /* Given a value WIDTH for frame F's nominal width,
|
|
51195
|
697 return the value that FRAME_TOTAL_COLS should have. */
|
|
|
698
|
|
|
699 #define FRAME_TOTAL_COLS_ARG(f, width) \
|
|
25029
|
700 ((width) \
|
|
51195
|
701 + FRAME_SCROLL_BAR_COLS (f) \
|
|
41121
|
702 + FRAME_FRINGE_COLS (f))
|
|
21814
|
703
|
|
21762
|
704 /* Maximum + 1 legitimate value for FRAME_CURSOR_X. */
|
|
51195
|
705
|
|
21762
|
706 #define FRAME_CURSOR_X_LIMIT(f) \
|
|
51195
|
707 (FRAME_COLS (f) + FRAME_LEFT_SCROLL_BAR_COLS (f))
|
|
21814
|
708
|
|
|
709 /* Nonzero if frame F has scroll bars. */
|
|
51195
|
710
|
|
1994
|
711 #define FRAME_SCROLL_BARS(f) ((f)->scroll_bars)
|
|
21814
|
712
|
|
1994
|
713 #define FRAME_CONDEMNED_SCROLL_BARS(f) ((f)->condemned_scroll_bars)
|
|
2148
|
714 #define FRAME_MENU_BAR_ITEMS(f) ((f)->menu_bar_items)
|
|
10120
|
715 #define FRAME_COST_BAUD_RATE(f) ((f)->cost_calculation_baud_rate)
|
|
17033
|
716
|
|
47133
|
717 #define FRAME_DESIRED_CURSOR(f) ((f)->desired_cursor)
|
|
|
718 #define FRAME_BLINK_OFF_CURSOR(f) ((f)->blink_off_cursor)
|
|
|
719 #define FRAME_CURSOR_WIDTH(f) ((f)->cursor_width)
|
|
|
720 #define FRAME_BLINK_OFF_CURSOR_WIDTH(f) ((f)->blink_off_cursor_width)
|
|
|
721
|
|
25029
|
722 /* Return a pointer to the face cache of frame F. */
|
|
|
723
|
|
|
724 #define FRAME_FACE_CACHE(F) (F)->face_cache
|
|
|
725
|
|
17033
|
726 /* Return the size of message_buf of the frame F. We multiply the
|
|
|
727 width of the frame by 4 because multi-byte form may require at most
|
|
|
728 4-byte for a character. */
|
|
49600
|
729
|
|
51195
|
730 #define FRAME_MESSAGE_BUF_SIZE(f) (((int) FRAME_COLS (f)) * 4)
|
|
261
|
731
|
|
1653
|
732 /* Emacs's redisplay code could become confused if a frame's
|
|
|
733 visibility changes at arbitrary times. For example, if a frame is
|
|
|
734 visible while the desired glyphs are being built, but becomes
|
|
|
735 invisible before they are updated, then some rows of the
|
|
|
736 desired_glyphs will be left marked as enabled after redisplay is
|
|
|
737 complete, which should never happen. The next time the frame
|
|
|
738 becomes visible, redisplay will probably barf.
|
|
|
739
|
|
|
740 Currently, there are no similar situations involving iconified, but
|
|
|
741 the principle is the same.
|
|
|
742
|
|
|
743 So instead of having asynchronous input handlers directly set and
|
|
|
744 clear the frame's visibility and iconification flags, they just set
|
|
|
745 the async_visible and async_iconified flags; the redisplay code
|
|
|
746 calls the FRAME_SAMPLE_VISIBILITY macro before doing any redisplay,
|
|
|
747 which sets visible and iconified from their asynchronous
|
|
1710
|
748 counterparts.
|
|
|
749
|
|
1776
|
750 Synchronous code must use the FRAME_SET_VISIBLE macro.
|
|
|
751
|
|
|
752 Also, if a frame used to be invisible, but has just become visible,
|
|
|
753 it must be marked as garbaged, since redisplay hasn't been keeping
|
|
|
754 up its contents. */
|
|
49600
|
755
|
|
1653
|
756 #define FRAME_SAMPLE_VISIBILITY(f) \
|
|
19696
|
757 (((f)->async_visible && (f)->visible != (f)->async_visible) ? \
|
|
|
758 SET_FRAME_GARBAGED (f) : 0, \
|
|
1776
|
759 (f)->visible = (f)->async_visible, \
|
|
1653
|
760 (f)->iconified = (f)->async_iconified)
|
|
|
761
|
40655
45453187feeb
(CHECK_FRAME, CHECK_LIVE_FRAME): Remove unused argument `i' in macros.
Pavel Janík <Pavel@Janik.cz>
diff
changeset
|
762 #define CHECK_FRAME(x) \
|
|
25711
|
763 do { \
|
|
|
764 if (! FRAMEP (x)) \
|
|
|
765 x = wrong_type_argument (Qframep, (x)); \
|
|
|
766 } while (0)
|
|
485
|
767
|
40655
45453187feeb
(CHECK_FRAME, CHECK_LIVE_FRAME): Remove unused argument `i' in macros.
Pavel Janík <Pavel@Janik.cz>
diff
changeset
|
768 #define CHECK_LIVE_FRAME(x) \
|
|
25711
|
769 do { \
|
|
|
770 if (! FRAMEP (x) \
|
|
|
771 || ! FRAME_LIVE_P (XFRAME (x))) \
|
|
|
772 x = wrong_type_argument (Qframe_live_p, (x)); \
|
|
|
773 } while (0)
|
|
485
|
774
|
|
765
|
775 /* FOR_EACH_FRAME (LIST_VAR, FRAME_VAR) followed by a statement is a
|
|
|
776 `for' loop which iterates over the elements of Vframe_list. The
|
|
2252
|
777 loop will set FRAME_VAR, a Lisp_Object, to each frame in
|
|
765
|
778 Vframe_list in succession and execute the statement. LIST_VAR
|
|
2252
|
779 should be a Lisp_Object too; it is used to iterate through the
|
|
49600
|
780 Vframe_list.
|
|
732
|
781
|
|
16051
|
782 This macro is a holdover from a time when multiple frames weren't always
|
|
|
783 supported. An alternate definition of the macro would expand to
|
|
|
784 something which executes the statement once. */
|
|
25029
|
785
|
|
765
|
786 #define FOR_EACH_FRAME(list_var, frame_var) \
|
|
|
787 for ((list_var) = Vframe_list; \
|
|
732
|
788 (CONSP (list_var) \
|
|
25638
|
789 && (frame_var = XCAR (list_var), 1)); \
|
|
|
790 list_var = XCDR (list_var))
|
|
732
|
791
|
|
|
792
|
|
50358
|
793 extern Lisp_Object Qframep, Qframe_live_p;
|
|
261
|
794
|
|
765
|
795 extern struct frame *last_nonminibuf_frame;
|
|
261
|
796
|
|
20316
|
797 extern struct frame *make_terminal_frame P_ ((void));
|
|
|
798 extern struct frame *make_frame P_ ((int));
|
21425
69491a9294a4
(make_frame_without_minibuffer): Conditionalize on HAVE_WINDOW_SYSTEM.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
799 #ifdef HAVE_WINDOW_SYSTEM
|
|
20316
|
800 extern struct frame *make_minibuffer_frame P_ ((void));
|
|
|
801 extern struct frame *make_frame_without_minibuffer P_ ((Lisp_Object,
|
|
|
802 struct kboard *,
|
|
|
803 Lisp_Object));
|
21425
69491a9294a4
(make_frame_without_minibuffer): Conditionalize on HAVE_WINDOW_SYSTEM.
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
804 #endif /* HAVE_WINDOW_SYSTEM */
|
|
20316
|
805 extern int other_visible_frames P_ ((struct frame *));
|
|
261
|
806
|
|
765
|
807 extern Lisp_Object Vframe_list;
|
|
|
808 extern Lisp_Object Vdefault_frame_alist;
|
|
261
|
809
|
|
765
|
810 extern Lisp_Object Vterminal_frame;
|
|
43367
|
811
|
|
|
812 extern Lisp_Object Vmouse_highlight;
|
|
261
|
813
|
|
25670
|
814 /* The currently selected frame. */
|
|
|
815
|
|
|
816 extern Lisp_Object selected_frame;
|
|
|
817
|
|
|
818 /* Value is a pointer to the selected frame. If the selected frame
|
|
29439
|
819 isn't live, abort. */
|
|
25670
|
820
|
|
|
821 #define SELECTED_FRAME() \
|
|
|
822 ((FRAMEP (selected_frame) \
|
|
|
823 && FRAME_LIVE_P (XFRAME (selected_frame))) \
|
|
|
824 ? XFRAME (selected_frame) \
|
|
28651
|
825 : (abort (), (struct frame *) 0))
|
|
25029
|
826
|
|
|
827
|
|
|
828 /***********************************************************************
|
|
|
829 Display-related Macros
|
|
|
830 ***********************************************************************/
|
|
|
831
|
|
64477
|
832 /* Canonical y-unit on frame F.
|
|
51195
|
833 This value currently equals the line height of the frame (which is
|
|
|
834 the height of the default font of F). */
|
|
25029
|
835
|
|
51195
|
836 #define FRAME_LINE_HEIGHT(F) ((F)->line_height)
|
|
25029
|
837
|
|
64477
|
838 /* Canonical x-unit on frame F.
|
|
59203
|
839 This value currently equals the average width of the default font of F. */
|
|
25029
|
840
|
|
51195
|
841 #define FRAME_COLUMN_WIDTH(F) ((F)->column_width)
|
|
|
842
|
|
59203
|
843 /* Space glyph width of the default font of frame F. */
|
|
|
844
|
|
|
845 #define FRAME_SPACE_WIDTH(F) ((F)->space_width)
|
|
|
846
|
|
25029
|
847
|
|
|
848 /* Pixel width of areas used to display truncation marks, continuation
|
|
25460
|
849 marks, overlay arrows. This is 0 for terminal frames. */
|
|
25029
|
850
|
|
|
851 #ifdef HAVE_WINDOW_SYSTEM
|
|
31147
|
852
|
|
51195
|
853 /* Total width of fringes reserved for drawing truncation bitmaps,
|
|
|
854 continuation bitmaps and alike. The width is in canonical char
|
|
|
855 units of the frame. This must currently be the case because window
|
|
|
856 sizes aren't pixel values. If it weren't the case, we wouldn't be
|
|
|
857 able to split windows horizontally nicely. */
|
|
|
858
|
|
|
859 #define FRAME_FRINGE_COLS(F) ((F)->fringe_cols)
|
|
|
860
|
|
|
861 /* Pixel-width of the left and right fringe. */
|
|
|
862
|
|
|
863 #define FRAME_LEFT_FRINGE_WIDTH(F) ((F)->left_fringe_width)
|
|
|
864 #define FRAME_RIGHT_FRINGE_WIDTH(F) ((F)->right_fringe_width)
|
|
|
865
|
|
|
866 /* Total width of fringes in pixels. */
|
|
|
867
|
|
|
868 #define FRAME_TOTAL_FRINGE_WIDTH(F) \
|
|
|
869 (FRAME_LEFT_FRINGE_WIDTH (F) + FRAME_RIGHT_FRINGE_WIDTH (F))
|
|
|
870
|
|
|
871
|
|
|
872 /* Pixel-width of internal border lines */
|
|
|
873
|
|
|
874 #define FRAME_INTERNAL_BORDER_WIDTH(F) ((F)->internal_border_width)
|
|
49600
|
875
|
|
31147
|
876 #else /* not HAVE_WINDOW_SYSTEM */
|
|
|
877
|
|
41121
|
878 #define FRAME_FRINGE_COLS(F) 0
|
|
51195
|
879 #define FRAME_TOTAL_FRINGE_WIDTH(F) 0
|
|
41121
|
880 #define FRAME_LEFT_FRINGE_WIDTH(F) 0
|
41717
6ca418a9510b
(struct frame): Remove trunc_area_pixel_width and trunc_area_cols fields.
Kim F. Storm <storm@cua.dk>
diff
changeset
|
881 #define FRAME_RIGHT_FRINGE_WIDTH(F) 0
|
|
51195
|
882 #define FRAME_INTERNAL_BORDER_WIDTH(F) 0
|
|
31147
|
883
|
|
|
884 #endif /* not HAVE_WINDOW_SYSTEM */
|
|
49600
|
885
|
|
25029
|
886
|
|
|
887
|
|
|
888
|
|
|
889 /***********************************************************************
|
|
|
890 Conversion between canonical units and pixels
|
|
|
891 ***********************************************************************/
|
|
|
892
|
|
51195
|
893 /* Canonical x-values are fractions of FRAME_COLUMN_WIDTH, canonical
|
|
|
894 y-unit are fractions of FRAME_LINE_HEIGHT of a frame. Both are
|
|
|
895 represented as Lisp numbers, i.e. integers or floats. */
|
|
25029
|
896
|
|
|
897 /* Convert canonical value X to pixels. F is the frame whose
|
|
|
898 canonical char width is to be used. X must be a Lisp integer or
|
|
|
899 float. Value is a C integer. */
|
|
49600
|
900
|
|
51195
|
901 #define FRAME_PIXEL_X_FROM_CANON_X(F, X) \
|
|
25029
|
902 (INTEGERP (X) \
|
|
51195
|
903 ? XINT (X) * FRAME_COLUMN_WIDTH (F) \
|
|
|
904 : (int) (XFLOAT_DATA (X) * FRAME_COLUMN_WIDTH (F)))
|
|
49600
|
905
|
|
25029
|
906 /* Convert canonical value Y to pixels. F is the frame whose
|
|
|
907 canonical character height is to be used. X must be a Lisp integer
|
|
|
908 or float. Value is a C integer. */
|
|
49600
|
909
|
|
51195
|
910 #define FRAME_PIXEL_Y_FROM_CANON_Y(F, Y) \
|
|
25029
|
911 (INTEGERP (Y) \
|
|
51195
|
912 ? XINT (Y) * FRAME_LINE_HEIGHT (F) \
|
|
|
913 : (int) (XFLOAT_DATA (Y) * FRAME_LINE_HEIGHT (F)))
|
|
25029
|
914
|
|
|
915 /* Convert pixel-value X to canonical units. F is the frame whose
|
|
|
916 canonical character width is to be used. X is a C integer. Result
|
|
|
917 is a Lisp float if X is not a multiple of the canon width,
|
|
|
918 otherwise it's a Lisp integer. */
|
|
|
919
|
|
51195
|
920 #define FRAME_CANON_X_FROM_PIXEL_X(F, X) \
|
|
|
921 ((X) % FRAME_COLUMN_WIDTH (F) != 0 \
|
|
|
922 ? make_float ((double) (X) / FRAME_COLUMN_WIDTH (F)) \
|
|
|
923 : make_number ((X) / FRAME_COLUMN_WIDTH (F)))
|
|
25029
|
924
|
|
|
925 /* Convert pixel-value Y to canonical units. F is the frame whose
|
|
|
926 canonical character height is to be used. Y is a C integer.
|
|
|
927 Result is a Lisp float if Y is not a multiple of the canon width,
|
|
|
928 otherwise it's a Lisp integer. */
|
|
|
929
|
|
51195
|
930 #define FRAME_CANON_Y_FROM_PIXEL_Y(F, Y) \
|
|
|
931 ((Y) % FRAME_LINE_HEIGHT (F) \
|
|
|
932 ? make_float ((double) (Y) / FRAME_LINE_HEIGHT (F)) \
|
|
|
933 : make_number ((Y) / FRAME_LINE_HEIGHT (F)))
|
|
|
934
|
|
|
935
|
|
|
936
|
|
|
937 /* Manipulating pixel sizes and character sizes.
|
|
|
938 Knowledge of which factors affect the overall size of the window should
|
|
|
939 be hidden in these macros, if that's possible.
|
|
|
940
|
|
|
941 Return the upper/left pixel position of the character cell on frame F
|
|
|
942 at ROW/COL. */
|
|
|
943
|
|
|
944 #define FRAME_LINE_TO_PIXEL_Y(f, row) \
|
|
|
945 (FRAME_INTERNAL_BORDER_WIDTH (f) \
|
|
|
946 + (row) * FRAME_LINE_HEIGHT (f))
|
|
|
947
|
|
|
948 #define FRAME_COL_TO_PIXEL_X(f, col) \
|
|
|
949 (FRAME_INTERNAL_BORDER_WIDTH (f) \
|
|
|
950 + (col) * FRAME_COLUMN_WIDTH (f))
|
|
|
951
|
|
|
952 /* Return the pixel width/height of frame F if it has
|
|
|
953 COLS columns/LINES rows. */
|
|
|
954
|
|
|
955 #define FRAME_TEXT_COLS_TO_PIXEL_WIDTH(f, cols) \
|
|
|
956 (FRAME_COL_TO_PIXEL_X (f, cols) \
|
|
|
957 + (f)->scroll_bar_actual_width \
|
|
|
958 + FRAME_TOTAL_FRINGE_WIDTH (f) \
|
|
|
959 + FRAME_INTERNAL_BORDER_WIDTH (f))
|
|
|
960
|
|
|
961 #define FRAME_TEXT_LINES_TO_PIXEL_HEIGHT(f, lines) \
|
|
|
962 (FRAME_LINE_TO_PIXEL_Y (f, lines) \
|
|
|
963 + FRAME_INTERNAL_BORDER_WIDTH (f))
|
|
|
964
|
|
|
965
|
|
|
966 /* Return the row/column (zero-based) of the character cell containing
|
|
|
967 the pixel on FRAME at Y/X. */
|
|
|
968
|
|
|
969 #define FRAME_PIXEL_Y_TO_LINE(f, y) \
|
|
|
970 (((y) - FRAME_INTERNAL_BORDER_WIDTH (f)) \
|
|
|
971 / FRAME_LINE_HEIGHT (f))
|
|
|
972
|
|
|
973 #define FRAME_PIXEL_X_TO_COL(f, x) \
|
|
|
974 (((x) - FRAME_INTERNAL_BORDER_WIDTH (f)) \
|
|
|
975 / FRAME_COLUMN_WIDTH (f))
|
|
|
976
|
|
|
977 /* How many columns/rows of text can we fit in WIDTH/HEIGHT pixels on
|
|
|
978 frame F? */
|
|
|
979
|
|
|
980 #define FRAME_PIXEL_WIDTH_TO_TEXT_COLS(f, width) \
|
|
|
981 (FRAME_PIXEL_X_TO_COL (f, ((width) \
|
|
|
982 - FRAME_INTERNAL_BORDER_WIDTH (f) \
|
|
|
983 - FRAME_TOTAL_FRINGE_WIDTH (f) \
|
|
|
984 - (f)->scroll_bar_actual_width)))
|
|
|
985
|
|
|
986 #define FRAME_PIXEL_HEIGHT_TO_TEXT_LINES(f, height) \
|
|
|
987 (FRAME_PIXEL_Y_TO_LINE (f, ((height) \
|
|
|
988 - FRAME_INTERNAL_BORDER_WIDTH (f))))
|
|
49600
|
989
|
|
50358
|
990
|
|
|
991 /***********************************************************************
|
|
|
992 Frame Parameters
|
|
|
993 ***********************************************************************/
|
|
|
994
|
|
|
995 extern Lisp_Object Qauto_raise, Qauto_lower;
|
|
|
996 extern Lisp_Object Qborder_color, Qborder_width;
|
|
|
997 extern Lisp_Object Qbuffer_predicate, Qbuffer_list;
|
|
|
998 extern Lisp_Object Qcursor_color, Qcursor_type;
|
|
|
999 extern Lisp_Object Qfont;
|
|
|
1000 extern Lisp_Object Qbackground_color, Qforeground_color;
|
|
|
1001 extern Lisp_Object Qicon, Qicon_name, Qicon_type, Qicon_left, Qicon_top;
|
|
|
1002 extern Lisp_Object Qinternal_border_width;
|
|
|
1003 extern Lisp_Object Qmenu_bar_lines, Qtool_bar_lines;
|
|
|
1004 extern Lisp_Object Qmouse_color;
|
|
|
1005 extern Lisp_Object Qname, Qtitle;
|
|
|
1006 extern Lisp_Object Qparent_id;
|
|
|
1007 extern Lisp_Object Qunsplittable, Qvisibility;
|
|
|
1008 extern Lisp_Object Qscroll_bar_width, Qvertical_scroll_bars;
|
|
|
1009 extern Lisp_Object Qscroll_bar_foreground, Qscroll_bar_background;
|
|
|
1010 extern Lisp_Object Qscreen_gamma;
|
|
|
1011 extern Lisp_Object Qline_spacing;
|
|
|
1012 extern Lisp_Object Qwait_for_wm;
|
|
|
1013 extern Lisp_Object Qfullscreen;
|
|
|
1014
|
|
|
1015 extern Lisp_Object Qleft_fringe, Qright_fringe;
|
|
|
1016 extern Lisp_Object Qheight, Qwidth;
|
|
|
1017 extern Lisp_Object Qminibuffer, Qmodeline;
|
|
|
1018 extern Lisp_Object Qonly;
|
|
|
1019 extern Lisp_Object Qx, Qw32, Qmac, Qpc;
|
|
|
1020 extern Lisp_Object Qvisible;
|
|
|
1021 extern Lisp_Object Qdisplay_type;
|
|
|
1022 extern Lisp_Object Qbackground_mode;
|
|
|
1023
|
|
|
1024 extern Lisp_Object Qx_resource_name;
|
|
|
1025
|
|
|
1026 extern Lisp_Object Qleft, Qright, Qtop, Qbox;
|
|
|
1027 extern Lisp_Object Qdisplay;
|
|
|
1028
|
|
|
1029 #ifdef HAVE_WINDOW_SYSTEM
|
|
|
1030
|
|
|
1031 /* The class of this X application. */
|
|
|
1032 #define EMACS_CLASS "Emacs"
|
|
|
1033
|
|
|
1034 enum
|
|
|
1035 {
|
|
|
1036 /* Values used as a bit mask, BOTH == WIDTH | HEIGHT. */
|
|
|
1037 FULLSCREEN_NONE = 0,
|
|
|
1038 FULLSCREEN_WIDTH = 1,
|
|
|
1039 FULLSCREEN_HEIGHT = 2,
|
|
|
1040 FULLSCREEN_BOTH = 3,
|
|
|
1041 FULLSCREEN_WAIT = 4,
|
|
|
1042 };
|
|
|
1043
|
|
|
1044
|
|
|
1045 /* These are in xterm.c, w32term.c, etc. */
|
|
|
1046
|
|
|
1047 extern void x_set_scroll_bar_default_width P_ ((struct frame *));
|
|
|
1048 extern void x_set_offset P_ ((struct frame *, int, int, int));
|
|
|
1049 extern void x_wm_set_icon_position P_ ((struct frame *, int, int));
|
|
|
1050
|
|
|
1051 extern Lisp_Object x_new_font P_ ((struct frame *, char *));
|
|
|
1052 extern Lisp_Object x_new_fontset P_ ((struct frame *, char *));
|
|
|
1053
|
|
|
1054
|
|
|
1055 /* These are in frame.c */
|
|
|
1056
|
|
|
1057 extern Lisp_Object Vx_resource_name;
|
|
|
1058 extern Lisp_Object Vx_resource_class;
|
|
|
1059
|
|
|
1060
|
|
|
1061 extern Lisp_Object Qface_set_after_frame_default;
|
|
|
1062
|
|
|
1063 extern void x_fullscreen_adjust P_ ((struct frame *f, int *, int *,
|
|
|
1064 int *, int *));
|
|
|
1065
|
|
|
1066 extern void x_set_frame_parameters P_ ((struct frame *, Lisp_Object));
|
|
|
1067 extern void x_report_frame_params P_ ((struct frame *, Lisp_Object *));
|
|
|
1068
|
|
|
1069 extern void x_set_fullscreen P_ ((struct frame *, Lisp_Object, Lisp_Object));
|
|
|
1070 extern void x_set_line_spacing P_ ((struct frame *, Lisp_Object, Lisp_Object));
|
|
|
1071 extern void x_set_screen_gamma P_ ((struct frame *, Lisp_Object, Lisp_Object));
|
|
|
1072 extern void x_set_font P_ ((struct frame *, Lisp_Object, Lisp_Object));
|
|
|
1073 extern void x_set_fringe_width P_ ((struct frame *, Lisp_Object, Lisp_Object));
|
|
|
1074 extern void x_set_border_width P_ ((struct frame *, Lisp_Object, Lisp_Object));
|
|
|
1075 extern void x_set_internal_border_width P_ ((struct frame *, Lisp_Object,
|
|
|
1076 Lisp_Object));
|
|
|
1077 extern void x_set_visibility P_ ((struct frame *, Lisp_Object, Lisp_Object));
|
|
|
1078 extern void x_set_autoraise P_ ((struct frame *, Lisp_Object, Lisp_Object));
|
|
|
1079 extern void x_set_autolower P_ ((struct frame *, Lisp_Object, Lisp_Object));
|
|
|
1080 extern void x_set_unsplittable P_ ((struct frame *, Lisp_Object, Lisp_Object));
|
|
|
1081 extern void x_set_vertical_scroll_bars P_ ((struct frame *, Lisp_Object,
|
|
|
1082 Lisp_Object));
|
|
|
1083 extern void x_set_scroll_bar_width P_ ((struct frame *, Lisp_Object,
|
|
|
1084 Lisp_Object));
|
|
|
1085
|
|
|
1086 extern Lisp_Object x_icon_type P_ ((struct frame *));
|
|
|
1087
|
|
|
1088 extern int x_figure_window_size P_ ((struct frame *, Lisp_Object, int));
|
|
|
1089
|
|
|
1090
|
|
|
1091 extern void validate_x_resource_name P_ ((void));
|
|
|
1092
|
|
|
1093 #endif /* HAVE_WINDOW_SYSTEM */
|
|
|
1094
|
|
35803
|
1095 #endif /* not EMACS_FRAME_H */
|
|
52401
|
1096
|
|
|
1097 /* arch-tag: 0df048ee-e6bf-4f48-bd56-e3cd055dd8c4
|
|
|
1098 (do not change this comment) */
|
