enhance seating docu draft

diff --git a/doc/seatplans.txt b/doc/seatplans.txt
index 42eaa0d..0382e3d 100644 (file)
--- a/doc/seatplans.txt
+++ b/doc/seatplans.txt
@@ -85,7 +85,7 @@ Graphical Seat Plans
 
 This part is never evaluated by the server, only by displays:
 
-<SeatPlan version="1" size="100 200">
+<SeatPlan version="1" size="100 200" bgcolor="darkred">
   <Group capacity="123" id="pr" name="Premium" numbered="yes" geo="0 20 100 100" bgcolor="#fcc">
     <Row id="2" capacity="23" first="2" geo="10 0 90 10/>
     <Row id="3" capacity="25" geo="0 20 100 30"/>
@@ -104,14 +104,30 @@ New Attributes:
  SeatPlan/size - relative canvas size, the actual canvas will be scaled to fit the display
  Group/geo - geometry relative to the canvas, coordinates are: x-left, y-top, x-right, y-bottom
  Row/geo - geometry relative to the Group
- bgcolor - (Group/Row) background color
- fgcolor - (Group/Row) foreground color
+ bgcolor - (Group/Row) background or fill color
+ fgcolor - (Group/Row) foreground or text color
+ linecolor - (Group/Row) the color of the outline; defaults to bgcolor
+ linewidth - (Group/Row) the width of the outline; defaults to 1 pixel
  Group/angle - rotate the group (value in degrees)
  Row/curve - row curvature, see below
 
 Colors: all web colors can be used by name, numeric values can be specified in hex
 either as "#rgb" or "#rrggbb".
 
+The background, foreground and line colors of seats can specify several space separated values:
+1) unsold seat - a seat that is available for selling to this customer, this color
+   must be specified if fgcolor is given
+2) already sold seat - a seat for which a ticket is already sold or reserved; if not
+   given it defaults to a slightly darker tone than 1)
+3) marked for selling to current customer - a seat chosen by the user for selling;
+   if not given it defaults to a slightly lighter tone than 1)
+4) not available - a seat that is not in the selected category or otherwise unavailable;
+   defaults to the grayscale equivalent of the color
+
+If bgcolor is missing it defaults to white for the entire SeatPlan, to orange for Rows and 
+to transparent for Groups.
+If fgcolor is missing it defaults to black.
+
 Curvature of Rows: a series of points at which to align seats... ?
  
 TODO: define trapezes(?), curved rows, etc.
@@ -136,7 +152,8 @@ The background of the seat plan can be defined in an additional element:
 
 Attributes:
   bgcolor - background or fill color (not for Text)
-  fgcolor - foreground (Text) or outline color
+  fgcolor - foreground or text color
+  linecolor/linewidth - see above
   geo - full size of the shape
   angle - rotation in degree
   Text/fontsize - font size in relative points of the seat plan, automatically scaled