* etc/NEWS, doc/lispref/tips.texi (Coding Conventions): Mention
[emacs.git] / src / fringe.c
blobf728cd6d5ffcddb46f33191e53752e1ddb2ea809
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 "lisp.h"
24 #include "frame.h"
25 #include "window.h"
26 #include "dispextern.h"
27 #include "character.h"
28 #include "buffer.h"
29 #include "blockinput.h"
30 #include "termhooks.h"
32 #ifdef HAVE_WINDOW_SYSTEM
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 unsigned 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 && !WINDOW_HAS_VERTICAL_SCROLL_BAR (w)
663 /* But don't reduce the fringe width if the window
664 has a left margin, because that means we are not
665 in danger of drawing over the vertical border,
666 and OTOH leaving out that one pixel leaves behind
667 traces of the cursor, if it was in column zero
668 before drawing non-empty margin area. */
669 && NILP (w->left_margin_cols))
670 ? 1 : 0);
671 p.bx = x - wd;
672 p.nx = wd;
675 else
677 int x = window_box_right (w,
678 (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w)
679 ? RIGHT_MARGIN_AREA
680 : TEXT_AREA));
681 int wd = WINDOW_RIGHT_FRINGE_WIDTH (w);
682 if (p.wd > wd)
683 p.wd = wd;
684 p.x = x + (wd - p.wd) / 2;
685 /* Clear right fringe if no bitmap to draw of if bitmap doesn't fill
686 the fringe. */
687 if (p.wd < wd || p.y > p.by || p.y + p.h < p.by + p.ny)
689 p.bx = x;
690 p.nx = wd;
694 FRAME_RIF (f)->draw_fringe_bitmap (w, row, &p);
697 static int
698 get_logical_cursor_bitmap (struct window *w, Lisp_Object cursor)
700 Lisp_Object cmap, bm = Qnil;
702 if ((cmap = BVAR (XBUFFER (w->contents), fringe_cursor_alist)), !NILP (cmap))
704 bm = Fassq (cursor, cmap);
705 if (CONSP (bm))
707 if ((bm = XCDR (bm)), NILP (bm))
708 return NO_FRINGE_BITMAP;
709 return lookup_fringe_bitmap (bm);
712 if (EQ (cmap, BVAR (&buffer_defaults, fringe_cursor_alist)))
713 return NO_FRINGE_BITMAP;
714 bm = Fassq (cursor, BVAR (&buffer_defaults, fringe_cursor_alist));
715 if (!CONSP (bm) || ((bm = XCDR (bm)), NILP (bm)))
716 return NO_FRINGE_BITMAP;
717 return lookup_fringe_bitmap (bm);
720 static int
721 get_logical_fringe_bitmap (struct window *w, Lisp_Object bitmap, int right_p, int partial_p)
723 Lisp_Object cmap, bm1 = Qnil, bm2 = Qnil, bm;
724 EMACS_INT ln1 = 0, ln2 = 0;
725 int ix1 = right_p;
726 int ix2 = ix1 + (partial_p ? 2 : 0);
728 /* Lookup in buffer-local fringe-indicator-alist before global alist.
730 Elements are:
731 BITMAP -- use for all
732 (L R) -- use for left right (whether partial or not)
733 (L R PL PR) -- use for left right partial-left partial-right
734 If any value in local binding is not present or t, use global value.
736 If partial, lookup partial bitmap in default value if not found here.
737 If not partial, or no partial spec is present, use non-partial bitmap. */
739 if ((cmap = BVAR (XBUFFER (w->contents), fringe_indicator_alist)), !NILP (cmap))
741 bm1 = Fassq (bitmap, cmap);
742 if (CONSP (bm1))
744 if ((bm1 = XCDR (bm1)), NILP (bm1))
745 return NO_FRINGE_BITMAP;
746 if (CONSP (bm1))
748 ln1 = XINT (Flength (bm1));
749 if (partial_p)
751 if (ln1 > ix2)
753 bm = Fnth (make_number (ix2), bm1);
754 if (!EQ (bm, Qt))
755 goto found;
758 else
760 if (ln1 > ix1)
762 bm = Fnth (make_number (ix1), bm1);
763 if (!EQ (bm, Qt))
764 goto found;
768 else if ((bm = bm1, !EQ (bm, Qt)))
769 goto found;
773 if (!EQ (cmap, BVAR (&buffer_defaults, fringe_indicator_alist))
774 && !NILP (BVAR (&buffer_defaults, fringe_indicator_alist)))
776 bm2 = Fassq (bitmap, BVAR (&buffer_defaults, fringe_indicator_alist));
777 if (CONSP (bm2))
779 if ((bm2 = XCDR (bm2)), !NILP (bm2))
781 if (CONSP (bm2))
783 ln2 = XINT (Flength (bm2));
784 if (partial_p)
786 if (ln2 > ix2)
788 bm = Fnth (make_number (ix2), bm2);
789 if (!EQ (bm, Qt))
790 goto found;
798 if (ln1 > ix1)
800 bm = Fnth (make_number (ix1), bm1);
801 if (!EQ (bm, Qt))
802 goto found;
805 if (ln2 > ix1)
807 bm = Fnth (make_number (ix1), bm2);
808 if (!EQ (bm, Qt))
809 goto found;
810 return NO_FRINGE_BITMAP;
812 else if ((bm = bm2, NILP (bm)))
813 return NO_FRINGE_BITMAP;
815 found:
816 return lookup_fringe_bitmap (bm);
820 void
821 draw_fringe_bitmap (struct window *w, struct glyph_row *row, int left_p)
823 int overlay = 0;
825 if (left_p == row->reversed_p && row->cursor_in_fringe_p)
827 Lisp_Object cursor = Qnil;
829 switch (w->phys_cursor_type)
831 case HOLLOW_BOX_CURSOR:
832 if (row->visible_height >= STANDARD_BITMAP_HEIGHT (hollow_rectangle_bits))
833 cursor = Qhollow;
834 else
835 cursor = Qhollow_small;
836 break;
837 case FILLED_BOX_CURSOR:
838 cursor = Qbox;
839 break;
840 case BAR_CURSOR:
841 cursor = Qbar;
842 break;
843 case HBAR_CURSOR:
844 cursor = Qhbar;
845 break;
846 case NO_CURSOR:
847 default:
848 w->phys_cursor_on_p = 0;
849 row->cursor_in_fringe_p = 0;
850 break;
852 if (!NILP (cursor))
854 int bm = get_logical_cursor_bitmap (w, cursor);
855 if (bm != NO_FRINGE_BITMAP)
857 draw_fringe_bitmap_1 (w, row, left_p, 2, bm);
858 overlay = EQ (cursor, Qbox) ? 3 : 1;
863 draw_fringe_bitmap_1 (w, row, left_p, overlay, NO_FRINGE_BITMAP);
865 if (left_p && row->overlay_arrow_bitmap != NO_FRINGE_BITMAP)
866 draw_fringe_bitmap_1 (w, row, 1, 1, row->overlay_arrow_bitmap);
870 /* Draw fringe bitmaps for glyph row ROW on window W. Call this
871 function with input blocked. */
873 void
874 draw_row_fringe_bitmaps (struct window *w, struct glyph_row *row)
876 eassert (input_blocked_p ());
878 /* If row is completely invisible, because of vscrolling, we
879 don't have to draw anything. */
880 if (row->visible_height <= 0)
881 return;
883 if (WINDOW_LEFT_FRINGE_WIDTH (w) != 0)
884 draw_fringe_bitmap (w, row, 1);
886 if (WINDOW_RIGHT_FRINGE_WIDTH (w) != 0)
887 draw_fringe_bitmap (w, row, 0);
890 /* Draw the fringes of window W. Only fringes for rows marked for
891 update in redraw_fringe_bitmaps_p are drawn.
893 Return >0 if left or right fringe was redrawn in any way.
895 If NO_FRINGE is non-zero, also return >0 if either fringe has zero width.
897 A return value >0 indicates that the vertical line between windows
898 needs update (as it may be drawn in the fringe).
902 draw_window_fringes (struct window *w, int no_fringe)
904 struct glyph_row *row;
905 int yb = window_text_bottom_y (w);
906 int nrows = w->current_matrix->nrows;
907 int y, rn;
908 int updated = 0;
910 if (w->pseudo_window_p)
911 return 0;
913 /* Must draw line if no fringe */
914 if (no_fringe
915 && (WINDOW_LEFT_FRINGE_WIDTH (w) == 0
916 || WINDOW_RIGHT_FRINGE_WIDTH (w) == 0))
917 updated++;
919 for (y = w->vscroll, rn = 0, row = w->current_matrix->rows;
920 y < yb && rn < nrows;
921 y += row->height, ++row, ++rn)
923 if (!row->redraw_fringe_bitmaps_p)
924 continue;
925 draw_row_fringe_bitmaps (w, row);
926 row->redraw_fringe_bitmaps_p = 0;
927 updated++;
930 return updated;
934 /* Recalculate the bitmaps to show in the fringes of window W.
935 Only mark rows with modified bitmaps for update in redraw_fringe_bitmaps_p.
937 If KEEP_CURRENT_P is 0, update current_matrix too. */
940 update_window_fringes (struct window *w, int keep_current_p)
942 struct glyph_row *row, *cur = 0;
943 int yb = window_text_bottom_y (w);
944 int rn, nrows = w->current_matrix->nrows;
945 int y;
946 int redraw_p = 0;
947 Lisp_Object boundary_top = Qnil, boundary_bot = Qnil;
948 Lisp_Object arrow_top = Qnil, arrow_bot = Qnil;
949 Lisp_Object empty_pos;
950 Lisp_Object ind = Qnil;
951 #define MAX_BITMAP_CACHE (8*4)
952 int bitmap_cache[MAX_BITMAP_CACHE];
953 int top_ind_rn, bot_ind_rn;
954 int top_ind_min_y, bot_ind_max_y;
956 /* top_ind_rn is set to a nonnegative value whenever
957 row->indicate_bob_p is set, so it's OK that top_row_ends_at_zv_p
958 is not initialized here. Similarly for bot_ind_rn,
959 row->indicate_eob_p and bot_row_ends_at_zv_p. */
960 int top_row_ends_at_zv_p IF_LINT (= 0), bot_row_ends_at_zv_p IF_LINT (= 0);
962 if (w->pseudo_window_p)
963 return 0;
965 if (!MINI_WINDOW_P (w)
966 && (ind = BVAR (XBUFFER (w->contents), indicate_buffer_boundaries), !NILP (ind)))
968 if (EQ (ind, Qleft) || EQ (ind, Qright))
969 boundary_top = boundary_bot = arrow_top = arrow_bot = ind;
970 else if (CONSP (ind) && CONSP (XCAR (ind)))
972 Lisp_Object pos;
973 if (pos = Fassq (Qt, ind), !NILP (pos))
974 boundary_top = boundary_bot = arrow_top = arrow_bot = XCDR (pos);
975 if (pos = Fassq (Qtop, ind), !NILP (pos))
976 boundary_top = XCDR (pos);
977 if (pos = Fassq (Qbottom, ind), !NILP (pos))
978 boundary_bot = XCDR (pos);
979 if (pos = Fassq (Qup, ind), !NILP (pos))
980 arrow_top = XCDR (pos);
981 if (pos = Fassq (Qdown, ind), !NILP (pos))
982 arrow_bot = XCDR (pos);
984 else
985 /* Anything else means boundary on left and no arrows. */
986 boundary_top = boundary_bot = Qleft;
989 top_ind_rn = bot_ind_rn = -1;
990 if (!NILP (ind))
992 for (y = w->vscroll, rn = 0;
993 y < yb && rn < nrows;
994 y += row->height, ++rn)
996 row = w->desired_matrix->rows + rn;
997 if (!row->enabled_p)
998 row = w->current_matrix->rows + rn;
1000 row->indicate_bob_p = row->indicate_top_line_p = 0;
1001 row->indicate_eob_p = row->indicate_bottom_line_p = 0;
1003 if (!row->mode_line_p)
1005 if (top_ind_rn < 0 && row->visible_height > 0)
1007 if (MATRIX_ROW_START_CHARPOS (row) <= BUF_BEGV (XBUFFER (w->contents))
1008 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_TOP_P (w, row))
1009 row->indicate_bob_p = !NILP (boundary_top);
1010 else
1011 row->indicate_top_line_p = !NILP (arrow_top);
1012 top_ind_rn = rn;
1015 if (bot_ind_rn < 0)
1017 if (MATRIX_ROW_END_CHARPOS (row) >= BUF_ZV (XBUFFER (w->contents))
1018 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_BOTTOM_P (w, row))
1019 row->indicate_eob_p = !NILP (boundary_bot), bot_ind_rn = rn;
1020 else if (y + row->height >= yb)
1021 row->indicate_bottom_line_p = !NILP (arrow_bot), bot_ind_rn = rn;
1027 empty_pos = BVAR (XBUFFER (w->contents), indicate_empty_lines);
1028 if (!NILP (empty_pos) && !EQ (empty_pos, Qright))
1029 empty_pos = WINDOW_LEFT_FRINGE_WIDTH (w) == 0 ? Qright : Qleft;
1031 for (y = 0; y < MAX_BITMAP_CACHE; y++)
1032 bitmap_cache[y] = -1;
1034 #define LEFT_FRINGE(cache, which, partial_p) \
1035 (bitmap_cache[cache*4+partial_p] >= 0 \
1036 ? bitmap_cache[cache*4+partial_p] \
1037 : (bitmap_cache[cache*4+partial_p] = \
1038 get_logical_fringe_bitmap (w, which, 0, partial_p)))
1040 #define RIGHT_FRINGE(cache, which, partial_p) \
1041 (bitmap_cache[cache*4+2+partial_p] >= 0 \
1042 ? bitmap_cache[cache*4+2+partial_p] \
1043 : (bitmap_cache[cache*4+2+partial_p] = \
1044 get_logical_fringe_bitmap (w, which, 1, partial_p)))
1047 /* Extend top-aligned top indicator (or bottom-aligned bottom
1048 indicator) to adjacent rows if it doesn't fit in one row. */
1049 top_ind_min_y = bot_ind_max_y = -1;
1050 if (top_ind_rn >= 0)
1052 int bn = NO_FRINGE_BITMAP;
1054 row = w->desired_matrix->rows + top_ind_rn;
1055 if (!row->enabled_p)
1056 row = w->current_matrix->rows + top_ind_rn;
1058 top_row_ends_at_zv_p = row->ends_at_zv_p;
1059 if (row->indicate_bob_p)
1061 if (EQ (boundary_top, Qleft))
1062 bn = ((row->indicate_eob_p && EQ (boundary_bot, Qleft))
1063 ? LEFT_FRINGE (1, Qtop_bottom, row->ends_at_zv_p)
1064 : LEFT_FRINGE (2, Qtop, 0));
1065 else
1066 bn = ((row->indicate_eob_p && EQ (boundary_bot, Qright))
1067 ? RIGHT_FRINGE (1, Qtop_bottom, row->ends_at_zv_p)
1068 : RIGHT_FRINGE (2, Qtop, 0));
1070 else if (row->indicate_top_line_p)
1072 if (EQ (arrow_top, Qleft))
1073 bn = LEFT_FRINGE (6, Qup, 0);
1074 else
1075 bn = RIGHT_FRINGE (6, Qup, 0);
1078 if (bn != NO_FRINGE_BITMAP)
1080 struct fringe_bitmap *fb = get_fringe_bitmap_data (bn);
1082 if (fb->align == ALIGN_BITMAP_TOP && fb->period == 0)
1084 struct glyph_row *row1;
1085 int top_ind_max_y;
1087 top_ind_min_y = WINDOW_HEADER_LINE_HEIGHT (w);
1088 top_ind_max_y = top_ind_min_y + fb->height;
1089 if (top_ind_max_y > yb)
1090 top_ind_max_y = yb;
1092 for (y = row->y + row->height, rn = top_ind_rn + 1;
1093 y < top_ind_max_y && rn < nrows;
1094 y += row1->height, rn++)
1096 if (bot_ind_rn >= 0 && rn >= bot_ind_rn)
1097 break;
1099 row1 = w->desired_matrix->rows + rn;
1100 if (!row1->enabled_p)
1101 row1 = w->current_matrix->rows + rn;
1103 row1->indicate_bob_p = row->indicate_bob_p;
1104 row1->indicate_top_line_p = row->indicate_top_line_p;
1109 if (bot_ind_rn >= 0)
1111 int bn = NO_FRINGE_BITMAP;
1113 row = w->desired_matrix->rows + bot_ind_rn;
1114 if (!row->enabled_p)
1115 row = w->current_matrix->rows + bot_ind_rn;
1117 bot_row_ends_at_zv_p = row->ends_at_zv_p;
1118 if (row->indicate_eob_p)
1120 if (EQ (boundary_bot, Qleft))
1121 bn = LEFT_FRINGE (3, Qbottom, row->ends_at_zv_p);
1122 else
1123 bn = RIGHT_FRINGE (3, Qbottom, row->ends_at_zv_p);
1125 else if (row->indicate_bottom_line_p)
1127 if (EQ (arrow_bot, Qleft))
1128 bn = LEFT_FRINGE (7, Qdown, 0);
1129 else
1130 bn = RIGHT_FRINGE (7, Qdown, 0);
1133 if (bn != NO_FRINGE_BITMAP)
1135 struct fringe_bitmap *fb = get_fringe_bitmap_data (bn);
1137 if (fb->align == ALIGN_BITMAP_BOTTOM && fb->period == 0)
1139 struct glyph_row *row1;
1140 int bot_ind_min_y;
1142 bot_ind_max_y = row->y + row->visible_height;
1143 bot_ind_min_y = bot_ind_max_y - fb->height;
1144 if (bot_ind_min_y < WINDOW_HEADER_LINE_HEIGHT (w))
1145 bot_ind_min_y = WINDOW_HEADER_LINE_HEIGHT (w);
1147 for (y = row->y, rn = bot_ind_rn - 1;
1148 y >= bot_ind_min_y && rn >= 0;
1149 y -= row1->height, rn--)
1151 if (top_ind_rn >= 0 && rn <= top_ind_rn)
1152 break;
1154 row1 = w->desired_matrix->rows + rn;
1155 if (!row1->enabled_p)
1156 row1 = w->current_matrix->rows + rn;
1158 row1->indicate_eob_p = row->indicate_eob_p;
1159 row1->indicate_bottom_line_p = row->indicate_bottom_line_p;
1165 for (y = w->vscroll, rn = 0;
1166 y < yb && rn < nrows;
1167 y += row->height, rn++)
1169 int left, right;
1170 unsigned left_face_id, right_face_id;
1171 int left_offset, right_offset;
1172 int periodic_p;
1174 row = w->desired_matrix->rows + rn;
1175 cur = w->current_matrix->rows + rn;
1176 if (!row->enabled_p)
1177 row = cur;
1179 left_face_id = right_face_id = DEFAULT_FACE_ID;
1180 left_offset = right_offset = 0;
1181 periodic_p = 0;
1183 /* Decide which bitmap to draw in the left fringe. */
1184 if (WINDOW_LEFT_FRINGE_WIDTH (w) == 0)
1185 left = NO_FRINGE_BITMAP;
1186 else if (row->left_user_fringe_bitmap != NO_FRINGE_BITMAP)
1188 left = row->left_user_fringe_bitmap;
1189 left_face_id = row->left_user_fringe_face_id;
1191 else if ((!row->reversed_p && row->truncated_on_left_p)
1192 || (row->reversed_p && row->truncated_on_right_p))
1193 left = LEFT_FRINGE (0, Qtruncation, 0);
1194 else if (row->indicate_bob_p && EQ (boundary_top, Qleft))
1196 left = ((row->indicate_eob_p && EQ (boundary_bot, Qleft))
1197 ? LEFT_FRINGE (1, Qtop_bottom, top_row_ends_at_zv_p)
1198 : LEFT_FRINGE (2, Qtop, 0));
1199 if (top_ind_min_y >= 0)
1200 left_offset = top_ind_min_y - row->y;
1202 else if (row->indicate_eob_p && EQ (boundary_bot, Qleft))
1204 left = LEFT_FRINGE (3, Qbottom, bot_row_ends_at_zv_p);
1205 if (bot_ind_max_y >= 0)
1206 left_offset = bot_ind_max_y - (row->y + row->visible_height);
1208 else if ((!row->reversed_p && MATRIX_ROW_CONTINUATION_LINE_P (row))
1209 || (row->reversed_p && row->continued_p))
1210 left = LEFT_FRINGE (4, Qcontinuation, 0);
1211 else if (row->indicate_empty_line_p && EQ (empty_pos, Qleft))
1212 left = LEFT_FRINGE (5, Qempty_line, 0);
1213 else if (row->indicate_top_line_p && EQ (arrow_top, Qleft))
1215 left = LEFT_FRINGE (6, Qup, 0);
1216 if (top_ind_min_y >= 0)
1217 left_offset = top_ind_min_y - row->y;
1219 else if (row->indicate_bottom_line_p && EQ (arrow_bot, Qleft))
1221 left = LEFT_FRINGE (7, Qdown, 0);
1222 if (bot_ind_max_y >= 0)
1223 left_offset = bot_ind_max_y - (row->y + row->visible_height);
1225 else
1226 left = NO_FRINGE_BITMAP;
1228 /* Decide which bitmap to draw in the right fringe. */
1229 if (WINDOW_RIGHT_FRINGE_WIDTH (w) == 0)
1230 right = NO_FRINGE_BITMAP;
1231 else if (row->right_user_fringe_bitmap != NO_FRINGE_BITMAP)
1233 right = row->right_user_fringe_bitmap;
1234 right_face_id = row->right_user_fringe_face_id;
1236 else if ((!row->reversed_p && row->truncated_on_right_p)
1237 || (row->reversed_p && row->truncated_on_left_p))
1238 right = RIGHT_FRINGE (0, Qtruncation, 0);
1239 else if (row->indicate_bob_p && EQ (boundary_top, Qright))
1241 right = ((row->indicate_eob_p && EQ (boundary_bot, Qright))
1242 ? RIGHT_FRINGE (1, Qtop_bottom, top_row_ends_at_zv_p)
1243 : RIGHT_FRINGE (2, Qtop, 0));
1244 if (top_ind_min_y >= 0)
1245 right_offset = top_ind_min_y - row->y;
1247 else if (row->indicate_eob_p && EQ (boundary_bot, Qright))
1249 right = RIGHT_FRINGE (3, Qbottom, bot_row_ends_at_zv_p);
1250 if (bot_ind_max_y >= 0)
1251 right_offset = bot_ind_max_y - (row->y + row->visible_height);
1253 else if ((!row->reversed_p && row->continued_p)
1254 || (row->reversed_p && MATRIX_ROW_CONTINUATION_LINE_P (row)))
1255 right = RIGHT_FRINGE (4, Qcontinuation, 0);
1256 else if (row->indicate_top_line_p && EQ (arrow_top, Qright))
1258 right = RIGHT_FRINGE (6, Qup, 0);
1259 if (top_ind_min_y >= 0)
1260 right_offset = top_ind_min_y - row->y;
1262 else if (row->indicate_bottom_line_p && EQ (arrow_bot, Qright))
1264 right = RIGHT_FRINGE (7, Qdown, 0);
1265 if (bot_ind_max_y >= 0)
1266 right_offset = bot_ind_max_y - (row->y + row->visible_height);
1268 else if (row->indicate_empty_line_p && EQ (empty_pos, Qright))
1269 right = RIGHT_FRINGE (5, Qempty_line, 0);
1270 else
1271 right = NO_FRINGE_BITMAP;
1273 periodic_p = (get_fringe_bitmap_data (left)->period != 0
1274 || get_fringe_bitmap_data (right)->period != 0);
1276 if (row->y != cur->y
1277 || row->visible_height != cur->visible_height
1278 || row->ends_at_zv_p != cur->ends_at_zv_p
1279 || left != cur->left_fringe_bitmap
1280 || right != cur->right_fringe_bitmap
1281 || left_face_id != cur->left_fringe_face_id
1282 || right_face_id != cur->right_fringe_face_id
1283 || left_offset != cur->left_fringe_offset
1284 || right_offset != cur->right_fringe_offset
1285 || periodic_p != cur->fringe_bitmap_periodic_p
1286 || cur->redraw_fringe_bitmaps_p)
1288 redraw_p = row->redraw_fringe_bitmaps_p = 1;
1289 if (!keep_current_p)
1291 cur->redraw_fringe_bitmaps_p = 1;
1292 cur->left_fringe_bitmap = left;
1293 cur->right_fringe_bitmap = right;
1294 cur->left_fringe_face_id = left_face_id;
1295 cur->right_fringe_face_id = right_face_id;
1296 cur->left_fringe_offset = left_offset;
1297 cur->right_fringe_offset = right_offset;
1298 cur->fringe_bitmap_periodic_p = periodic_p;
1302 if (row->overlay_arrow_bitmap < 0)
1303 row->overlay_arrow_bitmap = get_logical_fringe_bitmap (w, Qoverlay_arrow, 0, 0);
1305 if (row->overlay_arrow_bitmap != cur->overlay_arrow_bitmap)
1307 redraw_p = row->redraw_fringe_bitmaps_p = 1;
1308 if (!keep_current_p)
1310 cur->redraw_fringe_bitmaps_p = 1;
1311 cur->overlay_arrow_bitmap = row->overlay_arrow_bitmap;
1315 row->left_fringe_bitmap = left;
1316 row->right_fringe_bitmap = right;
1317 row->left_fringe_face_id = left_face_id;
1318 row->right_fringe_face_id = right_face_id;
1319 row->left_fringe_offset = left_offset;
1320 row->right_fringe_offset = right_offset;
1321 row->fringe_bitmap_periodic_p = periodic_p;
1324 return redraw_p && !keep_current_p;
1328 /* Compute actual fringe widths for frame F.
1330 If REDRAW is 1, redraw F if the fringe settings was actually
1331 modified and F is visible.
1333 Since the combined left and right fringe must occupy an integral
1334 number of columns, we may need to add some pixels to each fringe.
1335 Typically, we add an equal amount (+/- 1 pixel) to each fringe,
1336 but a negative width value is taken literally (after negating it).
1338 We never make the fringes narrower than specified.
1341 void
1342 compute_fringe_widths (struct frame *f, int redraw)
1344 int o_left = FRAME_LEFT_FRINGE_WIDTH (f);
1345 int o_right = FRAME_RIGHT_FRINGE_WIDTH (f);
1346 int o_cols = FRAME_FRINGE_COLS (f);
1348 Lisp_Object left_fringe = Fassq (Qleft_fringe, f->param_alist);
1349 Lisp_Object right_fringe = Fassq (Qright_fringe, f->param_alist);
1350 int left_fringe_width, right_fringe_width;
1352 if (!NILP (left_fringe))
1353 left_fringe = Fcdr (left_fringe);
1354 if (!NILP (right_fringe))
1355 right_fringe = Fcdr (right_fringe);
1357 left_fringe_width = ((NILP (left_fringe) || !INTEGERP (left_fringe)) ? 8 :
1358 XINT (left_fringe));
1359 right_fringe_width = ((NILP (right_fringe) || !INTEGERP (right_fringe)) ? 8 :
1360 XINT (right_fringe));
1362 if (left_fringe_width || right_fringe_width)
1364 int left_wid = eabs (left_fringe_width);
1365 int right_wid = eabs (right_fringe_width);
1366 int conf_wid = left_wid + right_wid;
1367 int font_wid = FRAME_COLUMN_WIDTH (f);
1368 int cols = (left_wid + right_wid + font_wid-1) / font_wid;
1369 int real_wid = cols * font_wid;
1370 if (left_wid && right_wid)
1372 if (left_fringe_width < 0)
1374 /* Left fringe width is fixed, adjust right fringe if necessary */
1375 FRAME_LEFT_FRINGE_WIDTH (f) = left_wid;
1376 FRAME_RIGHT_FRINGE_WIDTH (f) = real_wid - left_wid;
1378 else if (right_fringe_width < 0)
1380 /* Right fringe width is fixed, adjust left fringe if necessary */
1381 FRAME_LEFT_FRINGE_WIDTH (f) = real_wid - right_wid;
1382 FRAME_RIGHT_FRINGE_WIDTH (f) = right_wid;
1384 else
1386 /* Adjust both fringes with an equal amount.
1387 Note that we are doing integer arithmetic here, so don't
1388 lose a pixel if the total width is an odd number. */
1389 int fill = real_wid - conf_wid;
1390 FRAME_LEFT_FRINGE_WIDTH (f) = left_wid + fill/2;
1391 FRAME_RIGHT_FRINGE_WIDTH (f) = right_wid + fill - fill/2;
1394 else if (left_fringe_width)
1396 FRAME_LEFT_FRINGE_WIDTH (f) = real_wid;
1397 FRAME_RIGHT_FRINGE_WIDTH (f) = 0;
1399 else
1401 FRAME_LEFT_FRINGE_WIDTH (f) = 0;
1402 FRAME_RIGHT_FRINGE_WIDTH (f) = real_wid;
1404 FRAME_FRINGE_COLS (f) = cols;
1406 else
1408 FRAME_LEFT_FRINGE_WIDTH (f) = 0;
1409 FRAME_RIGHT_FRINGE_WIDTH (f) = 0;
1410 FRAME_FRINGE_COLS (f) = 0;
1413 if (redraw && FRAME_VISIBLE_P (f))
1414 if (o_left != FRAME_LEFT_FRINGE_WIDTH (f) ||
1415 o_right != FRAME_RIGHT_FRINGE_WIDTH (f) ||
1416 o_cols != FRAME_FRINGE_COLS (f))
1417 redraw_frame (f);
1421 /* Free resources used by a user-defined bitmap. */
1423 static void
1424 destroy_fringe_bitmap (int n)
1426 struct fringe_bitmap **fbp;
1428 fringe_faces[n] = Qnil;
1430 fbp = &fringe_bitmaps[n];
1431 if (*fbp && (*fbp)->dynamic)
1433 /* XXX Is SELECTED_FRAME OK here? */
1434 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1435 if (rif && rif->destroy_fringe_bitmap)
1436 rif->destroy_fringe_bitmap (n);
1437 xfree (*fbp);
1438 *fbp = NULL;
1441 while (max_used_fringe_bitmap > MAX_STANDARD_FRINGE_BITMAPS
1442 && fringe_bitmaps[max_used_fringe_bitmap - 1] == NULL)
1443 max_used_fringe_bitmap--;
1447 DEFUN ("destroy-fringe-bitmap", Fdestroy_fringe_bitmap, Sdestroy_fringe_bitmap,
1448 1, 1, 0,
1449 doc: /* Destroy fringe bitmap BITMAP.
1450 If BITMAP overrides a standard fringe bitmap, the original bitmap is restored. */)
1451 (Lisp_Object bitmap)
1453 int n;
1455 CHECK_SYMBOL (bitmap);
1456 n = lookup_fringe_bitmap (bitmap);
1457 if (!n)
1458 return Qnil;
1460 destroy_fringe_bitmap (n);
1462 if (n >= MAX_STANDARD_FRINGE_BITMAPS)
1464 Vfringe_bitmaps = Fdelq (bitmap, Vfringe_bitmaps);
1465 /* It would be better to remove the fringe property. */
1466 Fput (bitmap, Qfringe, Qnil);
1469 return Qnil;
1473 /* Initialize bitmap bit.
1475 On X, we bit-swap the built-in bitmaps and reduce bitmap
1476 from short to char array if width is <= 8 bits.
1478 On MAC with big-endian CPU, we need to byte-swap each short.
1480 On W32 and MAC (little endian), there's no need to do this.
1483 #if defined (HAVE_X_WINDOWS)
1484 static const unsigned char swap_nibble[16] = {
1485 0x0, 0x8, 0x4, 0xc, /* 0000 1000 0100 1100 */
1486 0x2, 0xa, 0x6, 0xe, /* 0010 1010 0110 1110 */
1487 0x1, 0x9, 0x5, 0xd, /* 0001 1001 0101 1101 */
1488 0x3, 0xb, 0x7, 0xf}; /* 0011 1011 0111 1111 */
1489 #endif /* HAVE_X_WINDOWS */
1491 static void
1492 init_fringe_bitmap (int which, struct fringe_bitmap *fb, int once_p)
1494 if (once_p || fb->dynamic)
1496 #if defined (HAVE_X_WINDOWS)
1497 unsigned short *bits = fb->bits;
1498 int j;
1500 if (fb->width <= 8)
1502 unsigned char *cbits = (unsigned char *)fb->bits;
1503 for (j = 0; j < fb->height; j++)
1505 unsigned short b = *bits++;
1506 unsigned char c;
1507 c = (unsigned char)((swap_nibble[b & 0xf] << 4)
1508 | (swap_nibble[(b>>4) & 0xf]));
1509 *cbits++ = (c >> (8 - fb->width));
1512 else
1514 for (j = 0; j < fb->height; j++)
1516 unsigned short b = *bits;
1517 b = (unsigned short)((swap_nibble[b & 0xf] << 12)
1518 | (swap_nibble[(b>>4) & 0xf] << 8)
1519 | (swap_nibble[(b>>8) & 0xf] << 4)
1520 | (swap_nibble[(b>>12) & 0xf]));
1521 b >>= (16 - fb->width);
1522 #ifdef WORDS_BIGENDIAN
1523 b = ((b >> 8) | (b << 8));
1524 #endif
1525 *bits++ = b;
1528 #endif /* HAVE_X_WINDOWS */
1532 if (!once_p)
1534 /* XXX Is SELECTED_FRAME OK here? */
1535 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1537 destroy_fringe_bitmap (which);
1539 if (rif && rif->define_fringe_bitmap)
1540 rif->define_fringe_bitmap (which, fb->bits, fb->height, fb->width);
1542 fringe_bitmaps[which] = fb;
1543 if (which >= max_used_fringe_bitmap)
1544 max_used_fringe_bitmap = which + 1;
1549 DEFUN ("define-fringe-bitmap", Fdefine_fringe_bitmap, Sdefine_fringe_bitmap,
1550 2, 5, 0,
1551 doc: /* Define fringe bitmap BITMAP from BITS of size HEIGHT x WIDTH.
1552 BITMAP is a symbol identifying the new fringe bitmap.
1553 BITS is either a string or a vector of integers.
1554 HEIGHT is height of bitmap. If HEIGHT is nil, use length of BITS.
1555 WIDTH must be an integer between 1 and 16, or nil which defaults to 8.
1556 Optional fifth arg ALIGN may be one of `top', `center', or `bottom',
1557 indicating the positioning of the bitmap relative to the rows where it
1558 is used; the default is to center the bitmap. Fifth arg may also be a
1559 list (ALIGN PERIODIC) where PERIODIC non-nil specifies that the bitmap
1560 should be repeated.
1561 If BITMAP already exists, the existing definition is replaced. */)
1562 (Lisp_Object bitmap, Lisp_Object bits, Lisp_Object height, Lisp_Object width, Lisp_Object align)
1564 int n, h, i, j;
1565 unsigned short *b;
1566 struct fringe_bitmap fb, *xfb;
1567 int fill1 = 0, fill2 = 0;
1569 CHECK_SYMBOL (bitmap);
1571 if (STRINGP (bits))
1572 h = SCHARS (bits);
1573 else if (VECTORP (bits))
1574 h = ASIZE (bits);
1575 else
1576 wrong_type_argument (Qsequencep, bits);
1578 if (NILP (height))
1579 fb.height = h;
1580 else
1582 CHECK_NUMBER (height);
1583 fb.height = max (0, min (XINT (height), 255));
1584 if (fb.height > h)
1586 fill1 = (fb.height - h) / 2;
1587 fill2 = fb.height - h - fill1;
1591 if (NILP (width))
1592 fb.width = 8;
1593 else
1595 CHECK_NUMBER (width);
1596 fb.width = max (0, min (XINT (width), 255));
1599 fb.period = 0;
1600 fb.align = ALIGN_BITMAP_CENTER;
1602 if (CONSP (align))
1604 Lisp_Object period = XCDR (align);
1605 if (CONSP (period))
1607 period = XCAR (period);
1608 if (!NILP (period))
1610 fb.period = fb.height;
1611 fb.height = 255;
1614 align = XCAR (align);
1616 if (EQ (align, Qtop))
1617 fb.align = ALIGN_BITMAP_TOP;
1618 else if (EQ (align, Qbottom))
1619 fb.align = ALIGN_BITMAP_BOTTOM;
1620 else if (!NILP (align) && !EQ (align, Qcenter))
1621 error ("Bad align argument");
1623 n = lookup_fringe_bitmap (bitmap);
1624 if (!n)
1626 if (max_used_fringe_bitmap < max_fringe_bitmaps)
1627 n = max_used_fringe_bitmap++;
1628 else
1630 for (n = MAX_STANDARD_FRINGE_BITMAPS;
1631 n < max_fringe_bitmaps;
1632 n++)
1633 if (fringe_bitmaps[n] == NULL)
1634 break;
1636 if (n == max_fringe_bitmaps)
1638 int bitmaps = max_fringe_bitmaps + 20;
1639 if (MAX_FRINGE_BITMAPS < bitmaps)
1640 error ("No free fringe bitmap slots");
1642 i = max_fringe_bitmaps;
1643 fringe_bitmaps = xrealloc (fringe_bitmaps,
1644 bitmaps * sizeof *fringe_bitmaps);
1645 fringe_faces = xrealloc (fringe_faces,
1646 bitmaps * sizeof *fringe_faces);
1648 for (i = max_fringe_bitmaps; i < bitmaps; i++)
1650 fringe_bitmaps[i] = NULL;
1651 fringe_faces[i] = Qnil;
1654 max_fringe_bitmaps = bitmaps;
1658 Vfringe_bitmaps = Fcons (bitmap, Vfringe_bitmaps);
1659 Fput (bitmap, Qfringe, make_number (n));
1662 fb.dynamic = 1;
1664 xfb = xmalloc (sizeof fb + fb.height * BYTES_PER_BITMAP_ROW);
1665 fb.bits = b = (unsigned short *) (xfb + 1);
1666 memset (b, 0, fb.height);
1668 j = 0;
1669 while (j < fb.height)
1671 for (i = 0; i < fill1 && j < fb.height; i++)
1672 b[j++] = 0;
1673 for (i = 0; i < h && j < fb.height; i++)
1675 Lisp_Object elt = Faref (bits, make_number (i));
1676 b[j++] = NUMBERP (elt) ? XINT (elt) : 0;
1678 for (i = 0; i < fill2 && j < fb.height; i++)
1679 b[j++] = 0;
1682 *xfb = fb;
1684 init_fringe_bitmap (n, xfb, 0);
1686 return bitmap;
1689 DEFUN ("set-fringe-bitmap-face", Fset_fringe_bitmap_face, Sset_fringe_bitmap_face,
1690 1, 2, 0,
1691 doc: /* Set face for fringe bitmap BITMAP to FACE.
1692 If FACE is nil, reset face to default fringe face. */)
1693 (Lisp_Object bitmap, Lisp_Object face)
1695 int n;
1697 CHECK_SYMBOL (bitmap);
1698 n = lookup_fringe_bitmap (bitmap);
1699 if (!n)
1700 error ("Undefined fringe bitmap");
1702 /* The purpose of the following code is to signal an error if FACE
1703 is not a face. This is for the caller's convenience only; the
1704 redisplay code should be able to fail gracefully. Skip the check
1705 if FRINGE_FACE_ID is unrealized (as in batch mode and during
1706 daemon startup). */
1707 if (!NILP (face))
1709 struct frame *f = SELECTED_FRAME ();
1711 if (FACE_FROM_ID (f, FRINGE_FACE_ID)
1712 && lookup_derived_face (f, face, FRINGE_FACE_ID, 1) < 0)
1713 error ("No such face");
1716 fringe_faces[n] = face;
1717 return Qnil;
1720 DEFUN ("fringe-bitmaps-at-pos", Ffringe_bitmaps_at_pos, Sfringe_bitmaps_at_pos,
1721 0, 2, 0,
1722 doc: /* Return fringe bitmaps of row containing position POS in window WINDOW.
1723 If WINDOW is nil, use selected window. If POS is nil, use value of point
1724 in that window. Return value is a list (LEFT RIGHT OV), where LEFT
1725 is the symbol for the bitmap in the left fringe (or nil if no bitmap),
1726 RIGHT is similar for the right fringe, and OV is non-nil if there is an
1727 overlay arrow in the left fringe.
1728 Return nil if POS is not visible in WINDOW. */)
1729 (Lisp_Object pos, Lisp_Object window)
1731 struct window *w;
1732 struct glyph_row *row;
1733 ptrdiff_t textpos;
1735 w = decode_any_window (window);
1736 XSETWINDOW (window, w);
1738 if (!NILP (pos))
1740 CHECK_NUMBER_COERCE_MARKER (pos);
1741 if (! (BEGV <= XINT (pos) && XINT (pos) <= ZV))
1742 args_out_of_range (window, pos);
1743 textpos = XINT (pos);
1745 else if (w == XWINDOW (selected_window))
1746 textpos = PT;
1747 else
1748 textpos = marker_position (w->pointm);
1750 row = MATRIX_FIRST_TEXT_ROW (w->current_matrix);
1751 row = row_containing_pos (w, textpos, row, NULL, 0);
1752 if (row)
1753 return list3 (get_fringe_bitmap_name (row->left_fringe_bitmap),
1754 get_fringe_bitmap_name (row->right_fringe_bitmap),
1755 (row->overlay_arrow_bitmap == 0 ? Qnil
1756 : row->overlay_arrow_bitmap < 0 ? Qt
1757 : get_fringe_bitmap_name (row->overlay_arrow_bitmap)));
1758 else
1759 return Qnil;
1763 /***********************************************************************
1764 Initialization
1765 ***********************************************************************/
1767 void
1768 syms_of_fringe (void)
1770 DEFSYM (Qtruncation, "truncation");
1771 DEFSYM (Qcontinuation, "continuation");
1772 DEFSYM (Qoverlay_arrow, "overlay-arrow");
1773 DEFSYM (Qempty_line, "empty-line");
1774 DEFSYM (Qtop_bottom, "top-bottom");
1775 DEFSYM (Qhollow_small, "hollow-small");
1777 defsubr (&Sdestroy_fringe_bitmap);
1778 defsubr (&Sdefine_fringe_bitmap);
1779 defsubr (&Sfringe_bitmaps_at_pos);
1780 defsubr (&Sset_fringe_bitmap_face);
1782 DEFVAR_LISP ("overflow-newline-into-fringe", Voverflow_newline_into_fringe,
1783 doc: /* Non-nil means that newline may flow into the right fringe.
1784 This means that display lines which are exactly as wide as the window
1785 (not counting the final newline) will only occupy one screen line, by
1786 showing (or hiding) the final newline in the right fringe; when point
1787 is at the final newline, the cursor is shown in the right fringe.
1788 If nil, also continue lines which are exactly as wide as the window. */);
1789 Voverflow_newline_into_fringe = Qt;
1791 DEFVAR_LISP ("fringe-bitmaps", Vfringe_bitmaps,
1792 doc: /* List of fringe bitmap symbols. */);
1793 Vfringe_bitmaps = Qnil;
1796 /* Garbage collection hook */
1798 void
1799 mark_fringe_data (void)
1801 int i;
1803 for (i = 0; i < max_fringe_bitmaps; i++)
1804 if (!NILP (fringe_faces[i]))
1805 mark_object (fringe_faces[i]);
1808 /* Initialize this module when Emacs starts. */
1810 void
1811 init_fringe_once (void)
1813 int bt;
1815 for (bt = NO_FRINGE_BITMAP + 1; bt < MAX_STANDARD_FRINGE_BITMAPS; bt++)
1816 init_fringe_bitmap (bt, &standard_bitmaps[bt], 1);
1819 void
1820 init_fringe (void)
1822 int i;
1824 max_fringe_bitmaps = MAX_STANDARD_FRINGE_BITMAPS + 20;
1826 fringe_bitmaps = xzalloc (max_fringe_bitmaps * sizeof *fringe_bitmaps);
1827 fringe_faces = xmalloc (max_fringe_bitmaps * sizeof *fringe_faces);
1829 for (i = 0; i < max_fringe_bitmaps; i++)
1830 fringe_faces[i] = Qnil;
1833 #ifdef HAVE_NTGUI
1835 void
1836 w32_init_fringe (struct redisplay_interface *rif)
1838 int bt;
1840 if (!rif)
1841 return;
1843 for (bt = NO_FRINGE_BITMAP + 1; bt < MAX_STANDARD_FRINGE_BITMAPS; bt++)
1845 struct fringe_bitmap *fb = &standard_bitmaps[bt];
1846 rif->define_fringe_bitmap (bt, fb->bits, fb->height, fb->width);
1850 void
1851 w32_reset_fringes (void)
1853 /* Destroy row bitmaps. */
1854 int bt;
1855 struct redisplay_interface *rif = FRAME_RIF (SELECTED_FRAME ());
1857 if (!rif)
1858 return;
1860 for (bt = NO_FRINGE_BITMAP + 1; bt < max_used_fringe_bitmap; bt++)
1861 rif->destroy_fringe_bitmap (bt);
1864 #endif /* HAVE_NTGUI */
1866 #endif /* HAVE_WINDOW_SYSTEM */