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