From 447e0daa09677fc75c2505e626c4be1e59f00019 Mon Sep 17 00:00:00 2001
From: rudolfkoenig <>
Date: Sat, 21 Jan 2012 12:14:26 +0000
Subject: [PATCH] Documenting svg-style
git-svn-id: https://svn.fhem.de/fhem/trunk/fhem@1199 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
docs/commandref.html | 103 ++++++++++++++++++++++++++++++++++++++++++-
docs/pgm2-3.png | Bin 124684 -> 252787 bytes
2 files changed, 101 insertions(+), 2 deletions(-)
diff --git a/docs/commandref.html b/docs/commandref.html
index 09ab91546..d88a96019 100644
--- a/docs/commandref.html
+++ b/docs/commandref.html
@@ -157,6 +157,7 @@
Perl specials
+ gnuplot file syntax
@@ -8194,9 +8195,107 @@ isday
-
-
+
+gnuplot file syntax
+
+The .gplot files are also used by the FHEMWEB/SVG module
+when the plotmode attribute is set to SVG. In this case
+only a subset of the .gnuplot attributes are used, and some lines have special
+meanings: the difference will be explained in this chapter. See also this fhemwiki entry on
+creating logs.
+Following is a minimal .gplot definition (valid only for plotmode SVG):
+
+ set terminal size <SIZE>
+ #FileLog 4:::
+ plot title 'Temperature' with lines
+
+The .gnuplot file consists of 3 parts:
+
+ - set commands
+ Following sets are recognized:
+
+ - terminal, only the size parameter.
+ This is usually set to <SIZE>, which is replaced by the plotsize attribute of the FHEMWEB or weblink
+ instance.
+
+ - title
+ Usually set to <TL> which is replace by the weblink title attribute, or to <Lx>, which is replaced
+ by the weblink label attribute.
+
+ - ylabel,y2label
+ Left and right labels, printed vertically. Are also subject to label
+ replacement.
+
+ - yrange,y2range
+ Specify the range of the left and right axis. Examples:
+
+ set yrange [-0.1:1.1]
+ set y2range [0:]
+
+
+ - ytics,y2tics
+ the label for the left/right axis tics. Examples:
+
+ set ytics ("on" 0, "off" 1)
+ set y2tics
+
+
+
+
+
+
+ - #FileLog entries
+ Each line from the plot section must have one corresponding #FileLog
+ line. For the syntax see the column_spec paragraph of the Filelog get description.
+ Note that for SVG plots the first column of the input file always has to
+ be in the standard fhem timestamp format (YYYY-MM-DD_HH:MM:SS)
+
+
+
+ - plot entries
+ There is always one plot command with comma separated argument-blocks.
+ Each argument-block represents one line, and has its own parameters.
+ Following parameters are recognized:
+
+ - axes x1y1 / x1y2
+ tells the program to assign the current line to one of the two axes
+ (left or right).
+
+ - title
+ Caption of the line. Whan clicking on this title, a small javascript
+ program will change the title to the min/max and last values of the plot,
+ will enable copying this line or pasting an already copied one (the
+ existing scale of the plot wont'be changed, only the pasted line will
+ be scaled), and other lines of the plot will temporarily be hidden.
+
+ - with <linetype>
+ Specify the line type. Following types are recognized: points,
+ steps, fsteps, histeps and lines. Everything unknown will be mapped to
+ the type lines.
+
+ - ls <linestyle>
+ The linestyle defaults to l0 for the first line, l1 for the second, and
+ so on. It is defined in the svg_style.css file. There are two sets
+ defined here: l0-l8 and l0fill-l6fill. The second set must be specified
+ explicitly. If the name of the linestyle contains the word fill, then
+ plots of the lineytype "lines" will have an additional starting and
+ ending segment, so that filling is done correctly.
+ See the SVG spec for details of this CSS file.
+
+ - lw <linewidth>
+ Sets the stroke-width style of the line. This attribute is deprecated,
+ the corresponding feature of the CSS file / (attribute ls) should be
+ used instead.
+
+
+
+
+