README.md — sigil-harfbuzz

1# sigil-harfbuzz

3HarfBuzz text shaping FFI bindings for [Sigil](https://codeberg.org/sigil/sigil).

5## Features

7- Buffer creation and lifecycle management

8- Text shaping with HarfBuzz

9- Script and language tag helpers

10- Glyph info and position access

11- Segment property guessing

13## Usage

15```scheme

16(import (sigil ffi)

17 (freetype)

18 (harfbuzz))

20;; Create a HarfBuzz buffer and shape text

21(let ((buf (hb-buffer-create)))

22 (hb-buffer-add-utf8 buf "Hello")

23 (hb-buffer-guess-segment-properties buf)

24 ;; Shape with a font...

25 (hb-buffer-destroy buf))

26```

28## Dependencies

30- sigil-stdlib

31- sigil-ffi

32- [sigil-freetype](https://codeberg.org/sigil/sigil-freetype)

34Requires HarfBuzz system library (`libharfbuzz`).

36## System Prerequisites

38- [HarfBuzz](https://harfbuzz.github.io/) (`libharfbuzz`)

39- [FreeType](https://freetype.org/) (`libfreetype`) — required for tests

41## Development

43```bash

44sigil deps install

45sigil build

46sigil test

47```

49## License

51BSD-3-Clause