Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sunsided/image-processing-libs-docker
Scripts and Dockerfiles to simplify building of image processing libraries.
https://github.com/sunsided/image-processing-libs-docker
dav1d docker image-processing libde265 libheif rav1e
Last synced: 4 days ago
JSON representation
Scripts and Dockerfiles to simplify building of image processing libraries.
- Host: GitHub
- URL: https://github.com/sunsided/image-processing-libs-docker
- Owner: sunsided
- Created: 2023-02-21T20:22:24.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-02-24T00:40:10.000Z (almost 2 years ago)
- Last Synced: 2024-11-09T08:20:21.100Z (about 2 months ago)
- Topics: dav1d, docker, image-processing, libde265, libheif, rav1e
- Language: Dockerfile
- Homepage:
- Size: 27.3 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Image Processing Library Builds
Scripts and Dockerfiles to simplify building of image processing libraries
such as [libheif], [libdav1d], [librav1e] etc.
Multi-stage Docker builds are used to build the library for the current hardware.
Builds are currently targeting `debian:bullseye`.
After compiling, an empty Docker image is created `FROM scratch` and the build
artifacts are copied to it in order to allow easy
access in other docker builds:
```dockerfile
FROM debian:bullseye as builder
COPY --from=sunside/libdav1d:1.1.0-x64 /dav1d/lib/ /usr/local/lib/
RUN ldconfig
```
Please consult the detail sections below for the directory layout of each image.
## Building locally
The [`.env`] file contains configuration shared by all build scripts.
If you need to rebuild the libraries under different conditions,
make sure to adjust this file to your needs:
```bash
BASE_IMAGE=debian:bullseye
DOCKER_REGISTRY=sunside/
# etc.
```
Two helper scripts exist:
- [`list-image-contents.sh`] lists the contents of the created scratch image
- [`extract-image-contents.sh`] extracts the files from the scratch image and bundles it up in a `.tar.gz` file.
# Libraries
## [libheif] (👉 [libheif.Dockerfile](build/libheif.Dockerfile))
> libheif is an ISO/IEC 23008-12:2017 HEIF and AVIF (AV1 Image File Format) file format decoder and encoder.
>
> HEIF and AVIF are new image file formats employing HEVC (h.265) or AV1 image coding, respectively, for the best compression ratios currently possible.
This build depends on `libde265`, `librav1e` and `libdav1d` built with the scripts below.
See [build-heif.sh](build-heif.sh) for the specific versions used.
To produce `sunside/libheif:1.1.0-x64` ([Docker Hub](https://hub.docker.com/repository/docker/sunside/libheif)), run:
```shell
./build-heif.sh
```
This builds `libheif` as a shared object.
Output
```
.
|-lib
| |-libheif.so.1
| |-cmake
| | |-libheif
| | | |-libheif-config-release.cmake
| | | |-libheif-config.cmake
| | | |-libheif-config-version.cmake
| |-libheif.so.1.15.1
| |-libheif.so
| |-libheif
| | |-libheif-rav1e.so
| |-pkgconfig
| | |-libheif.pc
|-share
| |-thumbnailers
| | |-heif.thumbnailer
|-base-image
|-COPYING
|-include
| |-libheif
| | |-heif.h
| | |-heif_version.h
| | |-heif_cxx.h
| | |-heif_plugin.h
```
## [libdav1d] (👉 [libdav1d.Dockerfile](build/libdav1d.Dockerfile))
> **dav1d** is an **AV1** cross-platform **d**ecoder, open-source, and focused on speed and correctness.
To produce `sunside/libdav1d:1.1.0-x64` ([Docker Hub](https://hub.docker.com/repository/docker/sunside/libdav1d)), run:
```shell
./build-dav1d.sh
```
This builds `libdav1d` as both a shared object and static archive.
Output
```
.
|-lib
| |-x86_64-linux-gnu
| | |-libdav1d.so
| | |-libdav1d.so.6
| | |-libdav1d.so.6.8.0
| | |-libdav1d.a
| | |-pkgconfig
| | | |-dav1d.pc
|-base-image
|-COPYING
|-include
| |-dav1d
| | |-data.h
| | |-picture.h
| | |-common.h
| | |-headers.h
| | |-version.h
| | |-meson.build
| | |-dav1d.h
| | |-version.h.in
```
## [libde265] (👉 [libde265.Dockerfile](build/libde265.Dockerfile))
> libde265 is an open source implementation of the h.265 video codec.
To produce `sunside/libde265:1.0.11-x64` ([Docker Hub](https://hub.docker.com/repository/docker/sunside/libde265)), run:
```shell
./build-de265.sh
```
This builds `libde265` as a shared object.
Output
```
.
|-lib
| |-cmake
| | |-libde265
| | | |-libde265Config-release.cmake
| | | |-libde265ConfigVersion.cmake
| | | |-libde265Config.cmake
| |-pkgconfig
| | |-libde265.pc
| |-libde265.so
|-base-image
|-COPYING
|-include
| |-libde265
| | |-en265.h
| | |-de265-version.h
| | |-de265.h
```
## [librav1e] (👉 [librav1e.Dockerfile](build/librav1e.Dockerfile))
> The fastest and safest AV1 encoder.
To produce `sunside/librav1e:0.6.3-x64` ([Docker Hub](https://hub.docker.com/repository/docker/sunside/librav1e)), run:
```shell
./build-rav1e.sh
```
This builds `librav1e` as both a shared object and a static archive.
Output
```
.
|-lib
| |-librav1e.a
| |-librav1e.so
| |-librav1e.so.0.6.3
| |-pkgconfig
| | |-rav1e.pc
| |-librav1e.so.0
|-base-image
|-include
| |-rav1e
| | |-rav1e.h
|-LICENSE
```
[libdav1d]: https://code.videolan.org/videolan/dav1d
[libde265]: https://github.com/strukturag/libde265
[libheif]: https://github.com/strukturag/libheif
[librav1e]: https://github.com/xiph/rav1e
[`.env`]: .env
[`list-image-contents.sh`]: list-image-contents.sh
[`extract-image-contents.sh`]: extract-image-contents.sh