# Changelog
* [3.1.5](#3-1-5)
* [3.1.4](#3-1-4)
* [3.1.3](#3-1-3)
* [3.1.2](#3-1-2)
* [3.1.1](#3-1-1)
* [3.1.0](#3-1-0)
* [3.0.1](#3-0-1)
* [3.0.0](#3-0-0)
* [2.5.1](#2-5-1)
* [2.5.0](#2-5-0)
* [2.4.6](#2-4-6)
* [2.4.5](#2-4-5)
* [2.4.4](#2-4-4)
* [2.4.3](#2-4-3)
* [2.4.2](#2-4-2)
* [2.4.1](#2-4-1)
* [2.4.0](#2-4-0)
* [2.3.3](#2-3-3)
* [2.3.2](#2-3-2)
* [2.3.1](#2-3-1)
* [2.3.0](#2-3-0)
* [2.2.7](#2-2-7)
* [2.2.6](#2-2-6)
* [2.2.5](#2-2-5)
* [2.2.4](#2-2-4)
* [2.2.3](#2-2-3)
* [2.2.2](#2-2-2)
* [2.2.1](#2-2-1)
* [2.2.0](#2-2-0)
* [2.1.3](#2-1-3)
* [2.1.2](#2-1-2)
* [2.1.1](#2-1-1)
* [2.1.0](#2-1-0)
* [2.0.0](#2-0-0)
* [1.1.7](#1-1-7)
## 3.1.5
### Changed
* SVG: user transformations are now ignored, instead of returning
_”unimplemented feature”_ error.
### Fixed
* Reverted “fixed: bitmap font glyph advance width calculation”.
It appears that HarfBuzz <= 5.1 calculated glyph advance widths
incorrectly for bitmap fonts, when bitmap font scaling has been
enabled (`pixelsizefixupfactor` has been set in FontConfig).
fcft-3.1.3 compensated for this when calculating the glyphs’ advance
widths.
HarfBuzz >= 5.2 changed how it calculates the advance widths, and
fcft’s compensation now causes and excessive advance width.
Thus, the patch from fcft-3.1.3 has been reverted.
[#163][fuzzel-163]
[fuzzel-163]: https://codeberg.org/dnkl/fuzzel/issues/163
## 3.1.4
### Fixed
* Crash when failing to load an SVG glyph with multiple sub-glyphs.
## 3.1.3
### Fixed
* Bitmap font glyph advance width calculation in
`fcft_rasterize_grapheme_utf32()` and
`fcft_rasterize_text_run_utf32()` when user had enabled
`10-scale-bitmap-fonts.conf` in FontConfig.
## 3.1.2
### Fixed
* SVG glyphs failing with “bad argument” if LCD subpixel rendering is
enabled ([#1069][foot-1069]).
[foot-1069]: https://codeberg.org/dnkl/foot/issues/1069
## 3.1.1
### Fixed
* Crash when multiple SVG glyphs are rasterized in parallel (i.e. the
SVG backend is now thread safe) ([#51][51]).
* Crash when rasterizing SVG glyphs with transforms (e.g. synthetic
slanting). Transforms are now completely ignored ([#51][51]).
[51]: https://codeberg.org/dnkl/fcft/issues/51
## 3.1.0
### Added
* OT-SVG support ([#49][49]). Note that FreeType does not rasterize
SVG glyphs by itself. Instead, fcft does this via FreeType hooks,
using a bundled [nanosvg][nanosvg] as backend. Enabled by default,
but can be disabled with `-Dsvg-backend=none`. FreeType >= 2.12 is
required.
* `FCFT_CAPABILITY_SVG` added to `fcft_capabilities()`.
[nanosvg]: https://github.com/memononen/nanosvg
[49]: https://codeberg.org/dnkl/fcft/issues/49
### Changed
* Minimum required meson version is now 0.58
### Fixed
* `fcft_font::name`, and `fcft_glyph::font_name` not being set
correctly for font collections (e.g. `*.ttc` files).
* Assertion inside HarfBuzz with `fcft_rasterize_grapheme_ut32()` when
we fail to rasterize a glyph ([#1056][foot-1056]).
[foot-1056]: https://codeberg.org/dnkl/foot/issues/1056
## 3.0.1
### Fixed
* Crash when failing to lookup the full font name
(https://codeberg.org/dnkl/fcft/issues/47).
## 3.0.0
### Added
* `name` to `struct fcft_font`. This is the name of the **primary**
font (i.e. not any of the fallback fonts).
* `font_name` to `struct fcft_glyph`. This is the name of the font the
glyph was loaded from, and may reference a fallback font. Note that
it is **always** NULL in text-run glyphs.
### Changed
* meson: default C standard changed from C18 to C11 (fcft does not use
any C18 features).
* fcft’s constructor and destructor are now part of the public API,
and must be explicitly called: `fcft_init()` and `fcft_fini()`. Note
that `fcft_init()` also handles logging initialization.
* All `wchar_t` usage replaced with `uint32_t`.
* layout tags removed from `fcft_grapheme_rasterize()`. These should
be set using `fontfeature`s in the font `names` and/or `attributes`
arguments in `fcft_from_name()`.
* `wc` member in `struct glyph` renamed to `cp` (CodePoint).
* `wc` function arguments renamed to `cp` in all APIs.
* `fcft_glyph_rasterize()` renamed to `fcft_rasterize_char_utf32()`.
* `fcft_grapheme_rasterize()` renamed to `fcft_rasterize_grapheme_utf32()`.
* `fcft_text_run_rasterize()` renamed to `fcft_rasterize_text_run_utf32()`.
### Removed
* `fcft_size_adjust()`
* `space_advance` member from `struct fcft_font`.
* `fcft_log_init()`. Use `fcft_init()` instead.
### Fixed
* Wrong version string generated when building as a subproject.
* Uninitialized grapheme state variable in
`fcft_text_run_rasterize()`.
* Incorrectly sorted Unicode precompose table when building in non-C
locales (https://codeberg.org/dnkl/fcft/issues/44).
## 2.5.1
### Added
* Meson command line option `-Ddocs` to force disable or enable
building manual pages and installing changelog and readme files
### Changed
* `scdoc` is optional and detected automatically
* `fcft_set_scaling_filter()` now applies to color bitmap fonts only
(i.e. emoji fonts). Applying e.g. cubic or lanczos3 on regular text
glyphs simply does not look good.
### Fixed
* `FCFT_SCALING_FILTER_CUBIC` incorrectly being mapped to “lanczos3”.
* Pixman errors and program freezes when scaling bitmap fonts to very
small sizes (https://codeberg.org/dnkl/foot/issues/830).
### Contributors
* Alibek Omarov
## 2.5.0
### Added
* Text-run shaping now requires libutf8proc (in addition to
HarfBuzz). Grapheme shaping still requires HarfBuzz only.
* `fcft_set_emoji_presentation()` - can be used to override emojis’
**default** presentation style.
### Changed
* Meson command line option `-Dtext-shaping` have been replaced with
`-Dgrapheme-shaping` and `-Drun-shaping`; grapheme shaping requires
HarfBuzz only, while run shaping requires HarfBuzz **and**
libutf8proc. Thus, enabling run shaping implicitly enables grapheme
shaping.
* `fcft_*_rasterize()`: emojis’ default presentation is now accounted
for when searching for a font containing the emoji codepoint;
codepoints whose default presentation is “text” will no longer
consider emoji fonts, and codepoints whose default presentation is
“emoji” will no longer consider non-emoji fonts.
### Fixed
* `fcft_text_run_rasterize()`: much improved handling of RTL scripts
(in mixed LTR/RTL strings in particular)
## 2.4.6
### Added
* UnicodeData updated to 14.0
### Fixed
* ‘cp’ field in `struct fcft_glyph` being assigned font index instead
of Unicode codepoint in `fcft_grapheme_rasterize()` and
`fcft_text_run_rasterize()`.
* Assertion in `glyph_cache_resize()`, triggered by trying to
rasterize, and _failing_, a large amount of code points
(https://codeberg.org/dnkl/foot/issues/763).
* Bad performance of grapheme cache when rasterizing many grapheme
clusters.
### Contributors
* [emersion](https://codeberg.org/emersion)
## 2.4.5
### Fixed
* `fcft_text_run_rasterize()` not checking if codepoint is in the
font’s charset before attempting shaping
(https://codeberg.org/dnkl/fcft/issues/30).
* Crash when destroying a font with a grapheme cache entry
representing a failed grapheme glyph.
## 2.4.4
### Fixed
* Rendering of bitmap fonts with Freetype >= 2.11
(https://codeberg.org/dnkl/fcft/issues/29).
## 2.4.3
### Fixed
* Bitmap/aliased font glyphs being mirrored on big-endian
architectures.
* Color font glyphs having wrong colors on big-endian architectures.
* Crash when destroying a font that failed to load (typically happens
when there are no fonts available at all).
## 2.4.2
### Fixed
* Rare crash when one thread was doing a glyph cache lookup, while
another was resizing the cache.
## 2.4.1
### Changed
* Log messages are now printed to stderr instead of stdout.
* `fcft_grapheme_rasterize()` now sets a minimum grapheme column count
of 2 when the cluster ends with an Emoji variant selector (codepoint
0xFE0F).
### Fixed
* Compilation error when fallback definition for `FCFT_EXPORT` was used
in `meson.build`.
### Contributors
* [emersion](https://codeberg.org/emersion)
* [craigbarnes](https://codeberg.org/craigbarnes)
## 2.4.0
### Added
* Example program. Very simple bare bones Wayland program that renders
a user provided string with user configurable fonts and colors. No
proper error checking etc. To build, configure meson with
`-Dexamples=true`.
* `fcft_log_init()`. This function enables, and configures logging in fcft.
* `fcft_text_run_rasterize()`: new API that uses HarfBuzz to shape a
text run (i.e. a whole string). Note that HarfBuzz is (still) an
**optional** dependency, see
[README](README.md#user-content-building).
* `fcft_text_run_destroy()`: new API that frees a rasterized text-run.
* `FCFT_CAPABILITY_TEXT_RUN_SHAPING` added to `fcft_capabilities()`.
* `antialias` and `subpixel` members to `struct fcft_font`.
### Changed
* fcft logging must now be enabled explicitly (see `fcft_log_init()`).
* Internal logging functions are no longer exported by the shared library.
* The pixel size passed from FontConfig to FreeType is now rounded
instead of truncated (https://codeberg.org/dnkl/foot/issues/456).
### Fixed
* Internal logging functions have been renamed, from generic `log_*`
names to fcft specific `fcft_log_` names.
* Apply pixel-size fixup to glyphs’ advance width/height, but **only**
if we estimated the fixup ourselves (otherwise the advance
width/height is already scaled).
## 2.3.3
### Fixed
* Cloned fonts not being properly freed in library destructor.
## 2.3.2
### Added
* Limited support for _"fontfeatures_" . fcft is still not a layout
engine, but with this we can support e.g. _stylistic sets_
(HarfBuzz-enabled builds only).
### Deprecated
* `tags` argument in `fcft_grapheme_rasterize()`. It is now being
ignored, and will be removed in a future release.
### Fixed
* Hang in library destructor when system has no fonts installed
(https://codeberg.org/dnkl/foot/issues/174).
### Contributors
* [birger](https://codeberg.org/birger)
## 2.3.1
### Fixed
* `fcft_grapheme_rasterize()` now makes use of the optional
`tags`. These were previously ignored.
* Compilation error when text shaping was disabled.
## 2.3.0
### Added
* `fcft_set_scaling_filter()`: new API that lets the calling
application configure the filter to use when downscaling bitmap
fonts (https://codeberg.org/dnkl/fcft/issues/9).
* `fcft_grapheme_rasterize()`: new API that uses HarfBuzz to shape a
grapheme cluster. Note that HarfBuzz is an **optional** dependency,
see [README](README.md#user-content-building).
### Changed
* Increased timeout in tests, from 4s (the default), to 60s
(https://codeberg.org/dnkl/foot/issues/120).
## 2.2.7
### Changed
* Use lanczos3 filtering when downscaling bitmap fonts. This improves
the quality of e.g. color emoji fonts.
### Fixed
* Compilation with `-pedantic`
## 2.2.6
### Fixed
* Set LCD filter. This fixes **severe** color fringes when FreeType
has been built with `FT_CONFIG_OPTION_SUBPIXEL_RENDERING` (i.e. the
old ClearType-style subpixel rendering, instead of the newer Harmony
LCD rendering).
## 2.2.5
### Changed
* `fcft_glyph_rasterize()`: improved performance in threaded
applications by guarding the glyph cache with an _rwlock_ instead of
a _mutex_.
### Fixed
* fcft now checks for memory allocation failures.
* Compilation errors in 32-bit builds.
## 2.2.4
### Added
* Unicode license file, for `UnicodeData.txt`
## 2.2.3
### Added
* Missing [LICENSE](LICENSE) file
* [LICENSE](LICENSE), [README.md](README.md) and
[CHANGELOG.md](CHANGELOG.md) are now installed to
`${datadir}/doc/fcft`.
### Fixed
* Assertion in debug builds when resizing the glyph cache
## 2.2.2
### Fixed
* `fcft_kerning()` was not threadsafe
* Rare crash in `fcft_glyph_rasterize()` caused by a race between a
successful glyph cache lookup and a glyph cache resize.
## 2.2.1
### Changed
* Color bitmap glyphs with a pixel-size fixup factor other than 1.0
are now pre-scaled. Previously, fcft would only set a pixman scale
transform on the glyph, causing actual scaling to occur **every**
time the glyph was blended. This improves the performance when
rendering color emojis.
## 2.2.0
### Changed
* Internal representation of the primary and fallback fonts.
* Do not load a fallback font if it does not contain the requested glyph.
### Deprecated
* `fcft_size_adjust()`
## 2.1.3
### Fixed
* Advance width and height of scaled bitmap fonts.
## 2.1.2
### Changed
* Glyph cache now resizes dynamically. This fixes a performance
problem when loading **a lot** of glyphs, as we ended up scanning
very long lists when looking up a glyph in the cache.
## 2.1.1
### Changed
* Prefer user-provided `charset`. This can be used to e.g. limit a
fallback font's usage to a custom Unicode point range.
### Fixed
* LCD RGB/BGR modes were reversed.
## 2.1.0
### Added
* When looking for a glyph in the fallback fonts, don't discard
(destroy/unload) the fonts that did not contain the glyph. This
improves performance massively when loading lots of glyphs that does
not exist in the primary font, or in the first fallback font(s).
* Synthetic bold and italics (FontConfig's _embolden_ and _matrix_
properties).
* `fcft_precompose()` - combines a base- and a combining wide
character into a single pre-composed character.
### Changed
* `fcft_from_name()` and `fcft_size_adjust()` no longer calls
`setlocale()` to set a suitable locale for `FcParseName()`, as this
was not thread safe. The caller is responsible for ensuring
`LC_NUMERICAL` is set to a locale that correctly recognizes _x.y_
decimal values.
### Fixed
* `fcft_from_name()` was not thread safe
* `fcft_clone()` was not thread safe
* `fcft_size_adjust()` was not thread safe
* `fcft_destroy` was not thread safe
## 2.0.0
### Changed
* API: `font_` prefix changed to `fcft_`.
* API: renamed `struct font` to `struct fcft_font`.
* API: renamed `struct glyph` to `struct fcft_glyph`.
* API: internal members of `struct fcft_glyph` removed.
* API: renamed `enum subpixel_order` to `enum fcft_subpixel`, and
`ORDER` was removed from the enum values.
* API: renamed `fcft_glyph.x_advance` to `fcft_glyph.advance.x`, and
added `fcft_glyph.advance.y`
* API: renamed `fcft_font.max_x_advance` to `fcft_font.max_advance.x`
and added `fcft_font.max_advance.y`.
* API: renamed `fcft_font.space_x_advance` to
`fcft_font.space_advance.x` and added `fcft_font.space_advance.y`.
* API: renamed `fcft_glyph_for_wc()` to `fcft_glyph_rasterize()`.
* Require meson >= 0.54.
* Use `meson.override_dependency()`.
### Fixed
* `fcft_kerning()` did not scale the returned kerning distances with
the font's pixel size fixup multiplier.
## 1.1.7
### Fixed
* LCD RGB/BGR modes were reversed
Generated by dwww version 1.15 on Sun Jun 16 02:46:39 CEST 2024.