; doc/emacs/misc.texi (Network Security): Fix typo.
[emacs.git] / src / fringe.c
blob6069184681454ef82f0caefc080322f0df1541e0
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 "ptr-bounds.h"
28 #include "window.h"
29 #include "dispextern.h"
30 #include "buffer.h"
31 #include "blockinput.h"
32 #include "termhooks.h"
34 /* Fringe bitmaps are represented in three different ways:
36 Logical bitmaps are used internally to denote things like
37 'end-of-buffer', 'left-truncation', 'overlay-arrow', etc.
39 Physical bitmaps specify the visual appearance of the bitmap,
40 e.g. 'bottom-left-angle', 'left-arrow', 'left-triangle', etc.
41 User defined bitmaps are physical bitmaps.
43 Internally, fringe bitmaps for a specific display row are
44 represented as a simple integer that is used as an index
45 into the table of all defined bitmaps. This index is stored
46 in the `fringe' property of the physical bitmap symbol.
48 Logical bitmaps are mapped to physical bitmaps through the
49 buffer-local `fringe-indicator-alist' variable.
51 Each element of this alist is a cons (LOGICAL . PHYSICAL)
52 mapping a logical bitmap to a physical bitmap.
53 PHYSICAL is either a symbol to use in both left and right fringe,
54 or a cons of two symbols (LEFT . RIGHT) denoting different
55 bitmaps to use in left and right fringe.
57 LOGICAL is first looked up in the window's buffer's buffer-local
58 value of the fringe-indicator-alist variable, and if not present,
59 in the global value of fringe-indicator-alist.
61 If LOGICAL is not present in either alist, or the PHYSICAL value
62 found is nil, no bitmap is shown for the logical bitmap.
64 The `left-fringe' and `right-fringe' display properties
65 must specify physical bitmap symbols.
68 enum fringe_bitmap_align
70 ALIGN_BITMAP_CENTER = 0,
71 ALIGN_BITMAP_TOP,
72 ALIGN_BITMAP_BOTTOM
75 struct fringe_bitmap
77 unsigned short *bits;
78 unsigned height : 8;
79 unsigned width : 8;
80 unsigned period : 8;
81 unsigned align : 2;
82 bool_bf dynamic : 1;
86 /***********************************************************************
87 Fringe bitmaps
88 ***********************************************************************/
90 /* Undefined bitmap. A question mark. */
92 ..xxxx..
93 .xxxxxx.
94 xx....xx
95 xx....xx
96 ....xx..
97 ...xx...
98 ...xx...
99 ........
100 ...xx...
101 ...xx...
103 static unsigned short question_mark_bits[] = {
104 0x3c, 0x7e, 0x7e, 0x0c, 0x18, 0x18, 0x00, 0x18, 0x18};
106 /* An exclamation mark. */
108 ...XX...
109 ...XX...
110 ...XX...
111 ...XX...
112 ...XX...
113 ...XX...
114 ...XX...
115 ........
116 ...XX...
117 ...XX...
119 static unsigned short exclamation_mark_bits[] = {
120 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00, 0x18};
122 /* An arrow like this: `<-'. */
124 ...xx...
125 ..xx....
126 .xx.....
127 xxxxxx..
128 xxxxxx..
129 .xx.....
130 ..xx....
131 ...xx...
133 static unsigned short left_arrow_bits[] = {
134 0x18, 0x30, 0x60, 0xfc, 0xfc, 0x60, 0x30, 0x18};
137 /* Right truncation arrow bitmap `->'. */
139 ...xx...
140 ....xx..
141 .....xx.
142 ..xxxxxx
143 ..xxxxxx
144 .....xx.
145 ....xx..
146 ...xx...
148 static unsigned short right_arrow_bits[] = {
149 0x18, 0x0c, 0x06, 0x3f, 0x3f, 0x06, 0x0c, 0x18};
152 /* Up arrow bitmap. */
154 ...xx...
155 ..xxxx..
156 .xxxxxx.
157 xxxxxxxx
158 ...xx...
159 ...xx...
160 ...xx...
161 ...xx...
163 static unsigned short up_arrow_bits[] = {
164 0x18, 0x3c, 0x7e, 0xff, 0x18, 0x18, 0x18, 0x18};
167 /* Down arrow bitmap. */
169 ...xx...
170 ...xx...
171 ...xx...
172 ...xx...
173 xxxxxxxx
174 .xxxxxx.
175 ..xxxx..
176 ...xx...
178 static unsigned short down_arrow_bits[] = {
179 0x18, 0x18, 0x18, 0x18, 0xff, 0x7e, 0x3c, 0x18};
181 /* Marker for continuation lines. */
183 ..xxxx..
184 .xxxxx..
185 xx......
186 xxx..x..
187 xxxxxx..
188 .xxxxx..
189 ..xxxx..
190 .xxxxx..
192 static unsigned short left_curly_arrow_bits[] = {
193 0x3c, 0x7c, 0xc0, 0xe4, 0xfc, 0x7c, 0x3c, 0x7c};
195 /* Marker for continued lines. */
197 ..xxxx..
198 ..xxxxx.
199 ......xx
200 ..x..xxx
201 ..xxxxxx
202 ..xxxxx.
203 ..xxxx..
204 ..xxxxx.
206 static unsigned short right_curly_arrow_bits[] = {
207 0x3c, 0x3e, 0x03, 0x27, 0x3f, 0x3e, 0x3c, 0x3e};
209 /* Reverse Overlay arrow bitmap. A triangular arrow. */
211 ......xx
212 ....xxxx
213 ...xxxxx
214 ..xxxxxx
215 ..xxxxxx
216 ...xxxxx
217 ....xxxx
218 ......xx
220 static unsigned short left_triangle_bits[] = {
221 0x03, 0x0f, 0x1f, 0x3f, 0x3f, 0x1f, 0x0f, 0x03};
223 /* Overlay arrow bitmap. A triangular arrow. */
225 xx......
226 xxxx....
227 xxxxx...
228 xxxxxx..
229 xxxxxx..
230 xxxxx...
231 xxxx....
232 xx......
234 static unsigned short right_triangle_bits[] = {
235 0xc0, 0xf0, 0xf8, 0xfc, 0xfc, 0xf8, 0xf0, 0xc0};
237 /* First line bitmap. An top-left angle. */
239 xxxxxx..
240 xxxxxx..
241 xx......
242 xx......
243 xx......
244 xx......
245 xx......
246 ........
248 static unsigned short top_left_angle_bits[] = {
249 0xfc, 0xfc, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0x00};
251 /* First line bitmap. An right-up angle. */
253 ..xxxxxx
254 ..xxxxxx
255 ......xx
256 ......xx
257 ......xx
258 ......xx
259 ......xx
260 ........
262 static unsigned short top_right_angle_bits[] = {
263 0x3f, 0x3f, 0x03, 0x03, 0x03, 0x03, 0x03, 0x00};
265 /* Last line bitmap. An left-down angle. */
267 ........
268 xx......
269 xx......
270 xx......
271 xx......
272 xx......
273 xxxxxx..
274 xxxxxx..
276 static unsigned short bottom_left_angle_bits[] = {
277 0x00, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xfc, 0xfc};
279 /* Last line bitmap. An right-down angle. */
281 ........
282 ......xx
283 ......xx
284 ......xx
285 ......xx
286 ......xx
287 ..xxxxxx
288 ..xxxxxx
290 static unsigned short bottom_right_angle_bits[] = {
291 0x00, 0x03, 0x03, 0x03, 0x03, 0x03, 0x3f, 0x3f};
293 /* First/last line bitmap. An left bracket. */
295 xxxxxx..
296 xxxxxx..
297 xx......
298 xx......
299 xx......
300 xx......
301 xx......
302 xx......
303 xxxxxx..
304 xxxxxx..
306 static unsigned short left_bracket_bits[] = {
307 0xfc, 0xfc, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xfc, 0xfc};
309 /* First/last line bitmap. An right bracket. */
311 ..xxxxxx
312 ..xxxxxx
313 ......xx
314 ......xx
315 ......xx
316 ......xx
317 ......xx
318 ......xx
319 ..xxxxxx
320 ..xxxxxx
322 static unsigned short right_bracket_bits[] = {
323 0x3f, 0x3f, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x3f, 0x3f};
325 /* Filled box cursor bitmap. A filled box; max 13 pixels high. */
327 xxxxxxx.
328 xxxxxxx.
329 xxxxxxx.
330 xxxxxxx.
331 xxxxxxx.
332 xxxxxxx.
333 xxxxxxx.
334 xxxxxxx.
335 xxxxxxx.
336 xxxxxxx.
337 xxxxxxx.
338 xxxxxxx.
339 xxxxxxx.
341 static unsigned short filled_rectangle_bits[] = {
342 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe};
344 /* Hollow box cursor bitmap. A hollow box; max 13 pixels high. */
346 xxxxxxx.
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 x.....x.
358 xxxxxxx.
360 static unsigned short hollow_rectangle_bits[] = {
361 0xfe, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0xfe};
363 /* Hollow square bitmap. */
365 .xxxxxx.
366 .x....x.
367 .x....x.
368 .x....x.
369 .x....x.
370 .xxxxxx.
372 static unsigned short hollow_square_bits[] = {
373 0x7e, 0x42, 0x42, 0x42, 0x42, 0x7e};
375 /* Filled square bitmap. */
377 .xxxxxx.
378 .xxxxxx.
379 .xxxxxx.
380 .xxxxxx.
381 .xxxxxx.
382 .xxxxxx.
384 static unsigned short filled_square_bits[] = {
385 0x7e, 0x7e, 0x7e, 0x7e, 0x7e, 0x7e};
387 /* Bar cursor bitmap. A vertical bar; max 13 pixels high. */
389 xx......
390 xx......
391 xx......
392 xx......
393 xx......
394 xx......
395 xx......
396 xx......
397 xx......
398 xx......
399 xx......
400 xx......
401 xx......
403 static unsigned short vertical_bar_bits[] = {
404 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0};
406 /* HBar cursor bitmap. A horizontal bar; 2 pixels high. */
408 xxxxxxx.
409 xxxxxxx.
411 static unsigned short horizontal_bar_bits[] = {
412 0xfe, 0xfe};
415 /* Bitmap drawn to indicate lines not displaying text if
416 `indicate-empty-lines' is non-nil. */
418 ........
419 ..xxxx..
420 ........
421 ........
422 ..xxxx..
423 ........
425 static unsigned short empty_line_bits[] = {
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,
433 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00};
436 #define BYTES_PER_BITMAP_ROW (sizeof (unsigned short))
437 #define STANDARD_BITMAP_HEIGHT(bits) (sizeof (bits)/BYTES_PER_BITMAP_ROW)
438 #define FRBITS(bits) bits, STANDARD_BITMAP_HEIGHT (bits)
440 /* NOTE: The order of these bitmaps must match the sequence
441 used in fringe.el to define the corresponding symbols. */
443 static struct fringe_bitmap standard_bitmaps[] =
445 { NULL, 0, 0, 0, 0, 0 }, /* NO_FRINGE_BITMAP */
446 { FRBITS (question_mark_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
447 { FRBITS (exclamation_mark_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
448 { FRBITS (left_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
449 { FRBITS (right_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
450 { FRBITS (up_arrow_bits), 8, 0, ALIGN_BITMAP_TOP, 0 },
451 { FRBITS (down_arrow_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
452 { FRBITS (left_curly_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
453 { FRBITS (right_curly_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
454 { FRBITS (left_triangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
455 { FRBITS (right_triangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
456 { FRBITS (top_left_angle_bits), 8, 0, ALIGN_BITMAP_TOP, 0 },
457 { FRBITS (top_right_angle_bits), 8, 0, ALIGN_BITMAP_TOP, 0 },
458 { FRBITS (bottom_left_angle_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
459 { FRBITS (bottom_right_angle_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
460 { FRBITS (left_bracket_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
461 { FRBITS (right_bracket_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
462 { FRBITS (filled_rectangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
463 { FRBITS (hollow_rectangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
464 { FRBITS (filled_square_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
465 { FRBITS (hollow_square_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
466 { FRBITS (vertical_bar_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
467 { FRBITS (horizontal_bar_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
468 { FRBITS (empty_line_bits), 8, 3, ALIGN_BITMAP_TOP, 0 },
471 #define NO_FRINGE_BITMAP 0
472 #define UNDEF_FRINGE_BITMAP 1
473 #define MAX_STANDARD_FRINGE_BITMAPS ARRAYELTS (standard_bitmaps)
475 static struct fringe_bitmap **fringe_bitmaps;
476 static Lisp_Object *fringe_faces;
477 static int max_fringe_bitmaps;
479 int max_used_fringe_bitmap = MAX_STANDARD_FRINGE_BITMAPS;
482 /* Lookup bitmap number for symbol BITMAP.
483 Return 0 if not a bitmap. */
486 lookup_fringe_bitmap (Lisp_Object bitmap)
488 EMACS_INT bn;
490 bitmap = Fget (bitmap, Qfringe);
491 if (!INTEGERP (bitmap))
492 return 0;
494 bn = XINT (bitmap);
495 if (bn > NO_FRINGE_BITMAP
496 && bn < max_used_fringe_bitmap
497 && (bn < MAX_STANDARD_FRINGE_BITMAPS
498 || fringe_bitmaps[bn] != NULL))
499 return bn;
501 return 0;
504 /* Get fringe bitmap name for bitmap number BN.
506 Found by traversing Vfringe_bitmaps comparing BN to the
507 fringe property for each symbol.
509 Return BN if not found in Vfringe_bitmaps. */
511 static Lisp_Object
512 get_fringe_bitmap_name (int bn)
514 Lisp_Object bitmaps;
515 Lisp_Object num;
517 /* Zero means no bitmap -- return nil. */
518 if (bn <= 0)
519 return Qnil;
521 bitmaps = Vfringe_bitmaps;
522 num = make_number (bn);
524 while (CONSP (bitmaps))
526 Lisp_Object bitmap = XCAR (bitmaps);
527 if (EQ (num, Fget (bitmap, Qfringe)))
528 return bitmap;
529 bitmaps = XCDR (bitmaps);
532 return num;
535 /* Get fringe bitmap data for bitmap number BN. */
537 static struct fringe_bitmap *
538 get_fringe_bitmap_data (int bn)
540 struct fringe_bitmap *fb;
542 fb = fringe_bitmaps[bn];
543 if (fb == NULL)
544 fb = &standard_bitmaps[bn < MAX_STANDARD_FRINGE_BITMAPS
545 ? bn : UNDEF_FRINGE_BITMAP];
547 return fb;
550 /* Draw the bitmap WHICH in one of the left or right fringes of
551 window W. ROW is the glyph row for which to display the bitmap; it
552 determines the vertical position at which the bitmap has to be
553 drawn.
554 LEFT_P is 1 for left fringe, 0 for right fringe.
557 static void
558 draw_fringe_bitmap_1 (struct window *w, struct glyph_row *row, int left_p, int overlay, int which)
560 struct frame *f = XFRAME (WINDOW_FRAME (w));
561 struct draw_fringe_bitmap_params p;
562 struct fringe_bitmap *fb;
563 int period;
564 int face_id = DEFAULT_FACE_ID;
565 int offset, header_line_height;
567 p.overlay_p = (overlay & 1) == 1;
568 p.cursor_p = (overlay & 2) == 2;
570 if (which != NO_FRINGE_BITMAP)
572 offset = 0;
574 else if (left_p)
576 which = row->left_fringe_bitmap;
577 face_id = row->left_fringe_face_id;
578 offset = row->left_fringe_offset;
580 else
582 which = row->right_fringe_bitmap;
583 face_id = row->right_fringe_face_id;
584 offset = row->right_fringe_offset;
587 if (face_id == DEFAULT_FACE_ID)
589 Lisp_Object face = fringe_faces[which];
590 face_id = NILP (face) ? lookup_named_face (w, f, Qfringe, false)
591 : lookup_derived_face (w, f, face, FRINGE_FACE_ID, 0);
592 if (face_id < 0)
593 face_id = FRINGE_FACE_ID;
596 fb = get_fringe_bitmap_data (which);
598 period = fb->period;
600 /* Convert row to frame coordinates. */
601 p.y = WINDOW_TO_FRAME_PIXEL_Y (w, row->y) + offset;
603 p.which = which;
604 p.bits = fb->bits;
605 p.wd = fb->width;
607 p.h = fb->height;
608 p.dh = (period > 0 ? (p.y % period) : 0);
609 p.h -= p.dh;
611 /* Adjust y to the offset in the row to start drawing the bitmap. */
612 switch (fb->align)
614 case ALIGN_BITMAP_CENTER:
615 p.y += (row->height - p.h) / 2;
616 break;
617 case ALIGN_BITMAP_BOTTOM:
618 p.y += (row->visible_height - p.h);
619 break;
620 case ALIGN_BITMAP_TOP:
621 break;
624 p.face = FACE_FROM_ID_OR_NULL (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 UNINIT, bot_row_ends_at_zv_p UNINIT;
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 */
1453 #ifdef HAVE_NTGUI
1454 unsigned short *bits = fb->bits;
1455 int j;
1456 for (j = 0; j < fb->height; j++)
1458 unsigned short b = *bits;
1459 b <<= (16 - fb->width);
1460 /* Windows is little-endian, so the next line is always
1461 needed. */
1462 b = ((b >> 8) | (b << 8));
1463 *bits++ = b;
1465 #endif
1468 if (!once_p)
1470 /* XXX Is SELECTED_FRAME OK here? */
1471 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1473 destroy_fringe_bitmap (which);
1475 if (rif && rif->define_fringe_bitmap)
1476 rif->define_fringe_bitmap (which, fb->bits, fb->height, fb->width);
1478 fringe_bitmaps[which] = fb;
1479 if (which >= max_used_fringe_bitmap)
1480 max_used_fringe_bitmap = which + 1;
1485 DEFUN ("define-fringe-bitmap", Fdefine_fringe_bitmap, Sdefine_fringe_bitmap,
1486 2, 5, 0,
1487 doc: /* Define fringe bitmap BITMAP from BITS of size HEIGHT x WIDTH.
1488 BITMAP is a symbol identifying the new fringe bitmap.
1489 BITS is either a string or a vector of integers.
1490 HEIGHT is height of bitmap. If HEIGHT is nil, use length of BITS.
1491 WIDTH must be an integer between 1 and 16, or nil which defaults to 8.
1492 Optional fifth arg ALIGN may be one of `top', `center', or `bottom',
1493 indicating the positioning of the bitmap relative to the rows where it
1494 is used; the default is to center the bitmap. Fifth arg may also be a
1495 list (ALIGN PERIODIC) where PERIODIC non-nil specifies that the bitmap
1496 should be repeated.
1497 If BITMAP already exists, the existing definition is replaced. */)
1498 (Lisp_Object bitmap, Lisp_Object bits, Lisp_Object height, Lisp_Object width, Lisp_Object align)
1500 int n, h, i, j;
1501 unsigned short *b;
1502 struct fringe_bitmap fb, *xfb;
1503 int fill1 = 0, fill2 = 0;
1505 CHECK_SYMBOL (bitmap);
1506 h = CHECK_VECTOR_OR_STRING (bits);
1508 if (NILP (height))
1509 fb.height = h;
1510 else
1512 CHECK_NUMBER (height);
1513 fb.height = max (0, min (XINT (height), 255));
1514 if (fb.height > h)
1516 fill1 = (fb.height - h) / 2;
1517 fill2 = fb.height - h - fill1;
1521 if (NILP (width))
1522 fb.width = 8;
1523 else
1525 CHECK_NUMBER (width);
1526 fb.width = max (0, min (XINT (width), 255));
1529 fb.period = 0;
1530 fb.align = ALIGN_BITMAP_CENTER;
1532 if (CONSP (align))
1534 Lisp_Object period = XCDR (align);
1535 if (CONSP (period))
1537 period = XCAR (period);
1538 if (!NILP (period))
1540 fb.period = fb.height;
1541 fb.height = 255;
1544 align = XCAR (align);
1546 if (EQ (align, Qtop))
1547 fb.align = ALIGN_BITMAP_TOP;
1548 else if (EQ (align, Qbottom))
1549 fb.align = ALIGN_BITMAP_BOTTOM;
1550 else if (!NILP (align) && !EQ (align, Qcenter))
1551 error ("Bad align argument");
1553 n = lookup_fringe_bitmap (bitmap);
1554 if (!n)
1556 if (max_used_fringe_bitmap < max_fringe_bitmaps)
1557 n = max_used_fringe_bitmap++;
1558 else
1560 for (n = MAX_STANDARD_FRINGE_BITMAPS;
1561 n < max_fringe_bitmaps;
1562 n++)
1563 if (fringe_bitmaps[n] == NULL)
1564 break;
1566 if (n == max_fringe_bitmaps)
1568 int bitmaps = max_fringe_bitmaps + 20;
1569 if (MAX_FRINGE_BITMAPS < bitmaps)
1570 error ("No free fringe bitmap slots");
1572 i = max_fringe_bitmaps;
1573 fringe_bitmaps = xrealloc (fringe_bitmaps,
1574 bitmaps * sizeof *fringe_bitmaps);
1575 fringe_faces = xrealloc (fringe_faces,
1576 bitmaps * sizeof *fringe_faces);
1578 for (i = max_fringe_bitmaps; i < bitmaps; i++)
1580 fringe_bitmaps[i] = NULL;
1581 fringe_faces[i] = Qnil;
1584 max_fringe_bitmaps = bitmaps;
1588 Vfringe_bitmaps = Fcons (bitmap, Vfringe_bitmaps);
1589 Fput (bitmap, Qfringe, make_number (n));
1592 fb.dynamic = true;
1594 xfb = xmalloc (sizeof fb + fb.height * BYTES_PER_BITMAP_ROW);
1595 fb.bits = b = ((unsigned short *)
1596 ptr_bounds_clip (xfb + 1, fb.height * BYTES_PER_BITMAP_ROW));
1597 xfb = ptr_bounds_clip (xfb, sizeof *xfb);
1598 memset (b, 0, fb.height);
1600 j = 0;
1601 while (j < fb.height)
1603 for (i = 0; i < fill1 && j < fb.height; i++)
1604 b[j++] = 0;
1605 for (i = 0; i < h && j < fb.height; i++)
1607 Lisp_Object elt = Faref (bits, make_number (i));
1608 b[j++] = NUMBERP (elt) ? XINT (elt) : 0;
1610 for (i = 0; i < fill2 && j < fb.height; i++)
1611 b[j++] = 0;
1614 *xfb = fb;
1616 init_fringe_bitmap (n, xfb, 0);
1618 return bitmap;
1621 DEFUN ("set-fringe-bitmap-face", Fset_fringe_bitmap_face, Sset_fringe_bitmap_face,
1622 1, 2, 0,
1623 doc: /* Set face for fringe bitmap BITMAP to FACE.
1624 FACE is merged with the `fringe' face, so normally FACE should specify
1625 only the foreground color.
1626 If FACE is nil, reset face to default fringe face. */)
1627 (Lisp_Object bitmap, Lisp_Object face)
1629 int n;
1631 CHECK_SYMBOL (bitmap);
1632 n = lookup_fringe_bitmap (bitmap);
1633 if (!n)
1634 error ("Undefined fringe bitmap");
1636 /* We used to check, as a convenience to callers, for basic face
1637 validity here, but since validity can depend on the specific
1638 _window_ in which this buffer is being displayed, defer the check
1639 to redisplay, which can cope with bad face specifications. */
1640 fringe_faces[n] = face;
1641 return Qnil;
1644 DEFUN ("fringe-bitmaps-at-pos", Ffringe_bitmaps_at_pos, Sfringe_bitmaps_at_pos,
1645 0, 2, 0,
1646 doc: /* Return fringe bitmaps of row containing position POS in window WINDOW.
1647 If WINDOW is nil, use selected window. If POS is nil, use value of point
1648 in that window. Return value is a list (LEFT RIGHT OV), where LEFT
1649 is the symbol for the bitmap in the left fringe (or nil if no bitmap),
1650 RIGHT is similar for the right fringe, and OV is non-nil if there is an
1651 overlay arrow in the left fringe.
1652 Return nil if POS is not visible in WINDOW. */)
1653 (Lisp_Object pos, Lisp_Object window)
1655 struct window *w;
1656 struct glyph_row *row;
1657 ptrdiff_t textpos;
1659 w = decode_any_window (window);
1660 XSETWINDOW (window, w);
1662 if (!NILP (pos))
1664 CHECK_NUMBER_COERCE_MARKER (pos);
1665 if (! (BEGV <= XINT (pos) && XINT (pos) <= ZV))
1666 args_out_of_range (window, pos);
1667 textpos = XINT (pos);
1669 else if (w == XWINDOW (selected_window))
1670 textpos = PT;
1671 else
1672 textpos = marker_position (w->pointm);
1674 row = MATRIX_FIRST_TEXT_ROW (w->current_matrix);
1675 row = row_containing_pos (w, textpos, row, NULL, 0);
1676 if (row)
1677 return list3 (get_fringe_bitmap_name (row->left_fringe_bitmap),
1678 get_fringe_bitmap_name (row->right_fringe_bitmap),
1679 (row->overlay_arrow_bitmap == 0 ? Qnil
1680 : row->overlay_arrow_bitmap < 0 ? Qt
1681 : get_fringe_bitmap_name (row->overlay_arrow_bitmap)));
1682 else
1683 return Qnil;
1687 /***********************************************************************
1688 Initialization
1689 ***********************************************************************/
1691 void
1692 syms_of_fringe (void)
1694 DEFSYM (Qtruncation, "truncation");
1695 DEFSYM (Qcontinuation, "continuation");
1696 DEFSYM (Qoverlay_arrow, "overlay-arrow");
1697 DEFSYM (Qempty_line, "empty-line");
1698 DEFSYM (Qtop_bottom, "top-bottom");
1699 DEFSYM (Qhollow_small, "hollow-small");
1701 defsubr (&Sdestroy_fringe_bitmap);
1702 defsubr (&Sdefine_fringe_bitmap);
1703 defsubr (&Sfringe_bitmaps_at_pos);
1704 defsubr (&Sset_fringe_bitmap_face);
1706 DEFVAR_LISP ("overflow-newline-into-fringe", Voverflow_newline_into_fringe,
1707 doc: /* Non-nil means that newline may flow into the right fringe.
1708 This means that display lines which are exactly as wide as the window
1709 \(not counting the final newline) will only occupy one screen line, by
1710 showing (or hiding) the final newline in the right fringe; when point
1711 is at the final newline, the cursor is shown in the right fringe.
1712 If nil, also continue lines which are exactly as wide as the window. */);
1713 Voverflow_newline_into_fringe = Qt;
1715 DEFVAR_LISP ("fringe-bitmaps", Vfringe_bitmaps,
1716 doc: /* List of fringe bitmap symbols. */);
1717 Vfringe_bitmaps = Qnil;
1720 /* Garbage collection hook */
1722 void
1723 mark_fringe_data (void)
1725 int i;
1727 for (i = 0; i < max_fringe_bitmaps; i++)
1728 if (!NILP (fringe_faces[i]))
1729 mark_object (fringe_faces[i]);
1732 /* Initialize this module when Emacs starts. */
1734 void
1735 init_fringe_once (void)
1737 int bt;
1739 for (bt = NO_FRINGE_BITMAP + 1; bt < MAX_STANDARD_FRINGE_BITMAPS; bt++)
1740 init_fringe_bitmap (bt, &standard_bitmaps[bt], 1);
1743 void
1744 init_fringe (void)
1746 max_fringe_bitmaps = MAX_STANDARD_FRINGE_BITMAPS + 20;
1748 fringe_bitmaps = xzalloc (max_fringe_bitmaps * sizeof *fringe_bitmaps);
1750 verify (NIL_IS_ZERO);
1751 fringe_faces = xzalloc (max_fringe_bitmaps * sizeof *fringe_faces);
1754 #if defined (HAVE_NTGUI) || defined (USE_CAIRO)
1756 void
1757 #ifdef HAVE_NTGUI
1758 w32_init_fringe (struct redisplay_interface *rif)
1759 #else
1760 x_cr_init_fringe (struct redisplay_interface *rif)
1761 #endif
1763 int bt;
1765 if (!rif)
1766 return;
1768 for (bt = NO_FRINGE_BITMAP + 1; bt < MAX_STANDARD_FRINGE_BITMAPS; bt++)
1770 struct fringe_bitmap *fb = &standard_bitmaps[bt];
1771 rif->define_fringe_bitmap (bt, fb->bits, fb->height, fb->width);
1774 #endif
1776 #ifdef HAVE_NTGUI
1777 void
1778 w32_reset_fringes (void)
1780 /* Destroy row bitmaps. */
1781 int bt;
1782 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1784 if (!rif)
1785 return;
1787 for (bt = NO_FRINGE_BITMAP + 1; bt < max_used_fringe_bitmap; bt++)
1788 rif->destroy_fringe_bitmap (bt);
1791 #endif /* HAVE_NTGUI */