At least one, and as many as three run control files are used to customize the settings of xviewsdts.
 

RUN CONTROL FILE	DESCRIPTION
/usr/local/etc/xviewsdtsrc.first	Host-wide defaults for all users.
$HOME/.xviewsdts/xviewsdtsrc	Defined for a specific user, overrides the above.
/usr/local/etc/xviewsdtsrc.last	Host-wide requirements for all users, overrides the above.

The format of all three files is the same.  Normally only /usr/local/etc/xviewsdtsrc.first need be installed.  If a single user wishes to create a personal run control file, he or she may create .xviewsdts/xviewsdtsrc in his or her home directory.  (Please note that the directory name .xviewsdts/ begins with a dot.)  Rarely, if ever, will there be a need to create /usr/local/etc/xviewsdtsrc.last.  This would only be necessary if the system administrator felt the need to override any unfriendly settings that a user might set in his or her personal run control file.

What follows is a list of all the items currently supported by the run control files.  It is probably a good idea to include all items in /usr/local/etc/xviewsdtsrc.first, but each item need only appear in one file.  So it unnecessary (although permissible) to put any items in $HOME/.xviewsdts/xviewsdtsrc other than the ones to be customized.  No items should appear in /usr/local/etc/xviewsdtsrc.last except those which the system administrator wishes to override.
 

ITEM	DESCRIPTION
browser_command_new	Command for starting a new session of your web browser to open a URL. In the command, you should represent the URL by "%s", for instance: "/usr/bin/netscape %s". (The "%s" will be replaced by XViewSDTS with a URL.)
browser_command_old	Command for using the current session of your web browser to open a URL. In the command, you should represent the URL by "%s", for instance: "/usr/bin/netscape -remote openURL(%s)". (The "%s" will be replaced by XViewSDTS with the URL.)
browser_lockfile_pathname	Directory and name of the lock file for your web browser, for instance: "/home/dmapper/.netscape/lock". (XViewSDTS will look for this file to determine if your web browser is already running.)
dlg_directory	Directory at the top of the tree containing the SDTS files.
essential_files_directory	Directory containing the files that are essential to the operation of XViewSDTS, such as legend_base.png.
fips55_pathname	Directory and name of the file containing the FIPS 55 codes for states, counties, and townships.
gnis_directory	Directory containing the GNIS files.
included_symbol_directory	Directory containing the graphic characteristics symbols that were included in the XViewSDTS package.
init_lat	Initial latitude to display at center of window.  Range is -90 to 90.  Fractional values are okay (e.g., 43.6875).
init_lon	Initial longitude to display at center of window.  Range is -180 to 180 (remember, North America is negative).  Fractional values are okay (e.g., -72.3125).
init_series	Initial map series to display.  Must be 2000000, 100000, or 24000.
init_zoom	Initial zoom level.  Range is 0 to 8  (See Levels for init_zoom, below, for definitions of zoom levels.)
lookup_24_pathname	Directory and name of lookup file for 1:24000 series surfaces.
lookup_100_pathname	Directory and name of lookup file for 1:100000 series surfaces.
lookup_2000_pathname	Directory and name of lookup file for 1:2000000 series surfaces.
mdd_24_path	Directory containing the Master Data Dictionary for 1:24000 series surfaces.
mdd_100_path	Directory containing the Master Data Dictionary for 1:100000 series surfaces.
mdd_2000_path	Directory containing the Master Data Dictionary for 1:2000000 series surfaces.
recursive_depth	Maximum number of subdirectories to search below the directory named by dlg_directory.
reserved_symbol_directory	Directory containing the graphic characteristics symbols whose names are reserved by XViewSDTS, such as none.
symbol_directory	Directory containing the graphic characteristics symbols that you have created for your overlay maps.

The point defined by init_lat, init_lon, and init_series must, of course, correspond to a surface in your SDTS collection (unless you enjoy looking at a blank window).  Most of the other items will never need to be changed from the values defined in the  /usr/local/etc/xviewsdtsrc.first file supplied in the XViewSDTS package.

Here is a sample run control file:

dlg_directory=/usr/local/share/usgs/

reserved_symbol_directory=/usr/local/lib/xviewsdts/symbols

symbol_directory=/home/dmapper/.xviewsdts/symbols

included_symbol_directory=/usr/local/lib/xviewsdts/symbols

essential_files_directory=/usr/local/lib/xviewsdts/essential

recursive_depth=5

mdd_24_path=/usr/local/share/usgs/dlg24/Master/

mdd_100_path=/usr/local/share/usgs/dlg100/Master/

mdd_2000_path=/usr/local/share/usgs/dlg2000/Master/

fips55_pathname=/usr/local/share/nist/fips55/all

gnis_directory=/usr/local/share/usgs/gnis/

lookup_24_pathname=/usr/local/share/usgs/dlg24/lookup

lookup_100_pathname=/usr/local/share/usgs/dlg100/lookup

lookup_2000_pathname=/usr/local/share/usgs/dlg2000/lookup

browser_command_new="/usr/bin/netscape %s"

browser_command_old="/usr/bin/netscape -remote openURL(%s)"

browser_lockfile_pathname=/home/dmapper/.netscape/lock

init_lat=43.6875

init_lon=-72.3125

init_series=24000

init_zoom=3

Levels for init_zoom:

UTM Coordinate System (native to 1:24000 and 1:100000 series)

init_zoom	cm per pixel	pixels per km
0	32000	3.125
1	16000	6.25
2	8000	12.5
3	4000	25
4	2000	50
5	1000	100
6	500	200
7	250	400
8	125	800

GEO Coordinate System (native to 1:2000000 series)

init_zoom	millionths of a degree per pixel	pixels per degree
0	32000	31.25
1	16000	62.5
2	8000	125
3	4000	250
4	2000	500
5	1000	1000
6	500	2000
7	250	4000
8	125	8000

Copyright © 2002, 2005 by Dapper Mapper