profilerTool

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

Synopsis

profilerTool [-categoryView] [-cpuView] [-destroy] [-exists] [-findNext] [-findPrevious] [-frameAll] [-frameSelected] [-isolateSegment int] [-make] [-matchWholeWord boolean] [-searchEvent string] [-segmentCount] [-showAllEvent boolean] [-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
-cpuView(-cpu)
Change view mode to cpu view
-destroy(-dtr)
Destroy the profiler tool Internal flag. Should not be used by user.
-exists(-ex)
Query if the profiler tool view exists. Profiler tool can only exist after "profilerTool -make" is called.
-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)
-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 which has same comment as selected events
	profilerTool -e -showSelectedEventsRepetition false;
	//
	//Find all events whose name contains "abc"
	profilerTool -q -searchEvent abc;
	//
	//Find the first event, whose name exactly match with "def", next to current selected event
	profilerTool -e -matchWholeWord true;
	profilerTool -q -searchEvent def -findNext;
	//
	//Query segment count in buffer
	profilerTool -q -segmentCount;
	//
	//Isolate the first segment
	profilerTool -e -isolateSegment 0;
	//
	//Unisolate segment
	profilerTool -e -unisolateSegment;