ImageDecoder

ImageDecoder - 20

版本

  • 名称: ImageDecoder (GitHub)

  • 域: main

  • 自版本: 20

  • 函数: False

  • 支持级别: SupportType.COMMON

  • 形状推断: True

此版本的运算符自版本 20起可用。

摘要

从文件中加载和解码图像。如果由于任何原因无法解码（例如，编码流损坏、格式无效，它将返回一个空矩阵）。支持以下图像格式

  • BMP

  • JPEG（注意：无损 JPEG 支持是可选的）

  • JPEG2000

  • TIFF

  • PNG

  • WebP

  • 可移植图像格式 (PBM、PGM、PPM、PXM、PNM) 解码后的图像遵循通道最后布局：(高度、宽度、通道)。JPEG 色度上采样方法：当将色度分量上采样 2 倍时，像素将进行线性插值，以便输出像素的中心位于输入像素中心的 1/4 和 3/4 处。舍入时，0.5 在交替像素位置向下和向上舍入，以防止偏向较大值（有序抖动模式）。考虑相邻的输入像素 A、B 和 C，B 上采样为像素 B0 和 B1，以便

B0 = round_half_down((1/4) * A + (3/4) * B)
B1 = round_half_up((3/4) * B + (1/4) * C)

此方法是完善的 libjpeg-turbo 库中的默认色度上采样方法，也称为“平滑”或“花哨”上采样。

属性

  • pixel_format - 字符串（默认值为 'RGB'）

    像素格式。可以是“RGB”、“BGR”或“灰度”之一。

输入

  • encoded_stream（异构） - T1

    编码流

输出

  • image（异构） - T2

    解码后的图像

类型约束

  • T1 in ( tensor(uint8) )

    将输入类型约束为 8 位无符号整数张量。

  • T2 in ( tensor(uint8) )

    将输出类型约束为 8 位无符号整数张量。