| Version | Date | Change |
|---|---|---|
| 2.2.5 | 2024-09-12 | Frog attribute lineend added and documentation updated. Default was and still is "round" (= tk.ROUND). Now it can also be set to "flat" (= tk.BUTT) which is useful, if thick lines are used for drawing. |
| 2.2.4 | 2023-08-01 | Documentation (tutorial) was updated. Module source code is unchanged. |
| 2.2.3 | 2017-12–16 | On Windows (and maybe MacOS) a frog cannot listen to the MouseWheel due to missing support for that feature in the underlying tkinter toolkit. Upto version 2.2.2 trying to do so lead to a runtime error, now it is just without any effect. It is still possible to have a pool listening to MouseWheel-Events. |
| 2.2.2 | 2016-08–30 | To make input more convenient, the frog method readlist() has been added. It works like read(), but returns a list of all input values, that are separated by commas (or a single value). Any value that can be converted into a number, will be converted the same way readnum() does. If [Cancel] is pressed, None is returned. |
| 2.2.1 | 2016-03–30 | Instead of raising a runtime error, if an imagefile for a frog's shape or a pool's background is missing, that is now just ignored – the previous shape resp. background will be retained. |
| 2.2.0 | 2016-01–09 | Two new frog methods are added: timer_start() and timer_stop(). They can be used instead of time.perf_counter() to do some time measurement. timer_start() saves the timestamp at that moment, timer_stop() returns the elapsed time in ms (integer) without resetting the starting time. |
| 2.1.0 | 2016-01–08 | To make the handling more robust and to avoid exception handling for frog users, the frog method readnum() has been added.
It works exactly like read(), but returns a number, if input is a valid number. If conversion to int is possible, an integer will be returned, otherwise a float.
If input isn't a valid int or float, the return value is False. The frog methods save() and load() are added for the same reason and to avoid dealing with file handling. Both methods use Python's pickle-technique (and module), so lists, tuples, dicts etc. can be saved in a file easily. Both methods are robust and do not need exception handling, either. If loading/saving were not successful, False resp. None will be returned. |
| 2.0.0 | 2016-01–04 | BEGINNING WITH THAT VERSION, PYTHON 2.X IS NO LONGER SUPPORTED! Frog method writeln() added to make it easier for beginners to use the pool for output instead of the console. writeln() works like write(), but adds a line break and moves the frog one line below left-aligned. Also a new frog method topleft() is added which places the frog "nearly" in the topleft corner of the pool. "Nearly" means: the frog is placed in a way, that using writeln() afterwards will start to write left aligned in the "first line". And: textsize(), write() and writeln() now accept multiple output like print() does. All arguments, separated by comma, will be printed in one line, separated by single whitespaces. |
| 1.0.3 | 2014-07–19 | Maximum speed with settings speed = "max" and visible = False has been increased enormously. A drawing frog now is about 3 to 50 times faster, a non-drawing frog may be upto 3000 times faster than before. |
| 1.0.2 | 2013-10-23 | A minor error has been corrected, that caused a runtime error on unbinding a timer-event if used with Python 3.x. |
| 1.0.1 | 2009-02-14 | The frog's read()-method returned a bytestring in Python 3.0 rather than a "normal" string, so that return-values had do be decoded for further str-operations or output. That is changed now. |
| 1.0.0 | 2009-01-15 | After several months of testing the time has come for a first major release! The frog module now works fine with Python 2.5 (and up) and has also been successfully adapted to Python 3.0. In both cases you only need the one and only module frog.py! |
| 0.88 | 2008-12-10 | Bugfix only: Setting a visible pool visible again made it invisible; that is fixed, now. |
| 0.87 | 2008-12-06 | Frog method listen() added! From now on not only the whole pool can listen to events,
but every frog can do so as well (as far as it is some kind of mouse-event). That makes it much easier e.g.
to realize own animated (maybe graphical) buttons using frog shapes. Moreover the event-dictionary
has a new key named "object" with a reference to the calling object (i.e. a pool- or frog-instance) as value.
At last a new data attribute id is added for pools and frogs, containing an individual
id (as string) to identify a frog or pool, and frogs have a new data attribute pool,
which contains a reference to the pool, that this frog belongs to. |
| 0.86 | 2008-12-03 | Pool method snapshot() now returns the filename used when saving the snapshot resp.
an empty string if capturing wasn't successful. Buxfix in method sing() (background-playing
didn't work) and on creating own polygonial shapes with the shape-attribute (which had been
mirrored at the x-axis). |
| 0.85 | 2008-12-01 | Pool-methods snapshot() and snapinfo() added. On Windows and Linux it is
now possible to take a screenshot of the pool or a self-defined part of the pool. |
| 0.84 | 2008-11-22 | New data attribute visible for pool-instances added. This is especially usefull, if
you are operating with more than one pool, so you can hide/unhide a pool. |
| 0.83 | 2008-11-12 | Method dot() has been extended. You can use it just as it was, but you can also
set a fillcolor or avoid filling. In this case use the keyword-parameter fill, that can be set to a color or True (= default,
i.e. fill with drawing color) or False (i.e. do not fill at all). So drawing a circle now can be done
by dot() as well, but normally circle() should be preferred, though dot() is much faster. |
| 0.82 | 2008-10-27 | The pool didn't react on key-events after the read()-method once had been called. This is fixed now. A new option resizable can be used when creating a pool to avoid resizing by the user (by setting it
to False). The default value is True. |
| 0.81 | 2008-10-20 | New data attributes borderwidth and size for frog-objects added.
The borderwidth attribute determines the width of the frog's border in px if it has a polygon
shape. If you set it to 0, the shape is borderless. By using the readonly attribute size
you get the width and height of the bounding-box of the frog's actual shape as a tuple in px.
If the frog is invisible, size is (0,0). |
| 0.80 | 2008-10-18 | Method stamp() has been improved. Now making a stamp, the frog's actual direction (angle)
is taken into account. Until Version 0.79 the stamp was always directed to 0° (east). |
| 0.79 | 2008-10-17 | Method jumpto() and data-attribute pos resp. x and y
have no longer an identical functionality:
jumpto() works like it did, but changing the frog's position by setting new values to pos or x or y
does no longer affect the frogs direction, i.e. does not set its angle to the jumping direction,
then jump and then at last set the angle back to its original direction. So, setting the frog
to a new position by pos/x/y is faster than changing position by jumpto(). |
| 0.78 | 2008-09-24 | Problems with misplaced large pools on Windows systems solved. A new option pos can be used
to set the position of the pool on startup (like width and height). Default value is "topleft". For more
information look at the sourcecode (docstrings) or at the (German) tutorial. |
| 0.77 | 2008-08-27 | Using the time module's time()-function leads to a namespace conflict, when (and only when!) the frog module is imported after the time module has been imported. Conflict is resolved now. |
| 0.76 | 2008-08-07 | Improvements concerning the pool's width and height attribute:
Now you get the exact values even on Windows systems and you get them without having created a frog before. |
| 0.75 | 2008-07-03 | circle()-method improved: angle=360 is now equivalent
to omitting the angle-option; angle=-360 is handled
like a complete circle, but the frog moves backward. |
| 0.74 | 2008-04-24 | Frog attribute animate removed resp. replaced by a new speed-value 'max'.
If speed is set to 'max' there will be no extra delay at all. A combination of speed='max'
and visible=False is now equivalent to the former animate=False. |
| 0.73 | 2008−04−21 | First official release. Seems to be stable ... |