diff options
| -rw-r--r-- | docs/topics/files.txt | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/topics/files.txt b/docs/topics/files.txt index 67ce56adcd..58bf9b7715 100644 --- a/docs/topics/files.txt +++ b/docs/topics/files.txt @@ -73,6 +73,27 @@ location (:setting:`MEDIA_ROOT` if you are using the default >>> car.photo.path == new_path True +.. note:: + + Whilst :class:`~django.db.models.ImageField` non-image data attributes, + such as ``height``, ``width``, and ``size`` are available on the instance, + the underlying image data cannot be used without reopening the image. For + example:: + + >>> from PIL import Image + >>> car = Car.objects.get(name='57 Chevy') + >>> car.photo.width + 191 + >>> car.photo.height + 287 + >>> image = Image.open(car.photo) + # Raises ValueError: seek of closed file. + >>> car.photo.open() + <ImageFieldFile: cars/chevy.jpg> + >>> image = Image.open(car.photo) + >>> image + <PIL.JpegImagePlugin.JpegImageFile image mode=RGB size=1600x1200 at 0x7F99A94E9048> + The ``File`` object =================== |