Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zigcv/zigcv
zig bindings for OpenCV4
https://github.com/zigcv/zigcv
opencv zig ziglang
Last synced: about 1 month ago
JSON representation
zig bindings for OpenCV4
- Host: GitHub
- URL: https://github.com/zigcv/zigcv
- Owner: zigcv
- License: mit
- Created: 2022-08-21T08:11:05.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-04T12:31:49.000Z (3 months ago)
- Last Synced: 2024-10-30T01:43:07.446Z (about 1 month ago)
- Topics: opencv, zig, ziglang
- Language: Zig
- Homepage: https://ryoppippi.github.io/zigcv
- Size: 847 KB
- Stars: 100
- Watchers: 5
- Forks: 14
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-zig - ryoppippi/zigcv
README
# ZIGCV
[](https://github.com/ryoppippi/zigcv/actions/workflows/ci.yml)
The ZIGCV library provides Zig language bindings for the [OpenCV 4](http://opencv.org/) computer vision library.
The ZIGCV library supports the head/master of zig and OpenCV (v4.6.0) on Linux, macOS, and Windows.
## Caution
Still under development, so the zig APIs will be dynamically changed.
You can use `const c_api = @import("zigcv").c_api;` to call c bindings directly.
This C-API is currently fixed.
## How to execute
### Use your own package manager
At first, install openCV 4.6. (maybe you can read how to install from [here](https://github.com/hybridgroup/gocv#how-to-install)).
Then:
```sh
git clone --recursive https://github.com/ryoppippi/zigcv
cd zigcv
zig build
```
Currently this repo works with zig 0.11.0, so make sure you have it installed.
We are working on updating to zig 0.12.0.
### Use devbox
We also provide a devbox config to manage dependencies and build environments.
```sh
git clone --recursive https://github.com/zigcv
cd zigcv
devbox init
```
Checkout [devbox.json](./devbox.json) for more details.
## Demos
you can build some demos.
For example:
```sh
zig build examples
./zig-out/bin/face_detection 0
```
Or you can run the demo with the following command:
```sh
devbox run build examples
./zig-out/bin/face_detection 0
```
You can see the full demo list by `zig build --help`.
## Technical restrictions
Due to zig being a relatively new language it does [not have full C ABI support](https://github.com/ziglang/zig/issues/1481) at the moment.
For use that mainly means we can't use any functions that return structs that are less than 16 bytes large on x86, and passing structs to any functions may cause memory error on arm.
## License
MIT
## Author
Ryotaro "Justin" Kimura (a.k.a. ryoppippi)