1 /* Fringe handling (split from xdisp.c).
2 Copyright (C) 1985-1988, 1993-1995, 1997-2017 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/>. */
28 #include "dispextern.h"
30 #include "blockinput.h"
31 #include "termhooks.h"
33 /* Fringe bitmaps are represented in three different ways:
35 Logical bitmaps are used internally to denote things like
36 'end-of-buffer', 'left-truncation', 'overlay-arrow', etc.
38 Physical bitmaps specify the visual appearance of the bitmap,
39 e.g. 'bottom-left-angle', 'left-arrow', 'left-triangle', etc.
40 User defined bitmaps are physical bitmaps.
42 Internally, fringe bitmaps for a specific display row are
43 represented as a simple integer that is used as an index
44 into the table of all defined bitmaps. This index is stored
45 in the `fringe' property of the physical bitmap symbol.
47 Logical bitmaps are mapped to physical bitmaps through the
48 buffer-local `fringe-indicator-alist' variable.
50 Each element of this alist is a cons (LOGICAL . PHYSICAL)
51 mapping a logical bitmap to a physical bitmap.
52 PHYSICAL is either a symbol to use in both left and right fringe,
53 or a cons of two symbols (LEFT . RIGHT) denoting different
54 bitmaps to use in left and right fringe.
56 LOGICAL is first looked up in the window's buffer's buffer-local
57 value of the fringe-indicator-alist variable, and if not present,
58 in the global value of fringe-indicator-alist.
60 If LOGICAL is not present in either alist, or the PHYSICAL value
61 found is nil, no bitmap is shown for the logical bitmap.
63 The `left-fringe' and `right-fringe' display properties
64 must specify physical bitmap symbols.
67 enum fringe_bitmap_align
69 ALIGN_BITMAP_CENTER
= 0,
85 /***********************************************************************
87 ***********************************************************************/
89 /* Undefined bitmap. A question mark. */
102 static unsigned short question_mark_bits
[] = {
103 0x3c, 0x7e, 0x7e, 0x0c, 0x18, 0x18, 0x00, 0x18, 0x18};
105 /* An exclamation mark. */
118 static unsigned short exclamation_mark_bits
[] = {
119 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00, 0x18};
121 /* An arrow like this: `<-'. */
132 static unsigned short left_arrow_bits
[] = {
133 0x18, 0x30, 0x60, 0xfc, 0xfc, 0x60, 0x30, 0x18};
136 /* Right truncation arrow bitmap `->'. */
147 static unsigned short right_arrow_bits
[] = {
148 0x18, 0x0c, 0x06, 0x3f, 0x3f, 0x06, 0x0c, 0x18};
151 /* Up arrow bitmap. */
162 static unsigned short up_arrow_bits
[] = {
163 0x18, 0x3c, 0x7e, 0xff, 0x18, 0x18, 0x18, 0x18};
166 /* Down arrow bitmap. */
177 static unsigned short down_arrow_bits
[] = {
178 0x18, 0x18, 0x18, 0x18, 0xff, 0x7e, 0x3c, 0x18};
180 /* Marker for continuation lines. */
191 static unsigned short left_curly_arrow_bits
[] = {
192 0x3c, 0x7c, 0xc0, 0xe4, 0xfc, 0x7c, 0x3c, 0x7c};
194 /* Marker for continued lines. */
205 static unsigned short right_curly_arrow_bits
[] = {
206 0x3c, 0x3e, 0x03, 0x27, 0x3f, 0x3e, 0x3c, 0x3e};
208 /* Reverse Overlay arrow bitmap. A triangular arrow. */
219 static unsigned short left_triangle_bits
[] = {
220 0x03, 0x0f, 0x1f, 0x3f, 0x3f, 0x1f, 0x0f, 0x03};
222 /* Overlay arrow bitmap. A triangular arrow. */
233 static unsigned short right_triangle_bits
[] = {
234 0xc0, 0xf0, 0xf8, 0xfc, 0xfc, 0xf8, 0xf0, 0xc0};
236 /* First line bitmap. An top-left angle. */
247 static unsigned short top_left_angle_bits
[] = {
248 0xfc, 0xfc, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0x00};
250 /* First line bitmap. An right-up angle. */
261 static unsigned short top_right_angle_bits
[] = {
262 0x3f, 0x3f, 0x03, 0x03, 0x03, 0x03, 0x03, 0x00};
264 /* Last line bitmap. An left-down angle. */
275 static unsigned short bottom_left_angle_bits
[] = {
276 0x00, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xfc, 0xfc};
278 /* Last line bitmap. An right-down angle. */
289 static unsigned short bottom_right_angle_bits
[] = {
290 0x00, 0x03, 0x03, 0x03, 0x03, 0x03, 0x3f, 0x3f};
292 /* First/last line bitmap. An left bracket. */
305 static unsigned short left_bracket_bits
[] = {
306 0xfc, 0xfc, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xfc, 0xfc};
308 /* First/last line bitmap. An right bracket. */
321 static unsigned short right_bracket_bits
[] = {
322 0x3f, 0x3f, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x3f, 0x3f};
324 /* Filled box cursor bitmap. A filled box; max 13 pixels high. */
340 static unsigned short filled_rectangle_bits
[] = {
341 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe, 0xfe};
343 /* Hollow box cursor bitmap. A hollow box; max 13 pixels high. */
359 static unsigned short hollow_rectangle_bits
[] = {
360 0xfe, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0xfe};
362 /* Hollow square bitmap. */
371 static unsigned short hollow_square_bits
[] = {
372 0x7e, 0x42, 0x42, 0x42, 0x42, 0x7e};
374 /* Filled square bitmap. */
383 static unsigned short filled_square_bits
[] = {
384 0x7e, 0x7e, 0x7e, 0x7e, 0x7e, 0x7e};
386 /* Bar cursor bitmap. A vertical bar; max 13 pixels high. */
402 static unsigned short vertical_bar_bits
[] = {
403 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0, 0xc0};
405 /* HBar cursor bitmap. A horizontal bar; 2 pixels high. */
410 static unsigned short horizontal_bar_bits
[] = {
414 /* Bitmap drawn to indicate lines not displaying text if
415 `indicate-empty-lines' is non-nil. */
424 static unsigned short empty_line_bits
[] = {
425 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
426 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
427 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
428 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
429 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
430 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
431 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00,
432 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00, 0x00, 0x3c, 0x00};
435 #define BYTES_PER_BITMAP_ROW (sizeof (unsigned short))
436 #define STANDARD_BITMAP_HEIGHT(bits) (sizeof (bits)/BYTES_PER_BITMAP_ROW)
437 #define FRBITS(bits) bits, STANDARD_BITMAP_HEIGHT (bits)
439 /* NOTE: The order of these bitmaps must match the sequence
440 used in fringe.el to define the corresponding symbols. */
442 static struct fringe_bitmap standard_bitmaps
[] =
444 { NULL
, 0, 0, 0, 0, 0 }, /* NO_FRINGE_BITMAP */
445 { FRBITS (question_mark_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
446 { FRBITS (exclamation_mark_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
447 { FRBITS (left_arrow_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
448 { FRBITS (right_arrow_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
449 { FRBITS (up_arrow_bits
), 8, 0, ALIGN_BITMAP_TOP
, 0 },
450 { FRBITS (down_arrow_bits
), 8, 0, ALIGN_BITMAP_BOTTOM
, 0 },
451 { FRBITS (left_curly_arrow_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
452 { FRBITS (right_curly_arrow_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
453 { FRBITS (left_triangle_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
454 { FRBITS (right_triangle_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
455 { FRBITS (top_left_angle_bits
), 8, 0, ALIGN_BITMAP_TOP
, 0 },
456 { FRBITS (top_right_angle_bits
), 8, 0, ALIGN_BITMAP_TOP
, 0 },
457 { FRBITS (bottom_left_angle_bits
), 8, 0, ALIGN_BITMAP_BOTTOM
, 0 },
458 { FRBITS (bottom_right_angle_bits
), 8, 0, ALIGN_BITMAP_BOTTOM
, 0 },
459 { FRBITS (left_bracket_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
460 { FRBITS (right_bracket_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
461 { FRBITS (filled_rectangle_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
462 { FRBITS (hollow_rectangle_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
463 { FRBITS (filled_square_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
464 { FRBITS (hollow_square_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
465 { FRBITS (vertical_bar_bits
), 8, 0, ALIGN_BITMAP_CENTER
, 0 },
466 { FRBITS (horizontal_bar_bits
), 8, 0, ALIGN_BITMAP_BOTTOM
, 0 },
467 { FRBITS (empty_line_bits
), 8, 3, ALIGN_BITMAP_TOP
, 0 },
470 #define NO_FRINGE_BITMAP 0
471 #define UNDEF_FRINGE_BITMAP 1
472 #define MAX_STANDARD_FRINGE_BITMAPS ARRAYELTS (standard_bitmaps)
474 static struct fringe_bitmap
**fringe_bitmaps
;
475 static Lisp_Object
*fringe_faces
;
476 static int max_fringe_bitmaps
;
478 int max_used_fringe_bitmap
= MAX_STANDARD_FRINGE_BITMAPS
;
481 /* Lookup bitmap number for symbol BITMAP.
482 Return 0 if not a bitmap. */
485 lookup_fringe_bitmap (Lisp_Object bitmap
)
489 bitmap
= Fget (bitmap
, Qfringe
);
490 if (!INTEGERP (bitmap
))
494 if (bn
> NO_FRINGE_BITMAP
495 && bn
< max_used_fringe_bitmap
496 && (bn
< MAX_STANDARD_FRINGE_BITMAPS
497 || fringe_bitmaps
[bn
] != NULL
))
503 /* Get fringe bitmap name for bitmap number BN.
505 Found by traversing Vfringe_bitmaps comparing BN to the
506 fringe property for each symbol.
508 Return BN if not found in Vfringe_bitmaps. */
511 get_fringe_bitmap_name (int bn
)
516 /* Zero means no bitmap -- return nil. */
520 bitmaps
= Vfringe_bitmaps
;
521 num
= make_number (bn
);
523 while (CONSP (bitmaps
))
525 Lisp_Object bitmap
= XCAR (bitmaps
);
526 if (EQ (num
, Fget (bitmap
, Qfringe
)))
528 bitmaps
= XCDR (bitmaps
);
534 /* Get fringe bitmap data for bitmap number BN. */
536 static struct fringe_bitmap
*
537 get_fringe_bitmap_data (int bn
)
539 struct fringe_bitmap
*fb
;
541 fb
= fringe_bitmaps
[bn
];
543 fb
= &standard_bitmaps
[bn
< MAX_STANDARD_FRINGE_BITMAPS
544 ? bn
: UNDEF_FRINGE_BITMAP
];
549 /* Draw the bitmap WHICH in one of the left or right fringes of
550 window W. ROW is the glyph row for which to display the bitmap; it
551 determines the vertical position at which the bitmap has to be
553 LEFT_P is 1 for left fringe, 0 for right fringe.
557 draw_fringe_bitmap_1 (struct window
*w
, struct glyph_row
*row
, int left_p
, int overlay
, int which
)
559 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
560 struct draw_fringe_bitmap_params p
;
561 struct fringe_bitmap
*fb
;
563 int face_id
= DEFAULT_FACE_ID
;
564 int offset
, header_line_height
;
566 p
.overlay_p
= (overlay
& 1) == 1;
567 p
.cursor_p
= (overlay
& 2) == 2;
569 if (which
!= NO_FRINGE_BITMAP
)
575 which
= row
->left_fringe_bitmap
;
576 face_id
= row
->left_fringe_face_id
;
577 offset
= row
->left_fringe_offset
;
581 which
= row
->right_fringe_bitmap
;
582 face_id
= row
->right_fringe_face_id
;
583 offset
= row
->right_fringe_offset
;
586 if (face_id
== DEFAULT_FACE_ID
)
588 Lisp_Object face
= fringe_faces
[which
];
589 face_id
= NILP (face
) ? lookup_named_face (f
, Qfringe
, false)
590 : lookup_derived_face (f
, face
, FRINGE_FACE_ID
, 0);
592 face_id
= FRINGE_FACE_ID
;
595 fb
= get_fringe_bitmap_data (which
);
599 /* Convert row to frame coordinates. */
600 p
.y
= WINDOW_TO_FRAME_PIXEL_Y (w
, row
->y
) + offset
;
607 p
.dh
= (period
> 0 ? (p
.y
% period
) : 0);
610 /* Adjust y to the offset in the row to start drawing the bitmap. */
613 case ALIGN_BITMAP_CENTER
:
614 p
.y
+= (row
->height
- p
.h
) / 2;
616 case ALIGN_BITMAP_BOTTOM
:
617 p
.y
+= (row
->visible_height
- p
.h
);
619 case ALIGN_BITMAP_TOP
:
623 p
.face
= FACE_FROM_ID_OR_NULL (f
, face_id
);
626 /* This could happen after clearing face cache.
627 But it shouldn't happen anymore. ++kfs */
631 prepare_face_for_display (f
, p
.face
);
633 /* Clear left fringe if no bitmap to draw or if bitmap doesn't fill
636 header_line_height
= WINDOW_HEADER_LINE_HEIGHT (w
);
637 p
.by
= WINDOW_TO_FRAME_PIXEL_Y (w
, max (header_line_height
, row
->y
));
638 p
.ny
= row
->visible_height
;
641 int wd
= WINDOW_LEFT_FRINGE_WIDTH (w
);
642 int x
= window_box_left (w
, (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w
)
647 p
.x
= x
- p
.wd
- (wd
- p
.wd
) / 2;
649 if (p
.wd
< wd
|| p
.y
> p
.by
|| p
.y
+ p
.h
< p
.by
+ p
.ny
)
651 /* If W has a vertical border to its left, don't draw over it. */
652 wd
-= ((!WINDOW_LEFTMOST_P (w
)
653 /* This could be wrong when we allow window local
654 right dividers - but the window on the left is hard
656 && !FRAME_RIGHT_DIVIDER_WIDTH (f
)
657 && !WINDOW_HAS_VERTICAL_SCROLL_BAR (w
)
658 /* But don't reduce the fringe width if the window
659 has a left margin, because that means we are not
660 in danger of drawing over the vertical border,
661 and OTOH leaving out that one pixel leaves behind
662 traces of the cursor, if it was in column zero
663 before drawing non-empty margin area. */
664 && w
->left_margin_cols
== 0)
672 int x
= window_box_right (w
,
673 (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w
)
676 int wd
= WINDOW_RIGHT_FRINGE_WIDTH (w
);
679 p
.x
= x
+ (wd
- p
.wd
) / 2;
680 /* Clear right fringe if no bitmap to draw of if bitmap doesn't fill
682 if (p
.wd
< wd
|| p
.y
> p
.by
|| p
.y
+ p
.h
< p
.by
+ p
.ny
)
689 if (p
.x
>= WINDOW_BOX_LEFT_EDGE_X (w
)
690 && (p
.x
+ p
.wd
) <= WINDOW_BOX_LEFT_EDGE_X (w
) + WINDOW_PIXEL_WIDTH (w
))
691 FRAME_RIF (f
)->draw_fringe_bitmap (w
, row
, &p
);
695 get_logical_cursor_bitmap (struct window
*w
, Lisp_Object cursor
)
697 Lisp_Object cmap
, bm
= Qnil
;
699 if ((cmap
= BVAR (XBUFFER (w
->contents
), fringe_cursor_alist
)), !NILP (cmap
))
701 bm
= Fassq (cursor
, cmap
);
704 if ((bm
= XCDR (bm
)), NILP (bm
))
705 return NO_FRINGE_BITMAP
;
706 return lookup_fringe_bitmap (bm
);
709 if (EQ (cmap
, BVAR (&buffer_defaults
, fringe_cursor_alist
)))
710 return NO_FRINGE_BITMAP
;
711 bm
= Fassq (cursor
, BVAR (&buffer_defaults
, fringe_cursor_alist
));
712 if (!CONSP (bm
) || ((bm
= XCDR (bm
)), NILP (bm
)))
713 return NO_FRINGE_BITMAP
;
714 return lookup_fringe_bitmap (bm
);
718 get_logical_fringe_bitmap (struct window
*w
, Lisp_Object bitmap
, int right_p
, int partial_p
)
720 Lisp_Object cmap
, bm1
= Qnil
, bm2
= Qnil
, bm
;
721 EMACS_INT ln1
= 0, ln2
= 0;
723 int ix2
= ix1
+ (partial_p
? 2 : 0);
725 /* Lookup in buffer-local fringe-indicator-alist before global alist.
728 BITMAP -- use for all
729 (L R) -- use for left right (whether partial or not)
730 (L R PL PR) -- use for left right partial-left partial-right
731 If any value in local binding is not present or t, use global value.
733 If partial, lookup partial bitmap in default value if not found here.
734 If not partial, or no partial spec is present, use non-partial bitmap. */
736 if ((cmap
= BVAR (XBUFFER (w
->contents
), fringe_indicator_alist
)), !NILP (cmap
))
738 bm1
= Fassq (bitmap
, cmap
);
741 if ((bm1
= XCDR (bm1
)), NILP (bm1
))
742 return NO_FRINGE_BITMAP
;
745 ln1
= XINT (Flength (bm1
));
750 bm
= Fnth (make_number (ix2
), bm1
);
759 bm
= Fnth (make_number (ix1
), bm1
);
765 else if ((bm
= bm1
, !EQ (bm
, Qt
)))
770 if (!EQ (cmap
, BVAR (&buffer_defaults
, fringe_indicator_alist
))
771 && !NILP (BVAR (&buffer_defaults
, fringe_indicator_alist
)))
773 bm2
= Fassq (bitmap
, BVAR (&buffer_defaults
, fringe_indicator_alist
));
776 if ((bm2
= XCDR (bm2
)), !NILP (bm2
))
780 ln2
= XINT (Flength (bm2
));
785 bm
= Fnth (make_number (ix2
), bm2
);
797 bm
= Fnth (make_number (ix1
), bm1
);
804 bm
= Fnth (make_number (ix1
), bm2
);
807 return NO_FRINGE_BITMAP
;
809 else if ((bm
= bm2
, NILP (bm
)))
810 return NO_FRINGE_BITMAP
;
813 return lookup_fringe_bitmap (bm
);
818 draw_fringe_bitmap (struct window
*w
, struct glyph_row
*row
, int left_p
)
822 if (left_p
== row
->reversed_p
&& row
->cursor_in_fringe_p
)
824 Lisp_Object cursor
= Qnil
;
826 switch (w
->phys_cursor_type
)
828 case HOLLOW_BOX_CURSOR
:
829 if (row
->visible_height
>= STANDARD_BITMAP_HEIGHT (hollow_rectangle_bits
))
832 cursor
= Qhollow_small
;
834 case FILLED_BOX_CURSOR
:
845 w
->phys_cursor_on_p
= 0;
846 row
->cursor_in_fringe_p
= 0;
851 int bm
= get_logical_cursor_bitmap (w
, cursor
);
852 if (bm
!= NO_FRINGE_BITMAP
)
854 draw_fringe_bitmap_1 (w
, row
, left_p
, 2, bm
);
855 overlay
= EQ (cursor
, Qbox
) ? 3 : 1;
860 draw_fringe_bitmap_1 (w
, row
, left_p
, overlay
, NO_FRINGE_BITMAP
);
862 if (left_p
&& row
->overlay_arrow_bitmap
!= NO_FRINGE_BITMAP
)
863 draw_fringe_bitmap_1 (w
, row
, 1, 1, row
->overlay_arrow_bitmap
);
867 /* Draw fringe bitmaps for glyph row ROW on window W. Call this
868 function with input blocked. */
871 draw_row_fringe_bitmaps (struct window
*w
, struct glyph_row
*row
)
873 eassert (input_blocked_p ());
875 /* If row is completely invisible, because of vscrolling, we
876 don't have to draw anything. */
877 if (row
->visible_height
<= 0)
880 if (WINDOW_LEFT_FRINGE_WIDTH (w
) != 0)
881 draw_fringe_bitmap (w
, row
, 1);
883 if (WINDOW_RIGHT_FRINGE_WIDTH (w
) != 0)
884 draw_fringe_bitmap (w
, row
, 0);
887 /* Draw the fringes of window W. Only fringes for rows marked for
888 update in redraw_fringe_bitmaps_p are drawn.
890 Return nonzero if left or right fringe was redrawn in any way.
892 If NO_FRINGE_P is non-zero, also return nonzero if either fringe
895 A return nonzero value indicates that the vertical line between
896 windows needs update (as it may be drawn in the fringe).
900 draw_window_fringes (struct window
*w
, bool no_fringe_p
)
902 struct glyph_row
*row
;
903 int yb
= window_text_bottom_y (w
);
904 int nrows
= w
->current_matrix
->nrows
;
908 if (w
->pseudo_window_p
)
911 /* Must draw line if no fringe */
913 && (WINDOW_LEFT_FRINGE_WIDTH (w
) == 0
914 || WINDOW_RIGHT_FRINGE_WIDTH (w
) == 0))
917 for (y
= w
->vscroll
, rn
= 0, row
= w
->current_matrix
->rows
;
918 y
< yb
&& rn
< nrows
;
919 y
+= row
->height
, ++row
, ++rn
)
921 if (!row
->redraw_fringe_bitmaps_p
)
923 draw_row_fringe_bitmaps (w
, row
);
924 row
->redraw_fringe_bitmaps_p
= 0;
932 /* Recalculate the bitmaps to show in the fringes of window W.
933 Only mark rows with modified bitmaps for update in redraw_fringe_bitmaps_p.
935 If KEEP_CURRENT_P is 0, update current_matrix too. */
938 update_window_fringes (struct window
*w
, bool keep_current_p
)
940 struct glyph_row
*row
, *cur
= 0;
941 int yb
= window_text_bottom_y (w
);
942 int rn
, nrows
= w
->current_matrix
->nrows
;
945 Lisp_Object boundary_top
= Qnil
, boundary_bot
= Qnil
;
946 Lisp_Object arrow_top
= Qnil
, arrow_bot
= Qnil
;
947 Lisp_Object empty_pos
;
948 Lisp_Object ind
= Qnil
;
949 #define MAX_BITMAP_CACHE (8*4)
950 int bitmap_cache
[MAX_BITMAP_CACHE
];
951 int top_ind_rn
, bot_ind_rn
;
952 int top_ind_min_y
, bot_ind_max_y
;
954 /* top_ind_rn is set to a nonnegative value whenever
955 row->indicate_bob_p is set, so it's OK that top_row_ends_at_zv_p
956 is not initialized here. Similarly for bot_ind_rn,
957 row->indicate_eob_p and bot_row_ends_at_zv_p. */
958 int top_row_ends_at_zv_p UNINIT
, bot_row_ends_at_zv_p UNINIT
;
960 if (w
->pseudo_window_p
)
963 if (!MINI_WINDOW_P (w
)
964 && (ind
= BVAR (XBUFFER (w
->contents
), indicate_buffer_boundaries
), !NILP (ind
)))
966 if (EQ (ind
, Qleft
) || EQ (ind
, Qright
))
967 boundary_top
= boundary_bot
= arrow_top
= arrow_bot
= ind
;
968 else if (CONSP (ind
) && CONSP (XCAR (ind
)))
971 if (pos
= Fassq (Qt
, ind
), !NILP (pos
))
972 boundary_top
= boundary_bot
= arrow_top
= arrow_bot
= XCDR (pos
);
973 if (pos
= Fassq (Qtop
, ind
), !NILP (pos
))
974 boundary_top
= XCDR (pos
);
975 if (pos
= Fassq (Qbottom
, ind
), !NILP (pos
))
976 boundary_bot
= XCDR (pos
);
977 if (pos
= Fassq (Qup
, ind
), !NILP (pos
))
978 arrow_top
= XCDR (pos
);
979 if (pos
= Fassq (Qdown
, ind
), !NILP (pos
))
980 arrow_bot
= XCDR (pos
);
983 /* Anything else means boundary on left and no arrows. */
984 boundary_top
= boundary_bot
= Qleft
;
987 top_ind_rn
= bot_ind_rn
= -1;
990 for (y
= w
->vscroll
, rn
= 0;
991 y
< yb
&& rn
< nrows
;
992 y
+= row
->height
, ++rn
)
994 row
= w
->desired_matrix
->rows
+ rn
;
996 row
= w
->current_matrix
->rows
+ rn
;
998 row
->indicate_bob_p
= row
->indicate_top_line_p
= 0;
999 row
->indicate_eob_p
= row
->indicate_bottom_line_p
= 0;
1001 if (!row
->mode_line_p
)
1003 if (top_ind_rn
< 0 && row
->visible_height
> 0)
1005 if (MATRIX_ROW_START_CHARPOS (row
) <= BUF_BEGV (XBUFFER (w
->contents
))
1006 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_TOP_P (w
, row
))
1007 row
->indicate_bob_p
= !NILP (boundary_top
);
1009 row
->indicate_top_line_p
= !NILP (arrow_top
);
1015 if (MATRIX_ROW_END_CHARPOS (row
) >= BUF_ZV (XBUFFER (w
->contents
))
1016 && !MATRIX_ROW_PARTIALLY_VISIBLE_AT_BOTTOM_P (w
, row
))
1017 row
->indicate_eob_p
= !NILP (boundary_bot
), bot_ind_rn
= rn
;
1018 else if (y
+ row
->height
>= yb
)
1019 row
->indicate_bottom_line_p
= !NILP (arrow_bot
), bot_ind_rn
= rn
;
1025 empty_pos
= BVAR (XBUFFER (w
->contents
), indicate_empty_lines
);
1026 if (!NILP (empty_pos
) && !EQ (empty_pos
, Qright
))
1027 empty_pos
= WINDOW_LEFT_FRINGE_WIDTH (w
) == 0 ? Qright
: Qleft
;
1029 for (y
= 0; y
< MAX_BITMAP_CACHE
; y
++)
1030 bitmap_cache
[y
] = -1;
1032 #define LEFT_FRINGE(cache, which, partial_p) \
1033 (bitmap_cache[cache*4+partial_p] >= 0 \
1034 ? bitmap_cache[cache*4+partial_p] \
1035 : (bitmap_cache[cache*4+partial_p] = \
1036 get_logical_fringe_bitmap (w, which, 0, partial_p)))
1038 #define RIGHT_FRINGE(cache, which, partial_p) \
1039 (bitmap_cache[cache*4+2+partial_p] >= 0 \
1040 ? bitmap_cache[cache*4+2+partial_p] \
1041 : (bitmap_cache[cache*4+2+partial_p] = \
1042 get_logical_fringe_bitmap (w, which, 1, partial_p)))
1045 /* Extend top-aligned top indicator (or bottom-aligned bottom
1046 indicator) to adjacent rows if it doesn't fit in one row. */
1047 top_ind_min_y
= bot_ind_max_y
= -1;
1048 if (top_ind_rn
>= 0)
1050 int bn
= NO_FRINGE_BITMAP
;
1052 row
= w
->desired_matrix
->rows
+ top_ind_rn
;
1053 if (!row
->enabled_p
)
1054 row
= w
->current_matrix
->rows
+ top_ind_rn
;
1056 top_row_ends_at_zv_p
= row
->ends_at_zv_p
;
1057 if (row
->indicate_bob_p
)
1059 if (EQ (boundary_top
, Qleft
))
1060 bn
= ((row
->indicate_eob_p
&& EQ (boundary_bot
, Qleft
))
1061 ? LEFT_FRINGE (1, Qtop_bottom
, row
->ends_at_zv_p
)
1062 : LEFT_FRINGE (2, Qtop
, 0));
1064 bn
= ((row
->indicate_eob_p
&& EQ (boundary_bot
, Qright
))
1065 ? RIGHT_FRINGE (1, Qtop_bottom
, row
->ends_at_zv_p
)
1066 : RIGHT_FRINGE (2, Qtop
, 0));
1068 else if (row
->indicate_top_line_p
)
1070 if (EQ (arrow_top
, Qleft
))
1071 bn
= LEFT_FRINGE (6, Qup
, 0);
1073 bn
= RIGHT_FRINGE (6, Qup
, 0);
1076 if (bn
!= NO_FRINGE_BITMAP
)
1078 struct fringe_bitmap
*fb
= get_fringe_bitmap_data (bn
);
1080 if (fb
->align
== ALIGN_BITMAP_TOP
&& fb
->period
== 0)
1082 struct glyph_row
*row1
;
1085 top_ind_min_y
= WINDOW_HEADER_LINE_HEIGHT (w
);
1086 top_ind_max_y
= top_ind_min_y
+ fb
->height
;
1087 if (top_ind_max_y
> yb
)
1090 for (y
= row
->y
+ row
->height
, rn
= top_ind_rn
+ 1;
1091 y
< top_ind_max_y
&& rn
< nrows
;
1092 y
+= row1
->height
, rn
++)
1094 if (bot_ind_rn
>= 0 && rn
>= bot_ind_rn
)
1097 row1
= w
->desired_matrix
->rows
+ rn
;
1098 if (!row1
->enabled_p
)
1099 row1
= w
->current_matrix
->rows
+ rn
;
1101 row1
->indicate_bob_p
= row
->indicate_bob_p
;
1102 row1
->indicate_top_line_p
= row
->indicate_top_line_p
;
1107 if (bot_ind_rn
>= 0)
1109 int bn
= NO_FRINGE_BITMAP
;
1111 row
= w
->desired_matrix
->rows
+ bot_ind_rn
;
1112 if (!row
->enabled_p
)
1113 row
= w
->current_matrix
->rows
+ bot_ind_rn
;
1115 bot_row_ends_at_zv_p
= row
->ends_at_zv_p
;
1116 if (row
->indicate_eob_p
)
1118 if (EQ (boundary_bot
, Qleft
))
1119 bn
= LEFT_FRINGE (3, Qbottom
, row
->ends_at_zv_p
);
1121 bn
= RIGHT_FRINGE (3, Qbottom
, row
->ends_at_zv_p
);
1123 else if (row
->indicate_bottom_line_p
)
1125 if (EQ (arrow_bot
, Qleft
))
1126 bn
= LEFT_FRINGE (7, Qdown
, 0);
1128 bn
= RIGHT_FRINGE (7, Qdown
, 0);
1131 if (bn
!= NO_FRINGE_BITMAP
)
1133 struct fringe_bitmap
*fb
= get_fringe_bitmap_data (bn
);
1135 if (fb
->align
== ALIGN_BITMAP_BOTTOM
&& fb
->period
== 0)
1137 struct glyph_row
*row1
;
1140 bot_ind_max_y
= row
->y
+ row
->visible_height
;
1141 bot_ind_min_y
= bot_ind_max_y
- fb
->height
;
1142 if (bot_ind_min_y
< WINDOW_HEADER_LINE_HEIGHT (w
))
1143 bot_ind_min_y
= WINDOW_HEADER_LINE_HEIGHT (w
);
1145 for (y
= row
->y
, rn
= bot_ind_rn
- 1;
1146 y
>= bot_ind_min_y
&& rn
>= 0;
1147 y
-= row1
->height
, rn
--)
1149 if (top_ind_rn
>= 0 && rn
<= top_ind_rn
)
1152 row1
= w
->desired_matrix
->rows
+ rn
;
1153 if (!row1
->enabled_p
)
1154 row1
= w
->current_matrix
->rows
+ rn
;
1156 row1
->indicate_eob_p
= row
->indicate_eob_p
;
1157 row1
->indicate_bottom_line_p
= row
->indicate_bottom_line_p
;
1163 for (y
= w
->vscroll
, rn
= 0;
1164 y
< yb
&& rn
< nrows
;
1165 y
+= row
->height
, rn
++)
1168 unsigned left_face_id
, right_face_id
;
1169 int left_offset
, right_offset
;
1172 row
= w
->desired_matrix
->rows
+ rn
;
1173 cur
= w
->current_matrix
->rows
+ rn
;
1174 if (!row
->enabled_p
)
1177 left_face_id
= right_face_id
= DEFAULT_FACE_ID
;
1178 left_offset
= right_offset
= 0;
1181 /* Decide which bitmap to draw in the left fringe. */
1182 if (WINDOW_LEFT_FRINGE_WIDTH (w
) == 0)
1183 left
= NO_FRINGE_BITMAP
;
1184 else if (row
->left_user_fringe_bitmap
!= NO_FRINGE_BITMAP
)
1186 left
= row
->left_user_fringe_bitmap
;
1187 left_face_id
= row
->left_user_fringe_face_id
;
1189 else if ((!row
->reversed_p
&& row
->truncated_on_left_p
)
1190 || (row
->reversed_p
&& row
->truncated_on_right_p
))
1191 left
= LEFT_FRINGE (0, Qtruncation
, 0);
1192 else if (row
->indicate_bob_p
&& EQ (boundary_top
, Qleft
))
1194 left
= ((row
->indicate_eob_p
&& EQ (boundary_bot
, Qleft
))
1195 ? LEFT_FRINGE (1, Qtop_bottom
, top_row_ends_at_zv_p
)
1196 : LEFT_FRINGE (2, Qtop
, 0));
1197 if (top_ind_min_y
>= 0)
1198 left_offset
= top_ind_min_y
- row
->y
;
1200 else if (row
->indicate_eob_p
&& EQ (boundary_bot
, Qleft
))
1202 left
= LEFT_FRINGE (3, Qbottom
, bot_row_ends_at_zv_p
);
1203 if (bot_ind_max_y
>= 0)
1204 left_offset
= bot_ind_max_y
- (row
->y
+ row
->visible_height
);
1206 else if ((!row
->reversed_p
&& MATRIX_ROW_CONTINUATION_LINE_P (row
))
1207 || (row
->reversed_p
&& row
->continued_p
))
1208 left
= LEFT_FRINGE (4, Qcontinuation
, 0);
1209 else if (row
->indicate_empty_line_p
&& EQ (empty_pos
, Qleft
))
1210 left
= LEFT_FRINGE (5, Qempty_line
, 0);
1211 else if (row
->indicate_top_line_p
&& EQ (arrow_top
, Qleft
))
1213 left
= LEFT_FRINGE (6, Qup
, 0);
1214 if (top_ind_min_y
>= 0)
1215 left_offset
= top_ind_min_y
- row
->y
;
1217 else if (row
->indicate_bottom_line_p
&& EQ (arrow_bot
, Qleft
))
1219 left
= LEFT_FRINGE (7, Qdown
, 0);
1220 if (bot_ind_max_y
>= 0)
1221 left_offset
= bot_ind_max_y
- (row
->y
+ row
->visible_height
);
1224 left
= NO_FRINGE_BITMAP
;
1226 /* Decide which bitmap to draw in the right fringe. */
1227 if (WINDOW_RIGHT_FRINGE_WIDTH (w
) == 0)
1228 right
= NO_FRINGE_BITMAP
;
1229 else if (row
->right_user_fringe_bitmap
!= NO_FRINGE_BITMAP
)
1231 right
= row
->right_user_fringe_bitmap
;
1232 right_face_id
= row
->right_user_fringe_face_id
;
1234 else if ((!row
->reversed_p
&& row
->truncated_on_right_p
)
1235 || (row
->reversed_p
&& row
->truncated_on_left_p
))
1236 right
= RIGHT_FRINGE (0, Qtruncation
, 0);
1237 else if (row
->indicate_bob_p
&& EQ (boundary_top
, Qright
))
1239 right
= ((row
->indicate_eob_p
&& EQ (boundary_bot
, Qright
))
1240 ? RIGHT_FRINGE (1, Qtop_bottom
, top_row_ends_at_zv_p
)
1241 : RIGHT_FRINGE (2, Qtop
, 0));
1242 if (top_ind_min_y
>= 0)
1243 right_offset
= top_ind_min_y
- row
->y
;
1245 else if (row
->indicate_eob_p
&& EQ (boundary_bot
, Qright
))
1247 right
= RIGHT_FRINGE (3, Qbottom
, bot_row_ends_at_zv_p
);
1248 if (bot_ind_max_y
>= 0)
1249 right_offset
= bot_ind_max_y
- (row
->y
+ row
->visible_height
);
1251 else if ((!row
->reversed_p
&& row
->continued_p
)
1252 || (row
->reversed_p
&& MATRIX_ROW_CONTINUATION_LINE_P (row
)))
1253 right
= RIGHT_FRINGE (4, Qcontinuation
, 0);
1254 else if (row
->indicate_top_line_p
&& EQ (arrow_top
, Qright
))
1256 right
= RIGHT_FRINGE (6, Qup
, 0);
1257 if (top_ind_min_y
>= 0)
1258 right_offset
= top_ind_min_y
- row
->y
;
1260 else if (row
->indicate_bottom_line_p
&& EQ (arrow_bot
, Qright
))
1262 right
= RIGHT_FRINGE (7, Qdown
, 0);
1263 if (bot_ind_max_y
>= 0)
1264 right_offset
= bot_ind_max_y
- (row
->y
+ row
->visible_height
);
1266 else if (row
->indicate_empty_line_p
&& EQ (empty_pos
, Qright
))
1267 right
= RIGHT_FRINGE (5, Qempty_line
, 0);
1269 right
= NO_FRINGE_BITMAP
;
1271 periodic_p
= (get_fringe_bitmap_data (left
)->period
!= 0
1272 || get_fringe_bitmap_data (right
)->period
!= 0);
1274 if (row
->y
!= cur
->y
1275 || row
->visible_height
!= cur
->visible_height
1276 || row
->ends_at_zv_p
!= cur
->ends_at_zv_p
1277 || left
!= cur
->left_fringe_bitmap
1278 || right
!= cur
->right_fringe_bitmap
1279 || left_face_id
!= cur
->left_fringe_face_id
1280 || right_face_id
!= cur
->right_fringe_face_id
1281 || left_offset
!= cur
->left_fringe_offset
1282 || right_offset
!= cur
->right_fringe_offset
1283 || periodic_p
!= cur
->fringe_bitmap_periodic_p
1284 || cur
->redraw_fringe_bitmaps_p
)
1286 redraw_p
= 1, row
->redraw_fringe_bitmaps_p
= 1;
1287 if (!keep_current_p
)
1289 cur
->redraw_fringe_bitmaps_p
= 1;
1290 cur
->left_fringe_bitmap
= left
;
1291 cur
->right_fringe_bitmap
= right
;
1292 cur
->left_fringe_face_id
= left_face_id
;
1293 cur
->right_fringe_face_id
= right_face_id
;
1294 cur
->left_fringe_offset
= left_offset
;
1295 cur
->right_fringe_offset
= right_offset
;
1296 cur
->fringe_bitmap_periodic_p
= periodic_p
;
1300 if (row
->overlay_arrow_bitmap
< 0)
1301 row
->overlay_arrow_bitmap
= get_logical_fringe_bitmap (w
, Qoverlay_arrow
, 0, 0);
1303 if (row
->overlay_arrow_bitmap
!= cur
->overlay_arrow_bitmap
)
1305 redraw_p
= 1, row
->redraw_fringe_bitmaps_p
= 1;
1306 if (!keep_current_p
)
1308 cur
->redraw_fringe_bitmaps_p
= 1;
1309 cur
->overlay_arrow_bitmap
= row
->overlay_arrow_bitmap
;
1313 row
->left_fringe_bitmap
= left
;
1314 row
->right_fringe_bitmap
= right
;
1315 row
->left_fringe_face_id
= left_face_id
;
1316 row
->right_fringe_face_id
= right_face_id
;
1317 row
->left_fringe_offset
= left_offset
;
1318 row
->right_fringe_offset
= right_offset
;
1319 row
->fringe_bitmap_periodic_p
= periodic_p
;
1322 return redraw_p
&& !keep_current_p
;
1327 /* Free resources used by a user-defined bitmap. */
1330 destroy_fringe_bitmap (int n
)
1332 struct fringe_bitmap
**fbp
;
1334 fringe_faces
[n
] = Qnil
;
1336 fbp
= &fringe_bitmaps
[n
];
1337 if (*fbp
&& (*fbp
)->dynamic
)
1339 /* XXX Is SELECTED_FRAME OK here? */
1340 struct redisplay_interface
*rif
= FRAME_RIF (SELECTED_FRAME ());
1341 if (rif
&& rif
->destroy_fringe_bitmap
)
1342 rif
->destroy_fringe_bitmap (n
);
1347 while (max_used_fringe_bitmap
> MAX_STANDARD_FRINGE_BITMAPS
1348 && fringe_bitmaps
[max_used_fringe_bitmap
- 1] == NULL
)
1349 max_used_fringe_bitmap
--;
1353 DEFUN ("destroy-fringe-bitmap", Fdestroy_fringe_bitmap
, Sdestroy_fringe_bitmap
,
1355 doc
: /* Destroy fringe bitmap BITMAP.
1356 If BITMAP overrides a standard fringe bitmap, the original bitmap is restored. */)
1357 (Lisp_Object bitmap
)
1361 CHECK_SYMBOL (bitmap
);
1362 n
= lookup_fringe_bitmap (bitmap
);
1366 destroy_fringe_bitmap (n
);
1368 if (n
>= MAX_STANDARD_FRINGE_BITMAPS
)
1370 Vfringe_bitmaps
= Fdelq (bitmap
, Vfringe_bitmaps
);
1371 /* It would be better to remove the fringe property. */
1372 Fput (bitmap
, Qfringe
, Qnil
);
1379 /* Initialize bitmap bit.
1381 On X, we bit-swap the built-in bitmaps and reduce bitmap
1382 from short to char array if width is <= 8 bits.
1384 On MAC with big-endian CPU, we need to byte-swap each short.
1386 On W32 and MAC (little endian), there's no need to do this.
1389 #if defined (HAVE_X_WINDOWS)
1390 static const unsigned char swap_nibble
[16] = {
1391 0x0, 0x8, 0x4, 0xc, /* 0000 1000 0100 1100 */
1392 0x2, 0xa, 0x6, 0xe, /* 0010 1010 0110 1110 */
1393 0x1, 0x9, 0x5, 0xd, /* 0001 1001 0101 1101 */
1394 0x3, 0xb, 0x7, 0xf}; /* 0011 1011 0111 1111 */
1395 #endif /* HAVE_X_WINDOWS */
1398 init_fringe_bitmap (int which
, struct fringe_bitmap
*fb
, int once_p
)
1400 if (once_p
|| fb
->dynamic
)
1402 #if defined (HAVE_X_WINDOWS)
1403 unsigned short *bits
= fb
->bits
;
1407 for (j
= 0; j
< fb
->height
; j
++)
1409 unsigned short b
= *bits
;
1410 #ifdef WORDS_BIGENDIAN
1411 *bits
++ = (b
<< (16 - fb
->width
));
1413 b
= (unsigned short)((swap_nibble
[b
& 0xf] << 12)
1414 | (swap_nibble
[(b
>>4) & 0xf] << 8)
1415 | (swap_nibble
[(b
>>8) & 0xf] << 4)
1416 | (swap_nibble
[(b
>>12) & 0xf]));
1417 *bits
++ = (b
>> (16 - fb
->width
));
1420 #else /* not USE_CAIRO */
1423 unsigned char *cbits
= (unsigned char *)fb
->bits
;
1424 for (j
= 0; j
< fb
->height
; j
++)
1426 unsigned short b
= *bits
++;
1428 c
= (unsigned char)((swap_nibble
[b
& 0xf] << 4)
1429 | (swap_nibble
[(b
>>4) & 0xf]));
1430 *cbits
++ = (c
>> (8 - fb
->width
));
1435 for (j
= 0; j
< fb
->height
; j
++)
1437 unsigned short b
= *bits
;
1438 b
= (unsigned short)((swap_nibble
[b
& 0xf] << 12)
1439 | (swap_nibble
[(b
>>4) & 0xf] << 8)
1440 | (swap_nibble
[(b
>>8) & 0xf] << 4)
1441 | (swap_nibble
[(b
>>12) & 0xf]));
1442 b
>>= (16 - fb
->width
);
1443 #ifdef WORDS_BIGENDIAN
1449 #endif /* not USE_CAIRO */
1450 #endif /* HAVE_X_WINDOWS */
1453 unsigned short *bits
= fb
->bits
;
1455 for (j
= 0; j
< fb
->height
; j
++)
1457 unsigned short b
= *bits
;
1458 b
<<= (16 - fb
->width
);
1459 /* Windows is little-endian, so the next line is always
1461 b
= ((b
>> 8) | (b
<< 8));
1469 /* XXX Is SELECTED_FRAME OK here? */
1470 struct redisplay_interface
*rif
= FRAME_RIF (SELECTED_FRAME ());
1472 destroy_fringe_bitmap (which
);
1474 if (rif
&& rif
->define_fringe_bitmap
)
1475 rif
->define_fringe_bitmap (which
, fb
->bits
, fb
->height
, fb
->width
);
1477 fringe_bitmaps
[which
] = fb
;
1478 if (which
>= max_used_fringe_bitmap
)
1479 max_used_fringe_bitmap
= which
+ 1;
1484 DEFUN ("define-fringe-bitmap", Fdefine_fringe_bitmap
, Sdefine_fringe_bitmap
,
1486 doc
: /* Define fringe bitmap BITMAP from BITS of size HEIGHT x WIDTH.
1487 BITMAP is a symbol identifying the new fringe bitmap.
1488 BITS is either a string or a vector of integers.
1489 HEIGHT is height of bitmap. If HEIGHT is nil, use length of BITS.
1490 WIDTH must be an integer between 1 and 16, or nil which defaults to 8.
1491 Optional fifth arg ALIGN may be one of `top', `center', or `bottom',
1492 indicating the positioning of the bitmap relative to the rows where it
1493 is used; the default is to center the bitmap. Fifth arg may also be a
1494 list (ALIGN PERIODIC) where PERIODIC non-nil specifies that the bitmap
1496 If BITMAP already exists, the existing definition is replaced. */)
1497 (Lisp_Object bitmap
, Lisp_Object bits
, Lisp_Object height
, Lisp_Object width
, Lisp_Object align
)
1501 struct fringe_bitmap fb
, *xfb
;
1502 int fill1
= 0, fill2
= 0;
1504 CHECK_SYMBOL (bitmap
);
1505 h
= CHECK_VECTOR_OR_STRING (bits
);
1511 CHECK_NUMBER (height
);
1512 fb
.height
= max (0, min (XINT (height
), 255));
1515 fill1
= (fb
.height
- h
) / 2;
1516 fill2
= fb
.height
- h
- fill1
;
1524 CHECK_NUMBER (width
);
1525 fb
.width
= max (0, min (XINT (width
), 255));
1529 fb
.align
= ALIGN_BITMAP_CENTER
;
1533 Lisp_Object period
= XCDR (align
);
1536 period
= XCAR (period
);
1539 fb
.period
= fb
.height
;
1543 align
= XCAR (align
);
1545 if (EQ (align
, Qtop
))
1546 fb
.align
= ALIGN_BITMAP_TOP
;
1547 else if (EQ (align
, Qbottom
))
1548 fb
.align
= ALIGN_BITMAP_BOTTOM
;
1549 else if (!NILP (align
) && !EQ (align
, Qcenter
))
1550 error ("Bad align argument");
1552 n
= lookup_fringe_bitmap (bitmap
);
1555 if (max_used_fringe_bitmap
< max_fringe_bitmaps
)
1556 n
= max_used_fringe_bitmap
++;
1559 for (n
= MAX_STANDARD_FRINGE_BITMAPS
;
1560 n
< max_fringe_bitmaps
;
1562 if (fringe_bitmaps
[n
] == NULL
)
1565 if (n
== max_fringe_bitmaps
)
1567 int bitmaps
= max_fringe_bitmaps
+ 20;
1568 if (MAX_FRINGE_BITMAPS
< bitmaps
)
1569 error ("No free fringe bitmap slots");
1571 i
= max_fringe_bitmaps
;
1572 fringe_bitmaps
= xrealloc (fringe_bitmaps
,
1573 bitmaps
* sizeof *fringe_bitmaps
);
1574 fringe_faces
= xrealloc (fringe_faces
,
1575 bitmaps
* sizeof *fringe_faces
);
1577 for (i
= max_fringe_bitmaps
; i
< bitmaps
; i
++)
1579 fringe_bitmaps
[i
] = NULL
;
1580 fringe_faces
[i
] = Qnil
;
1583 max_fringe_bitmaps
= bitmaps
;
1587 Vfringe_bitmaps
= Fcons (bitmap
, Vfringe_bitmaps
);
1588 Fput (bitmap
, Qfringe
, make_number (n
));
1593 xfb
= xmalloc (sizeof fb
+ fb
.height
* BYTES_PER_BITMAP_ROW
);
1594 fb
.bits
= b
= (unsigned short *) (xfb
+ 1);
1595 memset (b
, 0, fb
.height
);
1598 while (j
< fb
.height
)
1600 for (i
= 0; i
< fill1
&& j
< fb
.height
; i
++)
1602 for (i
= 0; i
< h
&& j
< fb
.height
; i
++)
1604 Lisp_Object elt
= Faref (bits
, make_number (i
));
1605 b
[j
++] = NUMBERP (elt
) ? XINT (elt
) : 0;
1607 for (i
= 0; i
< fill2
&& j
< fb
.height
; i
++)
1613 init_fringe_bitmap (n
, xfb
, 0);
1618 DEFUN ("set-fringe-bitmap-face", Fset_fringe_bitmap_face
, Sset_fringe_bitmap_face
,
1620 doc
: /* Set face for fringe bitmap BITMAP to FACE.
1621 FACE is merged with the `fringe' face, so normally FACE should specify
1622 only the foreground color.
1623 If FACE is nil, reset face to default fringe face. */)
1624 (Lisp_Object bitmap
, Lisp_Object face
)
1628 CHECK_SYMBOL (bitmap
);
1629 n
= lookup_fringe_bitmap (bitmap
);
1631 error ("Undefined fringe bitmap");
1633 /* The purpose of the following code is to signal an error if FACE
1634 is not a face. This is for the caller's convenience only; the
1635 redisplay code should be able to fail gracefully. Skip the check
1636 if FRINGE_FACE_ID is unrealized (as in batch mode and during
1640 struct frame
*f
= SELECTED_FRAME ();
1642 if (FACE_FROM_ID_OR_NULL (f
, FRINGE_FACE_ID
)
1643 && lookup_derived_face (f
, face
, FRINGE_FACE_ID
, 1) < 0)
1644 error ("No such face");
1647 fringe_faces
[n
] = face
;
1651 DEFUN ("fringe-bitmaps-at-pos", Ffringe_bitmaps_at_pos
, Sfringe_bitmaps_at_pos
,
1653 doc
: /* Return fringe bitmaps of row containing position POS in window WINDOW.
1654 If WINDOW is nil, use selected window. If POS is nil, use value of point
1655 in that window. Return value is a list (LEFT RIGHT OV), where LEFT
1656 is the symbol for the bitmap in the left fringe (or nil if no bitmap),
1657 RIGHT is similar for the right fringe, and OV is non-nil if there is an
1658 overlay arrow in the left fringe.
1659 Return nil if POS is not visible in WINDOW. */)
1660 (Lisp_Object pos
, Lisp_Object window
)
1663 struct glyph_row
*row
;
1666 w
= decode_any_window (window
);
1667 XSETWINDOW (window
, w
);
1671 CHECK_NUMBER_COERCE_MARKER (pos
);
1672 if (! (BEGV
<= XINT (pos
) && XINT (pos
) <= ZV
))
1673 args_out_of_range (window
, pos
);
1674 textpos
= XINT (pos
);
1676 else if (w
== XWINDOW (selected_window
))
1679 textpos
= marker_position (w
->pointm
);
1681 row
= MATRIX_FIRST_TEXT_ROW (w
->current_matrix
);
1682 row
= row_containing_pos (w
, textpos
, row
, NULL
, 0);
1684 return list3 (get_fringe_bitmap_name (row
->left_fringe_bitmap
),
1685 get_fringe_bitmap_name (row
->right_fringe_bitmap
),
1686 (row
->overlay_arrow_bitmap
== 0 ? Qnil
1687 : row
->overlay_arrow_bitmap
< 0 ? Qt
1688 : get_fringe_bitmap_name (row
->overlay_arrow_bitmap
)));
1694 /***********************************************************************
1696 ***********************************************************************/
1699 syms_of_fringe (void)
1701 DEFSYM (Qtruncation
, "truncation");
1702 DEFSYM (Qcontinuation
, "continuation");
1703 DEFSYM (Qoverlay_arrow
, "overlay-arrow");
1704 DEFSYM (Qempty_line
, "empty-line");
1705 DEFSYM (Qtop_bottom
, "top-bottom");
1706 DEFSYM (Qhollow_small
, "hollow-small");
1708 defsubr (&Sdestroy_fringe_bitmap
);
1709 defsubr (&Sdefine_fringe_bitmap
);
1710 defsubr (&Sfringe_bitmaps_at_pos
);
1711 defsubr (&Sset_fringe_bitmap_face
);
1713 DEFVAR_LISP ("overflow-newline-into-fringe", Voverflow_newline_into_fringe
,
1714 doc
: /* Non-nil means that newline may flow into the right fringe.
1715 This means that display lines which are exactly as wide as the window
1716 \(not counting the final newline) will only occupy one screen line, by
1717 showing (or hiding) the final newline in the right fringe; when point
1718 is at the final newline, the cursor is shown in the right fringe.
1719 If nil, also continue lines which are exactly as wide as the window. */);
1720 Voverflow_newline_into_fringe
= Qt
;
1722 DEFVAR_LISP ("fringe-bitmaps", Vfringe_bitmaps
,
1723 doc
: /* List of fringe bitmap symbols. */);
1724 Vfringe_bitmaps
= Qnil
;
1727 /* Garbage collection hook */
1730 mark_fringe_data (void)
1734 for (i
= 0; i
< max_fringe_bitmaps
; i
++)
1735 if (!NILP (fringe_faces
[i
]))
1736 mark_object (fringe_faces
[i
]);
1739 /* Initialize this module when Emacs starts. */
1742 init_fringe_once (void)
1746 for (bt
= NO_FRINGE_BITMAP
+ 1; bt
< MAX_STANDARD_FRINGE_BITMAPS
; bt
++)
1747 init_fringe_bitmap (bt
, &standard_bitmaps
[bt
], 1);
1753 max_fringe_bitmaps
= MAX_STANDARD_FRINGE_BITMAPS
+ 20;
1755 fringe_bitmaps
= xzalloc (max_fringe_bitmaps
* sizeof *fringe_bitmaps
);
1757 verify (NIL_IS_ZERO
);
1758 fringe_faces
= xzalloc (max_fringe_bitmaps
* sizeof *fringe_faces
);
1761 #if defined (HAVE_NTGUI) || defined (USE_CAIRO)
1765 w32_init_fringe (struct redisplay_interface
*rif
)
1767 x_cr_init_fringe (struct redisplay_interface
*rif
)
1775 for (bt
= NO_FRINGE_BITMAP
+ 1; bt
< MAX_STANDARD_FRINGE_BITMAPS
; bt
++)
1777 struct fringe_bitmap
*fb
= &standard_bitmaps
[bt
];
1778 rif
->define_fringe_bitmap (bt
, fb
->bits
, fb
->height
, fb
->width
);
1785 w32_reset_fringes (void)
1787 /* Destroy row bitmaps. */
1789 struct redisplay_interface
*rif
= FRAME_RIF (SELECTED_FRAME ());
1794 for (bt
= NO_FRINGE_BITMAP
+ 1; bt
< max_used_fringe_bitmap
; bt
++)
1795 rif
->destroy_fringe_bitmap (bt
);
1798 #endif /* HAVE_NTGUI */