...
| Note |
|---|
Configuration options for live stats are limited as this is a prototype feature. As this feature the system evolves so will the ability to create custom configurations of live stats. |
...
See JSON Report Listener reference page for JSON output configuration options.
Config File Search Order
The default configuration filename is "stats.ini" . If command-line prman is not provided a config file via the -statsconfig option , or if then the filename given is a relative filename, then the stats configuration search path order default configuration filename "stats.ini" will be used to attempt to find a configuration file.
The stats system will search for the configuration file in the following order:
...
Which will load the stats configuration from "/my/test/directory/debug_stats.ini"
A full-path, absolute file name can also be provided on the command line which obviates the need for the environment variable. E.g. the above configuration file could also be loaded with the following command:
| Code Block |
|---|
prman -statsconfig /my/test/directory/debug_stats.ini complicatedScene.rib |
If the filename provided on the command line is an absolute path the search path will be ignored.
| Note |
|---|
Listener control and configuration are not yet dynamic. In most cases, a render must be restarted in order to see the configuration change. In the case of RfM and RfB, the application will need to be restarted. |
...
These attributes are currently not exposed in PrmanGlobalStatements, they must be set via AttributeSet or OpScript at the moment. Below is an OpScript which exposes these two attributes as user args with defaults as listed above. Copy and paste into your Katana scene and modify the path and config file name as needed.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<katana release="4.0v2" version="4.0.2.000001">
<node name="__SAVE_exportedNodes" type="Group">
<node baseType="OpScript" edited="true" name="AdvancedStatsConfiguration" ns_colorb="0.050000" ns_colorg="0.260000" ns_colorr="0.090000" ns_errorGlow="0.000000" ns_fromContext="legacy" selected="true" type="OpScript" x="287.350171" y="-212.346316">
<port name="i0" source="GafferThree.out" type="in"/>
<port name="out" type="out"/>
<group_parameter name="AdvancedStatsConfiguration">
<string_parameter name="CEL" value="((/root))"/>
<string_parameter name="location" value="/root/world/location"/>
<group_parameter name="script">
<string_parameter name="lua" value="
-- Default: 'stats.ini'
local configFile = Interface.GetOpArg('user.configFile'):getValue()

-- Default: '.:${RMANTREE}/etc'
-- Can be overriden with RMAN_STATS_CONFIG_PATH
local configPath = Interface.GetOpArg('user.configPath'):getValue()

Interface.SetAttr(
 'prmanGlobalStatements.stats.configFile', 
 StringAttribute(configFile))

Interface.SetAttr(
 'prmanGlobalStatements.stats.configPath', 
 StringAttribute(configPath))

"/>
</group_parameter>
<string_parameter name="executionMode" value="immediate"/>
<string_parameter name="applyWhere" value="at locations matching CEL"/>
<string_parameter name="applyWhen" value="during op resolve"/>
<string_parameter name="modifierNameMode" value="node name"/>
<string_parameter name="modifierName" value="modifier"/>
<string_parameter name="resolveIds" value=""/>
<number_parameter name="recursiveEnable" value="0"/>
<string_parameter name="disableAt" value=""/>
<string_parameter name="inputBehavior" value="by index"/>
<number_parameter name="multisampleUserOpArgs" value="0"/>
<group_parameter hints="{}" name="user">
<string_parameter hints="{'widget': 'fileInput'}" name="configFile" value="stats.ini"/>
<string_parameter expression="'.:'+getenv("RMANTREE", ".")+'/etc'" hints="{}" name="configPath"/>
</group_parameter>
</group_parameter>
</node>
</node>
</katana> |
...