1 /* Fringe handling (split from xdisp.c).
2 Copyright (C) 1985-1988, 1993-1995, 1997-2018 Free Software
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or (at
10 your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>. */
27 #include "ptr-bounds.h"
29 #include "dispextern.h"
31 #include "blockinput.h"
32 #include "termhooks.h"
34 /* Fringe bitmaps are represented in three different ways:
36 Logical bitmaps are used internally to denote things like
37 'end-of-buffer', 'left-truncation', 'overlay-arrow', etc.
39 Physical bitmaps specify the visual appearance of the bitmap,
40 e.g. 'bottom-left-angle', 'left-arrow', 'left-triangle', etc.
41 User defined bitmaps are physical bitmaps.
43 Internally, fringe bitmaps for a specific display row are
44 represented as a simple integer that is used as an index
45 into the table of all defined bitmaps. This index is stored
46 in the `fringe' property of the physical bitmap symbol.
48 Logical bitmaps are mapped to physical bitmaps through the
49 buffer-local `fringe-indicator-alist' variable.
51 Each element of this alist is a cons (LOGICAL . PHYSICAL)
52 mapping a logical bitmap to a physical bitmap.
53 PHYSICAL is either a symbol to use in both left and right fringe,
54 or a cons of two symbols (LEFT . RIGHT) denoting different
55 bitmaps to use in left and right fringe.
57 LOGICAL is first looked up in the window's buffer's buffer-local
58 value of the fringe-indicator-alist variable, and if not present,
59 in the global value of fringe-indicator-alist.
61 If LOGICAL is not present in either alist, or the PHYSICAL value
62 found is nil, no bitmap is shown for the logical bitmap.
64 The `left-fringe' and `right-fringe' display properties
65 must specify physical bitmap symbols.
68 enum fringe_bitmap_align
70 ALIGN_BITMAP_CENTER
= 0,
86 /***********************************************************************
88 ***********************************************************************/
90 /* Undefined bitmap. A question mark. */
103 static unsigned short question_mark_bits
[] = {
104 0x3c, 0x7e, 0x7e, 0x0c, 0x18, 0x18, 0x00, 0x18, 0x18};
106 /* An exclamation mark. */
119 static unsigned short exclamation_mark_bits
[] = {
120 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00, 0x18};
122 /* An arrow like this: `<-'. */
133 static unsigned short left_arrow_bits
[] = {
134 0x18, 0x30, 0x60, 0xfc, 0xfc, 0x60, 0x30, 0x18};
137 /* Right truncation arrow bitmap `->'. */
148 static unsigned short right_arrow_bits
[] = {
149 0x18, 0x0c, 0x06, 0x3f, 0x3f, 0x06, 0x0c, 0x18};
152 /* Up arrow bitmap. */
163 static unsigned short up_arrow_bits
[] = {
164 0x18, 0x3c, 0x7e, 0xff, 0x18, 0x18, 0x18, 0x18};
167 /* Down arrow bitmap. */
178 static unsigned short down_arrow_bits
[] = {
179 0x18, 0x18, 0x18, 0x18, 0xff, 0x7e, 0x3c, 0x18};
181 /* Marker for continuation lines. */
192 static unsigned short left_curly_arrow_bits
[] = {
193 0x3c, 0x7c, 0xc0, 0xe4, 0xfc, 0x7c, 0x3c, 0x7c};
195 /* Marker for continued lines. */
206 static unsigned short right_curly_arrow_bits
[] = {
207 0x3c, 0x3e, 0x03, 0x27, 0x3f, 0x3e, 0x3c, 0x3e};
209 /* Reverse Overlay arrow bitmap. A triangular arrow. */
220 static unsigned short left_triangle_bits
[] = {
221 0x03, 0x0f, 0x1f, 0x3f, 0x3f, 0x1f, 0x0f, 0x03};
223 /* Overlay arrow bitmap. A triangular arrow. */
234 static unsigned short right_triangle_bits
[] = {
235 0xc0, 0xf0, 0xf8, 0xfc, 0xfc, 0xf8, 0xf0, 0xc0};
237 /* First line bitmap. An top-left angle. */
248 static unsigned short top_left_angle_bits
[] = {
249 0xfc, 0xfc, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0x00};
251 /* First line bitmap. An right-up angle. */
262 static unsigned short top_right_angle_bits
[] = {
263 0x3f, 0x3f, 0x03, 0x03, 0x03, 0x03, 0x03, 0x00};
265 /* Last line bitmap. An left-down angle. */
276 static unsigned short bottom_left_angle_bits
[] = {
277 0x00, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xfc, 0xfc};
279 /* Last line bitmap. An right-down angle. */
290 static unsigned short bottom_right_angle_bits
[] = {
291 0x00, 0x03, 0x03, 0x03, 0x03, 0x03, 0x3f, 0x3f};
293 /* First/last line bitmap. An left bracket. */
306 static unsigned short left_bracket_bits
[] = {
307 0xfc, 0xfc, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xfc, 0xfc};
309 /* First/last line bitmap. An right bracket. */
322 static unsigned short right_bracket_bits
[] = {
323 0x3f, 0x3f, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x3f, 0x3f};
325 /* Filled box cursor bitmap. A filled box; max 13 pixels high. */
341 static unsigned short filled_rectangle_bits
[] = {
342 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe};
344 /* Hollow box cursor bitmap. A hollow box; max 13 pixels high. */
360 static unsigned short hollow_rectangle_bits
[] = {
361 0xfe, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0xfe};
363 /* Hollow square bitmap. */
372 static unsigned short hollow_square_bits
[] = {
373 0x7e, 0x42, 0x42, 0x42, 0x42, 0x7e};
375 /* Filled square bitmap. */
384 static unsigned short filled_square_bits
[] = {
385 0x7e, 0x7e, 0x7e, 0x7e, 0x7e, 0x7e};
387 /* Bar cursor bitmap. A vertical bar; max 13 pixels high. */
403 static unsigned short vertical_bar_bits
[] = {
404 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0};
406 /* HBar cursor bitmap. A horizontal bar; 2 pixels high. */
411 static unsigned short horizontal_bar_bits
[] = {
415 /* Bitmap drawn to indicate lines not displaying text if
416 `indicate-empty-lines' is non-nil. */
425 static unsigned short empty_line_bits
[] = {
426 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
427 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
428 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
429 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
430 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
431 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
432 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
433 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00};
436 #define BYTES_PER_BITMAP_ROW (sizeof (unsigned short))
437 #define STANDARD_BITMAP_HEIGHT(bits) (sizeof (bits)/BYTES_PER_BITMAP_ROW)
438 #define FRBITS(bits) bits, STANDARD_BITMAP_HEIGHT (bits)
440 /* NOTE: The order of these bitmaps must match the sequence
441 used in fringe.el to define the corresponding symbols. */
443 static struct fringe_bitmap standard_bitmaps
[] =
445 { NULL
, 0, 0, 0, 0, 0 }, /* NO_FRINGE_BITMAP */
446 { FRBITS (question_mark_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
447 { FRBITS (exclamation_mark_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
448 { FRBITS (left_arrow_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
449 { FRBITS (right_arrow_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
450 { FRBITS (up_arrow_bits
), 8, 0, ALIGN_BITMAP_TOP
, 0 },
451 { FRBITS (down_arrow_bits
), 8, 0, ALIGN_BITMAP_BOTTOM
, 0 },
452 { FRBITS (left_curly_arrow_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
453 { FRBITS (right_curly_arrow_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
454 { FRBITS (left_triangle_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
455 { FRBITS (right_triangle_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
456 { FRBITS (top_left_angle_bits
), 8, 0, ALIGN_BITMAP_TOP
, 0 },
457 { FRBITS (top_right_angle_bits
), 8, 0, ALIGN_BITMAP_TOP
, 0 },
458 { FRBITS (bottom_left_angle_bits
), 8, 0, ALIGN_BITMAP_BOTTOM
, 0 },
459 { FRBITS (bottom_right_angle_bits
), 8, 0, ALIGN_BITMAP_BOTTOM
, 0 },
460 { FRBITS (left_bracket_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
461 { FRBITS (right_bracket_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
462 { FRBITS (filled_rectangle_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
463 { FRBITS (hollow_rectangle_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
464 { FRBITS (filled_square_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
465 { FRBITS (hollow_square_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
466 { FRBITS (vertical_bar_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
467 { FRBITS (horizontal_bar_bits
), 8, 0, ALIGN_BITMAP_BOTTOM
, 0 },
468 { FRBITS (empty_line_bits
), 8, 3, ALIGN_BITMAP_TOP
, 0 },
471 #define NO_FRINGE_BITMAP 0
472 #define UNDEF_FRINGE_BITMAP 1
473 #define MAX_STANDARD_FRINGE_BITMAPS ARRAYELTS (standard_bitmaps)
475 static struct fringe_bitmap
**fringe_bitmaps
;
476 static Lisp_Object
*fringe_faces
;
477 static int max_fringe_bitmaps
;
479 int max_used_fringe_bitmap
= MAX_STANDARD_FRINGE_BITMAPS
;
482 /* Lookup bitmap number for symbol BITMAP.
483 Return 0 if not a bitmap. */
486 lookup_fringe_bitmap (Lisp_Object bitmap
)
490 bitmap
= Fget (bitmap
, Qfringe
);
491 if (!INTEGERP (bitmap
))
495 if (bn
> NO_FRINGE_BITMAP
496 && bn
< max_used_fringe_bitmap
497 && (bn
< MAX_STANDARD_FRINGE_BITMAPS
498 || fringe_bitmaps
[bn
] != NULL
))
504 /* Get fringe bitmap name for bitmap number BN.
506 Found by traversing Vfringe_bitmaps comparing BN to the
507 fringe property for each symbol.
509 Return BN if not found in Vfringe_bitmaps. */
512 get_fringe_bitmap_name (int bn
)
517 /* Zero means no bitmap -- return nil. */
521 bitmaps
= Vfringe_bitmaps
;
522 num
= make_number (bn
);
524 while (CONSP (bitmaps
))
526 Lisp_Object bitmap
= XCAR (bitmaps
);
527 if (EQ (num
, Fget (bitmap
, Qfringe
)))
529 bitmaps
= XCDR (bitmaps
);
535 /* Get fringe bitmap data for bitmap number BN. */
537 static struct fringe_bitmap
*
538 get_fringe_bitmap_data (int bn
)
540 struct fringe_bitmap
*fb
;
542 fb
= fringe_bitmaps
[bn
];
544 fb
= &standard_bitmaps
[bn
< MAX_STANDARD_FRINGE_BITMAPS
545 ? bn
: UNDEF_FRINGE_BITMAP
];
550 /* Draw the bitmap WHICH in one of the left or right fringes of
551 window W. ROW is the glyph row for which to display the bitmap; it
552 determines the vertical position at which the bitmap has to be
554 LEFT_P is 1 for left fringe, 0 for right fringe.
558 draw_fringe_bitmap_1 (struct window
*w
, struct glyph_row
*row
, int left_p
, int overlay
, int which
)
560 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
561 struct draw_fringe_bitmap_params p
;
562 struct fringe_bitmap
*fb
;
564 int face_id
= DEFAULT_FACE_ID
;
565 int offset
, header_line_height
;
567 p
.overlay_p
= (overlay
& 1) == 1;
568 p
.cursor_p
= (overlay
& 2) == 2;
570 if (which
!= NO_FRINGE_BITMAP
)
576 which
= row
->left_fringe_bitmap
;
577 face_id
= row
->left_fringe_face_id
;
578 offset
= row
->left_fringe_offset
;
582 which
= row
->right_fringe_bitmap
;
583 face_id
= row
->right_fringe_face_id
;
584 offset
= row
->right_fringe_offset
;
587 if (face_id
== DEFAULT_FACE_ID
)
589 Lisp_Object face
= fringe_faces
[which
];
590 face_id
= NILP (face
) ? lookup_named_face (f
, Qfringe
, false)
591 : lookup_derived_face (f
, face
, FRINGE_FACE_ID
, 0);
593 face_id
= FRINGE_FACE_ID
;
596 fb
= get_fringe_bitmap_data (which
);
600 /* Convert row to frame coordinates. */
601 p
.y
= WINDOW_TO_FRAME_PIXEL_Y (w
, row
->y
) + offset
;
608 p
.dh
= (period
> 0 ? (p
.y
% period
) : 0);
611 /* Adjust y to the offset in the row to start drawing the bitmap. */
614 case ALIGN_BITMAP_CENTER
:
615 p
.y
+= (row
->height
- p
.h
) / 2;
617 case ALIGN_BITMAP_BOTTOM
:
618 p
.y
+= (row
->visible_height
- p
.h
);
620 case ALIGN_BITMAP_TOP
:
624 p
.face
= FACE_FROM_ID_OR_NULL (f
, face_id
);
627 /* This could happen after clearing face cache.
628 But it shouldn't happen anymore. ++kfs */
632 prepare_face_for_display (f
, p
.face
);
634 /* Clear left fringe if no bitmap to draw or if bitmap doesn't fill
637 header_line_height
= WINDOW_HEADER_LINE_HEIGHT (w
);
638 p
.by
= WINDOW_TO_FRAME_PIXEL_Y (w
, max (header_line_height
, row
->y
));
639 p
.ny
= row
->visible_height
;
642 int wd
= WINDOW_LEFT_FRINGE_WIDTH (w
);
643 int x
= window_box_left (w
, (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w
)
648 p
.x
= x
- p
.wd
- (wd
- p
.wd
) / 2;
650 if (p
.wd
< wd
|| p
.y
> p
.by
|| p
.y
+ p
.h
< p
.by
+ p
.ny
)
652 /* If W has a vertical border to its left, don't draw over it. */
653 wd
-= ((!WINDOW_LEFTMOST_P (w
)
654 /* This could be wrong when we allow window local
655 right dividers - but the window on the left is hard
657 && !FRAME_RIGHT_DIVIDER_WIDTH (f
)
658 && !WINDOW_HAS_VERTICAL_SCROLL_BAR (w
)
659 /* But don't reduce the fringe width if the window
660 has a left margin, because that means we are not
661 in danger of drawing over the vertical border,
662 and OTOH leaving out that one pixel leaves behind
663 traces of the cursor, if it was in column zero
664 before drawing non-empty margin area. */
665 && w
->left_margin_cols
== 0)
673 int x
= window_box_right (w
,
674 (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w
)
677 int wd
= WINDOW_RIGHT_FRINGE_WIDTH (w
);
680 p
.x
= x
+ (wd
- p
.wd
) / 2;
681 /* Clear right fringe if no bitmap to draw of if bitmap doesn't fill
683 if (p
.wd
< wd
|| p
.y
> p
.by
|| p
.y
+ p
.h
< p
.by
+ p
.ny
)
690 if (p
.x
>= WINDOW_BOX_LEFT_EDGE_X (w
)
691 && (p
.x
+ p
.wd
) <= WINDOW_BOX_LEFT_EDGE_X (w
) + WINDOW_PIXEL_WIDTH (w
))
692 FRAME_RIF (f
)->draw_fringe_bitmap (w
, row
, &p
);
696 get_logical_cursor_bitmap (struct window
*w
, Lisp_Object cursor
)
698 Lisp_Object cmap
, bm
= Qnil
;
700 if ((cmap
= BVAR (XBUFFER (w
->contents
), fringe_cursor_alist
)), !NILP (cmap
))
702 bm
= Fassq (cursor
, cmap
);
705 if ((bm
= XCDR (bm
)), NILP (bm
))
706 return NO_FRINGE_BITMAP
;
707 return lookup_fringe_bitmap (bm
);
710 if (EQ (cmap
, BVAR (&buffer_defaults
, fringe_cursor_alist
)))
711 return NO_FRINGE_BITMAP
;
712 bm
= Fassq (cursor
, BVAR (&buffer_defaults
, fringe_cursor_alist
));
713 if (!CONSP (bm
) || ((bm
= XCDR (bm
)), NILP (bm
)))
714 return NO_FRINGE_BITMAP
;
715 return lookup_fringe_bitmap (bm
);
719 get_logical_fringe_bitmap (struct window
*w
, Lisp_Object bitmap
, int right_p
, int partial_p
)
721 Lisp_Object cmap
, bm1
= Qnil
, bm2
= Qnil
, bm
;
722 EMACS_INT ln1
= 0, ln2
= 0;
724 int ix2
= ix1
+ (partial_p
? 2 : 0);
726 /* Lookup in buffer-local fringe-indicator-alist before global alist.
729 BITMAP -- use for all
730 (L R) -- use for left right (whether partial or not)
731 (L R PL PR) -- use for left right partial-left partial-right
732 If any value in local binding is not present or t, use global value.
734 If partial, lookup partial bitmap in default value if not found here.
735 If not partial, or no partial spec is present, use non-partial bitmap. */
737 if ((cmap
= BVAR (XBUFFER (w
->contents
), fringe_indicator_alist
)), !NILP (cmap
))
739 bm1
= Fassq (bitmap
, cmap
);
742 if ((bm1
= XCDR (bm1
)), NILP (bm1
))
743 return NO_FRINGE_BITMAP
;
746 ln1
= XINT (Flength (bm1
));
751 bm
= Fnth (make_number (ix2
), bm1
);
760 bm
= Fnth (make_number (ix1
), bm1
);
766 else if ((bm
= bm1
, !EQ (bm
, Qt
)))
771 if (!EQ (cmap
, BVAR (&buffer_defaults
, fringe_indicator_alist
))
772 && !NILP (BVAR (&buffer_defaults
, fringe_indicator_alist
)))
774 bm2
= Fassq (bitmap
, BVAR (&buffer_defaults
, fringe_indicator_alist
));
777 if ((bm2
= XCDR (bm2
)), !NILP (bm2
))
781 ln2
= XINT (Flength (bm2
));
786 bm
= Fnth (make_number (ix2
), bm2
);
798 bm
= Fnth (make_number (ix1
), bm1
);
805 bm
= Fnth (make_number (ix1
), bm2
);
808 return NO_FRINGE_BITMAP
;
810 else if ((bm
= bm2
, NILP (bm
)))
811 return NO_FRINGE_BITMAP
;
814 return lookup_fringe_bitmap (bm
);
819 draw_fringe_bitmap (struct window
*w
, struct glyph_row
*row
, int left_p
)
823 if (left_p
== row
->reversed_p
&& row
->cursor_in_fringe_p
)
825 Lisp_Object cursor
= Qnil
;
827 switch (w
->phys_cursor_type
)
829 case HOLLOW_BOX_CURSOR
:
830 if (row
->visible_height
>= STANDARD_BITMAP_HEIGHT (hollow_rectangle_bits
))
833 cursor
= Qhollow_small
;
835 case FILLED_BOX_CURSOR
:
846 w
->phys_cursor_on_p
= 0;
847 row
->cursor_in_fringe_p
= 0;
852 int bm
= get_logical_cursor_bitmap (w
, cursor
);
853 if (bm
!= NO_FRINGE_BITMAP
)
855 draw_fringe_bitmap_1 (w
, row
, left_p
, 2, bm
);
856 overlay
= EQ (cursor
, Qbox
) ? 3 : 1;
861 draw_fringe_bitmap_1 (w
, row
, left_p
, overlay
, NO_FRINGE_BITMAP
);
863 if (left_p
&& row
->overlay_arrow_bitmap
!= NO_FRINGE_BITMAP
)
864 draw_fringe_bitmap_1 (w
, row
, 1, 1, row
->overlay_arrow_bitmap
);
868 /* Draw fringe bitmaps for glyph row ROW on window W. Call this
869 function with input blocked. */
872 draw_row_fringe_bitmaps (struct window
*w
, struct glyph_row
*row
)
874 eassert (input_blocked_p ());
876 /* If row is completely invisible, because of vscrolling, we
877 don't have to draw anything. */
878 if (row
->visible_height
<= 0)
881 if (WINDOW_LEFT_FRINGE_WIDTH (w
) != 0)
882 draw_fringe_bitmap (w
, row
, 1);
884 if (WINDOW_RIGHT_FRINGE_WIDTH (w
) != 0)
885 draw_fringe_bitmap (w
, row
, 0);
888 /* Draw the fringes of window W. Only fringes for rows marked for
889 update in redraw_fringe_bitmaps_p are drawn.
891 Return nonzero if left or right fringe was redrawn in any way.
893 If NO_FRINGE_P is non-zero, also return nonzero if either fringe
896 A return nonzero value indicates that the vertical line between
897 windows needs update (as it may be drawn in the fringe).
901 draw_window_fringes (struct window
*w
, bool no_fringe_p
)
903 struct glyph_row
*row
;
904 int yb
= window_text_bottom_y (w
);
905 int nrows
= w
->current_matrix
->nrows
;
909 if (w
->pseudo_window_p
)
912 /* Must draw line if no fringe */
914 && (WINDOW_LEFT_FRINGE_WIDTH (w
) == 0
915 || WINDOW_RIGHT_FRINGE_WIDTH (w
) == 0))
918 for (y
= w
->vscroll
, rn
= 0, row
= w
->current_matrix
->rows
;
919 y
< yb
&& rn
< nrows
;
920 y
+= row
->height
, ++row
, ++rn
)
922 if (!row
->redraw_fringe_bitmaps_p
)
924 draw_row_fringe_bitmaps (w
, row
);
925 row
->redraw_fringe_bitmaps_p
= 0;
933 /* Recalculate the bitmaps to show in the fringes of window W.
934 Only mark rows with modified bitmaps for update in redraw_fringe_bitmaps_p.
936 If KEEP_CURRENT_P is 0, update current_matrix too. */
939 update_window_fringes (struct window
*w
, bool keep_current_p
)
941 struct glyph_row
*row
, *cur
= 0;
942 int yb
= window_text_bottom_y (w
);
943 int rn
, nrows
= w
->current_matrix
->nrows
;
946 Lisp_Object boundary_top
= Qnil
, boundary_bot
= Qnil
;
947 Lisp_Object arrow_top
= Qnil
, arrow_bot
= Qnil
;
948 Lisp_Object empty_pos
;
949 Lisp_Object ind
= Qnil
;
950 #define MAX_BITMAP_CACHE (8*4)
951 int bitmap_cache
[MAX_BITMAP_CACHE
];
952 int top_ind_rn
, bot_ind_rn
;
953 int top_ind_min_y
, bot_ind_max_y
;
955 /* top_ind_rn is set to a nonnegative value whenever
956 row->indicate_bob_p is set, so it's OK that top_row_ends_at_zv_p
957 is not initialized here. Similarly for bot_ind_rn,
958 row->indicate_eob_p and bot_row_ends_at_zv_p. */
959 int top_row_ends_at_zv_p UNINIT
, bot_row_ends_at_zv_p UNINIT
;
961 if (w
->pseudo_window_p
)
964 if (!MINI_WINDOW_P (w
)
965 && (ind
= BVAR (XBUFFER (w
->contents
), indicate_buffer_boundaries
), !NILP (ind
)))
967 if (EQ (ind
, Qleft
) || EQ (ind
, Qright
))
968 boundary_top
= boundary_bot
= arrow_top
= arrow_bot
= ind
;
969 else if (CONSP (ind
) && CONSP (XCAR (ind
)))
972 if (pos
= Fassq (Qt
, ind
), !NILP (pos
))
973 boundary_top
= boundary_bot
= arrow_top
= arrow_bot
= XCDR (pos
);
974 if (pos
= Fassq (Qtop
, ind
), !NILP (pos
))
975 boundary_top
= XCDR (pos
);
976 if (pos
= Fassq (Qbottom
, ind
), !NILP (pos
))
977 boundary_bot
= XCDR (pos
);
978 if (pos
= Fassq (Qup
, ind
), !NILP (pos
))
979 arrow_top
= XCDR (pos
);
980 if (pos
= Fassq (Qdown
, ind
), !NILP (pos
))
981 arrow_bot
= XCDR (pos
);
984 /* Anything else means boundary on left and no arrows. */
985 boundary_top
= boundary_bot
= Qleft
;
988 top_ind_rn
= bot_ind_rn
= -1;
991 for (y
= w
->vscroll
, rn
= 0;
992 y
< yb
&& rn
< nrows
;
993 y
+= row
->height
, ++rn
)
995 row
= w
->desired_matrix
->rows
+ rn
;
997 row
= w
->current_matrix
->rows
+ rn
;
999 row
->indicate_bob_p
= row
->indicate_top_line_p
= 0;
1000 row
->indicate_eob_p
= row
->indicate_bottom_line_p
= 0;
1002 if (!row
->mode_line_p
)
1004 if (top_ind_rn
< 0 && row
->visible_height
> 0)
1006 if (MATRIX_ROW_START_CHARPOS (row
) <= BUF_BEGV (XBUFFER (w
->contents
))
1007 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_TOP_P (w
, row
))
1008 row
->indicate_bob_p
= !NILP (boundary_top
);
1010 row
->indicate_top_line_p
= !NILP (arrow_top
);
1016 if (MATRIX_ROW_END_CHARPOS (row
) >= BUF_ZV (XBUFFER (w
->contents
))
1017 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_BOTTOM_P (w
, row
))
1018 row
->indicate_eob_p
= !NILP (boundary_bot
), bot_ind_rn
= rn
;
1019 else if (y
+ row
->height
>= yb
)
1020 row
->indicate_bottom_line_p
= !NILP (arrow_bot
), bot_ind_rn
= rn
;
1026 empty_pos
= BVAR (XBUFFER (w
->contents
), indicate_empty_lines
);
1027 if (!NILP (empty_pos
) && !EQ (empty_pos
, Qright
))
1028 empty_pos
= WINDOW_LEFT_FRINGE_WIDTH (w
) == 0 ? Qright
: Qleft
;
1030 for (y
= 0; y
< MAX_BITMAP_CACHE
; y
++)
1031 bitmap_cache
[y
] = -1;
1033 #define LEFT_FRINGE(cache, which, partial_p) \
1034 (bitmap_cache[cache*4+partial_p] >= 0 \
1035 ? bitmap_cache[cache*4+partial_p] \
1036 : (bitmap_cache[cache*4+partial_p] = \
1037 get_logical_fringe_bitmap (w, which, 0, partial_p)))
1039 #define RIGHT_FRINGE(cache, which, partial_p) \
1040 (bitmap_cache[cache*4+2+partial_p] >= 0 \
1041 ? bitmap_cache[cache*4+2+partial_p] \
1042 : (bitmap_cache[cache*4+2+partial_p] = \
1043 get_logical_fringe_bitmap (w, which, 1, partial_p)))
1046 /* Extend top-aligned top indicator (or bottom-aligned bottom
1047 indicator) to adjacent rows if it doesn't fit in one row. */
1048 top_ind_min_y
= bot_ind_max_y
= -1;
1049 if (top_ind_rn
>= 0)
1051 int bn
= NO_FRINGE_BITMAP
;
1053 row
= w
->desired_matrix
->rows
+ top_ind_rn
;
1054 if (!row
->enabled_p
)
1055 row
= w
->current_matrix
->rows
+ top_ind_rn
;
1057 top_row_ends_at_zv_p
= row
->ends_at_zv_p
;
1058 if (row
->indicate_bob_p
)
1060 if (EQ (boundary_top
, Qleft
))
1061 bn
= ((row
->indicate_eob_p
&& EQ (boundary_bot
, Qleft
))
1062 ? LEFT_FRINGE (1, Qtop_bottom
, row
->ends_at_zv_p
)
1063 : LEFT_FRINGE (2, Qtop
, 0));
1065 bn
= ((row
->indicate_eob_p
&& EQ (boundary_bot
, Qright
))
1066 ? RIGHT_FRINGE (1, Qtop_bottom
, row
->ends_at_zv_p
)
1067 : RIGHT_FRINGE (2, Qtop
, 0));
1069 else if (row
->indicate_top_line_p
)
1071 if (EQ (arrow_top
, Qleft
))
1072 bn
= LEFT_FRINGE (6, Qup
, 0);
1074 bn
= RIGHT_FRINGE (6, Qup
, 0);
1077 if (bn
!= NO_FRINGE_BITMAP
)
1079 struct fringe_bitmap
*fb
= get_fringe_bitmap_data (bn
);
1081 if (fb
->align
== ALIGN_BITMAP_TOP
&& fb
->period
== 0)
1083 struct glyph_row
*row1
;
1086 top_ind_min_y
= WINDOW_HEADER_LINE_HEIGHT (w
);
1087 top_ind_max_y
= top_ind_min_y
+ fb
->height
;
1088 if (top_ind_max_y
> yb
)
1091 for (y
= row
->y
+ row
->height
, rn
= top_ind_rn
+ 1;
1092 y
< top_ind_max_y
&& rn
< nrows
;
1093 y
+= row1
->height
, rn
++)
1095 if (bot_ind_rn
>= 0 && rn
>= bot_ind_rn
)
1098 row1
= w
->desired_matrix
->rows
+ rn
;
1099 if (!row1
->enabled_p
)
1100 row1
= w
->current_matrix
->rows
+ rn
;
1102 row1
->indicate_bob_p
= row
->indicate_bob_p
;
1103 row1
->indicate_top_line_p
= row
->indicate_top_line_p
;
1108 if (bot_ind_rn
>= 0)
1110 int bn
= NO_FRINGE_BITMAP
;
1112 row
= w
->desired_matrix
->rows
+ bot_ind_rn
;
1113 if (!row
->enabled_p
)
1114 row
= w
->current_matrix
->rows
+ bot_ind_rn
;
1116 bot_row_ends_at_zv_p
= row
->ends_at_zv_p
;
1117 if (row
->indicate_eob_p
)
1119 if (EQ (boundary_bot
, Qleft
))
1120 bn
= LEFT_FRINGE (3, Qbottom
, row
->ends_at_zv_p
);
1122 bn
= RIGHT_FRINGE (3, Qbottom
, row
->ends_at_zv_p
);
1124 else if (row
->indicate_bottom_line_p
)
1126 if (EQ (arrow_bot
, Qleft
))
1127 bn
= LEFT_FRINGE (7, Qdown
, 0);
1129 bn
= RIGHT_FRINGE (7, Qdown
, 0);
1132 if (bn
!= NO_FRINGE_BITMAP
)
1134 struct fringe_bitmap
*fb
= get_fringe_bitmap_data (bn
);
1136 if (fb
->align
== ALIGN_BITMAP_BOTTOM
&& fb
->period
== 0)
1138 struct glyph_row
*row1
;
1141 bot_ind_max_y
= row
->y
+ row
->visible_height
;
1142 bot_ind_min_y
= bot_ind_max_y
- fb
->height
;
1143 if (bot_ind_min_y
< WINDOW_HEADER_LINE_HEIGHT (w
))
1144 bot_ind_min_y
= WINDOW_HEADER_LINE_HEIGHT (w
);
1146 for (y
= row
->y
, rn
= bot_ind_rn
- 1;
1147 y
>= bot_ind_min_y
&& rn
>= 0;
1148 y
-= row1
->height
, rn
--)
1150 if (top_ind_rn
>= 0 && rn
<= top_ind_rn
)
1153 row1
= w
->desired_matrix
->rows
+ rn
;
1154 if (!row1
->enabled_p
)
1155 row1
= w
->current_matrix
->rows
+ rn
;
1157 row1
->indicate_eob_p
= row
->indicate_eob_p
;
1158 row1
->indicate_bottom_line_p
= row
->indicate_bottom_line_p
;
1164 for (y
= w
->vscroll
, rn
= 0;
1165 y
< yb
&& rn
< nrows
;
1166 y
+= row
->height
, rn
++)
1169 unsigned left_face_id
, right_face_id
;
1170 int left_offset
, right_offset
;
1173 row
= w
->desired_matrix
->rows
+ rn
;
1174 cur
= w
->current_matrix
->rows
+ rn
;
1175 if (!row
->enabled_p
)
1178 left_face_id
= right_face_id
= DEFAULT_FACE_ID
;
1179 left_offset
= right_offset
= 0;
1182 /* Decide which bitmap to draw in the left fringe. */
1183 if (WINDOW_LEFT_FRINGE_WIDTH (w
) == 0)
1184 left
= NO_FRINGE_BITMAP
;
1185 else if (row
->left_user_fringe_bitmap
!= NO_FRINGE_BITMAP
)
1187 left
= row
->left_user_fringe_bitmap
;
1188 left_face_id
= row
->left_user_fringe_face_id
;
1190 else if ((!row
->reversed_p
&& row
->truncated_on_left_p
)
1191 || (row
->reversed_p
&& row
->truncated_on_right_p
))
1192 left
= LEFT_FRINGE (0, Qtruncation
, 0);
1193 else if (row
->indicate_bob_p
&& EQ (boundary_top
, Qleft
))
1195 left
= ((row
->indicate_eob_p
&& EQ (boundary_bot
, Qleft
))
1196 ? LEFT_FRINGE (1, Qtop_bottom
, top_row_ends_at_zv_p
)
1197 : LEFT_FRINGE (2, Qtop
, 0));
1198 if (top_ind_min_y
>= 0)
1199 left_offset
= top_ind_min_y
- row
->y
;
1201 else if (row
->indicate_eob_p
&& EQ (boundary_bot
, Qleft
))
1203 left
= LEFT_FRINGE (3, Qbottom
, bot_row_ends_at_zv_p
);
1204 if (bot_ind_max_y
>= 0)
1205 left_offset
= bot_ind_max_y
- (row
->y
+ row
->visible_height
);
1207 else if ((!row
->reversed_p
&& MATRIX_ROW_CONTINUATION_LINE_P (row
))
1208 || (row
->reversed_p
&& row
->continued_p
))
1209 left
= LEFT_FRINGE (4, Qcontinuation
, 0);
1210 else if (row
->indicate_empty_line_p
&& EQ (empty_pos
, Qleft
))
1211 left
= LEFT_FRINGE (5, Qempty_line
, 0);
1212 else if (row
->indicate_top_line_p
&& EQ (arrow_top
, Qleft
))
1214 left
= LEFT_FRINGE (6, Qup
, 0);
1215 if (top_ind_min_y
>= 0)
1216 left_offset
= top_ind_min_y
- row
->y
;
1218 else if (row
->indicate_bottom_line_p
&& EQ (arrow_bot
, Qleft
))
1220 left
= LEFT_FRINGE (7, Qdown
, 0);
1221 if (bot_ind_max_y
>= 0)
1222 left_offset
= bot_ind_max_y
- (row
->y
+ row
->visible_height
);
1225 left
= NO_FRINGE_BITMAP
;
1227 /* Decide which bitmap to draw in the right fringe. */
1228 if (WINDOW_RIGHT_FRINGE_WIDTH (w
) == 0)
1229 right
= NO_FRINGE_BITMAP
;
1230 else if (row
->right_user_fringe_bitmap
!= NO_FRINGE_BITMAP
)
1232 right
= row
->right_user_fringe_bitmap
;
1233 right_face_id
= row
->right_user_fringe_face_id
;
1235 else if ((!row
->reversed_p
&& row
->truncated_on_right_p
)
1236 || (row
->reversed_p
&& row
->truncated_on_left_p
))
1237 right
= RIGHT_FRINGE (0, Qtruncation
, 0);
1238 else if (row
->indicate_bob_p
&& EQ (boundary_top
, Qright
))
1240 right
= ((row
->indicate_eob_p
&& EQ (boundary_bot
, Qright
))
1241 ? RIGHT_FRINGE (1, Qtop_bottom
, top_row_ends_at_zv_p
)
1242 : RIGHT_FRINGE (2, Qtop
, 0));
1243 if (top_ind_min_y
>= 0)
1244 right_offset
= top_ind_min_y
- row
->y
;
1246 else if (row
->indicate_eob_p
&& EQ (boundary_bot
, Qright
))
1248 right
= RIGHT_FRINGE (3, Qbottom
, bot_row_ends_at_zv_p
);
1249 if (bot_ind_max_y
>= 0)
1250 right_offset
= bot_ind_max_y
- (row
->y
+ row
->visible_height
);
1252 else if ((!row
->reversed_p
&& row
->continued_p
)
1253 || (row
->reversed_p
&& MATRIX_ROW_CONTINUATION_LINE_P (row
)))
1254 right
= RIGHT_FRINGE (4, Qcontinuation
, 0);
1255 else if (row
->indicate_top_line_p
&& EQ (arrow_top
, Qright
))
1257 right
= RIGHT_FRINGE (6, Qup
, 0);
1258 if (top_ind_min_y
>= 0)
1259 right_offset
= top_ind_min_y
- row
->y
;
1261 else if (row
->indicate_bottom_line_p
&& EQ (arrow_bot
, Qright
))
1263 right
= RIGHT_FRINGE (7, Qdown
, 0);
1264 if (bot_ind_max_y
>= 0)
1265 right_offset
= bot_ind_max_y
- (row
->y
+ row
->visible_height
);
1267 else if (row
->indicate_empty_line_p
&& EQ (empty_pos
, Qright
))
1268 right
= RIGHT_FRINGE (5, Qempty_line
, 0);
1270 right
= NO_FRINGE_BITMAP
;
1272 periodic_p
= (get_fringe_bitmap_data (left
)->period
!= 0
1273 || get_fringe_bitmap_data (right
)->period
!= 0);
1275 if (row
->y
!= cur
->y
1276 || row
->visible_height
!= cur
->visible_height
1277 || row
->ends_at_zv_p
!= cur
->ends_at_zv_p
1278 || left
!= cur
->left_fringe_bitmap
1279 || right
!= cur
->right_fringe_bitmap
1280 || left_face_id
!= cur
->left_fringe_face_id
1281 || right_face_id
!= cur
->right_fringe_face_id
1282 || left_offset
!= cur
->left_fringe_offset
1283 || right_offset
!= cur
->right_fringe_offset
1284 || periodic_p
!= cur
->fringe_bitmap_periodic_p
1285 || cur
->redraw_fringe_bitmaps_p
)
1287 redraw_p
= 1, row
->redraw_fringe_bitmaps_p
= 1;
1288 if (!keep_current_p
)
1290 cur
->redraw_fringe_bitmaps_p
= 1;
1291 cur
->left_fringe_bitmap
= left
;
1292 cur
->right_fringe_bitmap
= right
;
1293 cur
->left_fringe_face_id
= left_face_id
;
1294 cur
->right_fringe_face_id
= right_face_id
;
1295 cur
->left_fringe_offset
= left_offset
;
1296 cur
->right_fringe_offset
= right_offset
;
1297 cur
->fringe_bitmap_periodic_p
= periodic_p
;
1301 if (row
->overlay_arrow_bitmap
< 0)
1302 row
->overlay_arrow_bitmap
= get_logical_fringe_bitmap (w
, Qoverlay_arrow
, 0, 0);
1304 if (row
->overlay_arrow_bitmap
!= cur
->overlay_arrow_bitmap
)
1306 redraw_p
= 1, row
->redraw_fringe_bitmaps_p
= 1;
1307 if (!keep_current_p
)
1309 cur
->redraw_fringe_bitmaps_p
= 1;
1310 cur
->overlay_arrow_bitmap
= row
->overlay_arrow_bitmap
;
1314 row
->left_fringe_bitmap
= left
;
1315 row
->right_fringe_bitmap
= right
;
1316 row
->left_fringe_face_id
= left_face_id
;
1317 row
->right_fringe_face_id
= right_face_id
;
1318 row
->left_fringe_offset
= left_offset
;
1319 row
->right_fringe_offset
= right_offset
;
1320 row
->fringe_bitmap_periodic_p
= periodic_p
;
1323 return redraw_p
&& !keep_current_p
;
1328 /* Free resources used by a user-defined bitmap. */
1331 destroy_fringe_bitmap (int n
)
1333 struct fringe_bitmap
**fbp
;
1335 fringe_faces
[n
] = Qnil
;
1337 fbp
= &fringe_bitmaps
[n
];
1338 if (*fbp
&& (*fbp
)->dynamic
)
1340 /* XXX Is SELECTED_FRAME OK here? */
1341 struct redisplay_interface
*rif
= FRAME_RIF (SELECTED_FRAME ());
1342 if (rif
&& rif
->destroy_fringe_bitmap
)
1343 rif
->destroy_fringe_bitmap (n
);
1348 while (max_used_fringe_bitmap
> MAX_STANDARD_FRINGE_BITMAPS
1349 && fringe_bitmaps
[max_used_fringe_bitmap
- 1] == NULL
)
1350 max_used_fringe_bitmap
--;
1354 DEFUN ("destroy-fringe-bitmap", Fdestroy_fringe_bitmap
, Sdestroy_fringe_bitmap
,
1356 doc
: /* Destroy fringe bitmap BITMAP.
1357 If BITMAP overrides a standard fringe bitmap, the original bitmap is restored. */)
1358 (Lisp_Object bitmap
)
1362 CHECK_SYMBOL (bitmap
);
1363 n
= lookup_fringe_bitmap (bitmap
);
1367 destroy_fringe_bitmap (n
);
1369 if (n
>= MAX_STANDARD_FRINGE_BITMAPS
)
1371 Vfringe_bitmaps
= Fdelq (bitmap
, Vfringe_bitmaps
);
1372 /* It would be better to remove the fringe property. */
1373 Fput (bitmap
, Qfringe
, Qnil
);
1380 /* Initialize bitmap bit.
1382 On X, we bit-swap the built-in bitmaps and reduce bitmap
1383 from short to char array if width is <= 8 bits.
1385 On MAC with big-endian CPU, we need to byte-swap each short.
1387 On W32 and MAC (little endian), there's no need to do this.
1390 #if defined (HAVE_X_WINDOWS)
1391 static const unsigned char swap_nibble
[16] = {
1392 0x0, 0x8, 0x4, 0xc, /* 0000 1000 0100 1100 */
1393 0x2, 0xa, 0x6, 0xe, /* 0010 1010 0110 1110 */
1394 0x1, 0x9, 0x5, 0xd, /* 0001 1001 0101 1101 */
1395 0x3, 0xb, 0x7, 0xf}; /* 0011 1011 0111 1111 */
1396 #endif /* HAVE_X_WINDOWS */
1399 init_fringe_bitmap (int which
, struct fringe_bitmap
*fb
, int once_p
)
1401 if (once_p
|| fb
->dynamic
)
1403 #if defined (HAVE_X_WINDOWS)
1404 unsigned short *bits
= fb
->bits
;
1408 for (j
= 0; j
< fb
->height
; j
++)
1410 unsigned short b
= *bits
;
1411 #ifdef WORDS_BIGENDIAN
1412 *bits
++ = (b
<< (16 - fb
->width
));
1414 b
= (unsigned short)((swap_nibble
[b
& 0xf] << 12)
1415 | (swap_nibble
[(b
>>4) & 0xf] << 8)
1416 | (swap_nibble
[(b
>>8) & 0xf] << 4)
1417 | (swap_nibble
[(b
>>12) & 0xf]));
1418 *bits
++ = (b
>> (16 - fb
->width
));
1421 #else /* not USE_CAIRO */
1424 unsigned char *cbits
= (unsigned char *)fb
->bits
;
1425 for (j
= 0; j
< fb
->height
; j
++)
1427 unsigned short b
= *bits
++;
1429 c
= (unsigned char)((swap_nibble
[b
& 0xf] << 4)
1430 | (swap_nibble
[(b
>>4) & 0xf]));
1431 *cbits
++ = (c
>> (8 - fb
->width
));
1436 for (j
= 0; j
< fb
->height
; j
++)
1438 unsigned short b
= *bits
;
1439 b
= (unsigned short)((swap_nibble
[b
& 0xf] << 12)
1440 | (swap_nibble
[(b
>>4) & 0xf] << 8)
1441 | (swap_nibble
[(b
>>8) & 0xf] << 4)
1442 | (swap_nibble
[(b
>>12) & 0xf]));
1443 b
>>= (16 - fb
->width
);
1444 #ifdef WORDS_BIGENDIAN
1450 #endif /* not USE_CAIRO */
1451 #endif /* HAVE_X_WINDOWS */
1454 unsigned short *bits
= fb
->bits
;
1456 for (j
= 0; j
< fb
->height
; j
++)
1458 unsigned short b
= *bits
;
1459 b
<<= (16 - fb
->width
);
1460 /* Windows is little-endian, so the next line is always
1462 b
= ((b
>> 8) | (b
<< 8));
1470 /* XXX Is SELECTED_FRAME OK here? */
1471 struct redisplay_interface
*rif
= FRAME_RIF (SELECTED_FRAME ());
1473 destroy_fringe_bitmap (which
);
1475 if (rif
&& rif
->define_fringe_bitmap
)
1476 rif
->define_fringe_bitmap (which
, fb
->bits
, fb
->height
, fb
->width
);
1478 fringe_bitmaps
[which
] = fb
;
1479 if (which
>= max_used_fringe_bitmap
)
1480 max_used_fringe_bitmap
= which
+ 1;
1485 DEFUN ("define-fringe-bitmap", Fdefine_fringe_bitmap
, Sdefine_fringe_bitmap
,
1487 doc
: /* Define fringe bitmap BITMAP from BITS of size HEIGHT x WIDTH.
1488 BITMAP is a symbol identifying the new fringe bitmap.
1489 BITS is either a string or a vector of integers.
1490 HEIGHT is height of bitmap. If HEIGHT is nil, use length of BITS.
1491 WIDTH must be an integer between 1 and 16, or nil which defaults to 8.
1492 Optional fifth arg ALIGN may be one of `top', `center', or `bottom',
1493 indicating the positioning of the bitmap relative to the rows where it
1494 is used; the default is to center the bitmap. Fifth arg may also be a
1495 list (ALIGN PERIODIC) where PERIODIC non-nil specifies that the bitmap
1497 If BITMAP already exists, the existing definition is replaced. */)
1498 (Lisp_Object bitmap
, Lisp_Object bits
, Lisp_Object height
, Lisp_Object width
, Lisp_Object align
)
1502 struct fringe_bitmap fb
, *xfb
;
1503 int fill1
= 0, fill2
= 0;
1505 CHECK_SYMBOL (bitmap
);
1506 h
= CHECK_VECTOR_OR_STRING (bits
);
1512 CHECK_NUMBER (height
);
1513 fb
.height
= max (0, min (XINT (height
), 255));
1516 fill1
= (fb
.height
- h
) / 2;
1517 fill2
= fb
.height
- h
- fill1
;
1525 CHECK_NUMBER (width
);
1526 fb
.width
= max (0, min (XINT (width
), 255));
1530 fb
.align
= ALIGN_BITMAP_CENTER
;
1534 Lisp_Object period
= XCDR (align
);
1537 period
= XCAR (period
);
1540 fb
.period
= fb
.height
;
1544 align
= XCAR (align
);
1546 if (EQ (align
, Qtop
))
1547 fb
.align
= ALIGN_BITMAP_TOP
;
1548 else if (EQ (align
, Qbottom
))
1549 fb
.align
= ALIGN_BITMAP_BOTTOM
;
1550 else if (!NILP (align
) && !EQ (align
, Qcenter
))
1551 error ("Bad align argument");
1553 n
= lookup_fringe_bitmap (bitmap
);
1556 if (max_used_fringe_bitmap
< max_fringe_bitmaps
)
1557 n
= max_used_fringe_bitmap
++;
1560 for (n
= MAX_STANDARD_FRINGE_BITMAPS
;
1561 n
< max_fringe_bitmaps
;
1563 if (fringe_bitmaps
[n
] == NULL
)
1566 if (n
== max_fringe_bitmaps
)
1568 int bitmaps
= max_fringe_bitmaps
+ 20;
1569 if (MAX_FRINGE_BITMAPS
< bitmaps
)
1570 error ("No free fringe bitmap slots");
1572 i
= max_fringe_bitmaps
;
1573 fringe_bitmaps
= xrealloc (fringe_bitmaps
,
1574 bitmaps
* sizeof *fringe_bitmaps
);
1575 fringe_faces
= xrealloc (fringe_faces
,
1576 bitmaps
* sizeof *fringe_faces
);
1578 for (i
= max_fringe_bitmaps
; i
< bitmaps
; i
++)
1580 fringe_bitmaps
[i
] = NULL
;
1581 fringe_faces
[i
] = Qnil
;
1584 max_fringe_bitmaps
= bitmaps
;
1588 Vfringe_bitmaps
= Fcons (bitmap
, Vfringe_bitmaps
);
1589 Fput (bitmap
, Qfringe
, make_number (n
));
1594 xfb
= xmalloc (sizeof fb
+ fb
.height
* BYTES_PER_BITMAP_ROW
);
1595 fb
.bits
= b
= ((unsigned short *)
1596 ptr_bounds_clip (xfb
+ 1, fb
.height
* BYTES_PER_BITMAP_ROW
));
1597 xfb
= ptr_bounds_clip (xfb
, sizeof *xfb
);
1598 memset (b
, 0, fb
.height
);
1601 while (j
< fb
.height
)
1603 for (i
= 0; i
< fill1
&& j
< fb
.height
; i
++)
1605 for (i
= 0; i
< h
&& j
< fb
.height
; i
++)
1607 Lisp_Object elt
= Faref (bits
, make_number (i
));
1608 b
[j
++] = NUMBERP (elt
) ? XINT (elt
) : 0;
1610 for (i
= 0; i
< fill2
&& j
< fb
.height
; i
++)
1616 init_fringe_bitmap (n
, xfb
, 0);
1621 DEFUN ("set-fringe-bitmap-face", Fset_fringe_bitmap_face
, Sset_fringe_bitmap_face
,
1623 doc
: /* Set face for fringe bitmap BITMAP to FACE.
1624 FACE is merged with the `fringe' face, so normally FACE should specify
1625 only the foreground color.
1626 If FACE is nil, reset face to default fringe face. */)
1627 (Lisp_Object bitmap
, Lisp_Object face
)
1631 CHECK_SYMBOL (bitmap
);
1632 n
= lookup_fringe_bitmap (bitmap
);
1634 error ("Undefined fringe bitmap");
1636 /* The purpose of the following code is to signal an error if FACE
1637 is not a face. This is for the caller's convenience only; the
1638 redisplay code should be able to fail gracefully. Skip the check
1639 if FRINGE_FACE_ID is unrealized (as in batch mode and during
1643 struct frame
*f
= SELECTED_FRAME ();
1645 if (FACE_FROM_ID_OR_NULL (f
, FRINGE_FACE_ID
)
1646 && lookup_derived_face (f
, face
, FRINGE_FACE_ID
, 1) < 0)
1647 error ("No such face");
1650 fringe_faces
[n
] = face
;
1654 DEFUN ("fringe-bitmaps-at-pos", Ffringe_bitmaps_at_pos
, Sfringe_bitmaps_at_pos
,
1656 doc
: /* Return fringe bitmaps of row containing position POS in window WINDOW.
1657 If WINDOW is nil, use selected window. If POS is nil, use value of point
1658 in that window. Return value is a list (LEFT RIGHT OV), where LEFT
1659 is the symbol for the bitmap in the left fringe (or nil if no bitmap),
1660 RIGHT is similar for the right fringe, and OV is non-nil if there is an
1661 overlay arrow in the left fringe.
1662 Return nil if POS is not visible in WINDOW. */)
1663 (Lisp_Object pos
, Lisp_Object window
)
1666 struct glyph_row
*row
;
1669 w
= decode_any_window (window
);
1670 XSETWINDOW (window
, w
);
1674 CHECK_NUMBER_COERCE_MARKER (pos
);
1675 if (! (BEGV
<= XINT (pos
) && XINT (pos
) <= ZV
))
1676 args_out_of_range (window
, pos
);
1677 textpos
= XINT (pos
);
1679 else if (w
== XWINDOW (selected_window
))
1682 textpos
= marker_position (w
->pointm
);
1684 row
= MATRIX_FIRST_TEXT_ROW (w
->current_matrix
);
1685 row
= row_containing_pos (w
, textpos
, row
, NULL
, 0);
1687 return list3 (get_fringe_bitmap_name (row
->left_fringe_bitmap
),
1688 get_fringe_bitmap_name (row
->right_fringe_bitmap
),
1689 (row
->overlay_arrow_bitmap
== 0 ? Qnil
1690 : row
->overlay_arrow_bitmap
< 0 ? Qt
1691 : get_fringe_bitmap_name (row
->overlay_arrow_bitmap
)));
1697 /***********************************************************************
1699 ***********************************************************************/
1702 syms_of_fringe (void)
1704 DEFSYM (Qtruncation
, "truncation");
1705 DEFSYM (Qcontinuation
, "continuation");
1706 DEFSYM (Qoverlay_arrow
, "overlay-arrow");
1707 DEFSYM (Qempty_line
, "empty-line");
1708 DEFSYM (Qtop_bottom
, "top-bottom");
1709 DEFSYM (Qhollow_small
, "hollow-small");
1711 defsubr (&Sdestroy_fringe_bitmap
);
1712 defsubr (&Sdefine_fringe_bitmap
);
1713 defsubr (&Sfringe_bitmaps_at_pos
);
1714 defsubr (&Sset_fringe_bitmap_face
);
1716 DEFVAR_LISP ("overflow-newline-into-fringe", Voverflow_newline_into_fringe
,
1717 doc
: /* Non-nil means that newline may flow into the right fringe.
1718 This means that display lines which are exactly as wide as the window
1719 \(not counting the final newline) will only occupy one screen line, by
1720 showing (or hiding) the final newline in the right fringe; when point
1721 is at the final newline, the cursor is shown in the right fringe.
1722 If nil, also continue lines which are exactly as wide as the window. */);
1723 Voverflow_newline_into_fringe
= Qt
;
1725 DEFVAR_LISP ("fringe-bitmaps", Vfringe_bitmaps
,
1726 doc
: /* List of fringe bitmap symbols. */);
1727 Vfringe_bitmaps
= Qnil
;
1730 /* Garbage collection hook */
1733 mark_fringe_data (void)
1737 for (i
= 0; i
< max_fringe_bitmaps
; i
++)
1738 if (!NILP (fringe_faces
[i
]))
1739 mark_object (fringe_faces
[i
]);
1742 /* Initialize this module when Emacs starts. */
1745 init_fringe_once (void)
1749 for (bt
= NO_FRINGE_BITMAP
+ 1; bt
< MAX_STANDARD_FRINGE_BITMAPS
; bt
++)
1750 init_fringe_bitmap (bt
, &standard_bitmaps
[bt
], 1);
1756 max_fringe_bitmaps
= MAX_STANDARD_FRINGE_BITMAPS
+ 20;
1758 fringe_bitmaps
= xzalloc (max_fringe_bitmaps
* sizeof *fringe_bitmaps
);
1760 verify (NIL_IS_ZERO
);
1761 fringe_faces
= xzalloc (max_fringe_bitmaps
* sizeof *fringe_faces
);
1764 #if defined (HAVE_NTGUI) || defined (USE_CAIRO)
1768 w32_init_fringe (struct redisplay_interface
*rif
)
1770 x_cr_init_fringe (struct redisplay_interface
*rif
)
1778 for (bt
= NO_FRINGE_BITMAP
+ 1; bt
< MAX_STANDARD_FRINGE_BITMAPS
; bt
++)
1780 struct fringe_bitmap
*fb
= &standard_bitmaps
[bt
];
1781 rif
->define_fringe_bitmap (bt
, fb
->bits
, fb
->height
, fb
->width
);
1788 w32_reset_fringes (void)
1790 /* Destroy row bitmaps. */
1792 struct redisplay_interface
*rif
= FRAME_RIF (SELECTED_FRAME ());
1797 for (bt
= NO_FRINGE_BITMAP
+ 1; bt
< max_used_fringe_bitmap
; bt
++)
1798 rif
->destroy_fringe_bitmap (bt
);
1801 #endif /* HAVE_NTGUI */