Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/wolfpld/tracy.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
path: root/manual
diff options
context:
space:
mode:
authorBartosz Taudul <wolf@nereid.pl>2022-07-24 15:31:33 +0300
committerBartosz Taudul <wolf@nereid.pl>2022-07-24 15:31:57 +0300
commit347317745b725c267ff21b1a16e325b46d242ac3 (patch)
treedf6c43e2f1d6648212816136be12a01422766e93 /manual
parentb782b021c7f1e9d4078f63341a96ef9941179df4 (diff)
Update manual.
Diffstat (limited to 'manual')
-rw-r--r--manual/tracy.tex18
1 files changed, 17 insertions, 1 deletions
diff --git a/manual/tracy.tex b/manual/tracy.tex
index 2c74ec0f..0086124e 100644
--- a/manual/tracy.tex
+++ b/manual/tracy.tex
@@ -1307,7 +1307,7 @@ If using the \texttt{TracyLockable} or \texttt{TracySharedLockable} wrappers doe
Tracy can capture and draw numeric value changes over time. You may use it to analyze draw call counts, number of performed queries, etc. To report data, use the \texttt{TracyPlot(name, value)} macro.
-To configure how plot values are presented by the profiler, you may use the \texttt{TracyPlotConfig(name, format)} macro, where \texttt{format} is one of the following options:
+To configure how plot values are presented by the profiler, you may use the \texttt{TracyPlotConfig(name, format, step, fill, color)} macro, where \texttt{format} is one of the following options:
\begin{itemize}
\item \texttt{tracy::PlotFormatType::Number} -- values will be displayed as plain numbers.
@@ -1315,6 +1315,22 @@ To configure how plot values are presented by the profiler, you may use the \tex
\item \texttt{tracy::PlotFormatType::Percentage} -- values will be displayed as percentage (with value $100$ being equal to $100\%$).
\end{itemize}
+The \texttt{step} parameter determines whether the plot will be displayed as a staircase or will smoothly change between plot points (see figure~\ref{plotconfig}). The \texttt{fill} parameter can be used to disable filling the area below the plot with a solid color.
+
+\begin{figure}[h]
+\centering\begin{tikzpicture}
+[dot/.style={rectangle,draw,scale=0.5}];
+\draw(0, -2) -- (1, -2.3) node[dot]{} -- (1.2, -3) node[dot]{} -- (1.8, -1.2) node[dot]{} -- (2.7, -0.5) node[dot]{} -- (3, -2) node[dot]{} -- (5, -2.5);
+\draw(7, -1.5) -- (8, -1.5) -- (8, -2.3) node[dot]{} -- (8.2, -2.3) -- (8.2, -3) node[dot]{} -- (8.8, -3) -- (8.8, -1.2) node[dot]{} -- (9.7, -1.2) -- (9.7, -0.5) node[dot]{} -- (10, -0.5) -- (10, -2) node[dot]{} -- (12, -2);
+\end{tikzpicture}
+\caption{An identical set of values on a smooth plot (left) and a staircase plot (right).}
+\label{plotconfig}
+\end{figure}
+
+Each plot has its own color, which by default is derived from the plot name (each unique plot name produces its own color, which does not change between profiling runs). If you want to provide your own color instead, you may enter the \texttt{color} parameter. Note that you should set the color value to \texttt{0} if you do not want to set your own color.
+
+For reference, the following command sets the default parameters of the plot (that is, it's a no-op): \texttt{TracyPlotConfig(name, tracy::PlotFormatType::Number, false, true, 0)}.
+
It is beneficial but not required to use a unique pointer for name string literal (see section~\ref{uniquepointers} for more details).
\subsection{Message log}