Image Magick

All Plugins / Editor / Imagick

Identity Card

StatusCore
Plugin LabelImage Magick
Short DescriptionImage Magick viewer supports PDF and various images formats preview. Requires external library to be installed on the server.
Plugin Identifiereditor.imagick
AuthorCharles du Jeu
Urldocs/references/plugins/editor/imagick
Dependencieseditor.diaporama, access.smb, access.imap, access.swift, access.s3, access.inbox, access.demo, access.fs, access.dropbox, access.webdav, access.sftp_psl, access.smbicewind, access.sftp, access.ftp

Documentation

Makes use of a server installation of Image Magick and GhostScript to generate thumbnails for various formats : PDF, SVG, TIFF and PSD.

It cannot work if Image Magick and GhostScripts are not installed on your server, thus you won’t probably be able to use this editor on a shared host (unfortunately, I agree). Ghostscript fonts must be present on server too. When activated, PDF documents can also be viewed directly online, page by page.

The main configuration option will be the full path to the convert tool on the server. Test your server before posting some "it's not working" in the forum!!
In a commandline, change to a directory containing a pdf file, let's say myFile.pdf, and execute the following command :

  • > [PATH TO convert] myFile.pdf[0] preview.jpg
  • For example on windows : > C:\PROGRA~1\ImageMagick\convert.exe myFile.pdf[0] preview.jpg
  • For example on linux : > /opt/bin/convert myFile.pdf[0] preview.jpg

UNICONV INTEGRATION

If you can install the uniconv utilitary on your server, along with the openoffice or libreoffice headless suite, the plugin can also display preview for a wide range of office documents (Word,Excel,Powerpoint and all their closed or open-source variants).

Examples to install the packages on CentOS : yum install unoconv openoffice.org-headless openoffice.org-writer openoffice.org-calc openoffice.org-impress
Or on Debian : apt-get install unoconv openoffice.org-headless openoffice.org-writer openoffice.org-calc openoffice.org-impress

Remark : once installed, you can check the index.lucene plugin that can also make use of UNOCONV to extract textual information from office files into PDF, and the use PDF2TXT to extract and index this information for search.

Plugin parameters

LabelDescriptionTypeDefault
Convert Path *
IMAGE_MAGICK_CONVERT
Full path on the server to the 'convert' binaryString/usr/bin/convert
Thumbs Options
IM_THUMB_QUALITY
Imagick Options used for generating the thumbnailsString-quality 65 -density 150 -resize 250 -flatten
Images Options
IM_VIEWER_QUALITY
Imagick Options used for generation the high scale imagesString-quality 90 -density 250
Shared Options
IM_CUSTOM_OPTIONS
You can add any Image Magick options you want here, applied to both thumbs and big imagesString
Environment Path
ADDITIONAL_ENV_PATH
Additional path to put in the environment PATH variable before calling the command. Can be necessary for Ghostscript on Mac for example.String
Pregeneration Threshold
ONTHEFLY_THRESHOLD
Threshold (in MegaByte) under which the pages are all generated when opening the document, and over which pages are generated on-demand onlyInteger5
Unoconv Path
UNOCONV
Full path on the server to the 'unoconv' binary (see docs)String