Modification Controls

In order to facilitate the manipulation of numerical and text values, the Property View has been implemented with the following Modification Controls:

• Edit Box for writing text.
• Combo Box and Extented Combo Box to choose a value from a list or pick an object with the mouse.
• Type Box to edit a variant.
• Edit… Button to edit a VariantsSet (i.e. a table of couples ID-Variant).
• Check Box for type Boolean values (true/false).
• Spinner Box to edit numerical values that do not lie within a particular range.
• Slider Box to edit numerical values that lie within a defined range.
• Color Box for color values.

Property View controls can also be found in other views such as the Preferences Dialog or the Material Editor.
Modification controls facilitate the edition of numerical and text values with the mouse. You can still enter the desired value using the keyboard:
• spacebar for boolean check-boxes;
• letters for text fields;
• numbers for numerical fields (if a range is specified, only numbers within the range are accepted).

Using the Edit Box:

• Click on the Edit Box contents to enter edit mode.
• Type in the intended text as you would do in any regular text editor.
• Press ENTER when you are done typing or ESC to revert to the original text.

Using the Combo Box:

• Click on the downwards arrow button on the left of the combo-box to access a list of values.
• Select one from the list to assign it as the new value.
• To navigate the items listed in the combo-box use SHIFT + arrow keys.

Using the Extended Combo Box:

• Click on the downwards arrow button on the left of the combo-box to access a list of values.
• Alternatively, click on the “Pick” button to be able to pick an object which is not on the list,
  then click on the intended object in the 3D View or in the Project Editor to pick it.
• A pop up window will display useful information on the object under the mouse cursor.
  Use the middle mouse button to scroll the view, if necessary.

• Left-mouse click to pick the object or press ESC to cancel the pick.
• To navigate the items listed in the combo-box use SHIFT + arrow keys.

Using the Type Box (vkVariantTypeCtrl):

• Click on T: a default type is inserted in the box.
• Click on the downwards arrow button on the left of the inserted type to access a list of values:

• When a type is selected, you can click in the box to edit the value with the keyboard as needed:

Using the Edit… Button (vkVariantSetTypeCtrl):

The following dialog pops up :

To add IDs:

• Double-click “Add item”:

• Enter a name in the editable box

Or:

• Click “Add item”.
• Use the Ctrl+N keyboard shortcut:

• Enter a name in the editable box.

Or:

• Right-click anywhere in the dialog:

• Select “Add item”.
• Enter a name in the editable box.

The contextual menu also lets you:

• Edit IDs by selecting “Edit item” or by pressinf the F2 key).
• Delete a selected ID by selecting “Delete item” (or by pressing Delete or the Backspace key on the beyboard).
• Clear the whole list of IDs by selecting “Clear all”.

Using the Check Box:

• Checked boxes represent true values:
  • To change the value to false, click on the checked box.
  • This action will uncheck the box, changing the value to false.
• Unchecked boxes represent false values:
  • To change the value to true, click on the unchecked box.
  • This action will check the box, changing the value to true.
• Use SPACE BAR to check/uncheck a check-box.

Using the Spinner Box:

• To change the value with the keyboard:
  • Click on the value field to change to edit mode.
  • Enter the desired numerical value.

• To change the value with the mouse:
  • Click on the handle to the left of the spinner box and hold your click.
  • While holding the left mouse button down, drag the mouse to the right to increase the value or to the left to decrease it.

Using the Slider Box:

• To change the value with the keyboard:
  • Click on the value field to change to edit mode.
  • Enter the desired numerical value.
    Allowed values will depend on the defined range.

• To change the value with the mouse:
  • Click on the handle to the left of the slider box.
    A slider shows up.
  • Drag the thumb to the right to increase the value or to the left to decrease it.

Using the Color Box:

• To change the color with the keyboard:
  • Click on the red (“R”), green (“G”), blue (“B”) and alpha (“A”) values.
  • Enter the desired numerical value.
    A preview of the color defined by these numerical values will be displayed in the left colored box.
    Allowed values will depend on the range defined by the intrinsic type of color (integer based or float based).
• To change the color with the mouse:
  • Click on the left colored box.
    The color palette pops up: the region defined by the white circle corresponds to the current color value.

  

  • Click and drag the circle. Moving the circle will change the color value.
  • Press “Ok” when you are done.