graphics.py

# graphics.py
“““Simple object oriented graphics library  

The library is designed to make it very easy for novice programmers to
experiment with computer graphics in an object oriented fashion. It is
written by John Zelle for use with the book “Python Programming: An
Introduction to Computer Science“ （Franklin Beedle & Associates）.

LICENSE: This is open-source software released under the terms of the
GPL （http://www.gnu.org/licenses/gpl.html）.

PLATFORMS: The package is a wrapper around Tkinter and should run on
any platform where Tkinter is available.

INSTALLATION: Put this file somewhere where Python can see it.

OVERVIEW: There are two kinds of objects in the library. The GraphWin
class implements a window where drawing can be done and various
Graphicsobjects are provided that can be drawn into a GraphWin. As a
simple example here is a complete program to draw a circle of radius
10 centered in a 100x100 window:

--------------------------------------------------------------------
from graphics import *

def main（）:
    win = GraphWin（“My Circle“ 100 100）
    c = Circle（Point（5050） 10）
    c.draw（win）
    win.getMouse（） # Pause to view result
    win.close（）    # Close window when done

main（）
--------------------------------------------------------------------
GraphWin objects support coordinate transformation through the
setCoords method and mouse and keyboard interaction methods.

The library provides the following graphical objects:
    Point
    Line
    Circle
    Oval
    Rectangle
    Polygon
    Text
    Entry （for text-based input）
    Image

Various attributes of graphical objects can be set such as
outline-color fill-color and line-width. Graphical objects also
support moving and hiding for animation effects.

The library also provides a very simple class for pixel-based image
manipulation Pixmap. A pixmap can be loaded from a file and displayed
using an Image object. Both getPixel and setPixel methods are provided
for manipulating the image.

DOCUMENTATION: For complete documentation see Chapter 4 of “Python
Programming: An Introduction to Computer Science“ by John Zelle
published by Franklin Beedle & Associates.  Also see
http://mcsp.wartburg.edu/zelle/python for a quick reference“““

__version__ = “5.0“

# Version 5
#     * update at bottom to fix MacOS issue causing askopenfile（） to hang
#     * update takes an optional parameter specifying update rate
#     * Entry objects get focus when drawn
#     * __repr_ for all objects
#     * fixed offset problem in window made canvas borderless

# Version 4.3 4/25/2014
#     * Fixed Image getPixel to work with Python 3.4 TK 8.6 （tuple type handling）
#     * Added interactive keyboard input （getKey and checkKey） to GraphWin
#     * Modified setCoords to cause redraw of current objects thus
#       changing the view. This supports scrolling around via setCoords.
#
# Version 4.2 5/26/2011
#     * Modified Image to allow multiple undraws like other Graphicsobjects
# Versio