mirror/opencloud
1
0
Fork 0
mirror of https://github.com/opencloud-eu/opencloud.git synced 2026-01-05 19:59:37 -06:00
Code Issues Packages Projects Releases Wiki Activity

Changelog entry and Readme updates related to libvips

Browse Source
This commit is contained in:
Ralf Haferkamp
2024-10-16 12:05:40 +02:00
committed by Ralf Haferkamp
parent 3be9f82a28
commit eb7168ddb5
2 changed files with 34 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
changelog/unreleased/thumbnails-libvips.md Normal file
View File

@@ -0,0 +1,8 @@
Enhancement: Allow to use libvips for generating thumbnails
To improve performance (and to be able to support a wider range of images formats in the future)
the thumbnails service is now able to utilize libvips (https://www.libvips.org/) for generating thumbnails.
Enabling the use of libvips is implemented as a build-time option which is currently disabled for the
"bare-metal" build of the ocis binary and enabled for the docker image builds.
https://github.com/owncloud/ocis/pull/10310

26
services/thumbnails/README.md
View File

@@ -89,3 +89,29 @@ To have more control over memory (and CPU) consumption the maximum number of con
## Thumbnails and SecureView
If a resource is shared using SecureView, the share reciever will get a 403 (forbidden) response when requesting a thumbnail. The requesting client needs to decide what to show and usually a placeholder thumbnail is used.
## Using libvips for thumbnail generation
To improve performance (and to support a wider range of images formats) the thumbnails service is able to utilize libvips (https://www.libvips.org/) for thumbnail generation. Support for libvips needs to be
enabled at buildtime and has a couple of implications:
* With libvips support enabled it is not possible to create a statically linked ocis binary
* So the libvips shared libraries need to be available at runtime in the same release that was used to build the ocis binary
* When using the ocis docker images the libvips shared libraries are included in the image
Support of libvips is disabled by default. To enable it make sure libvips and its buildtime dependencies are install in your build environment. Then just set
the `ENABLE_VIPS` variable on the `make` command:
```shell
make -C ocis build ENABLE_VIPS=1
```
Or include the `enable_vips` build tag in the `go build` command:
```shell
go build -tags enable_vips -o ocis -o bin/ocis ./cmd/ocis
```
When building a docker image using the Dockerfile in the top-level directory of ocis, libvips support is enabled and the libvips shared libraries are included
in the resulting docker image.