Preferences

This section shows you which preferences you can set up for Katana.

Note:  To reset the preferences to their default values, you can delete the Prefs2.ini file in the following location: $KATANA_HOME/katana.

Application

Control (UI)

Default Value

Function

Application

fontFamily

Bitstream Vera Sans

Set the font family for the Katana UI.

Some UI components cache elements like font or control size. Restart Katana for the font family change to take full effect.

fontSize

8

Set the base font size for the Katana UI.

Some UI components cache elements like font or control size. Restart Katana for the font size change to take full effect.

macroSavePath

N/A

Specify the default location for saving macros.

numberOfRecentProjects

10

The number of recent projects that are shown in the File > Open Recent menu. The maximum number of recent projects that are stored is 100.

crashFile

numberOfActions

50

Set the number of actions before automatically saving the current project to a file from which the project can be restored after a crash.

time

5

Set the time in minutes before automatically saving the current project to a file from which the project can be restored after a crash.

rendering

interactiveRenderThreadOverride

Yes

Use the interactiveRenderThreads settings below to control the number of threads used in an interactive render.

When set to No, the renderer-specific settings from the scene are used.

interactiveRenderThreads2D

9

Set the number of render threads for interactive 2D renders, including hot renders. This value has to be larger than 0.

interactiveRenderThreads3D

1

Set the number of render threads for interactive 3D renders, including hot renders.

restartLiveRenderOnTimeChange

Yes

Specify whether or not a Live Render session should be automatically restarted when the selected time changes.

saveKatanaScriptOnRender

No

Specify whether or not to auto-save the .katana script for each render.

Warning:  For large sessions, this can substantially increase render launch times.

updateMode2D

Manual

Specify what UI actions trigger a render of the currently viewed 2D node.

Manual - changes to materials, lights, or geometry transformations don’t trigger a render update. To have the changes take effect, click the Trigger 2D Update button.

Pen-up - changes to materials, lights, or geometry transformations trigger a render update only when the mouse button is released or a parameter change is applied.

Continuous - changes to materials, lights, or geometry transformations, including some manipulations in the Viewer tab, continuously trigger a render update.

Note:  Setting this preference to a value other than Continuous is particularly useful when rendering large images where constant render updates would be too time-consuming.

updateMode3D

Continuous

Specify what UI actions trigger an update (recook) of the scene.

Manual - changes to materials, lights, or geometry transformations do not trigger an update of the scene. To have the changes take effect, click the Trigger 3D Update button .

Pen-up - changes to materials, lights, or geometry transformations trigger an update of the scene only when the mouse button is released or a parameter change is applied.

Continuous - changes to materials, lights, or geometry transformations, including some manipulations in the Viewer tab, continuously trigger an update of the scene.

Attributes

Control (UI)

Default Value

Function

attributes

showInternalNodesInAttributeHistory

No

Show internal nodes in Attribute History in the Attributes tab.

Color

Control (UI)

Default Value

Function

color

useSingleComponentRGB

No

Set whether or not the RGB gradients are displayed using pure components.

Control (UI)

Default Value

Function

documentation

source

Local

Controls where Katana's documentation should be served from.

remote - uses help.thefoundry.co.uk/katana.

local - uses a local copy of the documentation.

Dopesheet

Control (UI)

Default Value

Function

dopesheet

showToolTips

Yes

Specify whether or not to display the tooltips with key values.

ExternalTools

Control (UI)

Default Value

Function

externalTools

editor

gedit

Enter the command for launching an external text editor.

imageViewer

eog

Enter the command for launching an external image viewer.

pdfViewer

evince

Enter the command for launching an external PDF viewer.

webBrowser

firefox

Enter the command for launching an external web browser.

Control (UI)

Default Value

Function

flipbook

colorspace

n/a

Default output colorspace for flipbook images.

format

n/a

Default file format for flipbook images.

Layout

Control (UI)

Default Value

Function

layout

default

N/A

Specify which Katana UI layout you want to start in by default.

hotkey1

Monitor

Specify the layout assigned to F9.

hotkey2

Lighting

Specify the layout assigned to F10.

hotkey3

Dual Lighting

Specify the layout assigned to F11.

hotkey4

Composite

Specify the layout assigned to F12.

Monitor

Control (UI)

Default Value

Function

monitor

allowKeylessTabletInteraction

Yes

Specify whether or not to allow the tablet interaction without pressing the modifier keys.

When set to Yes, you can use the stylus pen buttons to perform actions such as zooming, panning, and so on.

When set to No, you need to use modifier keys along with the stylus pen to perform actions.

renderIDPass

Yes

Specify whether or not an ID pass is rendered when rendering from a node in the node graph.

The ID pass allows the Pixel Probe in the Monitor tab to identify pieces of geometry under the pointer, for which the name of a corresponding scene graph location is then displayed in the Pixel Probe toolbar.

Tip:  You can also toggle on and off the Render ID Pass preference in Katana's main menu in the Render > 3D Rendering > Render ID Pass menu, or in the Monitor tab in the 3D > Render ID Pass menu.

showColorTimingEditor

No

Specify whether or not to display the color timing editor.

showCommentEditor

No

Specify whether or not to display the comment editor.

showOverlayControl

No

Specify whether or not to display the overlay controls.

showPanel

Yes

Specify whether or not to display the monitor panel at each render.

showPixelProbe

No

Specify whether or not to display the pixel probe.

showSwipeLine

Yes

Specify whether or not to display the swipe line.

ShowTextResolution

Yes

Specify whether or not to display the resolution name for the image sizes in the monitor information.

backgroundColor

N/A

Choose the color values.

For more information, refer to the Color Widget Type in Common Parameter Widgets.

manipulatorLockedColor

N/A

manipulatorNormalColor

N/A

manipulatorSelectColor

N/A

swipeLineColor

N/A

NodeTags

Control (UI)

Default Value

Function

nodeTags

menuCategories

constraint,lookfile,
resolve,output,color,
composite,source,
i/o,keying,transform,filter,foundry,views,
_macro

Enter the categories to display in the node menu.

Nodegraph

Control (UI)

Default Value

Function

nodegraph

allowKeylessTabletInteraction

Yes

Specify whether or not to allow the tablet interaction without pressing the modifier keys.

When set to Yes, you can use the stylus pen buttons to perform actions such as zooming, panning, and so on.

When set to No, you need to use modifier keys along with the stylus pen to perform actions.

autoConnectOnCreate

No

Specify whether or not to auto-connect new nodes based on selection.

autoScroll

Yes

Specify whether or not to auto-scroll while selecting, dragging, and so on.

defaultShadingNodeViewState

Expanded

Specify whether new nodes added to a shading network are expanded or collapsed by default.

When showPagesConnectedOnly is enabled, setting this control to Connected Only displays the whole page containing connected inputs and outputs not just the connected inputs and outputs themselves.

dimNodesUnconnectedToViewedNode

No

Specify whether or not to dim nodes unconnected to the viewed node.

dimNonContributingNodes

No

Specify whether or not to dim nodes not contributing to the viewed node.

drawLowContrast

Yes

Specify whether or not to draw the node graph with a low-contrast look.

findOnlyNodesInThisGroupDefault

Yes

Specify whether or not to set the default state for the Show Only Nodes in this Group checkbox in the find pop-up of the Node Graph tab.

flagErrorsFileIn

Yes

Specify whether or not to flag FileIn node errors automatically.

flagErrorsNodeConnection

Yes

Specify whether or not to flag node connection errors automatically.

lockStickyNoteNodes

No

Specify whether or not to lock backdrop nodes.

showExpressionLinks

No

Specify whether or not to display expression links.

showNodeIcons

Yes

Specify whether or not to display icons on nodes where available.

showOffscreenFlagArrows

Yes

Specify whether or not to display off-screen flag arrows.

showPagesConnectedOnly

No

Specify whether the whole page or just the connected inputs and outputs are displayed when defaultShadingNodeViewState is set to Connected Only.

showRolloverNodeNames

Yes

Specify whether or not to display node names on rollover.

showViewMasks

No

Specify whether or not to display the view mask flags and link colors.

snapToGrid

No

Specify whether or not to snap nodes to grid.

stickyDrag

No

When this preference is set to Yes, nodes that are dragged in the Node Graph tab stick to the pointer when the mouse button is released, so that they can be moved without keeping the mouse button held down. In this mode, nodes are placed only when the mouse button is clicked again. This grab-and-drop behavior may help prevent repetitive strain injury (RSI).

useColorFromInputPortForConnections

Yes

Specify whether the color of a connection is determined by the color of the input port on the target node or the output port on the source node.

Nodes

Control (UI)

Default Value

Function

nodes > gaffer

syncSelection

off

Specify the default selection sync option for the GafferThree.

Parameters

Control (UI)

Default Value

Function

parameters

cacheEditors

Yes

Specify whether or not to cache node parameters editors.

openCelParametersEditors

No

Specify whether or not to open CEL parameters editors.

selectParameterValueOnFirstClick

No

Specify whether or not the text of parameter values (including project settings and preferences) is selected when first clicking into a value field.

Note:   By default, when clicking into a value field, the text cursor is placed where the text has been clicked, and no text is selected.
This single-click-to-select behavior may help prevent repetitive strain injury (RSI).

stickyScrub

No

Allow modifying a number parameter by clicking once on its label and moving the mouse. A second click commits the modification.

Python

Control (UI)

Default Value

Function

python

autoCompletionBehavior

Shell

Select the auto-completion behavior in the Python tab. Choose from these two options:

Shell - when pressing the Tab key, tokens are completed based on matches with possible completions. If there is more than one possibility for completion, a list of possibilities is printed to the result area of the tab.

IDE - while typing in the command area of the tab, possible completions are shown in a pop-up widget. Select completions with the up and down arrow keys, and chosen by pressing the Tab or Return/Enter key. Press Esc to close the pop-up widget.

showHelpTooltips

No

Specify whether or not to display tooltips with help on the item under the pointer within the Python tab, both in the result and the command areas of the tab.

Scenegraph

Control (UI)

Default Value

Function

scenegraph

findLocationsFilterDefault

Selected

Sets the default filter used by the Find Scene Graph Locations pop-up in the Scene Graph tab.

showLightsColumn

Yes

Choose whether or not to display the Lights column in the Scene Graph tab.

showRenderColumn

Yes

Determine whether to show Render Working Set column in the Scene Graph tab.

The title of the Render column can be clicked to turn the use of the render Working Set on. The render Working Set determines the scene graph locations for which geometry is rendered in Preview Renders and Live Renders.

The Monitor tab contains a corresponding button to turn the use of the render Working Set on, in order to render only objects from the Render column of the Scene Graph tab. The button is only shown when this preference is set to Yes.

showViewerVisibilityColumn

Yes

Show Viewer Visibility Working Set column in the Scene Graph tab.

The title of the Viewer Visibility column can be clicked to turn the use of the viewerVisibility Working Set on. The viewerVisibility Working Set determines the scene graph locations for which geometry is drawn in the Viewer tab.

The Viewer tab contains a corresponding button to turn the use of the viewerVisibility Working Set on, in order to show only objects from the Viewer Visibility column of the Scene Graph tab. The button is only shown when this preference is set to Yes.

scenegraph > userColumns

userColumns > Add

N/A

Select from the dropdown menu and define the custom columns to display in the Scene Graph tab.

Viewer

Control (UI)

Default Value

Function

viewer

interactiveProcessingDelay

250

The Viewer delays the processing of interactive updates for a short period of time. This allows updates to be processed in batches, and increases responsiveness. This setting determines the length of this delay in milliseconds.

showImagePlanes

Yes

Specify whether or not to display all image planes.

showOverlayControl

No

Specify whether or not to display the overlay controls.

showPanZoomEditor

No

Specify whether or not to display the pan/zoom controls.