https://github.com/aramperes/buzz4j

Java bindings for HarfBuzz
https://github.com/aramperes/buzz4j

bindings harfbuzz java jni text-shaping

Last synced: 1 day ago
JSON representation

Java bindings for HarfBuzz

• Host: GitHub
• URL: https://github.com/aramperes/buzz4j
• Owner: aramperes
• License: mit
• Created: 2023-08-18T03:12:18.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-08-22T20:56:01.000Z (over 1 year ago)
• Last Synced: 2024-11-08T18:53:26.631Z (about 2 months ago)
• Topics: bindings, harfbuzz, java, jni, text-shaping
• Language: Java
• Homepage:
• Size: 7.27 MB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


# buzz4j

Java bindings for [HarfBuzz](https://harfbuzz.github.io).

[![MIT licensed](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

[![Build status](https://github.com/aramperes/buzz4j/actions/workflows/build.yaml/badge.svg)](https://github.com/aramperes/buzz4j/actions)

[![Latest Release](https://img.shields.io/github/v/tag/aramperes/buzz4j?label=release)](https://github.com/aramperes/buzz4j/releases/latest)

## Usage

This library only implements a tiny subset of HarfBuzz API. I focused on the use-case for my own projects:

```java

import dev.poire.buzz4j.HarfBuzz;

HarfBuzz.shapeString(fontPath, text);

```

Which gives you a list of glyph and their drawing position:

```

ShapeGlyph{

  int glyphId

  int advanceX

  int advanceY

  int offsetX

  int offsetY

}[]

```

## Compile

There is a submodule for `harfbuzz`. Start by fetching the submodule sources with `git submodule update`.

Then, `cd harfbuzz` and follow the [official instructions](https://harfbuzz.github.io/building.html) (meson

recommended):

```sh

meson build --wrap-mode=default

meson compile -C build

```

The `harfbuzz/build` directory should have, at minimum:

```

src/harfbuzz.lib

src/harfbuzz.dll

subprojects/freetype-2.13.0/freetype-6.dll

subprojects/libpng-1.6.39/png16-16.dll

```

Now, back in the root directory, run tests and build a `debug` library:

```sh

./gradlew build

```

This will build a JAR in `build/libs`, but it is then recommended to build

the shared library in `release` mode for distribution:

```sh

./gradlew assembleRelease

```

The build outputs for distribution are:

```

build/libs/buzz4j-1.0-SNAPSHOT.jar

buzz4jni/build/lib/main/release/buzz4j.dll

```

Keep in mind that you will need dependencies at runtime:

```

harfbuzz.dll

freetype-6.dll

png16-16.dll

```

## License

MIT License. See `LICENSE` for details.