Customizing XTide
XTide is customized by changing its settings. The most
convenient way to do this is generally through the control panel that
is documented in a previous section. However,
you can also change these settings in config.hh, in your X resources database,
or on the command line. The order of precedence, from
least significant to most significant, is:
- config.hh
- Xdefaults (X resources)
- ~/.xtide.xml (control panel)
- command line
Note that only xtide (not xttpd or tide)
reads Xdefaults.
All command line settings take the form -xx value, with a space between
the switch and the supplied value. Even the yes-or-no settings require
a value of "y" or "n" to be supplied.
-
XTide*background
-
Background color for text windows and location chooser.
Default: white
Command line: -bg
config.hh: bgdefcolor
.xtide.xml: <xtideoptions bg="white"/>
-
XTide*buttoncolor
-
Background color of buttons.
Default: gray80
Command line: -bc
config.hh: buttondefcolor
.xtide.xml: <xtideoptions bc="gray80"/>
-
XTide*cwidth
-
Default width for tide clocks. NOTE: Default clock height is the
same as default graph height (XTide*gheight).
Default: 84
Command line: -cw
config.hh: defcwidth
.xtide.xml: <xtideoptions cw="84"/>
-
XTide*datefmt
-
Strftime style format string for printing dates.
Default: %Y-%m-%d
Command line: -df
config.hh: datefmt
.xtide.xml: <xtideoptions df="%Y-%m-%d"/>
-
XTide*datumcolor
-
Color of datum line in tide graphs.
Default: white
Command line: -Dc
config.hh: datumdefcolor
.xtide.xml: <xtideoptions Dc="white"/>
-
XTide*daycolor
-
Daytime background color in tide graphs.
Default: SkyBlue
Command line: -dc
config.hh: daydefcolor
.xtide.xml: <xtideoptions dc="SkyBlue"/>
-
XTide*ebbcolor
-
Foreground in tide graphs during outgoing tide.
Default: SeaGreen
Command line: -ec
config.hh: ebbdefcolor
.xtide.xml: <xtideoptions ec="SeaGreen"/>
-
XTide*extralines
-
Draw datum and MSL lines in tide graphs? (y/n)
Default: n
Command line: -el
config.hh: extralines
.xtide.xml: <xtideoptions el="n"/>
-
XTide*floodcolor
-
Foreground in tide graphs during incoming tide.
Default: Blue
Command line: -fc
config.hh: flooddefcolor
.xtide.xml: <xtideoptions fc="Blue"/>
-
XTide*foreground
-
Color of text and other notations.
Default: black
Command line: -fg
config.hh: fgdefcolor
.xtide.xml: <xtideoptions fg="black"/>
-
XTide*gaspect
-
Default aspect for tide graphs.
Default: 1.0
Command line: -ga
config.hh: defgaspect
.xtide.xml: <xtideoptions ga="1.0"/>
-
XTide*gheight
-
Default height for tide graphs.
Default: 312
Command line: -gh
config.hh: defgheight
.xtide.xml: <xtideoptions gh="312"/>
-
XTide*globelongitude
-
Default center longitude for globe.
Valid values: -180 -150 -120 -90 -60 -30 0 30 60 90 120 150 360
360 will pick the longitude with the most tide stations.
Default: 360
Command line: -gl
config.hh: defgl
.xtide.xml: <xtideoptions gl="360"/>
-
XTide*gwidth
-
Default width for tide graphs.
Default: 960
Command line: -gw
config.hh: defgwidth
.xtide.xml: <xtideoptions gw="960"/>
-
XTide*hourfmt
-
Strftime style format string for printing hour labels on time axis.
Default: %I
Command line: -hf
config.hh: hourfmt
.xtide.xml: <xtideoptions hf="%I"/>
-
XTide*lwidth
-
Width for lines in tide graphs with nofill.
Default: 2.5
Command line: -lw
config.hh: deflwidth
.xtide.xml: <xtideoptions lw="2.5"/>
-
XTide*markcolor
-
Color of mark line in graphs and of location dots on the spinning globe.
Default: red
Command line: -mc
config.hh: markdefcolor
.xtide.xml: <xtideoptions mc="red"/>
-
XTide*mslcolor
-
Color of Mean Sea Level line in tide graphs.
Default: yellow
Command line: -Mc
config.hh: msldefcolor
.xtide.xml: <xtideoptions Mc="yellow"/>
-
XTide*nightcolor
-
Nighttime background color in tide graphs.
Default: DeepSkyBlue
Command line: -nc
config.hh: nightdefcolor
.xtide.xml: <xtideoptions nc="DeepSkyBlue"/>
-
XTide*nofill
-
Draw tide graphs as line graphs? (y/n)
Default: n
Command line: -nf
config.hh: nofill
.xtide.xml: <xtideoptions nf="n"/>
-
XTide*timefmt
-
Strftime style format string for printing times.
Default: %I:%M %p %Z
Command line: -tf
config.hh: timefmt
.xtide.xml: <xtideoptions tf="%I:%M %p %Z"/>
-
XTide*toplines
-
Draw depth lines on top of tide graph? (y/n)
Default: n
Command line: -tl
config.hh: toplines
.xtide.xml: <xtideoptions tl="n"/>
-
XTide*ttyheight
-
Height of ASCII graphs (characters).
Default: 24
Command line: -th
config.hh: defttyheight
.xtide.xml: <xtideoptions th="24"/>
-
XTide*ttywidth
-
Width of ASCII graphs, banners, and calendars (characters).
Default: 79
Command line: -tw
config.hh: defttywidth
.xtide.xml: <xtideoptions tw="79"/>
-
XTide*units
-
Preferred units of length: ft, m, or x (no preference).
Default: x
Command line: -u
config.hh: prefunits
.xtide.xml: <xtideoptions u="x"/>
-
XTide*zulu
-
Coerce all time zones to UTC? (y/n)
Default: n
Command line: -z
config.hh: zulu
.xtide.xml: <xtideoptions z="n"/>
Format of ~/.xtide.xml
If you have compiled the interactive client (xtide), then you do not
need to worry about ~/.xtide.xml at all, because the control panel
will configure it for you automatically.
In the event that you cannot use xtide but still need to make some
settings for the command line client, use the example below as the starting
point for your ~/.xtide.xml file. This example just sets the TTY
geometry. You can add more settings by adding more attributes (like
the tw and th attributes shown here) to the xtideoptions entity. The
attributes that are recognized for each setting are documented above.
<?XML version="1.0" RMD="NONE"?>
<xtideoptions tw="79" th="24"/>