https://github.com/bfactory-ai/zignal

Image processing library
https://github.com/bfactory-ai/zignal

image-processing webassembly zig

Last synced: about 2 months ago
JSON representation

Image processing library

• Host: GitHub
• URL: https://github.com/bfactory-ai/zignal
• Owner: bfactory-ai
• License: mit
• Created: 2024-04-13T06:47:14.000Z (9 months ago)
• Default Branch: master
• Last Pushed: 2024-11-04T03:37:17.000Z (2 months ago)
• Last Synced: 2024-11-04T04:25:13.030Z (2 months ago)
• Topics: image-processing, webassembly, zig
• Language: Zig
• Homepage: https://bfactory-ai.github.io/zignal/
• Size: 318 KB
• Stars: 67
• Watchers: 4
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-zig - bfactory-ai/zignal
• awesome-zig - zignal🗒️Image processing library

README

        
# Zignal

[![test](https://github.com/bfactory-ai/zignal/actions/workflows/test.yml/badge.svg)](https://github.com/bfactory-ai/zignal/actions/workflows/test.yml)

[![documentation](https://github.com/bfactory-ai/zignal/actions/workflows/documentation.yml/badge.svg)](https://github.com/bfactory-ai/zignal/actions/workflows/documentation.yml)



Zignal is an image processing library heavily inspired by the amazing [dlib](http://dlib.net).

## Disclaimer

This library is in early stages of development and being used internally.

As a result, the API might change often.

## Reason of being

This library is used by [Ameli](https://ameli.co.kr/) for its makeup virtual try on.

## Features

Initially, the features in this library are the ones required to get the virtual makeup try on working.

However, we hope that it can be a foundation from which we can build a high quality image processing library, collaboratively.

Current features include:

- color space conversions

- simple matrix struct with common linear algebra operations

- singular value decomposition (SVD) ported from dlib

- geometry

  - points and rectangles

  - projective and similarity transforms

  - convex hull

- simple image struct with common operations

  - resize

  - rotate

  - crop

  - blur

  - sharpen

- drawing functions

  - lines

  - circles

  - polygons

## Examples

I plan to add examples for most of the features of this library as simple HTML/JS + Wasm. One of the greatest things about dlib

is the large amount of examples illustrating how to use many of that library features.

They can be accessed from [here](https://bfactory-ai.github.io/zignal/examples/).

Currently, there are examples for:

- [Color space conversions](https://bfactory-ai.github.io/zignal/examples/colorspace.html)

- [Face alignment](https://bfactory-ai.github.io/zignal/examples/face-alignment.html)

- [Perlin noise generation](https://bfactory-ai.github.io/zignal/examples/perlin-noise.html)

## Acknowledgements

First of all, this project would not have been possible without the existance of [dlib](http://dlib.net).

In fact, the first version of the virtual makeup try on was written in C++ with dlib and Emscripten.

However, we decided to give Zig a go, even if that meant rewriting the world, but we have no dependencies now.

Finally, [B factory, Inc](https://www.bfactory.ai/), which is my employer and graciously agreed to release this library to the public.