mirror of
https://github.com/wolfpld/tracy.git
synced 2024-11-10 02:31:48 +00:00
Make manual zone scope management more prominent.
This commit is contained in:
parent
21ddd0a820
commit
9c1dd6d498
@ -940,6 +940,10 @@ Use the \texttt{ZoneText(text, size)} macro to add a custom text string that wil
|
||||
|
||||
If you want to set zone name on a per-call basis, you may do so using the \texttt{ZoneName(text, size)} macro. This name won't be used in the process of grouping the zones for statistical purposes (sections~\ref{statistics} and~\ref{findzone}).
|
||||
|
||||
\subsubsection{Manual management of zone scope}
|
||||
|
||||
The zone markup macros automatically report when they end, through the RAII mechanism\footnote{\url{https://en.cppreference.com/w/cpp/language/raii}}. This is very helpful, but sometimes you may want to mark the zone start and end points yourself, for example if you want to have a zone that crosses the function's boundary. This can be achieved by using the C API, which is described in section~\ref{capi}.
|
||||
|
||||
\subsubsection{Multiple zones in one scope}
|
||||
\label{multizone}
|
||||
|
||||
@ -1026,10 +1030,6 @@ void Graphics::Render()
|
||||
}
|
||||
\end{lstlisting}
|
||||
|
||||
\subsubsection{Manual management of zone scope}
|
||||
|
||||
The zone markup macros automatically report when they end, through the RAII mechanism\footnote{\url{https://en.cppreference.com/w/cpp/language/raii}}. This is very helpful, but sometimes you may want to mark the zone start and end points yourself, for example if you want to have a zone that crosses the function's boundary. This can be achieved by using the C API, which is described in section~\ref{capi}.
|
||||
|
||||
\subsubsection{Exiting program from within a zone}
|
||||
|
||||
At the present time exiting the profiled application from inside a zone is not supported. When the client calls \texttt{exit()}, the profiler will wait for all zones to end, before a program can be truly terminated. If program execution stopped inside a zone, this will never happen, and the profiled application will seemingly hang up. At this point you will need to manually terminate the program (or simply disconnect the profiler server).
|
||||
|
Loading…
Reference in New Issue
Block a user