CLI 参考

完整的命令行参数说明。

基本用法

ray_tracer [选项] -o <输出文件>

通用选项

选项	默认值	说明
-o, --output <file>	output.ppm	输出文件路径
-w, --width <n>	800	图像宽度
-h, --height <n>	600	图像高度
--scene <name>	demo	预设场景名称
-v, --verbose	关闭	显示详细输出

渲染模式

选项	说明
-p, --path-trace	启用路径追踪模式
-s, --samples <n>	每像素采样数（路径追踪）

预设场景

名称	说明	球体数
demo	演示场景	10
cornell	Cornell Box	6
random	随机球体	100

示例

# 默认 Phong 着色
ray_tracer -o phong.ppm

# 4K 分辨率
ray_tracer -w 3840 -h 2160 -o 4k.ppm

# 路径追踪 128 采样
ray_tracer --scene cornell -p -s 128 -o cornell-128.ppm

# 高质量路径追踪
ray_tracer --scene cornell -p -s 512 -w 1920 -h 1080 -o high-quality.ppm

性能调优

# 使用 BVH 加速（默认开启）
ray_tracer --scene random -o fast.ppm

# 禁用 BVH（仅用于对比测试）
ray_tracer --scene demo --no-bvh -o slow.ppm