profilerTool

Go to: Synopsis. Return value. Keywords. Flags. MEL examples.

Synopsis

profilerTool [-categoryView] [-collapseSelectedEvents] [-collapseSelectedEventsRepetition] [-cpuView] [-destroy] [-eventTypes boolean] [-exists] [-expandSelectedEvents] [-expandSelectedEventsRepetition] [-findNext] [-findPrevious] [-frameAll] [-frameSelected] [-isolateSegment int] [-make] [-matchWholeWord boolean] [-searchEvent string] [-segmentCount] [-showAllEvent boolean] [-showCriticalPath] [-showHotspot] [-showSelectedEvents boolean] [-showSelectedEventsRepetition boolean] [-threadView] [-unisolateSegment]

profilerTool is NOT undoable, queryable, and editable.

This script is intended to be used by the profilerPanel to interact with the profiler tool's view (draw region). It can be used to control some behaviors about the profiler Tool.

Return value

None

In query mode, return type is based on queried flag.

Keywords

Flags

Long name (short name)	Argument types	Properties
-categoryView(-cat)
Change view mode to category view
-collapseSelectedEvents(-cs)
Hide all sub-events of selected events so that only top-level events show
-collapseSelectedEventsRepetition(-csr)
Hide all sub-events repetition of selected events based on their comment
-cpuView(-cpu)
Change view mode to cpu view
-destroy(-dtr)
Destroy the profiler tool Internal flag. Should not be used by user.
-eventTypes(-et)	boolean
Return JSON data containing the list of event types on currently existing events. If the value of the flag is true then show only event types for selected events, otherwise show them for all events. The JSON return string will contain the event type information in the following format: { "eventSummary" : [ { "type" : EVENT_TYPE_NAME, , "description" : EVENT_TYPE_DESCRIPTION, , "color" : [ RED_AS_FLOAT, GREEN_AS_FLOAT, BLUE_AS_FLOAT ] , "category" : CATEGORY_NAME , "count" : EVENT_TYPE_COUNT } ] } "type" and "description" may be omitted, indicating that the results correspond to anonymous events.
-exists(-ex)
Query if the profiler tool view exists. Profiler tool can only exist after "profilerTool -make" is called.
-expandSelectedEvents(-es)
Show all sub-events of selected events
-expandSelectedEventsRepetition(-esr)
Show all sub-events repetition of selected events based on their comment
-findNext(-fn)
This flag is used along with flag -searchEvent.
-findPrevious(-fp)
This flag is used along with flag -searchEvent.
-frameAll(-fa)
Frame on all events in the profilerToolView
-frameSelected(-fs)
Frame on all selected events in the profilerToolView
-isolateSegment(-is)	int
Isolate a specified segment. A segment is a set of events that happened in one animation frame. You can use flag -segmentCount to query the number of segments in the event buffer. The segment index starts from 0. If the specified segment does not exist, an error will be thrown.
-make(-mk)
Make the profiler tool and parent it to the most recent layout created Internal flag. Should not be used by user.
-matchWholeWord(-mww)	boolean
Tells profiler tool if it should match whole word when searching event(s). The default value is false.
-searchEvent(-se)	string
Search event(s). You can set -matchWholeWord before you use -searchEvent. If -matchWholeWord has been set to true, the profiler tool will search event(s) whose name exactly matches with the string. If -matchWholeWord has been set to false, the profiler tool will search event(s) whose name contains the string. If -findNext is also used along with this flag, the profiler tool will find the first event next to the current selected event. If -findPrevious is also used along with this flag, the profiler tool will find the first event previous to the current selected event. If currently don't have a selected event or there are multiple selected events, the search will start at the first event in profiler buffer. If -findNext and -findPrevious are not used along with this flag, the profiler tool will find all events. In query mode, this flag needs a value.
-segmentCount(-sc)
Returns the number of segments in the event buffer.
-showAllEvent(-sa)	boolean
Show all events (if events were hidden by filtering) (true) or Hide all events (false)
-showCriticalPath(-scp)
Show critical path of selected frame
-showHotspot(-sh)
Show hotspot of selected frame
-showSelectedEvents(-ss)	boolean
Show only the selected events (true) or hide all selected events (false)
-showSelectedEventsRepetition(-ssr)	boolean
Show only the selected events repetition based on their comment (true) or Hide all selected events repetition based on their comment (false)
-threadView(-thd)
Change view mode to thread view
-unisolateSegment(-uis)
Unisolate current isolated segment. If no segment is currently isolated, nothing will happen.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command.

MEL examples

//First record/load a profile
//Frame the tool's view on all recorded events.
profilerTool -e -frameAll;

//Frame selected events
profilerTool -e -frameSelected;

//Change to cpu view
profilerTool -e -cpuView;

//Show only selected events
profilerTool -e -showSelectedEvents true;

//Show all events
profilerTool -e -showAllEvent true;

//Hide all events that have same comment as selected events
profilerTool -e -showSelectedEventsRepetition false;

//Show hotspot
profilerTool -e -showHotspot;

//Find all events whose name contains "abc"
profilerTool -q -searchEvent abc;

//Find the first event, whose name exactly matches with "def", next to current selected event
profilerTool -e -matchWholeWord true;
profilerTool -q -searchEvent def -findNext;

//Query the active event types
profilerTool -q -eventTypes;

//Query segment count in buffer
profilerTool -q -segmentCount;

//Isolate the first segment
profilerTool -e -isolateSegment 0;

//Unisolate segment
profilerTool -e -unisolateSegment;