From e268fecc18fec7afd0205ec616bb37d2096f38aa Mon Sep 17 00:00:00 2001 From: Xu Yuan Date: Sun, 2 Oct 2011 20:04:28 +0200 Subject: release 0.2 --- release/pgf-pie-0.2/pgf-pie-manual.tex | 197 +++++++++++++++++++++++++++++++++ 1 file changed, 197 insertions(+) create mode 100644 release/pgf-pie-0.2/pgf-pie-manual.tex (limited to 'release/pgf-pie-0.2/pgf-pie-manual.tex') diff --git a/release/pgf-pie-0.2/pgf-pie-manual.tex b/release/pgf-pie-0.2/pgf-pie-manual.tex new file mode 100644 index 0000000..c8af241 --- /dev/null +++ b/release/pgf-pie-0.2/pgf-pie-manual.tex @@ -0,0 +1,197 @@ +% Manual of pgf-pie.sty, a convenient set of macros for drawing pie +% chart. Written by Xu Yuan This file is part of +% pgf-pie you may get it at http://code.google.com/p/pgf-pie/ + +\documentclass{article} +\usepackage[margin=12mm]{geometry} +\usepackage{hyperref} + +\usepackage{pgf-pie} +\usetikzlibrary{shadows} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\usepackage{listings} +\usepackage{color} +\definecolor{listinggray}{gray}{0.92} +\lstset{ % +language=[LaTeX]TeX, +breaklines=true, +frame=single, +% frameround=tttt, +basicstyle=\footnotesize\ttfamily, +backgroundcolor=\color{listinggray}, +keywordstyle=\color{blue} +} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\hypersetup{ + colorlinks=true, + linkcolor=blue, + anchorcolor=black, + citecolor=olive, + filecolor=magenta, + menucolor=red, + urlcolor=blue +} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\newcommand{\demo}[2][1]{ + \begin{center} + \begin{tabular}{cc} + \begin{minipage}{.49\linewidth} + \centering + \resizebox{#1\linewidth}{!}{ + \input{demo/#2} + } + \end{minipage} + & + \begin{minipage}{.45\linewidth} + \lstinputlisting{demo/#2} + \end{minipage} + \end{tabular} + \end{center} +} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\newcommand{\example}[2][1]{ + \begin{center} + \resizebox{#1\linewidth}{!}{ + \input{demo/#2} + } + \end{center} + \lstinputlisting{demo/#2} +} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\begin{document} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\title{Drawing Pie Chart by using \texttt{pgf-pie}} +\author{\href{mailto:xuyuan.cn@gmail.com}{Yuan Xu}} +\date{\today{}~(v0.2)} +\maketitle +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\begin{abstract} + \texttt{pgf-pie} is a LaTeX package for drawing pie chart (and + variant charts). As stated by its name, it is based on a very + popular graphic package \texttt{PGF/TikZ}. This document presents + the usage of \texttt{pgf-pie} and collects some pie charts as + examples. \texttt{pgf-pie} can be downloaded from + \href{http://code.google.com/p/pgf-pie/}{http://code.google.com/p/pgf-pie/}. +\end{abstract} + +\tableofcontents + +\section{The Essentials} + +\subsection{First Pie} +\lstinline|\pie| is the only coomand that provided by +\texttt{pgf-pie}. The argument is a list of number and text +combination in the formate of \texttt{number/text}, i.e. \texttt{10/A, + 20/B, 30/C, 40/D}. The result is shown in figure \ref{fig:first-pie}. +\begin{figure} + \centering + \demo[0.6]{first-pie} + \caption{The first pie.} + \label{fig:first-pie} +\end{figure} + +\subsection{Position, Rotation, Size} + +The center of chart can be set by \texttt{pos}, default is +\texttt{\{0,0\}}. The chart can be rotated by setting \texttt{rotate} +(in degrees). The size of chart can be set by \texttt{radius}, default +is 3. + +\demo{radius} + +\subsection{Color} +The color can be specified by \texttt{color}, the default color wheel +is shown in figure \ref{fig:color-wheel}. +\begin{figure} + \centering + \input{demo/colorwheel} + \caption{Default color wheel} + \label{fig:color-wheel} +\end{figure} + +\demo{color} + +\subsection{Explode} +\demo{explode} + +\subsection{Angle of slices} +The value of \texttt{sum} indicats the sum of all data in the chart, +it is 100 by default. It can be calculated automatically when +\texttt{auto} is set. Then the angle of slices are determined by +number value and \texttt{sum}. + +\demo{sum} + +\subsection{Text} + +\subsubsection{Number} +Two parameters can be used to decorate number: \texttt{before number} +and \texttt{after number}. Both are empty by default, but if +\texttt{sum=100}, \texttt{after number} will be set to \% +automatically if user doesn't set it. + +\demo[0.6]{before-after-number} + +\paragraph{Scale font} +The size of font in size pie can be scaled according to how big the +part is automatically. + +\demo[0.6]{scalefont} + +\subsubsection{Label text} +The value of \texttt{text} can be \texttt{label}(default), +\texttt{pin}, \texttt{inside} or \texttt{legend}. + +\demo[0.6]{text} + +\demo[0.5]{text-inside} + +\demo[0.6]{legend} + +\subsection{More about style} +\subsubsection{shadow} +\demo[0.6]{shadow} + +\section{Variant Charts} +\subsection{Polar area diagram} +The polar area diagram is similar to a usual pie chart, except sectors +are equal angles and differ rather in how far each sector extends from +the center of the circle. + +\demo[0.6]{polar} + +\subsection{Square} + +\demo[0.6]{square} + +Note: \texttt{explode} has no affects in sqaure chart. + +\subsection{Clouds} + +\demo[0.6]{cloud} + +\section{Examples} + +% \subsection{Population of the world} +% \example{population} + +% \section{Acknowledgements} +% Many people contributed to \texttt{pgf-pie} by reporting problems, +% suggesting various improvements or submitting code. Here is a list of +% these people: +% \href{mailto:???}{name}. + +\end{document} +%%% Local Variables: +%%% mode: Tex-PDF +%%% TeX-master: t +%%% End: -- cgit v1.2.3