图片

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对象。