更新时间：2025-12-18 GMT+08:00
图片
图片类型内部使用pillow库处理图片，可以通过获取PIL Image对象后通过PIL库处理图片。 支持处理的图片格式：JPEG、PNG、BMP。
| 属性名 | 类型 | 说明 |
|---|---|---|
| filename | str | 图像的文件名或路径（如果从文件加载）。 |
| format | str | 图像格式（如PNG、JPEG）。 |
| height | int | 图像高度（像素）。 |
| width | int | 图像宽度（像素）。 |
| data | bytes | 图像数据。 |
| pil_image | PIL_Image.Image | 动态属性：返回Pillow格式的图像对象（自动从data解码或缓存）。 |
| 方法名 | 参数 | 返回值 | 说明 |
|---|---|---|---|
| __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对象。 |
父主题： 多模态数据类型
