ジャンプ先: 概要. 戻り値. キーワード. フラグ. MEL 例.

概要

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

profilerTool は、取り消し不可能、照会可能、および編集可能です。

このスクリプトは、プロファイラ ツールのビュー(描画領域)と対話する profilerPanel によって使用されます。これは プロファイラ ツールの一部の動作をコントロールするために使用できます。

戻り値

なし

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

キーワード

profiler, tool, profilerTool, timing, performance, profiling

フラグ

categoryView, collapseSelectedEvents, collapseSelectedEventsRepetition, cpuView, destroy, exists, expandSelectedEvents, expandSelectedEventsRepetition, findNext, findPrevious, frameAll, frameSelected, isolateSegment, make, matchWholeWord, searchEvent, segmentCount, showAllEvent, showCriticalPath, showSelectedEvents, showSelectedEventsRepetition, threadView, unisolateSegment
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-categoryView(-cat) edit
ビュー モードをカテゴリ ビューに変更する
-collapseSelectedEvents(-cs) edit
選択したイベントのすべてのサブイベントを非表示にし、最上位のイベントのみが表示されるようにする
-collapseSelectedEventsRepetition(-csr) edit
コメントに基づき、選択したイベントのすべてのサブイベントの繰り返しを非表示にする
-cpuView(-cpu) edit
ビュー モードを CPU ビューに変更する
-destroy(-dtr) create
プロファイラ ツール内部フラグを破棄します。ユーザは使用しないでください。
-exists(-ex) query
プロファイラ ツール ビューが存在するかどうかを照会します。プロファイラ ツールは、「profilerTool -make」を呼び出した後しか存在できません。
-expandSelectedEvents(-es) edit
選択したイベントのすべてのサブイベントを表示する
-expandSelectedEventsRepetition(-esr) edit
コメントに基づき、選択したイベントのすべてのサブイベントの繰り返しを表示する
-findNext(-fn) query
このフラグはフラグ -searchEvent と併用されます。
-findPrevious(-fp) query
このフラグはフラグ -searchEvent と併用されます。
-frameAll(-fa) edit
profilerToolView 内のすべてのイベントをフレームに入れる
-frameSelected(-fs) edit
profilerToolView で選択されたすべてのイベントをフレームに入れる
-isolateSegment(-is) int edit
指定されたセグメントを分離します。セグメントは 1 つのアニメーション フレームで発生したイベントのセットです。-segmentCount フラグを使用すると、イベント バッファ内のセグメント数を照会できます。セグメントのインデックスは 0 から開始します。指定したセグメントが存在しない場合は、エラーが発生します。
-make(-mk) create
プロファイラ ツールを作成し、最も最近作成されたレイアウト(内部フラグ)の親にするユーザは使用しないでください。
-matchWholeWord(-mww) boolean edit
イベントを検索するときに、単語の完全一致を条件とするかどうかをプロファイラ ツールに指示します。既定値は false です。
-searchEvent(-se) string query
イベントを検索する-searchEvent を使用する前に -matchWholeWord before を設定できます。-matchWholeWord を true に設定すると、プロファイラ ツールは、名前が文字列と正確に一致するイベントを検索します。-matchWholeWord を false に設定すると、プロファイラ ツールは、名前に文字列が含まれているイベントを検索します。このフラグと -findNext を併用すると、プロファイラ ツールは、現在選択されているイベントの次に見つかる最初のイベントを検索します。このフラグと -findPrevious を併用すると、プロファイラ ツールは、現在選択されているイベントの前に見つかる最初のイベントを検索します。現在選択されているイベントがないか、複数のイベントが選択されている場合、検索はプロファイラ バッファ内の最初のイベントから開始されます。このフラグに -findNext および -findPrevious を併用しないと、プロファイラ ツールはすべてのイベントを検出します。

照会モードでは、このフラグに値が必要になります。

-segmentCount(-sc) query
イベント バッファ内のセグメントの数を返します。
-showAllEvent(-sa) boolean edit
すべてのイベントを表示(フィルタによってイベントが非表示になっている場合)(true)、またはすべてのイベントを非表示(false)
-showCriticalPath(-scp) edit
選択したフレームの重要なパスを表示する
-showSelectedEvents(-ss) boolean edit
選択したイベントのみを表示(true)、または選択したすべてのイベントを非表示(false)
-showSelectedEventsRepetition(-ssr) boolean edit
選択したイベントの繰り返しのみをそのコメント(true)に基づいて表示、または選択したすべてのイベントの繰り返しをそのコメント(false)に基づいて非表示
-threadView(-thd) edit
ビュー モードをスレッド ビューに変更する
-unisolateSegment(-uis) edit
現在分離されているセグメントの分離を解除します。セグメントが現在分離されていない場合は、何も起こりません。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます コマンド内でフラグを複数回使用できます。

MEL 例


//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;

//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 segment count in buffer
profilerTool -q -segmentCount;

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

//Unisolate segment
profilerTool -e -unisolateSegment;