如何将图像转换为灰度

提供图像数据后即可将其转换为灰度图像；不指定方法时使用 luminosity，指定精确值 average 时采用通道平均路径。成功结果会返回编码后的图像数据和原始尺寸。

先了解转换范围

这款工具用于把提供的图像数据转换为灰度图像，适合需要单色视觉效果、减少色彩信息或准备后续图像处理的场景。你可以使用默认的亮度转换方式，也可以指定 average，让工具采用单独的通道平均处理路径。这里的输入是图像数据，而不是图像名称或说明文字。

按步骤转换图像

1. 准备一份可读取的图像数据，并将其填入图像输入。输入可以留空，但空值会被视为没有提供图像数据，处理会失败。
2. 如需使用默认方式，不必指定转换方法；默认方法是 luminosity。如果要使用通道平均路径，将方法设置为精确值 average。不要把其他字符串理解为已验证的算法名称，因为其他值会继续沿用初始的灰度转换路径。
3. 执行处理并检查结果。成功时，结果会包含转换后的编码图像数据和原始图像尺寸。源图像格式可用时，输出沿用该格式；否则使用 PNG。
4. 如果没有得到成功结果，先确认输入确实包含可解码、可打开的图像数据，再检查图像处理依赖是否可用。解码、打开、转换或编码阶段发生异常，也会导致处理失败。

如何判断结果

成功结果应当同时体现两个方面：图像数据已经转换为灰度图像，并且返回了原始图像的尺寸。编码格式不一定固定为 PNG；当源图像格式可用时，会优先使用源格式，无法取得时才使用 PNG。

方法设置需要按条件解读。未指定方法时，采用 luminosity 默认路径；只有精确写成 average 时，才进入通道平均路径，其他值不会因此获得一个新的已验证算法。若输入为空，或图像无法解码、打开、转换或编码，不能把缺少成功结果当作正常的灰度输出。

使用示例

你有一张需要改成单色效果的 PNG 图片，希望保留其原始尺寸并获得可继续使用的图像数据。

准备一张可读取的 PNG 图像数据，不指定转换方法并执行处理，然后查看返回的图像数据、编码格式和原始尺寸。

成功结果包含灰度图像的编码数据和原始宽高；由于输入为 PNG，编码数据使用 PNG 格式。

使用限制

• 空输入、无法解码或打开的图像，以及转换或编码阶段出现异常时，处理可能失败。

常见错误

• 错误原因：输入为空，或提供的内容不是可读取的图像数据。纠正方法：重新提供包含实际图像内容且能够被解码、打开的数据后再执行处理。

常见问题

不提供图像数据可以转换吗？

可以，但空值会被视为没有图像数据，处理会失败。请提供可读取的图像数据后再执行转换。

默认使用哪种灰度转换方法？

未指定方法时使用 luminosity；只有精确值 average 会选择通道平均路径，其他值仍沿用初始灰度转换路径。

转换成功后会返回什么？

成功时，输出使用源图像格式（如果该格式可用），否则使用 PNG，并报告原始图像尺寸。