diff options
author | Karl Berry <karl@freefriends.org> | 2006-10-15 22:37:32 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-10-15 22:37:32 +0000 |
commit | 237df1eb06d422ff243a05b9a25501ba287681c1 (patch) | |
tree | 4cc4f2032474921cb986d1ca63b3cf9a267b480a /Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse31.html | |
parent | 15e21b5bab66eca251ac48fdc052126505428d4e (diff) |
pgf/tikz 1.09 big update (13oct06)
git-svn-id: svn://tug.org/texlive/trunk@2332 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse31.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse31.html | 428 |
1 files changed, 0 insertions, 428 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse31.html b/Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse31.html deleted file mode 100644 index 39308eba7bb..00000000000 --- a/Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse31.html +++ /dev/null @@ -1,428 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" - "http://www.w3.org/TR/html4/loose.dtd"> -<html > -<head><title>31 Quick Commands</title> -<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> -<meta name="generator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)"> -<meta name="originator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)"> -<!-- html --> -<meta name="src" content="pgfmanual.tex"> -<meta name="date" content="2005-11-15 18:41:00"> -<link rel="stylesheet" type="text/css" href="pgfmanual.css"> -</head><body -> - <div class="crosslinks"><p class="noindent">[<a -href="pgfmanualse30.html" >prev</a>] [<a -href="pgfmanualse30.html#tailpgfmanualse30.html" >prev-tail</a>] [<a -href="#tailpgfmanualse31.html">tail</a>] [<a -href="pgfmanual.html#pgfmanualse31.html" >up</a>] </p></div> - <h3 class="sectionHead"><span class="titlemark">31 </span> <a - id="x32-30200031"></a>Quick Commands</h3> -<!--l. 10--><p class="noindent">This section explains the “quick” commands of <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span>. These commands are executed more quickly than the normal -commands of <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span>, but offer less functionality. You should use these commands only if you either have a very large -number of commands that need to be processed or if you expect your commands to be executed very -often. -<!--l. 18--><p class="noindent"> - <h4 class="subsectionHead"><span class="titlemark">31.1 </span> <a - id="x32-30300031.1"></a>Quick Path Construction Commands</h4> -<!--l. 20--><p class="noindent">The difference between the quick and the normal path commands is that the quick path commands - <ul class="itemize1"> - <li class="itemize">do not keep track of the bounding boxes, - </li> - <li class="itemize">do not allow you to arc corners, - </li> - <li class="itemize">do not apply coordinate transformations.</li></ul> -<!--l. 31--><p class="indent"> However, they do use the soft-path subsystem (see Section <a -href="pgfmanualse34.html#x35-32300034">34<!--tex4ht:ref: section-soft-paths --></a> for details), which allows you to mix quick and -normal path commands arbitrarily. -<!--l. 35--><p class="indent"> All quick path construction commands start with <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\pgfpathq</span></span></span>. -<!--l. 37--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox387"><span -class="cmtt-10">\pgfpathqmoveto</span><span -class="cmtt-10">{</span><span -class="cmsy-10"><</span><span -class="cmti-10">x dimension</span><span -class="cmsy-10">></span><span -class="cmtt-10">}{</span><span -class="cmsy-10"><</span><span -class="cmti-10">y dimension</span><span -class="cmsy-10">></span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> -<a - id="dx32-303001"></a> - <!--l. 38--><p class="noindent">Either starts a path or starts a new part of a path at the coordinate (<span -class="cmsy-10"><</span><span -class="cmti-10">x dimension</span><span -class="cmsy-10">></span><span -class="cmmi-10">,</span><span -class="cmsy-10"><</span><span -class="cmti-10">y dimension</span><span -class="cmsy-10">></span>). - The coordinate is <span -class="cmti-10">not </span>transformed by the current coordinate transformation matrix. However, any - low-level transformations apply. - <!--l. 43--><p class="noindent"><div class="obeylines-v"></div><!--tex4ht:inline--><div class="tabular"><table class="tabular" -cellspacing="0" cellpadding="0" -frame="void" id="TBL-569-" ><colgroup id="TBL-569-1g"><col -id="TBL-569-1"><col -id="TBL-569-2"></colgroup><tr - valign="baseline" id="TBL-569-1-"><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-569-1-1" -class="td11"> <object data="pgfmanual-647.svg" width="115.21054 " height="77.27367 " type="image/svg+xml"><p>SVG-Viewer needed.</p></object> </td><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-569-1-2" -class="td11"> <table class="minipage"><tr><td><div class="obeylines-v"> -<br><span -class="cmtt-8">\begin{tikzpicture}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \draw[help</span><span -class="cmtt-8"> lines]</span><span -class="cmtt-8"> (0,0)</span><span -class="cmtt-8"> grid</span><span -class="cmtt-8"> (3,2);</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgftransformxshift{1cm}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfpathqmoveto{0pt}{0pt}</span><span -class="cmtt-8"> </span><span -class="cmsltt-10x-x-80">%</span><span -class="cmsltt-10x-x-80"> not</span><span -class="cmsltt-10x-x-80"> transformed</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfpathqlineto{1cm}{1cm}</span><span -class="cmtt-8"> </span><span -class="cmsltt-10x-x-80">%</span><span -class="cmsltt-10x-x-80"> not</span><span -class="cmsltt-10x-x-80"> transformed</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfpathlineto{\pgfpoint{2cm}{0cm}}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfusepath{stroke}</span> -<br><span -class="cmtt-8">\end{tikzpicture}</span></div> </td></tr></table> </td> -</tr></table></div> - </dd></dl> -<!--l. 55--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox388"><span -class="cmtt-10">\pgfpathqlineto</span><span -class="cmtt-10">{</span><span -class="cmsy-10"><</span><span -class="cmti-10">x dimension</span><span -class="cmsy-10">></span><span -class="cmtt-10">}{</span><span -class="cmsy-10"><</span><span -class="cmti-10">y dimension</span><span -class="cmsy-10">></span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> -<a - id="dx32-303002"></a> - <!--l. 56--><p class="noindent">The quick version of the line-to operation. </dd></dl> -<!--l. 59--><p class="indent"> - - - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox389"><span -class="cmtt-10">\pgfpathqcurveto</span><span -class="cmtt-10">{</span><span -class="cmsy-10"><</span><span -class="cmmi-10">s</span><sub><span -class="cmmi-7">x</span></sub><sup><span -class="cmr-7">1</span></sup><span -class="cmsy-10">></span><span -class="cmtt-10">}{</span><span -class="cmsy-10"><</span><span -class="cmmi-10">s</span><sub><span -class="cmmi-7">y</span></sub><sup><span -class="cmr-7">1</span></sup><span -class="cmsy-10">></span><span -class="cmtt-10">}{</span><span -class="cmsy-10"><</span><span -class="cmmi-10">s</span><sub><span -class="cmmi-7">x</span></sub><sup><span -class="cmr-7">2</span></sup><span -class="cmsy-10">></span><span -class="cmtt-10">}{</span><span -class="cmsy-10"><</span><span -class="cmmi-10">s</span><sub><span -class="cmmi-7">y</span></sub><sup><span -class="cmr-7">2</span></sup><span -class="cmsy-10">></span><span -class="cmtt-10">}{</span><span -class="cmsy-10"><</span><span -class="cmmi-10">t</span><sub ><span -class="cmmi-7">x</span></sub><span -class="cmsy-10">></span><span -class="cmtt-10">}{</span><span -class="cmsy-10"><</span><span -class="cmmi-10">t</span><sub ><span -class="cmmi-7">y</span></sub><span -class="cmsy-10">></span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> -<a - id="dx32-303003"></a> - <!--l. 60--><p class="noindent">The quick version of the curve-to operation. The first support point is (<span -class="cmmi-10">s</span><sub><span -class="cmmi-7">x</span></sub><sup><span -class="cmr-7">1</span></sup><span -class="cmmi-10">,s</span><sub><span -class="cmmi-7">y</span></sub><sup><span -class="cmr-7">1</span></sup>), the second support - point is (<span -class="cmmi-10">s</span><sub><span -class="cmmi-7">x</span></sub><sup><span -class="cmr-7">2</span></sup><span -class="cmmi-10">,s</span><sub><span -class="cmmi-7">y</span></sub><sup><span -class="cmr-7">2</span></sup>), and the target is (<span -class="cmmi-10">t</span><sub ><span -class="cmmi-7">x</span></sub><span -class="cmmi-10">,t</span><sub ><span -class="cmmi-7">y</span></sub>). - <!--l. 64--><p class="noindent"><div class="obeylines-v"></div><!--tex4ht:inline--><div class="tabular"><table class="tabular" -cellspacing="0" cellpadding="0" -frame="void" id="TBL-570-" ><colgroup id="TBL-570-1g"><col -id="TBL-570-1"><col -id="TBL-570-2"></colgroup><tr - valign="baseline" id="TBL-570-1-"><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-570-1-1" -class="td11"> <object data="pgfmanual-648.svg" width="115.07718 " height="77.14032 " type="image/svg+xml"><p>SVG-Viewer needed.</p></object> </td><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-570-1-2" -class="td11"> <table class="minipage"><tr><td><div class="obeylines-v"> -<br><span -class="cmtt-8">\begin{tikzpicture}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \draw[help</span><span -class="cmtt-8"> lines]</span><span -class="cmtt-8"> (0,0)</span><span -class="cmtt-8"> grid</span><span -class="cmtt-8"> (3,2);</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfpathqmoveto{0pt}{0pt}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfpathqcurveto{1cm}{1cm}{2cm}{1cm}{3cm}{0cm}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfusepath{stroke}</span> -<br><span -class="cmtt-8">\end{tikzpicture}</span></div> </td></tr></table> </td> -</tr></table></div> - </dd></dl> -<!--l. 74--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox390"><span -class="cmtt-10">\pgfpathqcircle</span><span -class="cmtt-10">{</span><span -class="cmsy-10"><</span><span -class="cmti-10">radius</span><span -class="cmsy-10">></span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> -<a - id="dx32-303004"></a> - <!--l. 75--><p class="noindent">Adds a radius around the origin of the given <span -class="cmsy-10"><</span><span -class="cmti-10">radius</span><span -class="cmsy-10">></span>. This command is orders of magnitude faster - than <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\pgfcircle{\pgfpointorigin}{</span></span></span><span -class="cmsy-10"><</span><span -class="cmti-10">radius</span><span -class="cmsy-10">></span><span class="obeylines-h"><span class="verb"><span -class="cmtt-10">}</span></span></span>. - <!--l. 79--><p class="noindent"><div class="obeylines-v"></div><!--tex4ht:inline--><div class="tabular"><table class="tabular" -cellspacing="0" cellpadding="0" -frame="void" id="TBL-571-" ><colgroup id="TBL-571-1g"><col -id="TBL-571-1"><col -id="TBL-571-2"></colgroup><tr - valign="baseline" id="TBL-571-1-"><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-571-1-1" -class="td11"> <object data="pgfmanual-649.svg" width="39.20348 " height="39.20348 " type="image/svg+xml"><p>SVG-Viewer needed.</p></object> </td><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-571-1-2" -class="td11"> <table class="minipage"><tr><td><div class="obeylines-v"> -<br><span -class="cmtt-8">\begin{tikzpicture}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \draw[help</span><span -class="cmtt-8"> lines]</span><span -class="cmtt-8"> (0,0)</span><span -class="cmtt-8"> grid</span><span -class="cmtt-8"> (1,1);</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfpathqcircle{10pt}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfsetfillcolor{examplefill}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfusepath{stroke,fill}</span> -<br><span -class="cmtt-8">\end{tikzpicture}</span></div> </td></tr></table> </td> -</tr></table></div> - </dd></dl> -<!--l. 91--><p class="noindent"> - <h4 class="subsectionHead"><span class="titlemark">31.2 </span> <a - id="x32-30400031.2"></a>Quick Path Usage Commands</h4> -<!--l. 93--><p class="noindent">The quick path usage commands perform similar tasks as <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\pgfusepath</span></span></span>, but they - <ul class="itemize1"> - <li class="itemize">do not add arrows, - </li> - <li class="itemize">do not modify the path in any way, in particular, - </li> - <li class="itemize">ends are not shortened, - </li> - <li class="itemize">corners are not replaced by arcs.</li></ul> -<!--l. 106--><p class="indent"> Note that you <span -class="cmti-10">have to </span>use the quick versions in the code of arrow tip definitions since, inside these definition, you -obviously do not want arrows to be drawn. -<!--l. 110--><p class="indent"> - - - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox391"><span -class="cmtt-10">\pgfusepathqstroke</span></span> </dt><dd -class="description"> -<a - id="dx32-304001"></a> - <!--l. 111--><p class="noindent">Strokes the path without further ado. No arrows are drawn, no corners are arced. - <!--l. 114--><p class="noindent"><div class="obeylines-v"></div><!--tex4ht:inline--><div class="tabular"><table class="tabular" -cellspacing="0" cellpadding="0" -frame="void" id="TBL-572-" ><colgroup id="TBL-572-1g"><col -id="TBL-572-1"><col -id="TBL-572-2"></colgroup><tr - valign="baseline" id="TBL-572-1-"><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-572-1-1" -class="td11"> <object data="pgfmanual-650.svg" width="1.0 " height="2.33333 " type="image/svg+xml"><p>SVG-Viewer needed.</p></object> </td> <td align="left" style="white-space:nowrap; text-align:left;" id="TBL-572-1-2" -class="td11"><table class="minipage"><tr><td><div class="obeylines-v"> -<br><span -class="cmtt-8">\begin{pgfpicture}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfpathqcircle{5pt}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \pgfusepathqstroke</span> -<br><span -class="cmtt-8">\end{pgfpicture}</span></div> </td></tr></table> </td> -</tr></table></div> - </dd></dl> -<!--l. 122--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox392"><span -class="cmtt-10">\pgfusepathqfill</span></span> </dt><dd -class="description"> -<a - id="dx32-304002"></a> - <!--l. 123--><p class="noindent">Fills the path without further ado. </dd></dl> -<!--l. 126--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox393"><span -class="cmtt-10">\pgfusepathqfillstroke</span></span> </dt><dd -class="description"> -<a - id="dx32-304003"></a> - <!--l. 127--><p class="noindent">Fills and then strokes the path without further ado. </dd></dl> -<!--l. 130--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox394"><span -class="cmtt-10">\pgfusepathqclip</span></span> </dt><dd -class="description"> -<a - id="dx32-304004"></a> - <!--l. 131--><p class="noindent">Clips all subsequent drawings against the current path. The path is not processed. </dd></dl> -<!--l. 136--><p class="noindent"> - <h4 class="subsectionHead"><span class="titlemark">31.3 </span> <a - id="x32-30500031.3"></a>Quick Text Box Commands</h4> -<!--l. 138--><p class="noindent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox395"><span -class="cmtt-10">\pgfqbox</span><span -class="cmtt-10">{</span><span -class="cmsy-10"><</span><span -class="cmti-10">box number</span><span -class="cmsy-10">></span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> -<a - id="dx32-305001"></a> - <!--l. 139--><p class="noindent">This command inserts a <span class="TEX">T<span -class="E">E</span>X</span> box into a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">{pgfpicture}</span></span></span> by “escaping” to <span class="TEX">T<span -class="E">E</span>X</span>, inserting the box - number <span -class="cmsy-10"><</span><span -class="cmti-10">box number</span><span -class="cmsy-10">> </span>at the origin, and then returning to the typesetting the picture. </dd></dl> -<!--l. 144--><p class="noindent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox396"><span -class="cmtt-10">\pgfqboxsynced</span><span -class="cmtt-10">{</span><span -class="cmsy-10"><</span><span -class="cmti-10">box number</span><span -class="cmsy-10">></span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> -<a - id="dx32-305002"></a> - <!--l. 145--><p class="noindent">This command works similarly to the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\pgfqbox</span></span></span> command. However, before inserting the text in <span -class="cmsy-10"><</span><span -class="cmti-10">box</span> - <span -class="cmti-10">number</span><span -class="cmsy-10">></span>, the current coordinate transformation matrix is applied to the current canvas transformation - matrix (is it “synced” with this matrix, hence the name). - <!--l. 151--><p class="noindent">Thus, this command basically has the same effect as if you first called <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\pgflowlevelsynccm</span></span></span> followed by - <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\pgfqbox</span></span></span>. However, this command will use <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\hskip</span></span></span> and <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\raise</span></span></span> commands for the “translational part” - of the coordinate transformation matrix, instead of adding the translational part to the current canvas - transformation matrix directly. Both methods have the same effect (box <span -class="cmsy-10"><</span><span -class="cmti-10">box number</span><span -class="cmsy-10">> </span>is translated - where it should), but the method used by <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\pgfqboxsynced</span></span></span> ensures that hyperlinks are placed correctly. - Note that scaling and rotation will not (cannot, even) apply to hyperlinks. </dd></dl> - - - - - <div class="crosslinks"><p class="noindent">[<a -href="pgfmanualse30.html" >prev</a>] [<a -href="pgfmanualse30.html#tailpgfmanualse30.html" >prev-tail</a>] [<a -href="pgfmanualse31.html" >front</a>] [<a -href="pgfmanual.html#pgfmanualse31.html" >up</a>] </p></div> -<!--l. 273--><p class="indent"> <a - id="tailpgfmanualse31.html"></a> -</body></html> |