version 2.6.8.dev1

CHANGELOG.md

 ChangeLog/更新日志
 =================
 
+[`2.6.8.dev1`] - 2023-07-28
+---------------------------
+
+### Added/新增
+
+- [X] The class `Animation` adds the parameter `callback` to extend the functionality  
+类 `Animation` 新增参数 `callback` 来扩展功能
+
 [`2.6.8.dev0`] - 2023-07-20
 ---------------------------
 

README.md

@@ -9,7 +9,7 @@ The `tkintertools` module is an auxiliary module of the `tkinter` module
 
 [![Version](https://img.shields.io/pypi/v/tkintertools?label=Version)](.)
 [![License](https://img.shields.io/pypi/l/tkintertools?label=License)](LICENSE.txt)
-[![ChangeLog](https://img.shields.io/badge/ChangeLog-2023/07/20-orange)](CHANGELOG.md)
+[![ChangeLog](https://img.shields.io/badge/ChangeLog-2023/07/28-orange)](CHANGELOG.md)
 [![ToDo](https://img.shields.io/badge/ToDo-16-yellow)](TODO.md)
 [![Size](https://img.shields.io/github/languages/code-size/Xiaokang2022/tkintertools?label=Size)](tkintertools)
 [![Wiki](https://img.shields.io/badge/Wiki-14-purple)](https://github.com/Xiaokang2022/tkintertools/wiki)\
@@ -40,15 +40,15 @@ pip install tkintertools==2.6.7
 
 ### Development Version/开发版本
 
-* Version/最新版本 : `2.6.8.dev0` (第 1 个预发布版本)
-* Release/发布日期 : 2023/07/20 (UTC+08)
+* Version/最新版本 : `2.6.8.dev1` (第 1 个预发布版本)
+* Release/发布日期 : 2023/07/28 (UTC+08)
 
 这个是我正在开发的版本，可能有新功能，bug 可能会比较多，但也可能会比原来的版本更加稳定。开发版没有经过多操作系统的测试，仅能保证在 Windows 系统下运行所有功能，在其他的操作系统上，可能有部分功能无法正常运行。大家可以在 Issues 中提出一些建议，我可能会适当采纳一些并在开发版本中更改或实现。
 
 **PIP Cmd/安装命令：**
 
 ```
-pip install tkintertools==2.6.8.dev0
+pip install tkintertools==2.6.8.dev1
 ```
 
 > **Warning**  
@@ -77,12 +77,12 @@ News/最新功能👇
 
 ### Release Notes/版本说明
 
-**最新版本: `tkintertools-v2.6.8.dev0`**
+**最新版本: `tkintertools-v2.6.8.dev1`**
 
 > **Note**   
 > tkintertools 的介绍、使用教程和开发文档均在 [Wiki](https://github.com/Xiaokang2022/tkintertools/wiki) 中，大家可前往查阅
 
-下面是本次开发版本（`v2.6.7` -> `v2.6.8.dev0`）的更新内容条目：
+下面是本次开发版本（`v2.6.7` -> `v2.6.8.dev1`）的更新内容条目：
 
 - [X] Added class `Animation` to achieve more efficient, convenient and functional animation effects  
 新增类 `Animation` 来实现更加高效、更加方便和功能性更强的动画效果
@@ -94,6 +94,8 @@ News/最新功能👇
 函数 `move` 即将被弃用，请用新类 `Animation` 来代替
 - [X] The class `Singleton` is about to be deprecated and singleton mode classes will no longer be available in subsequent releases  
 类 `Singleton` 即将被弃用，后续版本中将不再提供单例模式类
+- [X] The class `Animation` adds the parameter `callback` to extend the functionality  
+类 `Animation` 新增参数 `callback` 来扩展功能
 
 ### Template Demo/模板演示
 

tkintertools/__init__.py

@@ -48,14 +48,14 @@ from .__main__ import *
 from .constants import *
 
 __author__ = 'Xiaokang2022<2951256653@qq.com>'
-__version__ = '2.6.8.dev0'
+__version__ = '2.6.8.dev1'
 __all__ = [
     # Container Widgets
     'Tk', 'Toplevel', 'Canvas',
     # Virtual Canvas Widgets
     'Label', 'Button', 'CheckButton', 'Entry', 'Text', 'Progressbar',
     # Tool Classes
-    'PhotoImage', 'Singleton',
+    'PhotoImage', 'Singleton', 'Animation',
     # Tool Functions
     'move', 'text', 'color', 'askfont', 'SetProcessDpiAwareness',
 ] + all_constants

tkintertools/__main__.py

@@ -1397,6 +1397,7 @@ class Animation:
         start=None,  # type: Callable | None
         step=None,  # type: Callable | None
         stop=None,  # type: Callable | None
+        callback=None,  # type: Callable[[float]] | None
         canvas=None  # type: tkinter.Canvas | None
     ):  # type: (...) -> None
         """
@@ -1409,6 +1410,7 @@ class Animation:
         `start`: 动画开始前执行的函数 \ 
         `step`: 动画每一帧结束后执行的函数（包括开始和结束）\ 
         `stop`: 动画结束后执行的函数 \ 
+        `callback`: 回调函数，每一帧调用一次，传入参数为单帧占比 \ 
         `canvas`: 当 widget 是画布中的绘制对象时，应指定 canvas
         """
         self.widget = widget
@@ -1423,6 +1425,7 @@ class Animation:
         self.count = ms * fps // 1000  # 总帧数
         if self.count == 0:
             self.count = 1  # 至少一帧
+        self.callback = callback
         self.parts = self._parts(*control)
 
     def _parts(self, control, up, down):
@@ -1446,6 +1449,7 @@ class Animation:
             self.color[0](color(self.color[1:], sum(self.parts[:_ind + 1])))
 
         None if self.step is None else self.step()
+        None if self.callback is None else self.callback(self.parts[_ind])
 
     def _translate(self, dx, dy):  # type: (int, int) -> None
         """ 平移 """