Houdini 22.0 Reference Windows

Ramp Presets window

The Ramp Presets window lets you configure the presets available for ramp parameters.

On this page

Overview

This window displays the available presets for RGB color ramps and floating point (spline) ramps. Use this window to add, edit, and filter ramp presets. When Apply on Select is on, the preset you select in the Ramp Presets window gallery automatically applies to the ramp parameter in the parameter editor.

Each ramp parameter has a / Presets button that opens the dropdown presets menu. This menu lists only the ramp presets in the default folder or the folder set in the sidefx::ramp_gallery_folder tag. Click Show All to view all available ramp presets in the presets menu, or click the Open Gallery button to open the Ramp Presets window.

See Ramp parameters for more information about using ramps.

See Saving and using recipes for more information about using recipes.

Toolbar

Grid Layout

Display the ramp presets in a grid that previews the output in thumbnails. Use // to set the size of the grid.

Tree Layout

Display the ramp presets in a hierarchical tree of the folders that contain the preset files. This shows the preset label and a thumbnail image.

Split Layout

Display the ramp presets in a divided window, with a hierarchical tree of the folders that contain the preset files on the left and a grid that previews the output in thumbnails on the right. Use // to set the size of the grid.

Small Grid Layout

When using a Grid or Split Layout, display the ramp preset previews in small sized thumbnails.

Medium Grid Layout

When using a Grid or Split Layout, display the ramp preset previews in medium sized thumbnails.

Large Grid Layout

When using a Grid or Split Layout, display the ramp preset previews in large sized thumbnails.

Show Only Starred

Filter the presets so only starred presets are visible.

Search box

Type to filter the presets by label text and/or tags.

Show/Hide More Filters

Opens a sidebar with additional options for filtering.

Apply on Select

Automatically applies the selected preset to the ramp parameter in the parameter editor.

Organizing and filtering presets

Each preset includes pieces of metadata, some of which you can edit and filter.

Thumbnail

Each preset can point to an image file (usually a .jpg file) that depicts a view of the ramp.

Label

Each preset has a label that displays in the Tree Layout or when you hover over the ramp in Grid and Split Layout. Filter presets by their labels.

Folder

Presets are organized in a hierarchical tree of folders that contain the preset files. When you add a ramp recipe, set the Submenu to add the recipe in a specific subfolder.

The sidefx::ramp_gallery_folder tag sets which folder opens by default in the presets menu and Ramp Presets window.

Creation time

Filter presets by their creation times.

Star

Star a preset to make it easy to filter.

Color

Assign a color to a preset. This lets you quickly categorize presets for filtering. The Grid and Split Layouts display a preset’s color as a colored line above the thumbnail.

Tags

Associate an arbitrary list of tags (single words) with a preset in the Metadata Editor window. You can then filter presets based on tags.

See Parameter tags for information about tags specific to the Ramp Presets window gallery.

Parameter tags

  • sidefx::ramp_gallery_folder lets you set the folder path that the / presets menu and Ramp Presets window opens to by default.

  • sidefx::ramp_gallery_view lets you set whether the Ramp Presets window opens to the grid, tree, or split layout by default.

  • sidefx::ramp_open_full_gallery is a boolean that’s off (0) by default. When 1, the / Presets button is replaced with the Open Gallery button so you open the Ramp Presets window instead of the presets menu.

How to use the Ramp Presets window

To...Do this

Open the Ramp Presets window

  1. Click the / Presets button beside a ramp parameter to open the presets menu.

  2. Click the Open Gallery button.

Apply a preset

When Apply on Select is on, the preset you select in the gallery automatically applies to the ramp parameter in the parameter editor.

or

When Apply on Select is off, drag a preset from the gallery onto the ramp parameter in the parameter editor.

Star a preset

Turn on the star button in the upper-right corner of a preset’s thumbnail while in Grid or Split Layout. Turn off the star button to unstar the preset.

or

a preset while in Grid or Split Layout and choose Star. Choose Unstar to unstar the preset.

Assign a color

a preset while in Grid or Split Layout and choose a color from the dropdown menu.

Edit tags

  1. a preset while in Grid or Split Layout and choose Edit Metadata. This opens the Metadata Editor window.

  2. Edit the preset’s Tags. You can enter a list of space-separated tags (words), and add or remove existing tags using the checkboxes beside the tags in the tag list.

Show only starred presets

Turn on the Show Only Starred button.

or

Turn on the Show/Hide More Filters button and click Starred.

Filter presets

Type the ramp preset label or tag you want to filter for in the Search box.

or

  1. Turn on the Show/Hide More Filters button to open a sidebar with additional filters.

  2. Choose whether to show presets that match All of the following selected filters or Any of the following selected filters.

  3. Click one or more filter options to show presets matching those filters. Re-click a filter option to deselect it.

    • Date-based filters list presets Taken today or Taken in the last 7 days.

    • Starred lists presets that you starred.

    • Colors list presets with that assigned color.

Add ramp recipes to the gallery

Use the Create a parameter preset workflow to save a ramp parameter’s value as a recipe so it appears in the gallery.

Note

The Submenu parameter determines which gallery subfolder the recipe goes into. When blank, the new recipe appears in the Default folder. For example, enter Terrain/Desert in the Submenu to make a new recipe in the Terrain/Desert subfolder. You can also make new folders (for example, MyFolder/X), which are automatically created.

Edit a ramp recipe’s label

Note

You can only edit the label of a ramp preset that you added as a recipe.

While in Grid or Split Layout, a preset added as a recipe and choose Rename.

or

  1. While in Grid or Split Layout, a preset added as a recipe and choose Edit Metadata. This opens the Metadata Editor window.

  2. Edit the preset’s Label.

Remove a ramp recipe

Note

You can only delete a ramp preset that you added as a recipe.

the preset added as a recipe and choose Delete.

or

Click the preset added as a recipe and press ⌦ Del.

Windows