Commit f70f7a8
sfeam
repair damage to file format
1 parent b16be87 commit f70f7a8
1 file changed
Lines changed: 117 additions & 124 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -1,124 +1,117 @@ | |||
| 1 | - This script is intended to be called from GNUPLOT. | ||
| 2 | - | ||
| 3 | - For generating the associated LaTeX style file | ||
| 4 | - ('gnuplot-lua-tikz.sty') just call this script | ||
| 5 | - with the additional option 'style': | ||
| 6 | - | ||
| 7 | - # lua gnuplot.lua style | ||
| 8 | - | ||
| 9 | - The TikZ driver provides the following additional terminal options: | ||
| 10 | - | ||
| 11 | - {help} | ||
| 12 | - {monochrome} | ||
| 13 | - {solid} | ||
| 14 | - {originreset} | ||
| 15 | - {gparrows} | ||
| 16 | - {gppoints} | ||
| 17 | - {nopicenvironment} | ||
| 18 | - {size <x>{unit},<y>{unit}} | ||
| 19 | - {scale <x>,<y>} | ||
| 20 | - {plotsize <x>{unit},<y>{unit}} | ||
| 21 | - {charsize <x>{unit},<y>{unit}} | ||
| 22 | - {font "<fontdesc>"} | ||
| 23 | - {createstyle} | ||
| 24 | - {fulldoc|standalone} | ||
| 25 | - {{preamble|header} "<preamble_string>"} | ||
| 26 | - {tikzplot <ltn>,...} | ||
| 27 | - {tikzarrows} | ||
| 28 | - {cmykimages} | ||
| 29 | - {nobitmap} | ||
| 30 | - {providevars <var name>,...} | ||
| 31 | - | ||
| 32 | - For all options that expect lengths as their arguments they | ||
| 33 | - will default to 'cm' if no unit is specified. For all lengths | ||
| 34 | - the following units may be used: 'cm', 'mm', 'in' or 'inch', | ||
| 35 | - 'pt', 'pc', 'bp', 'dd', 'cc'. Blanks between numbers and units | ||
| 36 | - are not allowed. | ||
| 37 | - | ||
| 38 | - 'monochrome' disables line coloring and switches to grayscaled | ||
| 39 | - fills. | ||
| 40 | - | ||
| 41 | - 'solid' use only solid lines. | ||
| 42 | - | ||
| 43 | - 'originreset' moves the origin of the TikZ picture to the lower | ||
| 44 | - left corner of the plot. It may be used to align several plots | ||
| 45 | - within one tikzpicture environment. This is not tested with | ||
| 46 | - multiplots and pm3d plots! | ||
| 47 | - | ||
| 48 | - 'gparrows' use gnuplot's internal arrow drawing function | ||
| 49 | - instead of the ones provided by TikZ. | ||
| 50 | - | ||
| 51 | - 'gppoints' use gnuplot's internal plotmark drawing function | ||
| 52 | - instead of the ones provided by TikZ. | ||
| 53 | - | ||
| 54 | - 'nopicenvironment' omits the declaration of the 'tikzpicture' | ||
| 55 | - environment in order to set it manually. This permits putting | ||
| 56 | - some PGF/TikZ code directly before or after the plot. | ||
| 57 | - | ||
| 58 | - The 'size' option expects two lenghts <x> and <y> as the canvas size. | ||
| 59 | - The default size of the canvas is 12.5cm x 8.75cm. | ||
| 60 | - | ||
| 61 | - The 'scale' option works similar to the 'size' option but expects | ||
| 62 | - scaling factors <x> and <y> instead of lengths. | ||
| 63 | - | ||
| 64 | - The 'plotsize' option permits setting the size of the plot area | ||
| 65 | - instead of the canvas size, which is the usual gnuplot behaviour. | ||
| 66 | - Using this option may lead to slightly asymmetric tic lengths. | ||
| 67 | - Like 'originreset' this option may not lead to convenient results | ||
| 68 | - if used with multiplots or pm3d plots. | ||
| 69 | - | ||
| 70 | - The 'charsize' option expects the average horizontal and vertical | ||
| 71 | - size of the used font. Look at the generated style file for an | ||
| 72 | - example of how to use it from within your TeX document. | ||
| 73 | - | ||
| 74 | - 'createstyle' derives the LaTeX style file from the script and | ||
| 75 | - writes it to the file 'gnuplot-lua-tikz.sty'. | ||
| 76 | - | ||
| 77 | - 'fulldoc' or 'standalone' produces a full LaTeX document for direct | ||
| 78 | - compilation. | ||
| 79 | - | ||
| 80 | - 'preamble' or 'header' may be used to put any additional LaTeX code | ||
| 81 | - into the document preamble in standalone mode. | ||
| 82 | - | ||
| 83 | - With the 'tikzplot' option the '\path plot' command will be used | ||
| 84 | - instead of only '\path'. The following list of numbers of linetypes | ||
| 85 | - (<ltn>,...) defines the affected plotlines. There exists a plotstyle | ||
| 86 | - for every linetype. The default plotstyle is 'smooth' for every | ||
| 87 | - linetype >= 1. | ||
| 88 | - | ||
| 89 | - By using the 'tikzarrows' option the gnuplot arrow styles defined by | ||
| 90 | - the user will be mapped to TikZ arrow styles. This is done by 'misusing' | ||
| 91 | - the angle value of the arrow definition. E.g. an arrow style with the | ||
| 92 | - angle '7' will be mapped to the TikZ style 'gp arrow 7' ignoring all the | ||
| 93 | - other given values. By default the TikZ terminal uses the stealth' arrow | ||
| 94 | - tips for all arrows. To obtain the default gnuplot behaviour please use | ||
| 95 | - the 'gparrows' option. | ||
| 96 | - | ||
| 97 | - With 'cmykimages' the CMYK color model will be used for image data | ||
| 98 | - instead of the RGB model. All other colors (like line colors etc.) are | ||
| 99 | - not affected by this option, since they are handled by the xcolors | ||
| 100 | - package. So take care to change the color model also there if needed. | ||
| 101 | - | ||
| 102 | - The 'nobitmap' option let images be rendered as filled rectangles | ||
| 103 | - instead of the nativ PS or PDF image format. This option has to be | ||
| 104 | - enabled if you intend to use other output formats. | ||
| 105 | - | ||
| 106 | - The 'providevars' options makes gnuplot's internal and user variables | ||
| 107 | - available by using the '\gpgetvar{<var name>}' commmand within the TeX | ||
| 108 | - script. Use gnuplot's 'show variables all' command to see the list | ||
| 109 | - of valid variables. | ||
| 110 | - | ||
| 111 | - The <fontdesc> string may contain any valid LaTeX font commands like | ||
| 112 | - e.g. '\small'. It is passed directly as a node parameter in form of | ||
| 113 | - "font=<fontdesc>". This can be 'misused' to add further code to a node, | ||
| 114 | - e.g. '\small,yshift=1ex' or ',yshift=1ex' are also valid while the | ||
| 115 | - latter does not change the current font settings. One exception is | ||
| 116 | - the second argument of the list. If it is a number of the form | ||
| 117 | - <number>{unit} it will be interpreted as a fontsize like in other | ||
| 118 | - terminals and will be appended to the first argument. If the unit is | ||
| 119 | - omitted the value is interpreted as 'pt'. As an example the string | ||
| 120 | - '\sffamily,12,fill=red' sets the font to LaTeX's sans serif font at | ||
| 121 | - a size of 12pt and red background color. | ||
| 122 | - | ||
| 123 | - Strings have to be put in single or double quotes. Double quoted | ||
| 124 | - strings may contain special characters like newlines '\n' etc. | ||
| 1 | + "", | ||
| 2 | + " The TikZ driver provides the following additional terminal options:", | ||
| 3 | + "", | ||
| 4 | + " {help}", | ||
| 5 | + " {monochrome}", | ||
| 6 | + " {solid}", | ||
| 7 | + " {originreset}", | ||
| 8 | + " {gparrows}", | ||
| 9 | + " {gppoints}", | ||
| 10 | + " {nopicenvironment}", | ||
| 11 | + " {size <x>{unit},<y>{unit}}", | ||
| 12 | + " {scale <x>,<y>}", | ||
| 13 | + " {plotsize <x>{unit},<y>{unit}}", | ||
| 14 | + " {charsize <x>{unit},<y>{unit}}", | ||
| 15 | + " {font \"<fontdesc>\"}", | ||
| 16 | + " {createstyle}", | ||
| 17 | + " {fulldoc|standalone}", | ||
| 18 | + " {{preamble|header} \"<preamble_string>\"}", | ||
| 19 | + " {tikzplot <ltn>,...}", | ||
| 20 | + " {tikzarrows}", | ||
| 21 | + " {cmykimages}", | ||
| 22 | + " {nobitmap}", | ||
| 23 | + " {providevars <var name>,...}", | ||
| 24 | + "", | ||
| 25 | + " For all options that expect lengths as their arguments they", | ||
| 26 | + " will default to 'cm' if no unit is specified. For all lengths", | ||
| 27 | + " the following units may be used: 'cm', 'mm', 'in' or 'inch',", | ||
| 28 | + " 'pt', 'pc', 'bp', 'dd', 'cc'. Blanks between numbers and units", | ||
| 29 | + " are not allowed.", | ||
| 30 | + "", | ||
| 31 | + " 'monochrome' disables line coloring and switches to grayscaled", | ||
| 32 | + " fills.", | ||
| 33 | + "", | ||
| 34 | + " 'solid' use only solid lines.", | ||
| 35 | + "", | ||
| 36 | + " 'originreset' moves the origin of the TikZ picture to the lower", | ||
| 37 | + " left corner of the plot. It may be used to align several plots", | ||
| 38 | + " within one tikzpicture environment. This is not tested with", | ||
| 39 | + " multiplots and pm3d plots!", | ||
| 40 | + "", | ||
| 41 | + " 'gparrows' use gnuplot's internal arrow drawing function", | ||
| 42 | + " instead of the ones provided by TikZ.", | ||
| 43 | + "", | ||
| 44 | + " 'gppoints' use gnuplot's internal plotmark drawing function", | ||
| 45 | + " instead of the ones provided by TikZ.", | ||
| 46 | + "", | ||
| 47 | + " 'nopicenvironment' omits the declaration of the 'tikzpicture'", | ||
| 48 | + " environment in order to set it manually. This permits putting", | ||
| 49 | + " some PGF/TikZ code directly before or after the plot.", | ||
| 50 | + "", | ||
| 51 | + " The 'size' option expects two lenghts <x> and <y> as the canvas size.", | ||
| 52 | + " The default size of the canvas is 12.5cm x 8.75cm.", | ||
| 53 | + "", | ||
| 54 | + " The 'scale' option works similar to the 'size' option but expects", | ||
| 55 | + " scaling factors <x> and <y> instead of lengths.", | ||
| 56 | + "", | ||
| 57 | + " The 'plotsize' option permits setting the size of the plot area", | ||
| 58 | + " instead of the canvas size, which is the usual gnuplot behaviour.", | ||
| 59 | + " Using this option may lead to slightly asymmetric tic lengths.", | ||
| 60 | + " Like 'originreset' this option may not lead to convenient results", | ||
| 61 | + " if used with multiplots or pm3d plots.", | ||
| 62 | + "", | ||
| 63 | + " The 'charsize' option expects the average horizontal and vertical", | ||
| 64 | + " size of the used font. Look at the generated style file for an", | ||
| 65 | + " example of how to use it from within your TeX document.", | ||
| 66 | + "", | ||
| 67 | + " 'createstyle' derives the LaTeX style file from the script and", | ||
| 68 | + " writes it to the file 'gnuplot-lua-tikz.sty'.", | ||
| 69 | + "", | ||
| 70 | + " 'fulldoc' or 'standalone' produces a full LaTeX document for direct", | ||
| 71 | + " compilation.", | ||
| 72 | + "", | ||
| 73 | + " 'preamble' or 'header' may be used to put any additional LaTeX code", | ||
| 74 | + " into the document preamble in standalone mode.", | ||
| 75 | + "", | ||
| 76 | + " With the 'tikzplot' option the '\\path plot' command will be used", | ||
| 77 | + " instead of only '\\path'. The following list of numbers of linetypes", | ||
| 78 | + " (<ltn>,...) defines the affected plotlines. There exists a plotstyle", | ||
| 79 | + " for every linetype. The default plotstyle is 'smooth' for every", | ||
| 80 | + " linetype >= 1.", | ||
| 81 | + "", | ||
| 82 | + " By using the 'tikzarrows' option the gnuplot arrow styles defined by", | ||
| 83 | + " the user will be mapped to TikZ arrow styles. This is done by 'misusing'", | ||
| 84 | + " the angle value of the arrow definition. E.g. an arrow style with the", | ||
| 85 | + " angle '7' will be mapped to the TikZ style 'gp arrow 7' ignoring all the", | ||
| 86 | + " other given values. By default the TikZ terminal uses the stealth' arrow", | ||
| 87 | + " tips for all arrows. To obtain the default gnuplot behaviour please use", | ||
| 88 | + " the 'gparrows' option.", | ||
| 89 | + "", | ||
| 90 | + " With 'cmykimages' the CMYK color model will be used for image data", | ||
| 91 | + " instead of the RGB model. All other colors (like line colors etc.) are", | ||
| 92 | + " not affected by this option, since they are handled by the xcolors", | ||
| 93 | + " package. So take care to change the color model also there if needed.", | ||
| 94 | + "", | ||
| 95 | + " The 'nobitmap' option let images be rendered as filled rectangles", | ||
| 96 | + " instead of the nativ PS or PDF image format. This option has to be", | ||
| 97 | + " enabled if you intend to use other output formats.", | ||
| 98 | + "", | ||
| 99 | + " The 'providevars' options makes gnuplot's internal and user variables", | ||
| 100 | + " available by using the '\\gpgetvar{<var name>}' commmand within the TeX", | ||
| 101 | + " script. Use gnuplot's 'show variables all' command to see the list", | ||
| 102 | + " of valid variables.", | ||
| 103 | + "", | ||
| 104 | + " The <fontdesc> string may contain any valid LaTeX font commands like", | ||
| 105 | + " e.g. '\\small'. It is passed directly as a node parameter in form of", | ||
| 106 | + " \"font=<fontdesc>\". This can be 'misused' to add further code to a node,", | ||
| 107 | + " e.g. '\\small,yshift=1ex' or ',yshift=1ex' are also valid while the", | ||
| 108 | + " latter does not change the current font settings. One exception is", | ||
| 109 | + " the second argument of the list. If it is a number of the form", | ||
| 110 | + " <number>{unit} it will be interpreted as a fontsize like in other", | ||
| 111 | + " terminals and will be appended to the first argument. If the unit is", | ||
| 112 | + " omitted the value is interpreted as 'pt'. As an example the string", | ||
| 113 | + " '\\sffamily,12,fill=red' sets the font to LaTeX's sans serif font at", | ||
| 114 | + " a size of 12pt and red background color.", | ||
| 115 | + "", | ||
| 116 | + " Strings have to be put in single or double quotes. Double quoted", | ||
| 117 | + " strings may contain special characters like newlines '\\n' etc.", | ||
0 commit comments