1 /* Fringe handling (split from xdisp.c).
2 Copyright (C) 1985-1988, 1993-1995, 1997-2013 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
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/>. */
26 #include "dispextern.h"
27 #include "character.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,
90 /***********************************************************************
92 ***********************************************************************/
94 /* Undefined bitmap. A question mark. */
107 static unsigned short question_mark_bits
[] = {
108 0x3c, 0x7e, 0x7e, 0x0c, 0x18, 0x18, 0x00, 0x18, 0x18};
110 /* An exclamation mark. */
123 static unsigned short exclamation_mark_bits
[] = {
124 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x18, 0x00, 0x18};
126 /* An arrow like this: `<-'. */
137 static unsigned short left_arrow_bits
[] = {
138 0x18, 0x30, 0x60, 0xfc, 0xfc, 0x60, 0x30, 0x18};
141 /* Right truncation arrow bitmap `->'. */
152 static unsigned short right_arrow_bits
[] = {
153 0x18, 0x0c, 0x06, 0x3f, 0x3f, 0x06, 0x0c, 0x18};
156 /* Up arrow bitmap. */
167 static unsigned short up_arrow_bits
[] = {
168 0x18, 0x3c, 0x7e, 0xff, 0x18, 0x18, 0x18, 0x18};
171 /* Down arrow bitmap. */
182 static unsigned short down_arrow_bits
[] = {
183 0x18, 0x18, 0x18, 0x18, 0xff, 0x7e, 0x3c, 0x18};
185 /* Marker for continuation lines. */
196 static unsigned short left_curly_arrow_bits
[] = {
197 0x3c, 0x7c, 0xc0, 0xe4, 0xfc, 0x7c, 0x3c, 0x7c};
199 /* Marker for continued lines. */
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. */
224 static unsigned short left_triangle_bits
[] = {
225 0x03, 0x0f, 0x1f, 0x3f, 0x3f, 0x1f, 0x0f, 0x03};
227 /* Overlay arrow bitmap. A triangular arrow. */
238 static unsigned short right_triangle_bits
[] = {
239 0xc0, 0xf0, 0xf8, 0xfc, 0xfc, 0xf8, 0xf0, 0xc0};
241 /* First line bitmap. An top-left angle. */
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. */
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. */
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. */
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. */
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. */
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. */
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. */
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. */
376 static unsigned short hollow_square_bits
[] = {
377 0x7e, 0x42, 0x42, 0x42, 0x42, 0x7e};
379 /* Filled square bitmap. */
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. */
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. */
415 static unsigned short horizontal_bar_bits
[] = {
419 /* Bitmap drawn to indicate lines not displaying text if
420 `indicate-empty-lines' is non-nil. */
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
;
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
)
497 bitmap
= Fget (bitmap
, Qfringe
);
498 if (!INTEGERP (bitmap
))
502 if (bn
> NO_FRINGE_BITMAP
503 && bn
< max_used_fringe_bitmap
504 && (bn
< MAX_STANDARD_FRINGE_BITMAPS
505 || fringe_bitmaps
[bn
] != NULL
))
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. */
519 get_fringe_bitmap_name (int bn
)
524 /* Zero means no bitmap -- return nil. */
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
)))
536 bitmaps
= XCDR (bitmaps
);
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
];
551 fb
= &standard_bitmaps
[bn
< MAX_STANDARD_FRINGE_BITMAPS
552 ? bn
: UNDEF_FRINGE_BITMAP
];
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
561 LEFT_P is 1 for left fringe, 0 for right fringe.
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
;
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
)
583 which
= row
->left_fringe_bitmap
;
584 face_id
= row
->left_fringe_face_id
;
585 offset
= row
->left_fringe_offset
;
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);
600 face_id
= FRINGE_FACE_ID
;
603 fb
= get_fringe_bitmap_data (which
);
607 /* Convert row to frame coordinates. */
608 p
.y
= WINDOW_TO_FRAME_PIXEL_Y (w
, row
->y
) + offset
;
615 p
.dh
= (period
> 0 ? (p
.y
% period
) : 0);
618 /* Adjust y to the offset in the row to start drawing the bitmap. */
621 case ALIGN_BITMAP_CENTER
:
622 p
.y
+= (row
->height
- p
.h
) / 2;
624 case ALIGN_BITMAP_BOTTOM
:
625 p
.y
+= (row
->visible_height
- p
.h
);
627 case ALIGN_BITMAP_TOP
:
631 p
.face
= FACE_FROM_ID (f
, face_id
);
635 /* This could happen after clearing face cache.
636 But it shouldn't happen anymore. ++kfs */
640 PREPARE_FACE_FOR_DISPLAY (f
, p
.face
);
642 /* Clear left fringe if no bitmap to draw or if bitmap doesn't fill
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
;
650 int wd
= WINDOW_LEFT_FRINGE_WIDTH (w
);
651 int x
= window_box_left (w
, (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w
)
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
))
677 int x
= window_box_right (w
,
678 (WINDOW_HAS_FRINGES_OUTSIDE_MARGINS (w
)
681 int wd
= WINDOW_RIGHT_FRINGE_WIDTH (w
);
684 p
.x
= x
+ (wd
- p
.wd
) / 2;
685 /* Clear right fringe if no bitmap to draw of if bitmap doesn't fill
687 if (p
.wd
< wd
|| p
.y
> p
.by
|| p
.y
+ p
.h
< p
.by
+ p
.ny
)
694 FRAME_RIF (f
)->draw_fringe_bitmap (w
, row
, &p
);
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
);
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
);
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;
726 int ix2
= ix1
+ (partial_p
? 2 : 0);
728 /* Lookup in buffer-local fringe-indicator-alist before global alist.
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
);
744 if ((bm1
= XCDR (bm1
)), NILP (bm1
))
745 return NO_FRINGE_BITMAP
;
748 ln1
= XINT (Flength (bm1
));
753 bm
= Fnth (make_number (ix2
), bm1
);
762 bm
= Fnth (make_number (ix1
), bm1
);
768 else if ((bm
= bm1
, !EQ (bm
, Qt
)))
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
));
779 if ((bm2
= XCDR (bm2
)), !NILP (bm2
))
783 ln2
= XINT (Flength (bm2
));
788 bm
= Fnth (make_number (ix2
), bm2
);
800 bm
= Fnth (make_number (ix1
), bm1
);
807 bm
= Fnth (make_number (ix1
), bm2
);
810 return NO_FRINGE_BITMAP
;
812 else if ((bm
= bm2
, NILP (bm
)))
813 return NO_FRINGE_BITMAP
;
816 return lookup_fringe_bitmap (bm
);
821 draw_fringe_bitmap (struct window
*w
, struct glyph_row
*row
, int left_p
)
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
))
835 cursor
= Qhollow_small
;
837 case FILLED_BOX_CURSOR
:
848 w
->phys_cursor_on_p
= 0;
849 row
->cursor_in_fringe_p
= 0;
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. */
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)
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
;
910 if (w
->pseudo_window_p
)
913 /* Must draw line if no fringe */
915 && (WINDOW_LEFT_FRINGE_WIDTH (w
) == 0
916 || WINDOW_RIGHT_FRINGE_WIDTH (w
) == 0))
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
)
925 draw_row_fringe_bitmaps (w
, row
);
926 row
->redraw_fringe_bitmaps_p
= 0;
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
;
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
)
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
)))
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
);
985 /* Anything else means boundary on left and no arrows. */
986 boundary_top
= boundary_bot
= Qleft
;
989 top_ind_rn
= bot_ind_rn
= -1;
992 for (y
= w
->vscroll
, rn
= 0;
993 y
< yb
&& rn
< nrows
;
994 y
+= row
->height
, ++rn
)
996 row
= w
->desired_matrix
->rows
+ rn
;
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
);
1011 row
->indicate_top_line_p
= !NILP (arrow_top
);
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));
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);
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
;
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
)
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
)
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
);
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);
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
;
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
)
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
++)
1170 unsigned left_face_id
, right_face_id
;
1171 int left_offset
, right_offset
;
1174 row
= w
->desired_matrix
->rows
+ rn
;
1175 cur
= w
->current_matrix
->rows
+ rn
;
1176 if (!row
->enabled_p
)
1179 left_face_id
= right_face_id
= DEFAULT_FACE_ID
;
1180 left_offset
= right_offset
= 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
);
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);
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.
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
;
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;
1401 FRAME_LEFT_FRINGE_WIDTH (f
) = 0;
1402 FRAME_RIGHT_FRINGE_WIDTH (f
) = real_wid
;
1404 FRAME_FRINGE_COLS (f
) = cols
;
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
))
1421 /* Free resources used by a user-defined bitmap. */
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
);
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
,
1449 doc
: /* Destroy fringe bitmap BITMAP.
1450 If BITMAP overrides a standard fringe bitmap, the original bitmap is restored. */)
1451 (Lisp_Object bitmap
)
1455 CHECK_SYMBOL (bitmap
);
1456 n
= lookup_fringe_bitmap (bitmap
);
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
);
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 */
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
;
1502 unsigned char *cbits
= (unsigned char *)fb
->bits
;
1503 for (j
= 0; j
< fb
->height
; j
++)
1505 unsigned short b
= *bits
++;
1507 c
= (unsigned char)((swap_nibble
[b
& 0xf] << 4)
1508 | (swap_nibble
[(b
>>4) & 0xf]));
1509 *cbits
++ = (c
>> (8 - fb
->width
));
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));
1528 #endif /* HAVE_X_WINDOWS */
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
,
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
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
)
1566 struct fringe_bitmap fb
, *xfb
;
1567 int fill1
= 0, fill2
= 0;
1569 CHECK_SYMBOL (bitmap
);
1573 else if (VECTORP (bits
))
1576 wrong_type_argument (Qsequencep
, bits
);
1582 CHECK_NUMBER (height
);
1583 fb
.height
= max (0, min (XINT (height
), 255));
1586 fill1
= (fb
.height
- h
) / 2;
1587 fill2
= fb
.height
- h
- fill1
;
1595 CHECK_NUMBER (width
);
1596 fb
.width
= max (0, min (XINT (width
), 255));
1600 fb
.align
= ALIGN_BITMAP_CENTER
;
1604 Lisp_Object period
= XCDR (align
);
1607 period
= XCAR (period
);
1610 fb
.period
= fb
.height
;
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
);
1626 if (max_used_fringe_bitmap
< max_fringe_bitmaps
)
1627 n
= max_used_fringe_bitmap
++;
1630 for (n
= MAX_STANDARD_FRINGE_BITMAPS
;
1631 n
< max_fringe_bitmaps
;
1633 if (fringe_bitmaps
[n
] == NULL
)
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
));
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
);
1669 while (j
< fb
.height
)
1671 for (i
= 0; i
< fill1
&& j
< fb
.height
; i
++)
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
++)
1684 init_fringe_bitmap (n
, xfb
, 0);
1689 DEFUN ("set-fringe-bitmap-face", Fset_fringe_bitmap_face
, Sset_fringe_bitmap_face
,
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
)
1697 CHECK_SYMBOL (bitmap
);
1698 n
= lookup_fringe_bitmap (bitmap
);
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
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
;
1720 DEFUN ("fringe-bitmaps-at-pos", Ffringe_bitmaps_at_pos
, Sfringe_bitmaps_at_pos
,
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
)
1732 struct glyph_row
*row
;
1735 w
= decode_any_window (window
);
1736 XSETWINDOW (window
, w
);
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
))
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);
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
)));
1763 /***********************************************************************
1765 ***********************************************************************/
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 */
1799 mark_fringe_data (void)
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. */
1811 init_fringe_once (void)
1815 for (bt
= NO_FRINGE_BITMAP
+ 1; bt
< MAX_STANDARD_FRINGE_BITMAPS
; bt
++)
1816 init_fringe_bitmap (bt
, &standard_bitmaps
[bt
], 1);
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
;
1836 w32_init_fringe (struct redisplay_interface
*rif
)
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
);
1851 w32_reset_fringes (void)
1853 /* Destroy row bitmaps. */
1855 struct redisplay_interface
*rif
= FRAME_RIF (SELECTED_FRAME ());
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 */