From 248a9af6ad668b6f09f79dda548721756fe11d79 Mon Sep 17 00:00:00 2001
From: Tomas Bzatek <tbzatek@users.sourceforge.net>
Date: Sun, 4 Jan 2015 23:01:42 +0100
Subject: Introduce new "fixed" thumbnail crop mode

This mode retains given aspect ratio and crops the area from inside of the
source image.
---
 templates/default.xml | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

(limited to 'templates/default.xml')

diff --git a/templates/default.xml b/templates/default.xml
index c903a4b..3948538 100644
--- a/templates/default.xml
+++ b/templates/default.xml
@@ -46,13 +46,19 @@
     <!-- Thumbnail section is mandatory. -->
     <!-- Corresponds with optional <item thumbnail> tag in album source file.
          Note that thumbnail images are always resized even for custom supplied files.  -->
-    <!-- The "type" attribute has to be set to "thumbnail" to be treated as such.
-         An optional "style" attribute set to "squared" indicates the need of squared
-         thumbnails as opposed to original aspect ratio. -->
+    <!-- The "type" attribute has to be set to "thumbnail" to be treated as such. -->
+    <!-- An optional "style" attribute affects cropping:
+           * normal  - image is resized to fit the dimension limits, maintaining
+                       aspect ratio without any crop (default)
+           * squared - image is cropped to a squared size and resized to fit
+           * fixed   - image is cropped to a specified dimension and cropped to
+                       fit the specified aspect ratio
+         An optional album item <thumbnail crop> tags may affect crop area.  -->
     <size name="thumbnail" type="thumbnail" style="normal">
       <landscape w="180" h="120" />
       <portrait w="120" h="180" />
       <square size="180" />
+      <crop w="180" h="120" />   <!--  valid only for the "fixed" crop style  -->
       <quality value="80" />
     </size>
 
-- 
cgit v1.2.3