UniPlot’s Use of the Windows Registry¶
The following article is intended for UniPlot 3.4.x and above.
Registry Database¶
UnPlot saves settings like the recently used files list or the setup of the
toolbars in the Windows registry under the key
HKEY_CURRENT_USER\Software\RSB\UniPlot5
. In UniPlot Version 3 and 4 the key
HKEY_CURRENT_USER\Software\RSB\UniPlot
was used.
The registry can be edited using the Windows program (regedit.exe).
If the environment variable UNIPLOT_INI=filename
is set or UniPlot is started
with the command option /IniFileName filename
it will not use the windows
registry. Instead all settings are saved in a text file. The environment variable
UNIPLOT_INI=filename
can be set in the Control Panel (Example Windows XP:
System=>Advanced=>Environment Variables). If the command switch user
is
specified in the command line the user-name is added to the filename. See
Using a different Base Key.
The following command line will use the ini file d:\uniplot-Peter.ini
c:\program files\uniplot\program\uniplot.exe /user "Peter" /IniFileName "d:\uniplot"
Examples:
Key | Type | Default Value | Description |
---|---|---|---|
Menu/FormulaConfiguration | DWORD | 1 | 0:Display menu. |
Menu/ViewAddInManager | DWORD | 1 | 0:Display menu. |
Menu/CustomizeUserToolbar | DWORD | 1 | 0:Display menu. |
Settings/AddNCExtension | String | 1 | Data-Import: 1:Add the source file name extension to the NC file name. |
Settings/AddNCExcelSheetName | Number | 1 | Data-Import: 1:Add the sheet name of Excel files to the NC file name. |
Settings/StartUp | DWORD | 1 | 0: Do not display UniPlot splash screen. |
Settings/Combo1ExtraWidth | Number | 0 | Extra width for the toolbar combobox 1 (Recent NC file list)in pixel (0..400). Needs a restart. |
Settings/Combo2ExtraWidth | Number | 0 | Extra width for the toolbar combobox 2 (Dataset Style List) in pixel (0..400). Needs a restart. |
Settings/User-Home-Directory | String | “” | Path of the local directory with user specific settings. |
Settings/NEW-Command-Template-File | String | “” | Template for the File=>New command. |
Settings/Global-Options-File | String | “” | Complete file name of the uniplot.inb file. The file contains the
settings of the Tools=>Options command. |
Settings/EditXYDatasetCoordinates | DWORD | 1 | 0:Setting if the editing of XY dataset coordinates is enabled. |
Settings/standard-netcdf-files | Number | 0 | See Overview UniPlot Data Files. |
Settings/XYZOutsideValue | String | None | See File=>More File Functions=>Save 3D Data Matrix |
Settings/nRecentFiles | Number | 12 | Number of recent files in the file menu (8 - 16). |
Settings/simple-scrolling | Number | 0 | If 1 the document window is updated after the scrolling is finished. |
Settings/missing_string | String | ****** | String to mark missing values. Is used when data is copied to clipboard in the data editor. |
Settings/MDF_StripDeviceName | Number | 0 | Flag for MDF import. For example INCA/VS100. If the flag has the value 1, the channel name in MDF files is cut at the first backslash. Normally the channel and device names are separated by a backslash. Default Value is 0. Example: G3_InjCrv_phiMI1Des_ETKC_1 (Name with device name ETKC), G3_InjCrv_phiMI1Des (Name without the device name). |
Settings/MDF_StripGroupName | Number | 0 | Flag for MDF import. For example INCA/VS100. If the flag has the value 1,
the channel name in MDF files does not contain the groupname, e.g. G1_ .
Default Value is 0. Example: G3_InjCrv_phiMI1Des_ETKC_1 (Name with group
number), InjCrv_phiMI1Des (Name without group number). |
Settings/autoscale-add-extra-space | Number | 0 | If set to 1, extra space is added, so that the data does not start or end on the diagram borders. If set to 0, the data may start or end on the diagram border. |
Settings/data-symbol-clipping | Number | 0 | If set to 0, the data point symbols of a 2D dataset will not be clipped at the diagram border. If set to 1, the symbols will be clipped at the border. |
Settings/ReportMenuName | String | Report | Set the menu name of the Report menu See auto_AddToUI. |
Settings/LabelDataPoint_Count | Number | 50 | Sets the maximum number of labels for the field function @f{labeldatapoint}. |
Settings/editor-window-font-name | String | “Courier New” | Sets the font for the program editor. Only monospaced Fonts can be used. (Courier New, consolas etc.) |
Settings/editor-window-font-size | Number | 10 | Font size for the program editor. |
Settings/command-window-font-name | String | “Courier New” | Sets the font for the command windows. Only monospaced Fonts can be used. (Courier New, consolas etc.) |
Settings/command-window-font-size | Number | 14 | Font size for the command window. |
Settings/UTX_Split_Name_Unit | Number | 1 | If the channelname contains in unit in square brackets, the unit is
removed from the channel name and stored as the unit. Example: Speed
[1/min] is split into channel name Speed and unit rpm. If the key is set
to 0, the channel name is Speed_1_min_ . Applies to UTX Files, Excel
Files, Text Files. |
Setings/browser-load-startup | Number | 1 | Reload last open netCDF file into the data browser during start up of UniPlot (0/1). |
Settings/nc-allow-special-chars | Number | 0 | |
GRID_OPTIONS/ExtraTitle | String | units | _none_ |
Settings/ipz-pack-on-close | Number | 1 | Specifies, if an IPZ file is packed after the file has been closed. See DocDestroy. |
settings/”, “nc_use_groups” | Number | 0 | Enable/Disable the display of the tree structure in the data browser. To control the display in a program: _g().nc_use_groups = 1
_g().nc_use_groups = 0
|
settings/legend-symbol-length | String | “1.2” | Legend line symbol length in cm. |
The keys can be set and get using GetProfileString, GetProfileInt, WriteProfileString and WriteProfileInt.
Example:
Type the following commands into the command window.
WriteProfileString("Settings", "editor-window-font-name", "consolas");
WriteProfileInt("Settings", "editor-window-font-size", 12);
Using a different Base Key¶
If UniPlot is started with the following command
uniplot.exe /user "Peter"
UniPlot is using a different Key. Instead of
HKEY_CURRENT_USER\Software\RSB\UniPlot
it will use the key
HKEY_CURRENT_USER\Software\RSB\UniPlot-Users\"user-name"
The Name will be displayed in the UniPlot title bar.
System Policies¶
You can edit the registry using System Policy Editor (poledit.exe)
The keys are found in the registry under the base key
HKEY_CURRENT_USER\Software\Policies\RSB\UniPlot
The policy templates uniplot34.adm
is located in the uniplot\startup
directory.
It looks like this:
CLASS USER
CATEGORY "UniPlot Policies"
CATEGORY "Menu"
KEYNAME Software\Policies\RSB\UniPlot\Menu
POLICY "FormulaConfiguration"
KEYNAME "Software\Policies\RSB\UniPlot\Menu"
VALUENAME "FormulaConfiguration"ValueOn Numeric 1 ValueOff Numeric 0
END POLICY
POLICY "ViewAddInManager"
KEYNAME "Software\Policies\RSB\UniPlot\Menu"
VALUENAME "ViewAddInManager"ValueOn Numeric 1 ValueOff Numeric 0
END POLICY
POLICY "CustomizeUserToolbar"
KEYNAME "Software\Policies\RSB\UniPlot\Menu"
VALUENAME "CustomizeUserToolbar"ValueOn Numeric 1 ValueOff Numeric 0
END POLICY
END CATEGORY ; Menu
CATEGORY "Settings"
POLICY !!CPL_StartUp
KEYNAME "Software\Policies\RSB\UniPlot\Settings"
VALUENAME "StartUp"ValueOn Numeric 1 ValueOff Numeric 0
END POLICY
END CATEGORY ; Settings
CATEGORY "Formula"
POLICY !!CPL_ActivateFormulaCalculation
KEYNAME "Software\Policies\RSB\UniPlot\Formula"
VALUENAME "EnableFormulaEval"ValueOn Numeric 1 ValueOff Numeric 0
END POLICY
POLICY !!CPL_FormulaPath
KEYNAME "Software\Policies\RSB\UniPlot\Formula"
PART "Formula path" EDITTEXT
MAXLEN 1024
VALUENAME Path
END Part
END POLICY
END CATEGORY ; Formula
END CATEGORY ; Software\Policies\RSB\UniPlot\Menu
[strings]
CPL_StartUp="Display start-up screen"
CPL_ActivateFormulaCalculation="Activate Formula Calculation"
CPL_FormulaPath="Formula Directory"
id-1238227