Ctrl+K
v0.5
Tags
v0.2
v0.3
v0.4
v0.5
v0.6
v0.7
v1.0
Branches
dev
main
External links
K210 CanMV
K210 CanMV Docs
K230 Docs
K230 CanMV Docs

image 图像处理 API手册

image 图像处理 API手册#

移植于openmv，与openmv功能相同，详细请参考官方文档，以下仅列出与官方API的差异部分及新增API。

类 Image#

图像对象是机器视觉操作的基本对象。 image支持从micropython gc，mmz，heap，vb区域创建，REF为在参考对象内存上直接生成image。 未使用的image对象会在执行gc回收时自动释放，用户也可手动执行释放，此时申请的图像内存会立即归还到系统。

image支持的格式：

  • BINARY

  • GRAYSCALE

  • RGB565

  • BAYER

  • YUV422

  • JPEG

  • PNG

  • ARGB8888 (新增格式)

  • RGB888 (新增格式)

  • RGBP888 (新增格式)

  • YUV420 (新增格式)

image支持的分配区域：

  • ALLOC_MPGC：micropython管理的内存

  • ALLOC_HEAP：系统堆内存

  • ALLOC_MMZ：多媒体内存

  • ALLOC_VB：视频缓冲区

  • ALLOC_REF：不分配内存，使用参考对象内存

构造函数#

class image.Image(path, alloc=ALLOC_MMZ, cache=True, phyaddr=0, virtaddr=0, poolid=0, data=None)

从path中的文件创建一个图像对象，支持bmp/pgm/ppm/jpg/jpeg格式的图像文件。

class image.Image(w, h, format, alloc=ALLOC_MMZ, cache=True, phyaddr=0, virtaddr=0, poolid=0, data=None)

创建一个指定大小格式的图像对象。

  • w: 图像宽度

  • h: 图像高度

  • format: 图像格式

  • alloc: 图像创建内存位置，可选参数，默认ALLOC_MMZ

  • cache: 使能内存cache，可选参数，默认True

  • phyaddr: 图像数据的物理内存地址，仅在VB区域中创建有效

  • virtaddr: 图像数据的虚拟内存地址，仅在VB区域中创建有效

  • poolid: VB poolid，仅在VB区域中创建有效，可选参数

  • data: 参考对象，可用于初始化image数据，可选参数

示例：

# 在MMZ区域创建一个ARGB8888 640*480的图像：
img = image.Image(640,480,image.ARGB8888)
# 在VB区域创建一个YUV420 640*480的图像：
img = image.Image(640,480,image.YUV420,alloc=image.ALLOC_VB,phyaddr=xxx,virtaddr=xxx,poolid=xxx)
# 使用REF创建一个RGB888 640*480的图像：
img = image.Image(640,480,image.RGB888,alloc=image.ALLOC_REF,data=buffer_obj)
img = image.Image(640,480,image.RGB888,alloc=image.ALLOC_REF,data=ulab_obj)
# 立即释放图像内存
del img
gc.collect()

函数#

新增函数#

phyaddr#
image.phyaddr()

获取image数据的物理内存地址。

virtaddr#
image.virtaddr()

获取image数据的虚拟内存地址。

poolid#
image.poolid()

获取image数据的VB poolid。

to_rgb888#
image.to_rgb888(x_scale=1.0[, y_scale=1.0[, roi=None[, rgb_channel=-1[, alpha=256[, color_palette=None[, alpha_palette=None[, hint=0[, alloc=ALLOC_MMZ, cache=True, phyaddr=0, virtaddr=0, poolid=0]]]]]]]])

转换图像格式为RGB888，返回一个新图像对象。 除原生支持格式外，额外添加RGB888格式支持，其它格式不支持。

copy_from#
image.copy_from(src_img)

拷贝src_img到img。

copy_to#
image.copy_to(dst_img)

拷贝img到dst_img。

to_numpy_ref#
image.to_numpy_ref()

将image类转换成numpy类，转换完成后numpy与image指向的是同一块数据，在numpy使用完成之前不能删除image，支持格式GRAYSCALE、RGB565、ARGB8888、RGB888、RGBP888。

差异函数#

图像变换API#

  • to_bitmap

  • to_grayscale

  • to_rgb565

  • to_rainbow

  • to_ironbow

  • to_jpeg

  • to_png

  • copy

  • crop

  • scale

以上API的crop参数失效，新增分配方式参数，总是返回一个新图像对象，图像对象的分配参数参考构造函数。

compress与compressed新增分配方式参数，总是返回一个新图像对象。 compress_for_ide与compressed_for_ide新增分配方式参数，总是返回一个新图像对象。

除原生支持格式外，额外添加RGB888格式支持，其它格式不支持。

画图API#

除原生支持格式外，额外添加ARGB8888、RGB888格式支持，其它格式不支持。

BINARY API#

binary新增分配方式参数，仅在copy=True时有效。

POOL API#

mean_pooled和midpoint_pooled新增分配方式参数。

其它图像算法API#

只支持原生格式，RGB888格式需要经过转换后才能使用。

目录