diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse5.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse5.html | 653 |
1 files changed, 0 insertions, 653 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse5.html b/Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse5.html deleted file mode 100644 index c033ef520f7..00000000000 --- a/Master/texmf-dist/doc/generic/pgf/version-for-tex4ht/en/pgfmanualse5.html +++ /dev/null @@ -1,653 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" - "http://www.w3.org/TR/html4/loose.dtd"> -<html > -<head><title>5 Input and Output Formats</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="pgfmanualse4.html" >prev</a>] [<a -href="pgfmanualse4.html#tailpgfmanualse4.html" >prev-tail</a>] [<a -href="#tailpgfmanualse5.html">tail</a>] [<a -href="pgfmanual.html#pgfmanualse5.html" >up</a>] </p></div> - <h3 class="sectionHead"><span class="titlemark">5 </span> <a - id="x6-550005"></a>Input and Output Formats</h3> -<!--l. 12--><p class="noindent"><span class="TEX">T<span -class="E">E</span>X</span> was designed to be a flexible system. This is true both for the <span -class="cmti-10">input </span>for <span class="TEX">T<span -class="E">E</span>X</span> as well as for the <span -class="cmti-10">output</span>. The -present section explains which input formats there are and how they are supported by <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span>. It also explains which -different output formats can be produced. -<!--l. 20--><p class="noindent"> - <h4 class="subsectionHead"><span class="titlemark">5.1 </span> <a - id="x6-560005.1"></a>Supported Input Formats</h4> -<!--l. 22--><p class="noindent"><span class="TEX">T<span -class="E">E</span>X</span> does not prescribe exactly how your input should be formatted. While it is <span -class="cmti-10">customary </span>that, -say, an opening brace starts a scope in <span class="TEX">T<span -class="E">E</span>X</span>, this is by no means necessary. Likewise, it is <span -class="cmti-10">customary</span> -that environments start with <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\begin</span></span></span>, but <span class="TEX">T<span -class="E">E</span>X</span> could not really care less about the exact command -name. -<!--l. 28--><p class="indent"> Even though <span class="TEX">T<span -class="E">E</span>X</span> can be reconfigured, users can not. For this reason, certain <span -class="cmti-10">input formats </span>specify a set of -commands and conventions how input for <span class="TEX">T<span -class="E">E</span>X</span> should be formatted. There are currently three “major” formats: -Donald Knuth’s original <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">plain</span></span></span> <span class="TEX">T<span -class="E">E</span>X</span> format, Leslie Lamport’s popular <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> format, and Hans Hangen’s -Con<span class="TEX">T<span -class="E">E</span>X</span>t format. -<!--l. 36--><p class="noindent"> - <h5 class="subsubsectionHead"><span class="titlemark">5.1.1 </span> <a - id="x6-570005.1.1"></a>Using the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> Format</h5> -<!--l. 38--><p class="noindent">Using <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> and Ti<span -class="cmti-10">k</span>Z with the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> format is easy: You say <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\usepackage{pgf}</span></span></span> or <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\usepackage{tikz}</span></span></span>. -Usually, that is all you need to do, all configuration will be done automatically and (hopefully) correctly. -<!--l. 43--><p class="indent"> The style files used for the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> format reside in the subdirectory <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">latex/pgf/</span></span></span> of 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. Mainly, -what these files do is to include files in the directory <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">generic/pgf</span></span></span>. For example, here is the content of the file -<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">latex/pgf/frontends/tikz.sty</span></span></span>: -<!--l. 48--><p class="noindent"><div class="obeylines-v"></div><!--tex4ht:inline--><div class="tabular"><table class="tabular" -cellspacing="0" cellpadding="0" -frame="void" id="TBL-64-" ><colgroup id="TBL-64-1g"><col -id="TBL-64-1"></colgroup><tr - valign="baseline" id="TBL-64-1-"><td align="left" style="white-space:nowrap; text-align:left;" id="TBL-64-1-1" -class="td11"> <table class="minipage"><tr><td><div class="obeylines-v"> -<br><span -class="cmsltt-10x-x-80">%</span><span -class="cmsltt-10x-x-80"> Copyright</span><span -class="cmsltt-10x-x-80"> 2005</span><span -class="cmsltt-10x-x-80"> by</span><span -class="cmsltt-10x-x-80"> Till</span><span -class="cmsltt-10x-x-80"> Tantau</span><span -class="cmsltt-10x-x-80"> <tantau@users.sourceforge.net>.</span> -<br><span -class="cmsltt-10x-x-80">%</span> -<br><span -class="cmsltt-10x-x-80">%</span><span -class="cmsltt-10x-x-80"> This</span><span -class="cmsltt-10x-x-80"> program</span><span -class="cmsltt-10x-x-80"> can</span><span -class="cmsltt-10x-x-80"> be</span><span -class="cmsltt-10x-x-80"> redistributed</span><span -class="cmsltt-10x-x-80"> and/or</span><span -class="cmsltt-10x-x-80"> modified</span><span -class="cmsltt-10x-x-80"> under</span><span -class="cmsltt-10x-x-80"> the</span><span -class="cmsltt-10x-x-80"> terms</span> -<br><span -class="cmsltt-10x-x-80">%</span><span -class="cmsltt-10x-x-80"> of</span><span -class="cmsltt-10x-x-80"> the</span><span -class="cmsltt-10x-x-80"> GNU</span><span -class="cmsltt-10x-x-80"> Public</span><span -class="cmsltt-10x-x-80"> License,</span><span -class="cmsltt-10x-x-80"> version</span><span -class="cmsltt-10x-x-80"> 2.</span> -<br> -<br><span -class="cmtt-8">\RequirePackage{pgf,calc,pgffor,pgflibraryplothandlers,xkeyval}</span> -<br> -<br><span -class="cmtt-8">\input{tikz.code}</span> -<br> -<br><span -class="cmtt-8">\endinput</span></div> </td></tr></table> </td> -</tr></table></div> -<!--l. 61--><p class="indent"> The files in the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">generic/pgf</span></span></span> directory do the actual work. -<!--l. 65--><p class="noindent"> - <h5 class="subsubsectionHead"><span class="titlemark">5.1.2 </span> <a - id="x6-580005.1.2"></a>Using the Plain <span class="TEX">T<span -class="E">E</span>X</span> Format</h5> -<!--l. 67--><p class="noindent">When using the plain <span class="TEX">T<span -class="E">E</span>X</span> format, you say <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\input{pgf.tex}</span></span></span> or <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\input{tikz.tex}</span></span></span>. Instead of <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\begin{pgfpicture}</span></span></span> -and <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\end{pgfpicture}</span></span></span> you use <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\pgfpicture</span></span></span> and <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\endpicture</span></span></span>. -<!--l. 71--><p class="indent"> Unlike for the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> format, <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> is not as good at discerning the appropriate configuration for the plain -<span class="TEX">T<span -class="E">E</span>X</span> format. In particular, it can only automatically determine the correct output format if you use <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pdftex</span></span></span> or <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tex</span></span></span> -plus <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvips</span></span></span>. For all other output formats you need to set the macro <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\pgfsysdriver</span></span></span> to the correct value. See the -description of using output formats later on. -<!--l. 78--><p class="indent"> <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> was originally written for use with <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> and this shows in a number of places. Nevertheless, the plain -<span class="TEX">T<span -class="E">E</span>X</span> support is reasonably good. -<!--l. 82--><p class="indent"> Like the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> style files, the plain <span class="TEX">T<span -class="E">E</span>X</span> files like <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tikz.tex</span></span></span> also just include the correct <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tikz.code.tex</span></span></span> -file. - - -<!--l. 87--><p class="noindent"> - <h5 class="subsubsectionHead"><span class="titlemark">5.1.3 </span> <a - id="x6-590005.1.3"></a>Using the Con<span class="TEX">T<span -class="E">E</span>X</span>t Format</h5> -<!--l. 89--><p class="noindent">Currently, there is no special support for the Con<span class="TEX">T<span -class="E">E</span>X</span>t format. Rather, you have to use <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> and Ti<span -class="cmti-10">k</span>Z as if you -were using the plain <span class="TEX">T<span -class="E">E</span>X</span> format when using Con<span class="TEX">T<span -class="E">E</span>X</span>t. This may change in the future. -<!--l. 98--><p class="noindent"> - <h4 class="subsectionHead"><span class="titlemark">5.2 </span> <a - id="x6-600005.2"></a>Supported Output Formats</h4> -<!--l. 101--><p class="noindent">An output format is a format in which <span class="TEX">T<span -class="E">E</span>X</span> outputs the text it has typeset. Producing the output is (conceptually) -a two-stage process: - <ol type="1" class="enumerate1" > - <li class="enumerate" value="1" -><a - id="x6-60002x1"></a><span class="TEX">T<span -class="E">E</span>X</span> typesets your text and graphics. The result of this typesetting is mainly a long list of - letter-coordinate pairs, plus (possibly) some “special” commands. This long list of pairs is written to - something called a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-file. - </li> - <li class="enumerate" value="2" -><a - id="x6-60004x2"></a>Some other program reads this <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-file and translates the letter-coordinate pairs into, say, PostScript - commands for placing the given letter at the given coordinate.</li></ol> -<!--l. 115--><p class="indent"> The classical example of this process is the combination of <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">latex</span></span></span> and <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvips</span></span></span>. The <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">latex</span></span></span> program (which is just -the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tex</span></span></span> program called with the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span>-macros preinstalled) produces a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-file as its output. The <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvips</span></span></span> -program takes this output and produces a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.ps</span></span></span>-file (a PostScript) file. Possibly, this file is further converted using, -say, <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">ps2pdf</span></span></span>, whose name is supposed to mean “PostScript to PDF.” Another example of programs using this -process is the combination of <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tex</span></span></span> and <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvipdfm</span></span></span>. The <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvipdfm</span></span></span> program takes a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-file as input and translates the -letter-coordinate pairs therein into <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">D</small><small -class="small-caps">F</small></span>-commands, resulting in a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.pdf</span></span></span> file directly. Finally, the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tex4ht</span></span></span> is also a -program that takes a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-file and produces an output, this time it is a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.html</span></span></span> file. The programs <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pdftex</span></span></span> -and <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pdflatex</span></span></span> are special: They directly produce a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.pdf</span></span></span>-file without the intermediate <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-stage. -However, from the programmer’s point of view they behave exactly as if there where an intermediate -stage. -<!--l. 132--><p class="indent"> Normally, <span class="TEX">T<span -class="E">E</span>X</span> only produces letter-coordinate pairs as its “output.” This obviously makes is difficult tho draw, -say, a curve. For this, “special” commands can be used. Unfortunately, these special commands are not the same for -the different programs that process the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-file. Indeed, every program that takes a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-file as input has a totally -different syntax for the special commands. -<!--l. 140--><p class="indent"> One of the main jobs of <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> is to “abstract way” the difference in the syntax of the different programs. -However, this means that support for each program has to be “programmed,” which is a time-consuming and -complicated process. -<!--l. 146--><p class="noindent"> - <h5 class="subsubsectionHead"><span class="titlemark">5.2.1 </span> <a - id="x6-610005.2.1"></a>Selecting the Backend Driver</h5> -<!--l. 148--><p class="noindent">When <span class="TEX">T<span -class="E">E</span>X</span> typesets your document, it does not know which program you are going to use to transform the -<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-file. If your <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-file does not contain any special commands, this would be fine; but these days almost all -<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-files contain lots of special commands. It is thus necessary to tell <span class="TEX">T<span -class="E">E</span>X</span> which program you are going to use -later on. -<!--l. 155--><p class="indent"> Unfortunately, there is no “standard” way of telling this to <span class="TEX">T<span -class="E">E</span>X</span>. For the <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> format a sophisticated -mechanism exists inside the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">graphics</span></span></span> package and <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> plugs into this mechanism. For other formats and when this -plugging does not work as expected, it is necessary 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> directly which program you are going to use. This is -done by redefining the macro <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\pgfsysdriver</span></span></span> to an appropriate value <span -class="cmti-10">before </span>you load <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgf</span></span></span>. If you are going to use -the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvips</span></span></span> program, you set this macro to the value <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfsys-dvips.def</span></span></span>; if you use <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pdftex</span></span></span> or <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pdflatex</span></span></span>, you set it to -<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfsys-pdftex.def</span></span></span>; and so on. In the following, details of the support of the different programs are -discussed. -<!--l. 168--><p class="noindent"> - <h5 class="subsubsectionHead"><span class="titlemark">5.2.2 </span> <a - id="x6-620005.2.2"></a>Producing PDF Output</h5> -<!--l. 170--><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> supports three programs that produce <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">D</small><small -class="small-caps">F</small></span> output (<span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">D</small><small -class="small-caps">F</small></span> means “portable document format” and was invented -by the Adobe company): <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvipdfm</span></span></span>, <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pdftex</span></span></span>, and <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">vtex</span></span></span>. The <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pdflatex</span></span></span> program is the same as the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pdftex</span></span></span> program: it -uses a different input format, but the output is exactly the same. - - -<!--l. 176--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox1">File <span -class="cmtt-10">pgfsys-pdftex.def</span></span> </dt><dd -class="description"> -<a - id="dx6-62001"></a> -<a - id="dx6-62002"></a> - <!--l. 177--><p class="noindent">This is the driver file for use with pdf<span class="TEX">T<span -class="E">E</span>X</span>, that is, with the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pdftex</span></span></span> or <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pdflatex</span></span></span> command. It includes - <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfsys-common-pdf.def</span></span></span>. - <!--l. 181--><p class="noindent">This driver has the “complete” functionality. This means, everything <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> “can do at all” is - implemented in this driver. </dd></dl> -<!--l. 186--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox2">File <span -class="cmtt-10">pgfsys-dvipdfm.def</span></span> </dt><dd -class="description"> -<a - id="dx6-62003"></a> -<a - id="dx6-62004"></a> - <!--l. 187--><p class="noindent">This is a driver file for use with (<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">la</span></span></span>)<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tex</span></span></span> followed by <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvipdfm</span></span></span>. It includes <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfsys-common-pdf.def</span></span></span>. - <!--l. 190--><p class="noindent">This driver supports most of <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span>’s features, but there are some restrictions: - <ol type="1" class="enumerate1" > - <li class="enumerate" value="1" -><a - id="x6-62006x1"></a>In <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> mode it uses <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">graphicx</span></span></span> for the graphics inclusion and does not support masking. - </li> - <li class="enumerate" value="2" -><a - id="x6-62008x2"></a>In plain <span class="TEX">T<span -class="E">E</span>X</span> mode it does not support image inclusion.</li></ol> - </dd></dl> -<!--l. 201--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox3">File <span -class="cmtt-10">pgfsys-vtex.def</span></span> </dt><dd -class="description"> -<a - id="dx6-62009"></a> -<a - id="dx6-62010"></a> - <!--l. 202--><p class="noindent">This is the driver file for use with the commercial <span -class="cmcsc-10"><small -class="small-caps">V</small><small -class="small-caps">T</small><small -class="small-caps">E</small><small -class="small-caps">X</small> </span>program. Even though is will produce <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">D</small><small -class="small-caps">F</small></span> - output, it includes <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfsys-common-postscript.def</span></span></span>. Note that the <span -class="cmcsc-10"><small -class="small-caps">V</small><small -class="small-caps">T</small><small -class="small-caps">E</small><small -class="small-caps">X</small> </span>program can produce <span -class="cmti-10">both</span> - Postscript and <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">D</small><small -class="small-caps">F</small> </span>output, depending on the command line parameters. However, whether you produce - Postscript or <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">D</small><small -class="small-caps">F</small> </span>output does not change anything with respect to the driver. - <!--l. 211--><p class="noindent">This driver supports most of <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span>’s features, except for the following restrictions: - <ol type="1" class="enumerate1" > - <li class="enumerate" value="1" -><a - id="x6-62012x1"></a>In <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> mode it uses <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">graphicx</span></span></span> for the graphics inclusion and does not support masking. - </li> - <li class="enumerate" value="2" -><a - id="x6-62014x2"></a>In plain <span class="TEX">T<span -class="E">E</span>X</span> mode it does not support image inclusion. - </li> - <li class="enumerate" value="3" -><a - id="x6-62016x3"></a>Shading is fully implemented, but yields the same quality as the implementation for <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvips</span></span></span>. - </li> - <li class="enumerate" value="4" -><a - id="x6-62018x4"></a>Opacity is not implemented at all.</li></ol> - </dd></dl> -<!--l. 227--><p class="indent"> It is also possible to produce a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.pdf</span></span></span>-file by first producing a PostScript file (see below) and then using a -PostScript-to-<span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">D</small><small -class="small-caps">F</small></span> conversion program like <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">ps2pdf</span></span></span> or the Acrobat Distiller. -<!--l. 232--><p class="noindent"> - <h5 class="subsubsectionHead"><span class="titlemark">5.2.3 </span> <a - id="x6-630005.2.3"></a>Producing PostScript Output</h5> -<!--l. 234--><p class="noindent"> - - - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox4">File <span -class="cmtt-10">pgfsys-dvips.def</span></span> </dt><dd -class="description"> -<a - id="dx6-63001"></a> -<a - id="dx6-63002"></a> - <!--l. 235--><p class="noindent">This is a driver file for use with (<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">la</span></span></span>)<span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tex</span></span></span> followed by <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvips</span></span></span>. It includes - <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfsys-common-postscript.def</span></span></span>. - <!--l. 238--><p class="noindent">This driver also supports most of <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span>’s features, except for the following restrictions: - <ol type="1" class="enumerate1" > - <li class="enumerate" value="1" -><a - id="x6-63004x1"></a>In <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> mode it uses <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">graphicx</span></span></span> for the graphics inclusion and does not support masking. - </li> - <li class="enumerate" value="2" -><a - id="x6-63006x2"></a>In plain <span class="TEX">T<span -class="E">E</span>X</span> mode it does not support image inclusion. - </li> - <li class="enumerate" value="3" -><a - id="x6-63008x3"></a>Shading is fully implemented, but the results will not be as good as with a driver producing <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.pdf</span></span></span> - as output. - </li> - <li class="enumerate" value="4" -><a - id="x6-63010x4"></a>Opacity works only in conjunction with newer versions of GhostScript.</li></ol> - </dd></dl> -<!--l. 255--><p class="noindent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox5">File <span -class="cmtt-10">pgfsys-textures.def</span></span> </dt><dd -class="description"> -<a - id="dx6-63011"></a> -<a - id="dx6-63012"></a> - <!--l. 256--><p class="noindent">This is a driver file for use with the <span -class="cmcsc-10"><small -class="small-caps">T</small><small -class="small-caps">E</small><small -class="small-caps">X</small><small -class="small-caps">T</small><small -class="small-caps">U</small><small -class="small-caps">R</small><small -class="small-caps">E</small><small -class="small-caps">S</small> </span>program. It includes <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfsys-common-postscript.def</span></span></span>. - <!--l. 259--><p class="noindent">This driver has exactly the same restrictions as the driver for <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">dvips</span></span></span>. </dd></dl> -<!--l. 263--><p class="noindent">You can also use the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">vtex</span></span></span> program together with <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfsys-vtex.def</span></span></span> to produce Postscript output. -<!--l. 268--><p class="noindent"> - <h5 class="subsubsectionHead"><span class="titlemark">5.2.4 </span> <a - id="x6-640005.2.4"></a>Producing HTML / SVG Output</h5> -<!--l. 270--><p class="noindent">The <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tex4ht</span></span></span> program converts <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.dvi</span></span></span>-files to <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">.html</span></span></span>-files. While the <span -class="cmcsc-10"><small -class="small-caps">H</small><small -class="small-caps">T</small><small -class="small-caps">M</small><small -class="small-caps">L</small></span>-format cannot be used to draw graphics, -the <span -class="cmcsc-10"><small -class="small-caps">S</small><small -class="small-caps">V</small><small -class="small-caps">G</small></span>-format can. Using the following driver, you can ask <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> to produce an <span -class="cmcsc-10"><small -class="small-caps">S</small><small -class="small-caps">V</small><small -class="small-caps">G</small></span>-picture for each <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span> graphic in -your text. -<!--l. 276--><p class="indent"> - <dl class="description"><dt class="description"> -<span -class="colorbox" id="colorbox6">File <span -class="cmtt-10">pgfsys-tex4ht.def</span></span> </dt><dd -class="description"> -<a - id="dx6-64001"></a> -<a - id="dx6-64002"></a> - <!--l. 277--><p class="noindent">This is a driver file for use with the <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tex4ht</span></span></span> program. It includes <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfsys-common-svg.def</span></span></span>. - <!--l. 280--><p class="noindent">When using this driver you should be aware of the following restrictions: - <ol type="1" class="enumerate1" > - <li class="enumerate" value="1" -><a - id="x6-64004x1"></a>In <span class="LATEX">L<span class="A">A</span><span class="TEX">T<span -class="E">E</span>X</span></span> mode it uses <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">graphicx</span></span></span> for the graphics inclusion. - </li> - <li class="enumerate" value="2" -><a - id="x6-64006x2"></a>In plain <span class="TEX">T<span -class="E">E</span>X</span> mode it does not support image inclusion. - </li> - <li class="enumerate" value="3" -><a - id="x6-64008x3"></a>Text inside <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">pgfpicture</span></span></span>s is not supported very well. The reason is that the <span -class="cmcsc-10"><small -class="small-caps">S</small><small -class="small-caps">V</small><small -class="small-caps">G</small> </span>specification - currently does not support text very well and it is also not possible to correctly “escape back” to - <span -class="cmcsc-10"><small -class="small-caps">H</small><small -class="small-caps">T</small><small -class="small-caps">M</small><small -class="small-caps">L</small></span>. All these problems will hopefully disappear in the future, but currently only two kinds of - text work reasonably well: First, plain text without math mode, special characters or anything - else special. Second, <span -class="cmti-10">very </span>simple mathematical text that contains subscripts or superscripts. Even - then, variables are not correctly set in italics and, in general, text simple does not look very nice. - - - </li> - <li class="enumerate" value="4" -><a - id="x6-64010x4"></a>If you use text that contains anything special, even something as simple as <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">$\alpha$</span></span></span>, this may - corrupt the graphic since <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">text4ht</span></span></span> does not always produce valid <span -class="cmcsc-10"><small -class="small-caps">X</small><small -class="small-caps">M</small><small -class="small-caps">L</small> </span>code. So, once more, <span -class="cmti-10">stick</span> - <span -class="cmti-10">to very simple node text inside graphics. </span>Sorry. - </li> - <li class="enumerate" value="5" -><a - id="x6-64012x5"></a>Unlike for other output formats, the bounding box of a picture “really crops” the picture.</li></ol> - <!--l. 309--><p class="noindent">The driver basically works as follows: When a <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">{pgfpicture}</span></span></span> is started, appropriate <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\special</span></span></span> commands are - used to directed the output of <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">tex4ht</span></span></span> to a new file called <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">\jobname-xxx.svg</span></span></span>, where <span class="obeylines-h"><span class="verb"><span -class="cmtt-10">xxx</span></span></span> is a - number that is increased for each graphic. Then, till the end of the picture, each (system layer) - graphic command creates a specials that insert appropriate <span -class="cmcsc-10"><small -class="small-caps">S</small><small -class="small-caps">V</small><small -class="small-caps">G</small> </span>literal text into the output file. - The exact details are a bit complicated since the imaging model and the processing model of - PostScript/<span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">D</small><small -class="small-caps">F</small></span> and <span -class="cmcsc-10"><small -class="small-caps">S</small><small -class="small-caps">V</small><small -class="small-caps">G</small> </span>are not quite the same; but they are “close enough” for <span -class="cmcsc-10"><small -class="small-caps">P</small><small -class="small-caps">G</small><small -class="small-caps">F</small></span>’s purposes. - </dd></dl> - - - - - <div class="crosslinks"><p class="noindent">[<a -href="pgfmanualse4.html" >prev</a>] [<a -href="pgfmanualse4.html#tailpgfmanualse4.html" >prev-tail</a>] [<a -href="pgfmanualse5.html" >front</a>] [<a -href="pgfmanual.html#pgfmanualse5.html" >up</a>] </p></div> -<!--l. 132--><p class="indent"> <a - id="tailpgfmanualse5.html"></a> -</body></html> |