NVIDIA OptiX でレイトレーシングアプリをデバッグ

OptiX Toolkit の概要とライセンス

NVIDIA OptiX Toolkit (OTK) は GPU 光線追跡アプリケーションの一般的なワークフローをサポートするユーティリティ群であり、BSD 3 クロースタイルライセンスの下でコードのコピーや修正が自由に行える。

エラー検出とログの確認

OptiX デバイスコンテキストの作成時に設定する検証モードを「OPTIX_DEVICE_CONTEXT_VALIDATION_MODE_ALL」にすることで、API 関数への入力値が正しく検証され、エラーコードや人間 readable なメッセージがログに出力される。

デバッグ時の推奨構成

検証機能には追加コストがかかるため、開発・テストビルドではすべての検証を有効にし、リリースビルドではこれを省略することが推奨されている。

エラーの早期検出と具体例

OTK は API エラーコードの一貫したチェックとデバイス側デバッグ印刷を提供し、後続の失敗が元の問題を隠蔽する前にエラーを検知するための「DemandPbrtScene」サンプルプログラムも含まれている。

エラーコードの共通メカニズム

OptiX、CUDA ランタイム API、CUDA ドライバー API はすべて、エラーコードを返す列挙型と、そのシンボル名・人間 readable なメッセージを取得する関数をサポートしている。