Easy thumbnails for Django
Project description
The powerful, yet easy to implement thumbnailing application for Django.
To install this application into your project, just add it to your INSTALLED_APPS setting (and run manage.py syncdb):
INSTALLED_APPS = ( ... 'easy_thumbnails', )
Template usage
To generate thumbnails in your template, use the {% thumbnail %} tag. To make this tag available for use in your template, use:
{% load thumbnail %}
Basic tag Syntax:
{% thumbnail [source] [size] [options] %}
source must be a File object, usually an Image/FileField of a model instance.
size can either be:
the size in the format [width]x[height] (for example, {% thumbnail person.photo 100x50 %}) or
a variable containing a valid size (i.e. either a string in the [width]x[height] format or a tuple containing two integers): {% thumbnail person.photo size_var %}.
options are a space separated list of options which are used when processing the image to a thumbnail such as sharpen, crop and quality=90.
Model usage
You can use the ThumbnailerField or ThumbnailerImageField fields (based on FileField and ImageField, respectively) for easier access to retrieve (or generate) thumbnail images.
By passing a resize_source argument to the ThumbnailerImageField, you can resize the source image before it is saved:
class Profile(models.Model): user = models.ForeignKey('auth.User') avatar = ThumbnailerImageField( upload_to='avatars', resize_source=dict(size=(50, 50), crop='smart'), )
Lower level usage
Thumbnails are generated with a Thumbnailer instance. For example:
from easy_thumbnails import Thumbnailer def square_thumbnail(source): thumbnail_options = dict(size=(100, 100), crop=True, bw=True) return Thumbnailer(source).get_thumbnail(thumbnail_options)
By default, get_thumbnail saves the file (using file storage). The source file used to instanciate the Thumbnailer must have a name instance relative to the storage root.
The ThumbnailFile object provided makes this easy:
from easy_thumbnails import ThumbnailFile # For an existing file in storage: source = ThumbnailFile('animals/aarvark.jpg') square_thumbnail(source) # For a new file: picture = open('/home/zookeeper/pictures/my_anteater.jpg') source = ThumbnailFile('animals/anteater.jpg', file=picture) square_thumbnail(source)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for easy-thumbnails-1.0-alpha-5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 129f2d6233d96b3aeb0cdc25ad1338229422bf4b482f5172025ca73ccd595bb5 |
|
MD5 | 5ba9d4ad2d780d0e1120bf12f3503195 |
|
BLAKE2b-256 | e88e3faddb022aa9a91f2785bb5a1fc50459b9b927f4908fcebe5f24a0433309 |