Commit3cc14c9eRecorded29 Mar 2026Repositorysigil-harfbuzz

Add README

Changed
 README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
Diff
README.mdadded
@@ -0,0 +1,46 @@
+1
# sigil-harfbuzz
+2
+3
HarfBuzz text shaping FFI bindings for [Sigil](https://codeberg.org/sigil/sigil).
+4
+5
## Features
+6
+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
+12
+13
## Usage
+14
+15
```scheme
+16
(import (sigil ffi)
+17
(freetype)
+18
(harfbuzz))
+19
+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
```
+27
+28
## Dependencies
+29
+30
- sigil-stdlib
+31
- sigil-ffi
+32
- [sigil-freetype](https://codeberg.org/sigil/sigil-freetype)
+33
+34
Requires HarfBuzz system library (`libharfbuzz`).
+35
+36
## Development
+37
+38
```bash
+39
guix shell -m ~/Projects/Code/sigil/sigil/manifest.scm
+40
sigil build --redirects dev-redirects.sgl
+41
sigil test --redirects dev-redirects.sgl
+42
```
+43
+44
## License
+45
+46
BSD-3-Clause