DearPyGui纹理与图像处理技术详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00680/article/details/148378323

DearPyGui纹理与图像处理技术详解

DearPyGui Dear PyGui: A fast and powerful Graphical User Interface Toolkit for Python with minimal dependencies 项目地址: https://gitcode.com/gh_mirrors/de/DearPyGui

纹理系统概述

DearPyGui作为一款现代GUI框架，其核心渲染机制基于GPU加速。在图像显示方面，它采用了纹理(Texture)这一计算机图形学中的重要概念。纹理本质上是存储在GPU内存中的图像数据，通过纹理注册表(Texture Registry)进行统一管理。

纹理类型与应用场景

DearPyGui提供了三种纹理类型，分别针对不同的使用场景：

1. 静态纹理(Static Texture)

特点：

适用于不频繁变化的图像
通常在程序初始化时加载
更新需要删除后重建
支持多种数据格式：Python列表、元组、numpy数组等

典型应用：

程序界面背景图
静态图标资源
不频繁更新的图表数据

代码示例：

# 创建100x100的紫色纹理
texture_data = []
for i in range(100 * 100):
    texture_data.extend([1.0, 0.0, 1.0, 1.0])  # RGBA格式

with dpg.texture_registry():
    dpg.add_static_texture(width=100, height=100, 
                          default_value=texture_data, 
                          tag="static_tex")

2. 动态纹理(Dynamic Texture)

特点：

适合中小尺寸且需要每帧更新的图像
支持运行时更新内容（但尺寸不可变）
内置安全检查和数据转换
性能介于静态和原始纹理之间

典型应用：

实时数据可视化
动态生成的图表
交互式图像处理

代码示例：

def update_texture(sender):
    new_color = dpg.get_value(sender)
    normalized = [c/255 for c in new_color]
    new_data = [val for _ in range(100*100) for val in normalized]
    dpg.set_value("dynamic_tex", new_data)

with dpg.texture_registry():
    dpg.add_dynamic_texture(100, 100, initial_data, tag="dynamic_tex")

3. 原始纹理(Raw Texture)

特点：

专为高性能场景设计
仅接受数组类型数据
无安全检查，开发者需自行确保数据正确性
支持更多数据格式

典型应用：

大规模科学计算可视化
实时视频处理
高性能游戏开发

代码示例：

import numpy as np

# 使用numpy数组创建纹理
texture_array = np.zeros((100, 100, 4), dtype=np.float32)
texture_array[:,:,:] = [1.0, 0.0, 1.0, 1.0]  # 紫色

with dpg.texture_registry():
    dpg.add_raw_texture(100, 100, texture_array, 
                       format=dpg.mvFormat_Float_rgba,
                       tag="raw_tex")

纹理格式支持

DearPyGui支持多种纹理格式，不同纹理类型的支持情况如下：

| 格式类型 | 静态纹理 | 动态纹理 | 原始纹理 | |-----------------------|----------|----------|----------| | mvFormat_Float_rgba | ✓ | ✓ | ✓ | | mvFormat_Float_rgb | - | - | ✓* | | mvFormat_Int_rgba | - | - | - | | mvFormat_Int_rgb | - | - | * |

注意：mvFormat_Float_rgb格式目前在macOS上不受支持

图像加载与保存

图像加载

DearPyGui提供了load_image函数，支持多种常见图像格式：

# 加载图像文件
image_info = dpg.load_image("example.png")
if image_info:
    width, height, channels, data = image_info
    # 创建纹理...

支持格式：JPEG、PNG、BMP、PSD、GIF、HDR等主流格式。

图像保存

从1.4版本开始，DearPyGui新增了save_image功能：

# 保存图像数据
dpg.save_image(file="output.png", 
              width=width, 
              height=height,
              data=pixel_data,
              components=3)  # 3表示RGB格式

支持格式：PNG、JPG、BMP、TGA、HDR等，通过文件扩展名自动识别格式。