Commit 65cf1fd3 authored by Carsten  Rose's avatar Carsten Rose
Browse files

QFQ now recommends ImageMagick instead of GraphicsMagic, due to much better...

QFQ now recommends ImageMagick instead of GraphicsMagic, due to much better 'convert' quality by converting 'svg' images.
parent 2a82b8ac
Pipeline #1036 passed with stage
in 1 minute and 55 seconds
......@@ -64,7 +64,7 @@ Preparation for Ubuntu 14.04::
sudo apt-get install php5-mysqlnd php5-intl
sudo apt-get install pdftk file # for file upload and PDF
sudo apt-get install inkscape graphicsmagick # to render thumbnails
sudo apt-get install inkscape imagemagick # to render thumbnails
sudo php5enmod mysqlnd
sudo service apache2 restart
......@@ -161,7 +161,7 @@ The Typo3 sendmail eco-system is not used at all by QFQ.
Thumbnail
^^^^^^^^^
Thumbnails will be rendered via GraphicsMagick (http://www.graphicsmagick.org/) 'convert' and 'inkscape' (https://inkscape.org).
Thumbnails will be rendered via ImageMagick (https://www.imagemagick.org/) 'convert' and 'inkscape' (https://inkscape.org).
'inkscape' is only used for '.svg' files.
The Typo3 graphic eco-system is not used at all by QFQ.
......@@ -6130,14 +6130,17 @@ Examples: ::
Column: _thumbnail
^^^^^^^^^^^^^^^^^^
A thumbnail of the file `T:<pathFilename>` will be rendered and saved with the given pixel size as specified via
`W:<dimension>`. The file is only rendered once and subsequent access is delivered via a local cache. The will be
rendered again, if the source file is newer than the thumbnail or if the thumbnail dimension changes.
For file `T:<pathFilename>` a thumbnail will be rendered, saved (to be reused) and a HTML `<img>` tag is returned,
With the SIP encoded thumbnail.
The thumbnail pathFilename is a MD5 hash of the pathFilename plus the dimension information.
The thumbnail:
From multi page files like PDFs, the first page is used as the thumbnail.
All file formats, which GraphicsMagick 'convert' (http://www.graphicsmagick.org/formats.html) supports, can be
* Size is specified via `W:<dimension>`. The file is only rendered once and subsequent access is delivered via a local QFQ cache.
* Will be rendered, if the source file is newer than the thumbnail or if the thumbnail dimension changes.
* The caching is done by building the MD5 of pathFilename and thumbnail dimension.
* Of multi page files like PDFs, the first page is used as the thumbnail.
All file formats, which 'convert' ImageMagick (https://www.imagemagick.org/) supports, can be
used. Office file formats are not supported. Due to speed and quality reasons, SVG files will be converted by inkscape.
If a file format is not known, QFQ tries to show a corresponding file type image provided by Typo3 - such an image is not
scaled.
......@@ -6169,7 +6172,7 @@ Example: ::
10.sql = SELECT 'T:fileadmin/file3.pdf' AS _thumbnail
# SIP protected, IMG tag, thumbnail width 50px
20.sql = SELECT 'T:fileadmin/file3.pdf|W:50x' AS _thumbnail
20.sql = SELECT 'T:fileadmin/file3.pdf|W:50' AS _thumbnail
# No SIP protection, IMG tag, thumbnail width 150px
30.sql = SELECT 'T:fileadmin/file3.pdf|s:0' AS _thumbnail
......@@ -6181,7 +6184,8 @@ Example: ::
Dimension
'''''''''
GraphicsMagick support various settings to force the thumbnail size. See http://www.graphicsmagick.org/GraphicsMagick.html#details-geometry.
ImageMagick support various settings to force the thumbnail size.
See https://www.imagemagick.org/script/command-line-processing.php#geometry or http://www.graphicsmagick.org/GraphicsMagick.html#details-geometry.
Cleaning
''''''''
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment