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. Inherits from ImageField.

Features

  • Tested on Django 3.2, 4.0, 4.1, 4.2, 5.0, 5.1

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.3.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file django_resized-1.0.3.tar.gz.

File metadata

  • Download URL: django_resized-1.0.3.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for django_resized-1.0.3.tar.gz
Algorithm Hash digest
SHA256 c199f2b6e315816753df3a7a3889b923d3b73ce89fa16af93761cf2ea9bac4f7
MD5 f92913a3d1bde121799d075fed41b8ca
BLAKE2b-256 fcaa5e83b3dec9c1ec7d336c86e83bbc93674cd4fc125879a827b932a0ec25c3

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for django_resized-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b5b0cf0d1db4f8db43362eef121d94d63487e2bff7a59c45046a1420788db353
MD5 3d1bed84ec5811c820f5dd991aaeb634
BLAKE2b-256 38ac3495743e9923a3b79a929782f63db7acd606dc94c15c296487ef6d015717

See more details on using hashes here.

Supported by

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