* lisp/emacs-lisp/nadvice.el (add-function): Fix debug spec.
[emacs.git] / src / fringe.c
blob632fa0b25d4cca7d1dde2687d01f6351ae20a522
1 /* Fringe handling (split from xdisp.c).
2 Copyright (C) 1985-1988, 1993-1995, 1997-2015 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
10 (at 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 <http://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 (f, face_id);
625 if (p.face == NULL)
627 /* This could happen after clearing face cache.
628 But it shouldn't happen anymore. ++kfs */
629 return;
632 prepare_face_for_display (f, p.face);
634 /* Clear left fringe if no bitmap to draw or if bitmap doesn't fill
635 the fringe. */
636 p.bx = -1;
637 header_line_height = WINDOW_HEADER_LINE_HEIGHT (w);
638 p.by = WINDOW_TO_FRAME_PIXEL_Y (w, max (header_line_height, row->y));
639 p.ny = row->visible_height;
640 if (left_p)
642 int wd = WINDOW_LEFT_FRINGE_WIDTH (w);
643 int x = window_box_left (w, (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
644 ? LEFT_MARGIN_AREA
645 : TEXT_AREA));
646 if (p.wd > wd)
647 p.wd = wd;
648 p.x = x - p.wd - (wd - p.wd) / 2;
650 if (p.wd < wd || p.y > p.by || p.y + p.h < p.by + p.ny)
652 /* If W has a vertical border to its left, don't draw over it. */
653 wd -= ((!WINDOW_LEFTMOST_P (w)
654 /* This could be wrong when we allow window local
655 right dividers - but the window on the left is hard
656 to get. */
657 && !FRAME_RIGHT_DIVIDER_WIDTH (f)
658 && !WINDOW_HAS_VERTICAL_SCROLL_BAR (w)
659 /* But don't reduce the fringe width if the window
660 has a left margin, because that means we are not
661 in danger of drawing over the vertical border,
662 and OTOH leaving out that one pixel leaves behind
663 traces of the cursor, if it was in column zero
664 before drawing non-empty margin area. */
665 && w->left_margin_cols == 0)
666 ? 1 : 0);
667 p.bx = x - wd;
668 p.nx = wd;
671 else
673 int x = window_box_right (w,
674 (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
675 ? RIGHT_MARGIN_AREA
676 : TEXT_AREA));
677 int wd = WINDOW_RIGHT_FRINGE_WIDTH (w);
678 if (p.wd > wd)
679 p.wd = wd;
680 p.x = x + (wd - p.wd) / 2;
681 /* Clear right fringe if no bitmap to draw of if bitmap doesn't fill
682 the fringe. */
683 if (p.wd < wd || p.y > p.by || p.y + p.h < p.by + p.ny)
685 p.bx = x;
686 p.nx = wd;
690 if (p.x >= WINDOW_BOX_LEFT_EDGE_X (w)
691 && (p.x + p.wd) <= WINDOW_BOX_LEFT_EDGE_X (w) + WINDOW_PIXEL_WIDTH (w))
692 FRAME_RIF (f)->draw_fringe_bitmap (w, row, &p);
695 static int
696 get_logical_cursor_bitmap (struct window *w, Lisp_Object cursor)
698 Lisp_Object cmap, bm = Qnil;
700 if ((cmap = BVAR (XBUFFER (w->contents), fringe_cursor_alist)), !NILP (cmap))
702 bm = Fassq (cursor, cmap);
703 if (CONSP (bm))
705 if ((bm = XCDR (bm)), NILP (bm))
706 return NO_FRINGE_BITMAP;
707 return lookup_fringe_bitmap (bm);
710 if (EQ (cmap, BVAR (&buffer_defaults, fringe_cursor_alist)))
711 return NO_FRINGE_BITMAP;
712 bm = Fassq (cursor, BVAR (&buffer_defaults, fringe_cursor_alist));
713 if (!CONSP (bm) || ((bm = XCDR (bm)), NILP (bm)))
714 return NO_FRINGE_BITMAP;
715 return lookup_fringe_bitmap (bm);
718 static int
719 get_logical_fringe_bitmap (struct window *w, Lisp_Object bitmap, int right_p, int partial_p)
721 Lisp_Object cmap, bm1 = Qnil, bm2 = Qnil, bm;
722 EMACS_INT ln1 = 0, ln2 = 0;
723 int ix1 = right_p;
724 int ix2 = ix1 + (partial_p ? 2 : 0);
726 /* Lookup in buffer-local fringe-indicator-alist before global alist.
728 Elements are:
729 BITMAP -- use for all
730 (L R) -- use for left right (whether partial or not)
731 (L R PL PR) -- use for left right partial-left partial-right
732 If any value in local binding is not present or t, use global value.
734 If partial, lookup partial bitmap in default value if not found here.
735 If not partial, or no partial spec is present, use non-partial bitmap. */
737 if ((cmap = BVAR (XBUFFER (w->contents), fringe_indicator_alist)), !NILP (cmap))
739 bm1 = Fassq (bitmap, cmap);
740 if (CONSP (bm1))
742 if ((bm1 = XCDR (bm1)), NILP (bm1))
743 return NO_FRINGE_BITMAP;
744 if (CONSP (bm1))
746 ln1 = XINT (Flength (bm1));
747 if (partial_p)
749 if (ln1 > ix2)
751 bm = Fnth (make_number (ix2), bm1);
752 if (!EQ (bm, Qt))
753 goto found;
756 else
758 if (ln1 > ix1)
760 bm = Fnth (make_number (ix1), bm1);
761 if (!EQ (bm, Qt))
762 goto found;
766 else if ((bm = bm1, !EQ (bm, Qt)))
767 goto found;
771 if (!EQ (cmap, BVAR (&buffer_defaults, fringe_indicator_alist))
772 && !NILP (BVAR (&buffer_defaults, fringe_indicator_alist)))
774 bm2 = Fassq (bitmap, BVAR (&buffer_defaults, fringe_indicator_alist));
775 if (CONSP (bm2))
777 if ((bm2 = XCDR (bm2)), !NILP (bm2))
779 if (CONSP (bm2))
781 ln2 = XINT (Flength (bm2));
782 if (partial_p)
784 if (ln2 > ix2)
786 bm = Fnth (make_number (ix2), bm2);
787 if (!EQ (bm, Qt))
788 goto found;
796 if (ln1 > ix1)
798 bm = Fnth (make_number (ix1), bm1);
799 if (!EQ (bm, Qt))
800 goto found;
803 if (ln2 > ix1)
805 bm = Fnth (make_number (ix1), bm2);
806 if (!EQ (bm, Qt))
807 goto found;
808 return NO_FRINGE_BITMAP;
810 else if ((bm = bm2, NILP (bm)))
811 return NO_FRINGE_BITMAP;
813 found:
814 return lookup_fringe_bitmap (bm);
818 void
819 draw_fringe_bitmap (struct window *w, struct glyph_row *row, int left_p)
821 int overlay = 0;
823 if (left_p == row->reversed_p && row->cursor_in_fringe_p)
825 Lisp_Object cursor = Qnil;
827 switch (w->phys_cursor_type)
829 case HOLLOW_BOX_CURSOR:
830 if (row->visible_height >= STANDARD_BITMAP_HEIGHT (hollow_rectangle_bits))
831 cursor = Qhollow;
832 else
833 cursor = Qhollow_small;
834 break;
835 case FILLED_BOX_CURSOR:
836 cursor = Qbox;
837 break;
838 case BAR_CURSOR:
839 cursor = Qbar;
840 break;
841 case HBAR_CURSOR:
842 cursor = Qhbar;
843 break;
844 case NO_CURSOR:
845 default:
846 w->phys_cursor_on_p = 0;
847 row->cursor_in_fringe_p = 0;
848 break;
850 if (!NILP (cursor))
852 int bm = get_logical_cursor_bitmap (w, cursor);
853 if (bm != NO_FRINGE_BITMAP)
855 draw_fringe_bitmap_1 (w, row, left_p, 2, bm);
856 overlay = EQ (cursor, Qbox) ? 3 : 1;
861 draw_fringe_bitmap_1 (w, row, left_p, overlay, NO_FRINGE_BITMAP);
863 if (left_p && row->overlay_arrow_bitmap != NO_FRINGE_BITMAP)
864 draw_fringe_bitmap_1 (w, row, 1, 1, row->overlay_arrow_bitmap);
868 /* Draw fringe bitmaps for glyph row ROW on window W. Call this
869 function with input blocked. */
871 void
872 draw_row_fringe_bitmaps (struct window *w, struct glyph_row *row)
874 eassert (input_blocked_p ());
876 /* If row is completely invisible, because of vscrolling, we
877 don't have to draw anything. */
878 if (row->visible_height <= 0)
879 return;
881 if (WINDOW_LEFT_FRINGE_WIDTH (w) != 0)
882 draw_fringe_bitmap (w, row, 1);
884 if (WINDOW_RIGHT_FRINGE_WIDTH (w) != 0)
885 draw_fringe_bitmap (w, row, 0);
888 /* Draw the fringes of window W. Only fringes for rows marked for
889 update in redraw_fringe_bitmaps_p are drawn.
891 Return nonzero if left or right fringe was redrawn in any way.
893 If NO_FRINGE_P is non-zero, also return nonzero if either fringe
894 has zero width.
896 A return nonzero value indicates that the vertical line between
897 windows needs update (as it may be drawn in the fringe).
900 bool
901 draw_window_fringes (struct window *w, bool no_fringe_p)
903 struct glyph_row *row;
904 int yb = window_text_bottom_y (w);
905 int nrows = w->current_matrix->nrows;
906 int y, rn;
907 bool updated_p = 0;
909 if (w->pseudo_window_p)
910 return updated_p;
912 /* Must draw line if no fringe */
913 if (no_fringe_p
914 && (WINDOW_LEFT_FRINGE_WIDTH (w) == 0
915 || WINDOW_RIGHT_FRINGE_WIDTH (w) == 0))
916 updated_p = 1;
918 for (y = w->vscroll, rn = 0, row = w->current_matrix->rows;
919 y < yb && rn < nrows;
920 y += row->height, ++row, ++rn)
922 if (!row->redraw_fringe_bitmaps_p)
923 continue;
924 draw_row_fringe_bitmaps (w, row);
925 row->redraw_fringe_bitmaps_p = 0;
926 updated_p = 1;
929 return updated_p;
933 /* Recalculate the bitmaps to show in the fringes of window W.
934 Only mark rows with modified bitmaps for update in redraw_fringe_bitmaps_p.
936 If KEEP_CURRENT_P is 0, update current_matrix too. */
938 bool
939 update_window_fringes (struct window *w, bool keep_current_p)
941 struct glyph_row *row, *cur = 0;
942 int yb = window_text_bottom_y (w);
943 int rn, nrows = w->current_matrix->nrows;
944 int y;
945 bool redraw_p = 0;
946 Lisp_Object boundary_top = Qnil, boundary_bot = Qnil;
947 Lisp_Object arrow_top = Qnil, arrow_bot = Qnil;
948 Lisp_Object empty_pos;
949 Lisp_Object ind = Qnil;
950 #define MAX_BITMAP_CACHE (8*4)
951 int bitmap_cache[MAX_BITMAP_CACHE];
952 int top_ind_rn, bot_ind_rn;
953 int top_ind_min_y, bot_ind_max_y;
955 /* top_ind_rn is set to a nonnegative value whenever
956 row->indicate_bob_p is set, so it's OK that top_row_ends_at_zv_p
957 is not initialized here. Similarly for bot_ind_rn,
958 row->indicate_eob_p and bot_row_ends_at_zv_p. */
959 int top_row_ends_at_zv_p IF_LINT (= 0), bot_row_ends_at_zv_p IF_LINT (= 0);
961 if (w->pseudo_window_p)
962 return 0;
964 if (!MINI_WINDOW_P (w)
965 && (ind = BVAR (XBUFFER (w->contents), indicate_buffer_boundaries), !NILP (ind)))
967 if (EQ (ind, Qleft) || EQ (ind, Qright))
968 boundary_top = boundary_bot = arrow_top = arrow_bot = ind;
969 else if (CONSP (ind) && CONSP (XCAR (ind)))
971 Lisp_Object pos;
972 if (pos = Fassq (Qt, ind), !NILP (pos))
973 boundary_top = boundary_bot = arrow_top = arrow_bot = XCDR (pos);
974 if (pos = Fassq (Qtop, ind), !NILP (pos))
975 boundary_top = XCDR (pos);
976 if (pos = Fassq (Qbottom, ind), !NILP (pos))
977 boundary_bot = XCDR (pos);
978 if (pos = Fassq (Qup, ind), !NILP (pos))
979 arrow_top = XCDR (pos);
980 if (pos = Fassq (Qdown, ind), !NILP (pos))
981 arrow_bot = XCDR (pos);
983 else
984 /* Anything else means boundary on left and no arrows. */
985 boundary_top = boundary_bot = Qleft;
988 top_ind_rn = bot_ind_rn = -1;
989 if (!NILP (ind))
991 for (y = w->vscroll, rn = 0;
992 y < yb && rn < nrows;
993 y += row->height, ++rn)
995 row = w->desired_matrix->rows + rn;
996 if (!row->enabled_p)
997 row = w->current_matrix->rows + rn;
999 row->indicate_bob_p = row->indicate_top_line_p = 0;
1000 row->indicate_eob_p = row->indicate_bottom_line_p = 0;
1002 if (!row->mode_line_p)
1004 if (top_ind_rn < 0 && row->visible_height > 0)
1006 if (MATRIX_ROW_START_CHARPOS (row) <= BUF_BEGV (XBUFFER (w->contents))
1007 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_TOP_P (w, row))
1008 row->indicate_bob_p = !NILP (boundary_top);
1009 else
1010 row->indicate_top_line_p = !NILP (arrow_top);
1011 top_ind_rn = rn;
1014 if (bot_ind_rn < 0)
1016 if (MATRIX_ROW_END_CHARPOS (row) >= BUF_ZV (XBUFFER (w->contents))
1017 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_BOTTOM_P (w, row))
1018 row->indicate_eob_p = !NILP (boundary_bot), bot_ind_rn = rn;
1019 else if (y + row->height >= yb)
1020 row->indicate_bottom_line_p = !NILP (arrow_bot), bot_ind_rn = rn;
1026 empty_pos = BVAR (XBUFFER (w->contents), indicate_empty_lines);
1027 if (!NILP (empty_pos) && !EQ (empty_pos, Qright))
1028 empty_pos = WINDOW_LEFT_FRINGE_WIDTH (w) == 0 ? Qright : Qleft;
1030 for (y = 0; y < MAX_BITMAP_CACHE; y++)
1031 bitmap_cache[y] = -1;
1033 #define LEFT_FRINGE(cache, which, partial_p) \
1034 (bitmap_cache[cache*4+partial_p] >= 0 \
1035 ? bitmap_cache[cache*4+partial_p] \
1036 : (bitmap_cache[cache*4+partial_p] = \
1037 get_logical_fringe_bitmap (w, which, 0, partial_p)))
1039 #define RIGHT_FRINGE(cache, which, partial_p) \
1040 (bitmap_cache[cache*4+2+partial_p] >= 0 \
1041 ? bitmap_cache[cache*4+2+partial_p] \
1042 : (bitmap_cache[cache*4+2+partial_p] = \
1043 get_logical_fringe_bitmap (w, which, 1, partial_p)))
1046 /* Extend top-aligned top indicator (or bottom-aligned bottom
1047 indicator) to adjacent rows if it doesn't fit in one row. */
1048 top_ind_min_y = bot_ind_max_y = -1;
1049 if (top_ind_rn >= 0)
1051 int bn = NO_FRINGE_BITMAP;
1053 row = w->desired_matrix->rows + top_ind_rn;
1054 if (!row->enabled_p)
1055 row = w->current_matrix->rows + top_ind_rn;
1057 top_row_ends_at_zv_p = row->ends_at_zv_p;
1058 if (row->indicate_bob_p)
1060 if (EQ (boundary_top, Qleft))
1061 bn = ((row->indicate_eob_p && EQ (boundary_bot, Qleft))
1062 ? LEFT_FRINGE (1, Qtop_bottom, row->ends_at_zv_p)
1063 : LEFT_FRINGE (2, Qtop, 0));
1064 else
1065 bn = ((row->indicate_eob_p && EQ (boundary_bot, Qright))
1066 ? RIGHT_FRINGE (1, Qtop_bottom, row->ends_at_zv_p)
1067 : RIGHT_FRINGE (2, Qtop, 0));
1069 else if (row->indicate_top_line_p)
1071 if (EQ (arrow_top, Qleft))
1072 bn = LEFT_FRINGE (6, Qup, 0);
1073 else
1074 bn = RIGHT_FRINGE (6, Qup, 0);
1077 if (bn != NO_FRINGE_BITMAP)
1079 struct fringe_bitmap *fb = get_fringe_bitmap_data (bn);
1081 if (fb->align == ALIGN_BITMAP_TOP && fb->period == 0)
1083 struct glyph_row *row1;
1084 int top_ind_max_y;
1086 top_ind_min_y = WINDOW_HEADER_LINE_HEIGHT (w);
1087 top_ind_max_y = top_ind_min_y + fb->height;
1088 if (top_ind_max_y > yb)
1089 top_ind_max_y = yb;
1091 for (y = row->y + row->height, rn = top_ind_rn + 1;
1092 y < top_ind_max_y && rn < nrows;
1093 y += row1->height, rn++)
1095 if (bot_ind_rn >= 0 && rn >= bot_ind_rn)
1096 break;
1098 row1 = w->desired_matrix->rows + rn;
1099 if (!row1->enabled_p)
1100 row1 = w->current_matrix->rows + rn;
1102 row1->indicate_bob_p = row->indicate_bob_p;
1103 row1->indicate_top_line_p = row->indicate_top_line_p;
1108 if (bot_ind_rn >= 0)
1110 int bn = NO_FRINGE_BITMAP;
1112 row = w->desired_matrix->rows + bot_ind_rn;
1113 if (!row->enabled_p)
1114 row = w->current_matrix->rows + bot_ind_rn;
1116 bot_row_ends_at_zv_p = row->ends_at_zv_p;
1117 if (row->indicate_eob_p)
1119 if (EQ (boundary_bot, Qleft))
1120 bn = LEFT_FRINGE (3, Qbottom, row->ends_at_zv_p);
1121 else
1122 bn = RIGHT_FRINGE (3, Qbottom, row->ends_at_zv_p);
1124 else if (row->indicate_bottom_line_p)
1126 if (EQ (arrow_bot, Qleft))
1127 bn = LEFT_FRINGE (7, Qdown, 0);
1128 else
1129 bn = RIGHT_FRINGE (7, Qdown, 0);
1132 if (bn != NO_FRINGE_BITMAP)
1134 struct fringe_bitmap *fb = get_fringe_bitmap_data (bn);
1136 if (fb->align == ALIGN_BITMAP_BOTTOM && fb->period == 0)
1138 struct glyph_row *row1;
1139 int bot_ind_min_y;
1141 bot_ind_max_y = row->y + row->visible_height;
1142 bot_ind_min_y = bot_ind_max_y - fb->height;
1143 if (bot_ind_min_y < WINDOW_HEADER_LINE_HEIGHT (w))
1144 bot_ind_min_y = WINDOW_HEADER_LINE_HEIGHT (w);
1146 for (y = row->y, rn = bot_ind_rn - 1;
1147 y >= bot_ind_min_y && rn >= 0;
1148 y -= row1->height, rn--)
1150 if (top_ind_rn >= 0 && rn <= top_ind_rn)
1151 break;
1153 row1 = w->desired_matrix->rows + rn;
1154 if (!row1->enabled_p)
1155 row1 = w->current_matrix->rows + rn;
1157 row1->indicate_eob_p = row->indicate_eob_p;
1158 row1->indicate_bottom_line_p = row->indicate_bottom_line_p;
1164 for (y = w->vscroll, rn = 0;
1165 y < yb && rn < nrows;
1166 y += row->height, rn++)
1168 int left, right;
1169 unsigned left_face_id, right_face_id;
1170 int left_offset, right_offset;
1171 bool periodic_p;
1173 row = w->desired_matrix->rows + rn;
1174 cur = w->current_matrix->rows + rn;
1175 if (!row->enabled_p)
1176 row = cur;
1178 left_face_id = right_face_id = DEFAULT_FACE_ID;
1179 left_offset = right_offset = 0;
1180 periodic_p = 0;
1182 /* Decide which bitmap to draw in the left fringe. */
1183 if (WINDOW_LEFT_FRINGE_WIDTH (w) == 0)
1184 left = NO_FRINGE_BITMAP;
1185 else if (row->left_user_fringe_bitmap != NO_FRINGE_BITMAP)
1187 left = row->left_user_fringe_bitmap;
1188 left_face_id = row->left_user_fringe_face_id;
1190 else if ((!row->reversed_p && row->truncated_on_left_p)
1191 || (row->reversed_p && row->truncated_on_right_p))
1192 left = LEFT_FRINGE (0, Qtruncation, 0);
1193 else if (row->indicate_bob_p && EQ (boundary_top, Qleft))
1195 left = ((row->indicate_eob_p && EQ (boundary_bot, Qleft))
1196 ? LEFT_FRINGE (1, Qtop_bottom, top_row_ends_at_zv_p)
1197 : LEFT_FRINGE (2, Qtop, 0));
1198 if (top_ind_min_y >= 0)
1199 left_offset = top_ind_min_y - row->y;
1201 else if (row->indicate_eob_p && EQ (boundary_bot, Qleft))
1203 left = LEFT_FRINGE (3, Qbottom, bot_row_ends_at_zv_p);
1204 if (bot_ind_max_y >= 0)
1205 left_offset = bot_ind_max_y - (row->y + row->visible_height);
1207 else if ((!row->reversed_p && MATRIX_ROW_CONTINUATION_LINE_P (row))
1208 || (row->reversed_p && row->continued_p))
1209 left = LEFT_FRINGE (4, Qcontinuation, 0);
1210 else if (row->indicate_empty_line_p && EQ (empty_pos, Qleft))
1211 left = LEFT_FRINGE (5, Qempty_line, 0);
1212 else if (row->indicate_top_line_p && EQ (arrow_top, Qleft))
1214 left = LEFT_FRINGE (6, Qup, 0);
1215 if (top_ind_min_y >= 0)
1216 left_offset = top_ind_min_y - row->y;
1218 else if (row->indicate_bottom_line_p && EQ (arrow_bot, Qleft))
1220 left = LEFT_FRINGE (7, Qdown, 0);
1221 if (bot_ind_max_y >= 0)
1222 left_offset = bot_ind_max_y - (row->y + row->visible_height);
1224 else
1225 left = NO_FRINGE_BITMAP;
1227 /* Decide which bitmap to draw in the right fringe. */
1228 if (WINDOW_RIGHT_FRINGE_WIDTH (w) == 0)
1229 right = NO_FRINGE_BITMAP;
1230 else if (row->right_user_fringe_bitmap != NO_FRINGE_BITMAP)
1232 right = row->right_user_fringe_bitmap;
1233 right_face_id = row->right_user_fringe_face_id;
1235 else if ((!row->reversed_p && row->truncated_on_right_p)
1236 || (row->reversed_p && row->truncated_on_left_p))
1237 right = RIGHT_FRINGE (0, Qtruncation, 0);
1238 else if (row->indicate_bob_p && EQ (boundary_top, Qright))
1240 right = ((row->indicate_eob_p && EQ (boundary_bot, Qright))
1241 ? RIGHT_FRINGE (1, Qtop_bottom, top_row_ends_at_zv_p)
1242 : RIGHT_FRINGE (2, Qtop, 0));
1243 if (top_ind_min_y >= 0)
1244 right_offset = top_ind_min_y - row->y;
1246 else if (row->indicate_eob_p && EQ (boundary_bot, Qright))
1248 right = RIGHT_FRINGE (3, Qbottom, bot_row_ends_at_zv_p);
1249 if (bot_ind_max_y >= 0)
1250 right_offset = bot_ind_max_y - (row->y + row->visible_height);
1252 else if ((!row->reversed_p && row->continued_p)
1253 || (row->reversed_p && MATRIX_ROW_CONTINUATION_LINE_P (row)))
1254 right = RIGHT_FRINGE (4, Qcontinuation, 0);
1255 else if (row->indicate_top_line_p && EQ (arrow_top, Qright))
1257 right = RIGHT_FRINGE (6, Qup, 0);
1258 if (top_ind_min_y >= 0)
1259 right_offset = top_ind_min_y - row->y;
1261 else if (row->indicate_bottom_line_p && EQ (arrow_bot, Qright))
1263 right = RIGHT_FRINGE (7, Qdown, 0);
1264 if (bot_ind_max_y >= 0)
1265 right_offset = bot_ind_max_y - (row->y + row->visible_height);
1267 else if (row->indicate_empty_line_p && EQ (empty_pos, Qright))
1268 right = RIGHT_FRINGE (5, Qempty_line, 0);
1269 else
1270 right = NO_FRINGE_BITMAP;
1272 periodic_p = (get_fringe_bitmap_data (left)->period != 0
1273 || get_fringe_bitmap_data (right)->period != 0);
1275 if (row->y != cur->y
1276 || row->visible_height != cur->visible_height
1277 || row->ends_at_zv_p != cur->ends_at_zv_p
1278 || left != cur->left_fringe_bitmap
1279 || right != cur->right_fringe_bitmap
1280 || left_face_id != cur->left_fringe_face_id
1281 || right_face_id != cur->right_fringe_face_id
1282 || left_offset != cur->left_fringe_offset
1283 || right_offset != cur->right_fringe_offset
1284 || periodic_p != cur->fringe_bitmap_periodic_p
1285 || cur->redraw_fringe_bitmaps_p)
1287 redraw_p = 1, row->redraw_fringe_bitmaps_p = 1;
1288 if (!keep_current_p)
1290 cur->redraw_fringe_bitmaps_p = 1;
1291 cur->left_fringe_bitmap = left;
1292 cur->right_fringe_bitmap = right;
1293 cur->left_fringe_face_id = left_face_id;
1294 cur->right_fringe_face_id = right_face_id;
1295 cur->left_fringe_offset = left_offset;
1296 cur->right_fringe_offset = right_offset;
1297 cur->fringe_bitmap_periodic_p = periodic_p;
1301 if (row->overlay_arrow_bitmap < 0)
1302 row->overlay_arrow_bitmap = get_logical_fringe_bitmap (w, Qoverlay_arrow, 0, 0);
1304 if (row->overlay_arrow_bitmap != cur->overlay_arrow_bitmap)
1306 redraw_p = 1, row->redraw_fringe_bitmaps_p = 1;
1307 if (!keep_current_p)
1309 cur->redraw_fringe_bitmaps_p = 1;
1310 cur->overlay_arrow_bitmap = row->overlay_arrow_bitmap;
1314 row->left_fringe_bitmap = left;
1315 row->right_fringe_bitmap = right;
1316 row->left_fringe_face_id = left_face_id;
1317 row->right_fringe_face_id = right_face_id;
1318 row->left_fringe_offset = left_offset;
1319 row->right_fringe_offset = right_offset;
1320 row->fringe_bitmap_periodic_p = periodic_p;
1323 return redraw_p && !keep_current_p;
1328 /* Free resources used by a user-defined bitmap. */
1330 static void
1331 destroy_fringe_bitmap (int n)
1333 struct fringe_bitmap **fbp;
1335 fringe_faces[n] = Qnil;
1337 fbp = &fringe_bitmaps[n];
1338 if (*fbp && (*fbp)->dynamic)
1340 /* XXX Is SELECTED_FRAME OK here? */
1341 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1342 if (rif && rif->destroy_fringe_bitmap)
1343 rif->destroy_fringe_bitmap (n);
1344 xfree (*fbp);
1345 *fbp = NULL;
1348 while (max_used_fringe_bitmap > MAX_STANDARD_FRINGE_BITMAPS
1349 && fringe_bitmaps[max_used_fringe_bitmap - 1] == NULL)
1350 max_used_fringe_bitmap--;
1354 DEFUN ("destroy-fringe-bitmap", Fdestroy_fringe_bitmap, Sdestroy_fringe_bitmap,
1355 1, 1, 0,
1356 doc: /* Destroy fringe bitmap BITMAP.
1357 If BITMAP overrides a standard fringe bitmap, the original bitmap is restored. */)
1358 (Lisp_Object bitmap)
1360 int n;
1362 CHECK_SYMBOL (bitmap);
1363 n = lookup_fringe_bitmap (bitmap);
1364 if (!n)
1365 return Qnil;
1367 destroy_fringe_bitmap (n);
1369 if (n >= MAX_STANDARD_FRINGE_BITMAPS)
1371 Vfringe_bitmaps = Fdelq (bitmap, Vfringe_bitmaps);
1372 /* It would be better to remove the fringe property. */
1373 Fput (bitmap, Qfringe, Qnil);
1376 return Qnil;
1380 /* Initialize bitmap bit.
1382 On X, we bit-swap the built-in bitmaps and reduce bitmap
1383 from short to char array if width is <= 8 bits.
1385 On MAC with big-endian CPU, we need to byte-swap each short.
1387 On W32 and MAC (little endian), there's no need to do this.
1390 #if defined (HAVE_X_WINDOWS)
1391 static const unsigned char swap_nibble[16] = {
1392 0x0, 0x8, 0x4, 0xc, /* 0000 1000 0100 1100 */
1393 0x2, 0xa, 0x6, 0xe, /* 0010 1010 0110 1110 */
1394 0x1, 0x9, 0x5, 0xd, /* 0001 1001 0101 1101 */
1395 0x3, 0xb, 0x7, 0xf}; /* 0011 1011 0111 1111 */
1396 #endif /* HAVE_X_WINDOWS */
1398 static void
1399 init_fringe_bitmap (int which, struct fringe_bitmap *fb, int once_p)
1401 if (once_p || fb->dynamic)
1403 #if defined (HAVE_X_WINDOWS)
1404 unsigned short *bits = fb->bits;
1405 int j;
1407 #ifdef USE_CAIRO
1408 for (j = 0; j < fb->height; j++)
1410 unsigned short b = *bits;
1411 #ifdef WORDS_BIGENDIAN
1412 *bits++ = (b << (16 - fb->width));
1413 #else
1414 b = (unsigned short)((swap_nibble[b & 0xf] << 12)
1415 | (swap_nibble[(b>>4) & 0xf] << 8)
1416 | (swap_nibble[(b>>8) & 0xf] << 4)
1417 | (swap_nibble[(b>>12) & 0xf]));
1418 *bits++ = (b >> (16 - fb->width));
1419 #endif
1421 #else /* not USE_CAIRO */
1422 if (fb->width <= 8)
1424 unsigned char *cbits = (unsigned char *)fb->bits;
1425 for (j = 0; j < fb->height; j++)
1427 unsigned short b = *bits++;
1428 unsigned char c;
1429 c = (unsigned char)((swap_nibble[b & 0xf] << 4)
1430 | (swap_nibble[(b>>4) & 0xf]));
1431 *cbits++ = (c >> (8 - fb->width));
1434 else
1436 for (j = 0; j < fb->height; j++)
1438 unsigned short b = *bits;
1439 b = (unsigned short)((swap_nibble[b & 0xf] << 12)
1440 | (swap_nibble[(b>>4) & 0xf] << 8)
1441 | (swap_nibble[(b>>8) & 0xf] << 4)
1442 | (swap_nibble[(b>>12) & 0xf]));
1443 b >>= (16 - fb->width);
1444 #ifdef WORDS_BIGENDIAN
1445 b = bswap_16 (b);
1446 #endif
1447 *bits++ = b;
1450 #endif /* not USE_CAIRO */
1451 #endif /* HAVE_X_WINDOWS */
1455 if (!once_p)
1457 /* XXX Is SELECTED_FRAME OK here? */
1458 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1460 destroy_fringe_bitmap (which);
1462 if (rif && rif->define_fringe_bitmap)
1463 rif->define_fringe_bitmap (which, fb->bits, fb->height, fb->width);
1465 fringe_bitmaps[which] = fb;
1466 if (which >= max_used_fringe_bitmap)
1467 max_used_fringe_bitmap = which + 1;
1472 DEFUN ("define-fringe-bitmap", Fdefine_fringe_bitmap, Sdefine_fringe_bitmap,
1473 2, 5, 0,
1474 doc: /* Define fringe bitmap BITMAP from BITS of size HEIGHT x WIDTH.
1475 BITMAP is a symbol identifying the new fringe bitmap.
1476 BITS is either a string or a vector of integers.
1477 HEIGHT is height of bitmap. If HEIGHT is nil, use length of BITS.
1478 WIDTH must be an integer between 1 and 16, or nil which defaults to 8.
1479 Optional fifth arg ALIGN may be one of `top', `center', or `bottom',
1480 indicating the positioning of the bitmap relative to the rows where it
1481 is used; the default is to center the bitmap. Fifth arg may also be a
1482 list (ALIGN PERIODIC) where PERIODIC non-nil specifies that the bitmap
1483 should be repeated.
1484 If BITMAP already exists, the existing definition is replaced. */)
1485 (Lisp_Object bitmap, Lisp_Object bits, Lisp_Object height, Lisp_Object width, Lisp_Object align)
1487 int n, h, i, j;
1488 unsigned short *b;
1489 struct fringe_bitmap fb, *xfb;
1490 int fill1 = 0, fill2 = 0;
1492 CHECK_SYMBOL (bitmap);
1493 h = CHECK_VECTOR_OR_STRING (bits);
1495 if (NILP (height))
1496 fb.height = h;
1497 else
1499 CHECK_NUMBER (height);
1500 fb.height = max (0, min (XINT (height), 255));
1501 if (fb.height > h)
1503 fill1 = (fb.height - h) / 2;
1504 fill2 = fb.height - h - fill1;
1508 if (NILP (width))
1509 fb.width = 8;
1510 else
1512 CHECK_NUMBER (width);
1513 fb.width = max (0, min (XINT (width), 255));
1516 fb.period = 0;
1517 fb.align = ALIGN_BITMAP_CENTER;
1519 if (CONSP (align))
1521 Lisp_Object period = XCDR (align);
1522 if (CONSP (period))
1524 period = XCAR (period);
1525 if (!NILP (period))
1527 fb.period = fb.height;
1528 fb.height = 255;
1531 align = XCAR (align);
1533 if (EQ (align, Qtop))
1534 fb.align = ALIGN_BITMAP_TOP;
1535 else if (EQ (align, Qbottom))
1536 fb.align = ALIGN_BITMAP_BOTTOM;
1537 else if (!NILP (align) && !EQ (align, Qcenter))
1538 error ("Bad align argument");
1540 n = lookup_fringe_bitmap (bitmap);
1541 if (!n)
1543 if (max_used_fringe_bitmap < max_fringe_bitmaps)
1544 n = max_used_fringe_bitmap++;
1545 else
1547 for (n = MAX_STANDARD_FRINGE_BITMAPS;
1548 n < max_fringe_bitmaps;
1549 n++)
1550 if (fringe_bitmaps[n] == NULL)
1551 break;
1553 if (n == max_fringe_bitmaps)
1555 int bitmaps = max_fringe_bitmaps + 20;
1556 if (MAX_FRINGE_BITMAPS < bitmaps)
1557 error ("No free fringe bitmap slots");
1559 i = max_fringe_bitmaps;
1560 fringe_bitmaps = xrealloc (fringe_bitmaps,
1561 bitmaps * sizeof *fringe_bitmaps);
1562 fringe_faces = xrealloc (fringe_faces,
1563 bitmaps * sizeof *fringe_faces);
1565 for (i = max_fringe_bitmaps; i < bitmaps; i++)
1567 fringe_bitmaps[i] = NULL;
1568 fringe_faces[i] = Qnil;
1571 max_fringe_bitmaps = bitmaps;
1575 Vfringe_bitmaps = Fcons (bitmap, Vfringe_bitmaps);
1576 Fput (bitmap, Qfringe, make_number (n));
1579 fb.dynamic = true;
1581 xfb = xmalloc (sizeof fb + fb.height * BYTES_PER_BITMAP_ROW);
1582 fb.bits = b = (unsigned short *) (xfb + 1);
1583 memset (b, 0, fb.height);
1585 j = 0;
1586 while (j < fb.height)
1588 for (i = 0; i < fill1 && j < fb.height; i++)
1589 b[j++] = 0;
1590 for (i = 0; i < h && j < fb.height; i++)
1592 Lisp_Object elt = Faref (bits, make_number (i));
1593 b[j++] = NUMBERP (elt) ? XINT (elt) : 0;
1595 for (i = 0; i < fill2 && j < fb.height; i++)
1596 b[j++] = 0;
1599 *xfb = fb;
1601 init_fringe_bitmap (n, xfb, 0);
1603 return bitmap;
1606 DEFUN ("set-fringe-bitmap-face", Fset_fringe_bitmap_face, Sset_fringe_bitmap_face,
1607 1, 2, 0,
1608 doc: /* Set face for fringe bitmap BITMAP to FACE.
1609 FACE is merged with the `fringe' face, so normally FACE should specify
1610 only the foreground color.
1611 If FACE is nil, reset face to default fringe face. */)
1612 (Lisp_Object bitmap, Lisp_Object face)
1614 int n;
1616 CHECK_SYMBOL (bitmap);
1617 n = lookup_fringe_bitmap (bitmap);
1618 if (!n)
1619 error ("Undefined fringe bitmap");
1621 /* The purpose of the following code is to signal an error if FACE
1622 is not a face. This is for the caller's convenience only; the
1623 redisplay code should be able to fail gracefully. Skip the check
1624 if FRINGE_FACE_ID is unrealized (as in batch mode and during
1625 daemon startup). */
1626 if (!NILP (face))
1628 struct frame *f = SELECTED_FRAME ();
1630 if (FACE_FROM_ID (f, FRINGE_FACE_ID)
1631 && lookup_derived_face (f, face, FRINGE_FACE_ID, 1) < 0)
1632 error ("No such face");
1635 fringe_faces[n] = face;
1636 return Qnil;
1639 DEFUN ("fringe-bitmaps-at-pos", Ffringe_bitmaps_at_pos, Sfringe_bitmaps_at_pos,
1640 0, 2, 0,
1641 doc: /* Return fringe bitmaps of row containing position POS in window WINDOW.
1642 If WINDOW is nil, use selected window. If POS is nil, use value of point
1643 in that window. Return value is a list (LEFT RIGHT OV), where LEFT
1644 is the symbol for the bitmap in the left fringe (or nil if no bitmap),
1645 RIGHT is similar for the right fringe, and OV is non-nil if there is an
1646 overlay arrow in the left fringe.
1647 Return nil if POS is not visible in WINDOW. */)
1648 (Lisp_Object pos, Lisp_Object window)
1650 struct window *w;
1651 struct glyph_row *row;
1652 ptrdiff_t textpos;
1654 w = decode_any_window (window);
1655 XSETWINDOW (window, w);
1657 if (!NILP (pos))
1659 CHECK_NUMBER_COERCE_MARKER (pos);
1660 if (! (BEGV <= XINT (pos) && XINT (pos) <= ZV))
1661 args_out_of_range (window, pos);
1662 textpos = XINT (pos);
1664 else if (w == XWINDOW (selected_window))
1665 textpos = PT;
1666 else
1667 textpos = marker_position (w->pointm);
1669 row = MATRIX_FIRST_TEXT_ROW (w->current_matrix);
1670 row = row_containing_pos (w, textpos, row, NULL, 0);
1671 if (row)
1672 return list3 (get_fringe_bitmap_name (row->left_fringe_bitmap),
1673 get_fringe_bitmap_name (row->right_fringe_bitmap),
1674 (row->overlay_arrow_bitmap == 0 ? Qnil
1675 : row->overlay_arrow_bitmap < 0 ? Qt
1676 : get_fringe_bitmap_name (row->overlay_arrow_bitmap)));
1677 else
1678 return Qnil;
1682 /***********************************************************************
1683 Initialization
1684 ***********************************************************************/
1686 void
1687 syms_of_fringe (void)
1689 DEFSYM (Qtruncation, "truncation");
1690 DEFSYM (Qcontinuation, "continuation");
1691 DEFSYM (Qoverlay_arrow, "overlay-arrow");
1692 DEFSYM (Qempty_line, "empty-line");
1693 DEFSYM (Qtop_bottom, "top-bottom");
1694 DEFSYM (Qhollow_small, "hollow-small");
1696 defsubr (&Sdestroy_fringe_bitmap);
1697 defsubr (&Sdefine_fringe_bitmap);
1698 defsubr (&Sfringe_bitmaps_at_pos);
1699 defsubr (&Sset_fringe_bitmap_face);
1701 DEFVAR_LISP ("overflow-newline-into-fringe", Voverflow_newline_into_fringe,
1702 doc: /* Non-nil means that newline may flow into the right fringe.
1703 This means that display lines which are exactly as wide as the window
1704 (not counting the final newline) will only occupy one screen line, by
1705 showing (or hiding) the final newline in the right fringe; when point
1706 is at the final newline, the cursor is shown in the right fringe.
1707 If nil, also continue lines which are exactly as wide as the window. */);
1708 Voverflow_newline_into_fringe = Qt;
1710 DEFVAR_LISP ("fringe-bitmaps", Vfringe_bitmaps,
1711 doc: /* List of fringe bitmap symbols. */);
1712 Vfringe_bitmaps = Qnil;
1715 /* Garbage collection hook */
1717 void
1718 mark_fringe_data (void)
1720 int i;
1722 for (i = 0; i < max_fringe_bitmaps; i++)
1723 if (!NILP (fringe_faces[i]))
1724 mark_object (fringe_faces[i]);
1727 /* Initialize this module when Emacs starts. */
1729 void
1730 init_fringe_once (void)
1732 int bt;
1734 for (bt = NO_FRINGE_BITMAP + 1; bt < MAX_STANDARD_FRINGE_BITMAPS; bt++)
1735 init_fringe_bitmap (bt, &standard_bitmaps[bt], 1);
1738 void
1739 init_fringe (void)
1741 max_fringe_bitmaps = MAX_STANDARD_FRINGE_BITMAPS + 20;
1743 fringe_bitmaps = xzalloc (max_fringe_bitmaps * sizeof *fringe_bitmaps);
1745 verify (NIL_IS_ZERO);
1746 fringe_faces = xzalloc (max_fringe_bitmaps * sizeof *fringe_faces);
1749 #if defined (HAVE_NTGUI) || defined (USE_CAIRO)
1751 void
1752 #ifdef HAVE_NTGUI
1753 w32_init_fringe (struct redisplay_interface *rif)
1754 #else
1755 x_cr_init_fringe (struct redisplay_interface *rif)
1756 #endif
1758 int bt;
1760 if (!rif)
1761 return;
1763 for (bt = NO_FRINGE_BITMAP + 1; bt < MAX_STANDARD_FRINGE_BITMAPS; bt++)
1765 struct fringe_bitmap *fb = &standard_bitmaps[bt];
1766 rif->define_fringe_bitmap (bt, fb->bits, fb->height, fb->width);
1769 #endif
1771 #ifdef HAVE_NTGUI
1772 void
1773 w32_reset_fringes (void)
1775 /* Destroy row bitmaps. */
1776 int bt;
1777 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1779 if (!rif)
1780 return;
1782 for (bt = NO_FRINGE_BITMAP + 1; bt < max_used_fringe_bitmap; bt++)
1783 rif->destroy_fringe_bitmap (bt);
1786 #endif /* HAVE_NTGUI */