diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse30.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse30.html | 382 |
1 files changed, 0 insertions, 382 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse30.html b/Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse30.html deleted file mode 100644 index aa5c9e69513..00000000000 --- a/Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse30.html +++ /dev/null @@ -1,382 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" - "http://www.w3.org/TR/html4/loose.dtd"> -<html > -<head><title>30 Layered Graphics</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="pgfmanualse31.html" >next</a>] [<a -href="pgfmanualse29.html" >prev</a>] [<a -href="pgfmanualse29.html#tailpgfmanualse29.html" >prev-tail</a>] [<a -href="#tailpgfmanualse30.html">tail</a>] [<a -href="pgfmanual.html#pgfmanualse30.html" >up</a>] </p></div> - <h3 class="sectionHead"><span class="titlemark">30 </span> <a - id="x31-29800030"></a>Layered Graphics</h3> -<!--l. 12--><p class="noindent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox376"><span -class="cmtt-10">\usepackage{</span><span -class="cmtt-10">pgfbaselayers</span><span -class="cmtt-10">} % </span><span class="LATEX"><span -class="cmtt-10">L</span><span class="A"><span -class="cmtt-10">A</span></span><span class="TEX"><span -class="cmtt-10">T</span><span -class="E"><span -class="cmtt-10">E</span></span><span -class="cmtt-10">X</span></span></span></span> </dt><dd -class="description"> -<a - id="dx31-298001"></a> -<a - id="dx31-298002"></a> - </dd><dt class="description"> -<span -class="colorbox" id="colorbox377"><span -class="cmtt-10">\input </span><span -class="cmtt-10">pgfbaselayers</span><span -class="cmtt-10">.tex % plain </span><span class="TEX"><span -class="cmtt-10">T</span><span -class="E"><span -class="cmtt-10">E</span></span><span -class="cmtt-10">X</span></span></span> </dt><dd -class="description"> - </dd><dt class="description"> -<span -class="colorbox" id="colorbox378"><span -class="cmtt-10">\input </span><span -class="cmtt-10">pgfbaselayers</span><span -class="cmtt-10">.tex % Con</span><span class="TEX"><span -class="cmtt-10">T</span><span -class="E"><span -class="cmtt-10">E</span></span><span -class="cmtt-10">X</span></span><span -class="cmtt-10">t</span></span> </dt><dd -class="description"> - <!--l. 13--><p class="noindent">This package provides a commands and environments for composing a picture from multiple layers. - The package is loaded automatically by <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgf</span></span></span>, but you can load it manually if you have only included - <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfcore</span></span></span>. </dd></dl> -<!--l. 21--><p class="noindent"> - <h4 class="subsectionHead"><span class="titlemark">30.1 </span> <a - id="x31-29900030.1"></a>Overview</h4> -<!--l. 23--><p class="noindent"><span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> provides a layering mechanism for composing graphics from multiple layers. (This mechanism is not be -confused with the conceptual “software layers” the <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> system is composed of.) Layers are often used in graphic -programs. The idea is that you can draw on the different layers in any order. So you might start drawing something -on the “background” layer, then something on the “foreground” layer, then something on the “middle” layer, and -then something on the background layer once more, and so on. At the end, no matter in which ordering you drew on -the different layers, the layers are “stacked on top of each other” in a fixed ordering to produce the final -picture. Thus, anything drawn on the middle layer would come on top of everything of the background -layer. -<!--l. 36--><p class="indent"> Normally, you do not need to use different layers since you will have little trouble “ordering” your graphic -commands in such a way that layers are superfluous. However, in certain situations you only “know” what you -should draw behind something else after the “something else” has been drawn. -<!--l. 42--><p class="indent"> For example, suppose you wish to draw a yellow background behind your picture. The background should be as -large as the bounding box of the picture, plus a little border. If you know the size of the bounding box of the picture -at its beginning, this is easy to accomplish. However, in general this is not the case and you need to -create a “background” layer in addition to the standard “main” layer. Then, at the end of the picture, -when the bounding box has been established, you can add a rectangle of the appropriate size to the -picture. -<!--l. 53--><p class="noindent"> - <h4 class="subsectionHead"><span class="titlemark">30.2 </span> <a - id="x31-30000030.2"></a>Declaring Layers</h4> -<!--l. 55--><p class="noindent">In <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> layers are referenced using names. The standard layer, which is a bit special in certain ways, is called <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">main</span></span></span>. -If nothing else is specified, all graphic commands are added to the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">main</span></span></span> layer. You can declare a new layer using the -following command: -<!--l. 60--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox379"><span -class="cmtt-10">\pgfdeclarelayer</span><span -class="cmtt-10">{</span><span -class="cmsy-10"><</span><span -class="cmti-10">name</span><span -class="cmsy-10">></span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> -<a - id="dx31-300001"></a> - <!--l. 61--><p class="noindent">This command declares a layer named <span -class="cmsy-10"><</span><span -class="cmti-10">name</span><span -class="cmsy-10">> </span>for later use. Mainly, this will setup some internal - bookkeeping. </dd></dl> - - -<!--l. 65--><p class="indent"> The next step toward using a layer is to tell <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> which layers will be part of the actual picture -and which will be their ordering. Thus, it is possible to have more layers declared than are actually -used. -<!--l. 70--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox380"><span -class="cmtt-10">\pgfsetlayers</span><span -class="cmtt-10">{</span><span -class="cmsy-10"><</span><span -class="cmti-10">layer list</span><span -class="cmsy-10">></span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> -<a - id="dx31-300002"></a> - <!--l. 71--><p class="noindent">This command, which should be used <span -class="cmti-10">outside </span>a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">{pgfpicture}</span></span></span> environment, tells <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> which layers will be - used in pictures. They are stacked on top of each other in the order given. The layer <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">main</span></span></span> should always be - part of the list. Here is an example: - <!--l. 76--><p class="noindent"><div class="obeylines-v"></div><!--tex4ht:inline--><div class="tabular"><table class="tabular" -cellspacing="0" cellpadding="0" -frame="void" id="TBL-567-" ><colgroup id="TBL-567-1g"><col -id="TBL-567-1"></colgroup><tr - valign="baseline" id="TBL-567-1-"><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-567-1-1" -class="td11"> <table class="minipage"><tr><td><div class="obeylines-v"> -<br><span -class="cmtt-8">\pgfdeclarelayer{background}</span> -<br><span -class="cmtt-8">\pgfdeclarelayer{foreground}</span> -<br><span -class="cmtt-8">\pgfsetlayers{background,main,foreground}</span></div> </td></tr></table> </td> -</tr></table></div> - </dd></dl> -<!--l. 84--><p class="noindent"> - <h4 class="subsectionHead"><span class="titlemark">30.3 </span> <a - id="x31-30100030.3"></a>Using Layers</h4> -<!--l. 86--><p class="noindent">Once the layers of your picture have been declared, you can start to “fill” them. As said before, all graphics -commands are normally added to the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">main</span></span></span> layer. Using the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">{pgfonlayer}</span></span></span> environment, you can tell <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> that -certain commands should, instead, be added to the given layer. -<!--l. 92--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox381"><span -class="cmtt-10">\begin{</span><span -class="cmtt-10">pgfonlayer</span><span -class="cmtt-10">}{</span><span -class="cmsy-10"><</span><span -class="cmti-10">layer name</span><span -class="cmsy-10">></span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> - </dd><dt class="description"> -<span -class="colorbox" id="colorbox382"><span -class="cmtt-10"> </span><span -class="cmtt-10"> </span><span -class="cmsy-10"><</span><span -class="cmti-10">environment contents</span><span -class="cmsy-10">></span></span> </dt><dd -class="description"> - </dd><dt class="description"> -<span -class="colorbox" id="colorbox383"><span -class="cmtt-10">\end{</span><span -class="cmtt-10">pgfonlayer</span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> -<a - id="dx31-301001"></a> -<a - id="dx31-301002"></a> - <!--l. 93--><p class="noindent">The whole <span -class="cmsy-10"><</span><span -class="cmti-10">environment contents</span><span -class="cmsy-10">> </span>is added to the layer with the name <span -class="cmsy-10"><</span><span -class="cmti-10">layer name</span><span -class="cmsy-10">></span>. This environment - can be used anywhere inside a picture. Thus, even if it is used inside a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">{pgfscope}</span></span></span> or a <span class="TEX">T<span -class="E">E</span>X</span> group, - the contents will still be added to the “whole” picture. Using this environment multiple times inside - the same picture will cause the <span -class="cmsy-10"><</span><span -class="cmti-10">environment contents</span><span -class="cmsy-10">> </span>to accumulate. - <!--l. 100--><p class="noindent"><span -class="cmti-10">Note: </span>You can <span -class="cmti-10">not </span>add anything to the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">main</span></span></span> layer using this environment. The only way to add - anything to the main layer is to give graphic commands outside all <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">{pgfonlayer}</span></span></span> environments. - - - <!--l. 105--><p class="noindent"><div class="obeylines-v"></div><!--tex4ht:inline--><div class="tabular"><table class="tabular" -cellspacing="0" cellpadding="0" -frame="void" id="TBL-568-" ><colgroup id="TBL-568-1g"><col -id="TBL-568-1"><col -id="TBL-568-2"></colgroup><tr - valign="baseline" id="TBL-568-1-"><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-568-1-1" -class="td11"> <object data="pgfmanual-646.svg" width="76.87369 " height="76.87369 " type="image/svg+xml"><p>SVG-Viewer needed.</p></object> </td><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-568-1-2" -class="td11"> <table class="minipage"><tr><td><div class="obeylines-v"> -<br><span -class="cmtt-8">\pgfdeclarelayer{background</span><span -class="cmtt-8"> layer}</span> -<br><span -class="cmtt-8">\pgfdeclarelayer{foreground</span><span -class="cmtt-8"> layer}</span> -<br><span -class="cmtt-8">\pgfsetlayers{background</span><span -class="cmtt-8"> layer,main,foreground</span><span -class="cmtt-8"> layer}</span> -<br><span -class="cmtt-8">\begin{tikzpicture}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> </span><span -class="cmsltt-10x-x-80">%</span><span -class="cmsltt-10x-x-80"> On</span><span -class="cmsltt-10x-x-80"> main</span><span -class="cmsltt-10x-x-80"> layer:</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \fill[blue]</span><span -class="cmtt-8"> (0,0)</span><span -class="cmtt-8"> circle</span><span -class="cmtt-8"> (1cm);</span> -<br> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \begin{pgfonlayer}{background</span><span -class="cmtt-8"> layer}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> </span><span -class="cmtt-8"> </span><span -class="cmtt-8"> \fill[yellow]</span><span -class="cmtt-8"> (-1,-1)</span><span -class="cmtt-8"> rectangle</span><span -class="cmtt-8"> (1,1);</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \end{pgfonlayer}</span> -<br> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \begin{pgfonlayer}{foreground</span><span -class="cmtt-8"> layer}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> </span><span -class="cmtt-8"> </span><span -class="cmtt-8"> \node[white]</span><span -class="cmtt-8"> {foreground};</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \end{pgfonlayer}</span> -<br> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \begin{pgfonlayer}{background</span><span -class="cmtt-8"> layer}</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> </span><span -class="cmtt-8"> </span><span -class="cmtt-8"> \fill[black]</span><span -class="cmtt-8"> (-.8,-.8)</span><span -class="cmtt-8"> rectangle</span><span -class="cmtt-8"> (.8,.8);</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \end{pgfonlayer}</span> -<br> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> </span><span -class="cmsltt-10x-x-80">%</span><span -class="cmsltt-10x-x-80"> On</span><span -class="cmsltt-10x-x-80"> main</span><span -class="cmsltt-10x-x-80"> layer</span><span -class="cmsltt-10x-x-80"> again:</span> -<br><span -class="cmtt-8"> </span><span -class="cmtt-8"> \fill[blue!50]</span><span -class="cmtt-8"> (-.5,-1)</span><span -class="cmtt-8"> rectangle</span><span -class="cmtt-8"> (.5,1);</span> -<br><span -class="cmtt-8">\end{tikzpicture}</span></div> </td></tr></table> </td> -</tr></table></div> - </dd></dl> -<!--l. 131--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox384"><span -class="cmtt-10">\pgfonlayer</span><span -class="cmtt-10">{</span><span -class="cmsy-10"><</span><span -class="cmti-10">layer name</span><span -class="cmsy-10">></span><span -class="cmtt-10">}</span></span> </dt><dd -class="description"> - </dd><dt class="description"> -<span -class="colorbox" id="colorbox385"><span -class="cmtt-10"> </span><span -class="cmtt-10"> </span><span -class="cmsy-10"><</span><span -class="cmti-10">environment contents</span><span -class="cmsy-10">></span></span> </dt><dd -class="description"> - </dd><dt class="description"> -<span -class="colorbox" id="colorbox386"><span -class="cmtt-10">\endpgfonlayer</span></span> </dt><dd -class="description"> -<a - id="dx31-301003"></a> -<a - id="dx31-301004"></a> - <!--l. 132--><p class="noindent">This is the plain <span class="TEX">T<span -class="E">E</span>X</span> version of the environment. </dd></dl> - - - - - - - <div class="crosslinks"><p class="noindent">[<a -href="pgfmanualse31.html" >next</a>] [<a -href="pgfmanualse29.html" >prev</a>] [<a -href="pgfmanualse29.html#tailpgfmanualse29.html" >prev-tail</a>] [<a -href="pgfmanualse30.html" >front</a>] [<a -href="pgfmanual.html#pgfmanualse30.html" >up</a>] </p></div> -<!--l. 8--><p class="indent"> <a - id="tailpgfmanualse30.html"></a> -</body></html> |