Skip to main content

Resizes image origin to specified size.

Project description

https://github.com/un1t/django-resized/actions/workflows/python-app.yml/badge.svg

Resizes image origin to specified size. Compatible with sorl-thumbnail.

Features

  • Tested on Django 2.2, 3.0, 3.1, 3.2, 4.0

  • Python 3 support

Installation

pip install django-resized

Configuration (optional)

settings.py

DJANGORESIZED_DEFAULT_SIZE = [1920, 1080]
DJANGORESIZED_DEFAULT_SCALE = 0.5
DJANGORESIZED_DEFAULT_QUALITY = 75
DJANGORESIZED_DEFAULT_KEEP_META = True
DJANGORESIZED_DEFAULT_FORCE_FORMAT = 'JPEG'
DJANGORESIZED_DEFAULT_FORMAT_EXTENSIONS = {'JPEG': ".jpg"}
DJANGORESIZED_DEFAULT_NORMALIZE_ROTATION = True

Usage

models.py

from django_resized import ResizedImageField

class MyModel(models.Model):
    ...
    image1 = ResizedImageField(size=[500, 300], upload_to='whatever')
    image2 = ResizedImageField(size=[100, 100], crop=['top', 'left'], upload_to='whatever')
    image3 = ResizedImageField(size=[100, 150], crop=['middle', 'center'], upload_to='whatever')
    image4 = ResizedImageField(scale=0.5, quality=75, upload_to='whatever')
    image5 = ResizedImageField(size=None, upload_to='whatever', force_format='PNG')
    image6 = ResizedImageField(size=[100, None], upload_to='whatever')

Options

  • size - max width and height, for example [640, 480]. If a dimension is None, it will resized using the other value and maintains the ratio of the image. If size is None, the original size of the image will be kept.

  • scale - a float, if not None, which will rescale the image after the image has been resized.

  • crop - resize and crop. [‘top’, ‘left’] - top left corner, [‘middle’, ‘center’] is center cropping, [‘bottom’, ‘right’] - crop right bottom corner.

  • quality - quality of resized image 0..100, -1 means default

  • keep_meta - keep EXIF and other meta data, default True

  • force_format - force the format of the resized image, available formats are the one supported by pillow, default to None

How to run tests

pip install tox
tox

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-resized-1.0.2.tar.gz (4.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

django_resized-1.0.2-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file django-resized-1.0.2.tar.gz.

File metadata

  • Download URL: django-resized-1.0.2.tar.gz
  • Upload date:
  • Size: 4.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for django-resized-1.0.2.tar.gz
Algorithm Hash digest
SHA256 52d727860f64ef4fdadbe2e74b66231c71c59df4d95949e338fcd320450f77fa
MD5 ebbfe479d0dddeae158a51ba5baa21e1
BLAKE2b-256 304b06699ab3dbe204602e86d3af8ee42835290de80ea0633781a6e6dc1a31b6

See more details on using hashes here.

File details

Details for the file django_resized-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: django_resized-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 5.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for django_resized-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d55a8d4125838486a1e76ffb689f8364f7d579bc7562b04400065602ec2ba7cc
MD5 3e7d51036bf23b958cf96da399f9f085
BLAKE2b-256 05efa3ad9941f14a13a5dc9f2bdc8992bf21cc09c462c718711a0281acfab67c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page