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 enviroment 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 enviroment variable UNIPLOT_INI=filename can be set in the Control Panel (Example Windows XP: System=>Advanced=>Enviroment 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 netCDF 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 programm 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_

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