IMS Config.txt Options

The config.txt file contains configuration information for the Manifold Internet Map Server (IMS) web pages that it accompanies. It is an ordinary text file that may be edited with Notepad. The config.txt file is automatically generated by the Export Web Page dialog. A typical config.txt file might look like:

 

component = Mexico Drawing 1

copyright = Copyright (C) 2002. All rights reserved.

cx = 500

cy = 400

file = C:\maps\mexico.map

queries =

subtitle = Click near an edge to pan map. Zoom in to see more layers.

title = Mexico

 

Once a web site is generated, the config.txt file may be edited to make simple changes. For example, if the .map file used is moved to a different location the file = string can be changed.

 

Parameters (with typical examples of usage in the left column) may be:

 

antialiasLines = true

Set to true or false to turn on or off antialiasing of lines.

antialiasTexts = true

Set to true or false to turn on or off antialiasing of text.

clickAccuracy = 10

Specifies the clicking tolerance in pixels when hyperlinks are clicked or the info tool is clicked on an object. The default accuracy is 4 pixels. Adding a line like that to the left will decrease accuracy to 10 pixels, so that a mouse click within ten pixels of the object will be as if the mouse were clicked directly onto the object.

Component = MyMap

Name of component within the project to use. For example, if you have a map component named "MyMap" and you want that to be the component displayed by IMS.

configurationFolder = %Manifold%\Config

The location of the Configuration folder, as given in Tools - Options, File Locations.

Copyright = Copyright (c) Acme Corp, 2005

String to use in copyright position in standard templates.

country = United States

Default country name for use by the geocoding engine.

cx = 800

Width of the generated image in pixels.

cy = 600

Height of the generated image in pixels.

dataCacheFolder = %MyDocuments%

The location of the Data Cache folder, as given in Tools - Options, File Locations.

datumGridsFolder = %Manifold%\Grids

The location of the Datum Grids folder, as given in Tools - Options, File Locations.

File = c:\data.map

Absolute path to file to use.

geocodingDatabaseFolder = %Manifold%\GCDB

The location of the Geocoding Database folder, as given in Tools - Options, File Locations.

geocodingExtensionsFolder = %Manifold%\GCDBX

The location of the Geocoding Extensions folder, as given in Tools - Options, File Locations.

geocodingServers = Geocoder.us, mygcdbserver.org

A list of Manifold Geocoding Servers to use by the geocoding engine, separated by commas.

hyperlinks = true

Enable hyperlinks.

hyperlinksNew = false

If true, launch hyperlinks in new browser.

imageDesc = true

Embeds text information into the generated .png image.

logfile = c:\mapserver.log

Specifies the path to the logfile, if used. By default, a logfile is not used. If used, a logfile will log useful parameters, for example, the time required to render the legend, if a legend is used.

logo = true

Available for Enterprise Edition users. If false, suppresses "Powered by manifold.net" logo.

mrSidDecodeUtilityPath = MrSidDecode.exe

The path to the MrSID Decode utility, as given in Tools - Options, File Locations.

mrSidInfoUtilityPath = MrSidInfo.exe

The path to the MrSID Info utility, as given in Tools - Options, File Locations.

ogcWmsCaps = C:\Inetpub\Wwwroot\filename

Specifies the path to the custom server capabilities document, if used, for OGC WMS.

preferMapPointToGeocodingDatabase = false

Set to true or false. If true, gives MapPoint priority over Manifold Geocoding Database as a geocoding data source for the geocoding engine.

Proxy = true

Set to true or false. Set to "true" if network connections require the use of a proxy server, set to "false" otherwise.

proxyAddress = http://netproxy:8080

Proxy server address.

proxyPassword = 123passwd

Password used to login onto the proxy server.

proxyUser = rootuser

User name used to login onto the proxy server.

renderFormat = png

Set rendering format. Supported rendering formats are gif, jpeg and png.

renderOptions = dither

Set rendering options. Supported rendering options are dither (supported for gif rendering format) and interlace (supported for png rendering format).

renderQuality = 100

Set rendering quality in the range of 1 to 100, with 100 being the maximum quality.

queries = "Query 1", "Query 2", 52

Specifies queries used by IMS, using their names (such as "Query 1" ) or IDs (such as 52)

queryLimit = 100

Specifies the maximum number of records returned to the user by a query. The default value is 200.

refreshLinks = 60

Time interval over which linked components used in the website will be refreshed, in minutes. A value of 0 will refresh links on each browser access (can help debug server-side logic, not recommended for servers running in production mode due to heavy performance requirements).

refreshLinksOnOpen = true

Set to true or false. When true (the default), automatically refreshes linked components in opened MAP files. When false, does not automatically refresh linked components to save time.

scaleNumeric = true

Set to true or false. When true, causes scale (if used) to be reported as the horizontal extent of the visible region shown in the map server image. When false, scale is reported in absolute scale form

scaleEnglish = true

Set to true or false. When true, turns on the use of English measurement units when reporting scale in horizontal extent form, otherwise scale will be reported in metric units.

selectionColor = 255:0:0

Specify color in either hexadecimal or decimal form to use for selection color within IMS.

Hexadecimal colors are in "#rrggbb" form where rr, gg and bb are pairs of hexadecimal digits giving a hexadecimal number corresponding to the decimal number range from 0 to 255 for Red (rr), Green (gg) or Blue (bb). Leading zeros are significant, so that RGB values of 3, 5 and 6 are coded as 030506 in hexadecimal numbers. For example, selectionColor = #54BBB3 will set selection color to a light green-blue color instead of the default red selection color.

Decimal colors may be in two forms: either r:g:b form where r, g and b are decimal integer numbers in the range from 0 to 255 or as a single decimal number that is the decimal equivalent of a #rrggbb hexadecimal number.

selectionStyle = dashes

Controls the selection style used to display selections. Possible option values are: border, denseDots, mediumDots, sparseDots, and dashes. Case does not matter. For example, selectionStyle = border will change the selection style used to a border outline for areas.

smoothLargeVectorObjects = true

Set to true or false to turn smoothing of large vector objects on and off. Turning smoothing on increases performance at a slight cost in rendering quality.

Subtitle = Use the toolbar buttons to switch between zoom and pan modes.

String to use in subtitle position in standard templates.

Title = My Map

String to use in title position in standard templates.

useGeocodingDatabase = true

Set to true or false. Toggles the use of the Manifold Geocoding Database as a geocoding data source by the geocoding engine.

useGeocodingExtensions = true

Set to true or false. Toggles the use of geocoding data extensions as a geocoding data source by the geocoding engine.

useMapPointEurope = true

Set to true or false. Toggles the use of MapPoint Europe as a geocoding data source by the geocoding engine.

useMapPointNorthAmerica = true

Set to true or false. Toggles the use of MapPoint North America as a geocoding data source by the geocoding engine.

 

For example, we can edit the above config.txt file as follows:

 

component = Mexico Drawing 1

copyright = Copyright (C) 2005. All rights reserved.

cx = 500

cy = 400

file = C:\maps\mexico.map

queries =

subtitle = Click near an edge to pan map. Zoom in to see more layers.

title = Mexico

scaleNumeric = true

scaleEnglish = false

 

This will cause the scale to be reported as the number of kilometers spanning the horizontal extent of the displayed map server image.

 

A useful way of seeing what a config.txt file looks like is to create a web site, checking the Save proxy connection and file locations in the config file option checkbox, and then open the config.txt file to see what Manifold has created.

 

Manifold System Edition Requirements

 

You must be running Manifold System Professional Edition or greater to have the capabilities discussed in this topic. All Manifold System editions except Personal Edition include the map server. If you are running Manifold System Personal Edition you will not have the capabilities discussed in this topic.

 

Required Geocoding Tools

 

Manifold's street address geocoding capability becomes operational only when the optional Manifold Geocoding Tools package is installed. If you do not have the optional Geocoding Tools package, you will not be able to use street address geocoding functions within Manifold IMS or take advantage of the street address geocoding data provided on the Manifold downloads site for the United States.

 

Note that Manifold Universal Edition automatically installs the Geocoding Tools package. If you are using Universal Edition, you do not need to perform an extra Geocoding Tools installation as it has already been installed.

 

Required Geocoding Data Sources

 

In addition to installation of Geocoding Tools, for any street address geocoding capabilities the Manifold installation must have access to a geocoding data source. Once enabled by installation of the Geocoding Tools package, Manifold can use a variety of geocoding data sources, including the Manifold Geocoding Database for US streets provided on the Manifold downloads site, MapPoint North American or European editions, user-provided geocoding data extensions or Manifold Geocoding Servers accessed through the web.

 

See the Geocoding Data Sources topic for information on these sources as well as information on installing the Manifold Geocoding Database from the Manifold downloads site.

 

See Also

 

Geocoding Data Sources

Geocoding Tools

Map Server Overview

Creating a Web Site

IMS Queries

Publishing Multiple Pages

Optimizing Performance