More doc updates
[emacs.git] / src / fringe.c
blob409c444a317fd216dc35baf182c35e2eccc814bb
1 /* Fringe handling (split from xdisp.c).
2 Copyright (C) 1985-1988, 1993-1995, 1997-2013 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 "character.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 static Lisp_Object Qtruncation, Qcontinuation, Qoverlay_arrow;
69 static Lisp_Object Qempty_line, Qtop_bottom;
70 static Lisp_Object Qhollow_small;
72 enum fringe_bitmap_align
74 ALIGN_BITMAP_CENTER = 0,
75 ALIGN_BITMAP_TOP,
76 ALIGN_BITMAP_BOTTOM
79 struct fringe_bitmap
81 unsigned short *bits;
82 unsigned height : 8;
83 unsigned width : 8;
84 unsigned period : 8;
85 unsigned align : 2;
86 bool_bf dynamic : 1;
90 /***********************************************************************
91 Fringe bitmaps
92 ***********************************************************************/
94 /* Undefined bitmap. A question mark. */
96 ..xxxx..
97 .xxxxxx.
98 xx....xx
99 xx....xx
100 ....xx..
101 ...xx...
102 ...xx...
103 ........
104 ...xx...
105 ...xx...
107 static unsigned short question_mark_bits[] = {
108 0x3c, 0x7e, 0x7e, 0x0c, 0x18, 0x18, 0x00, 0x18, 0x18};
110 /* An exclamation mark. */
112 ...XX...
113 ...XX...
114 ...XX...
115 ...XX...
116 ...XX...
117 ...XX...
118 ...XX...
119 ........
120 ...XX...
121 ...XX...
123 static unsigned short exclamation_mark_bits[] = {
124 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00, 0x18};
126 /* An arrow like this: `<-'. */
128 ...xx...
129 ..xx....
130 .xx.....
131 xxxxxx..
132 xxxxxx..
133 .xx.....
134 ..xx....
135 ...xx...
137 static unsigned short left_arrow_bits[] = {
138 0x18, 0x30, 0x60, 0xfc, 0xfc, 0x60, 0x30, 0x18};
141 /* Right truncation arrow bitmap `->'. */
143 ...xx...
144 ....xx..
145 .....xx.
146 ..xxxxxx
147 ..xxxxxx
148 .....xx.
149 ....xx..
150 ...xx...
152 static unsigned short right_arrow_bits[] = {
153 0x18, 0x0c, 0x06, 0x3f, 0x3f, 0x06, 0x0c, 0x18};
156 /* Up arrow bitmap. */
158 ...xx...
159 ..xxxx..
160 .xxxxxx.
161 xxxxxxxx
162 ...xx...
163 ...xx...
164 ...xx...
165 ...xx...
167 static unsigned short up_arrow_bits[] = {
168 0x18, 0x3c, 0x7e, 0xff, 0x18, 0x18, 0x18, 0x18};
171 /* Down arrow bitmap. */
173 ...xx...
174 ...xx...
175 ...xx...
176 ...xx...
177 xxxxxxxx
178 .xxxxxx.
179 ..xxxx..
180 ...xx...
182 static unsigned short down_arrow_bits[] = {
183 0x18, 0x18, 0x18, 0x18, 0xff, 0x7e, 0x3c, 0x18};
185 /* Marker for continuation lines. */
187 ..xxxx..
188 .xxxxx..
189 xx......
190 xxx..x..
191 xxxxxx..
192 .xxxxx..
193 ..xxxx..
194 .xxxxx..
196 static unsigned short left_curly_arrow_bits[] = {
197 0x3c, 0x7c, 0xc0, 0xe4, 0xfc, 0x7c, 0x3c, 0x7c};
199 /* Marker for continued lines. */
201 ..xxxx..
202 ..xxxxx.
203 ......xx
204 ..x..xxx
205 ..xxxxxx
206 ..xxxxx.
207 ..xxxx..
208 ..xxxxx.
210 static unsigned short right_curly_arrow_bits[] = {
211 0x3c, 0x3e, 0x03, 0x27, 0x3f, 0x3e, 0x3c, 0x3e};
213 /* Reverse Overlay arrow bitmap. A triangular arrow. */
215 ......xx
216 ....xxxx
217 ...xxxxx
218 ..xxxxxx
219 ..xxxxxx
220 ...xxxxx
221 ....xxxx
222 ......xx
224 static unsigned short left_triangle_bits[] = {
225 0x03, 0x0f, 0x1f, 0x3f, 0x3f, 0x1f, 0x0f, 0x03};
227 /* Overlay arrow bitmap. A triangular arrow. */
229 xx......
230 xxxx....
231 xxxxx...
232 xxxxxx..
233 xxxxxx..
234 xxxxx...
235 xxxx....
236 xx......
238 static unsigned short right_triangle_bits[] = {
239 0xc0, 0xf0, 0xf8, 0xfc, 0xfc, 0xf8, 0xf0, 0xc0};
241 /* First line bitmap. An top-left angle. */
243 xxxxxx..
244 xxxxxx..
245 xx......
246 xx......
247 xx......
248 xx......
249 xx......
250 ........
252 static unsigned short top_left_angle_bits[] = {
253 0xfc, 0xfc, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0x00};
255 /* First line bitmap. An right-up angle. */
257 ..xxxxxx
258 ..xxxxxx
259 ......xx
260 ......xx
261 ......xx
262 ......xx
263 ......xx
264 ........
266 static unsigned short top_right_angle_bits[] = {
267 0x3f, 0x3f, 0x03, 0x03, 0x03, 0x03, 0x03, 0x00};
269 /* Last line bitmap. An left-down angle. */
271 ........
272 xx......
273 xx......
274 xx......
275 xx......
276 xx......
277 xxxxxx..
278 xxxxxx..
280 static unsigned short bottom_left_angle_bits[] = {
281 0x00, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xfc, 0xfc};
283 /* Last line bitmap. An right-down angle. */
285 ........
286 ......xx
287 ......xx
288 ......xx
289 ......xx
290 ......xx
291 ..xxxxxx
292 ..xxxxxx
294 static unsigned short bottom_right_angle_bits[] = {
295 0x00, 0x03, 0x03, 0x03, 0x03, 0x03, 0x3f, 0x3f};
297 /* First/last line bitmap. An left bracket. */
299 xxxxxx..
300 xxxxxx..
301 xx......
302 xx......
303 xx......
304 xx......
305 xx......
306 xx......
307 xxxxxx..
308 xxxxxx..
310 static unsigned short left_bracket_bits[] = {
311 0xfc, 0xfc, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xfc, 0xfc};
313 /* First/last line bitmap. An right bracket. */
315 ..xxxxxx
316 ..xxxxxx
317 ......xx
318 ......xx
319 ......xx
320 ......xx
321 ......xx
322 ......xx
323 ..xxxxxx
324 ..xxxxxx
326 static unsigned short right_bracket_bits[] = {
327 0x3f, 0x3f, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x3f, 0x3f};
329 /* Filled box cursor bitmap. A filled box; max 13 pixels high. */
331 xxxxxxx.
332 xxxxxxx.
333 xxxxxxx.
334 xxxxxxx.
335 xxxxxxx.
336 xxxxxxx.
337 xxxxxxx.
338 xxxxxxx.
339 xxxxxxx.
340 xxxxxxx.
341 xxxxxxx.
342 xxxxxxx.
343 xxxxxxx.
345 static unsigned short filled_rectangle_bits[] = {
346 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe};
348 /* Hollow box cursor bitmap. A hollow box; max 13 pixels high. */
350 xxxxxxx.
351 x.....x.
352 x.....x.
353 x.....x.
354 x.....x.
355 x.....x.
356 x.....x.
357 x.....x.
358 x.....x.
359 x.....x.
360 x.....x.
361 x.....x.
362 xxxxxxx.
364 static unsigned short hollow_rectangle_bits[] = {
365 0xfe, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0xfe};
367 /* Hollow square bitmap. */
369 .xxxxxx.
370 .x....x.
371 .x....x.
372 .x....x.
373 .x....x.
374 .xxxxxx.
376 static unsigned short hollow_square_bits[] = {
377 0x7e, 0x42, 0x42, 0x42, 0x42, 0x7e};
379 /* Filled square bitmap. */
381 .xxxxxx.
382 .xxxxxx.
383 .xxxxxx.
384 .xxxxxx.
385 .xxxxxx.
386 .xxxxxx.
388 static unsigned short filled_square_bits[] = {
389 0x7e, 0x7e, 0x7e, 0x7e, 0x7e, 0x7e};
391 /* Bar cursor bitmap. A vertical bar; max 13 pixels high. */
393 xx......
394 xx......
395 xx......
396 xx......
397 xx......
398 xx......
399 xx......
400 xx......
401 xx......
402 xx......
403 xx......
404 xx......
405 xx......
407 static unsigned short vertical_bar_bits[] = {
408 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0};
410 /* HBar cursor bitmap. A horizontal bar; 2 pixels high. */
412 xxxxxxx.
413 xxxxxxx.
415 static unsigned short horizontal_bar_bits[] = {
416 0xfe, 0xfe};
419 /* Bitmap drawn to indicate lines not displaying text if
420 `indicate-empty-lines' is non-nil. */
422 ........
423 ..xxxx..
424 ........
425 ........
426 ..xxxx..
427 ........
429 static unsigned short empty_line_bits[] = {
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,
434 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
435 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
436 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
437 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00};
440 #define BYTES_PER_BITMAP_ROW (sizeof (unsigned short))
441 #define STANDARD_BITMAP_HEIGHT(bits) (sizeof (bits)/BYTES_PER_BITMAP_ROW)
442 #define FRBITS(bits) bits, STANDARD_BITMAP_HEIGHT (bits)
444 /* NOTE: The order of these bitmaps must match the sequence
445 used in fringe.el to define the corresponding symbols. */
447 static struct fringe_bitmap standard_bitmaps[] =
449 { NULL, 0, 0, 0, 0, 0 }, /* NO_FRINGE_BITMAP */
450 { FRBITS (question_mark_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
451 { FRBITS (exclamation_mark_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
452 { FRBITS (left_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
453 { FRBITS (right_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
454 { FRBITS (up_arrow_bits), 8, 0, ALIGN_BITMAP_TOP, 0 },
455 { FRBITS (down_arrow_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
456 { FRBITS (left_curly_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
457 { FRBITS (right_curly_arrow_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
458 { FRBITS (left_triangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
459 { FRBITS (right_triangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
460 { FRBITS (top_left_angle_bits), 8, 0, ALIGN_BITMAP_TOP, 0 },
461 { FRBITS (top_right_angle_bits), 8, 0, ALIGN_BITMAP_TOP, 0 },
462 { FRBITS (bottom_left_angle_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
463 { FRBITS (bottom_right_angle_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
464 { FRBITS (left_bracket_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
465 { FRBITS (right_bracket_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
466 { FRBITS (filled_rectangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
467 { FRBITS (hollow_rectangle_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
468 { FRBITS (filled_square_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
469 { FRBITS (hollow_square_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
470 { FRBITS (vertical_bar_bits), 8, 0, ALIGN_BITMAP_CENTER, 0 },
471 { FRBITS (horizontal_bar_bits), 8, 0, ALIGN_BITMAP_BOTTOM, 0 },
472 { FRBITS (empty_line_bits), 8, 3, ALIGN_BITMAP_TOP, 0 },
475 #define NO_FRINGE_BITMAP 0
476 #define UNDEF_FRINGE_BITMAP 1
477 #define MAX_STANDARD_FRINGE_BITMAPS (sizeof (standard_bitmaps)/sizeof (standard_bitmaps[0]))
479 static struct fringe_bitmap **fringe_bitmaps;
480 static Lisp_Object *fringe_faces;
481 static int max_fringe_bitmaps;
483 #ifndef HAVE_NS
484 static
485 #endif
486 int max_used_fringe_bitmap = MAX_STANDARD_FRINGE_BITMAPS;
489 /* Lookup bitmap number for symbol BITMAP.
490 Return 0 if not a bitmap. */
493 lookup_fringe_bitmap (Lisp_Object bitmap)
495 EMACS_INT bn;
497 bitmap = Fget (bitmap, Qfringe);
498 if (!INTEGERP (bitmap))
499 return 0;
501 bn = XINT (bitmap);
502 if (bn > NO_FRINGE_BITMAP
503 && bn < max_used_fringe_bitmap
504 && (bn < MAX_STANDARD_FRINGE_BITMAPS
505 || fringe_bitmaps[bn] != NULL))
506 return bn;
508 return 0;
511 /* Get fringe bitmap name for bitmap number BN.
513 Found by traversing Vfringe_bitmaps comparing BN to the
514 fringe property for each symbol.
516 Return BN if not found in Vfringe_bitmaps. */
518 static Lisp_Object
519 get_fringe_bitmap_name (int bn)
521 Lisp_Object bitmaps;
522 Lisp_Object num;
524 /* Zero means no bitmap -- return nil. */
525 if (bn <= 0)
526 return Qnil;
528 bitmaps = Vfringe_bitmaps;
529 num = make_number (bn);
531 while (CONSP (bitmaps))
533 Lisp_Object bitmap = XCAR (bitmaps);
534 if (EQ (num, Fget (bitmap, Qfringe)))
535 return bitmap;
536 bitmaps = XCDR (bitmaps);
539 return num;
542 /* Get fringe bitmap data for bitmap number BN. */
544 static struct fringe_bitmap *
545 get_fringe_bitmap_data (int bn)
547 struct fringe_bitmap *fb;
549 fb = fringe_bitmaps[bn];
550 if (fb == NULL)
551 fb = &standard_bitmaps[bn < MAX_STANDARD_FRINGE_BITMAPS
552 ? bn : UNDEF_FRINGE_BITMAP];
554 return fb;
557 /* Draw the bitmap WHICH in one of the left or right fringes of
558 window W. ROW is the glyph row for which to display the bitmap; it
559 determines the vertical position at which the bitmap has to be
560 drawn.
561 LEFT_P is 1 for left fringe, 0 for right fringe.
564 static void
565 draw_fringe_bitmap_1 (struct window *w, struct glyph_row *row, int left_p, int overlay, int which)
567 struct frame *f = XFRAME (WINDOW_FRAME (w));
568 struct draw_fringe_bitmap_params p;
569 struct fringe_bitmap *fb;
570 int period;
571 int face_id = DEFAULT_FACE_ID;
572 int offset, header_line_height;
574 p.overlay_p = (overlay & 1) == 1;
575 p.cursor_p = (overlay & 2) == 2;
577 if (which != NO_FRINGE_BITMAP)
579 offset = 0;
581 else if (left_p)
583 which = row->left_fringe_bitmap;
584 face_id = row->left_fringe_face_id;
585 offset = row->left_fringe_offset;
587 else
589 which = row->right_fringe_bitmap;
590 face_id = row->right_fringe_face_id;
591 offset = row->right_fringe_offset;
594 if (face_id == DEFAULT_FACE_ID)
596 Lisp_Object face = fringe_faces[which];
597 face_id = NILP (face) ? lookup_named_face (f, Qfringe, 0)
598 : lookup_derived_face (f, face, FRINGE_FACE_ID, 0);
599 if (face_id < 0)
600 face_id = FRINGE_FACE_ID;
603 fb = get_fringe_bitmap_data (which);
605 period = fb->period;
607 /* Convert row to frame coordinates. */
608 p.y = WINDOW_TO_FRAME_PIXEL_Y (w, row->y) + offset;
610 p.which = which;
611 p.bits = fb->bits;
612 p.wd = fb->width;
614 p.h = fb->height;
615 p.dh = (period > 0 ? (p.y % period) : 0);
616 p.h -= p.dh;
618 /* Adjust y to the offset in the row to start drawing the bitmap. */
619 switch (fb->align)
621 case ALIGN_BITMAP_CENTER:
622 p.y += (row->height - p.h) / 2;
623 break;
624 case ALIGN_BITMAP_BOTTOM:
625 p.y += (row->visible_height - p.h);
626 break;
627 case ALIGN_BITMAP_TOP:
628 break;
631 p.face = FACE_FROM_ID (f, face_id);
633 if (p.face == NULL)
635 /* This could happen after clearing face cache.
636 But it shouldn't happen anymore. ++kfs */
637 return;
640 PREPARE_FACE_FOR_DISPLAY (f, p.face);
642 /* Clear left fringe if no bitmap to draw or if bitmap doesn't fill
643 the fringe. */
644 p.bx = -1;
645 header_line_height = WINDOW_HEADER_LINE_HEIGHT (w);
646 p.by = WINDOW_TO_FRAME_PIXEL_Y (w, max (header_line_height, row->y));
647 p.ny = row->visible_height;
648 if (left_p)
650 int wd = WINDOW_LEFT_FRINGE_WIDTH (w);
651 int x = window_box_left (w, (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
652 ? LEFT_MARGIN_AREA
653 : TEXT_AREA));
654 if (p.wd > wd)
655 p.wd = wd;
656 p.x = x - p.wd - (wd - p.wd) / 2;
658 if (p.wd < wd || p.y > p.by || p.y + p.h < p.by + p.ny)
660 /* If W has a vertical border to its left, don't draw over it. */
661 wd -= ((!WINDOW_LEFTMOST_P (w)
662 /* This could be wrong when we allow window local
663 right dividers - but the window on the left is hard
664 to get. */
665 && !FRAME_RIGHT_DIVIDER_WIDTH (f)
666 && !WINDOW_HAS_VERTICAL_SCROLL_BAR (w)
667 /* But don't reduce the fringe width if the window
668 has a left margin, because that means we are not
669 in danger of drawing over the vertical border,
670 and OTOH leaving out that one pixel leaves behind
671 traces of the cursor, if it was in column zero
672 before drawing non-empty margin area. */
673 && w->left_margin_cols == 0)
674 ? 1 : 0);
675 p.bx = x - wd;
676 p.nx = wd;
679 else
681 int x = window_box_right (w,
682 (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
683 ? RIGHT_MARGIN_AREA
684 : TEXT_AREA));
685 int wd = WINDOW_RIGHT_FRINGE_WIDTH (w);
686 if (p.wd > wd)
687 p.wd = wd;
688 p.x = x + (wd - p.wd) / 2;
689 /* Clear right fringe if no bitmap to draw of if bitmap doesn't fill
690 the fringe. */
691 if (p.wd < wd || p.y > p.by || p.y + p.h < p.by + p.ny)
693 p.bx = x;
694 p.nx = wd;
698 FRAME_RIF (f)->draw_fringe_bitmap (w, row, &p);
701 static int
702 get_logical_cursor_bitmap (struct window *w, Lisp_Object cursor)
704 Lisp_Object cmap, bm = Qnil;
706 if ((cmap = BVAR (XBUFFER (w->contents), fringe_cursor_alist)), !NILP (cmap))
708 bm = Fassq (cursor, cmap);
709 if (CONSP (bm))
711 if ((bm = XCDR (bm)), NILP (bm))
712 return NO_FRINGE_BITMAP;
713 return lookup_fringe_bitmap (bm);
716 if (EQ (cmap, BVAR (&buffer_defaults, fringe_cursor_alist)))
717 return NO_FRINGE_BITMAP;
718 bm = Fassq (cursor, BVAR (&buffer_defaults, fringe_cursor_alist));
719 if (!CONSP (bm) || ((bm = XCDR (bm)), NILP (bm)))
720 return NO_FRINGE_BITMAP;
721 return lookup_fringe_bitmap (bm);
724 static int
725 get_logical_fringe_bitmap (struct window *w, Lisp_Object bitmap, int right_p, int partial_p)
727 Lisp_Object cmap, bm1 = Qnil, bm2 = Qnil, bm;
728 EMACS_INT ln1 = 0, ln2 = 0;
729 int ix1 = right_p;
730 int ix2 = ix1 + (partial_p ? 2 : 0);
732 /* Lookup in buffer-local fringe-indicator-alist before global alist.
734 Elements are:
735 BITMAP -- use for all
736 (L R) -- use for left right (whether partial or not)
737 (L R PL PR) -- use for left right partial-left partial-right
738 If any value in local binding is not present or t, use global value.
740 If partial, lookup partial bitmap in default value if not found here.
741 If not partial, or no partial spec is present, use non-partial bitmap. */
743 if ((cmap = BVAR (XBUFFER (w->contents), fringe_indicator_alist)), !NILP (cmap))
745 bm1 = Fassq (bitmap, cmap);
746 if (CONSP (bm1))
748 if ((bm1 = XCDR (bm1)), NILP (bm1))
749 return NO_FRINGE_BITMAP;
750 if (CONSP (bm1))
752 ln1 = XINT (Flength (bm1));
753 if (partial_p)
755 if (ln1 > ix2)
757 bm = Fnth (make_number (ix2), bm1);
758 if (!EQ (bm, Qt))
759 goto found;
762 else
764 if (ln1 > ix1)
766 bm = Fnth (make_number (ix1), bm1);
767 if (!EQ (bm, Qt))
768 goto found;
772 else if ((bm = bm1, !EQ (bm, Qt)))
773 goto found;
777 if (!EQ (cmap, BVAR (&buffer_defaults, fringe_indicator_alist))
778 && !NILP (BVAR (&buffer_defaults, fringe_indicator_alist)))
780 bm2 = Fassq (bitmap, BVAR (&buffer_defaults, fringe_indicator_alist));
781 if (CONSP (bm2))
783 if ((bm2 = XCDR (bm2)), !NILP (bm2))
785 if (CONSP (bm2))
787 ln2 = XINT (Flength (bm2));
788 if (partial_p)
790 if (ln2 > ix2)
792 bm = Fnth (make_number (ix2), bm2);
793 if (!EQ (bm, Qt))
794 goto found;
802 if (ln1 > ix1)
804 bm = Fnth (make_number (ix1), bm1);
805 if (!EQ (bm, Qt))
806 goto found;
809 if (ln2 > ix1)
811 bm = Fnth (make_number (ix1), bm2);
812 if (!EQ (bm, Qt))
813 goto found;
814 return NO_FRINGE_BITMAP;
816 else if ((bm = bm2, NILP (bm)))
817 return NO_FRINGE_BITMAP;
819 found:
820 return lookup_fringe_bitmap (bm);
824 void
825 draw_fringe_bitmap (struct window *w, struct glyph_row *row, int left_p)
827 int overlay = 0;
829 if (left_p == row->reversed_p && row->cursor_in_fringe_p)
831 Lisp_Object cursor = Qnil;
833 switch (w->phys_cursor_type)
835 case HOLLOW_BOX_CURSOR:
836 if (row->visible_height >= STANDARD_BITMAP_HEIGHT (hollow_rectangle_bits))
837 cursor = Qhollow;
838 else
839 cursor = Qhollow_small;
840 break;
841 case FILLED_BOX_CURSOR:
842 cursor = Qbox;
843 break;
844 case BAR_CURSOR:
845 cursor = Qbar;
846 break;
847 case HBAR_CURSOR:
848 cursor = Qhbar;
849 break;
850 case NO_CURSOR:
851 default:
852 w->phys_cursor_on_p = 0;
853 row->cursor_in_fringe_p = 0;
854 break;
856 if (!NILP (cursor))
858 int bm = get_logical_cursor_bitmap (w, cursor);
859 if (bm != NO_FRINGE_BITMAP)
861 draw_fringe_bitmap_1 (w, row, left_p, 2, bm);
862 overlay = EQ (cursor, Qbox) ? 3 : 1;
867 draw_fringe_bitmap_1 (w, row, left_p, overlay, NO_FRINGE_BITMAP);
869 if (left_p && row->overlay_arrow_bitmap != NO_FRINGE_BITMAP)
870 draw_fringe_bitmap_1 (w, row, 1, 1, row->overlay_arrow_bitmap);
874 /* Draw fringe bitmaps for glyph row ROW on window W. Call this
875 function with input blocked. */
877 void
878 draw_row_fringe_bitmaps (struct window *w, struct glyph_row *row)
880 eassert (input_blocked_p ());
882 /* If row is completely invisible, because of vscrolling, we
883 don't have to draw anything. */
884 if (row->visible_height <= 0)
885 return;
887 if (WINDOW_LEFT_FRINGE_WIDTH (w) != 0)
888 draw_fringe_bitmap (w, row, 1);
890 if (WINDOW_RIGHT_FRINGE_WIDTH (w) != 0)
891 draw_fringe_bitmap (w, row, 0);
894 /* Draw the fringes of window W. Only fringes for rows marked for
895 update in redraw_fringe_bitmaps_p are drawn.
897 Return nonzero if left or right fringe was redrawn in any way.
899 If NO_FRINGE_P is non-zero, also return nonzero if either fringe
900 has zero width.
902 A return nonzero value indicates that the vertical line between
903 windows needs update (as it may be drawn in the fringe).
906 bool
907 draw_window_fringes (struct window *w, bool no_fringe_p)
909 struct glyph_row *row;
910 int yb = window_text_bottom_y (w);
911 int nrows = w->current_matrix->nrows;
912 int y, rn;
913 bool updated_p = 0;
915 if (w->pseudo_window_p)
916 return updated_p;
918 /* Must draw line if no fringe */
919 if (no_fringe_p
920 && (WINDOW_LEFT_FRINGE_WIDTH (w) == 0
921 || WINDOW_RIGHT_FRINGE_WIDTH (w) == 0))
922 updated_p = 1;
924 for (y = w->vscroll, rn = 0, row = w->current_matrix->rows;
925 y < yb && rn < nrows;
926 y += row->height, ++row, ++rn)
928 if (!row->redraw_fringe_bitmaps_p)
929 continue;
930 draw_row_fringe_bitmaps (w, row);
931 row->redraw_fringe_bitmaps_p = 0;
932 updated_p = 1;
935 return updated_p;
939 /* Recalculate the bitmaps to show in the fringes of window W.
940 Only mark rows with modified bitmaps for update in redraw_fringe_bitmaps_p.
942 If KEEP_CURRENT_P is 0, update current_matrix too. */
944 bool
945 update_window_fringes (struct window *w, bool keep_current_p)
947 struct glyph_row *row, *cur = 0;
948 int yb = window_text_bottom_y (w);
949 int rn, nrows = w->current_matrix->nrows;
950 int y;
951 bool redraw_p = 0;
952 Lisp_Object boundary_top = Qnil, boundary_bot = Qnil;
953 Lisp_Object arrow_top = Qnil, arrow_bot = Qnil;
954 Lisp_Object empty_pos;
955 Lisp_Object ind = Qnil;
956 #define MAX_BITMAP_CACHE (8*4)
957 int bitmap_cache[MAX_BITMAP_CACHE];
958 int top_ind_rn, bot_ind_rn;
959 int top_ind_min_y, bot_ind_max_y;
961 /* top_ind_rn is set to a nonnegative value whenever
962 row->indicate_bob_p is set, so it's OK that top_row_ends_at_zv_p
963 is not initialized here. Similarly for bot_ind_rn,
964 row->indicate_eob_p and bot_row_ends_at_zv_p. */
965 int top_row_ends_at_zv_p IF_LINT (= 0), bot_row_ends_at_zv_p IF_LINT (= 0);
967 if (w->pseudo_window_p)
968 return 0;
970 if (!MINI_WINDOW_P (w)
971 && (ind = BVAR (XBUFFER (w->contents), indicate_buffer_boundaries), !NILP (ind)))
973 if (EQ (ind, Qleft) || EQ (ind, Qright))
974 boundary_top = boundary_bot = arrow_top = arrow_bot = ind;
975 else if (CONSP (ind) && CONSP (XCAR (ind)))
977 Lisp_Object pos;
978 if (pos = Fassq (Qt, ind), !NILP (pos))
979 boundary_top = boundary_bot = arrow_top = arrow_bot = XCDR (pos);
980 if (pos = Fassq (Qtop, ind), !NILP (pos))
981 boundary_top = XCDR (pos);
982 if (pos = Fassq (Qbottom, ind), !NILP (pos))
983 boundary_bot = XCDR (pos);
984 if (pos = Fassq (Qup, ind), !NILP (pos))
985 arrow_top = XCDR (pos);
986 if (pos = Fassq (Qdown, ind), !NILP (pos))
987 arrow_bot = XCDR (pos);
989 else
990 /* Anything else means boundary on left and no arrows. */
991 boundary_top = boundary_bot = Qleft;
994 top_ind_rn = bot_ind_rn = -1;
995 if (!NILP (ind))
997 for (y = w->vscroll, rn = 0;
998 y < yb && rn < nrows;
999 y += row->height, ++rn)
1001 row = w->desired_matrix->rows + rn;
1002 if (!row->enabled_p)
1003 row = w->current_matrix->rows + rn;
1005 row->indicate_bob_p = row->indicate_top_line_p = 0;
1006 row->indicate_eob_p = row->indicate_bottom_line_p = 0;
1008 if (!row->mode_line_p)
1010 if (top_ind_rn < 0 && row->visible_height > 0)
1012 if (MATRIX_ROW_START_CHARPOS (row) <= BUF_BEGV (XBUFFER (w->contents))
1013 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_TOP_P (w, row))
1014 row->indicate_bob_p = !NILP (boundary_top);
1015 else
1016 row->indicate_top_line_p = !NILP (arrow_top);
1017 top_ind_rn = rn;
1020 if (bot_ind_rn < 0)
1022 if (MATRIX_ROW_END_CHARPOS (row) >= BUF_ZV (XBUFFER (w->contents))
1023 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_BOTTOM_P (w, row))
1024 row->indicate_eob_p = !NILP (boundary_bot), bot_ind_rn = rn;
1025 else if (y + row->height >= yb)
1026 row->indicate_bottom_line_p = !NILP (arrow_bot), bot_ind_rn = rn;
1032 empty_pos = BVAR (XBUFFER (w->contents), indicate_empty_lines);
1033 if (!NILP (empty_pos) && !EQ (empty_pos, Qright))
1034 empty_pos = WINDOW_LEFT_FRINGE_WIDTH (w) == 0 ? Qright : Qleft;
1036 for (y = 0; y < MAX_BITMAP_CACHE; y++)
1037 bitmap_cache[y] = -1;
1039 #define LEFT_FRINGE(cache, which, partial_p) \
1040 (bitmap_cache[cache*4+partial_p] >= 0 \
1041 ? bitmap_cache[cache*4+partial_p] \
1042 : (bitmap_cache[cache*4+partial_p] = \
1043 get_logical_fringe_bitmap (w, which, 0, partial_p)))
1045 #define RIGHT_FRINGE(cache, which, partial_p) \
1046 (bitmap_cache[cache*4+2+partial_p] >= 0 \
1047 ? bitmap_cache[cache*4+2+partial_p] \
1048 : (bitmap_cache[cache*4+2+partial_p] = \
1049 get_logical_fringe_bitmap (w, which, 1, partial_p)))
1052 /* Extend top-aligned top indicator (or bottom-aligned bottom
1053 indicator) to adjacent rows if it doesn't fit in one row. */
1054 top_ind_min_y = bot_ind_max_y = -1;
1055 if (top_ind_rn >= 0)
1057 int bn = NO_FRINGE_BITMAP;
1059 row = w->desired_matrix->rows + top_ind_rn;
1060 if (!row->enabled_p)
1061 row = w->current_matrix->rows + top_ind_rn;
1063 top_row_ends_at_zv_p = row->ends_at_zv_p;
1064 if (row->indicate_bob_p)
1066 if (EQ (boundary_top, Qleft))
1067 bn = ((row->indicate_eob_p && EQ (boundary_bot, Qleft))
1068 ? LEFT_FRINGE (1, Qtop_bottom, row->ends_at_zv_p)
1069 : LEFT_FRINGE (2, Qtop, 0));
1070 else
1071 bn = ((row->indicate_eob_p && EQ (boundary_bot, Qright))
1072 ? RIGHT_FRINGE (1, Qtop_bottom, row->ends_at_zv_p)
1073 : RIGHT_FRINGE (2, Qtop, 0));
1075 else if (row->indicate_top_line_p)
1077 if (EQ (arrow_top, Qleft))
1078 bn = LEFT_FRINGE (6, Qup, 0);
1079 else
1080 bn = RIGHT_FRINGE (6, Qup, 0);
1083 if (bn != NO_FRINGE_BITMAP)
1085 struct fringe_bitmap *fb = get_fringe_bitmap_data (bn);
1087 if (fb->align == ALIGN_BITMAP_TOP && fb->period == 0)
1089 struct glyph_row *row1;
1090 int top_ind_max_y;
1092 top_ind_min_y = WINDOW_HEADER_LINE_HEIGHT (w);
1093 top_ind_max_y = top_ind_min_y + fb->height;
1094 if (top_ind_max_y > yb)
1095 top_ind_max_y = yb;
1097 for (y = row->y + row->height, rn = top_ind_rn + 1;
1098 y < top_ind_max_y && rn < nrows;
1099 y += row1->height, rn++)
1101 if (bot_ind_rn >= 0 && rn >= bot_ind_rn)
1102 break;
1104 row1 = w->desired_matrix->rows + rn;
1105 if (!row1->enabled_p)
1106 row1 = w->current_matrix->rows + rn;
1108 row1->indicate_bob_p = row->indicate_bob_p;
1109 row1->indicate_top_line_p = row->indicate_top_line_p;
1114 if (bot_ind_rn >= 0)
1116 int bn = NO_FRINGE_BITMAP;
1118 row = w->desired_matrix->rows + bot_ind_rn;
1119 if (!row->enabled_p)
1120 row = w->current_matrix->rows + bot_ind_rn;
1122 bot_row_ends_at_zv_p = row->ends_at_zv_p;
1123 if (row->indicate_eob_p)
1125 if (EQ (boundary_bot, Qleft))
1126 bn = LEFT_FRINGE (3, Qbottom, row->ends_at_zv_p);
1127 else
1128 bn = RIGHT_FRINGE (3, Qbottom, row->ends_at_zv_p);
1130 else if (row->indicate_bottom_line_p)
1132 if (EQ (arrow_bot, Qleft))
1133 bn = LEFT_FRINGE (7, Qdown, 0);
1134 else
1135 bn = RIGHT_FRINGE (7, Qdown, 0);
1138 if (bn != NO_FRINGE_BITMAP)
1140 struct fringe_bitmap *fb = get_fringe_bitmap_data (bn);
1142 if (fb->align == ALIGN_BITMAP_BOTTOM && fb->period == 0)
1144 struct glyph_row *row1;
1145 int bot_ind_min_y;
1147 bot_ind_max_y = row->y + row->visible_height;
1148 bot_ind_min_y = bot_ind_max_y - fb->height;
1149 if (bot_ind_min_y < WINDOW_HEADER_LINE_HEIGHT (w))
1150 bot_ind_min_y = WINDOW_HEADER_LINE_HEIGHT (w);
1152 for (y = row->y, rn = bot_ind_rn - 1;
1153 y >= bot_ind_min_y && rn >= 0;
1154 y -= row1->height, rn--)
1156 if (top_ind_rn >= 0 && rn <= top_ind_rn)
1157 break;
1159 row1 = w->desired_matrix->rows + rn;
1160 if (!row1->enabled_p)
1161 row1 = w->current_matrix->rows + rn;
1163 row1->indicate_eob_p = row->indicate_eob_p;
1164 row1->indicate_bottom_line_p = row->indicate_bottom_line_p;
1170 for (y = w->vscroll, rn = 0;
1171 y < yb && rn < nrows;
1172 y += row->height, rn++)
1174 int left, right;
1175 unsigned left_face_id, right_face_id;
1176 int left_offset, right_offset;
1177 bool periodic_p;
1179 row = w->desired_matrix->rows + rn;
1180 cur = w->current_matrix->rows + rn;
1181 if (!row->enabled_p)
1182 row = cur;
1184 left_face_id = right_face_id = DEFAULT_FACE_ID;
1185 left_offset = right_offset = 0;
1186 periodic_p = 0;
1188 /* Decide which bitmap to draw in the left fringe. */
1189 if (WINDOW_LEFT_FRINGE_WIDTH (w) == 0)
1190 left = NO_FRINGE_BITMAP;
1191 else if (row->left_user_fringe_bitmap != NO_FRINGE_BITMAP)
1193 left = row->left_user_fringe_bitmap;
1194 left_face_id = row->left_user_fringe_face_id;
1196 else if ((!row->reversed_p && row->truncated_on_left_p)
1197 || (row->reversed_p && row->truncated_on_right_p))
1198 left = LEFT_FRINGE (0, Qtruncation, 0);
1199 else if (row->indicate_bob_p && EQ (boundary_top, Qleft))
1201 left = ((row->indicate_eob_p && EQ (boundary_bot, Qleft))
1202 ? LEFT_FRINGE (1, Qtop_bottom, top_row_ends_at_zv_p)
1203 : LEFT_FRINGE (2, Qtop, 0));
1204 if (top_ind_min_y >= 0)
1205 left_offset = top_ind_min_y - row->y;
1207 else if (row->indicate_eob_p && EQ (boundary_bot, Qleft))
1209 left = LEFT_FRINGE (3, Qbottom, bot_row_ends_at_zv_p);
1210 if (bot_ind_max_y >= 0)
1211 left_offset = bot_ind_max_y - (row->y + row->visible_height);
1213 else if ((!row->reversed_p && MATRIX_ROW_CONTINUATION_LINE_P (row))
1214 || (row->reversed_p && row->continued_p))
1215 left = LEFT_FRINGE (4, Qcontinuation, 0);
1216 else if (row->indicate_empty_line_p && EQ (empty_pos, Qleft))
1217 left = LEFT_FRINGE (5, Qempty_line, 0);
1218 else if (row->indicate_top_line_p && EQ (arrow_top, Qleft))
1220 left = LEFT_FRINGE (6, Qup, 0);
1221 if (top_ind_min_y >= 0)
1222 left_offset = top_ind_min_y - row->y;
1224 else if (row->indicate_bottom_line_p && EQ (arrow_bot, Qleft))
1226 left = LEFT_FRINGE (7, Qdown, 0);
1227 if (bot_ind_max_y >= 0)
1228 left_offset = bot_ind_max_y - (row->y + row->visible_height);
1230 else
1231 left = NO_FRINGE_BITMAP;
1233 /* Decide which bitmap to draw in the right fringe. */
1234 if (WINDOW_RIGHT_FRINGE_WIDTH (w) == 0)
1235 right = NO_FRINGE_BITMAP;
1236 else if (row->right_user_fringe_bitmap != NO_FRINGE_BITMAP)
1238 right = row->right_user_fringe_bitmap;
1239 right_face_id = row->right_user_fringe_face_id;
1241 else if ((!row->reversed_p && row->truncated_on_right_p)
1242 || (row->reversed_p && row->truncated_on_left_p))
1243 right = RIGHT_FRINGE (0, Qtruncation, 0);
1244 else if (row->indicate_bob_p && EQ (boundary_top, Qright))
1246 right = ((row->indicate_eob_p && EQ (boundary_bot, Qright))
1247 ? RIGHT_FRINGE (1, Qtop_bottom, top_row_ends_at_zv_p)
1248 : RIGHT_FRINGE (2, Qtop, 0));
1249 if (top_ind_min_y >= 0)
1250 right_offset = top_ind_min_y - row->y;
1252 else if (row->indicate_eob_p && EQ (boundary_bot, Qright))
1254 right = RIGHT_FRINGE (3, Qbottom, bot_row_ends_at_zv_p);
1255 if (bot_ind_max_y >= 0)
1256 right_offset = bot_ind_max_y - (row->y + row->visible_height);
1258 else if ((!row->reversed_p && row->continued_p)
1259 || (row->reversed_p && MATRIX_ROW_CONTINUATION_LINE_P (row)))
1260 right = RIGHT_FRINGE (4, Qcontinuation, 0);
1261 else if (row->indicate_top_line_p && EQ (arrow_top, Qright))
1263 right = RIGHT_FRINGE (6, Qup, 0);
1264 if (top_ind_min_y >= 0)
1265 right_offset = top_ind_min_y - row->y;
1267 else if (row->indicate_bottom_line_p && EQ (arrow_bot, Qright))
1269 right = RIGHT_FRINGE (7, Qdown, 0);
1270 if (bot_ind_max_y >= 0)
1271 right_offset = bot_ind_max_y - (row->y + row->visible_height);
1273 else if (row->indicate_empty_line_p && EQ (empty_pos, Qright))
1274 right = RIGHT_FRINGE (5, Qempty_line, 0);
1275 else
1276 right = NO_FRINGE_BITMAP;
1278 periodic_p = (get_fringe_bitmap_data (left)->period != 0
1279 || get_fringe_bitmap_data (right)->period != 0);
1281 if (row->y != cur->y
1282 || row->visible_height != cur->visible_height
1283 || row->ends_at_zv_p != cur->ends_at_zv_p
1284 || left != cur->left_fringe_bitmap
1285 || right != cur->right_fringe_bitmap
1286 || left_face_id != cur->left_fringe_face_id
1287 || right_face_id != cur->right_fringe_face_id
1288 || left_offset != cur->left_fringe_offset
1289 || right_offset != cur->right_fringe_offset
1290 || periodic_p != cur->fringe_bitmap_periodic_p
1291 || cur->redraw_fringe_bitmaps_p)
1293 redraw_p = 1, row->redraw_fringe_bitmaps_p = 1;
1294 if (!keep_current_p)
1296 cur->redraw_fringe_bitmaps_p = 1;
1297 cur->left_fringe_bitmap = left;
1298 cur->right_fringe_bitmap = right;
1299 cur->left_fringe_face_id = left_face_id;
1300 cur->right_fringe_face_id = right_face_id;
1301 cur->left_fringe_offset = left_offset;
1302 cur->right_fringe_offset = right_offset;
1303 cur->fringe_bitmap_periodic_p = periodic_p;
1307 if (row->overlay_arrow_bitmap < 0)
1308 row->overlay_arrow_bitmap = get_logical_fringe_bitmap (w, Qoverlay_arrow, 0, 0);
1310 if (row->overlay_arrow_bitmap != cur->overlay_arrow_bitmap)
1312 redraw_p = 1, row->redraw_fringe_bitmaps_p = 1;
1313 if (!keep_current_p)
1315 cur->redraw_fringe_bitmaps_p = 1;
1316 cur->overlay_arrow_bitmap = row->overlay_arrow_bitmap;
1320 row->left_fringe_bitmap = left;
1321 row->right_fringe_bitmap = right;
1322 row->left_fringe_face_id = left_face_id;
1323 row->right_fringe_face_id = right_face_id;
1324 row->left_fringe_offset = left_offset;
1325 row->right_fringe_offset = right_offset;
1326 row->fringe_bitmap_periodic_p = periodic_p;
1329 return redraw_p && !keep_current_p;
1333 /* Compute actual fringe widths for frame F.
1335 If REDRAW is 1, redraw F if the fringe settings was actually
1336 modified and F is visible.
1338 Since the combined left and right fringe must occupy an integral
1339 number of columns, we may need to add some pixels to each fringe.
1340 Typically, we add an equal amount (+/- 1 pixel) to each fringe,
1341 but a negative width value is taken literally (after negating it).
1343 We never make the fringes narrower than specified.
1346 void
1347 compute_fringe_widths (struct frame *f, bool redraw_p)
1349 int o_left = FRAME_LEFT_FRINGE_WIDTH (f);
1350 int o_right = FRAME_RIGHT_FRINGE_WIDTH (f);
1351 int o_cols = FRAME_FRINGE_COLS (f);
1353 Lisp_Object left_fringe = Fassq (Qleft_fringe, f->param_alist);
1354 Lisp_Object right_fringe = Fassq (Qright_fringe, f->param_alist);
1355 int left_fringe_width, right_fringe_width;
1357 if (!NILP (left_fringe))
1358 left_fringe = Fcdr (left_fringe);
1359 if (!NILP (right_fringe))
1360 right_fringe = Fcdr (right_fringe);
1362 left_fringe_width = ((NILP (left_fringe) || !INTEGERP (left_fringe)) ? 8 :
1363 XINT (left_fringe));
1364 right_fringe_width = ((NILP (right_fringe) || !INTEGERP (right_fringe)) ? 8 :
1365 XINT (right_fringe));
1367 if (left_fringe_width || right_fringe_width)
1369 int left_wid = eabs (left_fringe_width);
1370 int right_wid = eabs (right_fringe_width);
1371 int conf_wid = left_wid + right_wid;
1372 int font_wid = FRAME_COLUMN_WIDTH (f);
1373 int cols = (left_wid + right_wid + font_wid-1) / font_wid;
1374 int real_wid = cols * font_wid;
1375 if (left_wid && right_wid)
1377 if (left_fringe_width < 0)
1379 /* Left fringe width is fixed, adjust right fringe if necessary */
1380 FRAME_LEFT_FRINGE_WIDTH (f) = left_wid;
1381 FRAME_RIGHT_FRINGE_WIDTH (f) = real_wid - left_wid;
1383 else if (right_fringe_width < 0)
1385 /* Right fringe width is fixed, adjust left fringe if necessary */
1386 FRAME_LEFT_FRINGE_WIDTH (f) = real_wid - right_wid;
1387 FRAME_RIGHT_FRINGE_WIDTH (f) = right_wid;
1389 else
1391 /* Adjust both fringes with an equal amount.
1392 Note that we are doing integer arithmetic here, so don't
1393 lose a pixel if the total width is an odd number. */
1394 int fill = real_wid - conf_wid;
1395 FRAME_LEFT_FRINGE_WIDTH (f) = left_wid + fill/2;
1396 FRAME_RIGHT_FRINGE_WIDTH (f) = right_wid + fill - fill/2;
1399 else if (left_fringe_width)
1401 FRAME_LEFT_FRINGE_WIDTH (f) = real_wid;
1402 FRAME_RIGHT_FRINGE_WIDTH (f) = 0;
1404 else
1406 FRAME_LEFT_FRINGE_WIDTH (f) = 0;
1407 FRAME_RIGHT_FRINGE_WIDTH (f) = real_wid;
1409 FRAME_FRINGE_COLS (f) = cols;
1411 else
1413 FRAME_LEFT_FRINGE_WIDTH (f) = 0;
1414 FRAME_RIGHT_FRINGE_WIDTH (f) = 0;
1415 FRAME_FRINGE_COLS (f) = 0;
1418 if (redraw_p && FRAME_VISIBLE_P (f))
1419 if (o_left != FRAME_LEFT_FRINGE_WIDTH (f) ||
1420 o_right != FRAME_RIGHT_FRINGE_WIDTH (f) ||
1421 o_cols != FRAME_FRINGE_COLS (f))
1422 redraw_frame (f);
1426 /* Free resources used by a user-defined bitmap. */
1428 static void
1429 destroy_fringe_bitmap (int n)
1431 struct fringe_bitmap **fbp;
1433 fringe_faces[n] = Qnil;
1435 fbp = &fringe_bitmaps[n];
1436 if (*fbp && (*fbp)->dynamic)
1438 /* XXX Is SELECTED_FRAME OK here? */
1439 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1440 if (rif && rif->destroy_fringe_bitmap)
1441 rif->destroy_fringe_bitmap (n);
1442 xfree (*fbp);
1443 *fbp = NULL;
1446 while (max_used_fringe_bitmap > MAX_STANDARD_FRINGE_BITMAPS
1447 && fringe_bitmaps[max_used_fringe_bitmap - 1] == NULL)
1448 max_used_fringe_bitmap--;
1452 DEFUN ("destroy-fringe-bitmap", Fdestroy_fringe_bitmap, Sdestroy_fringe_bitmap,
1453 1, 1, 0,
1454 doc: /* Destroy fringe bitmap BITMAP.
1455 If BITMAP overrides a standard fringe bitmap, the original bitmap is restored. */)
1456 (Lisp_Object bitmap)
1458 int n;
1460 CHECK_SYMBOL (bitmap);
1461 n = lookup_fringe_bitmap (bitmap);
1462 if (!n)
1463 return Qnil;
1465 destroy_fringe_bitmap (n);
1467 if (n >= MAX_STANDARD_FRINGE_BITMAPS)
1469 Vfringe_bitmaps = Fdelq (bitmap, Vfringe_bitmaps);
1470 /* It would be better to remove the fringe property. */
1471 Fput (bitmap, Qfringe, Qnil);
1474 return Qnil;
1478 /* Initialize bitmap bit.
1480 On X, we bit-swap the built-in bitmaps and reduce bitmap
1481 from short to char array if width is <= 8 bits.
1483 On MAC with big-endian CPU, we need to byte-swap each short.
1485 On W32 and MAC (little endian), there's no need to do this.
1488 #if defined (HAVE_X_WINDOWS)
1489 static const unsigned char swap_nibble[16] = {
1490 0x0, 0x8, 0x4, 0xc, /* 0000 1000 0100 1100 */
1491 0x2, 0xa, 0x6, 0xe, /* 0010 1010 0110 1110 */
1492 0x1, 0x9, 0x5, 0xd, /* 0001 1001 0101 1101 */
1493 0x3, 0xb, 0x7, 0xf}; /* 0011 1011 0111 1111 */
1494 #endif /* HAVE_X_WINDOWS */
1496 static void
1497 init_fringe_bitmap (int which, struct fringe_bitmap *fb, int once_p)
1499 if (once_p || fb->dynamic)
1501 #if defined (HAVE_X_WINDOWS)
1502 unsigned short *bits = fb->bits;
1503 int j;
1505 if (fb->width <= 8)
1507 unsigned char *cbits = (unsigned char *)fb->bits;
1508 for (j = 0; j < fb->height; j++)
1510 unsigned short b = *bits++;
1511 unsigned char c;
1512 c = (unsigned char)((swap_nibble[b & 0xf] << 4)
1513 | (swap_nibble[(b>>4) & 0xf]));
1514 *cbits++ = (c >> (8 - fb->width));
1517 else
1519 for (j = 0; j < fb->height; j++)
1521 unsigned short b = *bits;
1522 b = (unsigned short)((swap_nibble[b & 0xf] << 12)
1523 | (swap_nibble[(b>>4) & 0xf] << 8)
1524 | (swap_nibble[(b>>8) & 0xf] << 4)
1525 | (swap_nibble[(b>>12) & 0xf]));
1526 b >>= (16 - fb->width);
1527 #ifdef WORDS_BIGENDIAN
1528 b = bswap_16 (b);
1529 #endif
1530 *bits++ = b;
1533 #endif /* HAVE_X_WINDOWS */
1537 if (!once_p)
1539 /* XXX Is SELECTED_FRAME OK here? */
1540 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1542 destroy_fringe_bitmap (which);
1544 if (rif && rif->define_fringe_bitmap)
1545 rif->define_fringe_bitmap (which, fb->bits, fb->height, fb->width);
1547 fringe_bitmaps[which] = fb;
1548 if (which >= max_used_fringe_bitmap)
1549 max_used_fringe_bitmap = which + 1;
1554 DEFUN ("define-fringe-bitmap", Fdefine_fringe_bitmap, Sdefine_fringe_bitmap,
1555 2, 5, 0,
1556 doc: /* Define fringe bitmap BITMAP from BITS of size HEIGHT x WIDTH.
1557 BITMAP is a symbol identifying the new fringe bitmap.
1558 BITS is either a string or a vector of integers.
1559 HEIGHT is height of bitmap. If HEIGHT is nil, use length of BITS.
1560 WIDTH must be an integer between 1 and 16, or nil which defaults to 8.
1561 Optional fifth arg ALIGN may be one of `top', `center', or `bottom',
1562 indicating the positioning of the bitmap relative to the rows where it
1563 is used; the default is to center the bitmap. Fifth arg may also be a
1564 list (ALIGN PERIODIC) where PERIODIC non-nil specifies that the bitmap
1565 should be repeated.
1566 If BITMAP already exists, the existing definition is replaced. */)
1567 (Lisp_Object bitmap, Lisp_Object bits, Lisp_Object height, Lisp_Object width, Lisp_Object align)
1569 int n, h, i, j;
1570 unsigned short *b;
1571 struct fringe_bitmap fb, *xfb;
1572 int fill1 = 0, fill2 = 0;
1574 CHECK_SYMBOL (bitmap);
1576 if (STRINGP (bits))
1577 h = SCHARS (bits);
1578 else if (VECTORP (bits))
1579 h = ASIZE (bits);
1580 else
1581 wrong_type_argument (Qsequencep, bits);
1583 if (NILP (height))
1584 fb.height = h;
1585 else
1587 CHECK_NUMBER (height);
1588 fb.height = max (0, min (XINT (height), 255));
1589 if (fb.height > h)
1591 fill1 = (fb.height - h) / 2;
1592 fill2 = fb.height - h - fill1;
1596 if (NILP (width))
1597 fb.width = 8;
1598 else
1600 CHECK_NUMBER (width);
1601 fb.width = max (0, min (XINT (width), 255));
1604 fb.period = 0;
1605 fb.align = ALIGN_BITMAP_CENTER;
1607 if (CONSP (align))
1609 Lisp_Object period = XCDR (align);
1610 if (CONSP (period))
1612 period = XCAR (period);
1613 if (!NILP (period))
1615 fb.period = fb.height;
1616 fb.height = 255;
1619 align = XCAR (align);
1621 if (EQ (align, Qtop))
1622 fb.align = ALIGN_BITMAP_TOP;
1623 else if (EQ (align, Qbottom))
1624 fb.align = ALIGN_BITMAP_BOTTOM;
1625 else if (!NILP (align) && !EQ (align, Qcenter))
1626 error ("Bad align argument");
1628 n = lookup_fringe_bitmap (bitmap);
1629 if (!n)
1631 if (max_used_fringe_bitmap < max_fringe_bitmaps)
1632 n = max_used_fringe_bitmap++;
1633 else
1635 for (n = MAX_STANDARD_FRINGE_BITMAPS;
1636 n < max_fringe_bitmaps;
1637 n++)
1638 if (fringe_bitmaps[n] == NULL)
1639 break;
1641 if (n == max_fringe_bitmaps)
1643 int bitmaps = max_fringe_bitmaps + 20;
1644 if (MAX_FRINGE_BITMAPS < bitmaps)
1645 error ("No free fringe bitmap slots");
1647 i = max_fringe_bitmaps;
1648 fringe_bitmaps = xrealloc (fringe_bitmaps,
1649 bitmaps * sizeof *fringe_bitmaps);
1650 fringe_faces = xrealloc (fringe_faces,
1651 bitmaps * sizeof *fringe_faces);
1653 for (i = max_fringe_bitmaps; i < bitmaps; i++)
1655 fringe_bitmaps[i] = NULL;
1656 fringe_faces[i] = Qnil;
1659 max_fringe_bitmaps = bitmaps;
1663 Vfringe_bitmaps = Fcons (bitmap, Vfringe_bitmaps);
1664 Fput (bitmap, Qfringe, make_number (n));
1667 fb.dynamic = true;
1669 xfb = xmalloc (sizeof fb + fb.height * BYTES_PER_BITMAP_ROW);
1670 fb.bits = b = (unsigned short *) (xfb + 1);
1671 memset (b, 0, fb.height);
1673 j = 0;
1674 while (j < fb.height)
1676 for (i = 0; i < fill1 && j < fb.height; i++)
1677 b[j++] = 0;
1678 for (i = 0; i < h && j < fb.height; i++)
1680 Lisp_Object elt = Faref (bits, make_number (i));
1681 b[j++] = NUMBERP (elt) ? XINT (elt) : 0;
1683 for (i = 0; i < fill2 && j < fb.height; i++)
1684 b[j++] = 0;
1687 *xfb = fb;
1689 init_fringe_bitmap (n, xfb, 0);
1691 return bitmap;
1694 DEFUN ("set-fringe-bitmap-face", Fset_fringe_bitmap_face, Sset_fringe_bitmap_face,
1695 1, 2, 0,
1696 doc: /* Set face for fringe bitmap BITMAP to FACE.
1697 FACE is merged with the `fringe' face, so normally FACE should specify
1698 only the foreground color.
1699 If FACE is nil, reset face to default fringe face. */)
1700 (Lisp_Object bitmap, Lisp_Object face)
1702 int n;
1704 CHECK_SYMBOL (bitmap);
1705 n = lookup_fringe_bitmap (bitmap);
1706 if (!n)
1707 error ("Undefined fringe bitmap");
1709 /* The purpose of the following code is to signal an error if FACE
1710 is not a face. This is for the caller's convenience only; the
1711 redisplay code should be able to fail gracefully. Skip the check
1712 if FRINGE_FACE_ID is unrealized (as in batch mode and during
1713 daemon startup). */
1714 if (!NILP (face))
1716 struct frame *f = SELECTED_FRAME ();
1718 if (FACE_FROM_ID (f, FRINGE_FACE_ID)
1719 && lookup_derived_face (f, face, FRINGE_FACE_ID, 1) < 0)
1720 error ("No such face");
1723 fringe_faces[n] = face;
1724 return Qnil;
1727 DEFUN ("fringe-bitmaps-at-pos", Ffringe_bitmaps_at_pos, Sfringe_bitmaps_at_pos,
1728 0, 2, 0,
1729 doc: /* Return fringe bitmaps of row containing position POS in window WINDOW.
1730 If WINDOW is nil, use selected window. If POS is nil, use value of point
1731 in that window. Return value is a list (LEFT RIGHT OV), where LEFT
1732 is the symbol for the bitmap in the left fringe (or nil if no bitmap),
1733 RIGHT is similar for the right fringe, and OV is non-nil if there is an
1734 overlay arrow in the left fringe.
1735 Return nil if POS is not visible in WINDOW. */)
1736 (Lisp_Object pos, Lisp_Object window)
1738 struct window *w;
1739 struct glyph_row *row;
1740 ptrdiff_t textpos;
1742 w = decode_any_window (window);
1743 XSETWINDOW (window, w);
1745 if (!NILP (pos))
1747 CHECK_NUMBER_COERCE_MARKER (pos);
1748 if (! (BEGV <= XINT (pos) && XINT (pos) <= ZV))
1749 args_out_of_range (window, pos);
1750 textpos = XINT (pos);
1752 else if (w == XWINDOW (selected_window))
1753 textpos = PT;
1754 else
1755 textpos = marker_position (w->pointm);
1757 row = MATRIX_FIRST_TEXT_ROW (w->current_matrix);
1758 row = row_containing_pos (w, textpos, row, NULL, 0);
1759 if (row)
1760 return list3 (get_fringe_bitmap_name (row->left_fringe_bitmap),
1761 get_fringe_bitmap_name (row->right_fringe_bitmap),
1762 (row->overlay_arrow_bitmap == 0 ? Qnil
1763 : row->overlay_arrow_bitmap < 0 ? Qt
1764 : get_fringe_bitmap_name (row->overlay_arrow_bitmap)));
1765 else
1766 return Qnil;
1770 /***********************************************************************
1771 Initialization
1772 ***********************************************************************/
1774 void
1775 syms_of_fringe (void)
1777 DEFSYM (Qtruncation, "truncation");
1778 DEFSYM (Qcontinuation, "continuation");
1779 DEFSYM (Qoverlay_arrow, "overlay-arrow");
1780 DEFSYM (Qempty_line, "empty-line");
1781 DEFSYM (Qtop_bottom, "top-bottom");
1782 DEFSYM (Qhollow_small, "hollow-small");
1784 defsubr (&Sdestroy_fringe_bitmap);
1785 defsubr (&Sdefine_fringe_bitmap);
1786 defsubr (&Sfringe_bitmaps_at_pos);
1787 defsubr (&Sset_fringe_bitmap_face);
1789 DEFVAR_LISP ("overflow-newline-into-fringe", Voverflow_newline_into_fringe,
1790 doc: /* Non-nil means that newline may flow into the right fringe.
1791 This means that display lines which are exactly as wide as the window
1792 (not counting the final newline) will only occupy one screen line, by
1793 showing (or hiding) the final newline in the right fringe; when point
1794 is at the final newline, the cursor is shown in the right fringe.
1795 If nil, also continue lines which are exactly as wide as the window. */);
1796 Voverflow_newline_into_fringe = Qt;
1798 DEFVAR_LISP ("fringe-bitmaps", Vfringe_bitmaps,
1799 doc: /* List of fringe bitmap symbols. */);
1800 Vfringe_bitmaps = Qnil;
1803 /* Garbage collection hook */
1805 void
1806 mark_fringe_data (void)
1808 int i;
1810 for (i = 0; i < max_fringe_bitmaps; i++)
1811 if (!NILP (fringe_faces[i]))
1812 mark_object (fringe_faces[i]);
1815 /* Initialize this module when Emacs starts. */
1817 void
1818 init_fringe_once (void)
1820 int bt;
1822 for (bt = NO_FRINGE_BITMAP + 1; bt < MAX_STANDARD_FRINGE_BITMAPS; bt++)
1823 init_fringe_bitmap (bt, &standard_bitmaps[bt], 1);
1826 void
1827 init_fringe (void)
1829 int i;
1831 max_fringe_bitmaps = MAX_STANDARD_FRINGE_BITMAPS + 20;
1833 fringe_bitmaps = xzalloc (max_fringe_bitmaps * sizeof *fringe_bitmaps);
1834 fringe_faces = xmalloc (max_fringe_bitmaps * sizeof *fringe_faces);
1836 for (i = 0; i < max_fringe_bitmaps; i++)
1837 fringe_faces[i] = Qnil;
1840 #ifdef HAVE_NTGUI
1842 void
1843 w32_init_fringe (struct redisplay_interface *rif)
1845 int bt;
1847 if (!rif)
1848 return;
1850 for (bt = NO_FRINGE_BITMAP + 1; bt < MAX_STANDARD_FRINGE_BITMAPS; bt++)
1852 struct fringe_bitmap *fb = &standard_bitmaps[bt];
1853 rif->define_fringe_bitmap (bt, fb->bits, fb->height, fb->width);
1857 void
1858 w32_reset_fringes (void)
1860 /* Destroy row bitmaps. */
1861 int bt;
1862 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1864 if (!rif)
1865 return;
1867 for (bt = NO_FRINGE_BITMAP + 1; bt < max_used_fringe_bitmap; bt++)
1868 rif->destroy_fringe_bitmap (bt);
1871 #endif /* HAVE_NTGUI */