comparison runtime/doc/options.txt @ 6110:1bff71d20262 v7.4.393

updated for version 7.4.393 Problem: Text drawing on newer MS-Windows systems is suboptimal. Some multi-byte characters are not displayed, even though the same font in Notepad can display them. (Srinath Avadhanula) Solution: Add the 'renderoptions' option to enable Direct-X drawing. (Taro Muraoka)
author Bram Moolenaar <bram@vim.org>
date Wed, 06 Aug 2014 14:52:30 +0200
parents 7090d7f160f7
children 18ac55444b37
comparison
equal deleted inserted replaced
6109:e21d20c8500f 6110:1bff71d20262
5648 a single entry, use the :noremap[!] command. 5648 a single entry, use the :noremap[!] command.
5649 NOTE: To avoid portability problems with Vim scripts, always keep 5649 NOTE: To avoid portability problems with Vim scripts, always keep
5650 this option at the default "on". Only switch it off when working with 5650 this option at the default "on". Only switch it off when working with
5651 old Vi scripts. 5651 old Vi scripts.
5652 5652
5653 *'renderoptions'* *'rop'*
5654 'renderoptions' 'rop' string (default: empty)
5655 global
5656 {not in Vi}
5657 {only available when compiled with GUI and DIRECTX on
5658 MS-Windows}
5659 Select a text renderer and set its options. The options depend on the
5660 renderer.
5661
5662 Syntax: >
5663 set rop=type:{renderer}(,{name}:{value})*
5664 <
5665 Currently, only one optional renderer is available.
5666
5667 render behavior ~
5668 directx Vim will draw text using DirectX (DirectWrite). It makes
5669 drawn glyphs more beautiful than default GDI.
5670 It requires 'encoding' is "utf-8", and only works on
5671 MS-Windows Vista or newer version.
5672
5673 Options:
5674 name meaning type value ~
5675 gamma gamma float 1.0 - 2.2 (maybe)
5676 contrast enhancedContrast float (unknown)
5677 level clearTypeLevel float (unknown)
5678 geom pixelGeometry int 0 - 2 (see below)
5679 renmode renderingMode int 0 - 6 (see below)
5680 taamode textAntialiasMode int 0 - 3 (see below)
5681
5682 See this URL for detail:
5683 http://msdn.microsoft.com/en-us/library/dd368190.aspx
5684
5685 For geom: structure of a device pixel.
5686 0 - DWRITE_PIXEL_GEOMETRY_FLAT
5687 1 - DWRITE_PIXEL_GEOMETRY_RGB
5688 2 - DWRITE_PIXEL_GEOMETRY_BGR
5689
5690 See this URL for detail:
5691 http://msdn.microsoft.com/en-us/library/dd368114.aspx
5692
5693 For renmode: method of rendering glyphs.
5694 0 - DWRITE_RENDERING_MODE_DEFAULT
5695 1 - DWRITE_RENDERING_MODE_ALIASED
5696 2 - DWRITE_RENDERING_MODE_GDI_CLASSIC
5697 3 - DWRITE_RENDERING_MODE_GDI_NATURAL
5698 4 - DWRITE_RENDERING_MODE_NATURAL
5699 5 - DWRITE_RENDERING_MODE_NATURAL_SYMMETRIC
5700 6 - DWRITE_RENDERING_MODE_OUTLINE
5701
5702 See this URL for detail:
5703 http://msdn.microsoft.com/en-us/library/dd368118.aspx
5704
5705 For taamode: antialiasing mode used for drawing text.
5706 0 - D2D1_TEXT_ANTIALIAS_MODE_DEFAULT
5707 1 - D2D1_TEXT_ANTIALIAS_MODE_CLEARTYPE
5708 2 - D2D1_TEXT_ANTIALIAS_MODE_GRAYSCALE
5709 3 - D2D1_TEXT_ANTIALIAS_MODE_ALIASED
5710
5711 See this URL for detail:
5712 http://msdn.microsoft.com/en-us/library/dd368170.aspx
5713
5714 Example: >
5715 set encoding=utf-8
5716 set gfn=Ricty_Diminished:h12:cSHIFTJIS
5717 set rop=type:directx
5718 <
5719 If select a raster font (Courier, Terminal or FixedSys) to
5720 'guifont', it fallbacks to be drawn by GDI automatically.
5721
5722 Other render types are currently not supported.
5723
5653 *'report'* 5724 *'report'*
5654 'report' number (default 2) 5725 'report' number (default 2)
5655 global 5726 global
5656 Threshold for reporting number of lines changed. When the number of 5727 Threshold for reporting number of lines changed. When the number of
5657 changed lines is more than 'report' a message will be given for most 5728 changed lines is more than 'report' a message will be given for most