From ca0250a87805d7f1f52d04a9dffa0944b2f13278 Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Fri, 11 Mar 2016 15:30:35 -0500 Subject: Issue 25959: Explain in docstring that PhotoImage.zoom arguments are multipliers, not final sizes. Explain y default for .zoom and .subsample. Initial patch by Serhiy Storchaka. --- Lib/tkinter/__init__.py | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/Lib/tkinter/__init__.py b/Lib/tkinter/__init__.py index 8139e38..da430df 100644 --- a/Lib/tkinter/__init__.py +++ b/Lib/tkinter/__init__.py @@ -3407,16 +3407,20 @@ class PhotoImage(Image): destImage = PhotoImage(master=self.tk) self.tk.call(destImage, 'copy', self.name) return destImage - def zoom(self,x,y=''): + def zoom(self, x, y=''): """Return a new PhotoImage with the same image as this widget - but zoom it with X and Y.""" + but zoom it with a factor of x in the X direction and y in the Y + direction. If y is not given, the default value is the same as x. + """ destImage = PhotoImage(master=self.tk) if y=='': y=x self.tk.call(destImage, 'copy', self.name, '-zoom',x,y) return destImage - def subsample(self,x,y=''): + def subsample(self, x, y=''): """Return a new PhotoImage based on the same image as this widget - but use only every Xth or Yth pixel.""" + but use only every Xth or Yth pixel. If y is not given, the + default value is the same as x. + """ destImage = PhotoImage(master=self.tk) if y=='': y=x self.tk.call(destImage, 'copy', self.name, '-subsample',x,y) -- cgit v0.12