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