Vane Data / API 参考

decode_image

decode_image 从 PNG/JPEG/TIFF/GIF/BMP/WebP 字节中解码第一张图像。mode=None 保留编码像素模式，默认转换为 RGB。

签名

example.py

vane.decode_image(bytes_expr, on_error="raise", mode="RGB") -> Expression

SQL：decode_image(bytes, on_error => ..., mode => ...)。Expression 方法：expr.decode_image(...)。

名称	类型	说明	默认值
bytes_expr	BLOB 值或 Expression	编码图像字节	必填
on_error	"raise" / "null"	"null" 只抑制损坏或不支持的内容	"raise"
mode	模式名、ImageMode、Expression 或 None	结果像素模式	"RGB"

返回动态 IMAGE，常量模式对应 IMAGE(mode)。NULL 返回 NULL。只有损坏或不支持的内容会遵循 on_error="null"，其他失败会传播。

example.py

import vane


con = vane.connect()
data = open("photo.png", "rb").read()
con.sql("SELECT decode_image($1)", params=[data]).show()