TESTRENDER(1)

📦
version 1.15.4.0 · 4 versions
, in fedora 44

✨ NAME ✨

testrender — Test Renderer for Open Shading Language 🎨

🦋 SYNOPSIS 🦋

testrender [options] scene.xml outputfilename

💖 DESCRIPTION 💖

okay so bestie, meet testrender — the Test Renderer for Open Shading Language, and the copyright on this icon belongs to the Copyright Contributors to the Open Shading Language project. 👑 she's giving renderer, she's giving test harness, she's giving let me visualize your shaders.

here's the whole menu of flags, no skips, no cuts, all of it 🫶

  • --help — print the help message
  • -v — verbose output (she talks a LOT, we love that for her)
  • -t NTHREADS — set the thread count (default = 0, which means auto-detect the number of cores)
  • --res XRES YRES — set resolution
  • --optix — use OptiX if it's available
  • --debug — lots of debugging info
  • --debug2 — even MORE debugging info 💀
  • --runstats — print run statistics
  • --profile — print profile information
  • --saveptx — save the generated PTX (OptiX mode only!!)
  • --warmup — perform a warmup launch
  • --res W H — set the resolution of the output image to W x H
  • -aa N — trace NxN rays per pixel
  • --no-jitter — disable AA pixel jitter
  • -albedo SCALE — visualize the albedo of each pixel instead of path tracing
  • -normals — visualize the shading normals instead of path tracing
  • -geonormals — visualize the geometric normals instead of path tracing
  • -utangents — visualize the surface tangent with respect to the u texture coordinate instead of path tracing
  • -vtangents — visualize the surface tangent with respect to the v texture coordinate instead of path tracing
  • -uvs — visualize the texture coordinates instead of path tracing
  • --iters N — number of iterations
  • -O0 — do no runtime shader optimization
  • -O1 — do a little runtime shader optimization
  • -O2 — do lots of runtime shader optimization
  • --llvm_opt LEVEL — LLVM JIT optimization level
  • --optix_no_inline — disable function inlining when compiling for OptiX
  • --optix_no_inline_layer_funcs — disable inlining the group layer functions when compiling for OptiX
  • --optix_no_merge_layer_funcs — disable merging group layer functions with only one caller when compiling for OptiX
  • --optix_no_inline_rend_lib — disable inlining the rend_lib functions when compiling for OptiX
  • --optix_no_rend_lib_bitcode — don't pass LLVM bitcode for the rend_lib functions to the ShadingSystem
  • --optix_no_inline_thresh THRESH — don't inline functions larger than the threshold when compiling for OptiX
  • --optix_force_inline_thresh THRESH — force inline functions smaller than the threshold when compiling for OptiX
  • --debugnan — turn on 'debugnan' mode
  • --path SEARCHPATH — specify the oso search path
  • --options LIST — set extra OSL options
  • --texoptions LIST — set extra TextureSystem options

and that's the whole page, bestie, no notes 💅 this was testrender, manual page 1, from testrender 1.15.4.0, dated May 2026 — go render something iconic 🌈✨🦋

📦 where this page comes from