webhelpers.media
¶
Multimedia helpers for images, etc.
-
webhelpers.media.
choose_height
(new_width, width, height)¶ Return the height corresponding to
new_width
that’s proportional to the original size (width
xheight
).
-
webhelpers.media.
get_dimensions_pil
(path, default=(None, None))¶ Get an image’s size using the Python Imaging Library (PIL).
path
is the path of the image file.default
is returned if the size could not be ascertained. This usually means the file does not exist or is not in a format recognized by PIL.The normal return value is a tuple:
(width, height)
.Depends on the Python Imaging Library. If your application is not otherwise using PIL, see the
get_dimensions()
function, which does not have external dependencies.
-
webhelpers.media.
get_dimensions
(path, default=(None, None))¶ Get an image’s size using only the Python standard library.
path
is the path of the image file.default
is returned if the size could not be ascertained. This usually means the file does not exist or is not in a recognized format. PIL. Only JPG, PNG, GIF, and BMP are supported at this time.The normal return value is a tuple:
(width, height)
.The algorithms are based on a PyCode recipe by Perenzo/Welch/Ray.
This helper recognizes fewer image formats and is potentially less accurate than
get_dimensions_pil()
.Running this module as a script tests this helper. It will print the size of each image file specified on the command line.