跳到主要内容

Img

图片句柄：仅本次运行有效，不能返回或写入 State；带出时用 ToBase64/ToBytes 或 qk.Image.Save。变换返回新图，不改原图；结果单边最多 32768、最多 4000 万像素（否则 LIMIT_EXCEEDED）。

属性​

属性类型说明
Widthint宽（像素）。
Heightint高（像素）。

Img.Crop​

Img Crop(Rect area)

裁剪（图内像素坐标），返回新图；超出范围报 INVALID_ARGUMENT。

参数声明说明
Rect area见本成员和所在域的说明。

返回类型：Img。空值、用户取消和异常行为以成员及域说明为准。

Img.Resize​

Img Resize(int width, int height = 0)

缩放到指定尺寸，返回新图。

参数声明说明
int width见本成员和所在域的说明。
int height = 0高；0 为按宽等比。

返回类型：Img。空值、用户取消和异常行为以成员及域说明为准。

Img.Scale​

Img Scale(double factor)

按比例缩放（如 0.5），返回新图。

参数声明说明
double factor见本成员和所在域的说明。

返回类型：Img。空值、用户取消和异常行为以成员及域说明为准。

Img.Rotate​

Img Rotate(int degrees)

顺时针旋转，返回新图。

参数声明说明
int degrees角度（90 的倍数）。

返回类型：Img。空值、用户取消和异常行为以成员及域说明为准。

Img.Grayscale​

Img Grayscale()

灰度，返回新图。

返回类型：Img。空值、用户取消和异常行为以成员及域说明为准。

Img.Invert​

Img Invert()

反色，返回新图。

返回类型：Img。空值、用户取消和异常行为以成员及域说明为准。

Img.ToBytes​

byte[] ToBytes(string format = "png", int quality = 90)

编码为字节（可返回或写入文件）；编码结果最多 256 MiB，编码失败报 IMAGE_ENCODE_FAILED。

参数声明说明
string format = "png"png|jpg|bmp。 取值：png、jpg、bmp。
int quality = 90JPEG 质量 1–100（只用于 jpg）。

返回类型：byte[]。空值、用户取消和异常行为以成员及域说明为准。

Img.ToBase64​

string ToBase64(bool dataUri = false, string format = "png", int quality = 90)

编码为 Base64 文本（可返回）；默认 PNG。

参数声明说明
bool dataUri = false带 data URI 前缀（如 data:image/png;base64,）。
string format = "png"png|jpg|bmp。 取值：png、jpg、bmp。
int quality = 90JPEG 质量 1–100（只用于 jpg）。

返回类型：string。空值、用户取消和异常行为以成员及域说明为准。

Img.Dispose​

void Dispose()

提前释放像素（循环中大量取图时使用）；之后再用本句柄报错。停止后的 finally 中也可调用。

返回类型：void。空值、用户取消和异常行为以成员及域说明为准。