## ![](https://img.kancloud.cn/b5/c5/b5c554039e9ab32c4db9c408398e1237_34x34.png)**图像基础**
> `Imager`_用于图像的基础操作
*****
* [ ] ### **打开空图**【构造函数】
![](https://img.kancloud.cn/1c/84/1c84eaf8fd69401b87ac50883b590fa8_309x80.png)
> 打开一个空的图像对象,用于无图像但需调用`Imager`函数库
*参数:*
* 无
*****
* [ ] ### **打开图像**【构造函数】
![](https://img.kancloud.cn/37/30/373059b3f1a5d3a9368822df4253d196_488x80.png)
> 从指定路径中打开一个新的图像对象,图片将赋予给`image`变量
*参数:*
* `路径`: 打开的图像对象路径, 比如`/sd/MixPY.jpg`,支持`bmp` `pgm` `ppm` `jpg` `jpeg`格式的图像文件
*****
* [ ] ### **图像清除**
![](https://img.kancloud.cn/d1/93/d1930828a2e787b6dfcf8a0ff64e7f3a_345x80.png)
> 将指定的`image`图像中的所有像素设置为零,即黑屏显示
*参数:*
* `图像`:需传入`image`类型图像进行操作
*****
* [ ] ### **图像保存**
![](https://img.kancloud.cn/2d/8c/2d8ceb449d144084e67cfa5a17ae2462_343x140.png)
> 将图像对象保存于指定路径中
*参数:*
* `图像`:需传入`image`类型图像进行操作
* `路径`:保存的图像对象路径, 比如`/sd/MixPY.jpg`,支持`bmp` `pgm` `ppm` `jpg` `jpeg`格式的图像文件
*****
* [ ] ### **修改某点像素值**
![](https://img.kancloud.cn/51/f5/51f514f094d4f310b29a1e3d2f2cafa6_264x162.png)
> 设置修改图像某点像素值
*参数:*
* `图像`:需传入`image`类型图像进行操作
* `坐标-xy`:图像的`(x, y)`位置点
* `颜色`:将某点像素改为的颜色
* `RGB565`16 位的颜色值,比如![](https://img.kancloud.cn/42/ac/42ac0a2561488eaac090edf4cccd3b21_142x60.png)
* `RGB888`元组, 比如![](https://img.kancloud.cn/3f/6f/3f6f9f51c03c27b294b1e8fc602eff46_182x60.png)
*返回:*
* 彩色图,返回`(x, y)`位置的RGB888像素元组`(r, g, b)`
* 灰度图, 返回`(x, y)`位置的像素值`0-255`
> 不支持压缩图像
*****
* [ ] ### **获取某点像素值**
![](https://img.kancloud.cn/8d/35/8d3550505c5aa5b36a1a1795c1591fd1_276x122.png)
> 获取图像某点像素值
*参数:*
* `图像`:需传入`image`类型图像进行操作
* `坐标-xy`:图像的`(x, y)`位置点
*返回:*
* 彩色图,返回`(x, y)`位置的RGB888像素元组`(r, g, b)`
* 灰度图, 返回`(x, y)`位置的像素值`0-255`
> 不支持压缩图像
*****
* [ ] ### **图像截取**
![](https://img.kancloud.cn/8d/6b/8d6b7c5510d5a4ad00d9bb64d2afa6c9_340x124.png)
> 在图像上截取指定区域的图像
*参数:*
* `图像`:需传入`image`类型图像进行操作
* `区域-xywh`:为列表类型,截取图像的起点坐标`x,y`,长`w`,高`h`的矩形的感兴区域,即`(x, y, w, h)`区域
![](https://img.kancloud.cn/79/5e/795e263151a413aaf51c8709b297f5d0_271x210.png)
*返回:*
* 返回一个`image`类型图像对象
> 不支持压缩图像
*****
* [ ] ### **图像压缩**
![](https://img.kancloud.cn/3f/0e/3f0e2d85bd5a3b3d573989d320d78bd3_241x121.png)
> 对图像进行适当压缩
*参数:*
* `图像`:需传入`image`类型图像进行操作
* `压缩率`:整形类型,填写压缩质量`(0-100)`%
*返回:*
* 返回一个`image`类型图像对象
*****
* [ ] ### **图像信息**
![](https://img.kancloud.cn/d2/45/d2455782894af1a052db9f80ea72a63e_467x166.png)
> 获取图像的宽度分辨率、高度分辨率、格式、大小信息
*参数:*
* `图像`:需传入`image`类型图像进行操作
*返回:*
* `宽度`:返回以像素计的图像的宽度
* `高度`:返回以像素计的图像的高度
* `格式`:返回`int`类型的图像的格式
* `1`:?
* `2`:`RGB565`的彩色图格式
* `3`:?
* `4`:`GRAYSCALE`的灰度图格式
* `大小`:返返回以字节计的图像大小
*****
* [ ] ### **图像转换**
![](https://img.kancloud.cn/31/8b/318b162688c31e13e96211527bf3bdf3_497x170.png)
> 将图像转换为灰度图、彩色图、彩虹图、AI格式图
*参数:*
* `图像`:需传入`image`类型图像进行操作
*返回:*
* `转换灰度图`:返回灰度图像对象
* `转换彩色图`:返回彩色图像对象
* `转换彩虹图`:返回彩虹图像对象
* `转换AI格式`:返回AI格式图对象
> 不支持压缩图像
> 彩虹图像是彩色图像,对于图像中的每个8位掩模灰度照明值具有唯一的颜色值。 例如,它为热图像提供热图颜色
> AI格式图是进行人工智能`KPU`处理需要使用一种图像类型
*****