c ray

C射线

便携式，可入侵的，可嵌入的软件路径示踪剂。

示例渲染

（1000个样本，1920x1080，512最大弹跳，26分钟，Scott Graham的场景）

（256个样品，2560x1440，12最大弹跳，9分37秒，现场，Mattesr）

（512个样品，2560x1600，30最大弹跳，8分钟）

关于

C射线是用于学习的便携式，可入侵的离线CPU渲染引擎。核心处于普通的C99中，重点是清晰和避免多余的抽象。欢迎捐款。有关更多详细信息，请参见Wiki中的贡献部分。

功能的不完整列表：

• TCP/IP的集群渲染支持
• AC API
• Python结合
• 搅拌机附加
• 具有32+节点类型的节点图形材料/着色器系统，包括原则上的BSDF近似。
• 表演者BVH加速器（ @Madmann92）
• 带有全球照明的简单单向蒙特卡洛集成商
• 实时渲染预览和状态报告使用回调机制
• 简单的薄镜相机近似与景深
• 多线程
• 对象的实例
• HDR环境图现实照明
• 三角形和球
• 俄罗斯轮盘路径优化

我想实施的事情：

• 更高级的轻度采样
• 更好的性能和降低记忆消耗。
• 适当基于物理的材料代替当前的临时实施
• 研究文献的更酷的高级技术

可移植性

C射线已经过验证以在以下架构上工作

• x86＆x86_64（主要在x86_64上开发）
• ARMV6，ARMV7和ARMV8，AARCH64（各种覆盆子PI系统）
• PowerPC 7xx和74xx（PowerPC G3和G4系统）
• MIPS R5000（1996 SGI O2）
• Supersparc II（1992 Sun Sparcstation 10）
• WebAssembly与Emscripten

用法

一个基本的驱动程序程序可用于运行C射线独立运行（请参阅下面的“独立用法”），但是尝试C射线的最简单方法是构建和安装搅拌机附加组件，然后尝试使用：

1. 在lib.mk中检查BLENDER_ROOT ，确保它指向您已安装的搅拌机版本
2. 然后， make fullblsync将编译Python绑定（ cray_wrap.so ），并在BLENDER_ROOT下方安装作为附加组件。
3. 启用Blender首选项中的C射线附加组件，然后选择c-ray for Blender作为渲染引擎。
4. 通过在GitHub上提交问题来报告错误或丢失的功能（有很多！）

依赖性

编译时间：

• 标准C99编译器，带有一些相当常见的库（libc，libm，pthreads）

运行时：

• 构建系统的Cmake（可选，为 *nix系统提供基本的makefile）
• SDL2（可选，如果在运行时发现SDL2，则启用）
• Python3（可选，用于某些实用程序脚本）

测试

您可以通过像这样调用测试脚本来运行集成的测试套件： ./run-tests.sh这将使用正确的标志编译C射线，然后在单独的过程中单独运行每个测试。如果要在共享过程中运行它们，请执行bin/c-ray --test还可以运行一个套件./run-tests.sh mathnode

独立用法

如果您只对将C射线作为搅拌机插件运行感兴趣，则可以大多忽略下面的这些说明。

Linux：

1. （可选）安装SDL2（请参阅下面安装SDL）
2. 运行make建立项目
3. 如果普通的makefile在系统上不起作用，请运行cmake .然后尝试再次make 。
4. 运行二进制。例如： bin/c-ray input/hdr.json 。您也可以将文件管输送到c-ray中，它将从那里阅读。这对于调用c-ray的脚本很有用。示例： cat input/scene.json | bin/c-ray注意：当从stdin读取JSON时，C射线假设资产路径为./ 。这可以用--asset-path指定

macos：

1. 遵循Linux说明，或者您可以尝试mkdir build && cd build && cmake -G Xcode ..

视窗：

1. 安装视觉工作室的构建工具
2. 可选：从这里下载SDL2开发诽谤并提取：https：//www.libsdl.org/download-2.0.php（https://www.libsdl.org/release/sdl2-devel-2.0.8-8-vc.zip）
3. 打开Developer Command Prompt for VS 2019 ，导航到克隆C射线的位置并将路径设置为sdl2dir（将文件提取到的位置应具有一些文件夹，例如'Include'inclage'and lib'）： set SDL2DIR=E:sdl2SDL2-devel-2.0.8-VCSDL2-2.0.8
4. 运行CMAKE： cmake -G "Visual Studio 16 2019" .
5. （可选）将您的SDL2.dll复制到binRelease and binDebug
6. 构建生成的解决方案： msbuild c-ray.sln /p:Configuration=Release
7. 运行： binReleasec-ray.exe inputscene.json或type inputscene.json | binReleasec-ray.exe

用法

input/中的所有.json文件都是带有C射线的测试场景，这些场景的资产（主要）也与存储库捆绑在一起。

如果您制作一个很酷的场景并安装了Python3，则可以使用scripts/bundle.py脚本将场景捆绑到便携式.zip文件中。

学分

该项目中包含的第三方库包括：

• lodepng png压缩库：http：//lodev.org/lodepng/
• SEAN BARRETT：https：//github.com/nothings/stb/blob/master/master/stb_image.h
• SDL2：https：//www.libsdl.org/index.php（可选）
• JSON解析库：https：//github.com/davegamble/cjson
• PCG随机数生成器：http：//www.pcg-random.org

贡献者

• 非常感谢 @Madmann91的BVH加速器，总体绩效提高了约60％

请提出一个问题，详细说明您计划进行的任何改进。我公开欢迎捐款！

您也可以在Discord上ping我： vkoskiv#3100