Skip to content

Conversation

@radarhere
Copy link
Member

@radarhere radarhere commented Dec 27, 2021

Resolves #5858

  1. Clarify that putdata() should receive a flattened sequence, rather than the 2D sequence that the user is trying in the issue.

I have drawn inspiration from the docstring for getdata()

Pillow/src/PIL/Image.py

Lines 1277 to 1282 in 11c536b

def getdata(self, band=None):
"""
Returns the contents of this image as a sequence object
containing pixel values. The sequence object is flattened, so
that values for line one follow directly after the values of
line zero, and so on.

  1. Raise an error if the sequence is not flattened.

>>> from PIL import Image
>>> im = Image.new("L", (1, 1), 0)
>>> im.putdata([2.0])
>>> print(im.getpixel((0, 0)))

At the moment, in Python 3.9, this returns 2, and in Python 3.10, this returns 0. I've added a commit here to consistently return 2.

@radarhere radarhere changed the title Clarified that the sequence object for putdata() should be flattened Improved putdata() documentation and casting Dec 27, 2021
@radarhere radarhere changed the title Improved putdata() documentation and casting Improved putdata() documentation and data handling Dec 27, 2021
@hugovk hugovk merged commit 8e631e4 into python-pillow:main Dec 28, 2021
@radarhere radarhere deleted the putdata branch December 28, 2021 07:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Image.putdata() NumPy usability suggestion

2 participants