https://github.com/floriankarsten/kirby3-vipsthumbnail

Kirby3 vipsthumbnail thumbnail driver
https://github.com/floriankarsten/kirby3-vipsthumbnail

kirby-cms kirby3-cms kirby3-plugin

Last synced: about 2 months ago
JSON representation

Kirby3 vipsthumbnail thumbnail driver

• Host: GitHub
• URL: https://github.com/floriankarsten/kirby3-vipsthumbnail
• Owner: floriankarsten
• License: mit
• Created: 2020-03-10T17:52:32.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2022-06-27T20:05:20.000Z (over 2 years ago)
• Last Synced: 2024-07-17T08:26:37.888Z (6 months ago)
• Topics: kirby-cms, kirby3-cms, kirby3-plugin
• Language: PHP
• Size: 20.5 KB
• Stars: 11
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Kirby 3 Vips thumbnail

Highly untested use at your own risk! This is very basic Kirby CMS thumbnail driver for libvips. It uses [vipsthumbnail](https://libvips.github.io/libvips/API/current/Using-vipsthumbnail.md.html) that is installed with vips. You need recent libvips [installed](https://libvips.github.io/libvips/install.html) on your machine but **you don't need** [Vips-php](https://github.com/libvips/php-vips) PECL extension installed this plugin doesn't use it.

## Why would you want to use this?

Vips is library similar to Imagemagick but uses much less memory and it's faster. This is especially useful if you are dealing with images in 10000x10000+ px range and need to make thumbnails on memory constrained environments ([benchmarks](https://github.com/libvips/libvips/wiki/Speed-and-memory-use)).

## Why use ImageMagick or GD

This library is aimed only at resizing and cropping. Kirby's other thumb functions like grayscale, blur won't work. Cropping right now uses vips "smartcrop" algorythm which might be advantage but you can't set cropping by hand (could be easily implemented i just don't have use for it).

## Installation

Download and copy this repository to ```/site/plugins/kirby3-vipsthumbnail```

Alternatively, you can install it with composer: ```composer require floriankarsten/kirby3-vipsthumbnail```

## Output options

Vips has some options that i don't understand (like trellis-quant, overshoot-deringing, optimize-scans) but these options are currently implemented:

- ```strip``` default: true - strips metadata from images

- ```autoOrient``` default: false - aplies orientation meta tag if its present (in vips flag --rotate)

- ```interlace``` default: false - generate an interlaced (progressive) jpeg

- ```log``` default: false - There is dumb loging included if you want to debug what is going on and what commands are getting fired

- ```logdir``` default: plugindirectory/logs - connected to above - set where to save logs.

You can set these with normal thumbs kirby config. Kirby options like 'quality' and 'bin' apply.

```

return [

  'thumbs' => [

    'driver'    => 'vipsthumbnail',

    'quality'   => 90,

    'bin'       => '/usr/local/bin/vipsthumbnail',

    'interlace' => true

  ]

];

```