SilverScreen Solid Modeler

V-EDIT command

V-EDIT command

Previous topic Next topic  

V-EDIT command

Previous topic Next topic JavaScript is required for the print function  

SilverScreenAPI

 

V-EDIT

 

 

 


What V-EDIT does
 

The VARIABLE V-EDIT command is a means for creating tab dialogues where large numbers of variables can be edited. The V-EDIT command is a close cousin to the panel menu family of functions (that is, pm_execute). Here are the capabilities of V -EDIT:

r_point

V-EDIT uses only system variables (rather than standard C variables).

r_point

At the start of an editing session, V-EDIT can retrieve initial values from a .VAR file.

r_point

At the conclusion of the editing session, V-EDIT can store the edited values in a .VAR file.

r_point

V-EDIT will permit an unlimited number of variables to be edited in the same session.

r_point

The values of the system variables stored in the .VAR file can later be loaded by the VARIABLE LOAD command.

 


V-EDIT File
 

V-EDIT is particularly useful in establishing a set of system parameters that are to be used during execution.

The appearance and contents of the are specified in a V-EDIT source file. A V-EDIT file is shown below:

Sample V-EDIT File

 

 title = "Sample V-EDIT file"

 input = "sample1"

 output = "sample1"

 * ""

 * "!0Editing of variables"

 * ""

 m $var1        "Variable 1"        "one"        "two"        "three"

 n $var2        "Variable 2"        "one"        "two"        "three"

 t $var3        "Variable 3"        "hello"

 f $var4        "Variable 4"        1.23

 i $var5        "Variable 5"        6

 * ""

 

 

title specifies text that is to appear at the top of the screen during editing. input specifies the .VAR file that is to be used to initialize system variables. output specifies the .VAR file to which the system variables are to be written when the editing session concludes. Both input and output are optional.

 

Starting on line 4, there is a line by line specification of the items that are to appear in the menu. The first character in each line identifies the type of information that is contained on the line.

 


Formatting the V-EDIT File

Below is a description of the first-character meanings:

 

Character

Meaning

*!0

indicates the beginning of a tab section of the tab dialogue. Text from this line will be used in the tab.

*

indicates that the line contains descriptive text.

m

indicates that the line contains a selection of items, one of which is to be selected by the user.

n

also indicates a selection of items, one of which is to be chosen by the user

t

indicates that the user may enter text.

f

indicates that the user may enter a real number.

i

indicates hat the user may enter an integer.

 

 


Except for the line containing descriptive text, each line is associated with a system variable. The variable name appears immediately after the line code. The line code determines variable type and the value that will be assigned at the conclusion of the editing session:

 

Character

Meaning

m

the variable is a text variable; it will be assigned the string corresponding to the selected item.

n

the variable is a value variable; it will be assigned the ordinal number corresponding to the selected item

t

the variable is a text variable; it will be assigned the string that appears on the line.

f

the variable is a value variable; it will be assigned the value that appears on the line.

i

the variable is a value variable; it will be assigned the value that appears on the line.

 

Following the variable name is a string of display text. For menu lines, the last entry is the set of menu items. Initial values appear on the remaining lines.

 

Further information about the V-EDIT command can be found in the SilverScreen Reference Manual.