Python PIL putpixel触发TypeError：颜色需为int或tuple的解决求助

我正在开发一个基于PIL库的图像渲染Python脚本，调用putpixel方法时触发错误：TypeError: color must be int or tuple。推测问题出在RenderEngine类的ray_trace方法（负责计算每个像素颜色）中。

完整代码 #

[原代码内容]

报错信息 #

[原报错栈内容]

错误原因 #

PIL的putpixel方法对颜色参数有严格要求：

• 单通道灰度图：必须传入0-255范围内的整数
• 多通道图像（如RGB/RGBA）：必须传入由0-255整数组成的元组（3元组对应RGB，4元组对应RGBA）

你的ray_trace方法返回的颜色值不符合上述要求，常见场景包括：

• 返回了0-1范围的浮点数元组（如(0.6, 0.8, 1.0)）
• 返回了列表而非元组
• 返回了其他非整数/非元组类型（如字符串、自定义对象）

解决方法 #

1. 修正ray_trace的返回值格式 #

确保方法最终输出符合putpixel的要求，以RGB颜色为例：

def ray_trace(self, ray):
    # 原有颜色计算逻辑，得到0-1范围的浮点数值
    r_float, g_float, b_float = self._calculate_color(ray)
    
    # 转换为0-255的整数，并限制范围
    r = max(0, min(255, int(round(r_float * 255))))
    g = max(0, min(255, int(round(g_float * 255))))
    b = max(0, min(255, int(round(b_float * 255))))
    
    # 返回合法的元组
    return (r, g, b)

2. 调用putpixel前添加格式校验（可选） #

如果无法直接修改ray_trace，可以在调用前对颜色值做转换：

color = render_engine.ray_trace(ray)

# 处理列表转元组
if isinstance(color, list):
    color = tuple(color)

# 处理浮点数转整数并限制范围
if isinstance(color, tuple):
    color = tuple(max(0, min(255, int(round(c)))) for c in color)

image.putpixel((x, y), color)

内容的提问来源于stack exchange，提问作者FrostDream