# 图片
图片类型内部使用pillow库处理图片，可以通过获取PIL Image对象后通过PIL库处理图片。 支持处理的图片格式：JPEG、PNG、BMP。
表1属性（Properties） 
| **属性名**   | **类型**          | **说明**                              |
|:---|:---|:---|
| filename  | str             | 图像的文件名或路径（如果从文件加载）。                 |
| format    | str             | 图像格式（如PNG、JPEG）。                    |
| height    | int             | 图像高度（像素）。                           |
| width     | int             | 图像宽度（像素）。                           |
| data      | bytes           | 图像数据。                               |
| pil_image | PIL_Image.Image | 动态属性：返回Pillow格式的图像对象（自动从data解码或缓存）。 |
   
表2方法（Methods） 
| **方法名**          | **参数**                                                                                                                                                                                                    | **返回值**    | **说明**                                            |
|:---|:---|:---|:---|
| __init__         | filename: Union\[str, os.PathLike\] = None data: Union\[str, PIL.Image\] = None format: Optional\[str\] = None | None       | 构造方法：从文件（filename）或数据（data）加载图像，支持bytes或Pillow对象。 |
| to_numpy         | ---                                                                                                                                                                                                       | np.ndarray | 将图像转换为NumPy数组（float32类型）。                         |
| resize           | new_shape: tuple\[int, int\]                                                                                                                                                                              | Image      | 返回调整尺寸后的新图像。                                      |
| show             | ---                                                                                                                                                                                                       | None       | 调用Pillow的默认图像查看器显示图像。                             |
| to_thumbnail     | size: tuple\[int, int\] = (100, 100)                                                                                                                                                                      | Image      | 生成指定尺寸的缩略图。                                       |
| from_struct（类方法） | obj: dict（需包含filename、data、format等字段）                                                                                                                                                                     | Image      | 从结构化字典创建Image对象。                                  |