Improve responsiveness while in 'replace-buffer-contents'
[emacs.git] / src / fringe.c
blob34bc5db06d161cdc2b524c191280d0778c06a648
1 /* Fringe handling (split from xdisp.c).
2 Copyright (C) 1985-1988, 1993-1995, 1997-2018 Free Software
3 Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or (at
10 your option) any later version.
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. If not, see <https://www.gnu.org/licenses/>. */
20 #include <config.h>
21 #include <stdio.h>
23 #include <byteswap.h>
25 #include "lisp.h"
26 #include "frame.h"
27 #include "window.h"
28 #include "dispextern.h"
29 #include "buffer.h"
30 #include "blockinput.h"
31 #include "termhooks.h"
33 /* Fringe bitmaps are represented in three different ways:
35 Logical bitmaps are used internally to denote things like
36 'end-of-buffer', 'left-truncation', 'overlay-arrow', etc.
38 Physical bitmaps specify the visual appearance of the bitmap,
39 e.g. 'bottom-left-angle', 'left-arrow', 'left-triangle', etc.
40 User defined bitmaps are physical bitmaps.
42 Internally, fringe bitmaps for a specific display row are
43 represented as a simple integer that is used as an index
44 into the table of all defined bitmaps. This index is stored
45 in the `fringe' property of the physical bitmap symbol.
47 Logical bitmaps are mapped to physical bitmaps through the
48 buffer-local `fringe-indicator-alist' variable.
50 Each element of this alist is a cons (LOGICAL . PHYSICAL)
51 mapping a logical bitmap to a physical bitmap.
52 PHYSICAL is either a symbol to use in both left and right fringe,
53 or a cons of two symbols (LEFT . RIGHT) denoting different
54 bitmaps to use in left and right fringe.
56 LOGICAL is first looked up in the window's buffer's buffer-local
57 value of the fringe-indicator-alist variable, and if not present,
58 in the global value of fringe-indicator-alist.
60 If LOGICAL is not present in either alist, or the PHYSICAL value
61 found is nil, no bitmap is shown for the logical bitmap.
63 The `left-fringe' and `right-fringe' display properties
64 must specify physical bitmap symbols.
67 enum fringe_bitmap_align
69 ALIGN_BITMAP_CENTER = 0,
70 ALIGN_BITMAP_TOP,
71 ALIGN_BITMAP_BOTTOM
74 struct fringe_bitmap
76 unsigned short *bits;
77 unsigned height : 8;
78 unsigned width : 8;
79 unsigned period : 8;
80 unsigned align : 2;
81 bool_bf dynamic : 1;
85 /***********************************************************************
86 Fringe bitmaps
87 ***********************************************************************/
89 /* Undefined bitmap. A question mark. */
91 ..xxxx..
92 .xxxxxx.
93 xx....xx
94 xx....xx
95 ....xx..
96 ...xx...
97 ...xx...
98 ........
99 ...xx...
100 ...xx...
102 static unsigned short question_mark_bits[] = {
103 0x3c, 0x7e, 0x7e, 0x0c, 0x18, 0x18, 0x00, 0x18, 0x18};
105 /* An exclamation mark. */
107 ...XX...
108 ...XX...
109 ...XX...
110 ...XX...
111 ...XX...
112 ...XX...
113 ...XX...
114 ........
115 ...XX...
116 ...XX...
118 static unsigned short exclamation_mark_bits[] = {
119 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00, 0x18};
121 /* An arrow like this: `<-'. */
123 ...xx...
124 ..xx....
125 .xx.....
126 xxxxxx..
127 xxxxxx..
128 .xx.....
129 ..xx....
130 ...xx...
132 static unsigned short left_arrow_bits[] = {
133 0x18, 0x30, 0x60, 0xfc, 0xfc, 0x60, 0x30, 0x18};
136 /* Right truncation arrow bitmap `->'. */
138 ...xx...
139 ....xx..
140 .....xx.
141 ..xxxxxx
142 ..xxxxxx
143 .....xx.
144 ....xx..
145 ...xx...
147 static unsigned short right_arrow_bits[] = {
148 0x18, 0x0c, 0x06, 0x3f, 0x3f, 0x06, 0x0c, 0x18};
151 /* Up arrow bitmap. */
153 ...xx...
154 ..xxxx..
155 .xxxxxx.
156 xxxxxxxx
157 ...xx...
158 ...xx...
159 ...xx...
160 ...xx...
162 static unsigned short up_arrow_bits[] = {
163 0x18, 0x3c, 0x7e, 0xff, 0x18, 0x18, 0x18, 0x18};
166 /* Down arrow bitmap. */
168 ...xx...
169 ...xx...
170 ...xx...
171 ...xx...
172 xxxxxxxx
173 .xxxxxx.
174 ..xxxx..
175 ...xx...
177 static unsigned short down_arrow_bits[] = {
178 0x18, 0x18, 0x18, 0x18, 0xff, 0x7e, 0x3c, 0x18};
180 /* Marker for continuation lines. */
182 ..xxxx..
183 .xxxxx..
184 xx......
185 xxx..x..
186 xxxxxx..
187 .xxxxx..
188 ..xxxx..
189 .xxxxx..
191 static unsigned short left_curly_arrow_bits[] = {
192 0x3c, 0x7c, 0xc0, 0xe4, 0xfc, 0x7c, 0x3c, 0x7c};
194 /* Marker for continued lines. */
196 ..xxxx..
197 ..xxxxx.
198 ......xx
199 ..x..xxx
200 ..xxxxxx
201 ..xxxxx.
202 ..xxxx..
203 ..xxxxx.
205 static unsigned short right_curly_arrow_bits[] = {
206 0x3c, 0x3e, 0x03, 0x27, 0x3f, 0x3e, 0x3c, 0x3e};
208 /* Reverse Overlay arrow bitmap. A triangular arrow. */
210 ......xx
211 ....xxxx
212 ...xxxxx
213 ..xxxxxx
214 ..xxxxxx
215 ...xxxxx
216 ....xxxx
217 ......xx
219 static unsigned short left_triangle_bits[] = {
220 0x03, 0x0f, 0x1f, 0x3f, 0x3f, 0x1f, 0x0f, 0x03};
222 /* Overlay arrow bitmap. A triangular arrow. */
224 xx......
225 xxxx....
226 xxxxx...
227 xxxxxx..
228 xxxxxx..
229 xxxxx...
230 xxxx....
231 xx......
233 static unsigned short right_triangle_bits[] = {
234 0xc0, 0xf0, 0xf8, 0xfc, 0xfc, 0xf8, 0xf0, 0xc0};
236 /* First line bitmap. An top-left angle. */
238 xxxxxx..
239 xxxxxx..
240 xx......
241 xx......
242 xx......
243 xx......
244 xx......
245 ........
247 static unsigned short top_left_angle_bits[] = {
248 0xfc, 0xfc, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0x00};
250 /* First line bitmap. An right-up angle. */
252 ..xxxxxx
253 ..xxxxxx
254 ......xx
255 ......xx
256 ......xx
257 ......xx
258 ......xx
259 ........
261 static unsigned short top_right_angle_bits[] = {
262 0x3f, 0x3f, 0x03, 0x03, 0x03, 0x03, 0x03, 0x00};
264 /* Last line bitmap. An left-down angle. */
266 ........
267 xx......
268 xx......
269 xx......
270 xx......
271 xx......
272 xxxxxx..
273 xxxxxx..
275 static unsigned short bottom_left_angle_bits[] = {
276 0x00, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xfc, 0xfc};
278 /* Last line bitmap. An right-down angle. */
280 ........
281 ......xx
282 ......xx
283 ......xx
284 ......xx
285 ......xx
286 ..xxxxxx
287 ..xxxxxx
289 static unsigned short bottom_right_angle_bits[] = {
290 0x00, 0x03, 0x03, 0x03, 0x03, 0x03, 0x3f, 0x3f};
292 /* First/last line bitmap. An left bracket. */
294 xxxxxx..
295 xxxxxx..
296 xx......
297 xx......
298 xx......
299 xx......
300 xx......
301 xx......
302 xxxxxx..
303 xxxxxx..
305 static unsigned short left_bracket_bits[] = {
306 0xfc, 0xfc, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xfc, 0xfc};
308 /* First/last line bitmap. An right bracket. */
310 ..xxxxxx
311 ..xxxxxx
312 ......xx
313 ......xx
314 ......xx
315 ......xx
316 ......xx
317 ......xx
318 ..xxxxxx
319 ..xxxxxx
321 static unsigned short right_bracket_bits[] = {
322 0x3f, 0x3f, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x3f, 0x3f};
324 /* Filled box cursor bitmap. A filled box; max 13 pixels high. */
326 xxxxxxx.
327 xxxxxxx.
328 xxxxxxx.
329 xxxxxxx.
330 xxxxxxx.
331 xxxxxxx.
332 xxxxxxx.
333 xxxxxxx.
334 xxxxxxx.
335 xxxxxxx.
336 xxxxxxx.
337 xxxxxxx.
338 xxxxxxx.
340 static unsigned short filled_rectangle_bits[] = {
341 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe};
343 /* Hollow box cursor bitmap. A hollow box; max 13 pixels high. */
345 xxxxxxx.
346 x.....x.
347 x.....x.
348 x.....x.
349 x.....x.
350 x.....x.
351 x.....x.
352 x.....x.
353 x.....x.
354 x.....x.
355 x.....x.
356 x.....x.
357 xxxxxxx.
359 static unsigned short hollow_rectangle_bits[] = {
360 0xfe, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0xfe};
362 /* Hollow square bitmap. */
364 .xxxxxx.
365 .x....x.
366 .x....x.
367 .x....x.
368 .x....x.
369 .xxxxxx.
371 static unsigned short hollow_square_bits[] = {
372 0x7e, 0x42, 0x42, 0x42, 0x42, 0x7e};
374 /* Filled square bitmap. */
376 .xxxxxx.
377 .xxxxxx.
378 .xxxxxx.
379 .xxxxxx.
380 .xxxxxx.
381 .xxxxxx.
383 static unsigned short filled_square_bits[] = {
384 0x7e, 0x7e, 0x7e, 0x7e, 0x7e, 0x7e};
386 /* Bar cursor bitmap. A vertical bar; max 13 pixels high. */
388 xx......
389 xx......
390 xx......
391 xx......
392 xx......
393 xx......
394 xx......
395 xx......
396 xx......
397 xx......
398 xx......
399 xx......
400 xx......
402 static unsigned short vertical_bar_bits[] = {
403 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0};
405 /* HBar cursor bitmap. A horizontal bar; 2 pixels high. */
407 xxxxxxx.
408 xxxxxxx.
410 static unsigned short horizontal_bar_bits[] = {
411 0xfe, 0xfe};
414 /* Bitmap drawn to indicate lines not displaying text if
415 `indicate-empty-lines' is non-nil. */
417 ........
418 ..xxxx..
419 ........
420 ........
421 ..xxxx..
422 ........
424 static unsigned short empty_line_bits[] = {
425 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
426 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
427 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
428 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
429 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
430 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
431 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
432 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00};
435 #define BYTES_PER_BITMAP_ROW (sizeof (unsigned short))
436 #define STANDARD_BITMAP_HEIGHT(bits) (sizeof (bits)/BYTES_PER_BITMAP_ROW)
437 #define FRBITS(bits) bits, STANDARD_BITMAP_HEIGHT (bits)
439 /* NOTE: The order of these bitmaps must match the sequence
440 used in fringe.el to define the corresponding symbols. */
442 static struct fringe_bitmap standard_bitmaps[] =
444 { NULL, 0, 0, 0, 0, 0 }, /* NO_FRINGE_BITMAP */
445 { FRBITS (question_mark_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
446 { FRBITS (exclamation_mark_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
447 { FRBITS (left_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
448 { FRBITS (right_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
449 { FRBITS (up_arrow_bits), 8, 0, ALIGN_BITMAP_TOP, 0 },
450 { FRBITS (down_arrow_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
451 { FRBITS (left_curly_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
452 { FRBITS (right_curly_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
453 { FRBITS (left_triangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
454 { FRBITS (right_triangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
455 { FRBITS (top_left_angle_bits), 8, 0, ALIGN_BITMAP_TOP, 0 },
456 { FRBITS (top_right_angle_bits), 8, 0, ALIGN_BITMAP_TOP, 0 },
457 { FRBITS (bottom_left_angle_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
458 { FRBITS (bottom_right_angle_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
459 { FRBITS (left_bracket_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
460 { FRBITS (right_bracket_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
461 { FRBITS (filled_rectangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
462 { FRBITS (hollow_rectangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
463 { FRBITS (filled_square_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
464 { FRBITS (hollow_square_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
465 { FRBITS (vertical_bar_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
466 { FRBITS (horizontal_bar_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
467 { FRBITS (empty_line_bits), 8, 3, ALIGN_BITMAP_TOP, 0 },
470 #define NO_FRINGE_BITMAP 0
471 #define UNDEF_FRINGE_BITMAP 1
472 #define MAX_STANDARD_FRINGE_BITMAPS ARRAYELTS (standard_bitmaps)
474 static struct fringe_bitmap **fringe_bitmaps;
475 static Lisp_Object *fringe_faces;
476 static int max_fringe_bitmaps;
478 int max_used_fringe_bitmap = MAX_STANDARD_FRINGE_BITMAPS;
481 /* Lookup bitmap number for symbol BITMAP.
482 Return 0 if not a bitmap. */
485 lookup_fringe_bitmap (Lisp_Object bitmap)
487 EMACS_INT bn;
489 bitmap = Fget (bitmap, Qfringe);
490 if (!INTEGERP (bitmap))
491 return 0;
493 bn = XINT (bitmap);
494 if (bn > NO_FRINGE_BITMAP
495 && bn < max_used_fringe_bitmap
496 && (bn < MAX_STANDARD_FRINGE_BITMAPS
497 || fringe_bitmaps[bn] != NULL))
498 return bn;
500 return 0;
503 /* Get fringe bitmap name for bitmap number BN.
505 Found by traversing Vfringe_bitmaps comparing BN to the
506 fringe property for each symbol.
508 Return BN if not found in Vfringe_bitmaps. */
510 static Lisp_Object
511 get_fringe_bitmap_name (int bn)
513 Lisp_Object bitmaps;
514 Lisp_Object num;
516 /* Zero means no bitmap -- return nil. */
517 if (bn <= 0)
518 return Qnil;
520 bitmaps = Vfringe_bitmaps;
521 num = make_number (bn);
523 while (CONSP (bitmaps))
525 Lisp_Object bitmap = XCAR (bitmaps);
526 if (EQ (num, Fget (bitmap, Qfringe)))
527 return bitmap;
528 bitmaps = XCDR (bitmaps);
531 return num;
534 /* Get fringe bitmap data for bitmap number BN. */
536 static struct fringe_bitmap *
537 get_fringe_bitmap_data (int bn)
539 struct fringe_bitmap *fb;
541 fb = fringe_bitmaps[bn];
542 if (fb == NULL)
543 fb = &standard_bitmaps[bn < MAX_STANDARD_FRINGE_BITMAPS
544 ? bn : UNDEF_FRINGE_BITMAP];
546 return fb;
549 /* Draw the bitmap WHICH in one of the left or right fringes of
550 window W. ROW is the glyph row for which to display the bitmap; it
551 determines the vertical position at which the bitmap has to be
552 drawn.
553 LEFT_P is 1 for left fringe, 0 for right fringe.
556 static void
557 draw_fringe_bitmap_1 (struct window *w, struct glyph_row *row, int left_p, int overlay, int which)
559 struct frame *f = XFRAME (WINDOW_FRAME (w));
560 struct draw_fringe_bitmap_params p;
561 struct fringe_bitmap *fb;
562 int period;
563 int face_id = DEFAULT_FACE_ID;
564 int offset, header_line_height;
566 p.overlay_p = (overlay & 1) == 1;
567 p.cursor_p = (overlay & 2) == 2;
569 if (which != NO_FRINGE_BITMAP)
571 offset = 0;
573 else if (left_p)
575 which = row->left_fringe_bitmap;
576 face_id = row->left_fringe_face_id;
577 offset = row->left_fringe_offset;
579 else
581 which = row->right_fringe_bitmap;
582 face_id = row->right_fringe_face_id;
583 offset = row->right_fringe_offset;
586 if (face_id == DEFAULT_FACE_ID)
588 Lisp_Object face = fringe_faces[which];
589 face_id = NILP (face) ? lookup_named_face (f, Qfringe, false)
590 : lookup_derived_face (f, face, FRINGE_FACE_ID, 0);
591 if (face_id < 0)
592 face_id = FRINGE_FACE_ID;
595 fb = get_fringe_bitmap_data (which);
597 period = fb->period;
599 /* Convert row to frame coordinates. */
600 p.y = WINDOW_TO_FRAME_PIXEL_Y (w, row->y) + offset;
602 p.which = which;
603 p.bits = fb->bits;
604 p.wd = fb->width;
606 p.h = fb->height;
607 p.dh = (period > 0 ? (p.y % period) : 0);
608 p.h -= p.dh;
610 /* Adjust y to the offset in the row to start drawing the bitmap. */
611 switch (fb->align)
613 case ALIGN_BITMAP_CENTER:
614 p.y += (row->height - p.h) / 2;
615 break;
616 case ALIGN_BITMAP_BOTTOM:
617 p.y += (row->visible_height - p.h);
618 break;
619 case ALIGN_BITMAP_TOP:
620 break;
623 p.face = FACE_FROM_ID_OR_NULL (f, face_id);
624 if (p.face == NULL)
626 /* This could happen after clearing face cache.
627 But it shouldn't happen anymore. ++kfs */
628 return;
631 prepare_face_for_display (f, p.face);
633 /* Clear left fringe if no bitmap to draw or if bitmap doesn't fill
634 the fringe. */
635 p.bx = -1;
636 header_line_height = WINDOW_HEADER_LINE_HEIGHT (w);
637 p.by = WINDOW_TO_FRAME_PIXEL_Y (w, max (header_line_height, row->y));
638 p.ny = row->visible_height;
639 if (left_p)
641 int wd = WINDOW_LEFT_FRINGE_WIDTH (w);
642 int x = window_box_left (w, (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
643 ? LEFT_MARGIN_AREA
644 : TEXT_AREA));
645 if (p.wd > wd)
646 p.wd = wd;
647 p.x = x - p.wd - (wd - p.wd) / 2;
649 if (p.wd < wd || p.y > p.by || p.y + p.h < p.by + p.ny)
651 /* If W has a vertical border to its left, don't draw over it. */
652 wd -= ((!WINDOW_LEFTMOST_P (w)
653 /* This could be wrong when we allow window local
654 right dividers - but the window on the left is hard
655 to get. */
656 && !FRAME_RIGHT_DIVIDER_WIDTH (f)
657 && !WINDOW_HAS_VERTICAL_SCROLL_BAR (w)
658 /* But don't reduce the fringe width if the window
659 has a left margin, because that means we are not
660 in danger of drawing over the vertical border,
661 and OTOH leaving out that one pixel leaves behind
662 traces of the cursor, if it was in column zero
663 before drawing non-empty margin area. */
664 && w->left_margin_cols == 0)
665 ? 1 : 0);
666 p.bx = x - wd;
667 p.nx = wd;
670 else
672 int x = window_box_right (w,
673 (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
674 ? RIGHT_MARGIN_AREA
675 : TEXT_AREA));
676 int wd = WINDOW_RIGHT_FRINGE_WIDTH (w);
677 if (p.wd > wd)
678 p.wd = wd;
679 p.x = x + (wd - p.wd) / 2;
680 /* Clear right fringe if no bitmap to draw of if bitmap doesn't fill
681 the fringe. */
682 if (p.wd < wd || p.y > p.by || p.y + p.h < p.by + p.ny)
684 p.bx = x;
685 p.nx = wd;
689 if (p.x >= WINDOW_BOX_LEFT_EDGE_X (w)
690 && (p.x + p.wd) <= WINDOW_BOX_LEFT_EDGE_X (w) + WINDOW_PIXEL_WIDTH (w))
691 FRAME_RIF (f)->draw_fringe_bitmap (w, row, &p);
694 static int
695 get_logical_cursor_bitmap (struct window *w, Lisp_Object cursor)
697 Lisp_Object cmap, bm = Qnil;
699 if ((cmap = BVAR (XBUFFER (w->contents), fringe_cursor_alist)), !NILP (cmap))
701 bm = Fassq (cursor, cmap);
702 if (CONSP (bm))
704 if ((bm = XCDR (bm)), NILP (bm))
705 return NO_FRINGE_BITMAP;
706 return lookup_fringe_bitmap (bm);
709 if (EQ (cmap, BVAR (&buffer_defaults, fringe_cursor_alist)))
710 return NO_FRINGE_BITMAP;
711 bm = Fassq (cursor, BVAR (&buffer_defaults, fringe_cursor_alist));
712 if (!CONSP (bm) || ((bm = XCDR (bm)), NILP (bm)))
713 return NO_FRINGE_BITMAP;
714 return lookup_fringe_bitmap (bm);
717 static int
718 get_logical_fringe_bitmap (struct window *w, Lisp_Object bitmap, int right_p, int partial_p)
720 Lisp_Object cmap, bm1 = Qnil, bm2 = Qnil, bm;
721 EMACS_INT ln1 = 0, ln2 = 0;
722 int ix1 = right_p;
723 int ix2 = ix1 + (partial_p ? 2 : 0);
725 /* Lookup in buffer-local fringe-indicator-alist before global alist.
727 Elements are:
728 BITMAP -- use for all
729 (L R) -- use for left right (whether partial or not)
730 (L R PL PR) -- use for left right partial-left partial-right
731 If any value in local binding is not present or t, use global value.
733 If partial, lookup partial bitmap in default value if not found here.
734 If not partial, or no partial spec is present, use non-partial bitmap. */
736 if ((cmap = BVAR (XBUFFER (w->contents), fringe_indicator_alist)), !NILP (cmap))
738 bm1 = Fassq (bitmap, cmap);
739 if (CONSP (bm1))
741 if ((bm1 = XCDR (bm1)), NILP (bm1))
742 return NO_FRINGE_BITMAP;
743 if (CONSP (bm1))
745 ln1 = XINT (Flength (bm1));
746 if (partial_p)
748 if (ln1 > ix2)
750 bm = Fnth (make_number (ix2), bm1);
751 if (!EQ (bm, Qt))
752 goto found;
755 else
757 if (ln1 > ix1)
759 bm = Fnth (make_number (ix1), bm1);
760 if (!EQ (bm, Qt))
761 goto found;
765 else if ((bm = bm1, !EQ (bm, Qt)))
766 goto found;
770 if (!EQ (cmap, BVAR (&buffer_defaults, fringe_indicator_alist))
771 && !NILP (BVAR (&buffer_defaults, fringe_indicator_alist)))
773 bm2 = Fassq (bitmap, BVAR (&buffer_defaults, fringe_indicator_alist));
774 if (CONSP (bm2))
776 if ((bm2 = XCDR (bm2)), !NILP (bm2))
778 if (CONSP (bm2))
780 ln2 = XINT (Flength (bm2));
781 if (partial_p)
783 if (ln2 > ix2)
785 bm = Fnth (make_number (ix2), bm2);
786 if (!EQ (bm, Qt))
787 goto found;
795 if (ln1 > ix1)
797 bm = Fnth (make_number (ix1), bm1);
798 if (!EQ (bm, Qt))
799 goto found;
802 if (ln2 > ix1)
804 bm = Fnth (make_number (ix1), bm2);
805 if (!EQ (bm, Qt))
806 goto found;
807 return NO_FRINGE_BITMAP;
809 else if ((bm = bm2, NILP (bm)))
810 return NO_FRINGE_BITMAP;
812 found:
813 return lookup_fringe_bitmap (bm);
817 void
818 draw_fringe_bitmap (struct window *w, struct glyph_row *row, int left_p)
820 int overlay = 0;
822 if (left_p == row->reversed_p && row->cursor_in_fringe_p)
824 Lisp_Object cursor = Qnil;
826 switch (w->phys_cursor_type)
828 case HOLLOW_BOX_CURSOR:
829 if (row->visible_height >= STANDARD_BITMAP_HEIGHT (hollow_rectangle_bits))
830 cursor = Qhollow;
831 else
832 cursor = Qhollow_small;
833 break;
834 case FILLED_BOX_CURSOR:
835 cursor = Qbox;
836 break;
837 case BAR_CURSOR:
838 cursor = Qbar;
839 break;
840 case HBAR_CURSOR:
841 cursor = Qhbar;
842 break;
843 case NO_CURSOR:
844 default:
845 w->phys_cursor_on_p = 0;
846 row->cursor_in_fringe_p = 0;
847 break;
849 if (!NILP (cursor))
851 int bm = get_logical_cursor_bitmap (w, cursor);
852 if (bm != NO_FRINGE_BITMAP)
854 draw_fringe_bitmap_1 (w, row, left_p, 2, bm);
855 overlay = EQ (cursor, Qbox) ? 3 : 1;
860 draw_fringe_bitmap_1 (w, row, left_p, overlay, NO_FRINGE_BITMAP);
862 if (left_p && row->overlay_arrow_bitmap != NO_FRINGE_BITMAP)
863 draw_fringe_bitmap_1 (w, row, 1, 1, row->overlay_arrow_bitmap);
867 /* Draw fringe bitmaps for glyph row ROW on window W. Call this
868 function with input blocked. */
870 void
871 draw_row_fringe_bitmaps (struct window *w, struct glyph_row *row)
873 eassert (input_blocked_p ());
875 /* If row is completely invisible, because of vscrolling, we
876 don't have to draw anything. */
877 if (row->visible_height <= 0)
878 return;
880 if (WINDOW_LEFT_FRINGE_WIDTH (w) != 0)
881 draw_fringe_bitmap (w, row, 1);
883 if (WINDOW_RIGHT_FRINGE_WIDTH (w) != 0)
884 draw_fringe_bitmap (w, row, 0);
887 /* Draw the fringes of window W. Only fringes for rows marked for
888 update in redraw_fringe_bitmaps_p are drawn.
890 Return nonzero if left or right fringe was redrawn in any way.
892 If NO_FRINGE_P is non-zero, also return nonzero if either fringe
893 has zero width.
895 A return nonzero value indicates that the vertical line between
896 windows needs update (as it may be drawn in the fringe).
899 bool
900 draw_window_fringes (struct window *w, bool no_fringe_p)
902 struct glyph_row *row;
903 int yb = window_text_bottom_y (w);
904 int nrows = w->current_matrix->nrows;
905 int y, rn;
906 bool updated_p = 0;
908 if (w->pseudo_window_p)
909 return updated_p;
911 /* Must draw line if no fringe */
912 if (no_fringe_p
913 && (WINDOW_LEFT_FRINGE_WIDTH (w) == 0
914 || WINDOW_RIGHT_FRINGE_WIDTH (w) == 0))
915 updated_p = 1;
917 for (y = w->vscroll, rn = 0, row = w->current_matrix->rows;
918 y < yb && rn < nrows;
919 y += row->height, ++row, ++rn)
921 if (!row->redraw_fringe_bitmaps_p)
922 continue;
923 draw_row_fringe_bitmaps (w, row);
924 row->redraw_fringe_bitmaps_p = 0;
925 updated_p = 1;
928 return updated_p;
932 /* Recalculate the bitmaps to show in the fringes of window W.
933 Only mark rows with modified bitmaps for update in redraw_fringe_bitmaps_p.
935 If KEEP_CURRENT_P is 0, update current_matrix too. */
937 bool
938 update_window_fringes (struct window *w, bool keep_current_p)
940 struct glyph_row *row, *cur = 0;
941 int yb = window_text_bottom_y (w);
942 int rn, nrows = w->current_matrix->nrows;
943 int y;
944 bool redraw_p = 0;
945 Lisp_Object boundary_top = Qnil, boundary_bot = Qnil;
946 Lisp_Object arrow_top = Qnil, arrow_bot = Qnil;
947 Lisp_Object empty_pos;
948 Lisp_Object ind = Qnil;
949 #define MAX_BITMAP_CACHE (8*4)
950 int bitmap_cache[MAX_BITMAP_CACHE];
951 int top_ind_rn, bot_ind_rn;
952 int top_ind_min_y, bot_ind_max_y;
954 /* top_ind_rn is set to a nonnegative value whenever
955 row->indicate_bob_p is set, so it's OK that top_row_ends_at_zv_p
956 is not initialized here. Similarly for bot_ind_rn,
957 row->indicate_eob_p and bot_row_ends_at_zv_p. */
958 int top_row_ends_at_zv_p UNINIT, bot_row_ends_at_zv_p UNINIT;
960 if (w->pseudo_window_p)
961 return 0;
963 if (!MINI_WINDOW_P (w)
964 && (ind = BVAR (XBUFFER (w->contents), indicate_buffer_boundaries), !NILP (ind)))
966 if (EQ (ind, Qleft) || EQ (ind, Qright))
967 boundary_top = boundary_bot = arrow_top = arrow_bot = ind;
968 else if (CONSP (ind) && CONSP (XCAR (ind)))
970 Lisp_Object pos;
971 if (pos = Fassq (Qt, ind), !NILP (pos))
972 boundary_top = boundary_bot = arrow_top = arrow_bot = XCDR (pos);
973 if (pos = Fassq (Qtop, ind), !NILP (pos))
974 boundary_top = XCDR (pos);
975 if (pos = Fassq (Qbottom, ind), !NILP (pos))
976 boundary_bot = XCDR (pos);
977 if (pos = Fassq (Qup, ind), !NILP (pos))
978 arrow_top = XCDR (pos);
979 if (pos = Fassq (Qdown, ind), !NILP (pos))
980 arrow_bot = XCDR (pos);
982 else
983 /* Anything else means boundary on left and no arrows. */
984 boundary_top = boundary_bot = Qleft;
987 top_ind_rn = bot_ind_rn = -1;
988 if (!NILP (ind))
990 for (y = w->vscroll, rn = 0;
991 y < yb && rn < nrows;
992 y += row->height, ++rn)
994 row = w->desired_matrix->rows + rn;
995 if (!row->enabled_p)
996 row = w->current_matrix->rows + rn;
998 row->indicate_bob_p = row->indicate_top_line_p = 0;
999 row->indicate_eob_p = row->indicate_bottom_line_p = 0;
1001 if (!row->mode_line_p)
1003 if (top_ind_rn < 0 && row->visible_height > 0)
1005 if (MATRIX_ROW_START_CHARPOS (row) <= BUF_BEGV (XBUFFER (w->contents))
1006 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_TOP_P (w, row))
1007 row->indicate_bob_p = !NILP (boundary_top);
1008 else
1009 row->indicate_top_line_p = !NILP (arrow_top);
1010 top_ind_rn = rn;
1013 if (bot_ind_rn < 0)
1015 if (MATRIX_ROW_END_CHARPOS (row) >= BUF_ZV (XBUFFER (w->contents))
1016 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_BOTTOM_P (w, row))
1017 row->indicate_eob_p = !NILP (boundary_bot), bot_ind_rn = rn;
1018 else if (y + row->height >= yb)
1019 row->indicate_bottom_line_p = !NILP (arrow_bot), bot_ind_rn = rn;
1025 empty_pos = BVAR (XBUFFER (w->contents), indicate_empty_lines);
1026 if (!NILP (empty_pos) && !EQ (empty_pos, Qright))
1027 empty_pos = WINDOW_LEFT_FRINGE_WIDTH (w) == 0 ? Qright : Qleft;
1029 for (y = 0; y < MAX_BITMAP_CACHE; y++)
1030 bitmap_cache[y] = -1;
1032 #define LEFT_FRINGE(cache, which, partial_p) \
1033 (bitmap_cache[cache*4+partial_p] >= 0 \
1034 ? bitmap_cache[cache*4+partial_p] \
1035 : (bitmap_cache[cache*4+partial_p] = \
1036 get_logical_fringe_bitmap (w, which, 0, partial_p)))
1038 #define RIGHT_FRINGE(cache, which, partial_p) \
1039 (bitmap_cache[cache*4+2+partial_p] >= 0 \
1040 ? bitmap_cache[cache*4+2+partial_p] \
1041 : (bitmap_cache[cache*4+2+partial_p] = \
1042 get_logical_fringe_bitmap (w, which, 1, partial_p)))
1045 /* Extend top-aligned top indicator (or bottom-aligned bottom
1046 indicator) to adjacent rows if it doesn't fit in one row. */
1047 top_ind_min_y = bot_ind_max_y = -1;
1048 if (top_ind_rn >= 0)
1050 int bn = NO_FRINGE_BITMAP;
1052 row = w->desired_matrix->rows + top_ind_rn;
1053 if (!row->enabled_p)
1054 row = w->current_matrix->rows + top_ind_rn;
1056 top_row_ends_at_zv_p = row->ends_at_zv_p;
1057 if (row->indicate_bob_p)
1059 if (EQ (boundary_top, Qleft))
1060 bn = ((row->indicate_eob_p && EQ (boundary_bot, Qleft))
1061 ? LEFT_FRINGE (1, Qtop_bottom, row->ends_at_zv_p)
1062 : LEFT_FRINGE (2, Qtop, 0));
1063 else
1064 bn = ((row->indicate_eob_p && EQ (boundary_bot, Qright))
1065 ? RIGHT_FRINGE (1, Qtop_bottom, row->ends_at_zv_p)
1066 : RIGHT_FRINGE (2, Qtop, 0));
1068 else if (row->indicate_top_line_p)
1070 if (EQ (arrow_top, Qleft))
1071 bn = LEFT_FRINGE (6, Qup, 0);
1072 else
1073 bn = RIGHT_FRINGE (6, Qup, 0);
1076 if (bn != NO_FRINGE_BITMAP)
1078 struct fringe_bitmap *fb = get_fringe_bitmap_data (bn);
1080 if (fb->align == ALIGN_BITMAP_TOP && fb->period == 0)
1082 struct glyph_row *row1;
1083 int top_ind_max_y;
1085 top_ind_min_y = WINDOW_HEADER_LINE_HEIGHT (w);
1086 top_ind_max_y = top_ind_min_y + fb->height;
1087 if (top_ind_max_y > yb)
1088 top_ind_max_y = yb;
1090 for (y = row->y + row->height, rn = top_ind_rn + 1;
1091 y < top_ind_max_y && rn < nrows;
1092 y += row1->height, rn++)
1094 if (bot_ind_rn >= 0 && rn >= bot_ind_rn)
1095 break;
1097 row1 = w->desired_matrix->rows + rn;
1098 if (!row1->enabled_p)
1099 row1 = w->current_matrix->rows + rn;
1101 row1->indicate_bob_p = row->indicate_bob_p;
1102 row1->indicate_top_line_p = row->indicate_top_line_p;
1107 if (bot_ind_rn >= 0)
1109 int bn = NO_FRINGE_BITMAP;
1111 row = w->desired_matrix->rows + bot_ind_rn;
1112 if (!row->enabled_p)
1113 row = w->current_matrix->rows + bot_ind_rn;
1115 bot_row_ends_at_zv_p = row->ends_at_zv_p;
1116 if (row->indicate_eob_p)
1118 if (EQ (boundary_bot, Qleft))
1119 bn = LEFT_FRINGE (3, Qbottom, row->ends_at_zv_p);
1120 else
1121 bn = RIGHT_FRINGE (3, Qbottom, row->ends_at_zv_p);
1123 else if (row->indicate_bottom_line_p)
1125 if (EQ (arrow_bot, Qleft))
1126 bn = LEFT_FRINGE (7, Qdown, 0);
1127 else
1128 bn = RIGHT_FRINGE (7, Qdown, 0);
1131 if (bn != NO_FRINGE_BITMAP)
1133 struct fringe_bitmap *fb = get_fringe_bitmap_data (bn);
1135 if (fb->align == ALIGN_BITMAP_BOTTOM && fb->period == 0)
1137 struct glyph_row *row1;
1138 int bot_ind_min_y;
1140 bot_ind_max_y = row->y + row->visible_height;
1141 bot_ind_min_y = bot_ind_max_y - fb->height;
1142 if (bot_ind_min_y < WINDOW_HEADER_LINE_HEIGHT (w))
1143 bot_ind_min_y = WINDOW_HEADER_LINE_HEIGHT (w);
1145 for (y = row->y, rn = bot_ind_rn - 1;
1146 y >= bot_ind_min_y && rn >= 0;
1147 y -= row1->height, rn--)
1149 if (top_ind_rn >= 0 && rn <= top_ind_rn)
1150 break;
1152 row1 = w->desired_matrix->rows + rn;
1153 if (!row1->enabled_p)
1154 row1 = w->current_matrix->rows + rn;
1156 row1->indicate_eob_p = row->indicate_eob_p;
1157 row1->indicate_bottom_line_p = row->indicate_bottom_line_p;
1163 for (y = w->vscroll, rn = 0;
1164 y < yb && rn < nrows;
1165 y += row->height, rn++)
1167 int left, right;
1168 unsigned left_face_id, right_face_id;
1169 int left_offset, right_offset;
1170 bool periodic_p;
1172 row = w->desired_matrix->rows + rn;
1173 cur = w->current_matrix->rows + rn;
1174 if (!row->enabled_p)
1175 row = cur;
1177 left_face_id = right_face_id = DEFAULT_FACE_ID;
1178 left_offset = right_offset = 0;
1179 periodic_p = 0;
1181 /* Decide which bitmap to draw in the left fringe. */
1182 if (WINDOW_LEFT_FRINGE_WIDTH (w) == 0)
1183 left = NO_FRINGE_BITMAP;
1184 else if (row->left_user_fringe_bitmap != NO_FRINGE_BITMAP)
1186 left = row->left_user_fringe_bitmap;
1187 left_face_id = row->left_user_fringe_face_id;
1189 else if ((!row->reversed_p && row->truncated_on_left_p)
1190 || (row->reversed_p && row->truncated_on_right_p))
1191 left = LEFT_FRINGE (0, Qtruncation, 0);
1192 else if (row->indicate_bob_p && EQ (boundary_top, Qleft))
1194 left = ((row->indicate_eob_p && EQ (boundary_bot, Qleft))
1195 ? LEFT_FRINGE (1, Qtop_bottom, top_row_ends_at_zv_p)
1196 : LEFT_FRINGE (2, Qtop, 0));
1197 if (top_ind_min_y >= 0)
1198 left_offset = top_ind_min_y - row->y;
1200 else if (row->indicate_eob_p && EQ (boundary_bot, Qleft))
1202 left = LEFT_FRINGE (3, Qbottom, bot_row_ends_at_zv_p);
1203 if (bot_ind_max_y >= 0)
1204 left_offset = bot_ind_max_y - (row->y + row->visible_height);
1206 else if ((!row->reversed_p && MATRIX_ROW_CONTINUATION_LINE_P (row))
1207 || (row->reversed_p && row->continued_p))
1208 left = LEFT_FRINGE (4, Qcontinuation, 0);
1209 else if (row->indicate_empty_line_p && EQ (empty_pos, Qleft))
1210 left = LEFT_FRINGE (5, Qempty_line, 0);
1211 else if (row->indicate_top_line_p && EQ (arrow_top, Qleft))
1213 left = LEFT_FRINGE (6, Qup, 0);
1214 if (top_ind_min_y >= 0)
1215 left_offset = top_ind_min_y - row->y;
1217 else if (row->indicate_bottom_line_p && EQ (arrow_bot, Qleft))
1219 left = LEFT_FRINGE (7, Qdown, 0);
1220 if (bot_ind_max_y >= 0)
1221 left_offset = bot_ind_max_y - (row->y + row->visible_height);
1223 else
1224 left = NO_FRINGE_BITMAP;
1226 /* Decide which bitmap to draw in the right fringe. */
1227 if (WINDOW_RIGHT_FRINGE_WIDTH (w) == 0)
1228 right = NO_FRINGE_BITMAP;
1229 else if (row->right_user_fringe_bitmap != NO_FRINGE_BITMAP)
1231 right = row->right_user_fringe_bitmap;
1232 right_face_id = row->right_user_fringe_face_id;
1234 else if ((!row->reversed_p && row->truncated_on_right_p)
1235 || (row->reversed_p && row->truncated_on_left_p))
1236 right = RIGHT_FRINGE (0, Qtruncation, 0);
1237 else if (row->indicate_bob_p && EQ (boundary_top, Qright))
1239 right = ((row->indicate_eob_p && EQ (boundary_bot, Qright))
1240 ? RIGHT_FRINGE (1, Qtop_bottom, top_row_ends_at_zv_p)
1241 : RIGHT_FRINGE (2, Qtop, 0));
1242 if (top_ind_min_y >= 0)
1243 right_offset = top_ind_min_y - row->y;
1245 else if (row->indicate_eob_p && EQ (boundary_bot, Qright))
1247 right = RIGHT_FRINGE (3, Qbottom, bot_row_ends_at_zv_p);
1248 if (bot_ind_max_y >= 0)
1249 right_offset = bot_ind_max_y - (row->y + row->visible_height);
1251 else if ((!row->reversed_p && row->continued_p)
1252 || (row->reversed_p && MATRIX_ROW_CONTINUATION_LINE_P (row)))
1253 right = RIGHT_FRINGE (4, Qcontinuation, 0);
1254 else if (row->indicate_top_line_p && EQ (arrow_top, Qright))
1256 right = RIGHT_FRINGE (6, Qup, 0);
1257 if (top_ind_min_y >= 0)
1258 right_offset = top_ind_min_y - row->y;
1260 else if (row->indicate_bottom_line_p && EQ (arrow_bot, Qright))
1262 right = RIGHT_FRINGE (7, Qdown, 0);
1263 if (bot_ind_max_y >= 0)
1264 right_offset = bot_ind_max_y - (row->y + row->visible_height);
1266 else if (row->indicate_empty_line_p && EQ (empty_pos, Qright))
1267 right = RIGHT_FRINGE (5, Qempty_line, 0);
1268 else
1269 right = NO_FRINGE_BITMAP;
1271 periodic_p = (get_fringe_bitmap_data (left)->period != 0
1272 || get_fringe_bitmap_data (right)->period != 0);
1274 if (row->y != cur->y
1275 || row->visible_height != cur->visible_height
1276 || row->ends_at_zv_p != cur->ends_at_zv_p
1277 || left != cur->left_fringe_bitmap
1278 || right != cur->right_fringe_bitmap
1279 || left_face_id != cur->left_fringe_face_id
1280 || right_face_id != cur->right_fringe_face_id
1281 || left_offset != cur->left_fringe_offset
1282 || right_offset != cur->right_fringe_offset
1283 || periodic_p != cur->fringe_bitmap_periodic_p
1284 || cur->redraw_fringe_bitmaps_p)
1286 redraw_p = 1, row->redraw_fringe_bitmaps_p = 1;
1287 if (!keep_current_p)
1289 cur->redraw_fringe_bitmaps_p = 1;
1290 cur->left_fringe_bitmap = left;
1291 cur->right_fringe_bitmap = right;
1292 cur->left_fringe_face_id = left_face_id;
1293 cur->right_fringe_face_id = right_face_id;
1294 cur->left_fringe_offset = left_offset;
1295 cur->right_fringe_offset = right_offset;
1296 cur->fringe_bitmap_periodic_p = periodic_p;
1300 if (row->overlay_arrow_bitmap < 0)
1301 row->overlay_arrow_bitmap = get_logical_fringe_bitmap (w, Qoverlay_arrow, 0, 0);
1303 if (row->overlay_arrow_bitmap != cur->overlay_arrow_bitmap)
1305 redraw_p = 1, row->redraw_fringe_bitmaps_p = 1;
1306 if (!keep_current_p)
1308 cur->redraw_fringe_bitmaps_p = 1;
1309 cur->overlay_arrow_bitmap = row->overlay_arrow_bitmap;
1313 row->left_fringe_bitmap = left;
1314 row->right_fringe_bitmap = right;
1315 row->left_fringe_face_id = left_face_id;
1316 row->right_fringe_face_id = right_face_id;
1317 row->left_fringe_offset = left_offset;
1318 row->right_fringe_offset = right_offset;
1319 row->fringe_bitmap_periodic_p = periodic_p;
1322 return redraw_p && !keep_current_p;
1327 /* Free resources used by a user-defined bitmap. */
1329 static void
1330 destroy_fringe_bitmap (int n)
1332 struct fringe_bitmap **fbp;
1334 fringe_faces[n] = Qnil;
1336 fbp = &fringe_bitmaps[n];
1337 if (*fbp && (*fbp)->dynamic)
1339 /* XXX Is SELECTED_FRAME OK here? */
1340 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1341 if (rif && rif->destroy_fringe_bitmap)
1342 rif->destroy_fringe_bitmap (n);
1343 xfree (*fbp);
1344 *fbp = NULL;
1347 while (max_used_fringe_bitmap > MAX_STANDARD_FRINGE_BITMAPS
1348 && fringe_bitmaps[max_used_fringe_bitmap - 1] == NULL)
1349 max_used_fringe_bitmap--;
1353 DEFUN ("destroy-fringe-bitmap", Fdestroy_fringe_bitmap, Sdestroy_fringe_bitmap,
1354 1, 1, 0,
1355 doc: /* Destroy fringe bitmap BITMAP.
1356 If BITMAP overrides a standard fringe bitmap, the original bitmap is restored. */)
1357 (Lisp_Object bitmap)
1359 int n;
1361 CHECK_SYMBOL (bitmap);
1362 n = lookup_fringe_bitmap (bitmap);
1363 if (!n)
1364 return Qnil;
1366 destroy_fringe_bitmap (n);
1368 if (n >= MAX_STANDARD_FRINGE_BITMAPS)
1370 Vfringe_bitmaps = Fdelq (bitmap, Vfringe_bitmaps);
1371 /* It would be better to remove the fringe property. */
1372 Fput (bitmap, Qfringe, Qnil);
1375 return Qnil;
1379 /* Initialize bitmap bit.
1381 On X, we bit-swap the built-in bitmaps and reduce bitmap
1382 from short to char array if width is <= 8 bits.
1384 On MAC with big-endian CPU, we need to byte-swap each short.
1386 On W32 and MAC (little endian), there's no need to do this.
1389 #if defined (HAVE_X_WINDOWS)
1390 static const unsigned char swap_nibble[16] = {
1391 0x0, 0x8, 0x4, 0xc, /* 0000 1000 0100 1100 */
1392 0x2, 0xa, 0x6, 0xe, /* 0010 1010 0110 1110 */
1393 0x1, 0x9, 0x5, 0xd, /* 0001 1001 0101 1101 */
1394 0x3, 0xb, 0x7, 0xf}; /* 0011 1011 0111 1111 */
1395 #endif /* HAVE_X_WINDOWS */
1397 static void
1398 init_fringe_bitmap (int which, struct fringe_bitmap *fb, int once_p)
1400 if (once_p || fb->dynamic)
1402 #if defined (HAVE_X_WINDOWS)
1403 unsigned short *bits = fb->bits;
1404 int j;
1406 #ifdef USE_CAIRO
1407 for (j = 0; j < fb->height; j++)
1409 unsigned short b = *bits;
1410 #ifdef WORDS_BIGENDIAN
1411 *bits++ = (b << (16 - fb->width));
1412 #else
1413 b = (unsigned short)((swap_nibble[b & 0xf] << 12)
1414 | (swap_nibble[(b>>4) & 0xf] << 8)
1415 | (swap_nibble[(b>>8) & 0xf] << 4)
1416 | (swap_nibble[(b>>12) & 0xf]));
1417 *bits++ = (b >> (16 - fb->width));
1418 #endif
1420 #else /* not USE_CAIRO */
1421 if (fb->width <= 8)
1423 unsigned char *cbits = (unsigned char *)fb->bits;
1424 for (j = 0; j < fb->height; j++)
1426 unsigned short b = *bits++;
1427 unsigned char c;
1428 c = (unsigned char)((swap_nibble[b & 0xf] << 4)
1429 | (swap_nibble[(b>>4) & 0xf]));
1430 *cbits++ = (c >> (8 - fb->width));
1433 else
1435 for (j = 0; j < fb->height; j++)
1437 unsigned short b = *bits;
1438 b = (unsigned short)((swap_nibble[b & 0xf] << 12)
1439 | (swap_nibble[(b>>4) & 0xf] << 8)
1440 | (swap_nibble[(b>>8) & 0xf] << 4)
1441 | (swap_nibble[(b>>12) & 0xf]));
1442 b >>= (16 - fb->width);
1443 #ifdef WORDS_BIGENDIAN
1444 b = bswap_16 (b);
1445 #endif
1446 *bits++ = b;
1449 #endif /* not USE_CAIRO */
1450 #endif /* HAVE_X_WINDOWS */
1452 #ifdef HAVE_NTGUI
1453 unsigned short *bits = fb->bits;
1454 int j;
1455 for (j = 0; j < fb->height; j++)
1457 unsigned short b = *bits;
1458 b <<= (16 - fb->width);
1459 /* Windows is little-endian, so the next line is always
1460 needed. */
1461 b = ((b >> 8) | (b << 8));
1462 *bits++ = b;
1464 #endif
1467 if (!once_p)
1469 /* XXX Is SELECTED_FRAME OK here? */
1470 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1472 destroy_fringe_bitmap (which);
1474 if (rif && rif->define_fringe_bitmap)
1475 rif->define_fringe_bitmap (which, fb->bits, fb->height, fb->width);
1477 fringe_bitmaps[which] = fb;
1478 if (which >= max_used_fringe_bitmap)
1479 max_used_fringe_bitmap = which + 1;
1484 DEFUN ("define-fringe-bitmap", Fdefine_fringe_bitmap, Sdefine_fringe_bitmap,
1485 2, 5, 0,
1486 doc: /* Define fringe bitmap BITMAP from BITS of size HEIGHT x WIDTH.
1487 BITMAP is a symbol identifying the new fringe bitmap.
1488 BITS is either a string or a vector of integers.
1489 HEIGHT is height of bitmap. If HEIGHT is nil, use length of BITS.
1490 WIDTH must be an integer between 1 and 16, or nil which defaults to 8.
1491 Optional fifth arg ALIGN may be one of `top', `center', or `bottom',
1492 indicating the positioning of the bitmap relative to the rows where it
1493 is used; the default is to center the bitmap. Fifth arg may also be a
1494 list (ALIGN PERIODIC) where PERIODIC non-nil specifies that the bitmap
1495 should be repeated.
1496 If BITMAP already exists, the existing definition is replaced. */)
1497 (Lisp_Object bitmap, Lisp_Object bits, Lisp_Object height, Lisp_Object width, Lisp_Object align)
1499 int n, h, i, j;
1500 unsigned short *b;
1501 struct fringe_bitmap fb, *xfb;
1502 int fill1 = 0, fill2 = 0;
1504 CHECK_SYMBOL (bitmap);
1505 h = CHECK_VECTOR_OR_STRING (bits);
1507 if (NILP (height))
1508 fb.height = h;
1509 else
1511 CHECK_NUMBER (height);
1512 fb.height = max (0, min (XINT (height), 255));
1513 if (fb.height > h)
1515 fill1 = (fb.height - h) / 2;
1516 fill2 = fb.height - h - fill1;
1520 if (NILP (width))
1521 fb.width = 8;
1522 else
1524 CHECK_NUMBER (width);
1525 fb.width = max (0, min (XINT (width), 255));
1528 fb.period = 0;
1529 fb.align = ALIGN_BITMAP_CENTER;
1531 if (CONSP (align))
1533 Lisp_Object period = XCDR (align);
1534 if (CONSP (period))
1536 period = XCAR (period);
1537 if (!NILP (period))
1539 fb.period = fb.height;
1540 fb.height = 255;
1543 align = XCAR (align);
1545 if (EQ (align, Qtop))
1546 fb.align = ALIGN_BITMAP_TOP;
1547 else if (EQ (align, Qbottom))
1548 fb.align = ALIGN_BITMAP_BOTTOM;
1549 else if (!NILP (align) && !EQ (align, Qcenter))
1550 error ("Bad align argument");
1552 n = lookup_fringe_bitmap (bitmap);
1553 if (!n)
1555 if (max_used_fringe_bitmap < max_fringe_bitmaps)
1556 n = max_used_fringe_bitmap++;
1557 else
1559 for (n = MAX_STANDARD_FRINGE_BITMAPS;
1560 n < max_fringe_bitmaps;
1561 n++)
1562 if (fringe_bitmaps[n] == NULL)
1563 break;
1565 if (n == max_fringe_bitmaps)
1567 int bitmaps = max_fringe_bitmaps + 20;
1568 if (MAX_FRINGE_BITMAPS < bitmaps)
1569 error ("No free fringe bitmap slots");
1571 i = max_fringe_bitmaps;
1572 fringe_bitmaps = xrealloc (fringe_bitmaps,
1573 bitmaps * sizeof *fringe_bitmaps);
1574 fringe_faces = xrealloc (fringe_faces,
1575 bitmaps * sizeof *fringe_faces);
1577 for (i = max_fringe_bitmaps; i < bitmaps; i++)
1579 fringe_bitmaps[i] = NULL;
1580 fringe_faces[i] = Qnil;
1583 max_fringe_bitmaps = bitmaps;
1587 Vfringe_bitmaps = Fcons (bitmap, Vfringe_bitmaps);
1588 Fput (bitmap, Qfringe, make_number (n));
1591 fb.dynamic = true;
1593 xfb = xmalloc (sizeof fb + fb.height * BYTES_PER_BITMAP_ROW);
1594 fb.bits = b = (unsigned short *) (xfb + 1);
1595 memset (b, 0, fb.height);
1597 j = 0;
1598 while (j < fb.height)
1600 for (i = 0; i < fill1 && j < fb.height; i++)
1601 b[j++] = 0;
1602 for (i = 0; i < h && j < fb.height; i++)
1604 Lisp_Object elt = Faref (bits, make_number (i));
1605 b[j++] = NUMBERP (elt) ? XINT (elt) : 0;
1607 for (i = 0; i < fill2 && j < fb.height; i++)
1608 b[j++] = 0;
1611 *xfb = fb;
1613 init_fringe_bitmap (n, xfb, 0);
1615 return bitmap;
1618 DEFUN ("set-fringe-bitmap-face", Fset_fringe_bitmap_face, Sset_fringe_bitmap_face,
1619 1, 2, 0,
1620 doc: /* Set face for fringe bitmap BITMAP to FACE.
1621 FACE is merged with the `fringe' face, so normally FACE should specify
1622 only the foreground color.
1623 If FACE is nil, reset face to default fringe face. */)
1624 (Lisp_Object bitmap, Lisp_Object face)
1626 int n;
1628 CHECK_SYMBOL (bitmap);
1629 n = lookup_fringe_bitmap (bitmap);
1630 if (!n)
1631 error ("Undefined fringe bitmap");
1633 /* The purpose of the following code is to signal an error if FACE
1634 is not a face. This is for the caller's convenience only; the
1635 redisplay code should be able to fail gracefully. Skip the check
1636 if FRINGE_FACE_ID is unrealized (as in batch mode and during
1637 daemon startup). */
1638 if (!NILP (face))
1640 struct frame *f = SELECTED_FRAME ();
1642 if (FACE_FROM_ID_OR_NULL (f, FRINGE_FACE_ID)
1643 && lookup_derived_face (f, face, FRINGE_FACE_ID, 1) < 0)
1644 error ("No such face");
1647 fringe_faces[n] = face;
1648 return Qnil;
1651 DEFUN ("fringe-bitmaps-at-pos", Ffringe_bitmaps_at_pos, Sfringe_bitmaps_at_pos,
1652 0, 2, 0,
1653 doc: /* Return fringe bitmaps of row containing position POS in window WINDOW.
1654 If WINDOW is nil, use selected window. If POS is nil, use value of point
1655 in that window. Return value is a list (LEFT RIGHT OV), where LEFT
1656 is the symbol for the bitmap in the left fringe (or nil if no bitmap),
1657 RIGHT is similar for the right fringe, and OV is non-nil if there is an
1658 overlay arrow in the left fringe.
1659 Return nil if POS is not visible in WINDOW. */)
1660 (Lisp_Object pos, Lisp_Object window)
1662 struct window *w;
1663 struct glyph_row *row;
1664 ptrdiff_t textpos;
1666 w = decode_any_window (window);
1667 XSETWINDOW (window, w);
1669 if (!NILP (pos))
1671 CHECK_NUMBER_COERCE_MARKER (pos);
1672 if (! (BEGV <= XINT (pos) && XINT (pos) <= ZV))
1673 args_out_of_range (window, pos);
1674 textpos = XINT (pos);
1676 else if (w == XWINDOW (selected_window))
1677 textpos = PT;
1678 else
1679 textpos = marker_position (w->pointm);
1681 row = MATRIX_FIRST_TEXT_ROW (w->current_matrix);
1682 row = row_containing_pos (w, textpos, row, NULL, 0);
1683 if (row)
1684 return list3 (get_fringe_bitmap_name (row->left_fringe_bitmap),
1685 get_fringe_bitmap_name (row->right_fringe_bitmap),
1686 (row->overlay_arrow_bitmap == 0 ? Qnil
1687 : row->overlay_arrow_bitmap < 0 ? Qt
1688 : get_fringe_bitmap_name (row->overlay_arrow_bitmap)));
1689 else
1690 return Qnil;
1694 /***********************************************************************
1695 Initialization
1696 ***********************************************************************/
1698 void
1699 syms_of_fringe (void)
1701 DEFSYM (Qtruncation, "truncation");
1702 DEFSYM (Qcontinuation, "continuation");
1703 DEFSYM (Qoverlay_arrow, "overlay-arrow");
1704 DEFSYM (Qempty_line, "empty-line");
1705 DEFSYM (Qtop_bottom, "top-bottom");
1706 DEFSYM (Qhollow_small, "hollow-small");
1708 defsubr (&Sdestroy_fringe_bitmap);
1709 defsubr (&Sdefine_fringe_bitmap);
1710 defsubr (&Sfringe_bitmaps_at_pos);
1711 defsubr (&Sset_fringe_bitmap_face);
1713 DEFVAR_LISP ("overflow-newline-into-fringe", Voverflow_newline_into_fringe,
1714 doc: /* Non-nil means that newline may flow into the right fringe.
1715 This means that display lines which are exactly as wide as the window
1716 \(not counting the final newline) will only occupy one screen line, by
1717 showing (or hiding) the final newline in the right fringe; when point
1718 is at the final newline, the cursor is shown in the right fringe.
1719 If nil, also continue lines which are exactly as wide as the window. */);
1720 Voverflow_newline_into_fringe = Qt;
1722 DEFVAR_LISP ("fringe-bitmaps", Vfringe_bitmaps,
1723 doc: /* List of fringe bitmap symbols. */);
1724 Vfringe_bitmaps = Qnil;
1727 /* Garbage collection hook */
1729 void
1730 mark_fringe_data (void)
1732 int i;
1734 for (i = 0; i < max_fringe_bitmaps; i++)
1735 if (!NILP (fringe_faces[i]))
1736 mark_object (fringe_faces[i]);
1739 /* Initialize this module when Emacs starts. */
1741 void
1742 init_fringe_once (void)
1744 int bt;
1746 for (bt = NO_FRINGE_BITMAP + 1; bt < MAX_STANDARD_FRINGE_BITMAPS; bt++)
1747 init_fringe_bitmap (bt, &standard_bitmaps[bt], 1);
1750 void
1751 init_fringe (void)
1753 max_fringe_bitmaps = MAX_STANDARD_FRINGE_BITMAPS + 20;
1755 fringe_bitmaps = xzalloc (max_fringe_bitmaps * sizeof *fringe_bitmaps);
1757 verify (NIL_IS_ZERO);
1758 fringe_faces = xzalloc (max_fringe_bitmaps * sizeof *fringe_faces);
1761 #if defined (HAVE_NTGUI) || defined (USE_CAIRO)
1763 void
1764 #ifdef HAVE_NTGUI
1765 w32_init_fringe (struct redisplay_interface *rif)
1766 #else
1767 x_cr_init_fringe (struct redisplay_interface *rif)
1768 #endif
1770 int bt;
1772 if (!rif)
1773 return;
1775 for (bt = NO_FRINGE_BITMAP + 1; bt < MAX_STANDARD_FRINGE_BITMAPS; bt++)
1777 struct fringe_bitmap *fb = &standard_bitmaps[bt];
1778 rif->define_fringe_bitmap (bt, fb->bits, fb->height, fb->width);
1781 #endif
1783 #ifdef HAVE_NTGUI
1784 void
1785 w32_reset_fringes (void)
1787 /* Destroy row bitmaps. */
1788 int bt;
1789 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1791 if (!rif)
1792 return;
1794 for (bt = NO_FRINGE_BITMAP + 1; bt < max_used_fringe_bitmap; bt++)
1795 rif->destroy_fringe_bitmap (bt);
1798 #endif /* HAVE_NTGUI */