1
1
mirror of https://github.com/wez/wezterm.git synced 2024-09-20 19:27:22 +03:00

docs: freetype_render_target

refs: #639
This commit is contained in:
Wez Furlong 2021-04-08 15:52:06 -07:00
parent 43ea2f192a
commit dcf41d7338
3 changed files with 28 additions and 4 deletions

View File

@ -16,6 +16,7 @@ As features stabilize some brief notes about them will accumulate here.
* Fixed: vertical alignment issue with Iosevka on Windows [#661](https://github.com/wez/wezterm/issues/661)
* Fixed: support for "Variable" fonts such as Cascadia Code and Inconsolata on all platforms [#655](https://github.com/wez/wezterm/issues/655)
* New: [wezterm.font](config/lua/wezterm/font.md) and [wezterm.font_with_fallback](config/lua/wezterm.font_with_fallback.md) *attributes* parameter now allows matching more granular font weights and font widths. e.g.: `wezterm.font('Iosevka Term', {width="Expanded", weight="Regular"})`
* New: [freetype_render_target](config/lua/config/freetype_render_target.md) option for additional control over glyph rasterization.
### 20210405-110924-a5bb5be8

View File

@ -2,8 +2,8 @@
*Since: 20210314-114017-04b7cedd*
Configures the rendering mode used with the freetype rasterizer.
The following values are possible:
Configures the hinting and (potentially) the rendering mode used with the
freetype rasterizer. The following values are possible:
* `"Normal"` - This corresponds to the default hinting algorithm, optimized for standard gray-level rendering. This is the default setting.
* `"Light"` - A lighter hinting algorithm for non-monochrome modes. Many
@ -14,6 +14,8 @@ The following values are possible:
glyph is rendered in non-monochrome modes.
* `"HorizontalLcd"` - A subpixel-rendering variant of `Normal` optimized for horizontally decimated LCD displays.
See also [freetype_load_flags](freetype_load_flags.md) for more advanced flags
that can be primarily used to influence font hinting.
See also [freetype_render_target](freetype_render_target.md) and
[freetype_load_flags](freetype_load_flags.md) for more advanced flags that can
be primarily used to influence font hinting.

View File

@ -0,0 +1,21 @@
# `freetype_render_target = "Normal"`
*Since: nightly builds only*
Configures the *rendering* mode used with the freetype rasterizer.
The default is to use the value of [freetype_load_target](freetype_load_target.md).
You may wish to override that value if you want very fine control over
how freetype hints and then renders glyphs.
For example, this configuration uses light hinting but produces
subpixel-antialiased glyph bitmaps:
```lua
return {
freetype_load_target = "Light",
freetype_render_target = "HorizontalLcd",
}
```