Vr Mapping |
ON-LINE REFERENCE DOCUMENTATION CARDINAL SYSTEMS, LLC |
Edit Toolbars (EdiToo)
Type: User Interface
Allows new toolbars to be created and defined.
Detailed Description
Toolbars are groups of command buttons that can be represented as icons or text, and may be used as stand-alone floating windows or may be docked with the VrOne Main and Graphics windows. A toolbar may be docked by dragging and dropping it onto any valid docking area. Docking areas are currently provided on the bottom of the Main window, and on the sides and bottom of all graphics windows. The toolbar definitions are stored in the \vr\hostdir directory in a file named vrone.vrt. The toolbar layout (locations) files is stored in the \vr\hostdir directory in a file named vrone.vrtoollayout.
NOTE: These files should be backup up when installing a new version of VrOne
Example:
Creating a Toolbar Containing Brightness and Contrast Controls
Edit Toolbars Dialog
This image displayed above is the Edit Toolbars dialog with six toolbars defined. The left side of the dialog displays the toolbars. The toolbar named “Files” is currently highlighted, and the right hand side of the dialog is displaying the command buttons that are assigned to the “Files” toolbar.
The image below shows the “Files” toolbar as a floating window (not docked). The Orientation on this toolbar is to Vertical, which only affects the toolbar when it is floating. Notice the use of the “SEPARATOR” item to place a line between the Close Img command button and the Plot command button.
The following image shows the “Files” toolbar docked in the VrOne main window.
Using the Edit Toolbars Dialog
Left Pane
The left hand pane displays a table of all currently defined toolbars. Whenever an item in the toolbar table is selected, the right hand pane displays the toolbar command buttons that are associated with the highlighted toolbar. Use the “Add” button to create new toolbars. Use the “Delete” button to delete the currently highlighted toolbar command button. The following items may be defined for each toolbar, and are edited by directly changing the items in the table.
Name |
This is the name of the toolbar. Each toolbar should have a unique name, which will be displayed in the window title if the toolbar is not docked. |
On |
Determines whether the toolbar is displayed or not. |
Orientation |
The toolbar orientation may be set to Horizontal or Vertical. This only affects the toolbar when it is not docked. |
Right Pane
The right hand pane displays a table of command buttons that are defined for the currently highlighted toolbar. Use the “Add” button to create new command buttons. Use the “Delete” button to delete the currently highlighted command button. Three special purpose buttons are provided to make it easy to add Separators, Brightness Controls, and Contrast controls. The following items may be defined for each command button, and are edited by directly changing the items in the table.
Name |
This is the name of the command button. Each command button should have a unique name, which will be displayed on the command button if the display mode is “Text” or “Both”. |
Display Mode |
This determines if the command button displays an Icon (image), Text, or both an Icon and Text. |
Command String |
This is the command string that is used when the command button is pressed. This may be any valid VrOne command input, such as a normal command, macro command, or function key name. |
Bitmap |
This is the image that is displayed if Icon or Both is selected for Display Mode. |
Creating a Toolbar Containing Brightness and Contrast Controls
The following steps may be used to create a Toolbar containing the brightness and contrast controls.
| 1. | Run Edit Toolbar (EdiToo) |
| 2. | Press the "Add" button on the left pane to create a new toolbar. Change the name from "New" to "Image" and press the Tab key. |
| 3. | Press the "Add Bright" button on the right pane. This should add a brightness slider to the toolbar. |
| 4. | Press the "Add Contrast" button on the right pane. This should add a contrast slider to the toolbar. |
| 5. | Close the Edit Toolbars dialog. |
| 6. | A floating toolbar containing the image controls is now displayed. Dragging this toolbar over the bottom portion of the graphics window and releasing it will “dock” the toolbar to the window. While dragging, the border changes to a thinner line when the toolbar is in a position to be docked. |
Parameter Files
Toolbar parameter information is stored in two files; the .vrt and the .vrtoollayout files which are in the \vr\hostdir folder. The program name precedes the file name. For example the toolbar parameters for the VrOne program is stored in \vr\hostdir\vrone.vrt and \vr\hostdir\vrone.vrtoollayout.