# CyclesRender

> Path-traced render of the same scene with Blender Cycles (headless).

| Node | CyclesRender |
|---|---|
| Menu | 3D › CyclesRender |
| **Names in each format** | |
| .oink comp (JSON) | `"type": "OC_N_cyclesrender"` |
| .nk script | none: written as an Oink node |
| Python | `nuke.createNode("OC_N_cyclesrender")` |
| Assistant (MCP) | `create_node(type="CyclesRender")` |
| Tab search | `cyclesrender`, or its initials `cr` |

![CyclesRender properties](/shots/nodes/cyclesrender@2x.webp)

## Inputs and outputs

| Port | Name | Type |
|---|---|---|
| input 0 | bg | image |
| input 1 | obj/scn | scene |
| input 2 | cam | scene |
| output 0 | Image | image |

## Knobs

Panel tab **Cyclesrender**, in panel order.

| Knob | Label | Type | Default | Range / values | .nk knob | Description |
|---|---|---|---|---|---|---|
| `samples` | samples | float | `32` | 1 to 4096 (integer) |  |  |
| `device` | device | menu | `GPU` | GPU, CPU |  |  |
| `denoise` | denoise | bool | `true` |  |  |  |
| `renderer` | renderer | menu | `auto` | auto, hdcycles (hdCycles), bridge (Blender bridge) |  |  |
| `blend_mode` | blend scene | menu | `auto` | auto, exact (exact (Blender)), fast (fast (in-app Cycles)) |  |  |
| `render_path` | render path | info |  |  |  |  |
| `ambient` | ambient | float | `0` | 0 to 1 |  |  |
| `motion_blur` | motion blur | bool | `false` |  |  |  |
| `shutter` | shutter | float | `0.5` | 0 to 2 |  |  |
| `shutteroffset` | shutter offset | menu | `start` | start, centred, end |  |  |
| `one_over_z` | 1/Z depth | bool | `true` |  |  |  |
| `output_depth` | depth | bool | `true` |  |  |  |
| `output_normal` | normal (N) | bool | `false` |  |  |  |
| `output_position` | position (P) | bool | `false` |  |  |  |
| `output_motion` | motion vectors | bool | `false` |  |  |  |
| `output_diffuse` | diffuse | bool | `false` |  |  |  |
| `output_glossy` | glossy | bool | `false` |  |  |  |
| `output_emission` | emission | bool | `false` |  |  |  |
| `output_ao` | AO | bool | `false` |  |  |  |
| `output_shadow` | shadow | bool | `false` |  |  |  |
| `output_crypto_object` | cryptomatte object | bool | `false` |  |  |  |
| `output_crypto_material` | cryptomatte material | bool | `false` |  |  |  |

### Other knobs (Python, .nk and the assistant; not on the panel)

| Knob | Label | Type | Default | Range / values | .nk knob | Description |
|---|---|---|---|---|---|---|
| `gl_color` | Viewer Controls Color | float ×3 | `0, 0, 0` | 0 to 1 |  |  |
| `postage_stamp_frame` | Static Frame | int | `1` | -2147483648 to 2147483647 |  |  |
| `lifetimeStart` | Lifetime Start | int | `0` | -2147483648 to 2147483647 |  |  |
| `lifetimeEnd` | Lifetime End | int | `100` | -2147483648 to 2147483647 |  |  |
| `useLifetime` | Use Lifetime | boolean | `false` |  |  |  |
| `cached` | Cached | boolean | `false` |  |  |  |
| `bookmark` | Bookmark | boolean | `false` |  |  |  |
| `dope_sheet` | Dope Sheet | boolean | `false` |  |  |  |
| `clone_group` | Clone Group | string |  |  |  |  |
| `link_source` | Link Source | string |  |  |  |  |
| `link_overrides` | Link Overrides | string |  |  |  |  |
| `split_views` | Split Views | string |  |  |  |  |


---
Sources: opencomp_core/nodes/three_d/render_nodes.py, opencomp_electron/src/components/properties/knobSchema.ts