Python DearPyGui 常用控件二

增量时间与内部时钟

Dear PyGui 有一个内置的时钟，用于检查应用程序运行的总时间 get_total_time，该时间以秒为单位。通过 get_delta_time() 方法，我们可以检查渲染的每帧之间的时间差，同样是以秒为单位。

from dearpygui.core import *
from dearpygui.simple import *add_additional_font('三极中柔宋.ttf', 18, glyph_ranges='chinese_simplified_common')def on_render(sender, data):delta_time = str(round(get_delta_time(), 4))total_time = str(round(get_total_time(), 4))set_value("delta_time", delta_time)set_value("total_time", total_time)with window("Tutorial"):add_text("应用运行的总时间: ")add_same_line()add_label_text("##total_time_text", source="total_time")add_text("应用刷新的时间差: ")add_same_line()add_label_text("##delta_time_text", source="delta_time")
set_render_callback(callback=on_render)start_dearpygui()

精灵(Sprites)

“精灵(Sprites)” 的概念通常用于游戏开发中，而 DearPyGui 是对 Dear ImGui 游戏类框架的包装，因此， DearPyGui 中也有精灵这个概念。从技术上讲，精灵就是一个可以不断变化的图片，这些变化包括：位置移动、旋转（以自身几何中心或以某个屏幕坐标为轴）、放大缩小、运动（按一定时间间隔连续显示一系列图像，形成运动效果）。

通过带有 tag 的图像、get_delta_time 和渲染时触发的 set_render_callback 回调方法，我们可以创建一个 精灵角色(Sprite Character)，我们会用到下面这张图像：

再通过 add_drawing 开始绘制，就可以通过具体的绘制方法来添加控件了。同样的，画布的原点位于左下角。

from dearpygui.core import *
from dearpygui.simple import *add_additional_font('三极中柔宋.ttf', 18, glyph_ranges='chinese_simplified_common')def on_render(sender, data):delta_draw_time = get_data("delta_draw_time")draw_speed = get_value("Draw Pause")if delta_draw_time > draw_speed:if get_value("Fly Mode") == 0:if get_data("sprite1"):draw_image("Drawing_1", 'SpriteMapExample.png', top_left, pmax=bottom_right, uv_min=[.7690, 0],uv_max=[.8074, .10], tag="sprite")add_data("sprite1", False)else:draw_image("Drawing_1", 'SpriteMapExample.png', top_left, pmax=bottom_right, uv_min=[.8074, 0],uv_max=[.8461, .10], tag="sprite")add_data("sprite1", True)else:if get_data("sprite1"):draw_image("Drawing_1", 'SpriteMapExample.png', top_left, pmax=bottom_right, uv_min=[.8464, 0],uv_max=[.8848, .10], tag="sprite")add_data("sprite1", False)else:draw_image("Drawing_1", 'SpriteMapExample.png', top_left, pmax=bottom_right, uv_min=[.8851, 0],uv_max=[.9235, .10], tag="sprite")add_data("sprite1", True)add_data("delta_draw_time", 0)else:add_data("delta_draw_time", delta_draw_time + get_delta_time())set_main_window_size(500, 500)with window("Tutorial"):add_drawing("Drawing_1", width=120, height=120)top_left = [100, 100]bottom_right = [50, 50]draw_image("Drawing_1", 'SpriteMapExample.png', top_left, pmax=bottom_right, uv_min=[.7687, 0], uv_max=[1, .10],tag="sprite")add_text("飞行模式:")add_radio_button("Fly Mode", items=["禁用", "启用"], default_value=0)add_slider_float("Draw Pause", label="快~慢", default_value=0.1, min_value=0.0, max_value=1.0,tip="通过等待 Elapsed Time 来降低绘制速度", format="%.4f")set_render_callback(on_render)add_data("delta_draw_time", 0.0)add_data("sprite1", True)start_dearpygui()

表格

Dear PyGui 有一个调用简单的表格 API，可以实现静态和动态的表格。先通过调用 add_table() 方法以启动表格控件，然后如果要编辑表格，可以使用 add_row() 和 add_column() 方法将行/列追加到表格的最后。

另外，还可以使用 insert_row 和 insert_column 方法插入行/列，列和行根据其 ***_index 参数插入，如果指定的 ***_index 参数已经存在，则会采取覆盖操作。默认情况下，添加或插入的行/列将用空值填充单元格。

from dearpygui.core import *
from dearpygui.simple import *add_additional_font('三极中柔宋.ttf', 18, glyph_ranges='chinese_simplified_common')with window("Tutorial"):add_table("Table Example", ["标题 0", "标题 1"])add_row("Table Example", ["行 0", "文本内容"])add_row("Table Example", ["行 2", "文本内容"])add_column("Table Example", "标题 3", [{'a': 1}, {'b': 2}])insert_row("Table Example", 1, ["行 1", "插入行", "插入行"])insert_column("Table Example", 2, "标题 2", ["插入列", "插入列", "插入列"])start_dearpygui()

此外，标题和单元格可以重命名/更改。

from dearpygui.core import *
from dearpygui.simple import *add_additional_font('三极中柔宋.ttf', 18, glyph_ranges='chinese_simplified_common')def modify_tables(sender, data):log_debug(f"表格名称: {sender}")coord_list = get_table_selections("Table Example")log_debug(f"选中的单元格 (坐标): {coord_list}")for coordinates in coord_list:set_table_item("Table Example", coordinates[0], coordinates[1], "新值")set_headers("Table Example", ["新标题 0", "新标题 1", "新标题 2"])show_logger()with window("Tutorial"):add_spacing(count=5)add_button("修改选定的表值", callback=modify_tables)add_spacing(count=5)add_table("Table Example", ["标题 0", "标题 1"])add_row("Table Example", ["文本内容", "文本内容"])add_row("Table Example", ["文本内容", "文本内容"])add_column("Table Example", "标题 2", ["文本内容", "文本内容"])add_row("Table Example", ["文本内容"])start_dearpygui()

上面的两个栗子中，表格的单元格是可选的，这意味着我们可以将回调方法应用于表格，并获取单元格中的内容。

from dearpygui.core import *
from dearpygui.simple import *add_additional_font('三极中柔宋.ttf', 18, glyph_ranges='chinese_simplified_common')def table_printer(sender, data):log_debug(f"表格名称: {sender}")coord_list = get_table_selections("Table Example")log_debug(f"选中的单元格 (坐标): {coord_list}")names = []for coordinates in coord_list:names.append(get_table_item("Table Example", coordinates[0], coordinates[1]))log_debug(names)show_logger()with window("Tutorial"):add_table("Table Example", ["标题 0", "标题 1"], callback=table_printer)add_row("Table Example", ["文本内容", "文本内容"])add_row("Table Example", ["文本内容", "文本内容"])add_column("Table Example", "标题 3", ["文本内容", "文本内容"])add_row("Table Example", ["文本内容"])start_dearpygui()