1 /* Updating of data structures for redisplay.
2 Copyright (C) 1985, 86, 87, 88, 93, 94, 95, 97, 98, 1999
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
34 #include "termhooks.h"
35 /* cm.h must come after dispextern.h on Windows. */
36 #include "dispextern.h"
46 #include "intervals.h"
47 #include "blockinput.h"
50 /* I don't know why DEC Alpha OSF1 fail to compile this file if we
51 include the following file. */
52 /* #include "systty.h" */
53 #include "syssignal.h"
57 #endif /* HAVE_X_WINDOWS */
61 #endif /* HAVE_NTGUI */
65 #endif /* macintosh */
67 /* Include systime.h after xterm.h to avoid double inclusion of time.h. */
72 /* To get the prototype for `sleep'. */
78 #define max(a, b) ((a) > (b) ? (a) : (b))
79 #define min(a, b) ((a) < (b) ? (a) : (b))
81 /* Get number of chars of output now in the buffer of a stdio stream.
82 This ought to be built in in stdio, but it isn't. Some s- files
83 override this because their stdio internals differ. */
85 #ifdef __GNU_LIBRARY__
87 /* The s- file might have overridden the definition with one that
88 works for the system's C library. But we are using the GNU C
89 library, so this is the right definition for every system. */
91 #ifdef GNU_LIBRARY_PENDING_OUTPUT_COUNT
92 #define PENDING_OUTPUT_COUNT GNU_LIBRARY_PENDING_OUTPUT_COUNT
94 #undef PENDING_OUTPUT_COUNT
95 #define PENDING_OUTPUT_COUNT(FILE) ((FILE)->__bufp - (FILE)->__buffer)
97 #else /* not __GNU_LIBRARY__ */
98 #if !defined (PENDING_OUTPUT_COUNT) && HAVE_STDIO_EXT_H && HAVE___FPENDING
99 #include <stdio_ext.h>
100 #define PENDING_OUTPUT_COUNT(FILE) __fpending (FILE)
102 #ifndef PENDING_OUTPUT_COUNT
103 #define PENDING_OUTPUT_COUNT(FILE) ((FILE)->_ptr - (FILE)->_base)
105 #endif /* not __GNU_LIBRARY__ */
107 #if defined (LINUX) && defined (HAVE_LIBNCURSES)
108 #include <term.h> /* for tgetent */
111 /* Structure to pass dimensions around. Used for character bounding
112 boxes, glyph matrix dimensions and alike. */
121 /* Function prototypes. */
123 static void redraw_overlapping_rows
P_ ((struct window
*, int));
124 static void redraw_overlapped_rows
P_ ((struct window
*, int));
125 static int count_blanks
P_ ((struct glyph
*, int));
126 static int count_match
P_ ((struct glyph
*, struct glyph
*,
127 struct glyph
*, struct glyph
*));
128 static unsigned line_draw_cost
P_ ((struct glyph_matrix
*, int));
129 static void update_frame_line
P_ ((struct frame
*, int));
130 static struct dim allocate_matrices_for_frame_redisplay
131 P_ ((Lisp_Object
, int, int, struct dim
, int, int *));
132 static void allocate_matrices_for_window_redisplay
P_ ((struct window
*,
134 static int realloc_glyph_pool
P_ ((struct glyph_pool
*, struct dim
));
135 static void adjust_frame_glyphs
P_ ((struct frame
*));
136 struct glyph_matrix
*new_glyph_matrix
P_ ((struct glyph_pool
*));
137 static void free_glyph_matrix
P_ ((struct glyph_matrix
*));
138 static void adjust_glyph_matrix
P_ ((struct window
*, struct glyph_matrix
*,
139 int, int, struct dim
));
140 static void change_frame_size_1
P_ ((struct frame
*, int, int, int, int, int));
141 static void swap_glyph_pointers
P_ ((struct glyph_row
*, struct glyph_row
*));
143 static int glyph_row_slice_p
P_ ((struct glyph_row
*, struct glyph_row
*));
145 static void fill_up_frame_row_with_spaces
P_ ((struct glyph_row
*, int));
146 static void build_frame_matrix_from_window_tree
P_ ((struct glyph_matrix
*,
148 static void build_frame_matrix_from_leaf_window
P_ ((struct glyph_matrix
*,
150 static struct glyph_pool
*new_glyph_pool
P_ ((void));
151 static void free_glyph_pool
P_ ((struct glyph_pool
*));
152 static void adjust_frame_glyphs_initially
P_ ((void));
153 static void adjust_frame_message_buffer
P_ ((struct frame
*));
154 static void adjust_decode_mode_spec_buffer
P_ ((struct frame
*));
155 static void fill_up_glyph_row_with_spaces
P_ ((struct glyph_row
*));
156 static void build_frame_matrix
P_ ((struct frame
*));
157 void clear_current_matrices
P_ ((struct frame
*));
158 void scroll_glyph_matrix_range
P_ ((struct glyph_matrix
*, int, int,
160 static void clear_window_matrices
P_ ((struct window
*, int));
161 static void fill_up_glyph_row_area_with_spaces
P_ ((struct glyph_row
*, int));
162 static int scrolling_window
P_ ((struct window
*, int));
163 static int update_window_line
P_ ((struct window
*, int, int *));
164 static void update_marginal_area
P_ ((struct window
*, int, int));
165 static int update_text_area
P_ ((struct window
*, int));
166 static void make_current
P_ ((struct glyph_matrix
*, struct glyph_matrix
*,
168 static void mirror_make_current
P_ ((struct window
*, int));
169 void check_window_matrix_pointers
P_ ((struct window
*));
171 static void check_matrix_pointers
P_ ((struct glyph_matrix
*,
172 struct glyph_matrix
*));
174 static void mirror_line_dance
P_ ((struct window
*, int, int, int *, char *));
175 static int update_window_tree
P_ ((struct window
*, int));
176 static int update_window
P_ ((struct window
*, int));
177 static int update_frame_1
P_ ((struct frame
*, int, int));
178 static void set_window_cursor_after_update
P_ ((struct window
*));
179 static int row_equal_p
P_ ((struct window
*, struct glyph_row
*,
180 struct glyph_row
*, int));
181 static void adjust_frame_glyphs_for_window_redisplay
P_ ((struct frame
*));
182 static void adjust_frame_glyphs_for_frame_redisplay
P_ ((struct frame
*));
183 static void reverse_rows
P_ ((struct glyph_matrix
*, int, int));
184 static int margin_glyphs_to_reserve
P_ ((struct window
*, int, Lisp_Object
));
185 static void sync_window_with_frame_matrix_rows
P_ ((struct window
*));
186 struct window
*frame_row_to_window
P_ ((struct window
*, int));
190 /* Non-zero means don't pause redisplay for pending input. (This is
191 for debugging and for a future implementation of EDT-like
194 int redisplay_dont_pause
;
196 /* Nonzero upon entry to redisplay means do not assume anything about
197 current contents of actual terminal frame; clear and redraw it. */
201 /* Nonzero means last display completed. Zero means it was preempted. */
203 int display_completed
;
205 /* Lisp variable visible-bell; enables use of screen-flash instead of
210 /* Invert the color of the whole frame, at a low level. */
214 /* Line speed of the terminal. */
218 /* Either nil or a symbol naming the window system under which Emacs
221 Lisp_Object Vwindow_system
;
223 /* Version number of X windows: 10, 11 or nil. */
225 Lisp_Object Vwindow_system_version
;
227 /* Vector of glyph definitions. Indexed by glyph number, the contents
228 are a string which is how to output the glyph.
230 If Vglyph_table is nil, a glyph is output by using its low 8 bits
233 This is an obsolete feature that is no longer used. The variable
234 is retained for compatibility. */
236 Lisp_Object Vglyph_table
;
238 /* Display table to use for vectors that don't specify their own. */
240 Lisp_Object Vstandard_display_table
;
242 /* Nonzero means reading single-character input with prompt so put
243 cursor on mini-buffer after the prompt. positive means at end of
244 text in echo area; negative means at beginning of line. */
246 int cursor_in_echo_area
;
248 Lisp_Object Qdisplay_table
, Qredisplay_dont_pause
;
251 /* The currently selected frame. In a single-frame version, this
252 variable always equals the_only_frame. */
254 Lisp_Object selected_frame
;
256 /* A frame which is not just a mini-buffer, or 0 if there are no such
257 frames. This is usually the most recent such frame that was
258 selected. In a single-frame version, this variable always holds
259 the address of the_only_frame. */
261 struct frame
*last_nonminibuf_frame
;
263 /* Stdio stream being used for copy of all output. */
267 /* Structure for info on cursor positioning. */
271 /* 1 means SIGWINCH happened when not safe. */
273 int delayed_size_change
;
275 /* 1 means glyph initialization has been completed at startup. */
277 static int glyphs_initialized_initially_p
;
279 /* Updated window if != 0. Set by update_window. */
281 struct window
*updated_window
;
283 /* Glyph row updated in update_window_line, and area that is updated. */
285 struct glyph_row
*updated_row
;
288 /* A glyph for a space. */
290 struct glyph space_glyph
;
292 /* Non-zero means update has been performed directly, so that there's
293 no need for redisplay_internal to do much work. Set by
294 direct_output_for_insert. */
296 int redisplay_performed_directly_p
;
298 /* Counts of allocated structures. These counts serve to diagnose
299 memory leaks and double frees. */
301 int glyph_matrix_count
;
302 int glyph_pool_count
;
304 /* If non-null, the frame whose frame matrices are manipulated. If
305 null, window matrices are worked on. */
307 static struct frame
*frame_matrix_frame
;
309 /* Current interface for window-based redisplay. Set from init_xterm.
310 A null value means we are not using window-based redisplay. */
312 struct redisplay_interface
*rif
;
314 /* Non-zero means that fonts have been loaded since the last glyph
315 matrix adjustments. Redisplay must stop, and glyph matrices must
316 be adjusted when this flag becomes non-zero during display. The
317 reason fonts can be loaded so late is that fonts of fontsets are
322 /* Convert vpos and hpos from frame to window and vice versa.
323 This may only be used for terminal frames. */
327 static int window_to_frame_vpos
P_ ((struct window
*, int));
328 static int window_to_frame_hpos
P_ ((struct window
*, int));
329 #define WINDOW_TO_FRAME_VPOS(W, VPOS) window_to_frame_vpos ((W), (VPOS))
330 #define WINDOW_TO_FRAME_HPOS(W, HPOS) window_to_frame_hpos ((W), (HPOS))
332 #else /* GLYPH_DEBUG == 0 */
334 #define WINDOW_TO_FRAME_VPOS(W, VPOS) ((VPOS) + XFASTINT ((W)->top))
335 #define WINDOW_TO_FRAME_HPOS(W, HPOS) ((HPOS) + XFASTINT ((W)->left))
337 #endif /* GLYPH_DEBUG == 0 */
340 /* Like bcopy except never gets confused by overlap. Let this be the
341 first function defined in this file, or change emacs.c where the
342 address of this function is used. */
345 safe_bcopy (from
, to
, size
)
349 if (size
<= 0 || from
== to
)
352 /* If the source and destination don't overlap, then bcopy can
353 handle it. If they do overlap, but the destination is lower in
354 memory than the source, we'll assume bcopy can handle that. */
355 if (to
< from
|| from
+ size
<= to
)
356 bcopy (from
, to
, size
);
358 /* Otherwise, we'll copy from the end. */
361 register char *endf
= from
+ size
;
362 register char *endt
= to
+ size
;
364 /* If TO - FROM is large, then we should break the copy into
365 nonoverlapping chunks of TO - FROM bytes each. However, if
366 TO - FROM is small, then the bcopy function call overhead
367 makes this not worth it. The crossover point could be about
368 anywhere. Since I don't think the obvious copy loop is too
369 bad, I'm trying to err in its favor. */
374 while (endf
!= from
);
386 bcopy (endf
, endt
, to
- from
);
389 /* If SIZE wasn't a multiple of TO - FROM, there will be a
390 little left over. The amount left over is (endt + (to -
391 from)) - to, which is endt - from. */
392 bcopy (from
, to
, endt
- from
);
399 /***********************************************************************
401 ***********************************************************************/
403 /* Allocate and return a glyph_matrix structure. POOL is the glyph
404 pool from which memory for the matrix should be allocated, or null
405 for window-based redisplay where no glyph pools are used. The
406 member `pool' of the glyph matrix structure returned is set to
407 POOL, the structure is otherwise zeroed. */
409 struct glyph_matrix
*
410 new_glyph_matrix (pool
)
411 struct glyph_pool
*pool
;
413 struct glyph_matrix
*result
;
415 /* Allocate and clear. */
416 result
= (struct glyph_matrix
*) xmalloc (sizeof *result
);
417 bzero (result
, sizeof *result
);
419 /* Increment number of allocated matrices. This count is used
420 to detect memory leaks. */
421 ++glyph_matrix_count
;
423 /* Set pool and return. */
429 /* Free glyph matrix MATRIX. Passing in a null MATRIX is allowed.
431 The global counter glyph_matrix_count is decremented when a matrix
432 is freed. If the count gets negative, more structures were freed
433 than allocated, i.e. one matrix was freed more than once or a bogus
434 pointer was passed to this function.
436 If MATRIX->pool is null, this means that the matrix manages its own
437 glyph memory---this is done for matrices on X frames. Freeing the
438 matrix also frees the glyph memory in this case. */
441 free_glyph_matrix (matrix
)
442 struct glyph_matrix
*matrix
;
448 /* Detect the case that more matrices are freed than were
450 if (--glyph_matrix_count
< 0)
453 /* Free glyph memory if MATRIX owns it. */
454 if (matrix
->pool
== NULL
)
455 for (i
= 0; i
< matrix
->rows_allocated
; ++i
)
456 xfree (matrix
->rows
[i
].glyphs
[LEFT_MARGIN_AREA
]);
458 /* Free row structures and the matrix itself. */
459 xfree (matrix
->rows
);
465 /* Return the number of glyphs to reserve for a marginal area of
466 window W. TOTAL_GLYPHS is the number of glyphs in a complete
467 display line of window W. MARGIN gives the width of the marginal
468 area in canonical character units. MARGIN should be an integer
472 margin_glyphs_to_reserve (w
, total_glyphs
, margin
)
479 if (NUMBERP (margin
))
481 int width
= XFASTINT (w
->width
);
482 double d
= max (0, XFLOATINT (margin
));
483 d
= min (width
/ 2 - 1, d
);
484 n
= (int) ((double) total_glyphs
/ width
* d
);
493 /* Adjust glyph matrix MATRIX on window W or on a frame to changed
496 W is null if the function is called for a frame glyph matrix.
497 Otherwise it is the window MATRIX is a member of. X and Y are the
498 indices of the first column and row of MATRIX within the frame
499 matrix, if such a matrix exists. They are zero for purely
500 window-based redisplay. DIM is the needed size of the matrix.
502 In window-based redisplay, where no frame matrices exist, glyph
503 matrices manage their own glyph storage. Otherwise, they allocate
504 storage from a common frame glyph pool which can be found in
507 The reason for this memory management strategy is to avoid complete
508 frame redraws if possible. When we allocate from a common pool, a
509 change of the location or size of a sub-matrix within the pool
510 requires a complete redisplay of the frame because we cannot easily
511 make sure that the current matrices of all windows still agree with
512 what is displayed on the screen. While this is usually fast, it
513 leads to screen flickering. */
516 adjust_glyph_matrix (w
, matrix
, x
, y
, dim
)
518 struct glyph_matrix
*matrix
;
524 int marginal_areas_changed_p
= 0;
525 int header_line_changed_p
= 0;
526 int header_line_p
= 0;
527 int left
= -1, right
= -1;
528 int window_x
, window_y
, window_width
, window_height
;
530 /* See if W had a top line that has disappeared now, or vice versa. */
533 header_line_p
= WINDOW_WANTS_HEADER_LINE_P (w
);
534 header_line_changed_p
= header_line_p
!= matrix
->header_line_p
;
536 matrix
->header_line_p
= header_line_p
;
538 /* Do nothing if MATRIX' size, position, vscroll, and marginal areas
539 haven't changed. This optimization is important because preserving
540 the matrix means preventing redisplay. */
541 if (matrix
->pool
== NULL
)
543 window_box (w
, -1, &window_x
, &window_y
, &window_width
, &window_height
);
544 left
= margin_glyphs_to_reserve (w
, dim
.width
, w
->left_margin_width
);
545 right
= margin_glyphs_to_reserve (w
, dim
.width
, w
->right_margin_width
);
546 xassert (left
>= 0 && right
>= 0);
547 marginal_areas_changed_p
= (left
!= matrix
->left_margin_glyphs
548 || right
!= matrix
->right_margin_glyphs
);
550 if (!marginal_areas_changed_p
552 && !header_line_changed_p
553 && matrix
->window_top_y
== XFASTINT (w
->top
)
554 && matrix
->window_height
== window_height
555 && matrix
->window_vscroll
== w
->vscroll
556 && matrix
->window_width
== window_width
)
560 /* Enlarge MATRIX->rows if necessary. New rows are cleared. */
561 if (matrix
->rows_allocated
< dim
.height
)
563 int size
= dim
.height
* sizeof (struct glyph_row
);
564 new_rows
= dim
.height
- matrix
->rows_allocated
;
565 matrix
->rows
= (struct glyph_row
*) xrealloc (matrix
->rows
, size
);
566 bzero (matrix
->rows
+ matrix
->rows_allocated
,
567 new_rows
* sizeof *matrix
->rows
);
568 matrix
->rows_allocated
= dim
.height
;
573 /* If POOL is not null, MATRIX is a frame matrix or a window matrix
574 on a frame not using window-based redisplay. Set up pointers for
575 each row into the glyph pool. */
578 xassert (matrix
->pool
->glyphs
);
582 left
= margin_glyphs_to_reserve (w
, dim
.width
,
583 w
->left_margin_width
);
584 right
= margin_glyphs_to_reserve (w
, dim
.width
,
585 w
->right_margin_width
);
590 for (i
= 0; i
< dim
.height
; ++i
)
592 struct glyph_row
*row
= &matrix
->rows
[i
];
594 row
->glyphs
[LEFT_MARGIN_AREA
]
595 = (matrix
->pool
->glyphs
596 + (y
+ i
) * matrix
->pool
->ncolumns
600 || row
== matrix
->rows
+ dim
.height
- 1
601 || (row
== matrix
->rows
&& matrix
->header_line_p
))
603 row
->glyphs
[TEXT_AREA
]
604 = row
->glyphs
[LEFT_MARGIN_AREA
];
605 row
->glyphs
[RIGHT_MARGIN_AREA
]
606 = row
->glyphs
[TEXT_AREA
] + dim
.width
;
607 row
->glyphs
[LAST_AREA
]
608 = row
->glyphs
[RIGHT_MARGIN_AREA
];
612 row
->glyphs
[TEXT_AREA
]
613 = row
->glyphs
[LEFT_MARGIN_AREA
] + left
;
614 row
->glyphs
[RIGHT_MARGIN_AREA
]
615 = row
->glyphs
[TEXT_AREA
] + dim
.width
- left
- right
;
616 row
->glyphs
[LAST_AREA
]
617 = row
->glyphs
[LEFT_MARGIN_AREA
] + dim
.width
;
621 matrix
->left_margin_glyphs
= left
;
622 matrix
->right_margin_glyphs
= right
;
626 /* If MATRIX->pool is null, MATRIX is responsible for managing
627 its own memory. Allocate glyph memory from the heap. */
628 if (dim
.width
> matrix
->matrix_w
630 || header_line_changed_p
631 || marginal_areas_changed_p
)
633 struct glyph_row
*row
= matrix
->rows
;
634 struct glyph_row
*end
= row
+ matrix
->rows_allocated
;
638 row
->glyphs
[LEFT_MARGIN_AREA
]
639 = (struct glyph
*) xrealloc (row
->glyphs
[LEFT_MARGIN_AREA
],
641 * sizeof (struct glyph
)));
643 /* The mode line never has marginal areas. */
644 if (row
== matrix
->rows
+ dim
.height
- 1
645 || (row
== matrix
->rows
&& matrix
->header_line_p
))
647 row
->glyphs
[TEXT_AREA
]
648 = row
->glyphs
[LEFT_MARGIN_AREA
];
649 row
->glyphs
[RIGHT_MARGIN_AREA
]
650 = row
->glyphs
[TEXT_AREA
] + dim
.width
;
651 row
->glyphs
[LAST_AREA
]
652 = row
->glyphs
[RIGHT_MARGIN_AREA
];
656 row
->glyphs
[TEXT_AREA
]
657 = row
->glyphs
[LEFT_MARGIN_AREA
] + left
;
658 row
->glyphs
[RIGHT_MARGIN_AREA
]
659 = row
->glyphs
[TEXT_AREA
] + dim
.width
- left
- right
;
660 row
->glyphs
[LAST_AREA
]
661 = row
->glyphs
[LEFT_MARGIN_AREA
] + dim
.width
;
667 xassert (left
>= 0 && right
>= 0);
668 matrix
->left_margin_glyphs
= left
;
669 matrix
->right_margin_glyphs
= right
;
672 /* Number of rows to be used by MATRIX. */
673 matrix
->nrows
= dim
.height
;
674 xassert (matrix
->nrows
>= 0);
676 /* Mark rows in a current matrix of a window as not having valid
677 contents. It's important to not do this for desired matrices.
678 When Emacs starts, it may already be building desired matrices
679 when this function runs. */
680 if (w
&& matrix
== w
->current_matrix
)
682 /* Optimize the case that only the height has changed (C-x 2,
683 upper window). Invalidate all rows that are no longer part
685 if (!marginal_areas_changed_p
686 && matrix
->window_top_y
== XFASTINT (w
->top
)
687 && matrix
->window_width
== window_width
)
690 while (matrix
->rows
[i
].enabled_p
691 && (MATRIX_ROW_BOTTOM_Y (matrix
->rows
+ i
)
692 < matrix
->window_height
))
695 /* Window end is invalid, if inside of the rows that
697 if (INTEGERP (w
->window_end_vpos
)
698 && XFASTINT (w
->window_end_vpos
) >= i
)
699 w
->window_end_valid
= Qnil
;
701 while (i
< matrix
->nrows
)
702 matrix
->rows
[i
++].enabled_p
= 0;
706 for (i
= 0; i
< matrix
->nrows
; ++i
)
707 matrix
->rows
[i
].enabled_p
= 0;
711 /* Remember last values to be able to optimize frame redraws. */
712 matrix
->matrix_x
= x
;
713 matrix
->matrix_y
= y
;
714 matrix
->matrix_w
= dim
.width
;
715 matrix
->matrix_h
= dim
.height
;
717 /* Record the top y location and height of W at the time the matrix
718 was last adjusted. This is used to optimize redisplay above. */
721 matrix
->window_top_y
= XFASTINT (w
->top
);
722 matrix
->window_height
= window_height
;
723 matrix
->window_width
= window_width
;
724 matrix
->window_vscroll
= w
->vscroll
;
729 /* Reverse the contents of rows in MATRIX between START and END. The
730 contents of the row at END - 1 end up at START, END - 2 at START +
731 1 etc. This is part of the implementation of rotate_matrix (see
735 reverse_rows (matrix
, start
, end
)
736 struct glyph_matrix
*matrix
;
741 for (i
= start
, j
= end
- 1; i
< j
; ++i
, --j
)
743 /* Non-ISO HP/UX compiler doesn't like auto struct
745 struct glyph_row temp
;
746 temp
= matrix
->rows
[i
];
747 matrix
->rows
[i
] = matrix
->rows
[j
];
748 matrix
->rows
[j
] = temp
;
753 /* Rotate the contents of rows in MATRIX in the range FIRST .. LAST -
754 1 by BY positions. BY < 0 means rotate left, i.e. towards lower
755 indices. (Note: this does not copy glyphs, only glyph pointers in
756 row structures are moved around).
758 The algorithm used for rotating the vector was, I believe, first
759 described by Kernighan. See the vector R as consisting of two
760 sub-vectors AB, where A has length BY for BY >= 0. The result
761 after rotating is then BA. Reverse both sub-vectors to get ArBr
762 and reverse the result to get (ArBr)r which is BA. Similar for
766 rotate_matrix (matrix
, first
, last
, by
)
767 struct glyph_matrix
*matrix
;
772 /* Up (rotate left, i.e. towards lower indices). */
774 reverse_rows (matrix
, first
, first
+ by
);
775 reverse_rows (matrix
, first
+ by
, last
);
776 reverse_rows (matrix
, first
, last
);
780 /* Down (rotate right, i.e. towards higher indices). */
781 reverse_rows (matrix
, last
- by
, last
);
782 reverse_rows (matrix
, first
, last
- by
);
783 reverse_rows (matrix
, first
, last
);
788 /* Increment buffer positions in glyph rows of MATRIX. Do it for rows
789 with indices START <= index < END. Increment positions by DELTA/
793 increment_matrix_positions (matrix
, start
, end
, delta
, delta_bytes
)
794 struct glyph_matrix
*matrix
;
795 int start
, end
, delta
, delta_bytes
;
797 /* Check that START and END are reasonable values. */
798 xassert (start
>= 0 && start
<= matrix
->nrows
);
799 xassert (end
>= 0 && end
<= matrix
->nrows
);
800 xassert (start
<= end
);
802 for (; start
< end
; ++start
)
803 increment_row_positions (matrix
->rows
+ start
, delta
, delta_bytes
);
807 /* Enable a range of rows in glyph matrix MATRIX. START and END are
808 the row indices of the first and last + 1 row to enable. If
809 ENABLED_P is non-zero, enabled_p flags in rows will be set to 1. */
812 enable_glyph_matrix_rows (matrix
, start
, end
, enabled_p
)
813 struct glyph_matrix
*matrix
;
817 xassert (start
<= end
);
818 xassert (start
>= 0 && start
< matrix
->nrows
);
819 xassert (end
>= 0 && end
<= matrix
->nrows
);
821 for (; start
< end
; ++start
)
822 matrix
->rows
[start
].enabled_p
= enabled_p
!= 0;
828 This empties all rows in MATRIX by setting the enabled_p flag for
829 all rows of the matrix to zero. The function prepare_desired_row
830 will eventually really clear a row when it sees one with a zero
833 Resets update hints to defaults value. The only update hint
834 currently present is the flag MATRIX->no_scrolling_p. */
837 clear_glyph_matrix (matrix
)
838 struct glyph_matrix
*matrix
;
842 enable_glyph_matrix_rows (matrix
, 0, matrix
->nrows
, 0);
843 matrix
->no_scrolling_p
= 0;
848 /* Shift part of the glyph matrix MATRIX of window W up or down.
849 Increment y-positions in glyph rows between START and END by DY,
850 and recompute their visible height. */
853 shift_glyph_matrix (w
, matrix
, start
, end
, dy
)
855 struct glyph_matrix
*matrix
;
860 xassert (start
<= end
);
861 xassert (start
>= 0 && start
< matrix
->nrows
);
862 xassert (end
>= 0 && end
<= matrix
->nrows
);
864 min_y
= WINDOW_DISPLAY_HEADER_LINE_HEIGHT (w
);
865 max_y
= WINDOW_DISPLAY_HEIGHT_NO_MODE_LINE (w
);
867 for (; start
< end
; ++start
)
869 struct glyph_row
*row
= &matrix
->rows
[start
];
874 row
->visible_height
= row
->height
- (min_y
- row
->y
);
875 else if (row
->y
+ row
->height
> max_y
)
876 row
->visible_height
= row
->height
- (row
->y
+ row
->height
- max_y
);
878 row
->visible_height
= row
->height
;
883 /* Mark all rows in current matrices of frame F as invalid. Marking
884 invalid is done by setting enabled_p to zero for all rows in a
888 clear_current_matrices (f
)
889 register struct frame
*f
;
891 /* Clear frame current matrix, if we have one. */
892 if (f
->current_matrix
)
893 clear_glyph_matrix (f
->current_matrix
);
895 /* Clear the matrix of the menu bar window, if such a window exists.
896 The menu bar window is currently used to display menus on X when
897 no toolkit support is compiled in. */
898 if (WINDOWP (f
->menu_bar_window
))
899 clear_glyph_matrix (XWINDOW (f
->menu_bar_window
)->current_matrix
);
901 /* Clear the matrix of the tool-bar window, if any. */
902 if (WINDOWP (f
->tool_bar_window
))
903 clear_glyph_matrix (XWINDOW (f
->tool_bar_window
)->current_matrix
);
905 /* Clear current window matrices. */
906 xassert (WINDOWP (FRAME_ROOT_WINDOW (f
)));
907 clear_window_matrices (XWINDOW (FRAME_ROOT_WINDOW (f
)), 0);
911 /* Clear out all display lines of F for a coming redisplay. */
914 clear_desired_matrices (f
)
915 register struct frame
*f
;
917 if (f
->desired_matrix
)
918 clear_glyph_matrix (f
->desired_matrix
);
920 if (WINDOWP (f
->menu_bar_window
))
921 clear_glyph_matrix (XWINDOW (f
->menu_bar_window
)->desired_matrix
);
923 if (WINDOWP (f
->tool_bar_window
))
924 clear_glyph_matrix (XWINDOW (f
->tool_bar_window
)->desired_matrix
);
926 /* Do it for window matrices. */
927 xassert (WINDOWP (FRAME_ROOT_WINDOW (f
)));
928 clear_window_matrices (XWINDOW (FRAME_ROOT_WINDOW (f
)), 1);
932 /* Clear matrices in window tree rooted in W. If DESIRED_P is
933 non-zero clear desired matrices, otherwise clear current matrices. */
936 clear_window_matrices (w
, desired_p
)
942 if (!NILP (w
->hchild
))
944 xassert (WINDOWP (w
->hchild
));
945 clear_window_matrices (XWINDOW (w
->hchild
), desired_p
);
947 else if (!NILP (w
->vchild
))
949 xassert (WINDOWP (w
->vchild
));
950 clear_window_matrices (XWINDOW (w
->vchild
), desired_p
);
955 clear_glyph_matrix (w
->desired_matrix
);
958 clear_glyph_matrix (w
->current_matrix
);
959 w
->window_end_valid
= Qnil
;
963 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
969 /***********************************************************************
972 See dispextern.h for an overall explanation of glyph rows.
973 ***********************************************************************/
975 /* Clear glyph row ROW. Do it in a way that makes it robust against
976 changes in the glyph_row structure, i.e. addition or removal of
977 structure members. */
980 clear_glyph_row (row
)
981 struct glyph_row
*row
;
983 struct glyph
*p
[1 + LAST_AREA
];
984 static struct glyph_row null_row
;
987 p
[LEFT_MARGIN_AREA
] = row
->glyphs
[LEFT_MARGIN_AREA
];
988 p
[TEXT_AREA
] = row
->glyphs
[TEXT_AREA
];
989 p
[RIGHT_MARGIN_AREA
] = row
->glyphs
[RIGHT_MARGIN_AREA
];
990 p
[LAST_AREA
] = row
->glyphs
[LAST_AREA
];
995 /* Restore pointers. */
996 row
->glyphs
[LEFT_MARGIN_AREA
] = p
[LEFT_MARGIN_AREA
];
997 row
->glyphs
[TEXT_AREA
] = p
[TEXT_AREA
];
998 row
->glyphs
[RIGHT_MARGIN_AREA
] = p
[RIGHT_MARGIN_AREA
];
999 row
->glyphs
[LAST_AREA
] = p
[LAST_AREA
];
1001 #if 0 /* At some point, some bit-fields of struct glyph were not set,
1002 which made glyphs unequal when compared with GLYPH_EQUAL_P.
1003 Redisplay outputs such glyphs, and flickering effects were
1004 the result. This also depended on the contents of memory
1005 returned by xmalloc. If flickering happens again, activate
1006 the code below If the flickering is gone with that, chances
1007 are that the flickering has the same reason as here. */
1008 bzero (p
[0], (char *) p
[LAST_AREA
] - (char *) p
[0]);
1013 /* Make ROW an empty, enabled row of canonical character height,
1014 in window W starting at y-position Y. */
1017 blank_row (w
, row
, y
)
1019 struct glyph_row
*row
;
1024 min_y
= WINDOW_DISPLAY_HEADER_LINE_HEIGHT (w
);
1025 max_y
= WINDOW_DISPLAY_HEIGHT_NO_MODE_LINE (w
);
1027 clear_glyph_row (row
);
1029 row
->ascent
= row
->phys_ascent
= 0;
1030 row
->height
= row
->phys_height
= CANON_Y_UNIT (XFRAME (w
->frame
));
1033 row
->visible_height
= row
->height
- (min_y
- row
->y
);
1034 else if (row
->y
+ row
->height
> max_y
)
1035 row
->visible_height
= row
->height
- (row
->y
+ row
->height
- max_y
);
1037 row
->visible_height
= row
->height
;
1043 /* Increment buffer positions in glyph row ROW. DELTA and DELTA_BYTES
1044 are the amounts by which to change positions. Note that the first
1045 glyph of the text area of a row can have a buffer position even if
1046 the used count of the text area is zero. Such rows display line
1050 increment_row_positions (row
, delta
, delta_bytes
)
1051 struct glyph_row
*row
;
1052 int delta
, delta_bytes
;
1056 /* Increment start and end positions. */
1057 MATRIX_ROW_START_CHARPOS (row
) += delta
;
1058 MATRIX_ROW_START_BYTEPOS (row
) += delta_bytes
;
1059 MATRIX_ROW_END_CHARPOS (row
) += delta
;
1060 MATRIX_ROW_END_BYTEPOS (row
) += delta_bytes
;
1062 /* Increment positions in glyphs. */
1063 for (area
= 0; area
< LAST_AREA
; ++area
)
1064 for (i
= 0; i
< row
->used
[area
]; ++i
)
1065 if (BUFFERP (row
->glyphs
[area
][i
].object
)
1066 && row
->glyphs
[area
][i
].charpos
> 0)
1067 row
->glyphs
[area
][i
].charpos
+= delta
;
1069 /* Capture the case of rows displaying a line end. */
1070 if (row
->used
[TEXT_AREA
] == 0
1071 && MATRIX_ROW_DISPLAYS_TEXT_P (row
))
1072 row
->glyphs
[TEXT_AREA
]->charpos
+= delta
;
1077 /* Swap glyphs between two glyph rows A and B. This exchanges glyph
1078 contents, i.e. glyph structure contents are exchanged between A and
1079 B without changing glyph pointers in A and B. */
1082 swap_glyphs_in_rows (a
, b
)
1083 struct glyph_row
*a
, *b
;
1087 for (area
= 0; area
< LAST_AREA
; ++area
)
1089 /* Number of glyphs to swap. */
1090 int max_used
= max (a
->used
[area
], b
->used
[area
]);
1092 /* Start of glyphs in area of row A. */
1093 struct glyph
*glyph_a
= a
->glyphs
[area
];
1095 /* End + 1 of glyphs in area of row A. */
1096 struct glyph
*glyph_a_end
= a
->glyphs
[max_used
];
1098 /* Start of glyphs in area of row B. */
1099 struct glyph
*glyph_b
= b
->glyphs
[area
];
1101 while (glyph_a
< glyph_a_end
)
1103 /* Non-ISO HP/UX compiler doesn't like auto struct
1107 *glyph_a
= *glyph_b
;
1117 /* Exchange pointers to glyph memory between glyph rows A and B. */
1120 swap_glyph_pointers (a
, b
)
1121 struct glyph_row
*a
, *b
;
1124 for (i
= 0; i
< LAST_AREA
+ 1; ++i
)
1126 struct glyph
*temp
= a
->glyphs
[i
];
1127 a
->glyphs
[i
] = b
->glyphs
[i
];
1128 b
->glyphs
[i
] = temp
;
1133 /* Copy glyph row structure FROM to glyph row structure TO, except
1134 that glyph pointers in the structures are left unchanged. */
1137 copy_row_except_pointers (to
, from
)
1138 struct glyph_row
*to
, *from
;
1140 struct glyph
*pointers
[1 + LAST_AREA
];
1142 /* Save glyph pointers of TO. */
1143 bcopy (to
->glyphs
, pointers
, sizeof to
->glyphs
);
1145 /* Do a structure assignment. */
1148 /* Restore original pointers of TO. */
1149 bcopy (pointers
, to
->glyphs
, sizeof to
->glyphs
);
1153 /* Copy contents of glyph row FROM to glyph row TO. Glyph pointers in
1154 TO and FROM are left unchanged. Glyph contents are copied from the
1155 glyph memory of FROM to the glyph memory of TO. Increment buffer
1156 positions in row TO by DELTA/ DELTA_BYTES. */
1159 copy_glyph_row_contents (to
, from
, delta
, delta_bytes
)
1160 struct glyph_row
*to
, *from
;
1161 int delta
, delta_bytes
;
1165 /* This is like a structure assignment TO = FROM, except that
1166 glyph pointers in the rows are left unchanged. */
1167 copy_row_except_pointers (to
, from
);
1169 /* Copy glyphs from FROM to TO. */
1170 for (area
= 0; area
< LAST_AREA
; ++area
)
1171 if (from
->used
[area
])
1172 bcopy (from
->glyphs
[area
], to
->glyphs
[area
],
1173 from
->used
[area
] * sizeof (struct glyph
));
1175 /* Increment buffer positions in TO by DELTA. */
1176 increment_row_positions (to
, delta
, delta_bytes
);
1180 /* Assign glyph row FROM to glyph row TO. This works like a structure
1181 assignment TO = FROM, except that glyph pointers are not copied but
1182 exchanged between TO and FROM. Pointers must be exchanged to avoid
1186 assign_row (to
, from
)
1187 struct glyph_row
*to
, *from
;
1189 swap_glyph_pointers (to
, from
);
1190 copy_row_except_pointers (to
, from
);
1194 /* Test whether the glyph memory of the glyph row WINDOW_ROW, which is
1195 a row in a window matrix, is a slice of the glyph memory of the
1196 glyph row FRAME_ROW which is a row in a frame glyph matrix. Value
1197 is non-zero if the glyph memory of WINDOW_ROW is part of the glyph
1198 memory of FRAME_ROW. */
1203 glyph_row_slice_p (window_row
, frame_row
)
1204 struct glyph_row
*window_row
, *frame_row
;
1206 struct glyph
*window_glyph_start
= window_row
->glyphs
[0];
1207 struct glyph
*frame_glyph_start
= frame_row
->glyphs
[0];
1208 struct glyph
*frame_glyph_end
= frame_row
->glyphs
[LAST_AREA
];
1210 return (frame_glyph_start
<= window_glyph_start
1211 && window_glyph_start
< frame_glyph_end
);
1214 #endif /* GLYPH_DEBUG */
1218 /* Find the row in the window glyph matrix WINDOW_MATRIX being a slice
1219 of ROW in the frame matrix FRAME_MATRIX. Value is null if no row
1220 in WINDOW_MATRIX is found satisfying the condition. */
1222 static struct glyph_row
*
1223 find_glyph_row_slice (window_matrix
, frame_matrix
, row
)
1224 struct glyph_matrix
*window_matrix
, *frame_matrix
;
1229 xassert (row
>= 0 && row
< frame_matrix
->nrows
);
1231 for (i
= 0; i
< window_matrix
->nrows
; ++i
)
1232 if (glyph_row_slice_p (window_matrix
->rows
+ i
,
1233 frame_matrix
->rows
+ row
))
1236 return i
< window_matrix
->nrows
? window_matrix
->rows
+ i
: 0;
1241 /* Prepare ROW for display. Desired rows are cleared lazily,
1242 i.e. they are only marked as to be cleared by setting their
1243 enabled_p flag to zero. When a row is to be displayed, a prior
1244 call to this function really clears it. */
1247 prepare_desired_row (row
)
1248 struct glyph_row
*row
;
1250 if (!row
->enabled_p
)
1252 clear_glyph_row (row
);
1258 /* Return a hash code for glyph row ROW. */
1261 line_hash_code (row
)
1262 struct glyph_row
*row
;
1270 /* Give all highlighted lines the same hash code
1271 so as to encourage scrolling to leave them in place. */
1276 struct glyph
*glyph
= row
->glyphs
[TEXT_AREA
];
1277 struct glyph
*end
= glyph
+ row
->used
[TEXT_AREA
];
1281 int c
= glyph
->u
.ch
;
1282 int face_id
= glyph
->face_id
;
1283 if (must_write_spaces
)
1285 hash
= (((hash
<< 4) + (hash
>> 24)) & 0x0fffffff) + c
;
1286 hash
= (((hash
<< 4) + (hash
>> 24)) & 0x0fffffff) + face_id
;
1299 /* Return the cost of drawing line VPOS In MATRIX. The cost equals
1300 the number of characters in the line. If must_write_spaces is
1301 zero, leading and trailing spaces are ignored. */
1304 line_draw_cost (matrix
, vpos
)
1305 struct glyph_matrix
*matrix
;
1308 struct glyph_row
*row
= matrix
->rows
+ vpos
;
1309 struct glyph
*beg
= row
->glyphs
[TEXT_AREA
];
1310 struct glyph
*end
= beg
+ row
->used
[TEXT_AREA
];
1312 Lisp_Object
*glyph_table_base
= GLYPH_TABLE_BASE
;
1313 int glyph_table_len
= GLYPH_TABLE_LENGTH
;
1315 /* Ignore trailing and leading spaces if we can. */
1316 if (!must_write_spaces
)
1318 /* Skip from the end over trailing spaces. */
1319 while (end
!= beg
&& CHAR_GLYPH_SPACE_P (*end
))
1322 /* All blank line. */
1326 /* Skip over leading spaces. */
1327 while (CHAR_GLYPH_SPACE_P (*beg
))
1331 /* If we don't have a glyph-table, each glyph is one character,
1332 so return the number of glyphs. */
1333 if (glyph_table_base
== 0)
1337 /* Otherwise, scan the glyphs and accumulate their total length
1342 GLYPH g
= GLYPH_FROM_CHAR_GLYPH (*beg
);
1345 || GLYPH_SIMPLE_P (glyph_table_base
, glyph_table_len
, g
))
1348 len
+= GLYPH_LENGTH (glyph_table_base
, g
);
1358 /* Test two glyph rows A and B for equality. Value is non-zero if A
1359 and B have equal contents. W is the window to which the glyphs
1360 rows A and B belong. It is needed here to test for partial row
1361 visibility. MOUSE_FACE_P non-zero means compare the mouse_face_p
1362 flags of A and B, too. */
1365 row_equal_p (w
, a
, b
, mouse_face_p
)
1367 struct glyph_row
*a
, *b
;
1372 else if (a
->hash
!= b
->hash
)
1376 struct glyph
*a_glyph
, *b_glyph
, *a_end
;
1379 if (mouse_face_p
&& a
->mouse_face_p
!= b
->mouse_face_p
)
1382 /* Compare glyphs. */
1383 for (area
= LEFT_MARGIN_AREA
; area
< LAST_AREA
; ++area
)
1385 if (a
->used
[area
] != b
->used
[area
])
1388 a_glyph
= a
->glyphs
[area
];
1389 a_end
= a_glyph
+ a
->used
[area
];
1390 b_glyph
= b
->glyphs
[area
];
1392 while (a_glyph
< a_end
1393 && GLYPH_EQUAL_P (a_glyph
, b_glyph
))
1394 ++a_glyph
, ++b_glyph
;
1396 if (a_glyph
!= a_end
)
1400 if (a
->truncated_on_left_p
!= b
->truncated_on_left_p
1401 || a
->inverse_p
!= b
->inverse_p
1402 || a
->fill_line_p
!= b
->fill_line_p
1403 || a
->truncated_on_right_p
!= b
->truncated_on_right_p
1404 || a
->overlay_arrow_p
!= b
->overlay_arrow_p
1405 || a
->continued_p
!= b
->continued_p
1406 || a
->indicate_empty_line_p
!= b
->indicate_empty_line_p
1407 || a
->overlapped_p
!= b
->overlapped_p
1408 || (MATRIX_ROW_CONTINUATION_LINE_P (a
)
1409 != MATRIX_ROW_CONTINUATION_LINE_P (b
))
1410 /* Different partially visible characters on left margin. */
1412 /* Different height. */
1413 || a
->ascent
!= b
->ascent
1414 || a
->phys_ascent
!= b
->phys_ascent
1415 || a
->phys_height
!= b
->phys_height
1416 || a
->visible_height
!= b
->visible_height
)
1425 /***********************************************************************
1428 See dispextern.h for an overall explanation of glyph pools.
1429 ***********************************************************************/
1431 /* Allocate a glyph_pool structure. The structure returned is
1432 initialized with zeros. The global variable glyph_pool_count is
1433 incremented for each pool allocated. */
1435 static struct glyph_pool
*
1438 struct glyph_pool
*result
;
1440 /* Allocate a new glyph_pool and clear it. */
1441 result
= (struct glyph_pool
*) xmalloc (sizeof *result
);
1442 bzero (result
, sizeof *result
);
1444 /* For memory leak and double deletion checking. */
1451 /* Free a glyph_pool structure POOL. The function may be called with
1452 a null POOL pointer. The global variable glyph_pool_count is
1453 decremented with every pool structure freed. If this count gets
1454 negative, more structures were freed than allocated, i.e. one
1455 structure must have been freed more than once or a bogus pointer
1456 was passed to free_glyph_pool. */
1459 free_glyph_pool (pool
)
1460 struct glyph_pool
*pool
;
1464 /* More freed than allocated? */
1466 xassert (glyph_pool_count
>= 0);
1468 xfree (pool
->glyphs
);
1474 /* Enlarge a glyph pool POOL. MATRIX_DIM gives the number of rows and
1475 columns we need. This function never shrinks a pool. The only
1476 case in which this would make sense, would be when a frame's size
1477 is changed from a large value to a smaller one. But, if someone
1478 does it once, we can expect that he will do it again.
1480 Value is non-zero if the pool changed in a way which makes
1481 re-adjusting window glyph matrices necessary. */
1484 realloc_glyph_pool (pool
, matrix_dim
)
1485 struct glyph_pool
*pool
;
1486 struct dim matrix_dim
;
1491 changed_p
= (pool
->glyphs
== 0
1492 || matrix_dim
.height
!= pool
->nrows
1493 || matrix_dim
.width
!= pool
->ncolumns
);
1495 /* Enlarge the glyph pool. */
1496 needed
= matrix_dim
.width
* matrix_dim
.height
;
1497 if (needed
> pool
->nglyphs
)
1499 int size
= needed
* sizeof (struct glyph
);
1502 pool
->glyphs
= (struct glyph
*) xrealloc (pool
->glyphs
, size
);
1505 pool
->glyphs
= (struct glyph
*) xmalloc (size
);
1506 bzero (pool
->glyphs
, size
);
1509 pool
->nglyphs
= needed
;
1512 /* Remember the number of rows and columns because (a) we use then
1513 to do sanity checks, and (b) the number of columns determines
1514 where rows in the frame matrix start---this must be available to
1515 determine pointers to rows of window sub-matrices. */
1516 pool
->nrows
= matrix_dim
.height
;
1517 pool
->ncolumns
= matrix_dim
.width
;
1524 /***********************************************************************
1526 ***********************************************************************/
1531 /* Flush standard output. This is sometimes useful to call from
1541 /* Check that no glyph pointers have been lost in MATRIX. If a
1542 pointer has been lost, e.g. by using a structure assignment between
1543 rows, at least one pointer must occur more than once in the rows of
1547 check_matrix_pointer_lossage (matrix
)
1548 struct glyph_matrix
*matrix
;
1552 for (i
= 0; i
< matrix
->nrows
; ++i
)
1553 for (j
= 0; j
< matrix
->nrows
; ++j
)
1555 || (matrix
->rows
[i
].glyphs
[TEXT_AREA
]
1556 != matrix
->rows
[j
].glyphs
[TEXT_AREA
]));
1560 /* Get a pointer to glyph row ROW in MATRIX, with bounds checks. */
1563 matrix_row (matrix
, row
)
1564 struct glyph_matrix
*matrix
;
1567 xassert (matrix
&& matrix
->rows
);
1568 xassert (row
>= 0 && row
< matrix
->nrows
);
1570 /* That's really too slow for normal testing because this function
1571 is called almost everywhere. Although---it's still astonishingly
1572 fast, so it is valuable to have for debugging purposes. */
1574 check_matrix_pointer_lossage (matrix
);
1577 return matrix
->rows
+ row
;
1581 #if 0 /* This function makes invalid assumptions when text is
1582 partially invisible. But it might come handy for debugging
1585 /* Check invariants that must hold for an up to date current matrix of
1589 check_matrix_invariants (w
)
1592 struct glyph_matrix
*matrix
= w
->current_matrix
;
1593 int yb
= window_text_bottom_y (w
);
1594 struct glyph_row
*row
= matrix
->rows
;
1595 struct glyph_row
*last_text_row
= NULL
;
1596 struct buffer
*saved
= current_buffer
;
1597 struct buffer
*buffer
= XBUFFER (w
->buffer
);
1600 /* This can sometimes happen for a fresh window. */
1601 if (matrix
->nrows
< 2)
1604 set_buffer_temp (buffer
);
1606 /* Note: last row is always reserved for the mode line. */
1607 while (MATRIX_ROW_DISPLAYS_TEXT_P (row
)
1608 && MATRIX_ROW_BOTTOM_Y (row
) < yb
)
1610 struct glyph_row
*next
= row
+ 1;
1612 if (MATRIX_ROW_DISPLAYS_TEXT_P (row
))
1613 last_text_row
= row
;
1615 /* Check that character and byte positions are in sync. */
1616 xassert (MATRIX_ROW_START_BYTEPOS (row
)
1617 == CHAR_TO_BYTE (MATRIX_ROW_START_CHARPOS (row
)));
1619 /* CHAR_TO_BYTE aborts when invoked for a position > Z. We can
1620 have such a position temporarily in case of a minibuffer
1621 displaying something like `[Sole completion]' at its end. */
1622 if (MATRIX_ROW_END_CHARPOS (row
) < BUF_ZV (current_buffer
))
1623 xassert (MATRIX_ROW_END_BYTEPOS (row
)
1624 == CHAR_TO_BYTE (MATRIX_ROW_END_CHARPOS (row
)));
1626 /* Check that end position of `row' is equal to start position
1628 if (next
->enabled_p
&& MATRIX_ROW_DISPLAYS_TEXT_P (next
))
1630 xassert (MATRIX_ROW_END_CHARPOS (row
)
1631 == MATRIX_ROW_START_CHARPOS (next
));
1632 xassert (MATRIX_ROW_END_BYTEPOS (row
)
1633 == MATRIX_ROW_START_BYTEPOS (next
));
1638 xassert (w
->current_matrix
->nrows
== w
->desired_matrix
->nrows
);
1639 xassert (w
->desired_matrix
->rows
!= NULL
);
1640 set_buffer_temp (saved
);
1645 #endif /* GLYPH_DEBUG != 0 */
1649 /**********************************************************************
1650 Allocating/ Adjusting Glyph Matrices
1651 **********************************************************************/
1653 /* Allocate glyph matrices over a window tree for a frame-based
1656 X and Y are column/row within the frame glyph matrix where
1657 sub-matrices for the window tree rooted at WINDOW must be
1658 allocated. CH_DIM contains the dimensions of the smallest
1659 character that could be used during display. DIM_ONLY_P non-zero
1660 means that the caller of this function is only interested in the
1661 result matrix dimension, and matrix adjustments should not be
1664 The function returns the total width/height of the sub-matrices of
1665 the window tree. If called on a frame root window, the computation
1666 will take the mini-buffer window into account.
1668 *WINDOW_CHANGE_FLAGS is set to a bit mask with bits
1670 NEW_LEAF_MATRIX set if any window in the tree did not have a
1671 glyph matrices yet, and
1673 CHANGED_LEAF_MATRIX set if the dimension or location of a matrix of
1674 any window in the tree will be changed or have been changed (see
1677 *WINDOW_CHANGE_FLAGS must be initialized by the caller of this
1680 Windows are arranged into chains of windows on the same level
1681 through the next fields of window structures. Such a level can be
1682 either a sequence of horizontally adjacent windows from left to
1683 right, or a sequence of vertically adjacent windows from top to
1684 bottom. Each window in a horizontal sequence can be either a leaf
1685 window or a vertical sequence; a window in a vertical sequence can
1686 be either a leaf or a horizontal sequence. All windows in a
1687 horizontal sequence have the same height, and all windows in a
1688 vertical sequence have the same width.
1690 This function uses, for historical reasons, a more general
1691 algorithm to determine glyph matrix dimensions that would be
1694 The matrix height of a horizontal sequence is determined by the
1695 maximum height of any matrix in the sequence. The matrix width of
1696 a horizontal sequence is computed by adding up matrix widths of
1697 windows in the sequence.
1699 |<------- result width ------->|
1700 +---------+----------+---------+ ---
1703 +---------+ | | result height
1708 The matrix width of a vertical sequence is the maximum matrix width
1709 of any window in the sequence. Its height is computed by adding up
1710 matrix heights of windows in the sequence.
1712 |<---- result width -->|
1720 +------------+---------+ |
1723 +------------+---------+ --- */
1725 /* Bit indicating that a new matrix will be allocated or has been
1728 #define NEW_LEAF_MATRIX (1 << 0)
1730 /* Bit indicating that a matrix will or has changed its location or
1733 #define CHANGED_LEAF_MATRIX (1 << 1)
1736 allocate_matrices_for_frame_redisplay (window
, x
, y
, ch_dim
,
1737 dim_only_p
, window_change_flags
)
1742 int *window_change_flags
;
1744 struct frame
*f
= XFRAME (WINDOW_FRAME (XWINDOW (window
)));
1746 int wmax
= 0, hmax
= 0;
1750 int in_horz_combination_p
;
1752 /* What combination is WINDOW part of? Compute this once since the
1753 result is the same for all windows in the `next' chain. The
1754 special case of a root window (parent equal to nil) is treated
1755 like a vertical combination because a root window's `next'
1756 points to the mini-buffer window, if any, which is arranged
1757 vertically below other windows. */
1758 in_horz_combination_p
1759 = (!NILP (XWINDOW (window
)->parent
)
1760 && !NILP (XWINDOW (XWINDOW (window
)->parent
)->hchild
));
1762 /* For WINDOW and all windows on the same level. */
1765 w
= XWINDOW (window
);
1767 /* Get the dimension of the window sub-matrix for W, depending
1768 on whether this a combination or a leaf window. */
1769 if (!NILP (w
->hchild
))
1770 dim
= allocate_matrices_for_frame_redisplay (w
->hchild
, x
, y
, ch_dim
,
1772 window_change_flags
);
1773 else if (!NILP (w
->vchild
))
1774 dim
= allocate_matrices_for_frame_redisplay (w
->vchild
, x
, y
, ch_dim
,
1776 window_change_flags
);
1779 /* If not already done, allocate sub-matrix structures. */
1780 if (w
->desired_matrix
== NULL
)
1782 w
->desired_matrix
= new_glyph_matrix (f
->desired_pool
);
1783 w
->current_matrix
= new_glyph_matrix (f
->current_pool
);
1784 *window_change_flags
|= NEW_LEAF_MATRIX
;
1787 /* Width and height MUST be chosen so that there are no
1788 holes in the frame matrix. */
1789 dim
.width
= XINT (w
->width
);
1790 dim
.height
= XINT (w
->height
);
1792 /* Will matrix be re-allocated? */
1793 if (x
!= w
->desired_matrix
->matrix_x
1794 || y
!= w
->desired_matrix
->matrix_y
1795 || dim
.width
!= w
->desired_matrix
->matrix_w
1796 || dim
.height
!= w
->desired_matrix
->matrix_h
1797 || (margin_glyphs_to_reserve (w
, dim
.width
,
1798 w
->right_margin_width
)
1799 != w
->desired_matrix
->left_margin_glyphs
)
1800 || (margin_glyphs_to_reserve (w
, dim
.width
,
1801 w
->left_margin_width
)
1802 != w
->desired_matrix
->right_margin_glyphs
))
1803 *window_change_flags
|= CHANGED_LEAF_MATRIX
;
1805 /* Actually change matrices, if allowed. Do not consider
1806 CHANGED_LEAF_MATRIX computed above here because the pool
1807 may have been changed which we don't now here. We trust
1808 that we only will be called with DIM_ONLY_P != 0 when
1812 adjust_glyph_matrix (w
, w
->desired_matrix
, x
, y
, dim
);
1813 adjust_glyph_matrix (w
, w
->current_matrix
, x
, y
, dim
);
1817 /* If we are part of a horizontal combination, advance x for
1818 windows to the right of W; otherwise advance y for windows
1820 if (in_horz_combination_p
)
1825 /* Remember maximum glyph matrix dimensions. */
1826 wmax
= max (wmax
, dim
.width
);
1827 hmax
= max (hmax
, dim
.height
);
1829 /* Next window on same level. */
1832 while (!NILP (window
));
1834 /* Set `total' to the total glyph matrix dimension of this window
1835 level. In a vertical combination, the width is the width of the
1836 widest window; the height is the y we finally reached, corrected
1837 by the y we started with. In a horizontal combination, the total
1838 height is the height of the tallest window, and the width is the
1839 x we finally reached, corrected by the x we started with. */
1840 if (in_horz_combination_p
)
1842 total
.width
= x
- x0
;
1843 total
.height
= hmax
;
1848 total
.height
= y
- y0
;
1855 /* Allocate window matrices for window-based redisplay. W is the
1856 window whose matrices must be allocated/reallocated. CH_DIM is the
1857 size of the smallest character that could potentially be used on W. */
1860 allocate_matrices_for_window_redisplay (w
, ch_dim
)
1864 struct frame
*f
= XFRAME (w
->frame
);
1868 if (!NILP (w
->vchild
))
1869 allocate_matrices_for_window_redisplay (XWINDOW (w
->vchild
), ch_dim
);
1870 else if (!NILP (w
->hchild
))
1871 allocate_matrices_for_window_redisplay (XWINDOW (w
->hchild
), ch_dim
);
1874 /* W is a leaf window. */
1875 int window_pixel_width
= XFLOATINT (w
->width
) * CANON_X_UNIT (f
);
1876 int window_pixel_height
= window_box_height (w
) + abs (w
->vscroll
);
1879 /* If matrices are not yet allocated, allocate them now. */
1880 if (w
->desired_matrix
== NULL
)
1882 w
->desired_matrix
= new_glyph_matrix (NULL
);
1883 w
->current_matrix
= new_glyph_matrix (NULL
);
1886 /* Compute number of glyphs needed in a glyph row. */
1887 dim
.width
= (((window_pixel_width
+ ch_dim
.width
- 1)
1889 /* 2 partially visible columns in the text area. */
1891 /* One partially visible column at the right
1892 edge of each marginal area. */
1895 /* Compute number of glyph rows needed. */
1896 dim
.height
= (((window_pixel_height
+ ch_dim
.height
- 1)
1898 /* One partially visible line at the top and
1899 bottom of the window. */
1901 /* 2 for top and mode line. */
1904 /* Change matrices. */
1905 adjust_glyph_matrix (w
, w
->desired_matrix
, 0, 0, dim
);
1906 adjust_glyph_matrix (w
, w
->current_matrix
, 0, 0, dim
);
1909 w
= NILP (w
->next
) ? NULL
: XWINDOW (w
->next
);
1914 /* Re-allocate/ re-compute glyph matrices on frame F. If F is null,
1915 do it for all frames; otherwise do it just for the given frame.
1916 This function must be called when a new frame is created, its size
1917 changes, or its window configuration changes. */
1923 /* Block input so that expose events and other events that access
1924 glyph matrices are not processed while we are changing them. */
1928 adjust_frame_glyphs (f
);
1931 Lisp_Object tail
, lisp_frame
;
1933 FOR_EACH_FRAME (tail
, lisp_frame
)
1934 adjust_frame_glyphs (XFRAME (lisp_frame
));
1941 /* Adjust frame glyphs when Emacs is initialized.
1943 To be called from init_display.
1945 We need a glyph matrix because redraw will happen soon.
1946 Unfortunately, window sizes on selected_frame are not yet set to
1947 meaningful values. I believe we can assume that there are only two
1948 windows on the frame---the mini-buffer and the root window. Frame
1949 height and width seem to be correct so far. So, set the sizes of
1950 windows to estimated values. */
1953 adjust_frame_glyphs_initially ()
1955 struct frame
*sf
= SELECTED_FRAME ();
1956 struct window
*root
= XWINDOW (sf
->root_window
);
1957 struct window
*mini
= XWINDOW (root
->next
);
1958 int frame_height
= FRAME_HEIGHT (sf
);
1959 int frame_width
= FRAME_WIDTH (sf
);
1960 int top_margin
= FRAME_TOP_MARGIN (sf
);
1962 /* Do it for the root window. */
1963 XSETFASTINT (root
->top
, top_margin
);
1964 XSETFASTINT (root
->width
, frame_width
);
1965 set_window_height (sf
->root_window
, frame_height
- 1 - top_margin
, 0);
1967 /* Do it for the mini-buffer window. */
1968 XSETFASTINT (mini
->top
, frame_height
- 1);
1969 XSETFASTINT (mini
->width
, frame_width
);
1970 set_window_height (root
->next
, 1, 0);
1972 adjust_frame_glyphs (sf
);
1973 glyphs_initialized_initially_p
= 1;
1977 /* Allocate/reallocate glyph matrices of a single frame F. */
1980 adjust_frame_glyphs (f
)
1983 if (FRAME_WINDOW_P (f
))
1984 adjust_frame_glyphs_for_window_redisplay (f
);
1986 adjust_frame_glyphs_for_frame_redisplay (f
);
1988 /* Don't forget the message buffer and the buffer for
1989 decode_mode_spec. */
1990 adjust_frame_message_buffer (f
);
1991 adjust_decode_mode_spec_buffer (f
);
1993 f
->glyphs_initialized_p
= 1;
1997 /* Allocate/reallocate glyph matrices of a single frame F for
1998 frame-based redisplay. */
2001 adjust_frame_glyphs_for_frame_redisplay (f
)
2005 struct dim matrix_dim
;
2007 int window_change_flags
;
2010 if (!FRAME_LIVE_P (f
))
2013 /* Determine the smallest character in any font for F. On
2014 console windows, all characters have dimension (1, 1). */
2015 ch_dim
.width
= ch_dim
.height
= 1;
2017 top_window_y
= FRAME_TOP_MARGIN (f
);
2019 /* Allocate glyph pool structures if not already done. */
2020 if (f
->desired_pool
== NULL
)
2022 f
->desired_pool
= new_glyph_pool ();
2023 f
->current_pool
= new_glyph_pool ();
2026 /* Allocate frames matrix structures if needed. */
2027 if (f
->desired_matrix
== NULL
)
2029 f
->desired_matrix
= new_glyph_matrix (f
->desired_pool
);
2030 f
->current_matrix
= new_glyph_matrix (f
->current_pool
);
2033 /* Compute window glyph matrices. (This takes the mini-buffer
2034 window into account). The result is the size of the frame glyph
2035 matrix needed. The variable window_change_flags is set to a bit
2036 mask indicating whether new matrices will be allocated or
2037 existing matrices change their size or location within the frame
2039 window_change_flags
= 0;
2041 = allocate_matrices_for_frame_redisplay (FRAME_ROOT_WINDOW (f
),
2044 &window_change_flags
);
2046 /* Add in menu bar lines, if any. */
2047 matrix_dim
.height
+= top_window_y
;
2049 /* Enlarge pools as necessary. */
2050 pool_changed_p
= realloc_glyph_pool (f
->desired_pool
, matrix_dim
);
2051 realloc_glyph_pool (f
->current_pool
, matrix_dim
);
2053 /* Set up glyph pointers within window matrices. Do this only if
2054 absolutely necessary since it requires a frame redraw. */
2055 if (pool_changed_p
|| window_change_flags
)
2057 /* Do it for window matrices. */
2058 allocate_matrices_for_frame_redisplay (FRAME_ROOT_WINDOW (f
),
2059 0, top_window_y
, ch_dim
, 0,
2060 &window_change_flags
);
2062 /* Size of frame matrices must equal size of frame. Note
2063 that we are called for X frames with window widths NOT equal
2064 to the frame width (from CHANGE_FRAME_SIZE_1). */
2065 xassert (matrix_dim
.width
== FRAME_WIDTH (f
)
2066 && matrix_dim
.height
== FRAME_HEIGHT (f
));
2068 /* Resize frame matrices. */
2069 adjust_glyph_matrix (NULL
, f
->desired_matrix
, 0, 0, matrix_dim
);
2070 adjust_glyph_matrix (NULL
, f
->current_matrix
, 0, 0, matrix_dim
);
2072 /* Since location and size of sub-matrices within the pool may
2073 have changed, and current matrices don't have meaningful
2074 contents anymore, mark the frame garbaged. */
2075 SET_FRAME_GARBAGED (f
);
2080 /* Allocate/reallocate glyph matrices of a single frame F for
2081 window-based redisplay. */
2084 adjust_frame_glyphs_for_window_redisplay (f
)
2090 xassert (FRAME_WINDOW_P (f
) && FRAME_LIVE_P (f
));
2092 /* Get minimum sizes. */
2093 #ifdef HAVE_WINDOW_SYSTEM
2094 ch_dim
.width
= FRAME_SMALLEST_CHAR_WIDTH (f
);
2095 ch_dim
.height
= FRAME_SMALLEST_FONT_HEIGHT (f
);
2097 ch_dim
.width
= ch_dim
.height
= 1;
2100 /* Allocate/reallocate window matrices. */
2101 allocate_matrices_for_window_redisplay (XWINDOW (FRAME_ROOT_WINDOW (f
)),
2104 /* Allocate/ reallocate matrices of the dummy window used to display
2105 the menu bar under X when no X toolkit support is available. */
2106 #ifndef USE_X_TOOLKIT
2108 /* Allocate a dummy window if not already done. */
2109 if (NILP (f
->menu_bar_window
))
2111 f
->menu_bar_window
= make_window ();
2112 w
= XWINDOW (f
->menu_bar_window
);
2113 XSETFRAME (w
->frame
, f
);
2114 w
->pseudo_window_p
= 1;
2117 w
= XWINDOW (f
->menu_bar_window
);
2119 /* Set window dimensions to frame dimensions and allocate or
2120 adjust glyph matrices of W. */
2121 XSETFASTINT (w
->top
, 0);
2122 XSETFASTINT (w
->left
, 0);
2123 XSETFASTINT (w
->height
, FRAME_MENU_BAR_LINES (f
));
2124 XSETFASTINT (w
->width
, FRAME_WINDOW_WIDTH (f
));
2125 allocate_matrices_for_window_redisplay (w
, ch_dim
);
2127 #endif /* not USE_X_TOOLKIT */
2129 /* Allocate/ reallocate matrices of the tool bar window. If we
2130 don't have a tool bar window yet, make one. */
2131 if (NILP (f
->tool_bar_window
))
2133 f
->tool_bar_window
= make_window ();
2134 w
= XWINDOW (f
->tool_bar_window
);
2135 XSETFRAME (w
->frame
, f
);
2136 w
->pseudo_window_p
= 1;
2139 w
= XWINDOW (f
->tool_bar_window
);
2141 XSETFASTINT (w
->top
, FRAME_MENU_BAR_LINES (f
));
2142 XSETFASTINT (w
->left
, 0);
2143 XSETFASTINT (w
->height
, FRAME_TOOL_BAR_LINES (f
));
2144 XSETFASTINT (w
->width
, FRAME_WINDOW_WIDTH (f
));
2145 allocate_matrices_for_window_redisplay (w
, ch_dim
);
2149 /* Adjust/ allocate message buffer of frame F.
2151 Note that the message buffer is never freed. Since I could not
2152 find a free in 19.34, I assume that freeing it would be
2153 problematic in some way and don't do it either.
2155 (Implementation note: It should be checked if we can free it
2156 eventually without causing trouble). */
2159 adjust_frame_message_buffer (f
)
2162 int size
= FRAME_MESSAGE_BUF_SIZE (f
) + 1;
2164 if (FRAME_MESSAGE_BUF (f
))
2166 char *buffer
= FRAME_MESSAGE_BUF (f
);
2167 char *new_buffer
= (char *) xrealloc (buffer
, size
);
2168 FRAME_MESSAGE_BUF (f
) = new_buffer
;
2171 FRAME_MESSAGE_BUF (f
) = (char *) xmalloc (size
);
2175 /* Re-allocate buffer for decode_mode_spec on frame F. */
2178 adjust_decode_mode_spec_buffer (f
)
2181 f
->decode_mode_spec_buffer
2182 = (char *) xrealloc (f
->decode_mode_spec_buffer
,
2183 FRAME_MESSAGE_BUF_SIZE (f
) + 1);
2188 /**********************************************************************
2189 Freeing Glyph Matrices
2190 **********************************************************************/
2192 /* Free glyph memory for a frame F. F may be null. This function can
2193 be called for the same frame more than once. The root window of
2194 F may be nil when this function is called. This is the case when
2195 the function is called when F is destroyed. */
2201 if (f
&& f
->glyphs_initialized_p
)
2203 /* Block interrupt input so that we don't get surprised by an X
2204 event while we're in an inconsistent state. */
2206 f
->glyphs_initialized_p
= 0;
2208 /* Release window sub-matrices. */
2209 if (!NILP (f
->root_window
))
2210 free_window_matrices (XWINDOW (f
->root_window
));
2212 /* Free the dummy window for menu bars without X toolkit and its
2214 if (!NILP (f
->menu_bar_window
))
2216 struct window
*w
= XWINDOW (f
->menu_bar_window
);
2217 free_glyph_matrix (w
->desired_matrix
);
2218 free_glyph_matrix (w
->current_matrix
);
2219 w
->desired_matrix
= w
->current_matrix
= NULL
;
2220 f
->menu_bar_window
= Qnil
;
2223 /* Free the tool bar window and its glyph matrices. */
2224 if (!NILP (f
->tool_bar_window
))
2226 struct window
*w
= XWINDOW (f
->tool_bar_window
);
2227 free_glyph_matrix (w
->desired_matrix
);
2228 free_glyph_matrix (w
->current_matrix
);
2229 w
->desired_matrix
= w
->current_matrix
= NULL
;
2230 f
->tool_bar_window
= Qnil
;
2233 /* Release frame glyph matrices. Reset fields to zero in
2234 case we are called a second time. */
2235 if (f
->desired_matrix
)
2237 free_glyph_matrix (f
->desired_matrix
);
2238 free_glyph_matrix (f
->current_matrix
);
2239 f
->desired_matrix
= f
->current_matrix
= NULL
;
2242 /* Release glyph pools. */
2243 if (f
->desired_pool
)
2245 free_glyph_pool (f
->desired_pool
);
2246 free_glyph_pool (f
->current_pool
);
2247 f
->desired_pool
= f
->current_pool
= NULL
;
2255 /* Free glyph sub-matrices in the window tree rooted at W. This
2256 function may be called with a null pointer, and it may be called on
2257 the same tree more than once. */
2260 free_window_matrices (w
)
2265 if (!NILP (w
->hchild
))
2266 free_window_matrices (XWINDOW (w
->hchild
));
2267 else if (!NILP (w
->vchild
))
2268 free_window_matrices (XWINDOW (w
->vchild
));
2271 /* This is a leaf window. Free its memory and reset fields
2272 to zero in case this function is called a second time for
2274 free_glyph_matrix (w
->current_matrix
);
2275 free_glyph_matrix (w
->desired_matrix
);
2276 w
->current_matrix
= w
->desired_matrix
= NULL
;
2279 /* Next window on same level. */
2280 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
2285 /* Check glyph memory leaks. This function is called from
2286 shut_down_emacs. Note that frames are not destroyed when Emacs
2287 exits. We therefore free all glyph memory for all active frames
2288 explicitly and check that nothing is left allocated. */
2291 check_glyph_memory ()
2293 Lisp_Object tail
, frame
;
2295 /* Free glyph memory for all frames. */
2296 FOR_EACH_FRAME (tail
, frame
)
2297 free_glyphs (XFRAME (frame
));
2299 /* Check that nothing is left allocated. */
2300 if (glyph_matrix_count
)
2302 if (glyph_pool_count
)
2308 /**********************************************************************
2309 Building a Frame Matrix
2310 **********************************************************************/
2312 /* Most of the redisplay code works on glyph matrices attached to
2313 windows. This is a good solution most of the time, but it is not
2314 suitable for terminal code. Terminal output functions cannot rely
2315 on being able to set an arbitrary terminal window. Instead they
2316 must be provided with a view of the whole frame, i.e. the whole
2317 screen. We build such a view by constructing a frame matrix from
2318 window matrices in this section.
2320 Windows that must be updated have their must_be_update_p flag set.
2321 For all such windows, their desired matrix is made part of the
2322 desired frame matrix. For other windows, their current matrix is
2323 made part of the desired frame matrix.
2325 +-----------------+----------------+
2326 | desired | desired |
2328 +-----------------+----------------+
2331 +----------------------------------+
2333 Desired window matrices can be made part of the frame matrix in a
2334 cheap way: We exploit the fact that the desired frame matrix and
2335 desired window matrices share their glyph memory. This is not
2336 possible for current window matrices. Their glyphs are copied to
2337 the desired frame matrix. The latter is equivalent to
2338 preserve_other_columns in the old redisplay.
2340 Used glyphs counters for frame matrix rows are the result of adding
2341 up glyph lengths of the window matrices. A line in the frame
2342 matrix is enabled, if a corresponding line in a window matrix is
2345 After building the desired frame matrix, it will be passed to
2346 terminal code, which will manipulate both the desired and current
2347 frame matrix. Changes applied to the frame's current matrix have
2348 to be visible in current window matrices afterwards, of course.
2350 This problem is solved like this:
2352 1. Window and frame matrices share glyphs. Window matrices are
2353 constructed in a way that their glyph contents ARE the glyph
2354 contents needed in a frame matrix. Thus, any modification of
2355 glyphs done in terminal code will be reflected in window matrices
2358 2. Exchanges of rows in a frame matrix done by terminal code are
2359 intercepted by hook functions so that corresponding row operations
2360 on window matrices can be performed. This is necessary because we
2361 use pointers to glyphs in glyph row structures. To satisfy the
2362 assumption of point 1 above that glyphs are updated implicitly in
2363 window matrices when they are manipulated via the frame matrix,
2364 window and frame matrix must of course agree where to find the
2365 glyphs for their rows. Possible manipulations that must be
2366 mirrored are assignments of rows of the desired frame matrix to the
2367 current frame matrix and scrolling the current frame matrix. */
2369 /* Build frame F's desired matrix from window matrices. Only windows
2370 which have the flag must_be_updated_p set have to be updated. Menu
2371 bar lines of a frame are not covered by window matrices, so make
2372 sure not to touch them in this function. */
2375 build_frame_matrix (f
)
2380 /* F must have a frame matrix when this function is called. */
2381 xassert (!FRAME_WINDOW_P (f
));
2383 /* Clear all rows in the frame matrix covered by window matrices.
2384 Menu bar lines are not covered by windows. */
2385 for (i
= FRAME_TOP_MARGIN (f
); i
< f
->desired_matrix
->nrows
; ++i
)
2386 clear_glyph_row (MATRIX_ROW (f
->desired_matrix
, i
));
2388 /* Build the matrix by walking the window tree. */
2389 build_frame_matrix_from_window_tree (f
->desired_matrix
,
2390 XWINDOW (FRAME_ROOT_WINDOW (f
)));
2394 /* Walk a window tree, building a frame matrix MATRIX from window
2395 matrices. W is the root of a window tree. */
2398 build_frame_matrix_from_window_tree (matrix
, w
)
2399 struct glyph_matrix
*matrix
;
2404 if (!NILP (w
->hchild
))
2405 build_frame_matrix_from_window_tree (matrix
, XWINDOW (w
->hchild
));
2406 else if (!NILP (w
->vchild
))
2407 build_frame_matrix_from_window_tree (matrix
, XWINDOW (w
->vchild
));
2409 build_frame_matrix_from_leaf_window (matrix
, w
);
2411 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
2416 /* Add a window's matrix to a frame matrix. FRAME_MATRIX is the
2417 desired frame matrix built. W is a leaf window whose desired or
2418 current matrix is to be added to FRAME_MATRIX. W's flag
2419 must_be_updated_p determines which matrix it contributes to
2420 FRAME_MATRIX. If must_be_updated_p is non-zero, W's desired matrix
2421 is added to FRAME_MATRIX, otherwise W's current matrix is added.
2422 Adding a desired matrix means setting up used counters and such in
2423 frame rows, while adding a current window matrix to FRAME_MATRIX
2424 means copying glyphs. The latter case corresponds to
2425 preserve_other_columns in the old redisplay. */
2428 build_frame_matrix_from_leaf_window (frame_matrix
, w
)
2429 struct glyph_matrix
*frame_matrix
;
2432 struct glyph_matrix
*window_matrix
;
2433 int window_y
, frame_y
;
2434 /* If non-zero, a glyph to insert at the right border of W. */
2435 GLYPH right_border_glyph
= 0;
2437 /* Set window_matrix to the matrix we have to add to FRAME_MATRIX. */
2438 if (w
->must_be_updated_p
)
2440 window_matrix
= w
->desired_matrix
;
2442 /* Decide whether we want to add a vertical border glyph. */
2443 if (!WINDOW_RIGHTMOST_P (w
))
2445 struct Lisp_Char_Table
*dp
= window_display_table (w
);
2446 right_border_glyph
= (dp
&& INTEGERP (DISP_BORDER_GLYPH (dp
))
2447 ? XINT (DISP_BORDER_GLYPH (dp
))
2452 window_matrix
= w
->current_matrix
;
2454 /* For all rows in the window matrix and corresponding rows in the
2457 frame_y
= window_matrix
->matrix_y
;
2458 while (window_y
< window_matrix
->nrows
)
2460 struct glyph_row
*frame_row
= frame_matrix
->rows
+ frame_y
;
2461 struct glyph_row
*window_row
= window_matrix
->rows
+ window_y
;
2462 int current_row_p
= window_matrix
== w
->current_matrix
;
2464 /* Fill up the frame row with spaces up to the left margin of the
2466 fill_up_frame_row_with_spaces (frame_row
, window_matrix
->matrix_x
);
2468 /* Fill up areas in the window matrix row with spaces. */
2469 fill_up_glyph_row_with_spaces (window_row
);
2471 /* If only part of W's desired matrix has been built, and
2472 window_row wasn't displayed, use the corresponding current
2474 if (window_matrix
== w
->desired_matrix
2475 && !window_row
->enabled_p
)
2477 window_row
= w
->current_matrix
->rows
+ window_y
;
2483 /* Copy window row to frame row. */
2484 bcopy (window_row
->glyphs
[0],
2485 frame_row
->glyphs
[TEXT_AREA
] + window_matrix
->matrix_x
,
2486 window_matrix
->matrix_w
* sizeof (struct glyph
));
2490 xassert (window_row
->enabled_p
);
2492 /* Only when a desired row has been displayed, we want
2493 the corresponding frame row to be updated. */
2494 frame_row
->enabled_p
= 1;
2496 /* Maybe insert a vertical border between horizontally adjacent
2498 if (right_border_glyph
)
2500 struct glyph
*border
= window_row
->glyphs
[LAST_AREA
] - 1;
2501 SET_CHAR_GLYPH_FROM_GLYPH (*border
, right_border_glyph
);
2504 #if 0 /* This shouldn't be necessary. Let's check it. */
2505 /* Due to hooks installed, it normally doesn't happen that
2506 window rows and frame rows of the same matrix are out of
2507 sync, i.e. have a different understanding of where to
2508 find glyphs for the row. The following is a safety-belt
2509 that doesn't cost much and makes absolutely sure that
2510 window and frame matrices are in sync. */
2511 if (!glyph_row_slice_p (window_row
, frame_row
))
2513 /* Find the row in the window being a slice. There
2514 should exist one from program logic. */
2515 struct glyph_row
*slice_row
2516 = find_glyph_row_slice (window_matrix
, frame_matrix
, frame_y
);
2517 xassert (slice_row
!= 0);
2519 /* Exchange glyphs between both window rows. */
2520 swap_glyphs_in_rows (window_row
, slice_row
);
2522 /* Exchange pointers between both rows. */
2523 swap_glyph_pointers (window_row
, slice_row
);
2527 /* Window row window_y must be a slice of frame row
2529 xassert (glyph_row_slice_p (window_row
, frame_row
));
2531 /* If rows are in sync, we don't have to copy glyphs because
2532 frame and window share glyphs. */
2535 strcpy (w
->current_matrix
->method
, w
->desired_matrix
->method
);
2539 /* Set number of used glyphs in the frame matrix. Since we fill
2540 up with spaces, and visit leaf windows from left to right it
2541 can be done simply. */
2542 frame_row
->used
[TEXT_AREA
]
2543 = window_matrix
->matrix_x
+ window_matrix
->matrix_w
;
2545 /* Or in other flags. */
2546 frame_row
->inverse_p
|= window_row
->inverse_p
;
2555 /* Add spaces to a glyph row ROW in a window matrix.
2557 Each row has the form:
2559 +---------+-----------------------------+------------+
2560 | left | text | right |
2561 +---------+-----------------------------+------------+
2563 Left and right marginal areas are optional. This function adds
2564 spaces to areas so that there are no empty holes between areas.
2565 In other words: If the right area is not empty, the text area
2566 is filled up with spaces up to the right area. If the text area
2567 is not empty, the left area is filled up.
2569 To be called for frame-based redisplay, only. */
2572 fill_up_glyph_row_with_spaces (row
)
2573 struct glyph_row
*row
;
2575 fill_up_glyph_row_area_with_spaces (row
, LEFT_MARGIN_AREA
);
2576 fill_up_glyph_row_area_with_spaces (row
, TEXT_AREA
);
2577 fill_up_glyph_row_area_with_spaces (row
, RIGHT_MARGIN_AREA
);
2581 /* Fill area AREA of glyph row ROW with spaces. To be called for
2582 frame-based redisplay only. */
2585 fill_up_glyph_row_area_with_spaces (row
, area
)
2586 struct glyph_row
*row
;
2589 if (row
->glyphs
[area
] < row
->glyphs
[area
+ 1])
2591 struct glyph
*end
= row
->glyphs
[area
+ 1];
2592 struct glyph
*text
= row
->glyphs
[area
] + row
->used
[area
];
2595 *text
++ = space_glyph
;
2596 row
->used
[area
] = text
- row
->glyphs
[area
];
2601 /* Add spaces to the end of ROW in a frame matrix until index UPTO is
2602 reached. In frame matrices only one area, TEXT_AREA, is used. */
2605 fill_up_frame_row_with_spaces (row
, upto
)
2606 struct glyph_row
*row
;
2609 int i
= row
->used
[TEXT_AREA
];
2610 struct glyph
*glyph
= row
->glyphs
[TEXT_AREA
];
2613 glyph
[i
++] = space_glyph
;
2615 row
->used
[TEXT_AREA
] = i
;
2620 /**********************************************************************
2621 Mirroring operations on frame matrices in window matrices
2622 **********************************************************************/
2624 /* Set frame being updated via frame-based redisplay to F. This
2625 function must be called before updates to make explicit that we are
2626 working on frame matrices or not. */
2629 set_frame_matrix_frame (f
)
2632 frame_matrix_frame
= f
;
2636 /* Make sure glyph row ROW in CURRENT_MATRIX is up to date.
2637 DESIRED_MATRIX is the desired matrix corresponding to
2638 CURRENT_MATRIX. The update is done by exchanging glyph pointers
2639 between rows in CURRENT_MATRIX and DESIRED_MATRIX. If
2640 frame_matrix_frame is non-null, this indicates that the exchange is
2641 done in frame matrices, and that we have to perform analogous
2642 operations in window matrices of frame_matrix_frame. */
2645 make_current (desired_matrix
, current_matrix
, row
)
2646 struct glyph_matrix
*desired_matrix
, *current_matrix
;
2649 struct glyph_row
*current_row
= MATRIX_ROW (current_matrix
, row
);
2650 struct glyph_row
*desired_row
= MATRIX_ROW (desired_matrix
, row
);
2651 int mouse_face_p
= current_row
->mouse_face_p
;
2653 /* Do current_row = desired_row. This exchanges glyph pointers
2654 between both rows, and does a structure assignment otherwise. */
2655 assign_row (current_row
, desired_row
);
2657 /* Enable current_row to mark it as valid. */
2658 current_row
->enabled_p
= 1;
2659 current_row
->mouse_face_p
= mouse_face_p
;
2661 /* If we are called on frame matrices, perform analogous operations
2662 for window matrices. */
2663 if (frame_matrix_frame
)
2664 mirror_make_current (XWINDOW (frame_matrix_frame
->root_window
), row
);
2668 /* W is the root of a window tree. FRAME_ROW is the index of a row in
2669 W's frame which has been made current (by swapping pointers between
2670 current and desired matrix). Perform analogous operations in the
2671 matrices of leaf windows in the window tree rooted at W. */
2674 mirror_make_current (w
, frame_row
)
2680 if (!NILP (w
->hchild
))
2681 mirror_make_current (XWINDOW (w
->hchild
), frame_row
);
2682 else if (!NILP (w
->vchild
))
2683 mirror_make_current (XWINDOW (w
->vchild
), frame_row
);
2686 /* Row relative to window W. Don't use FRAME_TO_WINDOW_VPOS
2687 here because the checks performed in debug mode there
2688 will not allow the conversion. */
2689 int row
= frame_row
- w
->desired_matrix
->matrix_y
;
2691 /* If FRAME_ROW is within W, assign the desired row to the
2692 current row (exchanging glyph pointers). */
2693 if (row
>= 0 && row
< w
->desired_matrix
->matrix_h
)
2695 struct glyph_row
*current_row
2696 = MATRIX_ROW (w
->current_matrix
, row
);
2697 struct glyph_row
*desired_row
2698 = MATRIX_ROW (w
->desired_matrix
, row
);
2700 if (desired_row
->enabled_p
)
2701 assign_row (current_row
, desired_row
);
2703 swap_glyph_pointers (desired_row
, current_row
);
2704 current_row
->enabled_p
= 1;
2708 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
2713 /* Perform row dance after scrolling. We are working on the range of
2714 lines UNCHANGED_AT_TOP + 1 to UNCHANGED_AT_TOP + NLINES (not
2715 including) in MATRIX. COPY_FROM is a vector containing, for each
2716 row I in the range 0 <= I < NLINES, the index of the original line
2717 to move to I. This index is relative to the row range, i.e. 0 <=
2718 index < NLINES. RETAINED_P is a vector containing zero for each
2719 row 0 <= I < NLINES which is empty.
2721 This function is called from do_scrolling and do_direct_scrolling. */
2724 mirrored_line_dance (matrix
, unchanged_at_top
, nlines
, copy_from
,
2726 struct glyph_matrix
*matrix
;
2727 int unchanged_at_top
, nlines
;
2731 /* A copy of original rows. */
2732 struct glyph_row
*old_rows
;
2734 /* Rows to assign to. */
2735 struct glyph_row
*new_rows
= MATRIX_ROW (matrix
, unchanged_at_top
);
2739 /* Make a copy of the original rows. */
2740 old_rows
= (struct glyph_row
*) alloca (nlines
* sizeof *old_rows
);
2741 bcopy (new_rows
, old_rows
, nlines
* sizeof *old_rows
);
2743 /* Assign new rows, maybe clear lines. */
2744 for (i
= 0; i
< nlines
; ++i
)
2746 int enabled_before_p
= new_rows
[i
].enabled_p
;
2748 xassert (i
+ unchanged_at_top
< matrix
->nrows
);
2749 xassert (unchanged_at_top
+ copy_from
[i
] < matrix
->nrows
);
2750 new_rows
[i
] = old_rows
[copy_from
[i
]];
2751 new_rows
[i
].enabled_p
= enabled_before_p
;
2753 /* RETAINED_P is zero for empty lines. */
2754 if (!retained_p
[copy_from
[i
]])
2755 new_rows
[i
].enabled_p
= 0;
2758 /* Do the same for window matrices, if MATRIX Is a frame matrix. */
2759 if (frame_matrix_frame
)
2760 mirror_line_dance (XWINDOW (frame_matrix_frame
->root_window
),
2761 unchanged_at_top
, nlines
, copy_from
, retained_p
);
2765 /* Synchronize glyph pointers in the current matrix of window W with
2766 the current frame matrix. W must be full-width, and be on a tty
2770 sync_window_with_frame_matrix_rows (w
)
2773 struct frame
*f
= XFRAME (w
->frame
);
2774 struct glyph_row
*window_row
, *window_row_end
, *frame_row
;
2776 /* Preconditions: W must be a leaf window and full-width. Its frame
2777 must have a frame matrix. */
2778 xassert (NILP (w
->hchild
) && NILP (w
->vchild
));
2779 xassert (WINDOW_FULL_WIDTH_P (w
));
2780 xassert (!FRAME_WINDOW_P (f
));
2782 /* If W is a full-width window, glyph pointers in W's current matrix
2783 have, by definition, to be the same as glyph pointers in the
2784 corresponding frame matrix. */
2785 window_row
= w
->current_matrix
->rows
;
2786 window_row_end
= window_row
+ w
->current_matrix
->nrows
;
2787 frame_row
= f
->current_matrix
->rows
+ XFASTINT (w
->top
);
2788 while (window_row
< window_row_end
)
2792 for (area
= LEFT_MARGIN_AREA
; area
<= LAST_AREA
; ++area
)
2793 window_row
->glyphs
[area
] = frame_row
->glyphs
[area
];
2795 ++window_row
, ++frame_row
;
2800 /* Return the window in the window tree rooted in W containing frame
2801 row ROW. Value is null if none is found. */
2804 frame_row_to_window (w
, row
)
2808 struct window
*found
= NULL
;
2812 if (!NILP (w
->hchild
))
2813 found
= frame_row_to_window (XWINDOW (w
->hchild
), row
);
2814 else if (!NILP (w
->vchild
))
2815 found
= frame_row_to_window (XWINDOW (w
->vchild
), row
);
2816 else if (row
>= XFASTINT (w
->top
)
2817 && row
< XFASTINT (w
->top
) + XFASTINT (w
->height
))
2820 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
2827 /* Perform a line dance in the window tree rooted at W, after
2828 scrolling a frame matrix in mirrored_line_dance.
2830 We are working on the range of lines UNCHANGED_AT_TOP + 1 to
2831 UNCHANGED_AT_TOP + NLINES (not including) in W's frame matrix.
2832 COPY_FROM is a vector containing, for each row I in the range 0 <=
2833 I < NLINES, the index of the original line to move to I. This
2834 index is relative to the row range, i.e. 0 <= index < NLINES.
2835 RETAINED_P is a vector containing zero for each row 0 <= I < NLINES
2839 mirror_line_dance (w
, unchanged_at_top
, nlines
, copy_from
, retained_p
)
2841 int unchanged_at_top
, nlines
;
2847 if (!NILP (w
->hchild
))
2848 mirror_line_dance (XWINDOW (w
->hchild
), unchanged_at_top
,
2849 nlines
, copy_from
, retained_p
);
2850 else if (!NILP (w
->vchild
))
2851 mirror_line_dance (XWINDOW (w
->vchild
), unchanged_at_top
,
2852 nlines
, copy_from
, retained_p
);
2855 /* W is a leaf window, and we are working on its current
2857 struct glyph_matrix
*m
= w
->current_matrix
;
2859 struct glyph_row
*old_rows
;
2861 /* Make a copy of the original rows of matrix m. */
2862 old_rows
= (struct glyph_row
*) alloca (m
->nrows
* sizeof *old_rows
);
2863 bcopy (m
->rows
, old_rows
, m
->nrows
* sizeof *old_rows
);
2865 for (i
= 0; i
< nlines
; ++i
)
2867 /* Frame relative line assigned to. */
2868 int frame_to
= i
+ unchanged_at_top
;
2870 /* Frame relative line assigned. */
2871 int frame_from
= copy_from
[i
] + unchanged_at_top
;
2873 /* Window relative line assigned to. */
2874 int window_to
= frame_to
- m
->matrix_y
;
2876 /* Window relative line assigned. */
2877 int window_from
= frame_from
- m
->matrix_y
;
2879 /* Is assigned line inside window? */
2880 int from_inside_window_p
2881 = window_from
>= 0 && window_from
< m
->matrix_h
;
2883 /* Is assigned to line inside window? */
2884 int to_inside_window_p
2885 = window_to
>= 0 && window_to
< m
->matrix_h
;
2887 if (from_inside_window_p
&& to_inside_window_p
)
2889 /* Enabled setting before assignment. */
2890 int enabled_before_p
;
2892 /* Do the assignment. The enabled_p flag is saved
2893 over the assignment because the old redisplay did
2895 enabled_before_p
= m
->rows
[window_to
].enabled_p
;
2896 m
->rows
[window_to
] = old_rows
[window_from
];
2897 m
->rows
[window_to
].enabled_p
= enabled_before_p
;
2899 /* If frame line is empty, window line is empty, too. */
2900 if (!retained_p
[copy_from
[i
]])
2901 m
->rows
[window_to
].enabled_p
= 0;
2903 else if (to_inside_window_p
)
2905 /* A copy between windows. This is an infrequent
2906 case not worth optimizing. */
2907 struct frame
*f
= XFRAME (w
->frame
);
2908 struct window
*root
= XWINDOW (FRAME_ROOT_WINDOW (f
));
2910 struct glyph_matrix
*m2
;
2913 w2
= frame_row_to_window (root
, frame_to
);
2914 m2
= w2
->current_matrix
;
2915 m2_from
= frame_from
- m2
->matrix_y
;
2916 copy_row_except_pointers (m
->rows
+ window_to
,
2917 m2
->rows
+ m2_from
);
2919 /* If frame line is empty, window line is empty, too. */
2920 if (!retained_p
[copy_from
[i
]])
2921 m
->rows
[window_to
].enabled_p
= 0;
2924 else if (from_inside_window_p
)
2928 /* If there was a copy between windows, make sure glyph
2929 pointers are in sync with the frame matrix. */
2931 sync_window_with_frame_matrix_rows (w
);
2933 /* Check that no pointers are lost. */
2937 /* Next window on same level. */
2938 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
2945 /* Check that window and frame matrices agree about their
2946 understanding where glyphs of the rows are to find. For each
2947 window in the window tree rooted at W, check that rows in the
2948 matrices of leaf window agree with their frame matrices about
2952 check_window_matrix_pointers (w
)
2957 if (!NILP (w
->hchild
))
2958 check_window_matrix_pointers (XWINDOW (w
->hchild
));
2959 else if (!NILP (w
->vchild
))
2960 check_window_matrix_pointers (XWINDOW (w
->vchild
));
2963 struct frame
*f
= XFRAME (w
->frame
);
2964 check_matrix_pointers (w
->desired_matrix
, f
->desired_matrix
);
2965 check_matrix_pointers (w
->current_matrix
, f
->current_matrix
);
2968 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
2973 /* Check that window rows are slices of frame rows. WINDOW_MATRIX is
2974 a window and FRAME_MATRIX is the corresponding frame matrix. For
2975 each row in WINDOW_MATRIX check that it's a slice of the
2976 corresponding frame row. If it isn't, abort. */
2979 check_matrix_pointers (window_matrix
, frame_matrix
)
2980 struct glyph_matrix
*window_matrix
, *frame_matrix
;
2982 /* Row number in WINDOW_MATRIX. */
2985 /* Row number corresponding to I in FRAME_MATRIX. */
2986 int j
= window_matrix
->matrix_y
;
2988 /* For all rows check that the row in the window matrix is a
2989 slice of the row in the frame matrix. If it isn't we didn't
2990 mirror an operation on the frame matrix correctly. */
2991 while (i
< window_matrix
->nrows
)
2993 if (!glyph_row_slice_p (window_matrix
->rows
+ i
,
2994 frame_matrix
->rows
+ j
))
3000 #endif /* GLYPH_DEBUG != 0 */
3004 /**********************************************************************
3005 VPOS and HPOS translations
3006 **********************************************************************/
3010 /* Translate vertical position VPOS which is relative to window W to a
3011 vertical position relative to W's frame. */
3014 window_to_frame_vpos (w
, vpos
)
3018 struct frame
*f
= XFRAME (w
->frame
);
3020 xassert (!FRAME_WINDOW_P (f
));
3021 xassert (vpos
>= 0 && vpos
<= w
->desired_matrix
->nrows
);
3022 vpos
+= XFASTINT (w
->top
);
3023 xassert (vpos
>= 0 && vpos
<= FRAME_HEIGHT (f
));
3028 /* Translate horizontal position HPOS which is relative to window W to
3029 a vertical position relative to W's frame. */
3032 window_to_frame_hpos (w
, hpos
)
3036 struct frame
*f
= XFRAME (w
->frame
);
3038 xassert (!FRAME_WINDOW_P (f
));
3039 hpos
+= XFASTINT (w
->left
);
3043 #endif /* GLYPH_DEBUG */
3047 /**********************************************************************
3049 **********************************************************************/
3051 DEFUN ("redraw-frame", Fredraw_frame
, Sredraw_frame
, 1, 1, 0,
3052 "Clear frame FRAME and output again what is supposed to appear on it.")
3058 CHECK_LIVE_FRAME (frame
, 0);
3061 /* Ignore redraw requests, if frame has no glyphs yet.
3062 (Implementation note: It still has to be checked why we are
3063 called so early here). */
3064 if (!glyphs_initialized_initially_p
)
3068 if (FRAME_MSDOS_P (f
))
3069 set_terminal_modes ();
3071 clear_current_matrices (f
);
3074 windows_or_buffers_changed
++;
3075 /* Mark all windows as inaccurate, so that every window will have
3076 its redisplay done. */
3077 mark_window_display_accurate (FRAME_ROOT_WINDOW (f
), 0);
3078 set_window_update_flags (XWINDOW (FRAME_ROOT_WINDOW (f
)), 1);
3084 /* Redraw frame F. This is nothing more than a call to the Lisp
3085 function redraw-frame. */
3092 XSETFRAME (frame
, f
);
3093 Fredraw_frame (frame
);
3097 DEFUN ("redraw-display", Fredraw_display
, Sredraw_display
, 0, 0, "",
3098 "Clear and redisplay all visible frames.")
3101 Lisp_Object tail
, frame
;
3103 FOR_EACH_FRAME (tail
, frame
)
3104 if (FRAME_VISIBLE_P (XFRAME (frame
)))
3105 Fredraw_frame (frame
);
3111 /* This is used when frame_garbaged is set. Call Fredraw_frame on all
3112 visible frames marked as garbaged. */
3115 redraw_garbaged_frames ()
3117 Lisp_Object tail
, frame
;
3119 FOR_EACH_FRAME (tail
, frame
)
3120 if (FRAME_VISIBLE_P (XFRAME (frame
))
3121 && FRAME_GARBAGED_P (XFRAME (frame
)))
3122 Fredraw_frame (frame
);
3127 /***********************************************************************
3129 ***********************************************************************/
3131 /* Try to update display and current glyph matrix directly.
3133 This function is called after a character G has been inserted into
3134 current_buffer. It tries to update the current glyph matrix and
3135 perform appropriate screen output to reflect the insertion. If it
3136 succeeds, the global flag redisplay_performed_directly_p will be
3137 set to 1, and thereby prevent the more costly general redisplay
3138 from running (see redisplay_internal).
3140 This function is not called for `hairy' character insertions.
3141 In particular, it is not called when after or before change
3142 functions exist, like they are used by font-lock. See keyboard.c
3143 for details where this function is called. */
3146 direct_output_for_insert (g
)
3149 register struct frame
*f
= SELECTED_FRAME ();
3150 struct window
*w
= XWINDOW (selected_window
);
3152 struct glyph_row
*glyph_row
;
3153 struct glyph
*glyphs
, *glyph
, *end
;
3155 /* Non-null means that Redisplay of W is based on window matrices. */
3156 int window_redisplay_p
= FRAME_WINDOW_P (f
);
3157 /* Non-null means we are in overwrite mode. */
3158 int overwrite_p
= !NILP (current_buffer
->overwrite_mode
);
3160 struct text_pos pos
;
3161 int delta
, delta_bytes
;
3163 /* Not done directly. */
3164 redisplay_performed_directly_p
= 0;
3166 /* Quickly give up for some common cases. */
3167 if (cursor_in_echo_area
3168 /* Give up if fonts have changed. */
3170 /* Give up if face attributes have been changed. */
3171 || face_change_count
3172 /* Give up if cursor position not really known. */
3173 || !display_completed
3174 /* Give up if buffer appears in two places. */
3175 || buffer_shared
> 1
3176 /* Give up if w is mini-buffer and a message is being displayed there */
3177 || (MINI_WINDOW_P (w
) && !NILP (echo_area_buffer
[0]))
3178 /* Give up for hscrolled mini-buffer because display of the prompt
3179 is handled specially there (see display_line). */
3180 || (MINI_WINDOW_P (w
) && XFASTINT (w
->hscroll
))
3181 /* Give up if overwriting in the middle of a line. */
3184 && FETCH_BYTE (PT
) != '\n')
3185 /* Give up for tabs and line ends. */
3189 /* Give up if unable to display the cursor in the window. */
3190 || w
->cursor
.vpos
< 0
3191 || (glyph_row
= MATRIX_ROW (w
->current_matrix
, w
->cursor
.vpos
),
3192 /* Can't do it in a continued line because continuation
3193 lines would change. */
3194 (glyph_row
->continued_p
3195 /* Can't use this method if the line overlaps others or is
3196 overlapped by others because these other lines would
3197 have to be redisplayed. */
3198 || glyph_row
->overlapping_p
3199 || glyph_row
->overlapped_p
))
3200 /* Can't do it for partial width windows on terminal frames
3201 because we can't clear to eol in such a window. */
3202 || (!window_redisplay_p
&& !WINDOW_FULL_WIDTH_P (w
)))
3205 /* Set up a display iterator structure for W. Glyphs will be
3206 produced in scratch_glyph_row. Current position is W's cursor
3208 clear_glyph_row (&scratch_glyph_row
);
3209 SET_TEXT_POS (pos
, PT
, PT_BYTE
);
3210 DEC_TEXT_POS (pos
, !NILP (current_buffer
->enable_multibyte_characters
));
3211 init_iterator (&it
, w
, CHARPOS (pos
), BYTEPOS (pos
), &scratch_glyph_row
,
3214 glyph_row
= MATRIX_ROW (w
->current_matrix
, w
->cursor
.vpos
);
3215 if (glyph_row
->mouse_face_p
)
3218 /* Give up if highlighting trailing whitespace and we have trailing
3219 whitespace in glyph_row. We would have to remove the trailing
3220 whitespace face in that case. */
3221 if (!NILP (Vshow_trailing_whitespace
)
3222 && glyph_row
->used
[TEXT_AREA
])
3226 last
= glyph_row
->glyphs
[TEXT_AREA
] + glyph_row
->used
[TEXT_AREA
] - 1;
3227 if (last
->type
== STRETCH_GLYPH
3228 || (last
->type
== CHAR_GLYPH
3229 && last
->u
.ch
== ' '))
3233 /* Give up if there are overlay strings at pos. This would fail
3234 if the overlay string has newlines in it. */
3235 if (STRINGP (it
.string
))
3238 it
.hpos
= w
->cursor
.hpos
;
3239 it
.vpos
= w
->cursor
.vpos
;
3240 it
.current_x
= w
->cursor
.x
+ it
.first_visible_x
;
3241 it
.current_y
= w
->cursor
.y
;
3242 it
.end_charpos
= PT
;
3243 it
.stop_charpos
= min (PT
, it
.stop_charpos
);
3245 /* More than one display element may be returned for PT - 1 if
3246 (i) it's a control character which is translated into `\003' or
3247 `^C', or (ii) it has a display table entry, or (iii) it's a
3248 combination of both. */
3249 delta
= delta_bytes
= 0;
3250 while (get_next_display_element (&it
))
3252 PRODUCE_GLYPHS (&it
);
3254 /* Give up if glyph doesn't fit completely on the line. */
3255 if (it
.current_x
>= it
.last_visible_x
)
3258 /* Give up if new glyph has different ascent or descent than
3259 the original row, or if it is not a character glyph. */
3260 if (glyph_row
->ascent
!= it
.ascent
3261 || glyph_row
->height
!= it
.ascent
+ it
.descent
3262 || glyph_row
->phys_ascent
!= it
.phys_ascent
3263 || glyph_row
->phys_height
!= it
.phys_ascent
+ it
.phys_descent
3264 || it
.what
!= IT_CHARACTER
)
3268 delta_bytes
+= it
.len
;
3269 set_iterator_to_next (&it
, 1);
3272 /* Give up if we hit the right edge of the window. We would have
3273 to insert truncation or continuation glyphs. */
3274 added_width
= it
.current_x
- (w
->cursor
.x
+ it
.first_visible_x
);
3275 if (glyph_row
->pixel_width
+ added_width
>= it
.last_visible_x
)
3278 /* Give up if there is a \t following in the line. */
3280 it2
.end_charpos
= ZV
;
3281 it2
.stop_charpos
= min (it2
.stop_charpos
, ZV
);
3282 while (get_next_display_element (&it2
)
3283 && !ITERATOR_AT_END_OF_LINE_P (&it2
))
3287 set_iterator_to_next (&it2
, 1);
3290 /* Number of new glyphs produced. */
3291 n
= it
.glyph_row
->used
[TEXT_AREA
];
3293 /* Start and end of glyphs in original row. */
3294 glyphs
= glyph_row
->glyphs
[TEXT_AREA
] + w
->cursor
.hpos
;
3295 end
= glyph_row
->glyphs
[1 + TEXT_AREA
];
3297 /* Make room for new glyphs, then insert them. */
3298 xassert (end
- glyphs
- n
>= 0);
3299 safe_bcopy ((char *) glyphs
, (char *) (glyphs
+ n
),
3300 (end
- glyphs
- n
) * sizeof (*end
));
3301 bcopy (it
.glyph_row
->glyphs
[TEXT_AREA
], glyphs
, n
* sizeof *glyphs
);
3302 glyph_row
->used
[TEXT_AREA
] = min (glyph_row
->used
[TEXT_AREA
] + n
,
3303 end
- glyph_row
->glyphs
[TEXT_AREA
]);
3305 /* Compute new line width. */
3306 glyph
= glyph_row
->glyphs
[TEXT_AREA
];
3307 end
= glyph
+ glyph_row
->used
[TEXT_AREA
];
3308 glyph_row
->pixel_width
= glyph_row
->x
;
3311 glyph_row
->pixel_width
+= glyph
->pixel_width
;
3315 /* Increment buffer positions for glyphs following the newly
3317 for (glyph
= glyphs
+ n
; glyph
< end
; ++glyph
)
3318 if (glyph
->charpos
> 0 && BUFFERP (glyph
->object
))
3319 glyph
->charpos
+= delta
;
3321 if (MATRIX_ROW_END_CHARPOS (glyph_row
) > 0)
3323 MATRIX_ROW_END_CHARPOS (glyph_row
) += delta
;
3324 MATRIX_ROW_END_BYTEPOS (glyph_row
) += delta_bytes
;
3327 /* Adjust positions in lines following the one we are in. */
3328 increment_matrix_positions (w
->current_matrix
,
3330 w
->current_matrix
->nrows
,
3331 delta
, delta_bytes
);
3333 glyph_row
->contains_overlapping_glyphs_p
3334 |= it
.glyph_row
->contains_overlapping_glyphs_p
;
3336 glyph_row
->displays_text_p
= 1;
3337 w
->window_end_vpos
= make_number (max (w
->cursor
.vpos
,
3338 XFASTINT (w
->window_end_vpos
)));
3340 if (!NILP (Vshow_trailing_whitespace
))
3341 highlight_trailing_whitespace (it
.f
, glyph_row
);
3343 /* Write glyphs. If at end of row, we can simply call write_glyphs.
3344 In the middle, we have to insert glyphs. Note that this is now
3345 implemented for X frames. The implementation uses updated_window
3347 updated_row
= glyph_row
;
3351 rif
->update_window_begin_hook (w
);
3353 if (glyphs
== end
- n
)
3354 rif
->write_glyphs (glyphs
, n
);
3356 rif
->insert_glyphs (glyphs
, n
);
3360 if (glyphs
== end
- n
)
3361 write_glyphs (glyphs
, n
);
3363 insert_glyphs (glyphs
, n
);
3366 w
->cursor
.hpos
+= n
;
3367 w
->cursor
.x
= it
.current_x
- it
.first_visible_x
;
3368 xassert (w
->cursor
.hpos
>= 0
3369 && w
->cursor
.hpos
< w
->desired_matrix
->matrix_w
);
3371 /* How to set the cursor differs depending on whether we are
3372 using a frame matrix or a window matrix. Note that when
3373 a frame matrix is used, cursor_to expects frame coordinates,
3374 and the X and Y parameters are not used. */
3375 if (window_redisplay_p
)
3376 rif
->cursor_to (w
->cursor
.vpos
, w
->cursor
.hpos
,
3377 w
->cursor
.y
, w
->cursor
.x
);
3381 x
= (WINDOW_TO_FRAME_HPOS (w
, w
->cursor
.hpos
)
3382 + (INTEGERP (w
->left_margin_width
)
3383 ? XFASTINT (w
->left_margin_width
)
3385 y
= WINDOW_TO_FRAME_VPOS (w
, w
->cursor
.vpos
);
3390 rif
->update_window_end_hook (w
, 1, 0);
3395 TRACE ((stderr
, "direct output for insert\n"));
3397 UNCHANGED_MODIFIED
= MODIFF
;
3398 BEG_UNCHANGED
= GPT
- BEG
;
3399 XSETFASTINT (w
->last_point
, PT
);
3400 w
->last_cursor
= w
->cursor
;
3401 XSETFASTINT (w
->last_modified
, MODIFF
);
3402 XSETFASTINT (w
->last_overlay_modified
, OVERLAY_MODIFF
);
3404 redisplay_performed_directly_p
= 1;
3409 /* Perform a direct display update for moving PT by N positions
3410 left or right. N < 0 means a movement backwards. This function
3411 is currently only called for N == 1 or N == -1. */
3414 direct_output_forward_char (n
)
3417 struct frame
*f
= SELECTED_FRAME ();
3418 struct window
*w
= XWINDOW (selected_window
);
3419 struct glyph_row
*row
;
3421 /* Give up if point moved out of or into a composition. */
3422 if (check_point_in_composition (current_buffer
, XINT (w
->last_point
),
3423 current_buffer
, PT
))
3426 /* Give up if face attributes have been changed. */
3427 if (face_change_count
)
3430 /* Give up if current matrix is not up to date or we are
3431 displaying a message. */
3432 if (!display_completed
|| cursor_in_echo_area
)
3435 /* Give up if the buffer's direction is reversed. */
3436 if (!NILP (XBUFFER (w
->buffer
)->direction_reversed
))
3439 /* Can't use direct output if highlighting a region. */
3440 if (!NILP (Vtransient_mark_mode
) && !NILP (current_buffer
->mark_active
))
3443 /* Can't use direct output if highlighting trailing whitespace. */
3444 if (!NILP (Vshow_trailing_whitespace
))
3447 /* Give up if we are showing a message or just cleared the message
3448 because we might need to resize the echo area window. */
3449 if (!NILP (echo_area_buffer
[0]) || !NILP (echo_area_buffer
[1]))
3452 /* Give up if currently displaying a message instead of the
3453 minibuffer contents. */
3454 if (XWINDOW (minibuf_window
) == w
3455 && EQ (minibuf_window
, echo_area_window
))
3458 /* Give up if we don't know where the cursor is. */
3459 if (w
->cursor
.vpos
< 0)
3462 row
= MATRIX_ROW (w
->current_matrix
, w
->cursor
.vpos
);
3464 /* Give up if PT is outside of the last known cursor row. */
3465 if (PT
<= MATRIX_ROW_START_BYTEPOS (row
)
3466 || PT
>= MATRIX_ROW_END_BYTEPOS (row
))
3469 set_cursor_from_row (w
, row
, w
->current_matrix
, 0, 0, 0, 0);
3471 w
->last_cursor
= w
->cursor
;
3472 XSETFASTINT (w
->last_point
, PT
);
3474 xassert (w
->cursor
.hpos
>= 0
3475 && w
->cursor
.hpos
< w
->desired_matrix
->matrix_w
);
3477 if (FRAME_WINDOW_P (f
))
3478 rif
->cursor_to (w
->cursor
.vpos
, w
->cursor
.hpos
,
3479 w
->cursor
.y
, w
->cursor
.x
);
3483 x
= (WINDOW_TO_FRAME_HPOS (w
, w
->cursor
.hpos
)
3484 + (INTEGERP (w
->left_margin_width
)
3485 ? XFASTINT (w
->left_margin_width
)
3487 y
= WINDOW_TO_FRAME_VPOS (w
, w
->cursor
.vpos
);
3492 redisplay_performed_directly_p
= 1;
3498 /***********************************************************************
3500 ***********************************************************************/
3502 /* Update frame F based on the data in desired matrices.
3504 If FORCE_P is non-zero, don't let redisplay be stopped by detecting
3505 pending input. If INHIBIT_HAIRY_ID_P is non-zero, don't try
3508 Value is non-zero if redisplay was stopped due to pending input. */
3511 update_frame (f
, force_p
, inhibit_hairy_id_p
)
3514 int inhibit_hairy_id_p
;
3516 /* 1 means display has been paused because of pending input. */
3518 struct window
*root_window
= XWINDOW (f
->root_window
);
3520 if (FRAME_WINDOW_P (f
))
3522 /* We are working on window matrix basis. All windows whose
3523 flag must_be_updated_p is set have to be updated. */
3525 /* Record that we are not working on frame matrices. */
3526 set_frame_matrix_frame (NULL
);
3528 /* Update all windows in the window tree of F, maybe stopping
3529 when pending input is detected. */
3532 /* Update the menu bar on X frames that don't have toolkit
3534 if (WINDOWP (f
->menu_bar_window
))
3535 update_window (XWINDOW (f
->menu_bar_window
), 1);
3537 /* Update the tool-bar window, if present. */
3538 if (WINDOWP (f
->tool_bar_window
))
3541 struct window
*w
= XWINDOW (f
->tool_bar_window
);
3543 /* Update tool-bar window. */
3544 if (w
->must_be_updated_p
)
3546 update_window (w
, 1);
3547 w
->must_be_updated_p
= 0;
3549 /* Swap tool-bar strings. We swap because we want to
3551 tem
= f
->current_tool_bar_string
;
3552 f
->current_tool_bar_string
= f
->desired_tool_bar_string
;
3553 f
->desired_tool_bar_string
= tem
;
3554 f
->n_current_tool_bar_items
= f
->n_desired_tool_bar_items
;
3556 /* Swap tool-bar items. We swap because we want to
3558 tem
= f
->current_tool_bar_items
;
3559 f
->current_tool_bar_items
= f
->desired_tool_bar_items
;
3560 f
->desired_tool_bar_items
= tem
;
3565 /* Update windows. */
3566 paused_p
= update_window_tree (root_window
, force_p
);
3569 #if 0 /* This flush is a performance bottleneck under X,
3570 and it doesn't seem to be necessary anyway. */
3571 rif
->flush_display (f
);
3576 /* We are working on frame matrix basis. Set the frame on whose
3577 frame matrix we operate. */
3578 set_frame_matrix_frame (f
);
3580 /* Build F's desired matrix from window matrices. */
3581 build_frame_matrix (f
);
3583 /* Update the display */
3585 paused_p
= update_frame_1 (f
, force_p
, inhibit_hairy_id_p
);
3589 fflush (termscript
);
3592 /* Check window matrices for lost pointers. */
3593 IF_DEBUG (check_window_matrix_pointers (root_window
));
3596 /* Reset flags indicating that a window should be updated. */
3597 set_window_update_flags (root_window
, 0);
3599 display_completed
= !paused_p
;
3605 /************************************************************************
3606 Window-based updates
3607 ************************************************************************/
3609 /* Perform updates in window tree rooted at W. FORCE_P non-zero means
3610 don't stop updating when input is pending. */
3613 update_window_tree (w
, force_p
)
3619 while (w
&& !paused_p
)
3621 if (!NILP (w
->hchild
))
3622 paused_p
|= update_window_tree (XWINDOW (w
->hchild
), force_p
);
3623 else if (!NILP (w
->vchild
))
3624 paused_p
|= update_window_tree (XWINDOW (w
->vchild
), force_p
);
3625 else if (w
->must_be_updated_p
)
3626 paused_p
|= update_window (w
, force_p
);
3628 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
3635 /* Update window W if its flag must_be_updated_p is non-zero. If
3636 FORCE_P is non-zero, don't stop updating if input is pending. */
3639 update_single_window (w
, force_p
)
3643 if (w
->must_be_updated_p
)
3645 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
3647 /* Record that this is not a frame-based redisplay. */
3648 set_frame_matrix_frame (NULL
);
3652 update_window (w
, force_p
);
3655 /* Reset flag in W. */
3656 w
->must_be_updated_p
= 0;
3661 /* Redraw lines from the current matrix of window W that are
3662 overlapped by other rows. YB is bottom-most y-position in W. */
3665 redraw_overlapped_rows (w
, yb
)
3671 /* If rows overlapping others have been changed, the rows being
3672 overlapped have to be redrawn. This won't draw lines that have
3673 already been drawn in update_window_line because overlapped_p in
3674 desired rows is 0, so after row assignment overlapped_p in
3675 current rows is 0. */
3676 for (i
= 0; i
< w
->current_matrix
->nrows
; ++i
)
3678 struct glyph_row
*row
= w
->current_matrix
->rows
+ i
;
3680 if (!row
->enabled_p
)
3682 else if (row
->mode_line_p
)
3685 if (row
->overlapped_p
)
3687 enum glyph_row_area area
;
3689 for (area
= LEFT_MARGIN_AREA
; area
< LAST_AREA
; ++area
)
3692 updated_area
= area
;
3693 rif
->cursor_to (i
, 0, row
->y
, area
== TEXT_AREA
? row
->x
: 0);
3694 if (row
->used
[area
])
3695 rif
->write_glyphs (row
->glyphs
[area
], row
->used
[area
]);
3696 rif
->clear_end_of_line (-1);
3699 row
->overlapped_p
= 0;
3702 if (MATRIX_ROW_BOTTOM_Y (row
) >= yb
)
3708 /* Redraw lines from the current matrix of window W that overlap
3709 others. YB is bottom-most y-position in W. */
3712 redraw_overlapping_rows (w
, yb
)
3717 struct glyph_row
*row
;
3719 for (i
= 0; i
< w
->current_matrix
->nrows
; ++i
)
3721 row
= w
->current_matrix
->rows
+ i
;
3723 if (!row
->enabled_p
)
3725 else if (row
->mode_line_p
)
3728 bottom_y
= MATRIX_ROW_BOTTOM_Y (row
);
3730 if (row
->overlapping_p
&& i
> 0 && bottom_y
< yb
)
3732 if (row
->used
[LEFT_MARGIN_AREA
])
3733 rif
->fix_overlapping_area (w
, row
, LEFT_MARGIN_AREA
);
3735 if (row
->used
[TEXT_AREA
])
3736 rif
->fix_overlapping_area (w
, row
, TEXT_AREA
);
3738 if (row
->used
[RIGHT_MARGIN_AREA
])
3739 rif
->fix_overlapping_area (w
, row
, RIGHT_MARGIN_AREA
);
3741 /* Record in neighbor rows that ROW overwrites part of their
3743 if (row
->phys_ascent
> row
->ascent
&& i
> 0)
3744 MATRIX_ROW (w
->current_matrix
, i
- 1)->overlapped_p
= 1;
3745 if ((row
->phys_height
- row
->phys_ascent
3746 > row
->height
- row
->ascent
)
3748 MATRIX_ROW (w
->current_matrix
, i
+ 1)->overlapped_p
= 1;
3757 /* Update display of window W. FORCE_P non-zero means that we should
3758 not stop when detecting pending input. */
3761 update_window (w
, force_p
)
3765 struct glyph_matrix
*desired_matrix
= w
->desired_matrix
;
3767 int preempt_count
= baud_rate
/ 2400 + 1;
3768 extern int input_pending
;
3770 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
3771 extern struct frame
*updating_frame
;
3774 /* Check that W's frame doesn't have glyph matrices. */
3775 xassert (FRAME_WINDOW_P (f
));
3776 xassert (updating_frame
!= NULL
);
3778 /* Check pending input the first time so that we can quickly return. */
3779 if (redisplay_dont_pause
)
3782 detect_input_pending ();
3784 /* If forced to complete the update, or if no input is pending, do
3786 if (force_p
|| !input_pending
)
3788 struct glyph_row
*row
, *end
;
3789 struct glyph_row
*mode_line_row
;
3790 struct glyph_row
*header_line_row
= NULL
;
3791 int yb
, changed_p
= 0, mouse_face_overwritten_p
= 0;
3793 rif
->update_window_begin_hook (w
);
3794 yb
= window_text_bottom_y (w
);
3796 /* If window has a top line, update it before everything else.
3797 Adjust y-positions of other rows by the top line height. */
3798 row
= desired_matrix
->rows
;
3799 end
= row
+ desired_matrix
->nrows
- 1;
3800 if (row
->mode_line_p
)
3801 header_line_row
= row
++;
3803 /* Update the mode line, if necessary. */
3804 mode_line_row
= MATRIX_MODE_LINE_ROW (desired_matrix
);
3805 if (mode_line_row
->mode_line_p
&& mode_line_row
->enabled_p
)
3807 mode_line_row
->y
= yb
;
3808 update_window_line (w
, MATRIX_ROW_VPOS (mode_line_row
,
3810 &mouse_face_overwritten_p
);
3814 /* Find first enabled row. Optimizations in redisplay_internal
3815 may lead to an update with only one row enabled. There may
3816 be also completely empty matrices. */
3817 while (row
< end
&& !row
->enabled_p
)
3820 /* Try reusing part of the display by copying. */
3821 if (row
< end
&& !desired_matrix
->no_scrolling_p
)
3823 int rc
= scrolling_window (w
, header_line_row
!= NULL
);
3826 /* All rows were found to be equal. */
3835 /* Update the top mode line after scrolling because a new top
3836 line would otherwise overwrite lines at the top of the window
3837 that can be scrolled. */
3838 if (header_line_row
&& header_line_row
->enabled_p
)
3840 header_line_row
->y
= 0;
3841 update_window_line (w
, 0, &mouse_face_overwritten_p
);
3845 /* Update the rest of the lines. */
3846 for (; row
< end
&& (force_p
|| !input_pending
); ++row
)
3849 int vpos
= MATRIX_ROW_VPOS (row
, desired_matrix
);
3852 /* We'll Have to play a little bit with when to
3853 detect_input_pending. If it's done too often,
3854 scrolling large windows with repeated scroll-up
3855 commands will too quickly pause redisplay. */
3856 if (!force_p
&& vpos
% preempt_count
== 0)
3857 detect_input_pending ();
3859 changed_p
|= update_window_line (w
, vpos
,
3860 &mouse_face_overwritten_p
);
3862 /* Mark all rows below the last visible one in the current
3863 matrix as invalid. This is necessary because of
3864 variable line heights. Consider the case of three
3865 successive redisplays, where the first displays 5
3866 lines, the second 3 lines, and the third 5 lines again.
3867 If the second redisplay wouldn't mark rows in the
3868 current matrix invalid, the third redisplay might be
3869 tempted to optimize redisplay based on lines displayed
3870 in the first redisplay. */
3871 if (MATRIX_ROW_BOTTOM_Y (row
) >= yb
)
3872 for (i
= vpos
+ 1; i
< w
->current_matrix
->nrows
- 1; ++i
)
3873 MATRIX_ROW (w
->current_matrix
, i
)->enabled_p
= 0;
3876 /* Was display preempted? */
3877 paused_p
= row
< end
;
3881 /* Fix the appearance of overlapping(overlapped rows. */
3882 if (!paused_p
&& !w
->pseudo_window_p
)
3884 if (changed_p
&& rif
->fix_overlapping_area
)
3886 redraw_overlapped_rows (w
, yb
);
3887 redraw_overlapping_rows (w
, yb
);
3890 /* Make cursor visible at cursor position of W. */
3891 set_window_cursor_after_update (w
);
3893 #if 0 /* Check that current matrix invariants are satisfied. This is
3894 for debugging only. See the comment of check_matrix_invariants. */
3895 IF_DEBUG (check_matrix_invariants (w
));
3900 /* Remember the redisplay method used to display the matrix. */
3901 strcpy (w
->current_matrix
->method
, w
->desired_matrix
->method
);
3904 /* End of update of window W. */
3905 rif
->update_window_end_hook (w
, 1, mouse_face_overwritten_p
);
3910 clear_glyph_matrix (desired_matrix
);
3916 /* Update the display of area AREA in window W, row number VPOS.
3917 AREA can be either LEFT_MARGIN_AREA or RIGHT_MARGIN_AREA. */
3920 update_marginal_area (w
, area
, vpos
)
3924 struct glyph_row
*desired_row
= MATRIX_ROW (w
->desired_matrix
, vpos
);
3926 /* Let functions in xterm.c know what area subsequent X positions
3927 will be relative to. */
3928 updated_area
= area
;
3930 /* Set cursor to start of glyphs, write them, and clear to the end
3931 of the area. I don't think that something more sophisticated is
3932 necessary here, since marginal areas will not be the default. */
3933 rif
->cursor_to (vpos
, 0, desired_row
->y
, 0);
3934 if (desired_row
->used
[area
])
3935 rif
->write_glyphs (desired_row
->glyphs
[area
], desired_row
->used
[area
]);
3936 rif
->clear_end_of_line (-1);
3940 /* Update the display of the text area of row VPOS in window W.
3941 Value is non-zero if display has changed. */
3944 update_text_area (w
, vpos
)
3948 struct glyph_row
*current_row
= MATRIX_ROW (w
->current_matrix
, vpos
);
3949 struct glyph_row
*desired_row
= MATRIX_ROW (w
->desired_matrix
, vpos
);
3952 /* Let functions in xterm.c know what area subsequent X positions
3953 will be relative to. */
3954 updated_area
= TEXT_AREA
;
3956 /* If rows are at different X or Y, or rows have different height,
3957 or the current row is marked invalid, write the entire line. */
3958 if (!current_row
->enabled_p
3959 || desired_row
->y
!= current_row
->y
3960 || desired_row
->ascent
!= current_row
->ascent
3961 || desired_row
->phys_ascent
!= current_row
->phys_ascent
3962 || desired_row
->phys_height
!= current_row
->phys_height
3963 || desired_row
->visible_height
!= current_row
->visible_height
3964 || current_row
->overlapped_p
3965 || current_row
->mouse_face_p
3966 || current_row
->x
!= desired_row
->x
)
3968 rif
->cursor_to (vpos
, 0, desired_row
->y
, desired_row
->x
);
3970 if (desired_row
->used
[TEXT_AREA
])
3971 rif
->write_glyphs (desired_row
->glyphs
[TEXT_AREA
],
3972 desired_row
->used
[TEXT_AREA
]);
3974 /* Clear to end of window. */
3975 rif
->clear_end_of_line (-1);
3981 struct glyph
*current_glyph
= current_row
->glyphs
[TEXT_AREA
];
3982 struct glyph
*desired_glyph
= desired_row
->glyphs
[TEXT_AREA
];
3984 /* If the desired row extends its face to the text area end,
3985 make sure we write at least one glyph, so that the face
3986 extension actually takes place. */
3987 int desired_stop_pos
= (desired_row
->used
[TEXT_AREA
]
3988 - (MATRIX_ROW_EXTENDS_FACE_P (desired_row
)
3991 stop
= min (current_row
->used
[TEXT_AREA
], desired_stop_pos
);
3997 /* Skip over glyphs that both rows have in common. These
3998 don't have to be written. */
4000 && GLYPH_EQUAL_P (desired_glyph
, current_glyph
))
4002 x
+= desired_glyph
->pixel_width
;
4003 ++desired_glyph
, ++current_glyph
, ++i
;
4006 /* Consider the case that the current row contains "xxx ppp
4007 ggg" in italic Courier font, and the desired row is "xxx
4008 ggg". The character `p' has lbearing, `g' has not. The
4009 loop above will stop in front of the first `p' in the
4010 current row. If we would start writing glyphs there, we
4011 wouldn't erase the lbearing of the `p'. The rest of the
4012 lbearing problem is then taken care of by x_draw_glyphs. */
4013 if (current_row
->contains_overlapping_glyphs_p
4015 && i
< current_row
->used
[TEXT_AREA
]
4016 && current_row
->used
[TEXT_AREA
] != desired_row
->used
[TEXT_AREA
])
4019 rif
->get_glyph_overhangs (current_glyph
, XFRAME (w
->frame
),
4021 while (left
> 0 && i
> 0)
4023 --i
, --desired_glyph
, --current_glyph
;
4024 x
-= desired_glyph
->pixel_width
;
4025 left
-= desired_glyph
->pixel_width
;
4029 /* Try to avoid writing the entire rest of the desired row
4030 by looking for a resync point. This mainly prevents
4031 mode line flickering in the case the mode line is in
4032 fixed-pitch font, which it usually will be. */
4033 if (i
< desired_row
->used
[TEXT_AREA
])
4035 int start_x
= x
, start_hpos
= i
;
4036 struct glyph
*start
= desired_glyph
;
4039 /* Find the next glyph that's equal again. */
4041 && !GLYPH_EQUAL_P (desired_glyph
, current_glyph
)
4044 x
+= desired_glyph
->pixel_width
;
4045 current_x
+= current_glyph
->pixel_width
;
4046 ++desired_glyph
, ++current_glyph
, ++i
;
4049 if (i
== start_hpos
|| x
!= current_x
)
4053 desired_glyph
= start
;
4057 rif
->cursor_to (vpos
, start_hpos
, desired_row
->y
, start_x
);
4058 rif
->write_glyphs (start
, i
- start_hpos
);
4063 /* Write the rest. */
4064 if (i
< desired_row
->used
[TEXT_AREA
])
4066 rif
->cursor_to (vpos
, i
, desired_row
->y
, x
);
4067 rif
->write_glyphs (desired_glyph
, desired_row
->used
[TEXT_AREA
] - i
);
4071 /* Maybe clear to end of line. */
4072 if (MATRIX_ROW_EXTENDS_FACE_P (desired_row
))
4074 /* If new row extends to the end of the text area, nothing
4075 has to be cleared, if and only if we did a write_glyphs
4076 above. This is made sure by setting desired_stop_pos
4077 appropriately above. */
4078 xassert (i
< desired_row
->used
[TEXT_AREA
]);
4080 else if (MATRIX_ROW_EXTENDS_FACE_P (current_row
))
4082 /* If old row extends to the end of the text area, clear. */
4083 if (i
>= desired_row
->used
[TEXT_AREA
])
4084 rif
->cursor_to (vpos
, i
, desired_row
->y
,
4085 desired_row
->x
+ desired_row
->pixel_width
);
4086 rif
->clear_end_of_line (-1);
4089 else if (desired_row
->pixel_width
< current_row
->pixel_width
)
4091 /* Otherwise clear to the end of the old row. Everything
4092 after that position should be clear already. */
4095 if (i
>= desired_row
->used
[TEXT_AREA
])
4096 rif
->cursor_to (vpos
, i
, desired_row
->y
,
4097 desired_row
->x
+ desired_row
->pixel_width
);
4099 /* If cursor is displayed at the end of the line, make sure
4100 it's cleared. Nowadays we don't have a phys_cursor_glyph
4101 with which to erase the cursor (because this method
4102 doesn't work with lbearing/rbearing), so we must do it
4104 if (vpos
== w
->phys_cursor
.vpos
4105 && w
->phys_cursor
.hpos
>= desired_row
->used
[TEXT_AREA
])
4107 w
->phys_cursor_on_p
= 0;
4111 x
= current_row
->x
+ current_row
->pixel_width
;
4112 rif
->clear_end_of_line (x
);
4121 /* Update row VPOS in window W. Value is non-zero if display has been
4125 update_window_line (w
, vpos
, mouse_face_overwritten_p
)
4127 int vpos
, *mouse_face_overwritten_p
;
4129 struct glyph_row
*current_row
= MATRIX_ROW (w
->current_matrix
, vpos
);
4130 struct glyph_row
*desired_row
= MATRIX_ROW (w
->desired_matrix
, vpos
);
4133 /* Set the row being updated. This is important to let xterm.c
4134 know what line height values are in effect. */
4135 updated_row
= desired_row
;
4137 /* A row can be completely invisible in case a desired matrix was
4138 built with a vscroll and then make_cursor_line_fully_visible shifts
4139 the matrix. Make sure to make such rows current anyway, since
4140 we need the correct y-position, for example, in the current matrix. */
4141 if (desired_row
->mode_line_p
4142 || desired_row
->visible_height
> 0)
4144 xassert (desired_row
->enabled_p
);
4146 /* Update display of the left margin area, if there is one. */
4147 if (!desired_row
->full_width_p
4148 && !NILP (w
->left_margin_width
))
4151 update_marginal_area (w
, LEFT_MARGIN_AREA
, vpos
);
4154 /* Update the display of the text area. */
4155 if (update_text_area (w
, vpos
))
4158 if (current_row
->mouse_face_p
)
4159 *mouse_face_overwritten_p
= 1;
4162 /* Update display of the right margin area, if there is one. */
4163 if (!desired_row
->full_width_p
4164 && !NILP (w
->right_margin_width
))
4167 update_marginal_area (w
, RIGHT_MARGIN_AREA
, vpos
);
4170 /* Draw truncation marks etc. */
4171 if (!current_row
->enabled_p
4172 || desired_row
->y
!= current_row
->y
4173 || desired_row
->visible_height
!= current_row
->visible_height
4174 || desired_row
->overlay_arrow_p
!= current_row
->overlay_arrow_p
4175 || desired_row
->truncated_on_left_p
!= current_row
->truncated_on_left_p
4176 || desired_row
->truncated_on_right_p
!= current_row
->truncated_on_right_p
4177 || desired_row
->continued_p
!= current_row
->continued_p
4178 || desired_row
->mode_line_p
!= current_row
->mode_line_p
4179 || (desired_row
->indicate_empty_line_p
4180 != current_row
->indicate_empty_line_p
)
4181 || (MATRIX_ROW_CONTINUATION_LINE_P (desired_row
)
4182 != MATRIX_ROW_CONTINUATION_LINE_P (current_row
)))
4183 rif
->after_update_window_line_hook (desired_row
);
4186 /* Update current_row from desired_row. */
4187 make_current (w
->desired_matrix
, w
->current_matrix
, vpos
);
4193 /* Set the cursor after an update of window W. This function may only
4194 be called from update_window. */
4197 set_window_cursor_after_update (w
)
4200 struct frame
*f
= XFRAME (w
->frame
);
4201 int cx
, cy
, vpos
, hpos
;
4203 /* Not intended for frame matrix updates. */
4204 xassert (FRAME_WINDOW_P (f
));
4206 if (cursor_in_echo_area
4207 && !NILP (echo_area_buffer
[0])
4208 /* If we are showing a message instead of the mini-buffer,
4209 show the cursor for the message instead. */
4210 && XWINDOW (minibuf_window
) == w
4211 && EQ (minibuf_window
, echo_area_window
)
4212 /* These cases apply only to the frame that contains
4213 the active mini-buffer window. */
4214 && FRAME_HAS_MINIBUF_P (f
)
4215 && EQ (FRAME_MINIBUF_WINDOW (f
), echo_area_window
))
4217 cx
= cy
= vpos
= hpos
= 0;
4219 if (cursor_in_echo_area
>= 0)
4221 /* If the mini-buffer is several lines high, find the last
4222 line that has any text on it. Note: either all lines
4223 are enabled or none. Otherwise we wouldn't be able to
4225 struct glyph_row
*row
, *last_row
;
4226 struct glyph
*glyph
;
4227 int yb
= window_text_bottom_y (w
);
4230 for (row
= MATRIX_ROW (w
->current_matrix
, 0);
4234 if (row
->used
[TEXT_AREA
]
4235 && row
->glyphs
[TEXT_AREA
][0].charpos
>= 0)
4238 if (MATRIX_ROW_BOTTOM_Y (row
) >= yb
)
4244 struct glyph
*start
= row
->glyphs
[TEXT_AREA
];
4245 struct glyph
*last
= start
+ row
->used
[TEXT_AREA
] - 1;
4247 while (last
> start
&& last
->charpos
< 0)
4250 for (glyph
= start
; glyph
< last
; ++glyph
)
4252 cx
+= glyph
->pixel_width
;
4257 vpos
= MATRIX_ROW_VPOS (last_row
, w
->current_matrix
);
4265 hpos
= w
->cursor
.hpos
;
4266 vpos
= w
->cursor
.vpos
;
4269 /* Window cursor can be out of sync for horizontally split windows. */
4270 hpos
= max (0, hpos
);
4271 hpos
= min (w
->current_matrix
->matrix_w
- 1, hpos
);
4272 vpos
= max (0, vpos
);
4273 vpos
= min (w
->current_matrix
->nrows
- 1, vpos
);
4274 rif
->cursor_to (vpos
, hpos
, cy
, cx
);
4278 /* Set WINDOW->must_be_updated_p to ON_P for all windows in the window
4279 tree rooted at W. */
4282 set_window_update_flags (w
, on_p
)
4288 if (!NILP (w
->hchild
))
4289 set_window_update_flags (XWINDOW (w
->hchild
), on_p
);
4290 else if (!NILP (w
->vchild
))
4291 set_window_update_flags (XWINDOW (w
->vchild
), on_p
);
4293 w
->must_be_updated_p
= on_p
;
4295 w
= NILP (w
->next
) ? 0 : XWINDOW (w
->next
);
4301 /***********************************************************************
4302 Window-Based Scrolling
4303 ***********************************************************************/
4305 /* Structure describing rows in scrolling_window. */
4309 /* Number of occurrences of this row in desired and current matrix. */
4310 int old_uses
, new_uses
;
4312 /* Vpos of row in new matrix. */
4313 int new_line_number
;
4315 /* Bucket index of this row_entry in the hash table row_table. */
4318 /* The row described by this entry. */
4319 struct glyph_row
*row
;
4321 /* Hash collision chain. */
4322 struct row_entry
*next
;
4325 /* A pool to allocate row_entry structures from, and the size of the
4326 pool. The pool is reallocated in scrolling_window when we find
4327 that we need a larger one. */
4329 static struct row_entry
*row_entry_pool
;
4330 static int row_entry_pool_size
;
4332 /* Index of next free entry in row_entry_pool. */
4334 static int row_entry_idx
;
4336 /* The hash table used during scrolling, and the table's size. This
4337 table is used to quickly identify equal rows in the desired and
4340 static struct row_entry
**row_table
;
4341 static int row_table_size
;
4343 /* Vectors of pointers to row_entry structures belonging to the
4344 current and desired matrix, and the size of the vectors. */
4346 static struct row_entry
**old_lines
, **new_lines
;
4347 static int old_lines_size
, new_lines_size
;
4349 /* A pool to allocate run structures from, and its size. */
4351 static struct run
*run_pool
;
4352 static int runs_size
;
4354 /* A vector of runs of lines found during scrolling. */
4356 static struct run
**runs
;
4358 static struct row_entry
*add_row_entry
P_ ((struct window
*,
4359 struct glyph_row
*));
4362 /* Add glyph row ROW to the scrolling hash table during the scrolling
4365 static INLINE
struct row_entry
*
4366 add_row_entry (w
, row
)
4368 struct glyph_row
*row
;
4370 struct row_entry
*entry
;
4371 int i
= row
->hash
% row_table_size
;
4373 entry
= row_table
[i
];
4374 while (entry
&& !row_equal_p (w
, entry
->row
, row
, 1))
4375 entry
= entry
->next
;
4379 entry
= row_entry_pool
+ row_entry_idx
++;
4381 entry
->old_uses
= entry
->new_uses
= 0;
4382 entry
->new_line_number
= 0;
4384 entry
->next
= row_table
[i
];
4385 row_table
[i
] = entry
;
4392 /* Try to reuse part of the current display of W by scrolling lines.
4393 HEADER_LINE_P non-zero means W has a top mode line.
4395 The algorithm is taken from Communications of the ACM, Apr78 "A
4396 Technique for Isolating Differences Between Files." It should take
4399 A short outline of the steps of the algorithm
4401 1. Skip lines equal at the start and end of both matrices.
4403 2. Enter rows in the current and desired matrix into a symbol
4404 table, counting how often they appear in both matrices.
4406 3. Rows that appear exactly once in both matrices serve as anchors,
4407 i.e. we assume that such lines are likely to have been moved.
4409 4. Starting from anchor lines, extend regions to be scrolled both
4410 forward and backward.
4414 -1 if all rows were found to be equal.
4415 0 to indicate that we did not scroll the display, or
4416 1 if we did scroll. */
4419 scrolling_window (w
, header_line_p
)
4423 struct glyph_matrix
*desired_matrix
= w
->desired_matrix
;
4424 struct glyph_matrix
*current_matrix
= w
->current_matrix
;
4425 int yb
= window_text_bottom_y (w
);
4426 int i
, j
, first_old
, first_new
, last_old
, last_new
;
4427 int nruns
, nbytes
, n
, run_idx
;
4428 struct row_entry
*entry
;
4430 /* Skip over rows equal at the start. */
4431 for (i
= header_line_p
? 1 : 0; i
< current_matrix
->nrows
- 1; ++i
)
4433 struct glyph_row
*d
= MATRIX_ROW (desired_matrix
, i
);
4434 struct glyph_row
*c
= MATRIX_ROW (current_matrix
, i
);
4439 && MATRIX_ROW_BOTTOM_Y (c
) <= yb
4440 && MATRIX_ROW_BOTTOM_Y (d
) <= yb
4441 && row_equal_p (w
, c
, d
, 1))
4450 /* Give up if some rows in the desired matrix are not enabled. */
4451 if (!MATRIX_ROW (desired_matrix
, i
)->enabled_p
)
4454 first_old
= first_new
= i
;
4456 /* Set last_new to the index + 1 of the last enabled row in the
4459 while (i
< desired_matrix
->nrows
- 1
4460 && MATRIX_ROW (desired_matrix
, i
)->enabled_p
4461 && MATRIX_ROW_BOTTOM_Y (MATRIX_ROW (desired_matrix
, i
)) <= yb
)
4464 if (!MATRIX_ROW (desired_matrix
, i
)->enabled_p
)
4469 /* Set last_old to the index + 1 of the last enabled row in the
4470 current matrix. We don't look at the enabled flag here because
4471 we plan to reuse part of the display even if other parts are
4474 while (i
< current_matrix
->nrows
- 1
4475 && MATRIX_ROW_BOTTOM_Y (MATRIX_ROW (current_matrix
, i
)) <= yb
)
4479 /* Skip over rows equal at the bottom. */
4482 while (i
- 1 > first_new
4483 && j
- 1 > first_old
4484 && MATRIX_ROW (current_matrix
, i
- 1)->enabled_p
4485 && (MATRIX_ROW (current_matrix
, i
- 1)->y
4486 == MATRIX_ROW (desired_matrix
, j
- 1)->y
)
4488 MATRIX_ROW (desired_matrix
, i
- 1),
4489 MATRIX_ROW (current_matrix
, j
- 1), 1))
4494 /* Nothing to do if all rows are equal. */
4495 if (last_new
== first_new
)
4498 /* Reallocate vectors, tables etc. if necessary. */
4500 if (current_matrix
->nrows
> old_lines_size
)
4502 old_lines_size
= current_matrix
->nrows
;
4503 nbytes
= old_lines_size
* sizeof *old_lines
;
4504 old_lines
= (struct row_entry
**) xrealloc (old_lines
, nbytes
);
4507 if (desired_matrix
->nrows
> new_lines_size
)
4509 new_lines_size
= desired_matrix
->nrows
;
4510 nbytes
= new_lines_size
* sizeof *new_lines
;
4511 new_lines
= (struct row_entry
**) xrealloc (new_lines
, nbytes
);
4514 n
= desired_matrix
->nrows
+ current_matrix
->nrows
;
4515 if (3 * n
> row_table_size
)
4517 row_table_size
= next_almost_prime (3 * n
);
4518 nbytes
= row_table_size
* sizeof *row_table
;
4519 row_table
= (struct row_entry
**) xrealloc (row_table
, nbytes
);
4520 bzero (row_table
, nbytes
);
4523 if (n
> row_entry_pool_size
)
4525 row_entry_pool_size
= n
;
4526 nbytes
= row_entry_pool_size
* sizeof *row_entry_pool
;
4527 row_entry_pool
= (struct row_entry
*) xrealloc (row_entry_pool
, nbytes
);
4530 if (desired_matrix
->nrows
> runs_size
)
4532 runs_size
= desired_matrix
->nrows
;
4533 nbytes
= runs_size
* sizeof *runs
;
4534 runs
= (struct run
**) xrealloc (runs
, nbytes
);
4535 nbytes
= runs_size
* sizeof *run_pool
;
4536 run_pool
= (struct run
*) xrealloc (run_pool
, nbytes
);
4539 nruns
= run_idx
= 0;
4542 /* Add rows from the current and desired matrix to the hash table
4543 row_hash_table to be able to find equal ones quickly. */
4545 for (i
= first_old
; i
< last_old
; ++i
)
4547 if (MATRIX_ROW (current_matrix
, i
)->enabled_p
)
4549 entry
= add_row_entry (w
, MATRIX_ROW (current_matrix
, i
));
4550 old_lines
[i
] = entry
;
4554 old_lines
[i
] = NULL
;
4557 for (i
= first_new
; i
< last_new
; ++i
)
4559 xassert (MATRIX_ROW_ENABLED_P (desired_matrix
, i
));
4560 entry
= add_row_entry (w
, MATRIX_ROW (desired_matrix
, i
));
4562 entry
->new_line_number
= i
;
4563 new_lines
[i
] = entry
;
4566 /* Identify moves based on lines that are unique and equal
4567 in both matrices. */
4568 for (i
= first_old
; i
< last_old
;)
4570 && old_lines
[i
]->old_uses
== 1
4571 && old_lines
[i
]->new_uses
== 1)
4574 int new_line
= old_lines
[i
]->new_line_number
;
4575 struct run
*run
= run_pool
+ run_idx
++;
4578 run
->current_vpos
= i
;
4579 run
->current_y
= MATRIX_ROW (current_matrix
, i
)->y
;
4580 run
->desired_vpos
= new_line
;
4581 run
->desired_y
= MATRIX_ROW (desired_matrix
, new_line
)->y
;
4583 run
->height
= MATRIX_ROW (current_matrix
, i
)->height
;
4585 /* Extend backward. */
4588 while (j
> first_old
4590 && old_lines
[j
] == new_lines
[k
])
4592 int h
= MATRIX_ROW (current_matrix
, j
)->height
;
4593 --run
->current_vpos
;
4594 --run
->desired_vpos
;
4597 run
->desired_y
-= h
;
4598 run
->current_y
-= h
;
4602 /* Extend forward. */
4607 && old_lines
[j
] == new_lines
[k
])
4609 int h
= MATRIX_ROW (current_matrix
, j
)->height
;
4615 /* Insert run into list of all runs. Order runs by copied
4616 pixel lines. Note that we record runs that don't have to
4617 be copied because they are already in place. This is done
4618 because we can avoid calling update_window_line in this
4620 for (j
= 0; j
< nruns
&& runs
[j
]->height
> run
->height
; ++j
)
4622 for (k
= nruns
; k
>= j
; --k
)
4623 runs
[k
] = runs
[k
- 1];
4632 /* Do the moves. Do it in a way that we don't overwrite something
4633 we want to copy later on. This is not solvable in general
4634 because there is only one display and we don't have a way to
4635 exchange areas on this display. Example:
4637 +-----------+ +-----------+
4639 +-----------+ --> +-----------+
4641 +-----------+ +-----------+
4643 Instead, prefer bigger moves, and invalidate moves that would
4644 copy from where we copied to. */
4646 for (i
= 0; i
< nruns
; ++i
)
4647 if (runs
[i
]->nrows
> 0)
4649 struct run
*r
= runs
[i
];
4651 /* Copy on the display. */
4652 if (r
->current_y
!= r
->desired_y
)
4654 rif
->scroll_run_hook (w
, r
);
4656 /* Invalidate runs that copy from where we copied to. */
4657 for (j
= i
+ 1; j
< nruns
; ++j
)
4659 struct run
*p
= runs
[j
];
4661 if ((p
->current_y
>= r
->desired_y
4662 && p
->current_y
< r
->desired_y
+ r
->height
)
4663 || (p
->current_y
+ p
->height
>= r
->desired_y
4664 && (p
->current_y
+ p
->height
4665 < r
->desired_y
+ r
->height
)))
4670 /* Assign matrix rows. */
4671 for (j
= 0; j
< r
->nrows
; ++j
)
4673 struct glyph_row
*from
, *to
;
4674 int to_overlapped_p
;
4676 to
= MATRIX_ROW (current_matrix
, r
->desired_vpos
+ j
);
4677 from
= MATRIX_ROW (desired_matrix
, r
->desired_vpos
+ j
);
4678 to_overlapped_p
= to
->overlapped_p
;
4679 assign_row (to
, from
);
4680 to
->enabled_p
= 1, from
->enabled_p
= 0;
4681 to
->overlapped_p
= to_overlapped_p
;
4685 /* Clear the hash table, for the next time. */
4686 for (i
= 0; i
< row_entry_idx
; ++i
)
4687 row_table
[row_entry_pool
[i
].bucket
] = NULL
;
4689 /* Value is non-zero to indicate that we scrolled the display. */
4695 /************************************************************************
4697 ************************************************************************/
4699 /* Update the desired frame matrix of frame F.
4701 FORCE_P non-zero means that the update should not be stopped by
4702 pending input. INHIBIT_HAIRY_ID_P non-zero means that scrolling
4703 should not be tried.
4705 Value is non-zero if update was stopped due to pending input. */
4708 update_frame_1 (f
, force_p
, inhibit_id_p
)
4713 /* Frame matrices to work on. */
4714 struct glyph_matrix
*current_matrix
= f
->current_matrix
;
4715 struct glyph_matrix
*desired_matrix
= f
->desired_matrix
;
4718 int preempt_count
= baud_rate
/ 2400 + 1;
4719 extern int input_pending
;
4721 xassert (current_matrix
&& desired_matrix
);
4723 if (baud_rate
!= FRAME_COST_BAUD_RATE (f
))
4724 calculate_costs (f
);
4726 if (preempt_count
<= 0)
4729 if (redisplay_dont_pause
)
4731 else if (!force_p
&& detect_input_pending ())
4737 /* If we cannot insert/delete lines, it's no use trying it. */
4738 if (!line_ins_del_ok
)
4741 /* See if any of the desired lines are enabled; don't compute for
4742 i/d line if just want cursor motion. */
4743 for (i
= 0; i
< desired_matrix
->nrows
; i
++)
4744 if (MATRIX_ROW_ENABLED_P (desired_matrix
, i
))
4747 /* Try doing i/d line, if not yet inhibited. */
4748 if (!inhibit_id_p
&& i
< desired_matrix
->nrows
)
4749 force_p
|= scrolling (f
);
4751 /* Update the individual lines as needed. Do bottom line first. */
4752 if (MATRIX_ROW_ENABLED_P (desired_matrix
, desired_matrix
->nrows
- 1))
4753 update_frame_line (f
, desired_matrix
->nrows
- 1);
4755 /* Now update the rest of the lines. */
4756 for (i
= 0; i
< desired_matrix
->nrows
- 1 && (force_p
|| !input_pending
); i
++)
4758 if (MATRIX_ROW_ENABLED_P (desired_matrix
, i
))
4760 if (FRAME_TERMCAP_P (f
))
4762 /* Flush out every so many lines.
4763 Also flush out if likely to have more than 1k buffered
4764 otherwise. I'm told that some telnet connections get
4765 really screwed by more than 1k output at once. */
4766 int outq
= PENDING_OUTPUT_COUNT (stdout
);
4768 || (outq
> 20 && ((i
- 1) % preempt_count
== 0)))
4771 if (preempt_count
== 1)
4773 #ifdef EMACS_OUTQSIZE
4774 if (EMACS_OUTQSIZE (0, &outq
) < 0)
4775 /* Probably not a tty. Ignore the error and reset
4776 * the outq count. */
4777 outq
= PENDING_OUTPUT_COUNT (stdout
);
4780 if (baud_rate
<= outq
&& baud_rate
> 0)
4781 sleep (outq
/ baud_rate
);
4786 if ((i
- 1) % preempt_count
== 0)
4787 detect_input_pending ();
4789 update_frame_line (f
, i
);
4793 pause
= (i
< FRAME_HEIGHT (f
) - 1) ? i
: 0;
4795 /* Now just clean up termcap drivers and set cursor, etc. */
4798 if ((cursor_in_echo_area
4799 /* If we are showing a message instead of the mini-buffer,
4800 show the cursor for the message instead of for the
4801 (now hidden) mini-buffer contents. */
4802 || (EQ (minibuf_window
, selected_window
)
4803 && EQ (minibuf_window
, echo_area_window
)
4804 && !NILP (echo_area_buffer
[0])))
4805 /* These cases apply only to the frame that contains
4806 the active mini-buffer window. */
4807 && FRAME_HAS_MINIBUF_P (f
)
4808 && EQ (FRAME_MINIBUF_WINDOW (f
), echo_area_window
))
4810 int top
= XINT (XWINDOW (FRAME_MINIBUF_WINDOW (f
))->top
);
4813 if (cursor_in_echo_area
< 0)
4815 /* Negative value of cursor_in_echo_area means put
4816 cursor at beginning of line. */
4822 /* Positive value of cursor_in_echo_area means put
4823 cursor at the end of the prompt. If the mini-buffer
4824 is several lines high, find the last line that has
4826 row
= FRAME_HEIGHT (f
);
4832 if (MATRIX_ROW_ENABLED_P (current_matrix
, row
))
4834 /* Frame rows are filled up with spaces that
4835 must be ignored here. */
4836 struct glyph_row
*r
= MATRIX_ROW (current_matrix
,
4838 struct glyph
*start
= r
->glyphs
[TEXT_AREA
];
4839 struct glyph
*last
= start
+ r
->used
[TEXT_AREA
];
4842 && (last
- 1)->charpos
< 0)
4848 while (row
> top
&& col
== 0);
4850 /* Make sure COL is not out of range. */
4851 if (col
>= FRAME_CURSOR_X_LIMIT (f
))
4853 /* If we have another row, advance cursor into it. */
4854 if (row
< FRAME_HEIGHT (f
) - 1)
4856 col
= FRAME_LEFT_SCROLL_BAR_WIDTH (f
);
4859 /* Otherwise move it back in range. */
4861 col
= FRAME_CURSOR_X_LIMIT (f
) - 1;
4865 cursor_to (row
, col
);
4869 /* We have only one cursor on terminal frames. Use it to
4870 display the cursor of the selected window. */
4871 struct window
*w
= XWINDOW (FRAME_SELECTED_WINDOW (f
));
4872 if (w
->cursor
.vpos
>= 0
4873 /* The cursor vpos may be temporarily out of bounds
4874 in the following situation: There is one window,
4875 with the cursor in the lower half of it. The window
4876 is split, and a message causes a redisplay before
4877 a new cursor position has been computed. */
4878 && w
->cursor
.vpos
< XFASTINT (w
->height
))
4880 int x
= WINDOW_TO_FRAME_HPOS (w
, w
->cursor
.hpos
);
4881 int y
= WINDOW_TO_FRAME_VPOS (w
, w
->cursor
.vpos
);
4883 if (INTEGERP (w
->left_margin_width
))
4884 x
+= XFASTINT (w
->left_margin_width
);
4886 /* x = max (min (x, FRAME_WINDOW_WIDTH (f) - 1), 0); */
4894 clear_desired_matrices (f
);
4899 /* Do line insertions/deletions on frame F for frame-based redisplay. */
4903 struct frame
*frame
;
4905 int unchanged_at_top
, unchanged_at_bottom
;
4908 int *old_hash
= (int *) alloca (FRAME_HEIGHT (frame
) * sizeof (int));
4909 int *new_hash
= (int *) alloca (FRAME_HEIGHT (frame
) * sizeof (int));
4910 int *draw_cost
= (int *) alloca (FRAME_HEIGHT (frame
) * sizeof (int));
4911 int *old_draw_cost
= (int *) alloca (FRAME_HEIGHT (frame
) * sizeof (int));
4913 int free_at_end_vpos
= FRAME_HEIGHT (frame
);
4914 struct glyph_matrix
*current_matrix
= frame
->current_matrix
;
4915 struct glyph_matrix
*desired_matrix
= frame
->desired_matrix
;
4917 if (!current_matrix
)
4920 /* Compute hash codes of all the lines. Also calculate number of
4921 changed lines, number of unchanged lines at the beginning, and
4922 number of unchanged lines at the end. */
4924 unchanged_at_top
= 0;
4925 unchanged_at_bottom
= FRAME_HEIGHT (frame
);
4926 for (i
= 0; i
< FRAME_HEIGHT (frame
); i
++)
4928 /* Give up on this scrolling if some old lines are not enabled. */
4929 if (!MATRIX_ROW_ENABLED_P (current_matrix
, i
))
4931 old_hash
[i
] = line_hash_code (MATRIX_ROW (current_matrix
, i
));
4932 if (! MATRIX_ROW_ENABLED_P (desired_matrix
, i
))
4934 /* This line cannot be redrawn, so don't let scrolling mess it. */
4935 new_hash
[i
] = old_hash
[i
];
4936 #define INFINITY 1000000 /* Taken from scroll.c */
4937 draw_cost
[i
] = INFINITY
;
4941 new_hash
[i
] = line_hash_code (MATRIX_ROW (desired_matrix
, i
));
4942 draw_cost
[i
] = line_draw_cost (desired_matrix
, i
);
4945 if (old_hash
[i
] != new_hash
[i
])
4948 unchanged_at_bottom
= FRAME_HEIGHT (frame
) - i
- 1;
4950 else if (i
== unchanged_at_top
)
4952 old_draw_cost
[i
] = line_draw_cost (current_matrix
, i
);
4955 /* If changed lines are few, don't allow preemption, don't scroll. */
4956 if ((!scroll_region_ok
&& changed_lines
< baud_rate
/ 2400)
4957 || unchanged_at_bottom
== FRAME_HEIGHT (frame
))
4960 window_size
= (FRAME_HEIGHT (frame
) - unchanged_at_top
4961 - unchanged_at_bottom
);
4963 if (scroll_region_ok
)
4964 free_at_end_vpos
-= unchanged_at_bottom
;
4965 else if (memory_below_frame
)
4966 free_at_end_vpos
= -1;
4968 /* If large window, fast terminal and few lines in common between
4969 current frame and desired frame, don't bother with i/d calc. */
4970 if (!scroll_region_ok
&& window_size
>= 18 && baud_rate
> 2400
4972 10 * scrolling_max_lines_saved (unchanged_at_top
,
4973 FRAME_HEIGHT (frame
) - unchanged_at_bottom
,
4974 old_hash
, new_hash
, draw_cost
)))
4977 if (window_size
< 2)
4980 scrolling_1 (frame
, window_size
, unchanged_at_top
, unchanged_at_bottom
,
4981 draw_cost
+ unchanged_at_top
- 1,
4982 old_draw_cost
+ unchanged_at_top
- 1,
4983 old_hash
+ unchanged_at_top
- 1,
4984 new_hash
+ unchanged_at_top
- 1,
4985 free_at_end_vpos
- unchanged_at_top
);
4991 /* Count the number of blanks at the start of the vector of glyphs R
4992 which is LEN glyphs long. */
4995 count_blanks (r
, len
)
5001 for (i
= 0; i
< len
; ++i
)
5002 if (!CHAR_GLYPH_SPACE_P (r
[i
]))
5009 /* Count the number of glyphs in common at the start of the glyph
5010 vectors STR1 and STR2. END1 is the end of STR1 and END2 is the end
5011 of STR2. Value is the number of equal glyphs equal at the start. */
5014 count_match (str1
, end1
, str2
, end2
)
5015 struct glyph
*str1
, *end1
, *str2
, *end2
;
5017 struct glyph
*p1
= str1
;
5018 struct glyph
*p2
= str2
;
5022 && GLYPH_CHAR_AND_FACE_EQUAL_P (p1
, p2
))
5029 /* Char insertion/deletion cost vector, from term.c */
5031 extern int *char_ins_del_vector
;
5032 #define char_ins_del_cost(f) (&char_ins_del_vector[FRAME_WINDOW_WIDTH((f))])
5035 /* Perform a frame-based update on line VPOS in frame FRAME. */
5038 update_frame_line (frame
, vpos
)
5039 register struct frame
*frame
;
5042 struct glyph
*obody
, *nbody
, *op1
, *op2
, *np1
, *nend
;
5044 int osp
, nsp
, begmatch
, endmatch
, olen
, nlen
;
5045 struct glyph_matrix
*current_matrix
= frame
->current_matrix
;
5046 struct glyph_matrix
*desired_matrix
= frame
->desired_matrix
;
5047 struct glyph_row
*current_row
= MATRIX_ROW (current_matrix
, vpos
);
5048 struct glyph_row
*desired_row
= MATRIX_ROW (desired_matrix
, vpos
);
5049 int must_write_whole_line_p
;
5051 if (desired_row
->inverse_p
5052 != (current_row
->enabled_p
&& current_row
->inverse_p
))
5054 int n
= current_row
->enabled_p
? current_row
->used
[TEXT_AREA
] : 0;
5055 change_line_highlight (desired_row
->inverse_p
, vpos
, vpos
, n
);
5056 current_row
->enabled_p
= 0;
5059 reassert_line_highlight (desired_row
->inverse_p
, vpos
);
5061 /* Current row not enabled means it has unknown contents. We must
5062 write the whole desired line in that case. */
5063 must_write_whole_line_p
= !current_row
->enabled_p
;
5064 if (must_write_whole_line_p
)
5071 obody
= MATRIX_ROW_GLYPH_START (current_matrix
, vpos
);
5072 olen
= current_row
->used
[TEXT_AREA
];
5074 if (! current_row
->inverse_p
)
5076 /* Ignore trailing spaces, if we can. */
5077 if (!must_write_spaces
)
5078 while (olen
> 0 && CHAR_GLYPH_SPACE_P (obody
[olen
-1]))
5083 /* For an inverse-video line, make sure it's filled with
5084 spaces all the way to the frame edge so that the reverse
5085 video extends all the way across. */
5086 while (olen
< FRAME_WIDTH (frame
) - 1)
5087 obody
[olen
++] = space_glyph
;
5091 current_row
->enabled_p
= 1;
5092 current_row
->used
[TEXT_AREA
] = desired_row
->used
[TEXT_AREA
];
5093 current_row
->inverse_p
= desired_row
->inverse_p
;
5095 /* If desired line is empty, just clear the line. */
5096 if (!desired_row
->enabled_p
)
5102 nbody
= desired_row
->glyphs
[TEXT_AREA
];
5103 nlen
= desired_row
->used
[TEXT_AREA
];
5104 nend
= nbody
+ nlen
;
5106 /* If display line has unknown contents, write the whole line. */
5107 if (must_write_whole_line_p
)
5109 /* Ignore spaces at the end, if we can. */
5110 if (!must_write_spaces
)
5111 while (nlen
> 0 && CHAR_GLYPH_SPACE_P (nbody
[nlen
- 1]))
5114 /* Write the contents of the desired line. */
5117 cursor_to (vpos
, 0);
5118 write_glyphs (nbody
, nlen
);
5121 /* Don't call clear_end_of_line if we already wrote the whole
5122 line. The cursor will not be at the right margin in that
5123 case but in the line below. */
5124 if (nlen
< FRAME_WINDOW_WIDTH (frame
))
5126 cursor_to (vpos
, nlen
);
5127 clear_end_of_line (FRAME_WINDOW_WIDTH (frame
));
5130 /* Make sure we are in the right row, otherwise cursor movement
5131 with cmgoto might use `ch' in the wrong row. */
5132 cursor_to (vpos
, 0);
5134 make_current (desired_matrix
, current_matrix
, vpos
);
5138 /* Pretend trailing spaces are not there at all,
5139 unless for one reason or another we must write all spaces. */
5140 if (!desired_row
->inverse_p
)
5142 if (!must_write_spaces
)
5143 while (nlen
> 0 && CHAR_GLYPH_SPACE_P (nbody
[nlen
- 1]))
5148 /* For an inverse-video line, give it extra trailing spaces all
5149 the way to the frame edge so that the reverse video extends
5150 all the way across. */
5151 while (nlen
< FRAME_WIDTH (frame
) - 1)
5152 nbody
[nlen
++] = space_glyph
;
5155 /* If there's no i/d char, quickly do the best we can without it. */
5156 if (!char_ins_del_ok
)
5160 /* Find the first glyph in desired row that doesn't agree with
5161 a glyph in the current row, and write the rest from there on. */
5162 for (i
= 0; i
< nlen
; i
++)
5164 if (i
>= olen
|| !GLYPH_EQUAL_P (nbody
+ i
, obody
+ i
))
5166 /* Find the end of the run of different glyphs. */
5170 || !GLYPH_EQUAL_P (nbody
+ j
, obody
+ j
)
5171 || CHAR_GLYPH_PADDING_P (nbody
[j
])))
5174 /* Output this run of non-matching chars. */
5175 cursor_to (vpos
, i
);
5176 write_glyphs (nbody
+ i
, j
- i
);
5179 /* Now find the next non-match. */
5183 /* Clear the rest of the line, or the non-clear part of it. */
5186 cursor_to (vpos
, nlen
);
5187 clear_end_of_line (olen
);
5190 /* Make current row = desired row. */
5191 make_current (desired_matrix
, current_matrix
, vpos
);
5195 /* Here when CHAR_INS_DEL_OK != 0, i.e. we can insert or delete
5196 characters in a row. */
5200 /* If current line is blank, skip over initial spaces, if
5201 possible, and write the rest. */
5202 if (must_write_spaces
|| desired_row
->inverse_p
)
5205 nsp
= count_blanks (nbody
, nlen
);
5209 cursor_to (vpos
, nsp
);
5210 write_glyphs (nbody
+ nsp
, nlen
- nsp
);
5213 /* Exchange contents between current_frame and new_frame. */
5214 make_current (desired_matrix
, current_matrix
, vpos
);
5218 /* Compute number of leading blanks in old and new contents. */
5219 osp
= count_blanks (obody
, olen
);
5220 nsp
= desired_row
->inverse_p
? 0 : count_blanks (nbody
, nlen
);
5222 /* Compute number of matching chars starting with first non-blank. */
5223 begmatch
= count_match (obody
+ osp
, obody
+ olen
,
5224 nbody
+ nsp
, nbody
+ nlen
);
5226 /* Spaces in new match implicit space past the end of old. */
5227 /* A bug causing this to be a no-op was fixed in 18.29. */
5228 if (!must_write_spaces
&& osp
+ begmatch
== olen
)
5231 while (np1
+ begmatch
< nend
&& CHAR_GLYPH_SPACE_P (np1
[begmatch
]))
5235 /* Avoid doing insert/delete char
5236 just cause number of leading spaces differs
5237 when the following text does not match. */
5238 if (begmatch
== 0 && osp
!= nsp
)
5239 osp
= nsp
= min (osp
, nsp
);
5241 /* Find matching characters at end of line */
5244 op2
= op1
+ begmatch
- min (olen
- osp
, nlen
- nsp
);
5246 && GLYPH_EQUAL_P (op1
- 1, np1
- 1))
5251 endmatch
= obody
+ olen
- op1
;
5253 /* tem gets the distance to insert or delete.
5254 endmatch is how many characters we save by doing so.
5257 tem
= (nlen
- nsp
) - (olen
- osp
);
5259 && (!char_ins_del_ok
|| endmatch
<= char_ins_del_cost (frame
)[tem
]))
5262 /* nsp - osp is the distance to insert or delete.
5263 If that is nonzero, begmatch is known to be nonzero also.
5264 begmatch + endmatch is how much we save by doing the ins/del.
5268 && (!char_ins_del_ok
5269 || begmatch
+ endmatch
<= char_ins_del_cost (frame
)[nsp
- osp
]))
5273 osp
= nsp
= min (osp
, nsp
);
5276 /* Now go through the line, inserting, writing and
5277 deleting as appropriate. */
5281 cursor_to (vpos
, nsp
);
5282 delete_glyphs (osp
- nsp
);
5286 /* If going to delete chars later in line
5287 and insert earlier in the line,
5288 must delete first to avoid losing data in the insert */
5289 if (endmatch
&& nlen
< olen
+ nsp
- osp
)
5291 cursor_to (vpos
, nlen
- endmatch
+ osp
- nsp
);
5292 delete_glyphs (olen
+ nsp
- osp
- nlen
);
5293 olen
= nlen
- (nsp
- osp
);
5295 cursor_to (vpos
, osp
);
5296 insert_glyphs (0, nsp
- osp
);
5300 tem
= nsp
+ begmatch
+ endmatch
;
5301 if (nlen
!= tem
|| olen
!= tem
)
5303 cursor_to (vpos
, nsp
+ begmatch
);
5304 if (!endmatch
|| nlen
== olen
)
5306 /* If new text being written reaches right margin,
5307 there is no need to do clear-to-eol at the end.
5308 (and it would not be safe, since cursor is not
5309 going to be "at the margin" after the text is done) */
5310 if (nlen
== FRAME_WINDOW_WIDTH (frame
))
5312 write_glyphs (nbody
+ nsp
+ begmatch
, nlen
- tem
);
5314 else if (nlen
> olen
)
5316 /* Here, we used to have the following simple code:
5317 ----------------------------------------
5318 write_glyphs (nbody + nsp + begmatch, olen - tem);
5319 insert_glyphs (nbody + nsp + begmatch + olen - tem, nlen - olen);
5320 ----------------------------------------
5321 but it doesn't work if nbody[nsp + begmatch + olen - tem]
5322 is a padding glyph. */
5323 int out
= olen
- tem
; /* Columns to be overwritten originally. */
5326 /* Calculate columns we can actually overwrite. */
5327 while (CHAR_GLYPH_PADDING_P (nbody
[nsp
+ begmatch
+ out
])) out
--;
5328 write_glyphs (nbody
+ nsp
+ begmatch
, out
);
5329 /* If we left columns to be overwritten, we must delete them. */
5330 del
= olen
- tem
- out
;
5331 if (del
> 0) delete_glyphs (del
);
5332 /* At last, we insert columns not yet written out. */
5333 insert_glyphs (nbody
+ nsp
+ begmatch
+ out
, nlen
- olen
+ del
);
5336 else if (olen
> nlen
)
5338 write_glyphs (nbody
+ nsp
+ begmatch
, nlen
- tem
);
5339 delete_glyphs (olen
- nlen
);
5345 /* If any unerased characters remain after the new line, erase them. */
5348 cursor_to (vpos
, nlen
);
5349 clear_end_of_line (olen
);
5352 /* Exchange contents between current_frame and new_frame. */
5353 make_current (desired_matrix
, current_matrix
, vpos
);
5358 /***********************************************************************
5359 X/Y Position -> Buffer Position
5360 ***********************************************************************/
5362 /* Return the character position of the character at window relative
5363 pixel position (*X, *Y). *X and *Y are adjusted to character
5367 buffer_posn_from_coords (w
, x
, y
)
5372 struct buffer
*old_current_buffer
= current_buffer
;
5373 struct text_pos startp
;
5374 int left_area_width
;
5376 current_buffer
= XBUFFER (w
->buffer
);
5377 SET_TEXT_POS_FROM_MARKER (startp
, w
->start
);
5378 CHARPOS (startp
) = min (ZV
, max (BEGV
, CHARPOS (startp
)));
5379 BYTEPOS (startp
) = min (ZV_BYTE
, max (BEGV_BYTE
, BYTEPOS (startp
)));
5380 start_display (&it
, w
, startp
);
5382 left_area_width
= WINDOW_DISPLAY_LEFT_AREA_PIXEL_WIDTH (w
);
5383 move_it_to (&it
, -1, *x
+ it
.first_visible_x
- left_area_width
, *y
, -1,
5384 MOVE_TO_X
| MOVE_TO_Y
);
5386 *x
= it
.current_x
- it
.first_visible_x
+ left_area_width
;
5388 current_buffer
= old_current_buffer
;
5389 return IT_CHARPOS (it
);
5393 /* Value is the string under window-relative coordinates X/Y in the
5394 mode or top line of window W, or nil if none. MODE_LINE_P non-zero
5395 means look at the mode line. *CHARPOS is set to the position in
5396 the string returned. */
5399 mode_line_string (w
, x
, y
, mode_line_p
, charpos
)
5401 int x
, y
, mode_line_p
;
5404 struct glyph_row
*row
;
5405 struct glyph
*glyph
, *end
;
5406 struct frame
*f
= XFRAME (w
->frame
);
5408 Lisp_Object string
= Qnil
;
5411 row
= MATRIX_MODE_LINE_ROW (w
->current_matrix
);
5413 row
= MATRIX_HEADER_LINE_ROW (w
->current_matrix
);
5415 if (row
->mode_line_p
&& row
->enabled_p
)
5417 /* The mode lines are displayed over scroll bars and bitmap
5418 areas, and X is window-relative. Correct X by the scroll bar
5419 and bitmap area width. */
5420 if (FRAME_HAS_VERTICAL_SCROLL_BARS_ON_LEFT (f
))
5421 x
+= FRAME_SCROLL_BAR_COLS (f
) * CANON_X_UNIT (f
);
5422 x
+= FRAME_LEFT_FLAGS_AREA_WIDTH (f
);
5424 /* Find the glyph under X. If we find one with a string object,
5425 it's the one we were looking for. */
5426 glyph
= row
->glyphs
[TEXT_AREA
];
5427 end
= glyph
+ row
->used
[TEXT_AREA
];
5428 for (x0
= 0; glyph
< end
; x0
+= glyph
->pixel_width
, ++glyph
)
5429 if (x
>= x0
&& x
< x0
+ glyph
->pixel_width
)
5431 string
= glyph
->object
;
5432 *charpos
= glyph
->charpos
;
5441 /***********************************************************************
5442 Changing Frame Sizes
5443 ***********************************************************************/
5448 window_change_signal (signalnum
) /* If we don't have an argument, */
5449 int signalnum
; /* some compilers complain in signal calls. */
5455 int old_errno
= errno
;
5457 get_frame_size (&width
, &height
);
5459 /* The frame size change obviously applies to a termcap-controlled
5460 frame. Find such a frame in the list, and assume it's the only
5461 one (since the redisplay code always writes to stdout, not a
5462 FILE * specified in the frame structure). Record the new size,
5463 but don't reallocate the data structures now. Let that be done
5464 later outside of the signal handler. */
5467 Lisp_Object tail
, frame
;
5469 FOR_EACH_FRAME (tail
, frame
)
5471 if (FRAME_TERMCAP_P (XFRAME (frame
)))
5473 change_frame_size (XFRAME (frame
), height
, width
, 0, 1, 0);
5479 signal (SIGWINCH
, window_change_signal
);
5482 #endif /* SIGWINCH */
5485 /* Do any change in frame size that was requested by a signal. SAFE
5486 non-zero means this function is called from a place where it is
5487 safe to change frame sizes while a redisplay is in progress. */
5490 do_pending_window_change (safe
)
5493 /* If window_change_signal should have run before, run it now. */
5494 if (redisplaying_p
&& !safe
)
5497 while (delayed_size_change
)
5499 Lisp_Object tail
, frame
;
5501 delayed_size_change
= 0;
5503 FOR_EACH_FRAME (tail
, frame
)
5505 struct frame
*f
= XFRAME (frame
);
5507 int height
= FRAME_NEW_HEIGHT (f
);
5508 int width
= FRAME_NEW_WIDTH (f
);
5510 if (height
!= 0 || width
!= 0)
5511 change_frame_size (f
, height
, width
, 0, 0, safe
);
5517 /* Change the frame height and/or width. Values may be given as zero to
5518 indicate no change is to take place.
5520 If DELAY is non-zero, then assume we're being called from a signal
5521 handler, and queue the change for later - perhaps the next
5522 redisplay. Since this tries to resize windows, we can't call it
5523 from a signal handler.
5525 SAFE non-zero means this function is called from a place where it's
5526 safe to change frame sizes while a redisplay is in progress. */
5529 change_frame_size (f
, newheight
, newwidth
, pretend
, delay
, safe
)
5530 register struct frame
*f
;
5531 int newheight
, newwidth
, pretend
, delay
, safe
;
5533 Lisp_Object tail
, frame
;
5535 if (! FRAME_WINDOW_P (f
))
5537 /* When using termcap, or on MS-DOS, all frames use
5538 the same screen, so a change in size affects all frames. */
5539 FOR_EACH_FRAME (tail
, frame
)
5540 if (! FRAME_WINDOW_P (XFRAME (frame
)))
5541 change_frame_size_1 (XFRAME (frame
), newheight
, newwidth
,
5542 pretend
, delay
, safe
);
5545 change_frame_size_1 (f
, newheight
, newwidth
, pretend
, delay
, safe
);
5549 change_frame_size_1 (f
, newheight
, newwidth
, pretend
, delay
, safe
)
5550 register struct frame
*f
;
5551 int newheight
, newwidth
, pretend
, delay
, safe
;
5553 int new_frame_window_width
;
5554 int count
= specpdl_ptr
- specpdl
;
5556 /* If we can't deal with the change now, queue it for later. */
5557 if (delay
|| (redisplaying_p
&& !safe
))
5559 FRAME_NEW_HEIGHT (f
) = newheight
;
5560 FRAME_NEW_WIDTH (f
) = newwidth
;
5561 delayed_size_change
= 1;
5565 /* This size-change overrides any pending one for this frame. */
5566 FRAME_NEW_HEIGHT (f
) = 0;
5567 FRAME_NEW_WIDTH (f
) = 0;
5569 /* If an argument is zero, set it to the current value. */
5571 newheight
= FRAME_HEIGHT (f
);
5573 newwidth
= FRAME_WIDTH (f
);
5575 /* Compute width of windows in F.
5576 This is the width of the frame without vertical scroll bars. */
5577 new_frame_window_width
= FRAME_WINDOW_WIDTH_ARG (f
, newwidth
);
5579 /* Round up to the smallest acceptable size. */
5580 check_frame_size (f
, &newheight
, &newwidth
);
5582 /* If we're not changing the frame size, quit now. */
5583 if (newheight
== FRAME_HEIGHT (f
)
5584 && new_frame_window_width
== FRAME_WINDOW_WIDTH (f
))
5590 /* We only can set screen dimensions to certain values supported
5591 by our video hardware. Try to find the smallest size greater
5592 or equal to the requested dimensions. */
5593 dos_set_window_size (&newheight
, &newwidth
);
5596 if (newheight
!= FRAME_HEIGHT (f
))
5598 if (FRAME_HAS_MINIBUF_P (f
) && !FRAME_MINIBUF_ONLY_P (f
))
5600 /* Frame has both root and mini-buffer. */
5601 XSETFASTINT (XWINDOW (FRAME_ROOT_WINDOW (f
))->top
,
5602 FRAME_TOP_MARGIN (f
));
5603 set_window_height (FRAME_ROOT_WINDOW (f
),
5606 - FRAME_TOP_MARGIN (f
)),
5608 XSETFASTINT (XWINDOW (FRAME_MINIBUF_WINDOW (f
))->top
,
5610 set_window_height (FRAME_MINIBUF_WINDOW (f
), 1, 0);
5613 /* Frame has just one top-level window. */
5614 set_window_height (FRAME_ROOT_WINDOW (f
),
5615 newheight
- FRAME_TOP_MARGIN (f
), 0);
5617 if (FRAME_TERMCAP_P (f
) && !pretend
)
5618 FrameRows
= newheight
;
5621 if (new_frame_window_width
!= FRAME_WINDOW_WIDTH (f
))
5623 set_window_width (FRAME_ROOT_WINDOW (f
), new_frame_window_width
, 0);
5624 if (FRAME_HAS_MINIBUF_P (f
))
5625 set_window_width (FRAME_MINIBUF_WINDOW (f
), new_frame_window_width
, 0);
5627 if (FRAME_TERMCAP_P (f
) && !pretend
)
5628 FrameCols
= newwidth
;
5630 if (WINDOWP (f
->tool_bar_window
))
5631 XSETFASTINT (XWINDOW (f
->tool_bar_window
)->width
, newwidth
);
5634 FRAME_HEIGHT (f
) = newheight
;
5635 SET_FRAME_WIDTH (f
, newwidth
);
5638 struct window
*w
= XWINDOW (FRAME_SELECTED_WINDOW (f
));
5639 int text_area_x
, text_area_y
, text_area_width
, text_area_height
;
5641 window_box (w
, TEXT_AREA
, &text_area_x
, &text_area_y
, &text_area_width
,
5643 if (w
->cursor
.x
>= text_area_x
+ text_area_width
)
5644 w
->cursor
.hpos
= w
->cursor
.x
= 0;
5645 if (w
->cursor
.y
>= text_area_y
+ text_area_height
)
5646 w
->cursor
.vpos
= w
->cursor
.y
= 0;
5650 SET_FRAME_GARBAGED (f
);
5651 calculate_costs (f
);
5655 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
5657 /* This isn't quite a no-op: it runs window-configuration-change-hook. */
5658 Fset_window_buffer (FRAME_SELECTED_WINDOW (f
),
5659 XWINDOW (FRAME_SELECTED_WINDOW (f
))->buffer
);
5661 unbind_to (count
, Qnil
);
5666 /***********************************************************************
5667 Terminal Related Lisp Functions
5668 ***********************************************************************/
5670 DEFUN ("open-termscript", Fopen_termscript
, Sopen_termscript
,
5671 1, 1, "FOpen termscript file: ",
5672 "Start writing all terminal output to FILE as well as the terminal.\n\
5673 FILE = nil means just close any termscript file currently open.")
5677 if (termscript
!= 0) fclose (termscript
);
5682 file
= Fexpand_file_name (file
, Qnil
);
5683 termscript
= fopen (XSTRING (file
)->data
, "w");
5684 if (termscript
== 0)
5685 report_file_error ("Opening termscript", Fcons (file
, Qnil
));
5691 DEFUN ("send-string-to-terminal", Fsend_string_to_terminal
,
5692 Ssend_string_to_terminal
, 1, 1, 0,
5693 "Send STRING to the terminal without alteration.\n\
5694 Control characters in STRING will have terminal-dependent effects.")
5698 /* ??? Perhaps we should do something special for multibyte strings here. */
5699 CHECK_STRING (string
, 0);
5700 fwrite (XSTRING (string
)->data
, 1, STRING_BYTES (XSTRING (string
)), stdout
);
5704 fwrite (XSTRING (string
)->data
, 1, STRING_BYTES (XSTRING (string
)),
5706 fflush (termscript
);
5712 DEFUN ("ding", Fding
, Sding
, 0, 1, 0,
5713 "Beep, or flash the screen.\n\
5714 Also, unless an argument is given,\n\
5715 terminate any keyboard macro currently executing.")
5738 else if (!INTERACTIVE
) /* Stop executing a keyboard macro. */
5739 error ("Keyboard macro terminated by a command ringing the bell");
5747 /***********************************************************************
5749 ***********************************************************************/
5751 DEFUN ("sleep-for", Fsleep_for
, Ssleep_for
, 1, 2, 0,
5752 "Pause, without updating display, for SECONDS seconds.\n\
5753 SECONDS may be a floating-point value, meaning that you can wait for a\n\
5754 fraction of a second. Optional second arg MILLISECONDS specifies an\n\
5755 additional wait period, in milliseconds; this may be useful if your\n\
5756 Emacs was built without floating point support.\n\
5757 \(Not all operating systems support waiting for a fraction of a second.)")
5758 (seconds
, milliseconds
)
5759 Lisp_Object seconds
, milliseconds
;
5763 if (NILP (milliseconds
))
5764 XSETINT (milliseconds
, 0);
5766 CHECK_NUMBER (milliseconds
, 1);
5767 usec
= XINT (milliseconds
) * 1000;
5770 double duration
= extract_float (seconds
);
5771 sec
= (int) duration
;
5772 usec
+= (duration
- sec
) * 1000000;
5775 #ifndef EMACS_HAS_USECS
5776 if (sec
== 0 && usec
!= 0)
5777 error ("millisecond `sleep-for' not supported on %s", SYSTEM_TYPE
);
5780 /* Assure that 0 <= usec < 1000000. */
5783 /* We can't rely on the rounding being correct if user is negative. */
5784 if (-1000000 < usec
)
5785 sec
--, usec
+= 1000000;
5787 sec
-= -usec
/ 1000000, usec
= 1000000 - (-usec
% 1000000);
5790 sec
+= usec
/ 1000000, usec
%= 1000000;
5792 if (sec
< 0 || (sec
== 0 && usec
== 0))
5798 XSETFASTINT (zero
, 0);
5799 wait_reading_process_input (sec
, usec
, zero
, 0);
5802 /* We should always have wait_reading_process_input; we have a dummy
5803 implementation for systems which don't support subprocesses. */
5805 /* No wait_reading_process_input */
5812 /* The reason this is done this way
5813 (rather than defined (H_S) && defined (H_T))
5814 is because the VMS preprocessor doesn't grok `defined' */
5816 EMACS_GET_TIME (end_time
);
5817 EMACS_SET_SECS_USECS (timeout
, sec
, usec
);
5818 EMACS_ADD_TIME (end_time
, end_time
, timeout
);
5822 EMACS_GET_TIME (timeout
);
5823 EMACS_SUB_TIME (timeout
, end_time
, timeout
);
5824 if (EMACS_TIME_NEG_P (timeout
)
5825 || !select (1, 0, 0, 0, &timeout
))
5828 #else /* not HAVE_SELECT */
5830 #endif /* HAVE_SELECT */
5831 #endif /* not VMS */
5834 #endif /* no subprocesses */
5840 /* This is just like wait_reading_process_input, except that
5841 it does the redisplay.
5843 It's also much like Fsit_for, except that it can be used for
5844 waiting for input as well. */
5847 sit_for (sec
, usec
, reading
, display
, initial_display
)
5848 int sec
, usec
, reading
, display
, initial_display
;
5850 Lisp_Object read_kbd
;
5852 swallow_events (display
);
5854 if (detect_input_pending_run_timers (display
))
5857 if (initial_display
)
5858 redisplay_preserve_echo_area ();
5860 if (sec
== 0 && usec
== 0)
5867 XSETINT (read_kbd
, reading
? -1 : 1);
5868 wait_reading_process_input (sec
, usec
, read_kbd
, display
);
5870 return detect_input_pending () ? Qnil
: Qt
;
5874 DEFUN ("sit-for", Fsit_for
, Ssit_for
, 1, 3, 0,
5875 "Perform redisplay, then wait for SECONDS seconds or until input is available.\n\
5876 SECONDS may be a floating-point value, meaning that you can wait for a\n\
5877 fraction of a second. Optional second arg MILLISECONDS specifies an\n\
5878 additional wait period, in milliseconds; this may be useful if your\n\
5879 Emacs was built without floating point support.\n\
5880 \(Not all operating systems support waiting for a fraction of a second.)\n\
5881 Optional third arg NODISP non-nil means don't redisplay, just wait for input.\n\
5882 Redisplay is preempted as always if input arrives, and does not happen\n\
5883 if input is available before it starts.\n\
5884 Value is t if waited the full time with no input arriving.")
5885 (seconds
, milliseconds
, nodisp
)
5886 Lisp_Object seconds
, milliseconds
, nodisp
;
5890 if (NILP (milliseconds
))
5891 XSETINT (milliseconds
, 0);
5893 CHECK_NUMBER (milliseconds
, 1);
5894 usec
= XINT (milliseconds
) * 1000;
5897 double duration
= extract_float (seconds
);
5898 sec
= (int) duration
;
5899 usec
+= (duration
- sec
) * 1000000;
5902 #ifndef EMACS_HAS_USECS
5903 if (usec
!= 0 && sec
== 0)
5904 error ("millisecond `sit-for' not supported on %s", SYSTEM_TYPE
);
5907 return sit_for (sec
, usec
, 0, NILP (nodisp
), NILP (nodisp
));
5912 /***********************************************************************
5913 Other Lisp Functions
5914 ***********************************************************************/
5916 /* A vector of size >= 2 * NFRAMES + 3 * NBUFFERS + 1, containing the
5917 session's frames, frame names, buffers, buffer-read-only flags, and
5918 buffer-modified-flags, and a trailing sentinel (so we don't need to
5919 add length checks). */
5921 static Lisp_Object frame_and_buffer_state
;
5924 DEFUN ("frame-or-buffer-changed-p", Fframe_or_buffer_changed_p
,
5925 Sframe_or_buffer_changed_p
, 0, 0, 0,
5926 "Return non-nil if the frame and buffer state appears to have changed.\n\
5927 The state variable is an internal vector containing all frames and buffers,\n\
5928 aside from buffers whose names start with space,\n\
5929 along with the buffers' read-only and modified flags, which allows a fast\n\
5930 check to see whether the menu bars might need to be recomputed.\n\
5931 If this function returns non-nil, it updates the internal vector to reflect\n\
5932 the current state.\n")
5935 Lisp_Object tail
, frame
, buf
;
5939 vecp
= XVECTOR (frame_and_buffer_state
)->contents
;
5940 FOR_EACH_FRAME (tail
, frame
)
5942 if (!EQ (*vecp
++, frame
))
5944 if (!EQ (*vecp
++, XFRAME (frame
)->name
))
5947 /* Check that the buffer info matches.
5948 No need to test for the end of the vector
5949 because the last element of the vector is lambda
5950 and that will always cause a mismatch. */
5951 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCDR (tail
))
5953 buf
= XCDR (XCAR (tail
));
5954 /* Ignore buffers that aren't included in buffer lists. */
5955 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
5957 if (!EQ (*vecp
++, buf
))
5959 if (!EQ (*vecp
++, XBUFFER (buf
)->read_only
))
5961 if (!EQ (*vecp
++, Fbuffer_modified_p (buf
)))
5964 /* Detect deletion of a buffer at the end of the list. */
5965 if (EQ (*vecp
, Qlambda
))
5968 /* Start with 1 so there is room for at least one lambda at the end. */
5970 FOR_EACH_FRAME (tail
, frame
)
5972 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCDR (tail
))
5974 /* Reallocate the vector if it's grown, or if it's shrunk a lot. */
5975 if (n
> XVECTOR (frame_and_buffer_state
)->size
5976 || n
+ 20 < XVECTOR (frame_and_buffer_state
)->size
/ 2)
5977 /* Add 20 extra so we grow it less often. */
5978 frame_and_buffer_state
= Fmake_vector (make_number (n
+ 20), Qlambda
);
5979 vecp
= XVECTOR (frame_and_buffer_state
)->contents
;
5980 FOR_EACH_FRAME (tail
, frame
)
5983 *vecp
++ = XFRAME (frame
)->name
;
5985 for (tail
= Vbuffer_alist
; CONSP (tail
); tail
= XCDR (tail
))
5987 buf
= XCDR (XCAR (tail
));
5988 /* Ignore buffers that aren't included in buffer lists. */
5989 if (XSTRING (XBUFFER (buf
)->name
)->data
[0] == ' ')
5992 *vecp
++ = XBUFFER (buf
)->read_only
;
5993 *vecp
++ = Fbuffer_modified_p (buf
);
5995 /* Fill up the vector with lambdas (always at least one). */
5997 while (vecp
- XVECTOR (frame_and_buffer_state
)->contents
5998 < XVECTOR (frame_and_buffer_state
)->size
)
6000 /* Make sure we didn't overflow the vector. */
6001 if (vecp
- XVECTOR (frame_and_buffer_state
)->contents
6002 > XVECTOR (frame_and_buffer_state
)->size
)
6009 /***********************************************************************
6011 ***********************************************************************/
6013 char *terminal_type
;
6015 /* Initialization done when Emacs fork is started, before doing stty.
6016 Determine terminal type and set terminal_driver. Then invoke its
6017 decoding routine to set up variables in the terminal package. */
6022 #ifdef HAVE_X_WINDOWS
6023 extern int display_arg
;
6026 /* Construct the space glyph. */
6027 space_glyph
.type
= CHAR_GLYPH
;
6028 SET_CHAR_GLYPH_FROM_GLYPH (space_glyph
, ' ');
6029 space_glyph
.charpos
= -1;
6033 cursor_in_echo_area
= 0;
6034 terminal_type
= (char *) 0;
6036 /* Now is the time to initialize this; it's used by init_sys_modes
6038 Vwindow_system
= Qnil
;
6040 /* If the user wants to use a window system, we shouldn't bother
6041 initializing the terminal. This is especially important when the
6042 terminal is so dumb that emacs gives up before and doesn't bother
6043 using the window system.
6045 If the DISPLAY environment variable is set and nonempty,
6046 try to use X, and die with an error message if that doesn't work. */
6048 #ifdef HAVE_X_WINDOWS
6053 display
= getenv ("DECW$DISPLAY");
6055 display
= getenv ("DISPLAY");
6058 display_arg
= (display
!= 0 && *display
!= 0);
6061 if (!inhibit_window_system
&& display_arg
6067 Vwindow_system
= intern ("x");
6069 Vwindow_system_version
= make_number (11);
6071 Vwindow_system_version
= make_number (10);
6073 #if defined (LINUX) && defined (HAVE_LIBNCURSES)
6074 /* In some versions of ncurses,
6075 tputs crashes if we have not called tgetent.
6077 { char b
[2044]; tgetent (b
, "xterm");}
6079 adjust_frame_glyphs_initially ();
6082 #endif /* HAVE_X_WINDOWS */
6085 if (!inhibit_window_system
)
6087 Vwindow_system
= intern ("w32");
6088 Vwindow_system_version
= make_number (1);
6089 adjust_frame_glyphs_initially ();
6092 #endif /* HAVE_NTGUI */
6095 if (!inhibit_window_system
)
6097 Vwindow_system
= intern ("mac");
6098 Vwindow_system_version
= make_number (1);
6099 adjust_frame_glyphs_initially ();
6102 #endif /* macintosh */
6104 /* If no window system has been specified, try to use the terminal. */
6107 fatal ("standard input is not a tty");
6111 /* Look at the TERM variable */
6112 terminal_type
= (char *) getenv ("TERM");
6116 fprintf (stderr
, "Please specify your terminal type.\n\
6117 For types defined in VMS, use set term /device=TYPE.\n\
6118 For types not defined in VMS, use define emacs_term \"TYPE\".\n\
6119 \(The quotation marks are necessary since terminal types are lower case.)\n");
6121 fprintf (stderr
, "Please set the environment variable TERM; see tset(1).\n");
6127 /* VMS DCL tends to up-case things, so down-case term type.
6128 Hardly any uppercase letters in terminal types; should be none. */
6130 char *new = (char *) xmalloc (strlen (terminal_type
) + 1);
6133 strcpy (new, terminal_type
);
6135 for (p
= new; *p
; p
++)
6139 terminal_type
= new;
6143 term_init (terminal_type
);
6146 struct frame
*sf
= SELECTED_FRAME ();
6147 int width
= FRAME_WINDOW_WIDTH (sf
);
6148 int height
= FRAME_HEIGHT (sf
);
6150 unsigned int total_glyphs
= height
* (width
+ 2) * sizeof (struct glyph
);
6152 /* If these sizes are so big they cause overflow, just ignore the
6153 change. It's not clear what better we could do. */
6154 if (total_glyphs
/ sizeof (struct glyph
) / height
!= width
+ 2)
6155 fatal ("screen size %dx%d too big", width
, height
);
6158 adjust_frame_glyphs_initially ();
6159 calculate_costs (XFRAME (selected_frame
));
6164 #endif /* CANNOT_DUMP */
6165 signal (SIGWINCH
, window_change_signal
);
6166 #endif /* SIGWINCH */
6168 /* Set up faces of the initial terminal frame of a dumped Emacs. */
6172 /* The MSDOS terminal turns on its ``window system'' relatively
6173 late into the startup, so we cannot do the frame faces'
6174 initialization just yet. It will be done later by pc-win.el
6175 and internal_terminal_init. */
6176 && (strcmp (terminal_type
, "internal") != 0 || inhibit_window_system
)
6178 && NILP (Vwindow_system
))
6180 /* For the initial frame, we don't have any way of knowing what
6181 are the foreground and background colors of the terminal. */
6182 struct frame
*sf
= SELECTED_FRAME();
6184 FRAME_FOREGROUND_PIXEL (sf
) = FACE_TTY_DEFAULT_FG_COLOR
;
6185 FRAME_BACKGROUND_PIXEL (sf
) = FACE_TTY_DEFAULT_BG_COLOR
;
6186 call0 (intern ("tty-set-up-initial-frame-faces"));
6192 /***********************************************************************
6194 ***********************************************************************/
6196 DEFUN ("internal-show-cursor", Finternal_show_cursor
,
6197 Sinternal_show_cursor
, 2, 2, 0,
6198 "Set the cursor-visibility flag of WINDOW to SHOW.\n\
6199 WINDOW nil means use the selected window. SHOW non-nil means\n\
6200 show a cursor in WINDOW in the next redisplay. SHOW nil means\n\
6201 don't show a cursor.")
6203 Lisp_Object window
, show
;
6205 /* Don't change cursor state while redisplaying. This could confuse
6207 if (!redisplaying_p
)
6210 window
= selected_window
;
6212 CHECK_WINDOW (window
, 2);
6214 XWINDOW (window
)->cursor_off_p
= NILP (show
);
6221 DEFUN ("internal-show-cursor-p", Finternal_show_cursor_p
,
6222 Sinternal_show_cursor_p
, 0, 1, 0,
6223 "Value is non-nil if next redisplay will display a cursor in WINDOW.\n\
6224 WINDOW nil or omitted means report on the selected window.")
6231 window
= selected_window
;
6233 CHECK_WINDOW (window
, 2);
6235 w
= XWINDOW (window
);
6236 return w
->cursor_off_p
? Qnil
: Qt
;
6240 /***********************************************************************
6242 ***********************************************************************/
6247 defsubr (&Sredraw_frame
);
6248 defsubr (&Sredraw_display
);
6249 defsubr (&Sframe_or_buffer_changed_p
);
6250 defsubr (&Sopen_termscript
);
6252 defsubr (&Ssit_for
);
6253 defsubr (&Ssleep_for
);
6254 defsubr (&Ssend_string_to_terminal
);
6255 defsubr (&Sinternal_show_cursor
);
6256 defsubr (&Sinternal_show_cursor_p
);
6258 frame_and_buffer_state
= Fmake_vector (make_number (20), Qlambda
);
6259 staticpro (&frame_and_buffer_state
);
6261 Qdisplay_table
= intern ("display-table");
6262 staticpro (&Qdisplay_table
);
6263 Qredisplay_dont_pause
= intern ("redisplay-dont-pause");
6264 staticpro (&Qredisplay_dont_pause
);
6266 DEFVAR_INT ("baud-rate", &baud_rate
,
6267 "*The output baud rate of the terminal.\n\
6268 On most systems, changing this value will affect the amount of padding\n\
6269 and the other strategic decisions made during redisplay.");
6271 DEFVAR_BOOL ("inverse-video", &inverse_video
,
6272 "*Non-nil means invert the entire frame display.\n\
6273 This means everything is in inverse video which otherwise would not be.");
6275 DEFVAR_BOOL ("visible-bell", &visible_bell
,
6276 "*Non-nil means try to flash the frame to represent a bell.");
6278 DEFVAR_BOOL ("no-redraw-on-reenter", &no_redraw_on_reenter
,
6279 "*Non-nil means no need to redraw entire frame after suspending.\n\
6280 A non-nil value is useful if the terminal can automatically preserve\n\
6281 Emacs's frame display when you reenter Emacs.\n\
6282 It is up to you to set this variable if your terminal can do that.");
6284 DEFVAR_LISP ("window-system", &Vwindow_system
,
6285 "A symbol naming the window-system under which Emacs is running\n\
6286 \(such as `x'), or nil if emacs is running on an ordinary terminal.");
6288 DEFVAR_LISP ("window-system-version", &Vwindow_system_version
,
6289 "The version number of the window system in use.\n\
6290 For X windows, this is 10 or 11.");
6292 DEFVAR_BOOL ("cursor-in-echo-area", &cursor_in_echo_area
,
6293 "Non-nil means put cursor in minibuffer, at end of any message there.");
6295 DEFVAR_LISP ("glyph-table", &Vglyph_table
,
6296 "Table defining how to output a glyph code to the frame.\n\
6297 If not nil, this is a vector indexed by glyph code to define the glyph.\n\
6298 Each element can be:\n\
6299 integer: a glyph code which this glyph is an alias for.\n\
6300 string: output this glyph using that string (not impl. in X windows).\n\
6301 nil: this glyph mod 256 is char code to output,\n\
6302 and this glyph / 256 is face code for X windows (see `face-id').");
6303 Vglyph_table
= Qnil
;
6305 DEFVAR_LISP ("standard-display-table", &Vstandard_display_table
,
6306 "Display table to use for buffers that specify none.\n\
6307 See `buffer-display-table' for more information.");
6308 Vstandard_display_table
= Qnil
;
6310 DEFVAR_BOOL ("redisplay-dont-pause", &redisplay_dont_pause
,
6311 "*Non-nil means update isn't paused when input is detected.");
6312 redisplay_dont_pause
= 0;
6314 /* Initialize `window-system', unless init_display already decided it. */
6319 Vwindow_system
= Qnil
;
6320 Vwindow_system_version
= Qnil
;