… | |
… | |
35 | |
35 | |
36 | <li><a href="#rendering__font___look_and_feel_issues">Rendering, Font & Look and Feel Issues</a></li> |
36 | <li><a href="#rendering__font___look_and_feel_issues">Rendering, Font & Look and Feel Issues</a></li> |
37 | <ul> |
37 | <ul> |
38 | |
38 | |
39 | <li><a href="#i_can_t_get_transparency_working__what_am_i_doing_wrong">I can't get transparency working, what am I doing wrong?</a></li> |
39 | <li><a href="#i_can_t_get_transparency_working__what_am_i_doing_wrong">I can't get transparency working, what am I doing wrong?</a></li> |
40 | <li><a href="#why_do_some_chinese_characters_look_so_different_than_others">Why do some chinese characters look so different than others?</a></li> |
|
|
41 | <li><a href="#why_does_rxvtunicode_sometimes_leave_pixel_droppings">Why does rxvt-unicode sometimes leave pixel droppings?</a></li> |
40 | <li><a href="#why_does_rxvtunicode_sometimes_leave_pixel_droppings">Why does rxvt-unicode sometimes leave pixel droppings?</a></li> |
42 | <li><a href="#how_can_i_keep_rxvtunicode_from_using_reverse_video_so_much">How can I keep rxvt-unicode from using reverse video so much?</a></li> |
41 | <li><a href="#how_can_i_keep_rxvtunicode_from_using_reverse_video_so_much">How can I keep rxvt-unicode from using reverse video so much?</a></li> |
43 | <li><a href="#some_programs_assume_totally_weird_colours__red_instead_of_blue___how_can_i_fix_that">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></li> |
42 | <li><a href="#some_programs_assume_totally_weird_colours__red_instead_of_blue___how_can_i_fix_that">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></li> |
44 | <li><a href="#can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></li> |
43 | <li><a href="#can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></li> |
45 | <li><a href="#why_do_italic_characters_look_as_if_clipped">Why do italic characters look as if clipped?</a></li> |
44 | <li><a href="#why_do_italic_characters_look_as_if_clipped">Why do italic characters look as if clipped?</a></li> |
46 | <li><a href="#can_i_speed_up_xft_rendering_somehow">Can I speed up Xft rendering somehow?</a></li> |
45 | <li><a href="#can_i_speed_up_xft_rendering_somehow">Can I speed up Xft rendering somehow?</a></li> |
47 | <li><a href="#rxvtunicode_doesn_t_seem_to_antialias_its_fonts__what_is_wrong">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></li> |
46 | <li><a href="#rxvtunicode_doesn_t_seem_to_antialias_its_fonts__what_is_wrong">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></li> |
48 | <li><a href="#what_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></li> |
47 | <li><a href="#what_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></li> |
49 | <li><a href="#i_don_t_like_the_screen_colors__how_do_i_change_them">I don't like the screen colors. How do I change them?</a></li> |
48 | <li><a href="#i_don_t_like_the_screen_colors__how_do_i_change_them">I don't like the screen colors. How do I change them?</a></li> |
50 | <li><a href="#why_do_some_characters_look_so_much_different_than_others">Why do some characters look so much different than others?</a></li> |
49 | <li><a href="#why_do_some_characters_look_so_much_different_than_others">Why do some characters look so much different than others?</a></li> |
|
|
50 | <li><a href="#how_does_rxvtunicode_choose_fonts">How does rxvt-unicode choose fonts?</a></li> |
|
|
51 | <li><a href="#why_do_some_chinese_characters_look_so_different_than_others">Why do some chinese characters look so different than others?</a></li> |
51 | </ul> |
52 | </ul> |
52 | |
53 | |
53 | <li><a href="#keyboard__mouse___user_interaction">Keyboard, Mouse & User Interaction</a></li> |
54 | <li><a href="#keyboard__mouse___user_interaction">Keyboard, Mouse & User Interaction</a></li> |
54 | <ul> |
55 | <ul> |
55 | |
56 | |
… | |
… | |
105 | </ul> |
106 | </ul> |
106 | |
107 | |
107 | </ul> |
108 | </ul> |
108 | |
109 | |
109 | <li><a href="#rxvtunicode_technical_reference">RXVT-UNICODE TECHNICAL REFERENCE</a></li> |
110 | <li><a href="#rxvtunicode_technical_reference">RXVT-UNICODE TECHNICAL REFERENCE</a></li> |
110 | <li><a href="#description">DESCRIPTION</a></li> |
111 | <ul> |
|
|
112 | |
111 | <li><a href="#definitions">Definitions</a></li> |
113 | <li><a href="#definitions">Definitions</a></li> |
112 | <li><a href="#values">Values</a></li> |
114 | <li><a href="#values">Values</a></li> |
113 | <li><a href="#escape_sequences">Escape Sequences</a></li> |
115 | <li><a href="#escape_sequences">Escape Sequences</a></li> |
114 | <li><a href="#csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></li> |
116 | <li><a href="#csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></li> |
115 | <li><a href="#dec_private_modes">DEC Private Modes</a></li> |
117 | <li><a href="#dec_private_modes">DEC Private Modes</a></li> |
116 | <li><a href="#xterm_operating_system_commands">XTerm Operating System Commands</a></li> |
118 | <li><a href="#xterm_operating_system_commands">XTerm Operating System Commands</a></li> |
|
|
119 | </ul> |
|
|
120 | |
117 | <li><a href="#xpm">XPM</a></li> |
121 | <li><a href="#xpm">XPM</a></li> |
118 | <li><a href="#mouse_reporting">Mouse Reporting</a></li> |
122 | <li><a href="#mouse_reporting">Mouse Reporting</a></li> |
119 | <li><a href="#key_codes">Key Codes</a></li> |
123 | <li><a href="#key_codes">Key Codes</a></li> |
120 | <li><a href="#configure_options">CONFIGURE OPTIONS</a></li> |
124 | <li><a href="#configure_options">CONFIGURE OPTIONS</a></li> |
121 | <li><a href="#authors">AUTHORS</a></li> |
125 | <li><a href="#authors">AUTHORS</a></li> |
… | |
… | |
348 | <p>Then click on a window you want to make transparent. Replace <code>0xc0000000</code> |
352 | <p>Then click on a window you want to make transparent. Replace <code>0xc0000000</code> |
349 | by other values to change the degree of opacity. If it doesn't work and |
353 | by other values to change the degree of opacity. If it doesn't work and |
350 | your server crashes, you got to keep the pieces.</p> |
354 | your server crashes, you got to keep the pieces.</p> |
351 | <p> |
355 | <p> |
352 | </p> |
356 | </p> |
|
|
357 | <h3><a name="why_does_rxvtunicode_sometimes_leave_pixel_droppings">Why does rxvt-unicode sometimes leave pixel droppings?</a></h3> |
|
|
358 | <p>Most fonts were not designed for terminal use, which means that character |
|
|
359 | size varies a lot. A font that is otherwise fine for terminal use might |
|
|
360 | contain some characters that are simply too wide. Rxvt-unicode will avoid |
|
|
361 | these characters. For characters that are just ``a bit'' too wide a special |
|
|
362 | ``careful'' rendering mode is used that redraws adjacent characters.</p> |
|
|
363 | <p>All of this requires that fonts do not lie about character sizes, |
|
|
364 | however: Xft fonts often draw glyphs larger than their acclaimed bounding |
|
|
365 | box, and rxvt-unicode has no way of detecting this (the correct way is to |
|
|
366 | ask for the character bounding box, which unfortunately is wrong in these |
|
|
367 | cases).</p> |
|
|
368 | <p>It's not clear (to me at least), wether this is a bug in Xft, freetype, |
|
|
369 | or the respective font. If you encounter this problem you might try using |
|
|
370 | the <code>-lsp</code> option to give the font more height. If that doesn't work, you |
|
|
371 | might be forced to use a different font.</p> |
|
|
372 | <p>All of this is not a problem when using X11 core fonts, as their bounding |
|
|
373 | box data is correct.</p> |
|
|
374 | <p> |
|
|
375 | </p> |
|
|
376 | <h3><a name="how_can_i_keep_rxvtunicode_from_using_reverse_video_so_much">How can I keep rxvt-unicode from using reverse video so much?</a></h3> |
|
|
377 | <p>First of all, make sure you are running with the right terminal settings |
|
|
378 | (<code>TERM=rxvt-unicode</code>), which will get rid of most of these effects. Then |
|
|
379 | make sure you have specified colours for italic and bold, as otherwise |
|
|
380 | rxvt-unicode might use reverse video to simulate the effect:</p> |
|
|
381 | <pre> |
|
|
382 | URxvt.colorBD: white |
|
|
383 | URxvt.colorIT: green</pre> |
|
|
384 | <p> |
|
|
385 | </p> |
|
|
386 | <h3><a name="some_programs_assume_totally_weird_colours__red_instead_of_blue___how_can_i_fix_that">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></h3> |
|
|
387 | <p>For some unexplainable reason, some rare programs assume a very weird |
|
|
388 | colour palette when confronted with a terminal with more than the standard |
|
|
389 | 8 colours (rxvt-unicode supports 88). The right fix is, of course, to fix |
|
|
390 | these programs not to assume non-ISO colours without very good reasons.</p> |
|
|
391 | <p>In the meantime, you can either edit your <code>rxvt-unicode</code> terminfo |
|
|
392 | definition to only claim 8 colour support or use <code>TERM=rxvt</code>, which will |
|
|
393 | fix colours but keep you from using other rxvt-unicode features.</p> |
|
|
394 | <p> |
|
|
395 | </p> |
|
|
396 | <h3><a name="can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></h3> |
|
|
397 | <p>Yes, using an escape sequence. Try something like this, which has the same |
|
|
398 | effect as using the <code>-fn</code> switch, and takes effect immediately:</p> |
|
|
399 | <pre> |
|
|
400 | printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic"</pre> |
|
|
401 | <p>This is useful if you e.g. work primarily with japanese (and prefer a |
|
|
402 | japanese font), but you have to switch to chinese temporarily, where |
|
|
403 | japanese fonts would only be in your way.</p> |
|
|
404 | <p>You can think of this as a kind of manual ISO-2022 switching.</p> |
|
|
405 | <p> |
|
|
406 | </p> |
|
|
407 | <h3><a name="why_do_italic_characters_look_as_if_clipped">Why do italic characters look as if clipped?</a></h3> |
|
|
408 | <p>Many fonts have difficulties with italic characters and hinting. For |
|
|
409 | example, the otherwise very nicely hinted font <code>xft:Bitstream Vera Sans |
|
|
410 | Mono</code> completely fails in it's italic face. A workaround might be to |
|
|
411 | enable freetype autohinting, i.e. like this:</p> |
|
|
412 | <pre> |
|
|
413 | URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true |
|
|
414 | URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true</pre> |
|
|
415 | <p> |
|
|
416 | </p> |
|
|
417 | <h3><a name="can_i_speed_up_xft_rendering_somehow">Can I speed up Xft rendering somehow?</a></h3> |
|
|
418 | <p>Yes, the most obvious way to speed it up is to avoid Xft entirely, as |
|
|
419 | it is simply slow. If you still want Xft fonts you might try to disable |
|
|
420 | antialiasing (by appending <code>:antialias=false</code>), which saves lots of |
|
|
421 | memory and also speeds up rendering considerably.</p> |
|
|
422 | <p> |
|
|
423 | </p> |
|
|
424 | <h3><a name="rxvtunicode_doesn_t_seem_to_antialias_its_fonts__what_is_wrong">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></h3> |
|
|
425 | <p>Rxvt-unicode will use whatever you specify as a font. If it needs to |
|
|
426 | fall back to it's default font search list it will prefer X11 core |
|
|
427 | fonts, because they are small and fast, and then use Xft fonts. It has |
|
|
428 | antialiasing disabled for most of them, because the author thinks they |
|
|
429 | look best that way.</p> |
|
|
430 | <p>If you want antialiasing, you have to specify the fonts manually.</p> |
|
|
431 | <p> |
|
|
432 | </p> |
|
|
433 | <h3><a name="what_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></h3> |
|
|
434 | <p>If no bold colour is set via <code>colorBD:</code>, bold will invert text using the |
|
|
435 | standard foreground colour.</p> |
|
|
436 | <p>For the standard background colour, blinking will actually make the |
|
|
437 | text blink when compiled with <code>--enable-blinking</code>. with standard |
|
|
438 | colours. Without <code>--enable-blinking</code>, the blink attribute will be |
|
|
439 | ignored.</p> |
|
|
440 | <p>On ANSI colours, bold/blink attributes are used to set high-intensity |
|
|
441 | foreground/background colors.</p> |
|
|
442 | <p>color0-7 are the low-intensity colors.</p> |
|
|
443 | <p>color8-15 are the corresponding high-intensity colors.</p> |
|
|
444 | <p> |
|
|
445 | </p> |
|
|
446 | <h3><a name="i_don_t_like_the_screen_colors__how_do_i_change_them">I don't like the screen colors. How do I change them?</a></h3> |
|
|
447 | <p>You can change the screen colors at run-time using <em>~/.Xdefaults</em> |
|
|
448 | resources (or as long-options).</p> |
|
|
449 | <p>Here are values that are supposed to resemble a VGA screen, |
|
|
450 | including the murky brown that passes for low-intensity yellow:</p> |
|
|
451 | <pre> |
|
|
452 | URxvt.color0: #000000 |
|
|
453 | URxvt.color1: #A80000 |
|
|
454 | URxvt.color2: #00A800 |
|
|
455 | URxvt.color3: #A8A800 |
|
|
456 | URxvt.color4: #0000A8 |
|
|
457 | URxvt.color5: #A800A8 |
|
|
458 | URxvt.color6: #00A8A8 |
|
|
459 | URxvt.color7: #A8A8A8</pre> |
|
|
460 | <pre> |
|
|
461 | URxvt.color8: #000054 |
|
|
462 | URxvt.color9: #FF0054 |
|
|
463 | URxvt.color10: #00FF54 |
|
|
464 | URxvt.color11: #FFFF54 |
|
|
465 | URxvt.color12: #0000FF |
|
|
466 | URxvt.color13: #FF00FF |
|
|
467 | URxvt.color14: #00FFFF |
|
|
468 | URxvt.color15: #FFFFFF</pre> |
|
|
469 | <p>And here is a more complete set of non-standard colors.</p> |
|
|
470 | <pre> |
|
|
471 | URxvt.cursorColor: #dc74d1 |
|
|
472 | URxvt.pointerColor: #dc74d1 |
|
|
473 | URxvt.background: #0e0e0e |
|
|
474 | URxvt.foreground: #4ad5e1 |
|
|
475 | URxvt.color0: #000000 |
|
|
476 | URxvt.color8: #8b8f93 |
|
|
477 | URxvt.color1: #dc74d1 |
|
|
478 | URxvt.color9: #dc74d1 |
|
|
479 | URxvt.color2: #0eb8c7 |
|
|
480 | URxvt.color10: #0eb8c7 |
|
|
481 | URxvt.color3: #dfe37e |
|
|
482 | URxvt.color11: #dfe37e |
|
|
483 | URxvt.color5: #9e88f0 |
|
|
484 | URxvt.color13: #9e88f0 |
|
|
485 | URxvt.color6: #73f7ff |
|
|
486 | URxvt.color14: #73f7ff |
|
|
487 | URxvt.color7: #e1dddd |
|
|
488 | URxvt.color15: #e1dddd</pre> |
|
|
489 | <p>They have been described (not by me) as ``pretty girly''.</p> |
|
|
490 | <p> |
|
|
491 | </p> |
|
|
492 | <h3><a name="why_do_some_characters_look_so_much_different_than_others">Why do some characters look so much different than others?</a></h3> |
|
|
493 | <p>See next entry.</p> |
|
|
494 | <p> |
|
|
495 | </p> |
|
|
496 | <h3><a name="how_does_rxvtunicode_choose_fonts">How does rxvt-unicode choose fonts?</a></h3> |
|
|
497 | <p>Most fonts do not contain the full range of Unicode, which is |
|
|
498 | fine. Chances are that the font you (or the admin/package maintainer of |
|
|
499 | your system/os) have specified does not cover all the characters you want |
|
|
500 | to display.</p> |
|
|
501 | <p><strong>rxvt-unicode</strong> makes a best-effort try at finding a replacement |
|
|
502 | font. Often the result is fine, but sometimes the chosen font looks |
|
|
503 | bad/ugly/wrong. Some fonts have totally strange characters that don't |
|
|
504 | resemble the correct glyph at all, and rxvt-unicode lacks the artificial |
|
|
505 | intelligence to detect that a specific glyph is wrong: it has to believe |
|
|
506 | the font that the characters it claims to contain indeed look correct.</p> |
|
|
507 | <p>In that case, select a font of your taste and add it to the font list, |
|
|
508 | e.g.:</p> |
|
|
509 | <pre> |
|
|
510 | urxvt -fn basefont,font2,font3...</pre> |
|
|
511 | <p>When rxvt-unicode sees a character, it will first look at the base |
|
|
512 | font. If the base font does not contain the character, it will go to the |
|
|
513 | next font, and so on. Specifying your own fonts will also speed up this |
|
|
514 | search and use less resources within rxvt-unicode and the X-server.</p> |
|
|
515 | <p>The only limitation is that none of the fonts may be larger than the base |
|
|
516 | font, as the base font defines the terminal character cell size, which |
|
|
517 | must be the same due to the way terminals work.</p> |
|
|
518 | <p> |
|
|
519 | </p> |
353 | <h3><a name="why_do_some_chinese_characters_look_so_different_than_others">Why do some chinese characters look so different than others?</a></h3> |
520 | <h3><a name="why_do_some_chinese_characters_look_so_different_than_others">Why do some chinese characters look so different than others?</a></h3> |
354 | <p>This is because there is a difference between script and language -- |
521 | <p>This is because there is a difference between script and language -- |
355 | rxvt-unicode does not know which language the text that is output is, |
522 | rxvt-unicode does not know which language the text that is output is, |
356 | as it only knows the unicode character codes. If rxvt-unicode first |
523 | as it only knows the unicode character codes. If rxvt-unicode first |
357 | sees a japanese/chinese character, it might choose a japanese font for |
524 | sees a japanese/chinese character, it might choose a japanese font for |
… | |
… | |
367 | <p>In the future it might be possible to switch language preferences at |
534 | <p>In the future it might be possible to switch language preferences at |
368 | runtime (the internal data structure has no problem with using different |
535 | runtime (the internal data structure has no problem with using different |
369 | fonts for the same character at the same time, but no interface for this |
536 | fonts for the same character at the same time, but no interface for this |
370 | has been designed yet).</p> |
537 | has been designed yet).</p> |
371 | <p>Until then, you might get away with switching fonts at runtime (see <a href="#can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a> later in this document).</p> |
538 | <p>Until then, you might get away with switching fonts at runtime (see <a href="#can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a> later in this document).</p> |
372 | <p> |
|
|
373 | </p> |
|
|
374 | <h3><a name="why_does_rxvtunicode_sometimes_leave_pixel_droppings">Why does rxvt-unicode sometimes leave pixel droppings?</a></h3> |
|
|
375 | <p>Most fonts were not designed for terminal use, which means that character |
|
|
376 | size varies a lot. A font that is otherwise fine for terminal use might |
|
|
377 | contain some characters that are simply too wide. Rxvt-unicode will avoid |
|
|
378 | these characters. For characters that are just ``a bit'' too wide a special |
|
|
379 | ``careful'' rendering mode is used that redraws adjacent characters.</p> |
|
|
380 | <p>All of this requires that fonts do not lie about character sizes, |
|
|
381 | however: Xft fonts often draw glyphs larger than their acclaimed bounding |
|
|
382 | box, and rxvt-unicode has no way of detecting this (the correct way is to |
|
|
383 | ask for the character bounding box, which unfortunately is wrong in these |
|
|
384 | cases).</p> |
|
|
385 | <p>It's not clear (to me at least), wether this is a bug in Xft, freetype, |
|
|
386 | or the respective font. If you encounter this problem you might try using |
|
|
387 | the <code>-lsp</code> option to give the font more height. If that doesn't work, you |
|
|
388 | might be forced to use a different font.</p> |
|
|
389 | <p>All of this is not a problem when using X11 core fonts, as their bounding |
|
|
390 | box data is correct.</p> |
|
|
391 | <p> |
|
|
392 | </p> |
|
|
393 | <h3><a name="how_can_i_keep_rxvtunicode_from_using_reverse_video_so_much">How can I keep rxvt-unicode from using reverse video so much?</a></h3> |
|
|
394 | <p>First of all, make sure you are running with the right terminal settings |
|
|
395 | (<code>TERM=rxvt-unicode</code>), which will get rid of most of these effects. Then |
|
|
396 | make sure you have specified colours for italic and bold, as otherwise |
|
|
397 | rxvt-unicode might use reverse video to simulate the effect:</p> |
|
|
398 | <pre> |
|
|
399 | URxvt.colorBD: white |
|
|
400 | URxvt.colorIT: green</pre> |
|
|
401 | <p> |
|
|
402 | </p> |
|
|
403 | <h3><a name="some_programs_assume_totally_weird_colours__red_instead_of_blue___how_can_i_fix_that">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></h3> |
|
|
404 | <p>For some unexplainable reason, some rare programs assume a very weird |
|
|
405 | colour palette when confronted with a terminal with more than the standard |
|
|
406 | 8 colours (rxvt-unicode supports 88). The right fix is, of course, to fix |
|
|
407 | these programs not to assume non-ISO colours without very good reasons.</p> |
|
|
408 | <p>In the meantime, you can either edit your <code>rxvt-unicode</code> terminfo |
|
|
409 | definition to only claim 8 colour support or use <code>TERM=rxvt</code>, which will |
|
|
410 | fix colours but keep you from using other rxvt-unicode features.</p> |
|
|
411 | <p> |
|
|
412 | </p> |
|
|
413 | <h3><a name="can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></h3> |
|
|
414 | <p>Yes, using an escape sequence. Try something like this, which has the same |
|
|
415 | effect as using the <code>-fn</code> switch, and takes effect immediately:</p> |
|
|
416 | <pre> |
|
|
417 | printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic"</pre> |
|
|
418 | <p>This is useful if you e.g. work primarily with japanese (and prefer a |
|
|
419 | japanese font), but you have to switch to chinese temporarily, where |
|
|
420 | japanese fonts would only be in your way.</p> |
|
|
421 | <p>You can think of this as a kind of manual ISO-2022 switching.</p> |
|
|
422 | <p> |
|
|
423 | </p> |
|
|
424 | <h3><a name="why_do_italic_characters_look_as_if_clipped">Why do italic characters look as if clipped?</a></h3> |
|
|
425 | <p>Many fonts have difficulties with italic characters and hinting. For |
|
|
426 | example, the otherwise very nicely hinted font <code>xft:Bitstream Vera Sans |
|
|
427 | Mono</code> completely fails in it's italic face. A workaround might be to |
|
|
428 | enable freetype autohinting, i.e. like this:</p> |
|
|
429 | <pre> |
|
|
430 | URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true |
|
|
431 | URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true</pre> |
|
|
432 | <p> |
|
|
433 | </p> |
|
|
434 | <h3><a name="can_i_speed_up_xft_rendering_somehow">Can I speed up Xft rendering somehow?</a></h3> |
|
|
435 | <p>Yes, the most obvious way to speed it up is to avoid Xft entirely, as |
|
|
436 | it is simply slow. If you still want Xft fonts you might try to disable |
|
|
437 | antialiasing (by appending <code>:antialias=false</code>), which saves lots of |
|
|
438 | memory and also speeds up rendering considerably.</p> |
|
|
439 | <p> |
|
|
440 | </p> |
|
|
441 | <h3><a name="rxvtunicode_doesn_t_seem_to_antialias_its_fonts__what_is_wrong">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></h3> |
|
|
442 | <p>Rxvt-unicode will use whatever you specify as a font. If it needs to |
|
|
443 | fall back to it's default font search list it will prefer X11 core |
|
|
444 | fonts, because they are small and fast, and then use Xft fonts. It has |
|
|
445 | antialiasing disabled for most of them, because the author thinks they |
|
|
446 | look best that way.</p> |
|
|
447 | <p>If you want antialiasing, you have to specify the fonts manually.</p> |
|
|
448 | <p> |
|
|
449 | </p> |
|
|
450 | <h3><a name="what_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></h3> |
|
|
451 | <p>If no bold colour is set via <code>colorBD:</code>, bold will invert text using the |
|
|
452 | standard foreground colour.</p> |
|
|
453 | <p>For the standard background colour, blinking will actually make the |
|
|
454 | text blink when compiled with <code>--enable-blinking</code>. with standard |
|
|
455 | colours. Without <code>--enable-blinking</code>, the blink attribute will be |
|
|
456 | ignored.</p> |
|
|
457 | <p>On ANSI colours, bold/blink attributes are used to set high-intensity |
|
|
458 | foreground/background colors.</p> |
|
|
459 | <p>color0-7 are the low-intensity colors.</p> |
|
|
460 | <p>color8-15 are the corresponding high-intensity colors.</p> |
|
|
461 | <p> |
|
|
462 | </p> |
|
|
463 | <h3><a name="i_don_t_like_the_screen_colors__how_do_i_change_them">I don't like the screen colors. How do I change them?</a></h3> |
|
|
464 | <p>You can change the screen colors at run-time using <em>~/.Xdefaults</em> |
|
|
465 | resources (or as long-options).</p> |
|
|
466 | <p>Here are values that are supposed to resemble a VGA screen, |
|
|
467 | including the murky brown that passes for low-intensity yellow:</p> |
|
|
468 | <pre> |
|
|
469 | URxvt.color0: #000000 |
|
|
470 | URxvt.color1: #A80000 |
|
|
471 | URxvt.color2: #00A800 |
|
|
472 | URxvt.color3: #A8A800 |
|
|
473 | URxvt.color4: #0000A8 |
|
|
474 | URxvt.color5: #A800A8 |
|
|
475 | URxvt.color6: #00A8A8 |
|
|
476 | URxvt.color7: #A8A8A8</pre> |
|
|
477 | <pre> |
|
|
478 | URxvt.color8: #000054 |
|
|
479 | URxvt.color9: #FF0054 |
|
|
480 | URxvt.color10: #00FF54 |
|
|
481 | URxvt.color11: #FFFF54 |
|
|
482 | URxvt.color12: #0000FF |
|
|
483 | URxvt.color13: #FF00FF |
|
|
484 | URxvt.color14: #00FFFF |
|
|
485 | URxvt.color15: #FFFFFF</pre> |
|
|
486 | <p>And here is a more complete set of non-standard colors.</p> |
|
|
487 | <pre> |
|
|
488 | URxvt.cursorColor: #dc74d1 |
|
|
489 | URxvt.pointerColor: #dc74d1 |
|
|
490 | URxvt.background: #0e0e0e |
|
|
491 | URxvt.foreground: #4ad5e1 |
|
|
492 | URxvt.color0: #000000 |
|
|
493 | URxvt.color8: #8b8f93 |
|
|
494 | URxvt.color1: #dc74d1 |
|
|
495 | URxvt.color9: #dc74d1 |
|
|
496 | URxvt.color2: #0eb8c7 |
|
|
497 | URxvt.color10: #0eb8c7 |
|
|
498 | URxvt.color3: #dfe37e |
|
|
499 | URxvt.color11: #dfe37e |
|
|
500 | URxvt.color5: #9e88f0 |
|
|
501 | URxvt.color13: #9e88f0 |
|
|
502 | URxvt.color6: #73f7ff |
|
|
503 | URxvt.color14: #73f7ff |
|
|
504 | URxvt.color7: #e1dddd |
|
|
505 | URxvt.color15: #e1dddd</pre> |
|
|
506 | <p>They have been described (not by me) as ``pretty girly''.</p> |
|
|
507 | <p> |
|
|
508 | </p> |
|
|
509 | <h3><a name="why_do_some_characters_look_so_much_different_than_others">Why do some characters look so much different than others?</a></h3> |
|
|
510 | <pre> |
|
|
511 | |
|
|
512 | See next entry.</pre> |
|
|
513 | <pre> |
|
|
514 | |
|
|
515 | =head3 How does rxvt-unicode choose fonts?</pre> |
|
|
516 | <pre> |
|
|
517 | |
|
|
518 | Most fonts do not contain the full range of Unicode, which is |
|
|
519 | fine. Chances are that the font you (or the admin/package maintainer of |
|
|
520 | your system/os) have specified does not cover all the characters you want |
|
|
521 | to display.</pre> |
|
|
522 | <pre> |
|
|
523 | |
|
|
524 | B<rxvt-unicode> makes a best-effort try at finding a replacement |
|
|
525 | font. Often the result is fine, but sometimes the chosen font looks |
|
|
526 | bad/ugly/wrong. Some fonts have totally strange characters that don't |
|
|
527 | resemble the correct glyph at all, and rxvt-unicode lacks the artificial |
|
|
528 | intelligence to detect that a specific glyph is wrong: it has to believe |
|
|
529 | the font that the characters it claims to contain indeed look correct.</pre> |
|
|
530 | <pre> |
|
|
531 | |
|
|
532 | In that case, select a font of your taste and add it to the font list, |
|
|
533 | e.g.:</pre> |
|
|
534 | <pre> |
|
|
535 | |
|
|
536 | urxvt -fn basefont,font2,font3...</pre> |
|
|
537 | <pre> |
|
|
538 | |
|
|
539 | When rxvt-unicode sees a character, it will first look at the base |
|
|
540 | font. If the base font does not contain the character, it will go to the |
|
|
541 | next font, and so on. Specifying your own fonts will also speed up this |
|
|
542 | search and use less resources within rxvt-unicode and the X-server.</pre> |
|
|
543 | <pre> |
|
|
544 | |
|
|
545 | The only limitation is that none of the fonts may be larger than the base |
|
|
546 | font, as the base font defines the terminal character cell size, which |
|
|
547 | must be the same due to the way terminals work.</pre> |
|
|
548 | <p> |
539 | <p> |
549 | </p> |
540 | </p> |
550 | <h2><a name="keyboard__mouse___user_interaction">Keyboard, Mouse & User Interaction</a></h2> |
541 | <h2><a name="keyboard__mouse___user_interaction">Keyboard, Mouse & User Interaction</a></h2> |
551 | <p> |
542 | <p> |
552 | </p> |
543 | </p> |
… | |
… | |
1049 | to 8-bit encodings.</p> |
1040 | to 8-bit encodings.</p> |
1050 | <p> |
1041 | <p> |
1051 | </p> |
1042 | </p> |
1052 | <hr /> |
1043 | <hr /> |
1053 | <h1><a name="rxvtunicode_technical_reference">RXVT-UNICODE TECHNICAL REFERENCE</a></h1> |
1044 | <h1><a name="rxvtunicode_technical_reference">RXVT-UNICODE TECHNICAL REFERENCE</a></h1> |
1054 | <p> |
|
|
1055 | </p> |
|
|
1056 | <hr /> |
|
|
1057 | <h1><a name="description">DESCRIPTION</a></h1> |
|
|
1058 | <p>The rest of this document describes various technical aspects of |
1045 | <p>The rest of this document describes various technical aspects of |
1059 | <strong>rxvt-unicode</strong>. First the description of supported command sequences, |
1046 | <strong>rxvt-unicode</strong>. First the description of supported command sequences, |
1060 | followed by pixmap support and last by a description of all features |
1047 | followed by pixmap support and last by a description of all features |
1061 | selectable at <code>configure</code> time.</p> |
1048 | selectable at <code>configure</code> time.</p> |
1062 | <p> |
1049 | <p> |
1063 | </p> |
1050 | </p> |
1064 | <hr /> |
|
|
1065 | <h1><a name="definitions">Definitions</a></h1> |
1051 | <h2><a name="definitions">Definitions</a></h2> |
1066 | <dl> |
1052 | <dl> |
1067 | <dt><strong><a name="item_c"><strong><code>c</code> </strong>></a></strong><br /> |
1053 | <dt><strong><a name="item_c"><strong><code>c</code> </strong>></a></strong><br /> |
1068 | </dt> |
1054 | </dt> |
1069 | <dd> |
1055 | <dd> |
1070 | The literal character c. |
1056 | The literal character c. |
… | |
… | |
1096 | A text parameter composed of printable characters. |
1082 | A text parameter composed of printable characters. |
1097 | </dd> |
1083 | </dd> |
1098 | <p></p></dl> |
1084 | <p></p></dl> |
1099 | <p> |
1085 | <p> |
1100 | </p> |
1086 | </p> |
1101 | <hr /> |
|
|
1102 | <h1><a name="values">Values</a></h1> |
1087 | <h2><a name="values">Values</a></h2> |
1103 | <dl> |
1088 | <dl> |
1104 | <dt><strong><a name="item_enq"><strong><code>ENQ</code> </strong>></a></strong><br /> |
1089 | <dt><strong><a name="item_enq"><strong><code>ENQ</code> </strong>></a></strong><br /> |
1105 | </dt> |
1090 | </dt> |
1106 | <dd> |
1091 | <dd> |
1107 | Enquiry (Ctrl-E) = Send Device Attributes (DA) |
1092 | Enquiry (Ctrl-E) = Send Device Attributes (DA) |
… | |
… | |
1170 | Space Character |
1155 | Space Character |
1171 | </dd> |
1156 | </dd> |
1172 | <p></p></dl> |
1157 | <p></p></dl> |
1173 | <p> |
1158 | <p> |
1174 | </p> |
1159 | </p> |
1175 | <hr /> |
|
|
1176 | <h1><a name="escape_sequences">Escape Sequences</a></h1> |
1160 | <h2><a name="escape_sequences">Escape Sequences</a></h2> |
1177 | <dl> |
1161 | <dl> |
1178 | <dt><strong><a name="item_esc__23_8"><strong><code>ESC # 8</code> </strong>></a></strong><br /> |
1162 | <dt><strong><a name="item_esc__23_8"><strong><code>ESC # 8</code> </strong>></a></strong><br /> |
1179 | </dt> |
1163 | </dt> |
1180 | <dd> |
1164 | <dd> |
1181 | DEC Screen Alignment Test (DECALN) |
1165 | DEC Screen Alignment Test (DECALN) |
… | |
… | |
1314 | <tr><td>C = K </td><td>German character set unimplemented</td></tr> |
1298 | <tr><td>C = K </td><td>German character set unimplemented</td></tr> |
1315 | </table><p></p></dl> |
1299 | </table><p></p></dl> |
1316 | <p></p> |
1300 | <p></p> |
1317 | <p> |
1301 | <p> |
1318 | </p> |
1302 | </p> |
1319 | <hr /> |
|
|
1320 | <h1><a name="csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></h1> |
1303 | <h2><a name="csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></h2> |
1321 | <dl> |
1304 | <dl> |
1322 | <dt><strong><a name="item_esc__5b_ps__40"><strong><code>ESC [ Ps @</code> </strong>></a></strong><br /> |
1305 | <dt><strong><a name="item_esc__5b_ps__40"><strong><code>ESC [ Ps @</code> </strong>></a></strong><br /> |
1323 | </dt> |
1306 | </dt> |
1324 | <dd> |
1307 | <dd> |
1325 | Insert <strong><a href="#item_ps"><code>Ps</code></a> </strong>> (Blank) <code>Character(s)</code> [default: 1] (ICH) |
1308 | Insert <strong><a href="#item_ps"><code>Ps</code></a> </strong>> (Blank) <code>Character(s)</code> [default: 1] (ICH) |
… | |
… | |
1621 | </dd> |
1604 | </dd> |
1622 | <p></p></dl> |
1605 | <p></p></dl> |
1623 | <p></p> |
1606 | <p></p> |
1624 | <p> |
1607 | <p> |
1625 | </p> |
1608 | </p> |
1626 | <hr /> |
|
|
1627 | <h1><a name="dec_private_modes">DEC Private Modes</a></h1> |
1609 | <h2><a name="dec_private_modes">DEC Private Modes</a></h2> |
1628 | <dl> |
1610 | <dl> |
1629 | <dt><strong><a name="item_esc__5b__3f_pm_h"><strong><code>ESC [ ? Pm h</code> </strong>></a></strong><br /> |
1611 | <dt><strong><a name="item_esc__5b__3f_pm_h"><strong><code>ESC [ ? Pm h</code> </strong>></a></strong><br /> |
1630 | </dt> |
1612 | </dt> |
1631 | <dd> |
1613 | <dd> |
1632 | DEC Private Mode Set (DECSET) |
1614 | DEC Private Mode Set (DECSET) |
… | |
… | |
1798 | </table></dl> |
1780 | </table></dl> |
1799 | </dl> |
1781 | </dl> |
1800 | <p></p> |
1782 | <p></p> |
1801 | <p> |
1783 | <p> |
1802 | </p> |
1784 | </p> |
1803 | <hr /> |
|
|
1804 | <h1><a name="xterm_operating_system_commands">XTerm Operating System Commands</a></h1> |
1785 | <h2><a name="xterm_operating_system_commands">XTerm Operating System Commands</a></h2> |
1805 | <dl> |
1786 | <dl> |
1806 | <dt><strong><a name="item_esc__5d_ps_3bpt_st"><strong><code>ESC ] Ps;Pt ST</code> </strong>></a></strong><br /> |
1787 | <dt><strong><a name="item_esc__5d_ps_3bpt_st"><strong><code>ESC ] Ps;Pt ST</code> </strong>></a></strong><br /> |
1807 | </dt> |
1788 | </dt> |
1808 | <dd> |
1789 | <dd> |
1809 | Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b, |
1790 | Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b, |
… | |
… | |
1841 | <tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr> |
1822 | <tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr> |
1842 | <tr><td>Ps = 720</td><td>Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr> |
1823 | <tr><td>Ps = 720</td><td>Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr> |
1843 | <tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr> |
1824 | <tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr> |
1844 | <tr><td>Ps = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr> |
1825 | <tr><td>Ps = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr> |
1845 | </table><p></p></dl> |
1826 | </table><p></p></dl> |
1846 | <p></p> |
|
|
1847 | <p> |
1827 | <p> |
1848 | </p> |
1828 | </p> |
1849 | <hr /> |
1829 | <hr /> |
1850 | <h1><a name="xpm">XPM</a></h1> |
1830 | <h1><a name="xpm">XPM</a></h1> |
1851 | <p>For the XPM XTerm escape sequence <strong><code>ESC ] 20 ; Pt ST</code> </strong>> then value |
1831 | <p>For the XPM XTerm escape sequence <strong><code>ESC ] 20 ; Pt ST</code> </strong>> then value |
… | |
… | |
2426 | <p></p> |
2406 | <p></p> |
2427 | <dt><strong><a name="item__2d_2dwith_2dxpm_2dincludes_3ddir">--with-xpm-includes=DIR</a></strong><br /> |
2407 | <dt><strong><a name="item__2d_2dwith_2dxpm_2dincludes_3ddir">--with-xpm-includes=DIR</a></strong><br /> |
2428 | </dt> |
2408 | </dt> |
2429 | <dd> |
2409 | <dd> |
2430 | Look for the XPM includes in DIR. |
2410 | Look for the XPM includes in DIR. |
2431 | |
|
|
2432 | |
|
|
2433 | </dd> |
2411 | </dd> |
2434 | <p></p> |
2412 | <p></p> |
2435 | <dt><strong><a name="item__2d_2dwith_2dxpm_2dlibrary_3ddir">--with-xpm-library=DIR</a></strong><br /> |
2413 | <dt><strong><a name="item__2d_2dwith_2dxpm_2dlibrary_3ddir">--with-xpm-library=DIR</a></strong><br /> |
2436 | </dt> |
2414 | </dt> |
2437 | <dd> |
2415 | <dd> |
2438 | Look for the XPM library in DIR. |
2416 | Look for the XPM library in DIR. |
2439 | |
|
|
2440 | |
|
|
2441 | </dd> |
2417 | </dd> |
2442 | <p></p> |
2418 | <p></p> |
2443 | <dt><strong><a name="item__2d_2dwith_2dxpm">--with-xpm</a></strong><br /> |
2419 | <dt><strong><a name="item__2d_2dwith_2dxpm">--with-xpm</a></strong><br /> |
2444 | </dt> |
2420 | </dt> |
2445 | <dd> |
2421 | <dd> |
2446 | Not needed - define via --enable-xpm-background. |
2422 | Not needed - define via --enable-xpm-background. |
2447 | |
|
|
2448 | |
|
|
2449 | </dd> |
2423 | </dd> |
2450 | <p></p></dl> |
2424 | <p></p></dl> |
2451 | <p> |
2425 | <p> |
2452 | </p> |
2426 | </p> |
2453 | <hr /> |
2427 | <hr /> |
2454 | <h1><a name="authors">AUTHORS</a></h1> |
2428 | <h1><a name="authors">AUTHORS</a></h1> |
2455 | <p>Marc Lehmann <<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>> converted this document to pod and |
2429 | <p>Marc Lehmann <<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>> converted this document to pod and |
2456 | reworked it from the original Rxvt documentation, which was done by Geoff |
2430 | reworked it from the original Rxvt documentation, which was done by Geoff |
2457 | Wing <<a href="mailto:gcw@pobox.com">gcw@pobox.com</a>>, who in turn used the XTerm documentation and other |
2431 | Wing <<a href="mailto:gcw@pobox.com">gcw@pobox.com</a>>, who in turn used the XTerm documentation and other |
2458 | sources. |
2432 | sources.</p> |
2459 | |
|
|
2460 | </p> |
|
|
2461 | |
2433 | |
2462 | </body> |
2434 | </body> |
2463 | |
2435 | |
2464 | </html> |
2436 | </html> |