Back to:
The parameter editor unit PrmEdit takes care of all loading, saving and editing of program setup parameters for all LEA programs. As well as editing and creating parameter files it can also dump parameter files in a readable form to a text file or to the printer.PrmEdit reads parameter file layout from program INI files. PrmEdit can be run in standalone mode to edit or create parameter files for a specific application as the program SETPARMW
SETPARMW is the standalone mode of PrmEdit which allows you to edit LEA program parameters independently of the individual program. You can run SETPARMW from the Lynx Launcher or from the command-line.
SETPARMW accepts a command line similar to the following:
SETPARMW [-pPROGNAME] [PARAMFILE]
If no parameter file is specified or program is specified (as when SETPARMW is run from the Launcher), a dialogue box will be displayed listing all available LEA programs for which you can edit parameters. Select a program from the list, and the default parameter values are displayed in the editor.
PARAMFILE is the file path of an LEA parameter file. SETPARMW will open the file to determine which LEA program the parameter file belongs to, and then open the parameter file to allow you to edit the parameters, save as a new file, or create new parameter files of the same type.
PROGNAME specifies the type of parameter file to open. If PROGNAME and PARAMFILE are both specified, then SETPARMW will force PARAMFILE to be opened as a PROGNAME parameter file. If no PARAMFILE is specified, then the default parameters will be displayed.
Select
Displays a sub-menu
containing a list of the available parameter pages to edit. Select a page from
the list to display it directly without using the Back
and Forward menu options.
Back
Return to the previous parameter page. If any of the parameter
edit fields on the current page contain illegal values, you will be prompted to
change that value before displaying another page.
Forward
Move to the next parameter page. If any of the parameter edit
fields on the current page contain illegal values, you will be prompted to
change that value before displaying another page.
Save Page
Save changes to all parameters on the
current page.
When PrmEdit is being run as part of another
application, this will allow that application to see the changes to parameter
values you have made.
Restore Page
Defaults
Restore the default values for all parameters on the current
page.
Context Help
Displays context help for the most
recently active control in the PrmEdit window.
If the most recently
active control is a parameter editing control, help for that parameter will be
displayed, or if it is a menu or toolbar button, then help from this file will
be displayed.
Parameter Page Help
Displays help for the current parameter page (from
the parameter application help file).
Parameter Editor Help
Displays this help
file.
When you exit the parameter editor or open a new file, if you have modified the displayed parameters, you are asked whether you wish to save the changed parameters as a new parameter file.
If no default parameter file exists in the current directory, you will be prompted to create one on exiting the parameter editor or saving the parameters.
Listed below are the error messages that may be generated by PrmEdit.
Every parameter page has a corresponding section in the program's INI file, in the form [page.n], followed by the page's name and title. The required section could not be found in the program's .INI file This error may happen prior to parameter loading, saving or editing when the program tries to use a parameter page section which is incorrectly named, corrupted or non-existent
The parameter editor was invoked but no program was specified on the command line. Check the command syntax if calling the parameter editor directly
A syntax error was found in the command line invoking the parameter editor. This should be in the standard form
SETPARMW -pPROGNAME (see Running SETPARMW)
The program INI file contains an error which means that the program may not behave correctly. Contact Lynx. The INI file contains a syntax error in "showif" ident in a parameter page. In the program's INI file, the information which determines whether a parameter page should be displayed, or not, is incorrect. To correct the problem the appropriate [page] section of program's INI file must be edited.
The specified file was not recognised as a proper Lynx parameter file. The file may have become corrupted, or may be the wrong file. Check the file by looking at in a text editor, e.g. NotePad. See documentation on parameter page definitions.
The specified file may have become corrupted, or it may be a file that belongs to a non-Lynx application, which has been created with the extension that PrmEdit expects to use for parameter files. The specified file was not recognised as a proper Lynx parameter file. Check the file by looking at in a text editor, e.g. NotePad. See documentation on parameter page definitions.
The number you entered was outside the allowed range for this parameter. The limits for this parameter will be displayed in a box on the parameter editor screen.
The parameter file had no version number in the [lynx] section. The parameter file's version number should appear in the form
version=Vx.yz
X, y and z are digits such that the version number matches the version number of the program that uses it, or falls within the range allowed by the INI file version number. When the parameter file's version number is missing, the file is probably seriously corrupted.
The parameter file's version number mismatches the allowed version range string in the program INI file. You are probably trying to use a parameter file from an earlier (or later) version of a program, whose internal variables do not match this parameter file. You have 2 alternatives:
- Generate a new parameter file.
- If the parameters are difficult to reproduce, print the parameter file and manually compare each page with the corresponding page in the program's current setup. You can then either enter the parameters manually, or (riskily) edit the old parameter file in a text editor so that the parameters match the new setup and change the version number in the edited file to match the program.
Both these errors could mean that you may have a number of conflicting versions of program INI files installed on your system.
The parameter page section in the application INI file is badly constructed or does not exist in the current language.
See also: