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, |
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.
|
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. |