1 /* Terminal control module for terminals described by TERMCAP
2 Copyright (C) 1985-1987, 1993-1995, 1998, 2000-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/>. */
20 /* New redisplay, TTY faces by Gerd Moellmann <gerd@gnu.org>. */
33 #include "character.h"
37 #include "composite.h"
41 #include "termhooks.h"
42 #include "dispextern.h"
45 #include "blockinput.h"
46 #include "syssignal.h"
48 #include "intervals.h"
51 static int been_here
= -1;
61 /* The name of the default console device. */
63 #define DEV_TTY "CONOUT$"
66 #define DEV_TTY "/dev/tty"
69 static void tty_set_scroll_region (struct frame
*f
, int start
, int stop
);
70 static void turn_on_face (struct frame
*, int face_id
);
71 static void turn_off_face (struct frame
*, int face_id
);
72 static void tty_turn_off_highlight (struct tty_display_info
*);
73 static void tty_show_cursor (struct tty_display_info
*);
74 static void tty_hide_cursor (struct tty_display_info
*);
75 static void tty_background_highlight (struct tty_display_info
*tty
);
76 static struct terminal
*get_tty_terminal (Lisp_Object
, bool);
77 static void clear_tty_hooks (struct terminal
*terminal
);
78 static void set_tty_hooks (struct terminal
*terminal
);
79 static void dissociate_if_controlling_tty (int fd
);
80 static void delete_tty (struct terminal
*);
81 static _Noreturn
void maybe_fatal (bool, struct terminal
*,
82 const char *, const char *, ...)
83 ATTRIBUTE_FORMAT_PRINTF (3, 5) ATTRIBUTE_FORMAT_PRINTF (4, 5);
84 static _Noreturn
void vfatal (const char *str
, va_list ap
)
85 ATTRIBUTE_FORMAT_PRINTF (1, 0);
88 #define OUTPUT(tty, a) \
89 emacs_tputs ((tty), a, \
90 FRAME_LINES (XFRAME (selected_frame)) - curY (tty), \
93 #define OUTPUT1(tty, a) emacs_tputs ((tty), a, 1, cmputc)
94 #define OUTPUTL(tty, a, lines) emacs_tputs ((tty), a, lines, cmputc)
96 #define OUTPUT_IF(tty, a) \
102 #define OUTPUT1_IF(tty, a) do { if (a) emacs_tputs ((tty), a, 1, cmputc); } while (0)
104 /* Display space properties */
106 /* Chain of all tty device parameters. */
107 struct tty_display_info
*tty_list
;
109 /* Meaning of bits in no_color_video. Each bit set means that the
110 corresponding attribute cannot be combined with colors. */
114 NC_STANDOUT
= 1 << 0,
115 NC_UNDERLINE
= 1 << 1,
126 /* The largest frame width in any call to calculate_costs. */
128 static int max_frame_cols
;
133 #include <sys/fcntl.h>
135 /* The device for which we have enabled gpm support (or NULL). */
136 struct tty_display_info
*gpm_tty
= NULL
;
138 /* Last recorded mouse coordinates. */
139 static int last_mouse_x
, last_mouse_y
;
140 #endif /* HAVE_GPM */
142 /* Ring the bell on a tty. */
145 tty_ring_bell (struct frame
*f
)
147 struct tty_display_info
*tty
= FRAME_TTY (f
);
151 OUTPUT (tty
, (tty
->TS_visible_bell
&& visible_bell
152 ? tty
->TS_visible_bell
154 fflush (tty
->output
);
158 /* Set up termcap modes for Emacs. */
161 tty_set_terminal_modes (struct terminal
*terminal
)
163 struct tty_display_info
*tty
= terminal
->display_info
.tty
;
167 if (tty
->TS_termcap_modes
)
168 OUTPUT (tty
, tty
->TS_termcap_modes
);
171 /* Output enough newlines to scroll all the old screen contents
172 off the screen, so it won't be overwritten and lost. */
175 for (i
= 0; i
< FRAME_LINES (XFRAME (selected_frame
)); i
++)
179 OUTPUT_IF (tty
, visible_cursor
? tty
->TS_cursor_visible
: tty
->TS_cursor_normal
);
180 OUTPUT_IF (tty
, tty
->TS_keypad_mode
);
182 fflush (tty
->output
);
186 /* Reset termcap modes before exiting Emacs. */
189 tty_reset_terminal_modes (struct terminal
*terminal
)
191 struct tty_display_info
*tty
= terminal
->display_info
.tty
;
195 tty_turn_off_highlight (tty
);
196 tty_turn_off_insert (tty
);
197 OUTPUT_IF (tty
, tty
->TS_end_keypad_mode
);
198 OUTPUT_IF (tty
, tty
->TS_cursor_normal
);
199 OUTPUT_IF (tty
, tty
->TS_end_termcap_modes
);
200 OUTPUT_IF (tty
, tty
->TS_orig_pair
);
201 /* Output raw CR so kernel can track the cursor hpos. */
204 fflush (tty
->output
);
208 /* Flag the end of a display update on a termcap terminal. */
211 tty_update_end (struct frame
*f
)
213 struct tty_display_info
*tty
= FRAME_TTY (f
);
215 if (!XWINDOW (selected_window
)->cursor_off_p
)
216 tty_show_cursor (tty
);
217 tty_turn_off_insert (tty
);
218 tty_background_highlight (tty
);
221 /* The implementation of set_terminal_window for termcap frames. */
224 tty_set_terminal_window (struct frame
*f
, int size
)
226 struct tty_display_info
*tty
= FRAME_TTY (f
);
228 tty
->specified_window
= size
? size
: FRAME_LINES (f
);
229 if (FRAME_SCROLL_REGION_OK (f
))
230 tty_set_scroll_region (f
, 0, tty
->specified_window
);
234 tty_set_scroll_region (struct frame
*f
, int start
, int stop
)
237 struct tty_display_info
*tty
= FRAME_TTY (f
);
239 if (tty
->TS_set_scroll_region
)
240 buf
= tparam (tty
->TS_set_scroll_region
, 0, 0, start
, stop
- 1, 0, 0);
241 else if (tty
->TS_set_scroll_region_1
)
242 buf
= tparam (tty
->TS_set_scroll_region_1
, 0, 0,
243 FRAME_LINES (f
), start
,
244 FRAME_LINES (f
) - stop
,
247 buf
= tparam (tty
->TS_set_window
, 0, 0, start
, 0, stop
, FRAME_COLS (f
));
256 tty_turn_on_insert (struct tty_display_info
*tty
)
258 if (!tty
->insert_mode
)
259 OUTPUT (tty
, tty
->TS_insert_mode
);
260 tty
->insert_mode
= 1;
264 tty_turn_off_insert (struct tty_display_info
*tty
)
266 if (tty
->insert_mode
)
267 OUTPUT (tty
, tty
->TS_end_insert_mode
);
268 tty
->insert_mode
= 0;
271 /* Handle highlighting. */
274 tty_turn_off_highlight (struct tty_display_info
*tty
)
276 if (tty
->standout_mode
)
277 OUTPUT_IF (tty
, tty
->TS_end_standout_mode
);
278 tty
->standout_mode
= 0;
282 tty_turn_on_highlight (struct tty_display_info
*tty
)
284 if (!tty
->standout_mode
)
285 OUTPUT_IF (tty
, tty
->TS_standout_mode
);
286 tty
->standout_mode
= 1;
290 tty_toggle_highlight (struct tty_display_info
*tty
)
292 if (tty
->standout_mode
)
293 tty_turn_off_highlight (tty
);
295 tty_turn_on_highlight (tty
);
299 /* Make cursor invisible. */
302 tty_hide_cursor (struct tty_display_info
*tty
)
304 if (tty
->cursor_hidden
== 0)
306 tty
->cursor_hidden
= 1;
308 w32con_hide_cursor ();
310 OUTPUT_IF (tty
, tty
->TS_cursor_invisible
);
316 /* Ensure that cursor is visible. */
319 tty_show_cursor (struct tty_display_info
*tty
)
321 if (tty
->cursor_hidden
)
323 tty
->cursor_hidden
= 0;
325 w32con_show_cursor ();
327 OUTPUT_IF (tty
, tty
->TS_cursor_normal
);
329 OUTPUT_IF (tty
, tty
->TS_cursor_visible
);
335 /* Set standout mode to the state it should be in for
336 empty space inside windows. What this is,
337 depends on the user option inverse-video. */
340 tty_background_highlight (struct tty_display_info
*tty
)
343 tty_turn_on_highlight (tty
);
345 tty_turn_off_highlight (tty
);
348 /* Set standout mode to the mode specified for the text to be output. */
351 tty_highlight_if_desired (struct tty_display_info
*tty
)
354 tty_turn_on_highlight (tty
);
356 tty_turn_off_highlight (tty
);
360 /* Move cursor to row/column position VPOS/HPOS. HPOS/VPOS are
361 frame-relative coordinates. */
364 tty_cursor_to (struct frame
*f
, int vpos
, int hpos
)
366 struct tty_display_info
*tty
= FRAME_TTY (f
);
368 /* Detect the case where we are called from reset_sys_modes
369 and the costs have never been calculated. Do nothing. */
370 if (! tty
->costs_set
)
373 if (curY (tty
) == vpos
374 && curX (tty
) == hpos
)
376 if (!tty
->TF_standout_motion
)
377 tty_background_highlight (tty
);
378 if (!tty
->TF_insmode_motion
)
379 tty_turn_off_insert (tty
);
380 cmgoto (tty
, vpos
, hpos
);
383 /* Similar but don't take any account of the wasted characters. */
386 tty_raw_cursor_to (struct frame
*f
, int row
, int col
)
388 struct tty_display_info
*tty
= FRAME_TTY (f
);
390 if (curY (tty
) == row
391 && curX (tty
) == col
)
393 if (!tty
->TF_standout_motion
)
394 tty_background_highlight (tty
);
395 if (!tty
->TF_insmode_motion
)
396 tty_turn_off_insert (tty
);
397 cmgoto (tty
, row
, col
);
400 /* Erase operations */
402 /* Clear from cursor to end of frame on a termcap device. */
405 tty_clear_to_end (struct frame
*f
)
408 struct tty_display_info
*tty
= FRAME_TTY (f
);
410 if (tty
->TS_clr_to_bottom
)
412 tty_background_highlight (tty
);
413 OUTPUT (tty
, tty
->TS_clr_to_bottom
);
417 for (i
= curY (tty
); i
< FRAME_LINES (f
); i
++)
420 clear_end_of_line (f
, FRAME_COLS (f
));
425 /* Clear an entire termcap frame. */
428 tty_clear_frame (struct frame
*f
)
430 struct tty_display_info
*tty
= FRAME_TTY (f
);
432 if (tty
->TS_clr_frame
)
434 tty_background_highlight (tty
);
435 OUTPUT (tty
, tty
->TS_clr_frame
);
445 /* An implementation of clear_end_of_line for termcap frames.
447 Note that the cursor may be moved, on terminals lacking a `ce' string. */
450 tty_clear_end_of_line (struct frame
*f
, int first_unused_hpos
)
453 struct tty_display_info
*tty
= FRAME_TTY (f
);
455 /* Detect the case where we are called from reset_sys_modes
456 and the costs have never been calculated. Do nothing. */
457 if (! tty
->costs_set
)
460 if (curX (tty
) >= first_unused_hpos
)
462 tty_background_highlight (tty
);
463 if (tty
->TS_clr_line
)
465 OUTPUT1 (tty
, tty
->TS_clr_line
);
468 { /* have to do it the hard way */
469 tty_turn_off_insert (tty
);
471 /* Do not write in last row last col with Auto-wrap on. */
473 && curY (tty
) == FrameRows (tty
) - 1
474 && first_unused_hpos
== FrameCols (tty
))
477 for (i
= curX (tty
); i
< first_unused_hpos
; i
++)
480 fputc (' ', tty
->termscript
);
481 fputc (' ', tty
->output
);
483 cmplus (tty
, first_unused_hpos
- curX (tty
));
487 /* Buffers to store the source and result of code conversion for terminal. */
488 static unsigned char *encode_terminal_src
;
489 static unsigned char *encode_terminal_dst
;
490 /* Allocated sizes of the above buffers. */
491 static ptrdiff_t encode_terminal_src_size
;
492 static ptrdiff_t encode_terminal_dst_size
;
494 /* Encode SRC_LEN glyphs starting at SRC to terminal output codes.
495 Set CODING->produced to the byte-length of the resulting byte
496 sequence, and return a pointer to that byte sequence. */
499 encode_terminal_code (struct glyph
*src
, int src_len
, struct coding_system
*coding
)
501 struct glyph
*src_end
= src
+ src_len
;
503 ptrdiff_t nchars
, nbytes
, required
;
504 ptrdiff_t tlen
= GLYPH_TABLE_LENGTH
;
505 register Lisp_Object
*tbase
= GLYPH_TABLE_BASE
;
506 Lisp_Object charset_list
;
508 /* Allocate sufficient size of buffer to store all characters in
509 multibyte-form. But, it may be enlarged on demand if
510 Vglyph_table contains a string or a composite glyph is
512 if (min (PTRDIFF_MAX
, SIZE_MAX
) / MAX_MULTIBYTE_LENGTH
< src_len
)
513 memory_full (SIZE_MAX
);
515 required
*= MAX_MULTIBYTE_LENGTH
;
516 if (encode_terminal_src_size
< required
)
518 encode_terminal_src
= xrealloc (encode_terminal_src
, required
);
519 encode_terminal_src_size
= required
;
522 charset_list
= coding_charset_list (coding
);
524 buf
= encode_terminal_src
;
526 while (src
< src_end
)
528 if (src
->type
== COMPOSITE_GLYPH
)
530 struct composition
*cmp
IF_LINT (= NULL
);
531 Lisp_Object gstring
IF_LINT (= Qnil
);
534 nbytes
= buf
- encode_terminal_src
;
535 if (src
->u
.cmp
.automatic
)
537 gstring
= composition_gstring_from_id (src
->u
.cmp
.id
);
538 required
= src
->slice
.cmp
.to
- src
->slice
.cmp
.from
+ 1;
542 cmp
= composition_table
[src
->u
.cmp
.id
];
543 required
= cmp
->glyph_len
;
544 required
*= MAX_MULTIBYTE_LENGTH
;
547 if (encode_terminal_src_size
- nbytes
< required
)
549 encode_terminal_src
=
550 xpalloc (encode_terminal_src
, &encode_terminal_src_size
,
551 required
- (encode_terminal_src_size
- nbytes
),
553 buf
= encode_terminal_src
+ nbytes
;
556 if (src
->u
.cmp
.automatic
)
557 for (i
= src
->slice
.cmp
.from
; i
<= src
->slice
.cmp
.to
; i
++)
559 Lisp_Object g
= LGSTRING_GLYPH (gstring
, i
);
560 int c
= LGLYPH_CHAR (g
);
562 if (! char_charset (c
, charset_list
, NULL
))
564 buf
+= CHAR_STRING (c
, buf
);
568 for (i
= 0; i
< cmp
->glyph_len
; i
++)
570 int c
= COMPOSITION_GLYPH (cmp
, i
);
572 /* TAB in a composition means display glyphs with
573 padding space on the left or right. */
576 if (char_charset (c
, charset_list
, NULL
))
578 if (CHAR_WIDTH (c
) == 0
579 && i
> 0 && COMPOSITION_GLYPH (cmp
, i
- 1) == '\t')
580 /* Should be left-padded */
582 buf
+= CHAR_STRING (' ', buf
);
588 buf
+= CHAR_STRING (c
, buf
);
592 /* We must skip glyphs to be padded for a wide character. */
593 else if (! CHAR_GLYPH_PADDING_P (*src
))
600 SET_GLYPH_FROM_CHAR_GLYPH (g
, src
[0]);
602 if (GLYPH_INVALID_P (g
) || GLYPH_SIMPLE_P (tbase
, tlen
, g
))
604 /* This glyph doesn't have an entry in Vglyph_table. */
609 /* This glyph has an entry in Vglyph_table,
610 so process any alias before testing for simpleness. */
611 GLYPH_FOLLOW_ALIASES (tbase
, tlen
, g
);
613 if (GLYPH_SIMPLE_P (tbase
, tlen
, g
))
614 /* We set the multi-byte form of a character in G
615 (that should be an ASCII character) at WORKBUF. */
618 /* We have a string in Vglyph_table. */
619 string
= tbase
[GLYPH_CHAR (g
)];
624 nbytes
= buf
- encode_terminal_src
;
625 if (encode_terminal_src_size
- nbytes
< MAX_MULTIBYTE_LENGTH
)
627 encode_terminal_src
=
628 xpalloc (encode_terminal_src
, &encode_terminal_src_size
,
629 MAX_MULTIBYTE_LENGTH
, -1, 1);
630 buf
= encode_terminal_src
+ nbytes
;
633 || char_charset (c
, charset_list
, NULL
))
635 /* Store the multibyte form of C at BUF. */
636 buf
+= CHAR_STRING (c
, buf
);
641 /* C is not encodable. */
644 while (src
+ 1 < src_end
&& CHAR_GLYPH_PADDING_P (src
[1]))
654 if (! STRING_MULTIBYTE (string
))
655 string
= string_to_multibyte (string
);
656 nbytes
= buf
- encode_terminal_src
;
657 if (encode_terminal_src_size
- nbytes
< SBYTES (string
))
659 encode_terminal_src
=
660 xpalloc (encode_terminal_src
, &encode_terminal_src_size
,
662 - (encode_terminal_src_size
- nbytes
)),
664 buf
= encode_terminal_src
+ nbytes
;
666 memcpy (buf
, SDATA (string
), SBYTES (string
));
667 buf
+= SBYTES (string
);
668 nchars
+= SCHARS (string
);
676 coding
->produced
= 0;
680 nbytes
= buf
- encode_terminal_src
;
681 coding
->source
= encode_terminal_src
;
682 if (encode_terminal_dst_size
== 0)
684 encode_terminal_dst
= xrealloc (encode_terminal_dst
,
685 encode_terminal_src_size
);
686 encode_terminal_dst_size
= encode_terminal_src_size
;
688 coding
->destination
= encode_terminal_dst
;
689 coding
->dst_bytes
= encode_terminal_dst_size
;
690 encode_coding_object (coding
, Qnil
, 0, 0, nchars
, nbytes
, Qnil
);
691 /* coding->destination may have been reallocated. */
692 encode_terminal_dst
= coding
->destination
;
693 encode_terminal_dst_size
= coding
->dst_bytes
;
695 return (encode_terminal_dst
);
700 /* An implementation of write_glyphs for termcap frames. */
703 tty_write_glyphs (struct frame
*f
, struct glyph
*string
, int len
)
705 unsigned char *conversion_buffer
;
706 struct coding_system
*coding
;
709 struct tty_display_info
*tty
= FRAME_TTY (f
);
711 tty_turn_off_insert (tty
);
712 tty_hide_cursor (tty
);
714 /* Don't dare write in last column of bottom line, if Auto-Wrap,
715 since that would scroll the whole frame on some terminals. */
718 && curY (tty
) + 1 == FRAME_LINES (f
)
719 && (curX (tty
) + len
) == FRAME_COLS (f
))
726 /* If terminal_coding does any conversion, use it, otherwise use
727 safe_terminal_coding. We can't use CODING_REQUIRE_ENCODING here
728 because it always return 1 if the member src_multibyte is 1. */
729 coding
= (FRAME_TERMINAL_CODING (f
)->common_flags
& CODING_REQUIRE_ENCODING_MASK
730 ? FRAME_TERMINAL_CODING (f
) : &safe_terminal_coding
);
731 /* The mode bit CODING_MODE_LAST_BLOCK should be set to 1 only at
733 coding
->mode
&= ~CODING_MODE_LAST_BLOCK
;
735 for (stringlen
= len
; stringlen
!= 0; stringlen
-= n
)
737 /* Identify a run of glyphs with the same face. */
738 int face_id
= string
->face_id
;
740 for (n
= 1; n
< stringlen
; ++n
)
741 if (string
[n
].face_id
!= face_id
)
744 /* Turn appearance modes of the face of the run on. */
745 tty_highlight_if_desired (tty
);
746 turn_on_face (f
, face_id
);
749 /* This is the last run. */
750 coding
->mode
|= CODING_MODE_LAST_BLOCK
;
751 conversion_buffer
= encode_terminal_code (string
, n
, coding
);
752 if (coding
->produced
> 0)
755 fwrite (conversion_buffer
, 1, coding
->produced
, tty
->output
);
756 if (ferror (tty
->output
))
757 clearerr (tty
->output
);
759 fwrite (conversion_buffer
, 1, coding
->produced
, tty
->termscript
);
764 /* Turn appearance modes off. */
765 turn_off_face (f
, face_id
);
766 tty_turn_off_highlight (tty
);
772 #ifdef HAVE_GPM /* Only used by GPM code. */
775 tty_write_glyphs_with_face (register struct frame
*f
, register struct glyph
*string
,
776 register int len
, register int face_id
)
778 unsigned char *conversion_buffer
;
779 struct coding_system
*coding
;
781 struct tty_display_info
*tty
= FRAME_TTY (f
);
783 tty_turn_off_insert (tty
);
784 tty_hide_cursor (tty
);
786 /* Don't dare write in last column of bottom line, if Auto-Wrap,
787 since that would scroll the whole frame on some terminals. */
790 && curY (tty
) + 1 == FRAME_LINES (f
)
791 && (curX (tty
) + len
) == FRAME_COLS (f
))
798 /* If terminal_coding does any conversion, use it, otherwise use
799 safe_terminal_coding. We can't use CODING_REQUIRE_ENCODING here
800 because it always return 1 if the member src_multibyte is 1. */
801 coding
= (FRAME_TERMINAL_CODING (f
)->common_flags
& CODING_REQUIRE_ENCODING_MASK
802 ? FRAME_TERMINAL_CODING (f
) : &safe_terminal_coding
);
803 /* The mode bit CODING_MODE_LAST_BLOCK should be set to 1 only at
805 coding
->mode
&= ~CODING_MODE_LAST_BLOCK
;
807 /* Turn appearance modes of the face. */
808 tty_highlight_if_desired (tty
);
809 turn_on_face (f
, face_id
);
811 coding
->mode
|= CODING_MODE_LAST_BLOCK
;
812 conversion_buffer
= encode_terminal_code (string
, len
, coding
);
813 if (coding
->produced
> 0)
816 fwrite (conversion_buffer
, 1, coding
->produced
, tty
->output
);
817 if (ferror (tty
->output
))
818 clearerr (tty
->output
);
820 fwrite (conversion_buffer
, 1, coding
->produced
, tty
->termscript
);
824 /* Turn appearance modes off. */
825 turn_off_face (f
, face_id
);
826 tty_turn_off_highlight (tty
);
832 /* An implementation of insert_glyphs for termcap frames. */
835 tty_insert_glyphs (struct frame
*f
, struct glyph
*start
, int len
)
838 struct glyph
*glyph
= NULL
;
839 unsigned char *conversion_buffer
;
840 unsigned char space
[1];
841 struct coding_system
*coding
;
843 struct tty_display_info
*tty
= FRAME_TTY (f
);
845 if (tty
->TS_ins_multi_chars
)
847 buf
= tparam (tty
->TS_ins_multi_chars
, 0, 0, len
, 0, 0, 0);
851 write_glyphs (f
, start
, len
);
855 tty_turn_on_insert (tty
);
859 space
[0] = SPACEGLYPH
;
861 /* If terminal_coding does any conversion, use it, otherwise use
862 safe_terminal_coding. We can't use CODING_REQUIRE_ENCODING here
863 because it always return 1 if the member src_multibyte is 1. */
864 coding
= (FRAME_TERMINAL_CODING (f
)->common_flags
& CODING_REQUIRE_ENCODING_MASK
865 ? FRAME_TERMINAL_CODING (f
) : &safe_terminal_coding
);
866 /* The mode bit CODING_MODE_LAST_BLOCK should be set to 1 only at
868 coding
->mode
&= ~CODING_MODE_LAST_BLOCK
;
872 OUTPUT1_IF (tty
, tty
->TS_ins_char
);
875 conversion_buffer
= space
;
876 coding
->produced
= 1;
880 tty_highlight_if_desired (tty
);
881 turn_on_face (f
, start
->face_id
);
884 /* We must open sufficient space for a character which
885 occupies more than one column. */
886 while (len
&& CHAR_GLYPH_PADDING_P (*start
))
888 OUTPUT1_IF (tty
, tty
->TS_ins_char
);
893 /* This is the last glyph. */
894 coding
->mode
|= CODING_MODE_LAST_BLOCK
;
896 conversion_buffer
= encode_terminal_code (glyph
, 1, coding
);
899 if (coding
->produced
> 0)
902 fwrite (conversion_buffer
, 1, coding
->produced
, tty
->output
);
903 if (ferror (tty
->output
))
904 clearerr (tty
->output
);
906 fwrite (conversion_buffer
, 1, coding
->produced
, tty
->termscript
);
910 OUTPUT1_IF (tty
, tty
->TS_pad_inserted_char
);
913 turn_off_face (f
, glyph
->face_id
);
914 tty_turn_off_highlight (tty
);
921 /* An implementation of delete_glyphs for termcap frames. */
924 tty_delete_glyphs (struct frame
*f
, int n
)
929 struct tty_display_info
*tty
= FRAME_TTY (f
);
931 if (tty
->delete_in_insert_mode
)
933 tty_turn_on_insert (tty
);
937 tty_turn_off_insert (tty
);
938 OUTPUT_IF (tty
, tty
->TS_delete_mode
);
941 if (tty
->TS_del_multi_chars
)
943 buf
= tparam (tty
->TS_del_multi_chars
, 0, 0, n
, 0, 0, 0);
948 for (i
= 0; i
< n
; i
++)
949 OUTPUT1 (tty
, tty
->TS_del_char
);
950 if (!tty
->delete_in_insert_mode
)
951 OUTPUT_IF (tty
, tty
->TS_end_delete_mode
);
954 /* An implementation of ins_del_lines for termcap frames. */
957 tty_ins_del_lines (struct frame
*f
, int vpos
, int n
)
959 struct tty_display_info
*tty
= FRAME_TTY (f
);
961 n
> 0 ? tty
->TS_ins_multi_lines
: tty
->TS_del_multi_lines
;
962 const char *single
= n
> 0 ? tty
->TS_ins_line
: tty
->TS_del_line
;
963 const char *scroll
= n
> 0 ? tty
->TS_rev_scroll
: tty
->TS_fwd_scroll
;
968 /* If the lines below the insertion are being pushed
969 into the end of the window, this is the same as clearing;
970 and we know the lines are already clear, since the matching
971 deletion has already been done. So can ignore this. */
972 /* If the lines below the deletion are blank lines coming
973 out of the end of the window, don't bother,
974 as there will be a matching inslines later that will flush them. */
975 if (FRAME_SCROLL_REGION_OK (f
)
976 && vpos
+ i
>= tty
->specified_window
)
978 if (!FRAME_MEMORY_BELOW_FRAME (f
)
979 && vpos
+ i
>= FRAME_LINES (f
))
984 raw_cursor_to (f
, vpos
, 0);
985 tty_background_highlight (tty
);
986 buf
= tparam (multi
, 0, 0, i
, 0, 0, 0);
992 raw_cursor_to (f
, vpos
, 0);
993 tty_background_highlight (tty
);
995 OUTPUT (tty
, single
);
1001 tty_set_scroll_region (f
, vpos
, tty
->specified_window
);
1003 raw_cursor_to (f
, tty
->specified_window
- 1, 0);
1005 raw_cursor_to (f
, vpos
, 0);
1006 tty_background_highlight (tty
);
1008 OUTPUTL (tty
, scroll
, tty
->specified_window
- vpos
);
1009 tty_set_scroll_region (f
, 0, tty
->specified_window
);
1012 if (!FRAME_SCROLL_REGION_OK (f
)
1013 && FRAME_MEMORY_BELOW_FRAME (f
)
1016 cursor_to (f
, FRAME_LINES (f
) + n
, 0);
1021 /* Compute cost of sending "str", in characters,
1022 not counting any line-dependent padding. */
1025 string_cost (const char *str
)
1029 tputs (str
, 0, evalcost
);
1033 /* Compute cost of sending "str", in characters,
1034 counting any line-dependent padding at one line. */
1037 string_cost_one_line (const char *str
)
1041 tputs (str
, 1, evalcost
);
1045 /* Compute per line amount of line-dependent padding,
1046 in tenths of characters. */
1049 per_line_cost (const char *str
)
1053 tputs (str
, 0, evalcost
);
1056 tputs (str
, 10, evalcost
);
1060 /* char_ins_del_cost[n] is cost of inserting N characters.
1061 char_ins_del_cost[-n] is cost of deleting N characters.
1062 The length of this vector is based on max_frame_cols. */
1064 int *char_ins_del_vector
;
1066 #define char_ins_del_cost(f) (&char_ins_del_vector[FRAME_COLS ((f))])
1070 calculate_ins_del_char_costs (struct frame
*f
)
1072 struct tty_display_info
*tty
= FRAME_TTY (f
);
1073 int ins_startup_cost
, del_startup_cost
;
1074 int ins_cost_per_char
, del_cost_per_char
;
1078 if (tty
->TS_ins_multi_chars
)
1080 ins_cost_per_char
= 0;
1081 ins_startup_cost
= string_cost_one_line (tty
->TS_ins_multi_chars
);
1083 else if (tty
->TS_ins_char
|| tty
->TS_pad_inserted_char
1084 || (tty
->TS_insert_mode
&& tty
->TS_end_insert_mode
))
1086 ins_startup_cost
= (30 * (string_cost (tty
->TS_insert_mode
)
1087 + string_cost (tty
->TS_end_insert_mode
))) / 100;
1088 ins_cost_per_char
= (string_cost_one_line (tty
->TS_ins_char
)
1089 + string_cost_one_line (tty
->TS_pad_inserted_char
));
1093 ins_startup_cost
= 9999;
1094 ins_cost_per_char
= 0;
1097 if (tty
->TS_del_multi_chars
)
1099 del_cost_per_char
= 0;
1100 del_startup_cost
= string_cost_one_line (tty
->TS_del_multi_chars
);
1102 else if (tty
->TS_del_char
)
1104 del_startup_cost
= (string_cost (tty
->TS_delete_mode
)
1105 + string_cost (tty
->TS_end_delete_mode
));
1106 if (tty
->delete_in_insert_mode
)
1107 del_startup_cost
/= 2;
1108 del_cost_per_char
= string_cost_one_line (tty
->TS_del_char
);
1112 del_startup_cost
= 9999;
1113 del_cost_per_char
= 0;
1116 /* Delete costs are at negative offsets */
1117 p
= &char_ins_del_cost (f
)[0];
1118 for (i
= FRAME_COLS (f
); --i
>= 0;)
1119 *--p
= (del_startup_cost
+= del_cost_per_char
);
1121 /* Doing nothing is free */
1122 p
= &char_ins_del_cost (f
)[0];
1125 /* Insert costs are at positive offsets */
1126 for (i
= FRAME_COLS (f
); --i
>= 0;)
1127 *p
++ = (ins_startup_cost
+= ins_cost_per_char
);
1131 calculate_costs (struct frame
*frame
)
1133 FRAME_COST_BAUD_RATE (frame
) = baud_rate
;
1135 if (FRAME_TERMCAP_P (frame
))
1137 struct tty_display_info
*tty
= FRAME_TTY (frame
);
1138 register const char *f
= (tty
->TS_set_scroll_region
1139 ? tty
->TS_set_scroll_region
1140 : tty
->TS_set_scroll_region_1
);
1142 FRAME_SCROLL_REGION_COST (frame
) = string_cost (f
);
1146 /* These variables are only used for terminal stuff. They are
1147 allocated once for the terminal frame of X-windows emacs, but not
1150 char_ins_del_vector (i.e., char_ins_del_cost) isn't used because
1151 X turns off char_ins_del_ok. */
1153 max_frame_cols
= max (max_frame_cols
, FRAME_COLS (frame
));
1154 if ((min (PTRDIFF_MAX
, SIZE_MAX
) / sizeof (int) - 1) / 2
1156 memory_full (SIZE_MAX
);
1158 char_ins_del_vector
=
1159 xrealloc (char_ins_del_vector
,
1160 (sizeof (int) + 2 * sizeof (int) * max_frame_cols
));
1162 memset (char_ins_del_vector
, 0,
1163 (sizeof (int) + 2 * sizeof (int) * max_frame_cols
));
1166 if (f
&& (!tty
->TS_ins_line
&& !tty
->TS_del_line
))
1167 do_line_insertion_deletion_costs (frame
,
1168 tty
->TS_rev_scroll
, tty
->TS_ins_multi_lines
,
1169 tty
->TS_fwd_scroll
, tty
->TS_del_multi_lines
,
1172 do_line_insertion_deletion_costs (frame
,
1173 tty
->TS_ins_line
, tty
->TS_ins_multi_lines
,
1174 tty
->TS_del_line
, tty
->TS_del_multi_lines
,
1177 calculate_ins_del_char_costs (frame
);
1179 /* Don't use TS_repeat if its padding is worse than sending the chars */
1180 if (tty
->TS_repeat
&& per_line_cost (tty
->TS_repeat
) * baud_rate
< 9000)
1181 tty
->RPov
= string_cost (tty
->TS_repeat
);
1183 tty
->RPov
= FRAME_COLS (frame
) * 2;
1185 cmcostinit (FRAME_TTY (frame
)); /* set up cursor motion costs */
1190 const char *cap
, *name
;
1193 /* Termcap capability names that correspond directly to X keysyms.
1194 Some of these (marked "terminfo") aren't supplied by old-style
1195 (Berkeley) termcap entries. They're listed in X keysym order;
1196 except we put the keypad keys first, so that if they clash with
1197 other keys (as on the IBM PC keyboard) they get overridden.
1200 static const struct fkey_table keys
[] =
1202 {"kh", "home"}, /* termcap */
1203 {"kl", "left"}, /* termcap */
1204 {"ku", "up"}, /* termcap */
1205 {"kr", "right"}, /* termcap */
1206 {"kd", "down"}, /* termcap */
1207 {"%8", "prior"}, /* terminfo */
1208 {"%5", "next"}, /* terminfo */
1209 {"@7", "end"}, /* terminfo */
1210 {"@1", "begin"}, /* terminfo */
1211 {"*6", "select"}, /* terminfo */
1212 {"%9", "print"}, /* terminfo */
1213 {"@4", "execute"}, /* terminfo --- actually the `command' key */
1215 * "insert" --- see below
1217 {"&8", "undo"}, /* terminfo */
1218 {"%0", "redo"}, /* terminfo */
1219 {"%7", "menu"}, /* terminfo --- actually the `options' key */
1220 {"@0", "find"}, /* terminfo */
1221 {"@2", "cancel"}, /* terminfo */
1222 {"%1", "help"}, /* terminfo */
1224 * "break" goes here, but can't be reliably intercepted with termcap
1226 {"&4", "reset"}, /* terminfo --- actually `restart' */
1228 * "system" and "user" --- no termcaps
1230 {"kE", "clearline"}, /* terminfo */
1231 {"kA", "insertline"}, /* terminfo */
1232 {"kL", "deleteline"}, /* terminfo */
1233 {"kI", "insertchar"}, /* terminfo */
1234 {"kD", "deletechar"}, /* terminfo */
1235 {"kB", "backtab"}, /* terminfo */
1237 * "kp_backtab", "kp-space", "kp-tab" --- no termcaps
1239 {"@8", "kp-enter"}, /* terminfo */
1241 * "kp-f1", "kp-f2", "kp-f3" "kp-f4",
1242 * "kp-multiply", "kp-add", "kp-separator",
1243 * "kp-subtract", "kp-decimal", "kp-divide", "kp-0";
1244 * --- no termcaps for any of these.
1246 {"K4", "kp-1"}, /* terminfo */
1248 * "kp-2" --- no termcap
1250 {"K5", "kp-3"}, /* terminfo */
1252 * "kp-4" --- no termcap
1254 {"K2", "kp-5"}, /* terminfo */
1256 * "kp-6" --- no termcap
1258 {"K1", "kp-7"}, /* terminfo */
1260 * "kp-8" --- no termcap
1262 {"K3", "kp-9"}, /* terminfo */
1264 * "kp-equal" --- no termcap
1276 {"&0", "S-cancel"}, /*shifted cancel key*/
1277 {"&9", "S-begin"}, /*shifted begin key*/
1278 {"*0", "S-find"}, /*shifted find key*/
1279 {"*1", "S-execute"}, /*shifted execute? actually shifted command key*/
1280 {"*4", "S-delete"}, /*shifted delete-character key*/
1281 {"*7", "S-end"}, /*shifted end key*/
1282 {"*8", "S-clearline"}, /*shifted clear-to end-of-line key*/
1283 {"#1", "S-help"}, /*shifted help key*/
1284 {"#2", "S-home"}, /*shifted home key*/
1285 {"#3", "S-insert"}, /*shifted insert-character key*/
1286 {"#4", "S-left"}, /*shifted left-arrow key*/
1287 {"%d", "S-menu"}, /*shifted menu? actually shifted options key*/
1288 {"%c", "S-next"}, /*shifted next key*/
1289 {"%e", "S-prior"}, /*shifted previous key*/
1290 {"%f", "S-print"}, /*shifted print key*/
1291 {"%g", "S-redo"}, /*shifted redo key*/
1292 {"%i", "S-right"}, /*shifted right-arrow key*/
1293 {"!3", "S-undo"} /*shifted undo key*/
1297 static char **term_get_fkeys_address
;
1298 static KBOARD
*term_get_fkeys_kboard
;
1299 static Lisp_Object
term_get_fkeys_1 (void);
1301 /* Find the escape codes sent by the function keys for Vinput_decode_map.
1302 This function scans the termcap function key sequence entries, and
1303 adds entries to Vinput_decode_map for each function key it finds. */
1306 term_get_fkeys (char **address
, KBOARD
*kboard
)
1308 /* We run the body of the function (term_get_fkeys_1) and ignore all Lisp
1309 errors during the call. The only errors should be from Fdefine_key
1310 when given a key sequence containing an invalid prefix key. If the
1311 termcap defines function keys which use a prefix that is already bound
1312 to a command by the default bindings, we should silently ignore that
1313 function key specification, rather than giving the user an error and
1314 refusing to run at all on such a terminal. */
1316 term_get_fkeys_address
= address
;
1317 term_get_fkeys_kboard
= kboard
;
1318 internal_condition_case (term_get_fkeys_1
, Qerror
, Fidentity
);
1322 term_get_fkeys_1 (void)
1326 char **address
= term_get_fkeys_address
;
1327 KBOARD
*kboard
= term_get_fkeys_kboard
;
1329 /* This can happen if CANNOT_DUMP or with strange options. */
1330 if (!KEYMAPP (KVAR (kboard
, Vinput_decode_map
)))
1331 kset_input_decode_map (kboard
, Fmake_sparse_keymap (Qnil
));
1333 for (i
= 0; i
< (sizeof (keys
) / sizeof (keys
[0])); i
++)
1335 char *sequence
= tgetstr (keys
[i
].cap
, address
);
1337 Fdefine_key (KVAR (kboard
, Vinput_decode_map
), build_string (sequence
),
1338 Fmake_vector (make_number (1),
1339 intern (keys
[i
].name
)));
1342 /* The uses of the "k0" capability are inconsistent; sometimes it
1343 describes F10, whereas othertimes it describes F0 and "k;" describes F10.
1344 We will attempt to politely accommodate both systems by testing for
1345 "k;", and if it is present, assuming that "k0" denotes F0, otherwise F10.
1348 const char *k_semi
= tgetstr ("k;", address
);
1349 const char *k0
= tgetstr ("k0", address
);
1350 const char *k0_name
= "f10";
1355 /* Define f0 first, so that f10 takes precedence in case the
1356 key sequences happens to be the same. */
1357 Fdefine_key (KVAR (kboard
, Vinput_decode_map
), build_string (k0
),
1358 Fmake_vector (make_number (1), intern ("f0")));
1359 Fdefine_key (KVAR (kboard
, Vinput_decode_map
), build_string (k_semi
),
1360 Fmake_vector (make_number (1), intern ("f10")));
1363 Fdefine_key (KVAR (kboard
, Vinput_decode_map
), build_string (k0
),
1364 Fmake_vector (make_number (1), intern (k0_name
)));
1367 /* Set up cookies for numbered function keys above f10. */
1369 char fcap
[3], fkey
[4];
1371 fcap
[0] = 'F'; fcap
[2] = '\0';
1372 for (i
= 11; i
< 64; i
++)
1375 fcap
[1] = '1' + i
- 11;
1377 fcap
[1] = 'A' + i
- 20;
1379 fcap
[1] = 'a' + i
- 46;
1382 char *sequence
= tgetstr (fcap
, address
);
1385 sprintf (fkey
, "f%d", i
);
1386 Fdefine_key (KVAR (kboard
, Vinput_decode_map
), build_string (sequence
),
1387 Fmake_vector (make_number (1),
1395 * Various mappings to try and get a better fit.
1398 #define CONDITIONAL_REASSIGN(cap1, cap2, sym) \
1399 if (!tgetstr (cap1, address)) \
1401 char *sequence = tgetstr (cap2, address); \
1403 Fdefine_key (KVAR (kboard, Vinput_decode_map), build_string (sequence), \
1404 Fmake_vector (make_number (1), \
1408 /* if there's no key_next keycap, map key_npage to `next' keysym */
1409 CONDITIONAL_REASSIGN ("%5", "kN", "next");
1410 /* if there's no key_prev keycap, map key_ppage to `previous' keysym */
1411 CONDITIONAL_REASSIGN ("%8", "kP", "prior");
1412 /* if there's no key_dc keycap, map key_ic to `insert' keysym */
1413 CONDITIONAL_REASSIGN ("kD", "kI", "insert");
1414 /* if there's no key_end keycap, map key_ll to 'end' keysym */
1415 CONDITIONAL_REASSIGN ("@7", "kH", "end");
1417 /* IBM has their own non-standard dialect of terminfo.
1418 If the standard name isn't found, try the IBM name. */
1419 CONDITIONAL_REASSIGN ("kB", "KO", "backtab");
1420 CONDITIONAL_REASSIGN ("@4", "kJ", "execute"); /* actually "action" */
1421 CONDITIONAL_REASSIGN ("@4", "kc", "execute"); /* actually "command" */
1422 CONDITIONAL_REASSIGN ("%7", "ki", "menu");
1423 CONDITIONAL_REASSIGN ("@7", "kw", "end");
1424 CONDITIONAL_REASSIGN ("F1", "k<", "f11");
1425 CONDITIONAL_REASSIGN ("F2", "k>", "f12");
1426 CONDITIONAL_REASSIGN ("%1", "kq", "help");
1427 CONDITIONAL_REASSIGN ("*6", "kU", "select");
1428 #undef CONDITIONAL_REASSIGN
1433 #endif /* not DOS_NT */
1436 /***********************************************************************
1437 Character Display Information
1438 ***********************************************************************/
1439 static void append_glyph (struct it
*);
1440 static void append_composite_glyph (struct it
*);
1441 static void produce_composite_glyph (struct it
*);
1442 static void append_glyphless_glyph (struct it
*, int, const char *);
1443 static void produce_glyphless_glyph (struct it
*, Lisp_Object
);
1445 /* Append glyphs to IT's glyph_row. Called from produce_glyphs for
1446 terminal frames if IT->glyph_row != NULL. IT->char_to_display is
1447 the character for which to produce glyphs; IT->face_id contains the
1448 character's face. Padding glyphs are appended if IT->c has a
1449 IT->pixel_width > 1. */
1452 append_glyph (struct it
*it
)
1454 struct glyph
*glyph
, *end
;
1457 eassert (it
->glyph_row
);
1458 glyph
= (it
->glyph_row
->glyphs
[it
->area
]
1459 + it
->glyph_row
->used
[it
->area
]);
1460 end
= it
->glyph_row
->glyphs
[1 + it
->area
];
1462 /* If the glyph row is reversed, we need to prepend the glyph rather
1464 if (it
->glyph_row
->reversed_p
&& it
->area
== TEXT_AREA
)
1467 int move_by
= it
->pixel_width
;
1469 /* Make room for the new glyphs. */
1470 if (move_by
> end
- glyph
) /* don't overstep end of this area */
1471 move_by
= end
- glyph
;
1472 for (g
= glyph
- 1; g
>= it
->glyph_row
->glyphs
[it
->area
]; g
--)
1474 glyph
= it
->glyph_row
->glyphs
[it
->area
];
1475 end
= glyph
+ move_by
;
1478 /* BIDI Note: we put the glyphs of a "multi-pixel" character left to
1479 right, even in the REVERSED_P case, since (a) all of its u.ch are
1480 identical, and (b) the PADDING_P flag needs to be set for the
1481 leftmost one, because we write to the terminal left-to-right. */
1483 i
< it
->pixel_width
&& glyph
< end
;
1486 glyph
->type
= CHAR_GLYPH
;
1487 glyph
->pixel_width
= 1;
1488 glyph
->u
.ch
= it
->char_to_display
;
1489 glyph
->face_id
= it
->face_id
;
1490 glyph
->padding_p
= i
> 0;
1491 glyph
->charpos
= CHARPOS (it
->position
);
1492 glyph
->object
= it
->object
;
1495 glyph
->resolved_level
= it
->bidi_it
.resolved_level
;
1496 if ((it
->bidi_it
.type
& 7) != it
->bidi_it
.type
)
1498 glyph
->bidi_type
= it
->bidi_it
.type
;
1502 glyph
->resolved_level
= 0;
1503 glyph
->bidi_type
= UNKNOWN_BT
;
1506 ++it
->glyph_row
->used
[it
->area
];
1511 /* For external use. */
1513 tty_append_glyph (struct it
*it
)
1519 /* Produce glyphs for the display element described by IT. *IT
1520 specifies what we want to produce a glyph for (character, image, ...),
1521 and where in the glyph matrix we currently are (glyph row and hpos).
1522 produce_glyphs fills in output fields of *IT with information such as the
1523 pixel width and height of a character, and maybe output actual glyphs at
1524 the same time if IT->glyph_row is non-null. For an overview, see
1525 the explanation in dispextern.h, before the definition of the
1526 display_element_type enumeration.
1528 produce_glyphs also stores the result of glyph width, ascent
1529 etc. computations in *IT.
1531 IT->glyph_row may be null, in which case produce_glyphs does not
1532 actually fill in the glyphs. This is used in the move_* functions
1533 in xdisp.c for text width and height computations.
1535 Callers usually don't call produce_glyphs directly;
1536 instead they use the macro PRODUCE_GLYPHS. */
1539 produce_glyphs (struct it
*it
)
1541 /* If a hook is installed, let it do the work. */
1543 /* Nothing but characters are supported on terminal frames. */
1544 eassert (it
->what
== IT_CHARACTER
1545 || it
->what
== IT_COMPOSITION
1546 || it
->what
== IT_STRETCH
1547 || it
->what
== IT_GLYPHLESS
);
1549 if (it
->what
== IT_STRETCH
)
1551 produce_stretch_glyph (it
);
1555 if (it
->what
== IT_COMPOSITION
)
1557 produce_composite_glyph (it
);
1561 if (it
->what
== IT_GLYPHLESS
)
1563 produce_glyphless_glyph (it
, Qnil
);
1567 if (it
->char_to_display
>= 040 && it
->char_to_display
< 0177)
1569 it
->pixel_width
= it
->nglyphs
= 1;
1573 else if (it
->char_to_display
== '\n')
1574 it
->pixel_width
= it
->nglyphs
= 0;
1575 else if (it
->char_to_display
== '\t')
1577 int absolute_x
= (it
->current_x
1578 + it
->continuation_lines_width
);
1580 = (((1 + absolute_x
+ it
->tab_width
- 1)
1585 /* If part of the TAB has been displayed on the previous line
1586 which is continued now, continuation_lines_width will have
1587 been incremented already by the part that fitted on the
1588 continued line. So, we will get the right number of spaces
1590 nspaces
= next_tab_x
- absolute_x
;
1596 it
->char_to_display
= ' ';
1597 it
->pixel_width
= it
->len
= 1;
1603 it
->pixel_width
= nspaces
;
1604 it
->nglyphs
= nspaces
;
1606 else if (CHAR_BYTE8_P (it
->char_to_display
))
1608 /* Coming here means that we must send the raw 8-bit byte as is
1609 to the terminal. Although there's no way to know how many
1610 columns it occupies on a screen, it is a good assumption that
1611 a single byte code has 1-column width. */
1612 it
->pixel_width
= it
->nglyphs
= 1;
1618 Lisp_Object charset_list
= FRAME_TERMINAL (it
->f
)->charset_list
;
1620 if (char_charset (it
->char_to_display
, charset_list
, NULL
))
1622 it
->pixel_width
= CHAR_WIDTH (it
->char_to_display
);
1623 it
->nglyphs
= it
->pixel_width
;
1629 Lisp_Object acronym
= lookup_glyphless_char_display (-1, it
);
1631 eassert (it
->what
== IT_GLYPHLESS
);
1632 produce_glyphless_glyph (it
, acronym
);
1637 /* Advance current_x by the pixel width as a convenience for
1639 if (it
->area
== TEXT_AREA
)
1640 it
->current_x
+= it
->pixel_width
;
1641 it
->ascent
= it
->max_ascent
= it
->phys_ascent
= it
->max_phys_ascent
= 0;
1642 it
->descent
= it
->max_descent
= it
->phys_descent
= it
->max_phys_descent
= 1;
1645 /* Append glyphs to IT's glyph_row for the composition IT->cmp_id.
1646 Called from produce_composite_glyph for terminal frames if
1647 IT->glyph_row != NULL. IT->face_id contains the character's
1651 append_composite_glyph (struct it
*it
)
1653 struct glyph
*glyph
;
1655 eassert (it
->glyph_row
);
1656 glyph
= it
->glyph_row
->glyphs
[it
->area
] + it
->glyph_row
->used
[it
->area
];
1657 if (glyph
< it
->glyph_row
->glyphs
[1 + it
->area
])
1659 /* If the glyph row is reversed, we need to prepend the glyph
1660 rather than append it. */
1661 if (it
->glyph_row
->reversed_p
&& it
->area
== TEXT_AREA
)
1665 /* Make room for the new glyph. */
1666 for (g
= glyph
- 1; g
>= it
->glyph_row
->glyphs
[it
->area
]; g
--)
1668 glyph
= it
->glyph_row
->glyphs
[it
->area
];
1670 glyph
->type
= COMPOSITE_GLYPH
;
1671 glyph
->pixel_width
= it
->pixel_width
;
1672 glyph
->u
.cmp
.id
= it
->cmp_it
.id
;
1673 if (it
->cmp_it
.ch
< 0)
1675 glyph
->u
.cmp
.automatic
= 0;
1676 glyph
->u
.cmp
.id
= it
->cmp_it
.id
;
1680 glyph
->u
.cmp
.automatic
= 1;
1681 glyph
->u
.cmp
.id
= it
->cmp_it
.id
;
1682 glyph
->slice
.cmp
.from
= it
->cmp_it
.from
;
1683 glyph
->slice
.cmp
.to
= it
->cmp_it
.to
- 1;
1686 glyph
->face_id
= it
->face_id
;
1687 glyph
->padding_p
= 0;
1688 glyph
->charpos
= CHARPOS (it
->position
);
1689 glyph
->object
= it
->object
;
1692 glyph
->resolved_level
= it
->bidi_it
.resolved_level
;
1693 if ((it
->bidi_it
.type
& 7) != it
->bidi_it
.type
)
1695 glyph
->bidi_type
= it
->bidi_it
.type
;
1699 glyph
->resolved_level
= 0;
1700 glyph
->bidi_type
= UNKNOWN_BT
;
1703 ++it
->glyph_row
->used
[it
->area
];
1709 /* Produce a composite glyph for iterator IT. IT->cmp_id is the ID of
1710 the composition. We simply produces components of the composition
1711 assuming that the terminal has a capability to layout/render it
1715 produce_composite_glyph (struct it
*it
)
1717 if (it
->cmp_it
.ch
< 0)
1719 struct composition
*cmp
= composition_table
[it
->cmp_it
.id
];
1721 it
->pixel_width
= cmp
->width
;
1725 Lisp_Object gstring
= composition_gstring_from_id (it
->cmp_it
.id
);
1727 it
->pixel_width
= composition_gstring_width (gstring
, it
->cmp_it
.from
,
1728 it
->cmp_it
.to
, NULL
);
1732 append_composite_glyph (it
);
1736 /* Append a glyph for a glyphless character to IT->glyph_row. FACE_ID
1737 is a face ID to be used for the glyph. What is actually appended
1738 are glyphs of type CHAR_GLYPH whose characters are in STR (which
1739 comes from it->nglyphs bytes). */
1742 append_glyphless_glyph (struct it
*it
, int face_id
, const char *str
)
1744 struct glyph
*glyph
, *end
;
1747 eassert (it
->glyph_row
);
1748 glyph
= it
->glyph_row
->glyphs
[it
->area
] + it
->glyph_row
->used
[it
->area
];
1749 end
= it
->glyph_row
->glyphs
[1 + it
->area
];
1751 /* If the glyph row is reversed, we need to prepend the glyph rather
1753 if (it
->glyph_row
->reversed_p
&& it
->area
== TEXT_AREA
)
1756 int move_by
= it
->pixel_width
;
1758 /* Make room for the new glyphs. */
1759 if (move_by
> end
- glyph
) /* don't overstep end of this area */
1760 move_by
= end
- glyph
;
1761 for (g
= glyph
- 1; g
>= it
->glyph_row
->glyphs
[it
->area
]; g
--)
1763 glyph
= it
->glyph_row
->glyphs
[it
->area
];
1764 end
= glyph
+ move_by
;
1769 glyph
->type
= CHAR_GLYPH
;
1770 glyph
->pixel_width
= 1;
1771 glyph
->face_id
= face_id
;
1772 glyph
->padding_p
= 0;
1773 glyph
->charpos
= CHARPOS (it
->position
);
1774 glyph
->object
= it
->object
;
1777 glyph
->resolved_level
= it
->bidi_it
.resolved_level
;
1778 if ((it
->bidi_it
.type
& 7) != it
->bidi_it
.type
)
1780 glyph
->bidi_type
= it
->bidi_it
.type
;
1784 glyph
->resolved_level
= 0;
1785 glyph
->bidi_type
= UNKNOWN_BT
;
1788 /* BIDI Note: we put the glyphs of characters left to right, even in
1789 the REVERSED_P case because we write to the terminal
1791 for (i
= 0; i
< it
->nglyphs
&& glyph
< end
; ++i
)
1794 glyph
[0] = glyph
[-1];
1795 glyph
->u
.ch
= str
[i
];
1796 ++it
->glyph_row
->used
[it
->area
];
1801 /* Produce glyphs for a glyphless character for iterator IT.
1802 IT->glyphless_method specifies which method to use for displaying
1803 the character. See the description of enum
1804 glyphless_display_method in dispextern.h for the details.
1806 ACRONYM, if non-nil, is an acronym string for the character.
1808 The glyphs actually produced are of type CHAR_GLYPH. */
1811 produce_glyphless_glyph (struct it
*it
, Lisp_Object acronym
)
1815 char buf
[sizeof "\\x" + max (6, (sizeof it
->c
* CHAR_BIT
+ 3) / 4)];
1816 char const *str
= " ";
1818 /* Get a face ID for the glyph by utilizing a cache (the same way as
1819 done for `escape-glyph' in get_next_display_element). */
1820 if (it
->f
== last_glyphless_glyph_frame
1821 && it
->face_id
== last_glyphless_glyph_face_id
)
1823 face_id
= last_glyphless_glyph_merged_face_id
;
1827 /* Merge the `glyphless-char' face into the current face. */
1828 face_id
= merge_faces (it
->f
, Qglyphless_char
, 0, it
->face_id
);
1829 last_glyphless_glyph_frame
= it
->f
;
1830 last_glyphless_glyph_face_id
= it
->face_id
;
1831 last_glyphless_glyph_merged_face_id
= face_id
;
1834 if (it
->glyphless_method
== GLYPHLESS_DISPLAY_THIN_SPACE
)
1836 /* As there's no way to produce a thin space, we produce a space
1837 of canonical width. */
1840 else if (it
->glyphless_method
== GLYPHLESS_DISPLAY_EMPTY_BOX
)
1842 len
= CHAR_WIDTH (it
->c
);
1847 len
= sprintf (buf
, "[%.*s]", len
, str
);
1852 if (it
->glyphless_method
== GLYPHLESS_DISPLAY_ACRONYM
)
1854 if (! STRINGP (acronym
) && CHAR_TABLE_P (Vglyphless_char_display
))
1855 acronym
= CHAR_TABLE_REF (Vglyphless_char_display
, it
->c
);
1856 if (CONSP (acronym
))
1857 acronym
= XCDR (acronym
);
1859 str
= STRINGP (acronym
) ? SSDATA (acronym
) : "";
1860 for (len
= 0; len
< 6 && str
[len
] && ASCII_BYTE_P (str
[len
]); len
++)
1861 buf
[1 + len
] = str
[len
];
1867 eassert (it
->glyphless_method
== GLYPHLESS_DISPLAY_HEX_CODE
);
1868 len
= (it
->c
< 0x10000 ? sprintf (buf
, "\\u%04X", it
->c
)
1869 : it
->c
<= MAX_UNICODE_CHAR
? sprintf (buf
, "\\U%06X", it
->c
)
1870 : sprintf (buf
, "\\x%06X", it
->c
));
1875 it
->pixel_width
= len
;
1878 append_glyphless_glyph (it
, face_id
, str
);
1882 /***********************************************************************
1884 ***********************************************************************/
1886 /* Value is non-zero if attribute ATTR may be used. ATTR should be
1887 one of the enumerators from enum no_color_bit, or a bit set built
1888 from them. Some display attributes may not be used together with
1889 color; the termcap capability `NC' specifies which ones. */
1891 #define MAY_USE_WITH_COLORS_P(tty, ATTR) \
1892 (tty->TN_max_colors > 0 \
1893 ? (tty->TN_no_color_video & (ATTR)) == 0 \
1896 /* Turn appearances of face FACE_ID on tty frame F on.
1897 FACE_ID is a realized face ID number, in the face cache. */
1900 turn_on_face (struct frame
*f
, int face_id
)
1902 struct face
*face
= FACE_FROM_ID (f
, face_id
);
1903 long fg
= face
->foreground
;
1904 long bg
= face
->background
;
1905 struct tty_display_info
*tty
= FRAME_TTY (f
);
1907 /* Do this first because TS_end_standout_mode may be the same
1908 as TS_exit_attribute_mode, which turns all appearances off. */
1909 if (MAY_USE_WITH_COLORS_P (tty
, NC_REVERSE
))
1911 if (tty
->TN_max_colors
> 0)
1913 if (fg
>= 0 && bg
>= 0)
1915 /* If the terminal supports colors, we can set them
1916 below without using reverse video. The face's fg
1917 and bg colors are set as they should appear on
1918 the screen, i.e. they take the inverse-video'ness
1919 of the face already into account. */
1921 else if (inverse_video
)
1923 if (fg
== FACE_TTY_DEFAULT_FG_COLOR
1924 || bg
== FACE_TTY_DEFAULT_BG_COLOR
)
1925 tty_toggle_highlight (tty
);
1929 if (fg
== FACE_TTY_DEFAULT_BG_COLOR
1930 || bg
== FACE_TTY_DEFAULT_FG_COLOR
)
1931 tty_toggle_highlight (tty
);
1936 /* If we can't display colors, use reverse video
1937 if the face specifies that. */
1940 if (fg
== FACE_TTY_DEFAULT_FG_COLOR
1941 || bg
== FACE_TTY_DEFAULT_BG_COLOR
)
1942 tty_toggle_highlight (tty
);
1946 if (fg
== FACE_TTY_DEFAULT_BG_COLOR
1947 || bg
== FACE_TTY_DEFAULT_FG_COLOR
)
1948 tty_toggle_highlight (tty
);
1953 if (face
->tty_bold_p
&& MAY_USE_WITH_COLORS_P (tty
, NC_BOLD
))
1954 OUTPUT1_IF (tty
, tty
->TS_enter_bold_mode
);
1956 if (face
->tty_italic_p
&& MAY_USE_WITH_COLORS_P (tty
, NC_ITALIC
))
1958 if (tty
->TS_enter_italic_mode
)
1959 OUTPUT1 (tty
, tty
->TS_enter_italic_mode
);
1961 /* Italics mode is unavailable on many terminals. In that
1962 case, map slant to dimmed text; we want italic text to
1963 appear different and dimming is not otherwise used. */
1964 OUTPUT1 (tty
, tty
->TS_enter_dim_mode
);
1967 if (face
->tty_underline_p
&& MAY_USE_WITH_COLORS_P (tty
, NC_UNDERLINE
))
1968 OUTPUT1_IF (tty
, tty
->TS_enter_underline_mode
);
1970 if (tty
->TN_max_colors
> 0)
1975 ts
= tty
->standout_mode
? tty
->TS_set_background
: tty
->TS_set_foreground
;
1978 p
= tparam (ts
, NULL
, 0, fg
, 0, 0, 0);
1983 ts
= tty
->standout_mode
? tty
->TS_set_foreground
: tty
->TS_set_background
;
1986 p
= tparam (ts
, NULL
, 0, bg
, 0, 0, 0);
1994 /* Turn off appearances of face FACE_ID on tty frame F. */
1997 turn_off_face (struct frame
*f
, int face_id
)
1999 struct face
*face
= FACE_FROM_ID (f
, face_id
);
2000 struct tty_display_info
*tty
= FRAME_TTY (f
);
2002 eassert (face
!= NULL
);
2004 if (tty
->TS_exit_attribute_mode
)
2006 /* Capability "me" will turn off appearance modes double-bright,
2007 half-bright, reverse-video, standout, underline. It may or
2008 may not turn off alt-char-mode. */
2009 if (face
->tty_bold_p
2010 || face
->tty_italic_p
2011 || face
->tty_reverse_p
2012 || face
->tty_underline_p
)
2014 OUTPUT1_IF (tty
, tty
->TS_exit_attribute_mode
);
2015 if (strcmp (tty
->TS_exit_attribute_mode
, tty
->TS_end_standout_mode
) == 0)
2016 tty
->standout_mode
= 0;
2021 /* If we don't have "me" we can only have those appearances
2022 that have exit sequences defined. */
2023 if (face
->tty_underline_p
)
2024 OUTPUT_IF (tty
, tty
->TS_exit_underline_mode
);
2027 /* Switch back to default colors. */
2028 if (tty
->TN_max_colors
> 0
2029 && ((face
->foreground
!= FACE_TTY_DEFAULT_COLOR
2030 && face
->foreground
!= FACE_TTY_DEFAULT_FG_COLOR
)
2031 || (face
->background
!= FACE_TTY_DEFAULT_COLOR
2032 && face
->background
!= FACE_TTY_DEFAULT_BG_COLOR
)))
2033 OUTPUT1_IF (tty
, tty
->TS_orig_pair
);
2037 /* Return true if the terminal on frame F supports all of the
2038 capabilities in CAPS simultaneously, with foreground and background
2039 colors FG and BG. */
2042 tty_capable_p (struct tty_display_info
*tty
, unsigned int caps
,
2043 unsigned long fg
, unsigned long bg
)
2045 #define TTY_CAPABLE_P_TRY(tty, cap, TS, NC_bit) \
2046 if ((caps & (cap)) && (!(TS) || !MAY_USE_WITH_COLORS_P(tty, NC_bit))) \
2049 TTY_CAPABLE_P_TRY (tty
, TTY_CAP_INVERSE
, tty
->TS_standout_mode
, NC_REVERSE
);
2050 TTY_CAPABLE_P_TRY (tty
, TTY_CAP_UNDERLINE
, tty
->TS_enter_underline_mode
, NC_UNDERLINE
);
2051 TTY_CAPABLE_P_TRY (tty
, TTY_CAP_BOLD
, tty
->TS_enter_bold_mode
, NC_BOLD
);
2052 TTY_CAPABLE_P_TRY (tty
, TTY_CAP_DIM
, tty
->TS_enter_dim_mode
, NC_DIM
);
2053 TTY_CAPABLE_P_TRY (tty
, TTY_CAP_ITALIC
, tty
->TS_enter_italic_mode
, NC_ITALIC
);
2059 /* Return non-zero if the terminal is capable to display colors. */
2061 DEFUN ("tty-display-color-p", Ftty_display_color_p
, Stty_display_color_p
,
2063 doc
: /* Return non-nil if the tty device TERMINAL can display colors.
2065 TERMINAL can be a terminal object, a frame, or nil (meaning the
2066 selected frame's terminal). This function always returns nil if
2067 TERMINAL does not refer to a text terminal. */)
2068 (Lisp_Object terminal
)
2070 struct terminal
*t
= get_tty_terminal (terminal
, 0);
2074 return t
->display_info
.tty
->TN_max_colors
> 0 ? Qt
: Qnil
;
2077 /* Return the number of supported colors. */
2078 DEFUN ("tty-display-color-cells", Ftty_display_color_cells
,
2079 Stty_display_color_cells
, 0, 1, 0,
2080 doc
: /* Return the number of colors supported by the tty device TERMINAL.
2082 TERMINAL can be a terminal object, a frame, or nil (meaning the
2083 selected frame's terminal). This function always returns 0 if
2084 TERMINAL does not refer to a text terminal. */)
2085 (Lisp_Object terminal
)
2087 struct terminal
*t
= get_tty_terminal (terminal
, 0);
2089 return make_number (0);
2091 return make_number (t
->display_info
.tty
->TN_max_colors
);
2096 /* Declare here rather than in the function, as in the rest of Emacs,
2097 to work around an HPUX compiler bug (?). See
2098 http://lists.gnu.org/archive/html/emacs-devel/2007-08/msg00410.html */
2099 static int default_max_colors
;
2100 static int default_max_pairs
;
2101 static int default_no_color_video
;
2102 static char *default_orig_pair
;
2103 static char *default_set_foreground
;
2104 static char *default_set_background
;
2106 /* Save or restore the default color-related capabilities of this
2109 tty_default_color_capabilities (struct tty_display_info
*tty
, bool save
)
2114 xfree (default_orig_pair
);
2115 default_orig_pair
= tty
->TS_orig_pair
? xstrdup (tty
->TS_orig_pair
) : NULL
;
2117 xfree (default_set_foreground
);
2118 default_set_foreground
= tty
->TS_set_foreground
? xstrdup (tty
->TS_set_foreground
)
2121 xfree (default_set_background
);
2122 default_set_background
= tty
->TS_set_background
? xstrdup (tty
->TS_set_background
)
2125 default_max_colors
= tty
->TN_max_colors
;
2126 default_max_pairs
= tty
->TN_max_pairs
;
2127 default_no_color_video
= tty
->TN_no_color_video
;
2131 tty
->TS_orig_pair
= default_orig_pair
;
2132 tty
->TS_set_foreground
= default_set_foreground
;
2133 tty
->TS_set_background
= default_set_background
;
2134 tty
->TN_max_colors
= default_max_colors
;
2135 tty
->TN_max_pairs
= default_max_pairs
;
2136 tty
->TN_no_color_video
= default_no_color_video
;
2140 /* Setup one of the standard tty color schemes according to MODE.
2141 MODE's value is generally the number of colors which we want to
2142 support; zero means set up for the default capabilities, the ones
2143 we saw at init_tty time; -1 means turn off color support. */
2145 tty_setup_colors (struct tty_display_info
*tty
, int mode
)
2147 /* Canonicalize all negative values of MODE. */
2153 case -1: /* no colors at all */
2154 tty
->TN_max_colors
= 0;
2155 tty
->TN_max_pairs
= 0;
2156 tty
->TN_no_color_video
= 0;
2157 tty
->TS_set_foreground
= tty
->TS_set_background
= tty
->TS_orig_pair
= NULL
;
2159 case 0: /* default colors, if any */
2161 tty_default_color_capabilities (tty
, 0);
2163 case 8: /* 8 standard ANSI colors */
2164 tty
->TS_orig_pair
= "\033[0m";
2166 tty
->TS_set_foreground
= "\033[3%p1%dm";
2167 tty
->TS_set_background
= "\033[4%p1%dm";
2169 tty
->TS_set_foreground
= "\033[3%dm";
2170 tty
->TS_set_background
= "\033[4%dm";
2172 tty
->TN_max_colors
= 8;
2173 tty
->TN_max_pairs
= 64;
2174 tty
->TN_no_color_video
= 0;
2180 set_tty_color_mode (struct tty_display_info
*tty
, struct frame
*f
)
2182 Lisp_Object tem
, val
;
2183 Lisp_Object color_mode
;
2185 Lisp_Object tty_color_mode_alist
2186 = Fintern_soft (build_string ("tty-color-mode-alist"), Qnil
);
2188 tem
= assq_no_quit (Qtty_color_mode
, f
->param_alist
);
2189 val
= CONSP (tem
) ? XCDR (tem
) : Qnil
;
2193 else if (SYMBOLP (tty_color_mode_alist
))
2195 tem
= Fassq (val
, Fsymbol_value (tty_color_mode_alist
));
2196 color_mode
= CONSP (tem
) ? XCDR (tem
) : Qnil
;
2201 mode
= TYPE_RANGED_INTEGERP (int, color_mode
) ? XINT (color_mode
) : 0;
2203 if (mode
!= tty
->previous_color_mode
)
2205 tty
->previous_color_mode
= mode
;
2206 tty_setup_colors (tty
, mode
);
2207 /* This recomputes all the faces given the new color definitions. */
2208 safe_call (1, intern ("tty-set-up-initial-frame-faces"));
2212 #endif /* !DOS_NT */
2216 /* Return the tty display object specified by TERMINAL. */
2218 static struct terminal
*
2219 get_tty_terminal (Lisp_Object terminal
, bool throw)
2221 struct terminal
*t
= get_terminal (terminal
, throw);
2223 if (t
&& t
->type
!= output_termcap
&& t
->type
!= output_msdos_raw
)
2226 error ("Device %d is not a termcap terminal device", t
->id
);
2234 /* Return an active termcap device that uses the tty device with the
2237 This function ignores suspended devices.
2239 Returns NULL if the named terminal device is not opened. */
2242 get_named_tty (const char *name
)
2248 for (t
= terminal_list
; t
; t
= t
->next_terminal
)
2250 if ((t
->type
== output_termcap
|| t
->type
== output_msdos_raw
)
2251 && !strcmp (t
->display_info
.tty
->name
, name
)
2252 && TERMINAL_ACTIVE_P (t
))
2260 DEFUN ("tty-type", Ftty_type
, Stty_type
, 0, 1, 0,
2261 doc
: /* Return the type of the tty device that TERMINAL uses.
2262 Returns nil if TERMINAL is not on a tty device.
2264 TERMINAL can be a terminal object, a frame, or nil (meaning the
2265 selected frame's terminal). */)
2266 (Lisp_Object terminal
)
2268 struct terminal
*t
= get_terminal (terminal
, 1);
2270 if (t
->type
!= output_termcap
&& t
->type
!= output_msdos_raw
)
2273 if (t
->display_info
.tty
->type
)
2274 return build_string (t
->display_info
.tty
->type
);
2279 DEFUN ("controlling-tty-p", Fcontrolling_tty_p
, Scontrolling_tty_p
, 0, 1, 0,
2280 doc
: /* Return non-nil if TERMINAL is the controlling tty of the Emacs process.
2282 TERMINAL can be a terminal object, a frame, or nil (meaning the
2283 selected frame's terminal). This function always returns nil if
2284 TERMINAL is not on a tty device. */)
2285 (Lisp_Object terminal
)
2287 struct terminal
*t
= get_terminal (terminal
, 1);
2289 if ((t
->type
!= output_termcap
&& t
->type
!= output_msdos_raw
)
2290 || strcmp (t
->display_info
.tty
->name
, DEV_TTY
) != 0)
2296 DEFUN ("tty-no-underline", Ftty_no_underline
, Stty_no_underline
, 0, 1, 0,
2297 doc
: /* Declare that the tty used by TERMINAL does not handle underlining.
2298 This is used to override the terminfo data, for certain terminals that
2299 do not really do underlining, but say that they do. This function has
2300 no effect if used on a non-tty terminal.
2302 TERMINAL can be a terminal object, a frame or nil (meaning the
2303 selected frame's terminal). This function always returns nil if
2304 TERMINAL does not refer to a text terminal. */)
2305 (Lisp_Object terminal
)
2307 struct terminal
*t
= get_terminal (terminal
, 1);
2309 if (t
->type
== output_termcap
)
2310 t
->display_info
.tty
->TS_enter_underline_mode
= 0;
2314 DEFUN ("tty-top-frame", Ftty_top_frame
, Stty_top_frame
, 0, 1, 0,
2315 doc
: /* Return the topmost terminal frame on TERMINAL.
2316 TERMINAL can be a terminal object, a frame or nil (meaning the
2317 selected frame's terminal). This function returns nil if TERMINAL
2318 does not refer to a text terminal. Otherwise, it returns the
2319 top-most frame on the text terminal. */)
2320 (Lisp_Object terminal
)
2322 struct terminal
*t
= get_terminal (terminal
, 1);
2324 if (t
->type
== output_termcap
)
2325 return t
->display_info
.tty
->top_frame
;
2331 DEFUN ("suspend-tty", Fsuspend_tty
, Ssuspend_tty
, 0, 1, 0,
2332 doc
: /* Suspend the terminal device TTY.
2334 The device is restored to its default state, and Emacs ceases all
2335 access to the tty device. Frames that use the device are not deleted,
2336 but input is not read from them and if they change, their display is
2339 TTY may be a terminal object, a frame, or nil for the terminal device
2340 of the currently selected frame.
2342 This function runs `suspend-tty-functions' after suspending the
2343 device. The functions are run with one arg, the id of the suspended
2346 `suspend-tty' does nothing if it is called on a device that is already
2349 A suspended tty may be resumed by calling `resume-tty' on it. */)
2352 struct terminal
*t
= get_tty_terminal (tty
, 1);
2356 error ("Unknown tty device");
2358 f
= t
->display_info
.tty
->input
;
2362 /* First run `suspend-tty-functions' and then clean up the tty
2363 state because `suspend-tty-functions' might need to change
2365 Lisp_Object args
[2];
2366 args
[0] = intern ("suspend-tty-functions");
2367 XSETTERMINAL (args
[1], t
);
2368 Frun_hook_with_args (2, args
);
2370 reset_sys_modes (t
->display_info
.tty
);
2371 delete_keyboard_wait_descriptor (fileno (f
));
2375 if (f
!= t
->display_info
.tty
->output
)
2376 fclose (t
->display_info
.tty
->output
);
2379 t
->display_info
.tty
->input
= 0;
2380 t
->display_info
.tty
->output
= 0;
2382 if (FRAMEP (t
->display_info
.tty
->top_frame
))
2383 SET_FRAME_VISIBLE (XFRAME (t
->display_info
.tty
->top_frame
), 0);
2387 /* Clear display hooks to prevent further output. */
2388 clear_tty_hooks (t
);
2393 DEFUN ("resume-tty", Fresume_tty
, Sresume_tty
, 0, 1, 0,
2394 doc
: /* Resume the previously suspended terminal device TTY.
2395 The terminal is opened and reinitialized. Frames that are on the
2396 suspended terminal are revived.
2398 It is an error to resume a terminal while another terminal is active
2401 This function runs `resume-tty-functions' after resuming the terminal.
2402 The functions are run with one arg, the id of the resumed terminal
2405 `resume-tty' does nothing if it is called on a device that is not
2408 TTY may be a terminal object, a frame, or nil (meaning the selected
2409 frame's terminal). */)
2412 struct terminal
*t
= get_tty_terminal (tty
, 1);
2416 error ("Unknown tty device");
2418 if (!t
->display_info
.tty
->input
)
2420 if (get_named_tty (t
->display_info
.tty
->name
))
2421 error ("Cannot resume display while another display is active on the same device");
2424 t
->display_info
.tty
->output
= stdout
;
2425 t
->display_info
.tty
->input
= stdin
;
2427 fd
= emacs_open (t
->display_info
.tty
->name
, O_RDWR
| O_NOCTTY
, 0);
2428 t
->display_info
.tty
->input
= t
->display_info
.tty
->output
2429 = fd
< 0 ? 0 : fdopen (fd
, "w+");
2431 if (! t
->display_info
.tty
->input
)
2433 int open_errno
= errno
;
2435 report_file_errno ("Cannot reopen tty device",
2436 build_string (t
->display_info
.tty
->name
),
2440 if (!O_IGNORE_CTTY
&& strcmp (t
->display_info
.tty
->name
, DEV_TTY
) != 0)
2441 dissociate_if_controlling_tty (fd
);
2444 add_keyboard_wait_descriptor (fd
);
2446 if (FRAMEP (t
->display_info
.tty
->top_frame
))
2448 struct frame
*f
= XFRAME (t
->display_info
.tty
->top_frame
);
2450 int old_height
= FRAME_COLS (f
);
2451 int old_width
= FRAME_LINES (f
);
2453 /* Check if terminal/window size has changed while the frame
2455 get_tty_size (fileno (t
->display_info
.tty
->input
), &width
, &height
);
2456 if (width
!= old_width
|| height
!= old_height
)
2457 change_frame_size (f
, height
, width
, 0, 0, 0);
2458 SET_FRAME_VISIBLE (XFRAME (t
->display_info
.tty
->top_frame
), 1);
2462 init_sys_modes (t
->display_info
.tty
);
2465 /* Run `resume-tty-functions'. */
2466 Lisp_Object args
[2];
2467 args
[0] = intern ("resume-tty-functions");
2468 XSETTERMINAL (args
[1], t
);
2469 Frun_hook_with_args (2, args
);
2479 /***********************************************************************
2481 ***********************************************************************/
2485 #ifndef HAVE_WINDOW_SYSTEM
2487 term_mouse_moveto (int x
, int y
)
2489 /* TODO: how to set mouse position?
2492 name = (const char *) ttyname (0);
2493 fd = emacs_open (name, O_WRONLY, 0);
2494 SOME_FUNCTION (x, y, fd);
2497 last_mouse_y = y; */
2499 #endif /* HAVE_WINDOW_SYSTEM */
2501 /* Implementation of draw_row_with_mouse_face for TTY/GPM. */
2503 tty_draw_row_with_mouse_face (struct window
*w
, struct glyph_row
*row
,
2504 int start_hpos
, int end_hpos
,
2505 enum draw_glyphs_face draw
)
2507 int nglyphs
= end_hpos
- start_hpos
;
2508 struct frame
*f
= XFRAME (WINDOW_FRAME (w
));
2509 struct tty_display_info
*tty
= FRAME_TTY (f
);
2510 int face_id
= tty
->mouse_highlight
.mouse_face_face_id
;
2511 int save_x
, save_y
, pos_x
, pos_y
;
2513 if (end_hpos
>= row
->used
[TEXT_AREA
])
2514 nglyphs
= row
->used
[TEXT_AREA
] - start_hpos
;
2516 pos_y
= row
->y
+ WINDOW_TOP_EDGE_Y (w
);
2517 pos_x
= row
->used
[LEFT_MARGIN_AREA
] + start_hpos
+ WINDOW_LEFT_EDGE_X (w
);
2519 /* Save current cursor co-ordinates. */
2520 save_y
= curY (tty
);
2521 save_x
= curX (tty
);
2522 cursor_to (f
, pos_y
, pos_x
);
2524 if (draw
== DRAW_MOUSE_FACE
)
2525 tty_write_glyphs_with_face (f
, row
->glyphs
[TEXT_AREA
] + start_hpos
,
2527 else if (draw
== DRAW_NORMAL_TEXT
)
2528 write_glyphs (f
, row
->glyphs
[TEXT_AREA
] + start_hpos
, nglyphs
);
2530 cursor_to (f
, save_y
, save_x
);
2534 term_mouse_movement (struct frame
*frame
, Gpm_Event
*event
)
2536 /* Has the mouse moved off the glyph it was on at the last sighting? */
2537 if (event
->x
!= last_mouse_x
|| event
->y
!= last_mouse_y
)
2539 frame
->mouse_moved
= 1;
2540 note_mouse_highlight (frame
, event
->x
, event
->y
);
2541 /* Remember which glyph we're now on. */
2542 last_mouse_x
= event
->x
;
2543 last_mouse_y
= event
->y
;
2549 /* Return the Time that corresponds to T. Wrap around on overflow. */
2551 timeval_to_Time (struct timeval
const *t
)
2557 ms
= t
->tv_usec
/ 1000;
2561 /* Return the current position of the mouse.
2563 Set *f to the frame the mouse is in, or zero if the mouse is in no
2564 Emacs frame. If it is set to zero, all the other arguments are
2567 Set *bar_window to Qnil, and *x and *y to the column and
2568 row of the character cell the mouse is over.
2570 Set *timeptr to the time the mouse was at the returned position.
2572 This clears mouse_moved until the next motion
2575 term_mouse_position (struct frame
**fp
, int insist
, Lisp_Object
*bar_window
,
2576 enum scroll_bar_part
*part
, Lisp_Object
*x
,
2577 Lisp_Object
*y
, Time
*timeptr
)
2581 *fp
= SELECTED_FRAME ();
2582 (*fp
)->mouse_moved
= 0;
2587 XSETINT (*x
, last_mouse_x
);
2588 XSETINT (*y
, last_mouse_y
);
2589 gettimeofday(&now
, 0);
2590 *timeptr
= timeval_to_Time (&now
);
2593 /* Prepare a mouse-event in *RESULT for placement in the input queue.
2595 If the event is a button press, then note that we have grabbed
2599 term_mouse_click (struct input_event
*result
, Gpm_Event
*event
,
2605 result
->kind
= GPM_CLICK_EVENT
;
2606 for (i
= 0, j
= GPM_B_LEFT
; i
< 3; i
++, j
>>= 1 )
2608 if (event
->buttons
& j
) {
2609 result
->code
= i
; /* button number */
2613 gettimeofday(&now
, 0);
2614 result
->timestamp
= timeval_to_Time (&now
);
2616 if (event
->type
& GPM_UP
)
2617 result
->modifiers
= up_modifier
;
2618 else if (event
->type
& GPM_DOWN
)
2619 result
->modifiers
= down_modifier
;
2621 result
->modifiers
= 0;
2623 if (event
->type
& GPM_SINGLE
)
2624 result
->modifiers
|= click_modifier
;
2626 if (event
->type
& GPM_DOUBLE
)
2627 result
->modifiers
|= double_modifier
;
2629 if (event
->type
& GPM_TRIPLE
)
2630 result
->modifiers
|= triple_modifier
;
2632 if (event
->type
& GPM_DRAG
)
2633 result
->modifiers
|= drag_modifier
;
2635 if (!(event
->type
& (GPM_MOVE
| GPM_DRAG
))) {
2638 if (event
->modifiers
& (1 << 0))
2639 result
->modifiers
|= shift_modifier
;
2642 if (event
->modifiers
& (1 << 2))
2643 result
->modifiers
|= ctrl_modifier
;
2645 /* 1 << KG_ALT || KG_ALTGR */
2646 if (event
->modifiers
& (1 << 3)
2647 || event
->modifiers
& (1 << 1))
2648 result
->modifiers
|= meta_modifier
;
2651 XSETINT (result
->x
, event
->x
);
2652 XSETINT (result
->y
, event
->y
);
2653 XSETFRAME (result
->frame_or_window
, f
);
2659 handle_one_term_event (struct tty_display_info
*tty
, Gpm_Event
*event
, struct input_event
* hold_quit
)
2661 struct frame
*f
= XFRAME (tty
->top_frame
);
2662 struct input_event ie
;
2670 if (event
->type
& (GPM_MOVE
| GPM_DRAG
)) {
2671 previous_help_echo_string
= help_echo_string
;
2672 help_echo_string
= Qnil
;
2674 Gpm_DrawPointer (event
->x
, event
->y
, fileno (tty
->output
));
2676 if (!term_mouse_movement (f
, event
))
2677 help_echo_string
= previous_help_echo_string
;
2679 /* If the contents of the global variable help_echo_string
2680 has changed, generate a HELP_EVENT. */
2681 if (!NILP (help_echo_string
)
2682 || !NILP (previous_help_echo_string
))
2689 term_mouse_click (&ie
, event
, f
);
2693 if (ie
.kind
!= NO_EVENT
)
2695 kbd_buffer_store_event_hold (&ie
, hold_quit
);
2700 && !(hold_quit
&& hold_quit
->kind
!= NO_EVENT
))
2705 XSETFRAME (frame
, f
);
2709 gen_help_event (help_echo_string
, frame
, help_echo_window
,
2710 help_echo_object
, help_echo_pos
);
2717 DEFUN ("gpm-mouse-start", Fgpm_mouse_start
, Sgpm_mouse_start
,
2719 doc
: /* Open a connection to Gpm.
2720 Gpm-mouse can only be activated for one tty at a time. */)
2723 struct frame
*f
= SELECTED_FRAME ();
2724 struct tty_display_info
*tty
2725 = ((f
)->output_method
== output_termcap
2726 ? (f
)->terminal
->display_info
.tty
: NULL
);
2727 Gpm_Connect connection
;
2730 error ("Gpm-mouse only works in the GNU/Linux console");
2732 return Qnil
; /* Already activated, nothing to do. */
2734 error ("Gpm-mouse can only be activated for one tty at a time");
2736 connection
.eventMask
= ~0;
2737 connection
.defaultMask
= ~GPM_HARD
;
2738 connection
.maxMod
= ~0;
2739 connection
.minMod
= 0;
2742 if (Gpm_Open (&connection
, 0) < 0)
2743 error ("Gpm-mouse failed to connect to the gpm daemon");
2747 /* `init_sys_modes' arranges for mouse movements sent through gpm_fd
2748 to generate SIGIOs. Apparently we need to call reset_sys_modes
2749 before calling init_sys_modes. */
2750 reset_sys_modes (tty
);
2751 init_sys_modes (tty
);
2752 add_gpm_wait_descriptor (gpm_fd
);
2761 delete_gpm_wait_descriptor (fd
);
2762 while (Gpm_Close()); /* close all the stack */
2766 DEFUN ("gpm-mouse-stop", Fgpm_mouse_stop
, Sgpm_mouse_stop
,
2768 doc
: /* Close a connection to Gpm. */)
2771 struct frame
*f
= SELECTED_FRAME ();
2772 struct tty_display_info
*tty
2773 = ((f
)->output_method
== output_termcap
2774 ? (f
)->terminal
->display_info
.tty
: NULL
);
2776 if (!tty
|| gpm_tty
!= tty
)
2777 return Qnil
; /* Not activated on this terminal, nothing to do. */
2782 #endif /* HAVE_GPM */
2785 /***********************************************************************
2787 ***********************************************************************/
2789 #if defined (HAVE_MENUS) && !defined (MSDOS)
2791 /* TTY menu implementation and main ideas are borrowed from msdos.c.
2793 However, unlike on MSDOS, where the menu text is drawn directly to
2794 the display video memory, on a TTY we use display_string (see
2795 display_tty_menu_item in xdisp.c) to put the glyphs produced from
2796 the menu items directly into the frame's 'desired_matrix' glyph
2797 matrix, and then call update_frame_with_menu to deliver the results
2798 to the glass. The previous contents of the screen, in the form of
2799 the current_matrix, is stashed away, and used to restore screen
2800 contents when the menu selection changes or when the final
2801 selection is made and the menu should be popped down.
2803 The idea of this implementation was suggested by Gerd Moellmann. */
2805 #define TTYM_FAILURE -1
2806 #define TTYM_SUCCESS 1
2807 #define TTYM_NO_SELECT 2
2808 #define TTYM_IA_SELECT 3
2810 /* These hold text of the current and the previous menu help messages. */
2811 static const char *menu_help_message
, *prev_menu_help_message
;
2812 /* Pane number and item number of the menu item which generated the
2813 last menu help message. */
2814 static int menu_help_paneno
, menu_help_itemno
;
2816 static int menu_x
, menu_y
;
2818 typedef struct tty_menu_struct
2822 struct tty_menu_struct
**submenu
;
2823 int *panenumber
; /* Also used as enable. */
2827 const char **help_text
;
2830 /* Create a brand new menu structure. */
2833 tty_menu_create (void)
2837 menu
= (tty_menu
*) xmalloc (sizeof (tty_menu
));
2838 menu
->allocated
= menu
->count
= menu
->panecount
= menu
->width
= 0;
2842 /* Allocate some (more) memory for MENU ensuring that there is room for one
2846 tty_menu_make_room (tty_menu
*menu
)
2848 if (menu
->allocated
== 0)
2850 int count
= menu
->allocated
= 10;
2851 menu
->text
= (char **) xmalloc (count
* sizeof (char *));
2852 menu
->submenu
= (tty_menu
**) xmalloc (count
* sizeof (tty_menu
*));
2853 menu
->panenumber
= (int *) xmalloc (count
* sizeof (int));
2854 menu
->help_text
= (const char **) xmalloc (count
* sizeof (char *));
2856 else if (menu
->allocated
== menu
->count
)
2858 int count
= menu
->allocated
= menu
->allocated
+ 10;
2860 = (char **) xrealloc (menu
->text
, count
* sizeof (char *));
2862 = (tty_menu
**) xrealloc (menu
->submenu
, count
* sizeof (tty_menu
*));
2864 = (int *) xrealloc (menu
->panenumber
, count
* sizeof (int));
2866 = (const char **) xrealloc (menu
->help_text
, count
* sizeof (char *));
2870 /* Search the given menu structure for a given pane number. */
2873 tty_menu_search_pane (tty_menu
*menu
, int pane
)
2878 for (i
= 0; i
< menu
->count
; i
++)
2879 if (menu
->submenu
[i
])
2881 if (pane
== menu
->panenumber
[i
])
2882 return menu
->submenu
[i
];
2883 if ((try = tty_menu_search_pane (menu
->submenu
[i
], pane
)))
2886 return (tty_menu
*) 0;
2889 /* Determine how much screen space a given menu needs. */
2892 tty_menu_calc_size (tty_menu
*menu
, int *width
, int *height
)
2894 int i
, h2
, w2
, maxsubwidth
, maxheight
;
2897 maxheight
= menu
->count
;
2898 for (i
= 0; i
< menu
->count
; i
++)
2900 if (menu
->submenu
[i
])
2902 tty_menu_calc_size (menu
->submenu
[i
], &w2
, &h2
);
2903 if (w2
> maxsubwidth
) maxsubwidth
= w2
;
2904 if (i
+ h2
> maxheight
) maxheight
= i
+ h2
;
2907 *width
= menu
->width
+ maxsubwidth
;
2908 *height
= maxheight
;
2911 /* Display MENU at (X,Y) using FACES. */
2914 tty_menu_display (tty_menu
*menu
, int x
, int y
, int pn
, int *faces
,
2917 int i
, face
, width
, mx
= -1, my
= -1, enabled
, mousehere
, row
, col
;
2918 struct frame
*sf
= SELECTED_FRAME ();
2919 struct tty_display_info
*tty
= FRAME_TTY (sf
);
2920 #if defined (HAVE_MOUSE) || defined (HAVE_GPM)
2921 Lisp_Object lmx
, lmy
, lisp_dummy
;
2922 enum scroll_bar_part part_dummy
;
2925 if (FRAME_TERMINAL (sf
)->mouse_position_hook
)
2926 (*FRAME_TERMINAL (sf
)->mouse_position_hook
) (&sf
, -1,
2927 &lispy_dummy
, &party_dummy
,
2945 menu_help_message
= NULL
;
2947 width
= menu
->width
;
2948 col
= cursorX (tty
);
2949 row
= cursorY (tty
);
2951 IT_update_begin (sf
); /* FIXME: do we need an update_begin_hook? */
2953 for (i
= 0; i
< menu
->count
; i
++)
2955 int max_width
= width
+ 2; /* +2 for padding blanks on each side */
2957 cursor_to (sf
, y
+ i
, x
);
2958 if (menu
->submenu
[i
])
2959 max_width
+= 2; /* for displaying " >" after the item */
2961 = (!menu
->submenu
[i
] && menu
->panenumber
[i
]) || (menu
->submenu
[i
]);
2962 mousehere
= (y
+ i
== my
&& x
<= mx
&& mx
< x
+ max_width
);
2963 face
= faces
[enabled
+ mousehere
* 2];
2964 /* Display the menu help string for the i-th menu item even if
2965 the menu item is currently disabled. That's what the GUI
2967 if (disp_help
&& enabled
+ mousehere
* 2 >= 2)
2969 menu_help_message
= menu
->help_text
[i
];
2970 menu_help_paneno
= pn
- 1;
2971 menu_help_itemno
= i
;
2973 display_tty_menu_item (menu
->text
[i
], max_width
, face
, x
, y
+ i
,
2974 menu
->submenu
[i
] != NULL
);
2976 update_frame_with_menu (sf
);
2977 cursor_to (sf
, row
, col
);
2980 /* --------------------------- X Menu emulation ---------------------- */
2982 /* Report availability of menus. */
2985 have_menus_p (void) { return 1; }
2987 /* Create a new pane and place it on the outer-most level. */
2990 tty_menu_add_pane (tty_menu
*menu
, const char *txt
)
2995 tty_menu_make_room (menu
);
2996 menu
->submenu
[menu
->count
] = tty_menu_create ();
2997 menu
->text
[menu
->count
] = (char *)txt
;
2998 menu
->panenumber
[menu
->count
] = ++menu
->panecount
;
2999 menu
->help_text
[menu
->count
] = NULL
;
3002 /* Update the menu width, if necessary. */
3003 for (len
= 0, p
= txt
; *p
; )
3006 int ch
= STRING_CHAR_AND_LENGTH (p
, ch_len
);
3008 len
+= CHAR_WIDTH (ch
);
3012 if (len
> menu
->width
)
3015 return menu
->panecount
;
3018 /* Create a new item in a menu pane. */
3021 tty_menu_add_selection (tty_menu
*menu
, int pane
,
3022 char *txt
, int enable
, char const *help_text
)
3028 if (!(menu
= tty_menu_search_pane (menu
, pane
)))
3029 return TTYM_FAILURE
;
3030 tty_menu_make_room (menu
);
3031 menu
->submenu
[menu
->count
] = (tty_menu
*) 0;
3032 menu
->text
[menu
->count
] = txt
;
3033 menu
->panenumber
[menu
->count
] = enable
;
3034 menu
->help_text
[menu
->count
] = help_text
;
3037 /* Update the menu width, if necessary. */
3038 for (len
= 0, p
= txt
; *p
; )
3041 int ch
= STRING_CHAR_AND_LENGTH (p
, ch_len
);
3043 len
+= CHAR_WIDTH (ch
);
3047 if (len
> menu
->width
)
3050 return TTYM_SUCCESS
;
3053 /* Decide where the menu would be placed if requested at (X,Y). */
3056 tty_menu_locate (tty_menu
*menu
, int x
, int y
,
3057 int *ulx
, int *uly
, int *width
, int *height
)
3059 tty_menu_calc_size (menu
, width
, height
);
3065 struct tty_menu_state
3067 struct glyph_matrix
*screen_behind
;
3073 /* Restore the contents of frame F's desired frame matrix from SAVED,
3074 and free memory associated with SAVED. */
3077 restore_desired_matrix (struct frame
*f
, struct glyph_matrix
*saved
)
3081 for (i
= 0; i
< saved
->nrows
; ++i
)
3083 struct glyph_row
*from
= saved
->rows
+ i
;
3084 struct glyph_row
*to
= f
->desired_matrix
->rows
+ i
;
3085 ptrdiff_t nbytes
= from
->used
[TEXT_AREA
] * sizeof (struct glyph
);
3087 eassert (to
->glyphs
[TEXT_AREA
] != from
->glyphs
[TEXT_AREA
]);
3088 memcpy (to
->glyphs
[TEXT_AREA
], from
->glyphs
[TEXT_AREA
], nbytes
);
3089 to
->used
[TEXT_AREA
] = from
->used
[TEXT_AREA
];
3090 to
->enabled_p
= from
->enabled_p
;
3091 to
->hash
= from
->hash
;
3092 xfree (from
->glyphs
[TEXT_AREA
]);
3093 nbytes
= from
->used
[LEFT_MARGIN_AREA
] * sizeof (struct glyph
);
3096 eassert (to
->glyphs
[LEFT_MARGIN_AREA
] != from
->glyphs
[LEFT_MARGIN_AREA
]);
3097 memcpy (to
->glyphs
[LEFT_MARGIN_AREA
],
3098 from
->glyphs
[LEFT_MARGIN_AREA
], nbytes
);
3099 to
->used
[LEFT_MARGIN_AREA
] = from
->used
[LEFT_MARGIN_AREA
];
3100 xfree (from
->glyphs
[LEFT_MARGIN_AREA
]);
3103 to
->used
[LEFT_MARGIN_AREA
] = 0;
3104 nbytes
= from
->used
[RIGHT_MARGIN_AREA
] * sizeof (struct glyph
);
3107 eassert (to
->glyphs
[RIGHT_MARGIN_AREA
] != from
->glyphs
[RIGHT_MARGIN_AREA
]);
3108 memcpy (to
->glyphs
[RIGHT_MARGIN_AREA
],
3109 from
->glyphs
[RIGHT_MARGIN_AREA
], nbytes
);
3110 to
->used
[RIGHT_MARGIN_AREA
] = from
->used
[RIGHT_MARGIN_AREA
];
3111 xfree (from
->glyphs
[RIGHT_MARGIN_AREA
]);
3114 to
->used
[RIGHT_MARGIN_AREA
] = 0;
3117 xfree (saved
->rows
);
3122 free_saved_screen (struct glyph_matrix
*saved
)
3127 return; /* already freed */
3129 for (i
= 0; i
< saved
->nrows
; ++i
)
3131 struct glyph_row
*from
= saved
->rows
+ i
;
3133 xfree (from
->glyphs
[TEXT_AREA
]);
3134 if (from
->used
[LEFT_MARGIN_AREA
])
3135 xfree (from
->glyphs
[LEFT_MARGIN_AREA
]);
3136 if (from
->used
[RIGHT_MARGIN_AREA
])
3137 xfree (from
->glyphs
[RIGHT_MARGIN_AREA
]);
3140 xfree (saved
->rows
);
3144 /* Update the display of frame F from its saved contents. */
3146 screen_update (struct frame
*f
, struct glyph_matrix
*mtx
)
3148 restore_desired_matrix (f
, mtx
);
3149 update_frame_with_menu (f
);
3152 /* Read user input and return X and Y coordinates where that input
3153 puts us. We only consider mouse movement and click events and
3154 keyboard movement commands; the rest are ignored.
3156 Value is -1 if C-g was pressed, zero otherwise. */
3158 read_menu_input (struct frame
*sf
, int *x
, int *y
, bool *first_time
)
3164 *first_time
= false;
3165 /* FIXME: Following 2 or 3 lines are temporary! */
3168 sf
->mouse_moved
= 1;
3176 c
= read_char (-2, Qnil
, Qnil
, NULL
, NULL
);
3177 } while (BUFFERP (c
) || (INTEGERP (c
) && XINT (c
) == -2));
3182 int usable_input
= 1;
3184 /* FIXME: Exceedingly primitive! Can we support arrow keys? */
3185 switch (ch
&& ~CHAR_MODIFIER_MASK
)
3206 sf
->mouse_moved
= 1;
3210 else if (EVENT_HAS_PARAMETERS (c
))
3212 if (EQ (EVENT_HEAD (c
), Qmouse_movement
))
3215 else if (EQ (EVENT_HEAD_KIND (EVENT_HEAD (c
)), Qmouse_click
))
3220 int volatile dx
= 0;
3221 int volatile dy
= 0;
3222 int volatile st
= 0;
3226 if (dx
!= 0 || dy
!= 0)
3227 sf
->mouse_moved
= 1;
3238 static bool mouse_visible
;
3242 mouse_visible
= false;
3248 mouse_visible
= true;
3252 mouse_pressed (int b
, int *x
, int *y
)
3258 mouse_button_depressed (int b
, int *x
, int *y
)
3264 mouse_released (int b
, int *x
, int *y
)
3269 /* Display menu, wait for user's response, and return that response. */
3271 tty_menu_activate (tty_menu
*menu
, int *pane
, int *selidx
,
3272 int x0
, int y0
, char **txt
,
3273 void (*help_callback
)(char const *, int, int))
3275 struct tty_menu_state
*state
;
3276 int statecount
, x
, y
, i
, b
, leave
, result
, onepane
;
3277 int title_faces
[4]; /* face to display the menu title */
3278 int faces
[4], buffers_num_deleted
= 0;
3279 struct frame
*sf
= SELECTED_FRAME ();
3280 struct tty_display_info
*tty
= FRAME_TTY (sf
);
3282 Lisp_Object saved_echo_area_message
, selectface
;
3284 /* Don't allow non-positive x0 and y0, lest the menu will wrap
3285 around the display. */
3292 /* We will process all the mouse events directly. */
3296 state
= alloca (menu
->panecount
* sizeof (struct tty_menu_state
));
3297 memset (state
, 0, sizeof (*state
));
3299 = lookup_derived_face (sf
, intern ("tty-menu-disabled-face"),
3300 DEFAULT_FACE_ID
, 1);
3302 = lookup_derived_face (sf
, intern ("tty-menu-enabled-face"),
3303 DEFAULT_FACE_ID
, 1);
3304 selectface
= intern ("tty-menu-selected-face");
3305 faces
[2] = lookup_derived_face (sf
, selectface
,
3307 faces
[3] = lookup_derived_face (sf
, selectface
,
3310 /* Make sure the menu title is always displayed with
3311 `tty-menu-selected-face', no matter where the mouse pointer is. */
3312 for (i
= 0; i
< 4; i
++)
3313 title_faces
[i
] = faces
[3];
3317 /* Don't let the title for the "Buffers" popup menu include a
3318 digit (which is ugly).
3320 This is a terrible kludge, but I think the "Buffers" case is
3321 the only one where the title includes a number, so it doesn't
3322 seem to be necessary to make this more general. */
3323 if (strncmp (menu
->text
[0], "Buffers 1", 9) == 0)
3325 menu
->text
[0][7] = '\0';
3326 buffers_num_deleted
= 1;
3330 /* We need to save the current echo area message, so that we could
3331 restore it below, before we exit. See the commentary below,
3332 before the call to message_with_string. */
3333 saved_echo_area_message
= Fcurrent_message ();
3335 /* Force update of the current frame, so that the desired and the
3336 current matrices are identical. */
3337 update_frame_with_menu (sf
);
3338 state
[0].menu
= menu
;
3339 mouse_off (); /* FIXME */
3340 state
[0].screen_behind
= save_current_matrix (sf
);
3342 /* Turn off the cursor. Otherwise it shows through the menu
3343 panes, which is ugly. */
3344 tty_hide_cursor (tty
);
3346 /* Display the menu title. We subtract 1 from x0 and y0 because we
3347 want to interpret them as zero-based column and row coordinates,
3348 and also because we want the first item of the menu, not its
3349 title, to appear at x0,y0. */
3350 tty_menu_display (menu
, x0
- 1, y0
- 1, 1, title_faces
, 0);
3351 if (buffers_num_deleted
)
3352 menu
->text
[0][7] = ' ';
3353 if ((onepane
= menu
->count
== 1 && menu
->submenu
[0]))
3355 menu
->width
= menu
->submenu
[0]->width
;
3356 state
[0].menu
= menu
->submenu
[0];
3360 state
[0].menu
= menu
;
3362 state
[0].x
= x0
- 1;
3364 state
[0].pane
= onepane
;
3373 int mouse_button_count
= 3; /* FIXME */
3375 if (!mouse_visible
) mouse_on ();
3376 if (read_menu_input (sf
, &x
, &y
, &first_time
) == -1)
3378 else if (sf
->mouse_moved
)
3380 sf
->mouse_moved
= 0;
3381 result
= TTYM_IA_SELECT
;
3382 for (i
= 0; i
< statecount
; i
++)
3383 if (state
[i
].x
<= x
&& x
< state
[i
].x
+ state
[i
].menu
->width
+ 2)
3385 int dy
= y
- state
[i
].y
;
3386 if (0 <= dy
&& dy
< state
[i
].menu
->count
)
3388 if (!state
[i
].menu
->submenu
[dy
])
3390 if (state
[i
].menu
->panenumber
[dy
])
3391 result
= TTYM_SUCCESS
;
3393 result
= TTYM_IA_SELECT
;
3395 *pane
= state
[i
].pane
- 1;
3397 /* We hit some part of a menu, so drop extra menus that
3398 have been opened. That does not include an open and
3400 if (i
!= statecount
- 2
3401 || state
[i
].menu
->submenu
[dy
] != state
[i
+1].menu
)
3402 while (i
!= statecount
- 1)
3405 mouse_off (); /* FIXME */
3406 screen_update (sf
, state
[statecount
].screen_behind
);
3407 state
[statecount
].screen_behind
= NULL
;
3409 if (i
== statecount
- 1 && state
[i
].menu
->submenu
[dy
])
3411 tty_menu_display (state
[i
].menu
,
3416 state
[statecount
].menu
= state
[i
].menu
->submenu
[dy
];
3417 state
[statecount
].pane
= state
[i
].menu
->panenumber
[dy
];
3418 mouse_off (); /* FIXME */
3419 state
[statecount
].screen_behind
3420 = save_current_matrix (sf
);
3422 = state
[i
].x
+ state
[i
].menu
->width
+ 2;
3423 state
[statecount
].y
= y
;
3428 tty_menu_display (state
[statecount
- 1].menu
,
3429 state
[statecount
- 1].x
,
3430 state
[statecount
- 1].y
,
3431 state
[statecount
- 1].pane
,
3436 if ((menu_help_message
|| prev_menu_help_message
)
3437 && menu_help_message
!= prev_menu_help_message
)
3439 help_callback (menu_help_message
,
3440 menu_help_paneno
, menu_help_itemno
);
3441 tty_hide_cursor (tty
);
3442 prev_menu_help_message
= menu_help_message
;
3444 /* We are busy-waiting for the mouse to move, so let's be nice
3445 to other Windows applications by releasing our time slice. */
3446 Sleep (20); /* FIXME */
3448 for (b
= 0; b
< mouse_button_count
&& !leave
; b
++)
3450 /* Only leave if user both pressed and released the mouse, and in
3451 that order. This avoids popping down the menu pane unless
3452 the user is really done with it. */
3453 if (mouse_pressed (b
, &x
, &y
))
3455 while (mouse_button_depressed (b
, &x
, &y
))
3456 Sleep (20); /* FIXME */
3459 (void) mouse_released (b
, &x
, &y
);
3463 mouse_off (); /* FIXME */
3464 sf
->mouse_moved
= 0;
3465 /* FIXME: Since we set the fram's garbaged flag, do we need this
3466 call to screen_update? */
3467 screen_update (sf
, state
[0].screen_behind
);
3468 state
[0].screen_behind
= NULL
;
3470 /* We have a situation here. ScreenUpdate has just restored the
3471 screen contents as it was before we started drawing this menu.
3472 That includes any echo area message that could have been
3473 displayed back then. (In reality, that echo area message will
3474 almost always be the ``keystroke echo'' that echoes the sequence
3475 of menu items chosen by the user.) However, if the menu had some
3476 help messages, then displaying those messages caused Emacs to
3477 forget about the original echo area message. So when
3478 ScreenUpdate restored it, it created a discrepancy between the
3479 actual screen contents and what Emacs internal data structures
3482 To avoid this conflict, we force Emacs to restore the original
3483 echo area message as we found it when we entered this function.
3484 The irony of this is that we then erase the restored message
3485 right away, so the only purpose of restoring it is so that
3486 erasing it works correctly... */
3487 if (! NILP (saved_echo_area_message
))
3488 message_with_string ("%s", saved_echo_area_message
, 0);
3491 while (statecount
--)
3492 free_saved_screen (state
[statecount
].screen_behind
);
3493 tty_show_cursor (tty
); /* turn cursor back on */
3495 /* Clean up any mouse events that are waiting inside Emacs event queue.
3496 These events are likely to be generated before the menu was even
3497 displayed, probably because the user pressed and released the button
3498 (which invoked the menu) too quickly. If we don't remove these events,
3499 Emacs will process them after we return and surprise the user. */
3500 discard_mouse_events ();
3502 mouse_clear_clicks ();
3504 if (!kbd_buffer_events_waiting ())
3505 clear_input_pending ();
3507 /* Allow mouse events generation by dos_rawgetc. */
3510 SET_FRAME_GARBAGED (sf
);
3514 /* Dispose of a menu. */
3517 tty_menu_destroy (tty_menu
*menu
)
3520 if (menu
->allocated
)
3522 for (i
= 0; i
< menu
->count
; i
++)
3523 if (menu
->submenu
[i
])
3524 tty_menu_destroy (menu
->submenu
[i
]);
3526 xfree (menu
->submenu
);
3527 xfree (menu
->panenumber
);
3528 xfree (menu
->help_text
);
3531 menu_help_message
= prev_menu_help_message
= NULL
;
3534 static struct frame
*tty_menu_help_frame
;
3536 /* Show help HELP_STRING, or clear help if HELP_STRING is null.
3538 PANE is the pane number, and ITEM is the menu item number in
3539 the menu (currently not used).
3541 This cannot be done with generating a HELP_EVENT because
3542 XMenuActivate contains a loop that doesn't let Emacs process
3545 FIXME: Do we need this in TTY menus? */
3548 tty_menu_help_callback (char const *help_string
, int pane
, int item
)
3550 Lisp_Object
*first_item
;
3551 Lisp_Object pane_name
;
3552 Lisp_Object menu_object
;
3554 first_item
= XVECTOR (menu_items
)->contents
;
3555 if (EQ (first_item
[0], Qt
))
3556 pane_name
= first_item
[MENU_ITEMS_PANE_NAME
];
3557 else if (EQ (first_item
[0], Qquote
))
3558 /* This shouldn't happen, see xmenu_show. */
3559 pane_name
= empty_unibyte_string
;
3561 pane_name
= first_item
[MENU_ITEMS_ITEM_NAME
];
3563 /* (menu-item MENU-NAME PANE-NUMBER) */
3564 menu_object
= list3 (Qmenu_item
, pane_name
, make_number (pane
));
3565 show_help_echo (help_string
? build_string (help_string
) : Qnil
,
3566 Qnil
, menu_object
, make_number (item
));
3570 tty_pop_down_menu (Lisp_Object arg
)
3572 tty_menu
*menu
= XSAVE_POINTER (arg
, 0);
3575 tty_menu_destroy (menu
);
3580 tty_menu_show (struct frame
*f
, int x
, int y
, int for_click
, int keymaps
,
3581 Lisp_Object title
, const char **error_name
)
3584 int pane
, selidx
, lpane
, status
;
3585 Lisp_Object entry
, pane_prefix
;
3587 int ulx
, uly
, width
, height
;
3588 int dispwidth
, dispheight
;
3589 int i
, j
, lines
, maxlines
;
3592 unsigned int dummy_uint
;
3593 ptrdiff_t specpdl_count
= SPECPDL_INDEX ();
3595 if (! FRAME_TERMCAP_P (f
))
3599 if (menu_items_n_panes
== 0)
3602 if (menu_items_used
<= MENU_ITEMS_PANE_LENGTH
)
3604 *error_name
= "Empty menu";
3608 /* Make the menu on that window. */
3609 menu
= tty_menu_create ();
3612 *error_name
= "Can't create menu";
3616 /* Don't GC while we prepare and show the menu, because we give the
3617 menu functions pointers to the contents of strings. */
3618 inhibit_garbage_collection ();
3620 /* Adjust coordinates to be root-window-relative. */
3624 /* Create all the necessary panes and their items. */
3625 maxwidth
= maxlines
= lines
= i
= 0;
3626 lpane
= TTYM_FAILURE
;
3627 while (i
< menu_items_used
)
3629 if (EQ (AREF (menu_items
, i
), Qt
))
3631 /* Create a new pane. */
3632 Lisp_Object pane_name
, prefix
;
3633 const char *pane_string
;
3635 maxlines
= max (maxlines
, lines
);
3637 pane_name
= AREF (menu_items
, i
+ MENU_ITEMS_PANE_NAME
);
3638 prefix
= AREF (menu_items
, i
+ MENU_ITEMS_PANE_PREFIX
);
3639 pane_string
= (NILP (pane_name
)
3640 ? "" : SSDATA (pane_name
));
3641 if (keymaps
&& !NILP (prefix
))
3644 lpane
= tty_menu_add_pane (menu
, pane_string
);
3645 if (lpane
== TTYM_FAILURE
)
3647 tty_menu_destroy (menu
);
3648 *error_name
= "Can't create pane";
3651 i
+= MENU_ITEMS_PANE_LENGTH
;
3653 /* Find the width of the widest item in this pane. */
3655 while (j
< menu_items_used
)
3658 item
= AREF (menu_items
, j
);
3666 width
= SBYTES (item
);
3667 if (width
> maxwidth
)
3670 j
+= MENU_ITEMS_ITEM_LENGTH
;
3673 /* Ignore a nil in the item list.
3674 It's meaningful only for dialog boxes. */
3675 else if (EQ (AREF (menu_items
, i
), Qquote
))
3679 /* Create a new item within current pane. */
3680 Lisp_Object item_name
, enable
, descrip
, help
;
3682 char const *help_string
;
3684 item_name
= AREF (menu_items
, i
+ MENU_ITEMS_ITEM_NAME
);
3685 enable
= AREF (menu_items
, i
+ MENU_ITEMS_ITEM_ENABLE
);
3686 descrip
= AREF (menu_items
, i
+ MENU_ITEMS_ITEM_EQUIV_KEY
);
3687 help
= AREF (menu_items
, i
+ MENU_ITEMS_ITEM_HELP
);
3688 help_string
= STRINGP (help
) ? SSDATA (help
) : NULL
;
3690 if (!NILP (descrip
))
3692 /* if alloca is fast, use that to make the space,
3693 to reduce gc needs. */
3694 item_data
= (char *) alloca (maxwidth
+ SBYTES (descrip
) + 1);
3695 memcpy (item_data
, SSDATA (item_name
), SBYTES (item_name
));
3696 for (j
= SCHARS (item_name
); j
< maxwidth
; j
++)
3698 memcpy (item_data
+ j
, SSDATA (descrip
), SBYTES (descrip
));
3699 item_data
[j
+ SBYTES (descrip
)] = 0;
3702 item_data
= SSDATA (item_name
);
3704 if (lpane
== TTYM_FAILURE
3705 || (tty_menu_add_selection (menu
, lpane
, item_data
,
3706 !NILP (enable
), help_string
)
3709 tty_menu_destroy (menu
);
3710 *error_name
= "Can't add selection to menu";
3713 i
+= MENU_ITEMS_ITEM_LENGTH
;
3718 maxlines
= max (maxlines
, lines
);
3720 /* All set and ready to fly. */
3721 dispwidth
= f
->text_cols
;
3722 dispheight
= f
->text_lines
;
3723 x
= min (x
, dispwidth
);
3724 y
= min (y
, dispheight
);
3727 tty_menu_locate (menu
, x
, y
, &ulx
, &uly
, &width
, &height
);
3728 if (ulx
+width
> dispwidth
)
3730 x
-= (ulx
+ width
) - dispwidth
;
3731 ulx
= dispwidth
- width
;
3733 if (uly
+height
> dispheight
)
3735 y
-= (uly
+ height
) - dispheight
;
3736 uly
= dispheight
- height
;
3739 if (FRAME_HAS_MINIBUF_P (f
) && uly
+height
> dispheight
- 1)
3741 /* Move the menu away of the echo area, to avoid overwriting the
3742 menu with help echo messages or vice versa. */
3743 if (BUFFERP (echo_area_buffer
[0]) && WINDOWP (echo_area_window
))
3745 y
-= WINDOW_TOTAL_LINES (XWINDOW (echo_area_window
));
3746 uly
-= WINDOW_TOTAL_LINES (XWINDOW (echo_area_window
));
3755 if (ulx
< 0) x
-= ulx
;
3756 if (uly
< 0) y
-= uly
;
3759 /* This code doesn't make sense on a TTY, since it can easily annul
3760 the adjustments above that carefully avoid truncation of the menu
3764 /* If position was not given by a mouse click, adjust so upper left
3765 corner of the menu as a whole ends up at given coordinates. This
3766 is what x-popup-menu says in its documentation. */
3768 y
+= 1.5*height
/(maxlines
+2);
3774 record_unwind_protect (tty_pop_down_menu
, make_save_ptr (menu
));
3776 /* Help display under X won't work because XMenuActivate contains
3777 a loop that doesn't give Emacs a chance to process it. FIXME. */
3778 tty_menu_help_frame
= f
;
3779 status
= tty_menu_activate (menu
, &pane
, &selidx
, x
, y
, &datap
,
3780 tty_menu_help_callback
);
3781 entry
= pane_prefix
= Qnil
;
3786 /* Find the item number SELIDX in pane number PANE. */
3788 while (i
< menu_items_used
)
3790 if (EQ (AREF (menu_items
, i
), Qt
))
3794 = AREF (menu_items
, i
+ MENU_ITEMS_PANE_PREFIX
);
3796 i
+= MENU_ITEMS_PANE_LENGTH
;
3805 = AREF (menu_items
, i
+ MENU_ITEMS_ITEM_VALUE
);
3808 entry
= Fcons (entry
, Qnil
);
3809 if (!NILP (pane_prefix
))
3810 entry
= Fcons (pane_prefix
, entry
);
3816 i
+= MENU_ITEMS_ITEM_LENGTH
;
3822 *error_name
= "Can't activate menu";
3823 case TTYM_IA_SELECT
:
3825 case TTYM_NO_SELECT
:
3826 /* Make "Cancel" equivalent to C-g unless FOR_CLICK (which means
3827 the menu was invoked with a mouse event as POSITION). */
3829 Fsignal (Qquit
, Qnil
);
3833 unbind_to (specpdl_count
, Qnil
);
3838 #endif /* HAVE_MENUS && !MSDOS */
3842 /***********************************************************************
3844 ***********************************************************************/
3846 /* Initialize the tty-dependent part of frame F. The frame must
3847 already have its device initialized. */
3850 create_tty_output (struct frame
*f
)
3852 struct tty_output
*t
= xzalloc (sizeof *t
);
3854 eassert (FRAME_TERMCAP_P (f
));
3856 t
->display_info
= FRAME_TERMINAL (f
)->display_info
.tty
;
3858 f
->output_data
.tty
= t
;
3861 /* Delete frame F's face cache, and its tty-dependent part. */
3864 tty_free_frame_resources (struct frame
*f
)
3866 eassert (FRAME_TERMCAP_P (f
));
3868 if (FRAME_FACE_CACHE (f
))
3869 free_frame_faces (f
);
3871 xfree (f
->output_data
.tty
);
3876 /* Delete frame F's face cache. */
3879 tty_free_frame_resources (struct frame
*f
)
3881 eassert (FRAME_TERMCAP_P (f
) || FRAME_MSDOS_P (f
));
3883 if (FRAME_FACE_CACHE (f
))
3884 free_frame_faces (f
);
3888 /* Reset the hooks in TERMINAL. */
3891 clear_tty_hooks (struct terminal
*terminal
)
3894 terminal
->cursor_to_hook
= 0;
3895 terminal
->raw_cursor_to_hook
= 0;
3896 terminal
->clear_to_end_hook
= 0;
3897 terminal
->clear_frame_hook
= 0;
3898 terminal
->clear_end_of_line_hook
= 0;
3899 terminal
->ins_del_lines_hook
= 0;
3900 terminal
->insert_glyphs_hook
= 0;
3901 terminal
->write_glyphs_hook
= 0;
3902 terminal
->delete_glyphs_hook
= 0;
3903 terminal
->ring_bell_hook
= 0;
3904 terminal
->reset_terminal_modes_hook
= 0;
3905 terminal
->set_terminal_modes_hook
= 0;
3906 terminal
->update_begin_hook
= 0;
3907 terminal
->update_end_hook
= 0;
3908 terminal
->set_terminal_window_hook
= 0;
3909 terminal
->mouse_position_hook
= 0;
3910 terminal
->frame_rehighlight_hook
= 0;
3911 terminal
->frame_raise_lower_hook
= 0;
3912 terminal
->fullscreen_hook
= 0;
3913 terminal
->set_vertical_scroll_bar_hook
= 0;
3914 terminal
->condemn_scroll_bars_hook
= 0;
3915 terminal
->redeem_scroll_bar_hook
= 0;
3916 terminal
->judge_scroll_bars_hook
= 0;
3917 terminal
->read_socket_hook
= 0;
3918 terminal
->frame_up_to_date_hook
= 0;
3920 /* Leave these two set, or suspended frames are not deleted
3922 terminal
->delete_frame_hook
= &tty_free_frame_resources
;
3923 terminal
->delete_terminal_hook
= &delete_tty
;
3926 /* Initialize hooks in TERMINAL with the values needed for a tty. */
3929 set_tty_hooks (struct terminal
*terminal
)
3931 terminal
->rif
= 0; /* ttys don't support window-based redisplay. */
3933 terminal
->cursor_to_hook
= &tty_cursor_to
;
3934 terminal
->raw_cursor_to_hook
= &tty_raw_cursor_to
;
3936 terminal
->clear_to_end_hook
= &tty_clear_to_end
;
3937 terminal
->clear_frame_hook
= &tty_clear_frame
;
3938 terminal
->clear_end_of_line_hook
= &tty_clear_end_of_line
;
3940 terminal
->ins_del_lines_hook
= &tty_ins_del_lines
;
3942 terminal
->insert_glyphs_hook
= &tty_insert_glyphs
;
3943 terminal
->write_glyphs_hook
= &tty_write_glyphs
;
3944 terminal
->delete_glyphs_hook
= &tty_delete_glyphs
;
3946 terminal
->ring_bell_hook
= &tty_ring_bell
;
3948 terminal
->reset_terminal_modes_hook
= &tty_reset_terminal_modes
;
3949 terminal
->set_terminal_modes_hook
= &tty_set_terminal_modes
;
3950 terminal
->update_begin_hook
= 0; /* Not needed. */
3951 terminal
->update_end_hook
= &tty_update_end
;
3952 terminal
->set_terminal_window_hook
= &tty_set_terminal_window
;
3954 terminal
->mouse_position_hook
= 0; /* Not needed. */
3955 terminal
->frame_rehighlight_hook
= 0; /* Not needed. */
3956 terminal
->frame_raise_lower_hook
= 0; /* Not needed. */
3958 terminal
->set_vertical_scroll_bar_hook
= 0; /* Not needed. */
3959 terminal
->condemn_scroll_bars_hook
= 0; /* Not needed. */
3960 terminal
->redeem_scroll_bar_hook
= 0; /* Not needed. */
3961 terminal
->judge_scroll_bars_hook
= 0; /* Not needed. */
3963 terminal
->read_socket_hook
= &tty_read_avail_input
; /* keyboard.c */
3964 terminal
->frame_up_to_date_hook
= 0; /* Not needed. */
3966 terminal
->delete_frame_hook
= &tty_free_frame_resources
;
3967 terminal
->delete_terminal_hook
= &delete_tty
;
3970 /* If FD is the controlling terminal, drop it. */
3972 dissociate_if_controlling_tty (int fd
)
3974 /* If tcgetpgrp succeeds, fd is the controlling terminal,
3975 so dissociate it by invoking setsid. */
3976 if (tcgetpgrp (fd
) >= 0 && setsid () < 0)
3979 /* setsid failed, presumably because Emacs is already a process
3980 group leader. Fall back on the obsolescent way to dissociate
3981 a controlling tty. */
3982 block_tty_out_signal ();
3983 ioctl (fd
, TIOCNOTTY
, 0);
3984 unblock_tty_out_signal ();
3989 /* Create a termcap display on the tty device with the given name and
3992 If NAME is NULL, then use the controlling tty, i.e., "/dev/tty".
3993 Otherwise NAME should be a path to the tty device file,
3996 TERMINAL_TYPE is the termcap type of the device, e.g. "vt100".
3998 If MUST_SUCCEED is true, then all errors are fatal. */
4001 init_tty (const char *name
, const char *terminal_type
, bool must_succeed
)
4007 char **address
= &area
;
4010 struct tty_display_info
*tty
= NULL
;
4011 struct terminal
*terminal
= NULL
;
4012 bool ctty
= false; /* True if asked to open controlling tty. */
4015 maybe_fatal (must_succeed
, 0,
4016 "Unknown terminal type",
4017 "Unknown terminal type");
4021 if (!strcmp (name
, DEV_TTY
))
4024 /* If we already have a terminal on the given device, use that. If
4025 all such terminals are suspended, create a new one instead. */
4026 /* XXX Perhaps this should be made explicit by having init_tty
4027 always create a new terminal and separating terminal and frame
4028 creation on Lisp level. */
4029 terminal
= get_named_tty (name
);
4033 terminal
= create_terminal ();
4036 maybe_fatal (0, 0, "Attempt to create another terminal %s", "",
4039 tty
= &the_only_display_info
;
4041 tty
= xzalloc (sizeof *tty
);
4043 tty
->top_frame
= Qnil
;
4044 tty
->next
= tty_list
;
4047 terminal
->type
= output_termcap
;
4048 terminal
->display_info
.tty
= tty
;
4049 tty
->terminal
= terminal
;
4051 tty
->Wcm
= xmalloc (sizeof *tty
->Wcm
);
4054 encode_terminal_src_size
= 0;
4055 encode_terminal_dst_size
= 0;
4059 set_tty_hooks (terminal
);
4062 /* Open the terminal device. */
4064 /* If !ctty, don't recognize it as our controlling terminal, and
4065 don't make it the controlling tty if we don't have one now.
4067 Alas, O_IGNORE_CTTY is a GNU extension that seems to be only
4068 defined on Hurd. On other systems, we need to explicitly
4069 dissociate ourselves from the controlling tty when we want to
4070 open a frame on the same terminal. */
4071 int flags
= O_RDWR
| O_NOCTTY
| (ctty
? 0 : O_IGNORE_CTTY
);
4072 int fd
= emacs_open (name
, flags
, 0);
4073 tty
->input
= tty
->output
= fd
< 0 || ! isatty (fd
) ? 0 : fdopen (fd
, "w+");
4077 char const *diagnostic
4078 = tty
->input
? "Not a tty device: %s" : "Could not open file: %s";
4080 maybe_fatal (must_succeed
, terminal
, diagnostic
, diagnostic
, name
);
4083 tty
->name
= xstrdup (name
);
4084 terminal
->name
= xstrdup (name
);
4086 if (!O_IGNORE_CTTY
&& !ctty
)
4087 dissociate_if_controlling_tty (fd
);
4090 tty
->type
= xstrdup (terminal_type
);
4092 add_keyboard_wait_descriptor (fileno (tty
->input
));
4096 /* On some systems, tgetent tries to access the controlling
4098 block_tty_out_signal ();
4100 status
= tgetent (0, terminal_type
);
4102 status
= tgetent (tty
->termcap_term_buffer
, terminal_type
);
4103 if (tty
->termcap_term_buffer
[TERMCAP_BUFFER_SIZE
- 1])
4106 unblock_tty_out_signal ();
4111 maybe_fatal (must_succeed
, terminal
,
4112 "Cannot open terminfo database file",
4113 "Cannot open terminfo database file");
4115 maybe_fatal (must_succeed
, terminal
,
4116 "Cannot open termcap database file",
4117 "Cannot open termcap database file");
4122 maybe_fatal (must_succeed
, terminal
,
4123 "Terminal type %s is not defined",
4124 "Terminal type %s is not defined.\n\
4125 If that is not the actual type of terminal you have,\n\
4126 use the Bourne shell command `TERM=... export TERM' (C-shell:\n\
4127 `setenv TERM ...') to specify the correct type. It may be necessary\n"
4129 "to do `unset TERMINFO' (C-shell: `unsetenv TERMINFO') as well.",
4131 "to do `unset TERMCAP' (C-shell: `unsetenv TERMCAP') as well.",
4137 area
= tty
->termcap_strings_buffer
;
4139 tty
->TS_ins_line
= tgetstr ("al", address
);
4140 tty
->TS_ins_multi_lines
= tgetstr ("AL", address
);
4141 tty
->TS_bell
= tgetstr ("bl", address
);
4142 BackTab (tty
) = tgetstr ("bt", address
);
4143 tty
->TS_clr_to_bottom
= tgetstr ("cd", address
);
4144 tty
->TS_clr_line
= tgetstr ("ce", address
);
4145 tty
->TS_clr_frame
= tgetstr ("cl", address
);
4146 ColPosition (tty
) = NULL
; /* tgetstr ("ch", address); */
4147 AbsPosition (tty
) = tgetstr ("cm", address
);
4148 CR (tty
) = tgetstr ("cr", address
);
4149 tty
->TS_set_scroll_region
= tgetstr ("cs", address
);
4150 tty
->TS_set_scroll_region_1
= tgetstr ("cS", address
);
4151 RowPosition (tty
) = tgetstr ("cv", address
);
4152 tty
->TS_del_char
= tgetstr ("dc", address
);
4153 tty
->TS_del_multi_chars
= tgetstr ("DC", address
);
4154 tty
->TS_del_line
= tgetstr ("dl", address
);
4155 tty
->TS_del_multi_lines
= tgetstr ("DL", address
);
4156 tty
->TS_delete_mode
= tgetstr ("dm", address
);
4157 tty
->TS_end_delete_mode
= tgetstr ("ed", address
);
4158 tty
->TS_end_insert_mode
= tgetstr ("ei", address
);
4159 Home (tty
) = tgetstr ("ho", address
);
4160 tty
->TS_ins_char
= tgetstr ("ic", address
);
4161 tty
->TS_ins_multi_chars
= tgetstr ("IC", address
);
4162 tty
->TS_insert_mode
= tgetstr ("im", address
);
4163 tty
->TS_pad_inserted_char
= tgetstr ("ip", address
);
4164 tty
->TS_end_keypad_mode
= tgetstr ("ke", address
);
4165 tty
->TS_keypad_mode
= tgetstr ("ks", address
);
4166 LastLine (tty
) = tgetstr ("ll", address
);
4167 Right (tty
) = tgetstr ("nd", address
);
4168 Down (tty
) = tgetstr ("do", address
);
4170 Down (tty
) = tgetstr ("nl", address
); /* Obsolete name for "do". */
4171 if (tgetflag ("bs"))
4172 Left (tty
) = "\b"; /* Can't possibly be longer! */
4173 else /* (Actually, "bs" is obsolete...) */
4174 Left (tty
) = tgetstr ("le", address
);
4176 Left (tty
) = tgetstr ("bc", address
); /* Obsolete name for "le". */
4177 tty
->TS_pad_char
= tgetstr ("pc", address
);
4178 tty
->TS_repeat
= tgetstr ("rp", address
);
4179 tty
->TS_end_standout_mode
= tgetstr ("se", address
);
4180 tty
->TS_fwd_scroll
= tgetstr ("sf", address
);
4181 tty
->TS_standout_mode
= tgetstr ("so", address
);
4182 tty
->TS_rev_scroll
= tgetstr ("sr", address
);
4183 tty
->Wcm
->cm_tab
= tgetstr ("ta", address
);
4184 tty
->TS_end_termcap_modes
= tgetstr ("te", address
);
4185 tty
->TS_termcap_modes
= tgetstr ("ti", address
);
4186 Up (tty
) = tgetstr ("up", address
);
4187 tty
->TS_visible_bell
= tgetstr ("vb", address
);
4188 tty
->TS_cursor_normal
= tgetstr ("ve", address
);
4189 tty
->TS_cursor_visible
= tgetstr ("vs", address
);
4190 tty
->TS_cursor_invisible
= tgetstr ("vi", address
);
4191 tty
->TS_set_window
= tgetstr ("wi", address
);
4193 tty
->TS_enter_underline_mode
= tgetstr ("us", address
);
4194 tty
->TS_exit_underline_mode
= tgetstr ("ue", address
);
4195 tty
->TS_enter_bold_mode
= tgetstr ("md", address
);
4196 tty
->TS_enter_italic_mode
= tgetstr ("ZH", address
);
4197 tty
->TS_enter_dim_mode
= tgetstr ("mh", address
);
4198 tty
->TS_enter_reverse_mode
= tgetstr ("mr", address
);
4199 tty
->TS_enter_alt_charset_mode
= tgetstr ("as", address
);
4200 tty
->TS_exit_alt_charset_mode
= tgetstr ("ae", address
);
4201 tty
->TS_exit_attribute_mode
= tgetstr ("me", address
);
4203 MultiUp (tty
) = tgetstr ("UP", address
);
4204 MultiDown (tty
) = tgetstr ("DO", address
);
4205 MultiLeft (tty
) = tgetstr ("LE", address
);
4206 MultiRight (tty
) = tgetstr ("RI", address
);
4208 /* SVr4/ANSI color support. If "op" isn't available, don't support
4209 color because we can't switch back to the default foreground and
4211 tty
->TS_orig_pair
= tgetstr ("op", address
);
4212 if (tty
->TS_orig_pair
)
4214 tty
->TS_set_foreground
= tgetstr ("AF", address
);
4215 tty
->TS_set_background
= tgetstr ("AB", address
);
4216 if (!tty
->TS_set_foreground
)
4219 tty
->TS_set_foreground
= tgetstr ("Sf", address
);
4220 tty
->TS_set_background
= tgetstr ("Sb", address
);
4223 tty
->TN_max_colors
= tgetnum ("Co");
4224 tty
->TN_max_pairs
= tgetnum ("pa");
4226 tty
->TN_no_color_video
= tgetnum ("NC");
4227 if (tty
->TN_no_color_video
== -1)
4228 tty
->TN_no_color_video
= 0;
4231 tty_default_color_capabilities (tty
, 1);
4233 MagicWrap (tty
) = tgetflag ("xn");
4234 /* Since we make MagicWrap terminals look like AutoWrap, we need to have
4235 the former flag imply the latter. */
4236 AutoWrap (tty
) = MagicWrap (tty
) || tgetflag ("am");
4237 terminal
->memory_below_frame
= tgetflag ("db");
4238 tty
->TF_hazeltine
= tgetflag ("hz");
4239 terminal
->must_write_spaces
= tgetflag ("in");
4240 tty
->meta_key
= tgetflag ("km") || tgetflag ("MT");
4241 tty
->TF_insmode_motion
= tgetflag ("mi");
4242 tty
->TF_standout_motion
= tgetflag ("ms");
4243 tty
->TF_underscore
= tgetflag ("ul");
4244 tty
->TF_teleray
= tgetflag ("xt");
4249 struct frame
*f
= XFRAME (selected_frame
);
4252 initialize_w32_display (terminal
, &width
, &height
);
4254 FrameRows (tty
) = height
;
4255 FrameCols (tty
) = width
;
4256 tty
->specified_window
= height
;
4258 FRAME_VERTICAL_SCROLL_BAR_TYPE (f
) = vertical_scroll_bar_none
;
4259 terminal
->char_ins_del_ok
= 1;
4265 if (strcmp (terminal_type
, "internal") == 0)
4266 terminal
->type
= output_msdos_raw
;
4267 initialize_msdos_display (terminal
);
4269 get_tty_size (fileno (tty
->input
), &width
, &height
);
4270 FrameCols (tty
) = width
;
4271 FrameRows (tty
) = height
;
4272 terminal
->char_ins_del_ok
= 0;
4273 init_baud_rate (fileno (tty
->input
));
4276 tty
->output
= stdout
;
4278 /* The following two are inaccessible from w32console.c. */
4279 terminal
->delete_frame_hook
= &tty_free_frame_resources
;
4280 terminal
->delete_terminal_hook
= &delete_tty
;
4282 tty
->name
= xstrdup (name
);
4283 terminal
->name
= xstrdup (name
);
4284 tty
->type
= xstrdup (terminal_type
);
4286 add_keyboard_wait_descriptor (0);
4288 tty
->delete_in_insert_mode
= 1;
4291 terminal
->scroll_region_ok
= 0;
4293 /* Seems to insert lines when it's not supposed to, messing up the
4294 display. In doing a trace, it didn't seem to be called much, so I
4295 don't think we're losing anything by turning it off. */
4296 terminal
->line_ins_del_ok
= 0;
4298 tty
->TN_max_colors
= 16; /* Must be non-zero for tty-display-color-p. */
4302 terminal
->mouse_position_hook
= term_mouse_position
;
4303 tty
->mouse_highlight
.mouse_face_window
= Qnil
;
4306 terminal
->kboard
= xmalloc (sizeof *terminal
->kboard
);
4307 init_kboard (terminal
->kboard
);
4308 kset_window_system (terminal
->kboard
, Qnil
);
4309 terminal
->kboard
->next_kboard
= all_kboards
;
4310 all_kboards
= terminal
->kboard
;
4311 terminal
->kboard
->reference_count
++;
4312 /* Don't let the initial kboard remain current longer than necessary.
4313 That would cause problems if a file loaded on startup tries to
4314 prompt in the mini-buffer. */
4315 if (current_kboard
== initial_kboard
)
4316 current_kboard
= terminal
->kboard
;
4318 term_get_fkeys (address
, terminal
->kboard
);
4320 /* Get frame size from system, or else from termcap. */
4323 get_tty_size (fileno (tty
->input
), &width
, &height
);
4324 FrameCols (tty
) = width
;
4325 FrameRows (tty
) = height
;
4328 if (FrameCols (tty
) <= 0)
4329 FrameCols (tty
) = tgetnum ("co");
4330 if (FrameRows (tty
) <= 0)
4331 FrameRows (tty
) = tgetnum ("li");
4333 if (FrameRows (tty
) < 3 || FrameCols (tty
) < 3)
4334 maybe_fatal (must_succeed
, terminal
,
4335 "Screen size %dx%d is too small",
4336 "Screen size %dx%d is too small",
4337 FrameCols (tty
), FrameRows (tty
));
4339 TabWidth (tty
) = tgetnum ("tw");
4342 tty
->TS_bell
= "\07";
4344 if (!tty
->TS_fwd_scroll
)
4345 tty
->TS_fwd_scroll
= Down (tty
);
4347 PC
= tty
->TS_pad_char
? *tty
->TS_pad_char
: 0;
4349 if (TabWidth (tty
) < 0)
4352 /* Turned off since /etc/termcap seems to have :ta= for most terminals
4353 and newer termcap doc does not seem to say there is a default.
4354 if (!tty->Wcm->cm_tab)
4355 tty->Wcm->cm_tab = "\t";
4358 /* We don't support standout modes that use `magic cookies', so
4359 turn off any that do. */
4360 if (tty
->TS_standout_mode
&& tgetnum ("sg") >= 0)
4362 tty
->TS_standout_mode
= 0;
4363 tty
->TS_end_standout_mode
= 0;
4365 if (tty
->TS_enter_underline_mode
&& tgetnum ("ug") >= 0)
4367 tty
->TS_enter_underline_mode
= 0;
4368 tty
->TS_exit_underline_mode
= 0;
4371 /* If there's no standout mode, try to use underlining instead. */
4372 if (tty
->TS_standout_mode
== 0)
4374 tty
->TS_standout_mode
= tty
->TS_enter_underline_mode
;
4375 tty
->TS_end_standout_mode
= tty
->TS_exit_underline_mode
;
4378 /* If no `se' string, try using a `me' string instead.
4379 If that fails, we can't use standout mode at all. */
4380 if (tty
->TS_end_standout_mode
== 0)
4382 char *s
= tgetstr ("me", address
);
4384 tty
->TS_end_standout_mode
= s
;
4386 tty
->TS_standout_mode
= 0;
4389 if (tty
->TF_teleray
)
4391 tty
->Wcm
->cm_tab
= 0;
4392 /* We can't support standout mode, because it uses magic cookies. */
4393 tty
->TS_standout_mode
= 0;
4394 /* But that means we cannot rely on ^M to go to column zero! */
4396 /* LF can't be trusted either -- can alter hpos. */
4397 /* If move at column 0 thru a line with TS_standout_mode. */
4401 tty
->specified_window
= FrameRows (tty
);
4403 if (Wcm_init (tty
) == -1) /* Can't do cursor motion. */
4405 maybe_fatal (must_succeed
, terminal
,
4406 "Terminal type \"%s\" is not powerful enough to run Emacs",
4407 "Terminal type \"%s\" is not powerful enough to run Emacs.\n\
4408 It lacks the ability to position the cursor.\n\
4409 If that is not the actual type of terminal you have,\n\
4410 use the Bourne shell command `TERM=... export TERM' (C-shell:\n\
4411 `setenv TERM ...') to specify the correct type. It may be necessary\n"
4413 "to do `unset TERMINFO' (C-shell: `unsetenv TERMINFO') as well.",
4414 # else /* TERMCAP */
4415 "to do `unset TERMCAP' (C-shell: `unsetenv TERMCAP') as well.",
4416 # endif /* TERMINFO */
4420 if (FrameRows (tty
) <= 0 || FrameCols (tty
) <= 0)
4421 maybe_fatal (must_succeed
, terminal
,
4422 "Could not determine the frame size",
4423 "Could not determine the frame size");
4425 tty
->delete_in_insert_mode
4426 = tty
->TS_delete_mode
&& tty
->TS_insert_mode
4427 && !strcmp (tty
->TS_delete_mode
, tty
->TS_insert_mode
);
4429 UseTabs (tty
) = tabs_safe_p (fileno (tty
->input
)) && TabWidth (tty
) == 8;
4431 terminal
->scroll_region_ok
4433 && (tty
->TS_set_window
|| tty
->TS_set_scroll_region
|| tty
->TS_set_scroll_region_1
));
4435 terminal
->line_ins_del_ok
4436 = (((tty
->TS_ins_line
|| tty
->TS_ins_multi_lines
)
4437 && (tty
->TS_del_line
|| tty
->TS_del_multi_lines
))
4438 || (terminal
->scroll_region_ok
4439 && tty
->TS_fwd_scroll
&& tty
->TS_rev_scroll
));
4441 terminal
->char_ins_del_ok
4442 = ((tty
->TS_ins_char
|| tty
->TS_insert_mode
4443 || tty
->TS_pad_inserted_char
|| tty
->TS_ins_multi_chars
)
4444 && (tty
->TS_del_char
|| tty
->TS_del_multi_chars
));
4446 terminal
->fast_clear_end_of_line
= tty
->TS_clr_line
!= 0;
4448 init_baud_rate (fileno (tty
->input
));
4450 #endif /* not DOS_NT */
4452 /* Init system terminal modes (RAW or CBREAK, etc.). */
4453 init_sys_modes (tty
);
4460 vfatal (const char *str
, va_list ap
)
4462 fprintf (stderr
, "emacs: ");
4463 vfprintf (stderr
, str
, ap
);
4464 if (!(strlen (str
) > 0 && str
[strlen (str
) - 1] == '\n'))
4465 fprintf (stderr
, "\n");
4471 /* Auxiliary error-handling function for init_tty.
4472 Delete TERMINAL, then call error or fatal with str1 or str2,
4473 respectively, according to whether MUST_SUCCEED is true. */
4476 maybe_fatal (bool must_succeed
, struct terminal
*terminal
,
4477 const char *str1
, const char *str2
, ...)
4480 va_start (ap
, str2
);
4482 delete_tty (terminal
);
4491 fatal (const char *str
, ...)
4500 /* Delete the given tty terminal, closing all frames on it. */
4503 delete_tty (struct terminal
*terminal
)
4505 struct tty_display_info
*tty
;
4507 /* Protect against recursive calls. delete_frame in
4508 delete_terminal calls us back when it deletes our last frame. */
4509 if (!terminal
->name
)
4512 eassert (terminal
->type
== output_termcap
);
4514 tty
= terminal
->display_info
.tty
;
4516 if (tty
== tty_list
)
4517 tty_list
= tty
->next
;
4520 struct tty_display_info
*p
;
4521 for (p
= tty_list
; p
&& p
->next
!= tty
; p
= p
->next
)
4525 /* This should not happen. */
4528 p
->next
= tty
->next
;
4532 /* reset_sys_modes needs a valid device, so this call needs to be
4533 before delete_terminal. */
4534 reset_sys_modes (tty
);
4536 delete_terminal (terminal
);
4543 delete_keyboard_wait_descriptor (fileno (tty
->input
));
4544 if (tty
->input
!= stdin
)
4545 fclose (tty
->input
);
4547 if (tty
->output
&& tty
->output
!= stdout
&& tty
->output
!= tty
->input
)
4548 fclose (tty
->output
);
4549 if (tty
->termscript
)
4550 fclose (tty
->termscript
);
4552 xfree (tty
->old_tty
);
4560 DEFVAR_BOOL ("system-uses-terminfo", system_uses_terminfo
,
4561 doc
: /* Non-nil means the system uses terminfo rather than termcap.
4562 This variable can be used by terminal emulator packages. */);
4564 system_uses_terminfo
= 1;
4566 system_uses_terminfo
= 0;
4569 DEFVAR_LISP ("suspend-tty-functions", Vsuspend_tty_functions
,
4570 doc
: /* Functions run after suspending a tty.
4571 The functions are run with one argument, the terminal object to be suspended.
4572 See `suspend-tty'. */);
4573 Vsuspend_tty_functions
= Qnil
;
4576 DEFVAR_LISP ("resume-tty-functions", Vresume_tty_functions
,
4577 doc
: /* Functions run after resuming a tty.
4578 The functions are run with one argument, the terminal object that was revived.
4579 See `resume-tty'. */);
4580 Vresume_tty_functions
= Qnil
;
4582 DEFVAR_BOOL ("visible-cursor", visible_cursor
,
4583 doc
: /* Non-nil means to make the cursor very visible.
4584 This only has an effect when running in a text terminal.
4585 What means \"very visible\" is up to your terminal. It may make the cursor
4586 bigger, or it may make it blink, or it may do nothing at all. */);
4589 defsubr (&Stty_display_color_p
);
4590 defsubr (&Stty_display_color_cells
);
4591 defsubr (&Stty_no_underline
);
4592 defsubr (&Stty_type
);
4593 defsubr (&Scontrolling_tty_p
);
4594 defsubr (&Stty_top_frame
);
4595 defsubr (&Ssuspend_tty
);
4596 defsubr (&Sresume_tty
);
4598 defsubr (&Sgpm_mouse_start
);
4599 defsubr (&Sgpm_mouse_stop
);
4600 #endif /* HAVE_GPM */
4603 default_orig_pair
= NULL
;
4604 default_set_foreground
= NULL
;
4605 default_set_background
= NULL
;
4606 #endif /* !DOS_NT */
4608 encode_terminal_src
= NULL
;
4609 encode_terminal_dst
= NULL
;