Icon 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:

  1. config.hh
  2. Xdefaults (X resources)
  3. ~/.xtide.xml (control panel)
  4. 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"/>