markusmoenig/DenrimRendererKit

DenrimRendererKit

DenrimRendererKit is a MoonRay-inspired Swift Package for high-quality Metal path tracing on Apple platforms. It is built for Denrim products, but the repository is kept useful as a standalone renderer: you can load scripted scenes, render material previews, benchmark backends, and use the Swift API directly from an app or tool.

The renderer and material system are shaped by MoonRay-style production rendering ideas: physically based layered materials, predictable scriptable scenes, useful diagnostics, and a path toward a polished Apple-native offline/preview renderer. DenrimRendererKit is not a MoonRay port or shader-compatible implementation; it uses MoonRay as a quality and material-design reference.

Features

• Progressive Metal path tracer with flat BVH fallback and Metal ray tracing traversal on supported devices.
• denrim CLI for rendering .denrim SceneScript files and built-in material previews.
• SceneScript with script-relative assets, includes, mesh instances, render defaults, and readable grouped arguments.
• OBJ and PLY mesh loading with preserved normals and UVs.
• ImageIO texture loading with explicit sRGB/linear handling, checker/solid/generated textures, and tangent-space normal maps.
• Direct emissive-triangle lighting, HDRI environment sampling, and benchmark timing reports.

• Rough dielectric, metal, clearcoat, thin-film, sheen/fuzz, transmission, absorption, volume scattering, and random-walk subsurface controls.
• Built-in material preset catalog with generated preview thumbnails.
• Beauty, depth, normal, albedo, material ID, object ID, and motion-vector outputs.
• Unit, parser, backend parity, AOV, and render smoke tests.

DiningRoom Preview

The DiningRoom scene lives at Examples/SceneScripts/Quality/DiningRoom/dining-room.denrim. It carries render defaults in the script itself:

render output ../../../Renders/DiningRoom.png size hd spp 512 quality final backend automatic

Run it with:

swift run -c release denrim -- Examples/SceneScripts/Quality/DiningRoom/dining-room.denrim

For a quick smoke render, override the script defaults:

swift run denrim -- Examples/SceneScripts/Quality/DiningRoom/dining-room.denrim \
    --output /tmp/denrim-dining-room.png \
    --width 320 \
    --height 180 \
    --samples 1 \
    --quality interactive

Materials

Built-in materials are exposed through BuiltInMaterialLibrary and SceneScript's material name preset preset-id form. The thumbnails below are generated with Examples/Tools/render-built-in-materials.sh.

| Preview | Preset | Category | Description | | --- | --- | --- | --- | | <img src="Examples/Renders/Materials/matte.clay.png" width="96" alt="Matte Clay" | matte.clay | Diffuse | Warm neutral diffuse clay for model previews. | | <img src="Examples/Renders/Materials/matte.paper.png" width="96" alt="Matte Paper" | matte.paper | Diffuse | Soft off-white paper with low specular response. | | <img src="Examples/Renders/Materials/matte.charcoal.png" width="96" alt="Matte Charcoal" | matte.charcoal | Diffuse | Dark rough diffuse surface. | | <img src="Examples/Renders/Materials/plastic.soft-black.png" width="96" alt="Soft Black Plastic" | plastic.soft-black | Plastic | Dark plastic with readable broad highlights. | | <img src="Examples/Renders/Materials/plastic.gloss-white.png" width="96" alt="Gloss White Plastic" | plastic.gloss-white | Plastic | White molded plastic with a clear glossy coat. | | <img src="Examples/Renders/Materials/rubber.black.png" width="96" alt="Black Rubber" | rubber.black | Plastic | Very rough black rubber. | | <img src="Examples/Renders/Materials/fabric.velvet-purple.png" width="96" alt="Purple Velvet" | fabric.velvet-purple | Fabric | Velvet-like fabric using the sheen/fuzz lobe. | | <img src="Examples/Renders/Materials/fabric.denim-blue.png" width="96" alt="Blue Denim" | fabric.denim-blue | Fabric | Rough blue fabric with a gentle grazing sheen. | | <img src="Examples/Renders/Materials/subsurface.skin-warm.png" width="96" alt="Warm Skin" | subsurface.skin-warm | Subsurface | Warm organic random-walk subsurface scattering. | | <img src="Examples/Renders/Materials/subsurface.wax-cream.png" width="96" alt="Cream Wax" | subsurface.wax-cream | Subsurface | Soft creamy wax with broad internal scattering. | | <img src="Examples/Renders/Materials/liquid.milk.png" width="96" alt="Milk" | liquid.milk | Liquid | Cloudy refractive liquid with absorption and volume scattering. | | <img src="Examples/Renders/Materials/subsurface.jade-green.png" width="96" alt="Green Jade" | subsurface.jade-green | Subsurface | Dense green stone with colored multiple scattering. | | <img src="Examples/Renders/Materials/metal.chrome.png" width="96" alt="Chrome" | metal.chrome | Metal | Polished neutral mirror-like metal. | | <img src="Examples/Renders/Materials/metal.aluminum.png" width="96" alt="Aluminum" | metal.aluminum | Metal | Clean bright aluminum. | | <img src="Examples/Renders/Materials/metal.brushed-aluminum.png" width="96" alt="Brushed Aluminum" | metal.brushed-aluminum | Metal | Anisotropic satin aluminum. | | <img src="Examples/Renders/Materials/metal.gold.png" width="96" alt="Gold" | metal.gold | Metal | Polished warm gold. | | <img src="Examples/Renders/Materials/metal.copper.png" width="96" alt="Copper" | metal.copper | Metal | Polished copper. | | <img src="Examples/Renders/Materials/coating.car-red.png" width="96" alt="Red Automotive Paint" | coating.car-red | Coating | Glossy red paint with a clearcoat layer. | | <img src="Examples/Renders/Materials/coating.pearl-white.png" width="96" alt="Pearl White Paint" | coating.pearl-white | Coating | Bright coated paint with subtle warm clearcoat tint. | | <img src="Examples/Renders/Materials/coating.iridescent-amber.png" width="96" alt="Iridescent Amber Coating" | coating.iridescent-amber | Coating | Glossy amber coated surface with thin-film color shift. | | <img src="Examples/Renders/Materials/glass.clear.png" width="96" alt="Clear Glass" | glass.clear | Glass | Clear solid dielectric glass. | | <img src="Examples/Renders/Materials/glass.frosted.png" width="96" alt="Frosted Glass" | glass.frosted | Glass | Rough transmissive glass. | | <img src="Examples/Renders/Materials/glass.thin-pane.png" width="96" alt="Thin Glass Pane" | glass.thin-pane | Glass | Zero-thickness glass pane for windows and tabletops. | | <img src="Examples/Renders/Materials/liquid.water.png" width="96" alt="Water" | liquid.water | Liquid | Clear water with IOR 1.333. | | <img src="Examples/Renders/Materials/ceramic.white.png" width="96" alt="White Ceramic" | ceramic.white | Ceramic | Glazed white ceramic. | | <img src="Examples/Renders/Materials/ceramic.porcelain.png" width="96" alt="Porcelain" | ceramic.porcelain | Ceramic | Smooth porcelain with soft off-white tint. | | <img src="Examples/Renders/Materials/emission.warm-panel.png" width="96" alt="Warm Light Panel" | emission.warm-panel | Emission | Warm white area-light material. | | <img src="Examples/Renders/Materials/emission.cool-panel.png" width="96" alt="Cool Light Panel" | emission.cool-panel | Emission | Cool white area-light material. |

Render a material preview directly:

swift run denrim -- material matte.clay --samples 64 --quality interactive
swift run denrim -- material liquid.milk --samples 1024 --quality final