How to customise thumbnails - Revision history

Libjlrs at 11:02, 21 May 2021

2021-05-21T11:02:08Z

Th.lauke@arcor.de: typos corrected

2021-01-12T12:37:11Z

typos corrected

Libjlrs@leeds.ac.uk: Added categories

2012-10-30T17:11:19Z

Added categories

Libjlrs@leeds.ac.uk: Created page

2012-10-30T17:09:38Z

Created page

New page

Based on EPrints-3.3.10.

To customise the size and type of thumbnails generated by eprints you can create archive-based configuration.
The steps below show how to add a new thumbnail size, and render it the way *I* want it.

The default thumbnails are generated by: <code>~/perl_lib/EPrints/Plugin/Convert/Thumbnails.pm</code>

I wanted to add a new size 160x90px, called 'homepage' (to fit in with the institution's branding).
To make your own set of thumbnail sizes, edit <code>~/archives/ARCHIVEID/cfg/cfg.d/plugins.pl</code>.
I added the following to the file:
<source lang="perl">
$c->{plugins}->{'Convert::Thumbnails'}->{params}->{sizes} = {(
small => [66,50],
homepage => [160, 90], # new size - others are copied from Thumbnails.pm
medium => [200,150],
preview => [400,300],
lightbox => [640,480],
)};
$c->{thumbnail_types} = sub {
my( $list, $repo, $doc ) = @_;
push @$list, qw( homepage ); # add new size to list of files to be generated
};
</source>

By default this will produce a thumbnail that will fit into a box 160x90px - a proportionally scaled down version of the original. The 'small' thumbnail size produces a cropped version of the original. This is a better option for my needs, but it has a grey 1px border around it - that I don't want.

To alter the thumbnails I need to add the following to <code>~/archives/ARCHIVEID/cfg/cfg.d/plugins.pl</code> - which is a slightly modified version of the <code>sub call_convert</code> copied from Thumbnails.pl
<source lang="perl">
$c->{plugins}->{'Convert::Thumbnails'}->{params}->{call_convert} = sub {
my( $self, $dir, $doc, $src, $geom, $size ) = @_;

my $convert = $self->{'convert'};
my $version = $self->convert_version;

if (!defined($geom)) {
EPrints::abort("NO GEOM");
}

my $fn = $size . ".jpg";
my $dst = "$dir/$fn";

$geom = "$geom->[0]x$geom->[1]";
# JPEG
# Read this: http://www.imagemagick.org/script/command-line-processing.php#geometry
# for details of the convert geom options.
#
if( $size eq "small" )
{
# attempt to create a thumbnail that fits within the given dimensions
# geom^ requires 6.3.8
if( $version > 6.3 )
{
$self->_system($convert, "-strip", "-colorspace", "RGB", "-background", "white", "-thumbnail","$geom^", "-gravity", "center", "-extent", $geom, "-bordercolor", "gray", "-border", "1x1", $src."[0]", "JPEG:$dst");
}
else
{
$self->_system($convert, "-strip", "-colorspace", "RGB", "-background", "white", "-thumbnail","$geom>", "-extract", $geom, "-bordercolor", "gray", "-border", "1x1", $src."[0]", "JPEG:$dst");
}
}
elsif( $size eq "homepage" ) # This is the new section to deal with the new 'homepage' size
{
# attempt to create a thumbnail that fits within the given dimensions
# geom^ requires 6.3.8
if( $version > 6.3 )
{
# homepage thumbnails don't want a border on them!
$self->_system($convert, "-strip", "-colorspace", "RGB", "-background", "white", "-thumbnail","$geom^", "-gravity", "center", "-extent", $geom, "-bordercolor", "white", "-border", "0x0", $src."[0]", "JPEG:$dst");
}
else
{
# homepage thumbnails don't want a border on them!
$self->_system($convert, "-strip", "-colorspace", "RGB", "-background", "white", "-thumbnail","$geom>", "-extract", $geom, "-bordercolor", "white", "-border", "0x0", $src."[0]", "JPEG:$dst");
}
}
elsif( $size eq "medium" )
{
$self->_system($convert, "-strip", "-colorspace", "RGB", "-trim", "+repage", "-size", "$geom", "-thumbnail","$geom>", "-background", "white", "-gravity", "center", "-extent", $geom, "-bordercolor", "white", "-border", "0x0", $src."[0]", "JPEG:$dst");
}
else
{
$self->_system($convert, "-strip", "-colorspace", "RGB", "-background", "white", "-thumbnail","$geom>", "-extract", $geom, "-bordercolor", "white", "-border", "0x0", $src."[0]", "JPEG:$dst");
}

if( -s $dst )
{
return ($fn);
}

return ();
};
</source>

To test the new thumbnail generation, find an eprint with some good images attached to it. In the example below I'll use '1234', and assume the original image is called 'file.jpg' and is the first docuemtn in the eprint (this only matters for the URL to view the image in the browser with).

Run <code>~/bin/epadmin/redo_thumbnails ARCHIVEID 1234 --verbose</code>

You should see the convert command being run - and the new size filename being created e.g.
<source lang="bash">
Starting EPrints Repository.
Connecting to DB ... done.
Redoing thumbnails for document 1234
/usr/bin/convert -strip -colorspace RGB -background white -thumbnail 160x90^ -gravity center -extent 160x90 -bordercolor white -border 0x0 /opt/eprints3/archives/digitallibrary/documents/disk0/00/00/12/34/01/file.jpg[0] JPEG:/tmp/_NyUoqmsuZ/homepage.jpg
/usr/bin/convert ... JPEG:/tmp/XR51ieKBCj/lightbox.jpg
/usr/bin/convert ... JPEG:/tmp/fCOP2BPoa2/preview.jpg
/usr/bin/convert ... JPEG:/tmp/zLEip1ewUq/medium.jpg
/usr/bin/convert ... JPEG:/tmp/weRJwQPgNT/small.jpg
</source>
NB The lines for lightbox, preview, medium and small.jpg have been truncated for clarity.

You should new be able to view the new thumbnails in a browser:
<code><nowiki>http://your.repo.url/1234/1.hashomepageThumbnailVersion/file.jpg</nowiki></code>

← Older revision		Revision as of 17:11, 30 October 2012
Line 110:		Line 110:
	You should new be able to view the new thumbnails in a browser:		You should new be able to view the new thumbnails in a browser:
	<code><nowiki>http://your.repo.url/1234/1.hashomepageThumbnailVersion/file.jpg</nowiki></code>		<code><nowiki>http://your.repo.url/1234/1.hashomepageThumbnailVersion/file.jpg</nowiki></code>
		+
		+	[[Category:Howto]][[Category:Snippets]][[Category:Contribute]]

@@ Line 9: / Line 9: @@
 To make your own set of thumbnail sizes, edit <code>~/archives/ARCHIVEID/cfg/cfg.d/plugins.pl</code>.
 I added the following to the file:
-<source lang="perl">
+<syntaxhighlight lang="perl">
 $c->{plugins}->{'Convert::Thumbnails'}->{params}->{sizes} = {(
          small => [66,50],
@@ Line 21: / Line 21: @@
          push @$list, qw( homepage ); # add new size to list of files to be generated
 };
-</source>
+</syntaxhighlight>
 By default this will produce a thumbnail that will fit into a box 160x90px - a proportionally scaled down version of the original. The 'small' thumbnail size produces a cropped version of the original. This is a better option for my needs, but it has a grey 1px border around it - that I don't want.
 To alter the thumbnails I need to add the following to <code>~/archives/ARCHIVEID/cfg/cfg.d/plugins.pl</code> - which is a slightly modified version of the <code>sub call_convert</code> copied from Thumbnails.pl
-<source lang="perl">
+<syntaxhighlight lang="perl">
 $c->{plugins}->{'Convert::Thumbnails'}->{params}->{call_convert} = sub {
 	my( $self, $dir, $doc, $src, $geom, $size ) = @_;
@@ Line 89: / Line 89: @@
 	return ();
 };
-</source>
+</syntaxhighlight>
 To test the new thumbnail generation, find an eprint with some good images attached to it. In the example below I'll use '1234', and assume the original image is called 'file.jpg' and is the first document in the eprint (this only matters for the URL to view the image in the browser with).
@@ Line 96: / Line 96: @@
 You should see the convert command being run - and the new size filename being created e.g.
-<source lang="bash">
+<syntaxhighlight lang="bash">
 Starting EPrints Repository.
 Connecting to DB ... done.
@@ Line 105: / Line 105: @@
 /usr/bin/convert ... JPEG:/tmp/zLEip1ewUq/medium.jpg
 /usr/bin/convert ... JPEG:/tmp/weRJwQPgNT/small.jpg
-</source>
+</syntaxhighlight>
 NB The lines for lightbox, preview, medium and small.jpg have been truncated for clarity.

@@ Line 91: / Line 91: @@
 </source>
-To test the new thumbnail generation, find an eprint with some good images attached to it. In the example below I'll use '1234', and assume the original image is called 'file.jpg' and is the first docuemtn in the eprint (this only matters for the URL to view the image in the browser with).
+To test the new thumbnail generation, find an eprint with some good images attached to it. In the example below I'll use '1234', and assume the original image is called 'file.jpg' and is the first document in the eprint (this only matters for the URL to view the image in the browser with).
-Run <code>~/bin/epadmin/redo_thumbnails ARCHIVEID 1234 --verbose</code>
+Run <code>~/bin/epadmin redo_thumbnails ARCHIVEID 1234 --verbose</code>
 You should see the convert command being run - and the new size filename being created e.g.
@@ Line 108: / Line 108: @@
 NB The lines for lightbox, preview, medium and small.jpg have been truncated for clarity.
-You should new be able to view the new thumbnails in a browser:
+You should now be able to view the new thumbnails in a browser:
 <code><nowiki>http://your.repo.url/1234/1.hashomepageThumbnailVersion/file.jpg</nowiki></code>
 [[Category:Howto]][[Category:Snippets]][[Category:Contribute]]