Houdini Kit · John Fanny

Tips › Viewport

How to change the viewport background color in Houdini.

Three ways: the Display Options menu, a custom color file, or one click with a free Houdini Digital Asset (HDA).

Short answer: hover over the viewport, press D to open Display Options, go to the Background tab, and pick a preset in Color Scheme (Light, Dark, Grey and others, depending on your Houdini version).

Change it in Display Options

  1. Hover over the Scene View and press D. You can also click the Display Options button in the display toolbar, on the right side of the viewport.
  2. Open the Background tab.
  3. Choose a preset in the Color Scheme menu. The viewport updates right away.
  4. To keep it for every session, click Save as Default.
Opening Display Options with D in the Houdini viewport and changing the Color Scheme on the Background tab

Use a custom color

The menu has presets only, with no color picker. For your own color, override the preset's color file:

  1. In your Houdini install, open $HFS/houdini/config and find the 3DSceneColors files, one per preset (for example 3DSceneColors.dark).
  2. Copy the one you use into the config folder of your Houdini user directory, for example Documents/houdini20.5/config. Create the folder if it doesn't exist.
  3. Edit the background color values in the copy, save, and restart Houdini, or switch to another preset and back.

Your copy overrides the installed file. For a picture instead of a color, turn on Display Background Image in the same Background tab.

Switch it with Python

The color scheme is also available from Python, for a shelf tool or a startup script:

import hou

viewer = hou.ui.paneTabOfType(hou.paneTabType.SceneViewer)
for viewport in viewer.viewports():
    viewport.settings().setColorScheme(hou.viewportColorScheme.Dark)

Or switch it in one click

Switch Background adds a button to the Houdini viewport. Click to change the background in every viewport at once. Shift+click to open the menu: pick a preset, or set your own color, flat or as a top-to-bottom gradient. Your last custom backgrounds stay in the menu, one click to reapply, and the button loads with every session.

No Display Options. No config files.

Setting a custom flat and gradient viewport background in Houdini with Switch Background Get Switch Background

Free · Houdini 19.5+ · FAQ