Settings files provide an easy and flexible way of defining default plotting values for your plots and plot sets. Settings files, which can be either binary or ASCII, should be used to do the following:
Binary settings files:
ASCII settings files:
Note: Only data type support that is installed will display in this dialog box. The Common section enables you to specify common settings. Common settings include printer name, archive name, rendering attributes filename, and plot set attributes.
ASCII settings files are text files that contain Create and Modify command line qualifiers. The format of the settings file is one qualifier per line (along with its associated value). The maximum length of any line in a settings file is 1024 characters. The leading dash (-) character is optional when used in a settings file, though the command line interface requires it.
You can use any setting in a settings file except for the -settings qualifier. One additional setting you cannot use in a printer settings file is -printer. The following is an example of a settings file:
# This settings file establishes a default printer, color table, pen table and turns off # the display of enter data fields and text nodes. queue=hp5si color_table=c:\program files\common files\interplot\iplot\misc\color.ctb pen_table=c:\data\pen\test.pen nodisplay=[enter_data, text_nodes]
Types of Settings Files
Default Settings FileYou can create a default settings file that stores plot parameters that will be applied automatically each time you create plots using the dialog, Organizer or command line interfaces. By default, you must name the settings file IPLOT.SET and put it in one of three directories:
Printer Settings FileWhen you select a printer, InterPlot searches for a printer settings file, which defines the parameters related to a specific printer. For example, suppose you have a printer named color that connects to a color plotter and a printer named mono that connects to a monochrome plotter. You can create a printer settings file for each printer and use the color table qualifier to specify a different color table for each printer.
InterPlot searches for a printer settings file with the same name as the printer and with a .set extension appended to it. Using the previous example, InterPlot looks for a printer settings file named color.set when you use the color printer.
Manually Applied Settings FileAlthough InterPlot uses settings files automatically, you can manually load specific settings files by using Organizer, the dialog box or the command line. By manually applying settings files, you can store groups of commonly used qualifiers (along with their values) in a file and then reference them on demand. This method of referencing settings files is helpful when a group of plotting parameters is used only for a specific project or on an occasional basis.
To ensure that you have an opportunity to override any settings file defaults, InterPlot always processes settings files and any specified qualifiers in a particular order. The following priority issues are applicable to the dialog, Organizer and command line interfaces:
The following priority issues are applicable only to the command line:
There are several variables in the Common configuration file, ip.cfg, that relate to settings files.
IP_DEFAULT_SETTINGSIf you want to name the default settings file something other than iplot.set, you can change it. The default settings file name is defined by the configuration variable IP_DEFAULT_SETTINGS.
IP_SETTINGS_PATHThe directory locations for default and printer settings files can be changed. InterPlot searches the directories specified by the configuration variable IP_SETTINGS_PATH for default and printer settings files. Once it finds the first occurrence of the settings file, InterPlot does not search any of the remaining directories for the file. To specify a list of directories in the settings file search path, you must separate each directory with a semicolon.
IP_SETTINGS_FILE_FILTERIP_SETTINGS_FILE_FILTER defines the settings file filter and is defined as set by default. Organizer and the dialog interfaces use this filter to determine which filenames to display in the file selection dialog box.
IP_APPLY_ALL_SETTINGSBy default, InterPlot finds the first occurrence of a default or printer settings file and does not search any of the remaining directories in the settings file search path. You can change this behavior and search multiple levels of default and printer settings files.
The configuration variable IP_APPLY_ALL_SETTINGS allows you to set up multiple levels of default settings files. For example, some users may want to have company-wide default settings files that can be overridden on a per-user or per-site basis. To do this, you can set the configuration variable IP_APPLY_ALL_SETTINGS to true. When this configuration variable is set to true, all of the default settings files found in the search path are read and applied. The default value for this configuration variable is false.
Product TechNotes and FAQs
ProjectWise TechNotes And FAQs
Bentley Technical Support KnowledgeBase
Bentley LEARN Server
Bentley's Technical Support Group requests that you please confine any comments you have on this Wiki entry to this "Comments or Corrections?" section. THANK YOU!