Skip to main content

A Small python package to easily resize images

Project description

python-resize-image v1.1.20 on PyPi MIT license Stable

A python package to easily resize images

This package provides function for easily resizing images.

Dependencies

  • Pillow 2.7++

  • Python 2.7/3.4

Introduction

The following functions are supported:

  • resize_crop crop the image with a centered rectangle of the specified size.

  • resize_cover resize the image to fill the specified area, crop as needed (same behavior as background-size: cover).

  • resize_contain resize the image so that it can fit in the specified area, keeping the ratio and without crop (same behavior as background-size: contain).

  • resize_height resize the image to the specified height adjusting width to keep the ratio the same.

  • resize_width resize the image to the specified width adjusting height to keep the ratio the same.

  • resize_thumbnail resize image while keeping the ratio trying its best to match the specified size.

Installation

Install python-resize-image using pip:

pip install python-resize-image

Usage

python-resize-image takes as first argument a PIL.Image and then size argument which can be a single integer or tuple of two integers.

In the following example, we open an image, crop it and save as new file:

from PIL import Image

from resizeimage import resizeimage


with open('test-image.jpeg', 'r+b') as f:
    with Image.open(f) as image:
        cover = resizeimage.resize_cover(image, [200, 100])
        cover.save('test-image-cover.jpeg', image.format)

Before resizing, python-image-resize will check whether the operation can be done. A resize is considered valid if it doesn’t require to increase one of the dimension. To avoid the test add validate=False as argument:

cover = resizeimage.resize_cover(image, [200, 100], validate=False)

You can also create a two step process validation then processing using validate function attached to resized function which allows to test the viability of the resize without doing it just after validation. validate is available using the dot . operator on every resize function e.g. resize_cover.validate.

The first exemple is rewritten in the following snippet to use this feature:

from PIL import Image

from resizeimage import resizeimage

with open('test-image.jpeg', 'r+b')
    with Image.open() as image:
        is_valid = resizeimage.resize_cover.validate(image, [200, 100])

# do something else...

if is_valid:
    with Image.open('test-image.jpeg') as image:
        resizeimage.resize_cover.validate(image, [200, 100], validate=False)
        cover = resizeimage.resize_cover(image, [200, 100])
        cover.save('test-image-cover.jpeg', image.format)

Mind the fact that it’s useless to validate the image twice, so we pass validate=False to resize_cover.validate.

API Reference

resize_crop(image, size, validate=True)

Crop the image with a centered rectangle of the specified size.

Crop an image with a 200x200 cented square:

from PIL import Image
from resizeimage import resizeimage

fd_img = open('test-image.jpeg', 'r')
img = Image.open(fd_img)
img = resizeimage.resize_crop(img, [200, 200])
img.save('test-image-crop.jpeg', img.format)
fd_img.close()

resize_cover(image, size, validate=True, resample=Image.LANCZOS)

Resize the image to fill the specified area, crop as needed. It’s the same behavior as css background-size: cover property.

Resize and crop (from center) the image so that it covers a 200x100 rectangle.

from PIL import Image
from resizeimage import resizeimage

fd_img = open('test-image.jpeg', 'r')
img = Image.open(fd_img)
img = resizeimage.resize_cover(img, [200, 100])
img.save('test-image-cover.jpeg', img.format)
fd_img.close()

resize_contain(image, size, validate=True, resample=Image.LANCZOS, bg_color=(255, 255, 255, 0))

Resize the image so that it can fit in the specified area, keeping the ratio and without crop. It’s the same behavior as css background-size: contain property. A white a background border is created.

Resize the image to minimum so that it is contained in a 200x100 rectangle is the ratio between source and destination image.

from PIL import Image
from resizeimage import resizeimage

fd_img = open('test-image.jpeg', 'r')
img = Image.open(fd_img)
img = resizeimage.resize_contain(img, [200, 100])
img.save('test-image-contain.jpeg', img.format)
fd_img.close()

resize_width(image, width, validate=True, resample=Image.LANCZOS)

Resize the image to the specified height adjusting width to keep the ratio the same.

Resize the image to be 200px width:

from PIL import Image
from resizeimage import resizeimage

fd_img = open('test-image.jpeg', 'r')
img = Image.open(fd_img)
img = resizeimage.resize_width(img, 200)
img.save('test-image-width.jpeg', img.format)
fd_img.close()

resize_height(image, height, validate=True, resample=Image.LANCZOS)

Resize the image to the specified width adjusting height to keep the ratio the same.

Resize the image to be 200px height:

from PIL import Image
from resizeimage import resizeimage

fd_img = open('test-image.jpeg', 'r')
img = Image.open(fd_img)
img = resizeimage.resize_height(img, 200)
img.save('test-image-height.jpeg', img.format)
fd_img.close()

resize_thumbnail(image, size, validate=True, resample=Image.LANCZOS)

Resize image while keeping the ratio trying its best to match the specified size.

Resize the image to be contained in a 200px square:

from PIL import Image
from resizeimage import resizeimage

fd_img = open('test-image.jpeg', 'r')
img = Image.open(fd_img)
img = resizeimage.resize_thumbnail(img, [200, 200])
img.save('test-image-thumbnail.jpeg', img.format)
fd_img.close()

resize(method, *args, **kwargs)

Resize Image with the specified method : ‘crop’, ‘cover’, ‘contain’, ‘width’, ‘height’ or ‘thumbnail’.

from PIL import Image
from resizeimage import resizeimage

fd_img = open('test-image.jpeg', 'r')
img = Image.open(fd_img)
img = resizeimage.resize('thumbnail', img, [200, 200])
img.save('test-image-thumbnail.jpeg', img.format)
fd_img.close()

Tests

pip install -r requirements.dev.txt
pip install -e .
python setup.py test

Contribute

python-resize-image is hosted at github.com/VingtCinq/python-resize-image/.

Before coding install pre-commit as git hook using the following command:

cp pre-commit .git/hooks/

And install the hook and pylint:

pip install git-pylint-commit-hook pylint

If you want to force a commit (you need a good reason to do that) use commit with the -n option e.g. git commit -n.

Support

If you are having issues, please let us know.

License

The project is licensed under the MIT License.

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

python-resize-image-1.1.20.tar.gz (6.9 kB view details)

Uploaded Source

Built Distribution

python_resize_image-1.1.20-py2.py3-none-any.whl (8.4 kB view details)

Uploaded Python 2Python 3

File details

Details for the file python-resize-image-1.1.20.tar.gz.

File metadata

  • Download URL: python-resize-image-1.1.20.tar.gz
  • Upload date:
  • Size: 6.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/41.4.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/2.7.17

File hashes

Hashes for python-resize-image-1.1.20.tar.gz
Algorithm Hash digest
SHA256 b055dab919d623ece8ec95262d4bdbf006cb1a10e818e9b36221c8b1885f9922
MD5 6f1dfa83c3e718ceb7dbda6326541ac5
BLAKE2b-256 ea5ef84b810b290cfd5fb72ffbdd96046f97871db09d26bfcff0353a60cde569

See more details on using hashes here.

File details

Details for the file python_resize_image-1.1.20-py2.py3-none-any.whl.

File metadata

  • Download URL: python_resize_image-1.1.20-py2.py3-none-any.whl
  • Upload date:
  • Size: 8.4 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/41.4.0 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/2.7.17

File hashes

Hashes for python_resize_image-1.1.20-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 0977bcf8454949b2d37e56c66d95494146c4d9da295a8f7af8eff43d2c35ca6a
MD5 adb343c3560bc10fe16824f411eb539f
BLAKE2b-256 67447fb293646ed21bab5cfe8d17ec5524214cc51cb9c3ee186704f844583e57

See more details on using hashes here.

Supported by

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