On this page |
The Render viewer pane renders the scene and can automatically preview changes quickly as you edit parameters.
This pane’s viewing interface is nearly identical to the standard image viewer , except that the render viewer cannot show multiple viewports at once. See how to use the image viewer for information on how to work with images in the render viewer.
How to ¶
To... | Do this |
---|---|
Zoom and pan around the rendered image |
Hold and drag to pan. Hold and drag, or use to zoom. |
Only update a sub-region of the image |
Hold ⇧ Shift and drag a box around the area you want to render. The render view will only update this area. Shift-click outside the image to clear the region. Shift-click on the image to move the region. |
Inspect a pixel in the rendered image |
Ctrl-click the pixel in the render view. By default, Houdini will print information about the pixel and open the associated object’s shader palette. You can override this behavior by overriding the “pick pixel” script. |
Edit the material affecting a pixel |
Hold ⇧ Shift + ⌃ Ctrl and click the pixel in the render view. If the corresponding object has a material assigned, the parameter editor for the material will pop up in a floating pane. |
Edit the stylesheet rules affecting a pixel |
Turn on Inspect Material Style Sheets in the top render toolbar. This tells mantra to include stylesheet metadata in the render, so turning it on will cause a re-render. Hold ⇧ Shift + ⌃ Ctrl and click the pixel in the render view. A floating pane will pop up with tabs containing the parameter editor for the material and a data tree with the corresponding stylesheet rows selected. |
Save the current image to the image history |
Click the snapshot button in the render history toolbar at the bottom of the render view. To give the image a unique name in history, enter it in the text box to the right of the snapshot button before you click it. |
Review saved images in the render history |
Use the slider in the render history toolbar at the bottom of the render view. Alternatively, you can choose an image by name in the pop-up at the left end of the toolbar, or click the previous and next buttons to move through the image history. To delete an image from the history, go to an image in the history and click the Remove button next to the pop-up menu. |
Compare the current image to an image from the render history |
|
Saving the rendered image ¶
You can manually save the current contents of the render view to a series of images, or set up auto-save to save the contents at intervals during rendering.
To... | Do this |
---|---|
Set the save location |
Edit the file path next to the save icon in the snapshot toolbar the bottom of the render view. |
Manually save the image |
Click the icon in the snapshot toolbar at the bottom of the render view. |
Auto-save every ‹n› seconds |
When this is on, Houdini will periodically save the current view contents during rendering. |
Tip
The default image file path includes the $SAVENUM
variable. This integer increases with every save, ensuring each time you save it creates a new file. You should be careful about filling up available disk space if you use auto-save.
If you remove the $SAVENUM
variable from the path, each save will overwrite the previous save (the default path also includes $F
so separate frames would still save in separate files).
Render controls toolbar ¶
Render
Regenerates shadow maps and renders the scene again. Any time you move a light that uses shadow maps, or change the geometry, click Render to recompute depth and shadow maps.
This is disabled if you have not selected an output node to render.
Restart rendering
Restarts the current render. This will usually have no effect other than to recreate the exact same image.
Pauses rendering. Click again to resume.
Stop rendering
Stops rendering the scene. This is disabled if the view is not currently rendering.
Render node parameters
Opens a floating parameter editor for the selected render node.
Camera parameters
Opens a floating parameter editor for the selected camera node.
When this option is on, any parameter changes make the render view re-render. This lets you make changes in a node’s parameter interface and see the results in the render view interactively.
If you turn this option off, use the Render button at the left end of the toolbar when you want to update the render view manually.
When this option is on, the view will show progressively more detailed previews of the scene as it renders. This makes the final output take a little longer but lets you get a sense of what the image will look like much faster.
Whether to use the relighting buffer in the preview.
When this is on, mantra keeps a copy of the previous render. When a new pixel is rendered, mantra compares the new value to the value in the previous render. It uses the difference to influence the preview of nearby pixels, on the theory that neighboring pixels will generally update similarly. Mantra also uses the buffer to concentrate on sampling areas that have changed the most.
The buffer can be very helpful when you're changing lights and shaders. It is less helpful when you make a large change such as moving objects or the camera. In that case the previous render shows as a ghost image until the image is fully rendered.
Note
The relighting buffer does not affect the final render. It only attempts to improve the accuracy of the preview.
The relighting buffer exists only in memory, so killing a render will also delete the relighting buffer.
You’ll get the most accurate results if you let a render complete and then make lighting and shading changes, so the buffer contains the most possible samples.
Enables inspection of Material Style Sheets in the IPR viewer. Mantra will generate extra data to track which style sheets are applied at each pixel. The full evaluated style sheet can be found by ⌃ Ctrl + clicking on a pixel in the rendered result. ⇧ Shift + ⌃ Ctrl + click will open the style sheet in a Data Tree pane tab.
Enables the NVIDIA OptiX denoiser. The denoiser plugin is not installed, this button is disabled.
(In IPR, the denoiser always uses the “basecolor” image plane (if it exists) as the albedo input. On a render node, the corresponding render property lets you specify the plane to use for albedo.)
Update time
Time (in seconds) between preview passes. Mantra estimates the number of shading samples to use for the preview based on the speed of previous previews. So, if you have a faster machine, mantra will use more shading samples to generate a better preview in the given time.
Delay
Time (in seconds) between a parameter change and the auto-update. Increasing this time lets you combine small parameter changes when updating is slow.
Opens this help page.
Render history toolbar ¶
This toolbar lets you keep a history of rendered images from the render view. This is useful when you are playing with a parameter and want to compare the variations.
Remove Image from History
Delete the currently shown image from the render history. This button is disabled when the pop-up menu is set to “Active Render”.
Slider
Use the slider or click the previous and next buttons to move through the history of saved images.
Add Image to History
Save the active rendered image to the render history. To give the image a unique name in the history list, enter it in the text box to the right of the button before you click it.
Comparison slider
Use the slider to control the comparison. This is disabled when the Comparison method pop-up menu is set to Off.
Saves the current IPR render to a file. If the Active Render entry is selected from the snapshot menu, the render progress is saved. Otherwise, the selected snap shot is written out. It is possible to save an in-progress render.
Auto Save Path
The file path used to write auto save images. The file path extension is used to determine the image format. Enabled when the Auto Save button is toggled on.
When this option is on IPR render progress is periodically saved to disk. The image is written to the auto save path.
Auto Save Time
Time (in seconds) between automatic image saves. Enabled when the Auto Save button is toggled on.
Add custom functionality to the render viewer ¶
Use the iprview command to set the options of an IPR viewer pane.
Scripts ¶
The scripts in HOUDINIPATH/scripts/ipr
control the behavior of drag-and-drop onto the IPR viewer (dragdrop.py
), and ⌃ Ctrl click (pickpixel.py
) in the IPR viewer.
You can override the default behavior by inserting your own script(s) earlier in the path.