[Next] [Previous] [Up] [Top] [Contents] [Index] |
Chapter 2 Basic Operations
2. The Display Operations Area
When you start EDD without a filename, it should bring up an empty display window that looks similar to Figure 2-1. Towards the top of the window, you will see the full pathname of the directory from which you started EDD or of the directory that contains the current display file. Underneath the pathname is the name of the file you are working on. In the case of figure 2-1, EDD was started from the directory
Notice the rectangular outline in the window. The area within the outline is known as the drawing area and the area outside the outline is the display operations area. It is important to recognize the distinction between these two areas and keep track of which area the mouse's pointer is in. Any operations you perform within the display operations area are "global" for the display and everything in it--operations in this area affect the entire display file. In this area you can perform operations that specify certain characteristics that the display itself and all objects within the display file shall inherit (these characteristics can be overridden for specific objects; see Chapter 4), but you cannot create or edit objects from this area. The drawing area is where you create objects and perform all operations specific to certain objects.
The rest of this chapter covers the operations in the display operations area.
When you move the mouse's pointer over an option, a box appears around it. This means that the option is highlighted. In Figure 2-2, for example, the load display option is highlighted. If you release the mouse while the option is highlighted, EDD will either perform the operation that the option indicates or prompt you for more information that it needs to perform an operation (such as the file you want to load if you select the load display option).
Notice the triangular marker to the right of the modify display option. The marker indicates that the option contains a submenu. If you highlight the modify display option and move the pointer towards the right, a submenu appears, slightly overlapping the main menu. It contains three options: attributes, color table, and color rules. If you move the pointer over the color table option so that it is highlighted and then release the mouse button, a window will appear entitled Color Map Modify. If you move the pointer over things within the window, they are highlighted as in the display menu. If you move the pointer over the quit button at the bottom of the window and click the left mouse button, the window will disappear. You have just performed the basic operations in EDD. In addition, the following two sections describe how to enter text in text-entry fields and how to use sliders.
To enter text in a text-entry box, simply type in the text. When you do so, the text will have a "faded" look. If you move the pointer out of the box, the text you just entered will disappear. To enter text so that it does not disappear when you de-select the box, you must press the Return or Enter key after you have entered the text. After you do this, the text is no longer "faded".
A similar thing occurs when you delete text that has been entered in the field. If you delete a word, for instance, and then move the pointer out of the field, the original word will appear again. It will not be deleted until you press Enter/Return.
Edd.teTimeout 1.0When the
This capability was made mostly for DM, and because DM and EDD use common operations, it appears in EDD. It was implemented because users wanted the current value of text-entry objects at run-time to reflect the current value of the channel. In addition, users wanted data to be sent to channels only when they had pressed return. Hence, the value is not really entered in a text-entry box or a text-entry controller object unless the Return/Enter key is pressed. This behavior was implemented as of version 2.2, and does not appear in previous versions.
Another capability that is useful when entering text is the text-entry menu. All text-entry fields have a menu with options (except for the load display dialog box) that will aid you when entering text, though it isn't necessary to utilize the options within this menu.
After you've highlighted a text-entry line, if you hold down the right mouse button you will bring up a menu like the one in Figure 2-3.
The menu contains standard text-editing commands like clear, cut, copy, and paste:
The other options in the text-entry menu are not so obvious or standard, but are easy to understand and use:
To change a slider's value:
When you drag the mouse either right or left to increase or decrease the slider's value, the value changes in increments or decrements. The coarse, medium, fine, and xfine options determine the gain of the slider, the number of the increment or decrement. The coarse setting of the gain increments or decrements the value by 5%; the medium setting, by 0.5%; the fine setting, by 0.05%; and the xfine setting, by 0.005%. With these options, you can change the value by varying degrees of exactness. However, the slider cannot display decimals or fractions, so if you change the horizontal setting to 327.5, for instance, the window will change accordingly but the value will only display 327. By default, the slider is set to coarse.
Choosing the keyboard option allows you to set the slider's value manually by entering in the numbers from the keyboard. To use this option, choose keyboard from the slider menu, which will bring up a Keyboard Entry window. This window has an entry line in which you can enter the value, which must be within the slider's range of possible values.
Invoking the increment and decrement options increases or decreases the value by the increment or decrement setting.
Invoking setup brings up a Valuator Setup window (Figure 2-5) that has three choice buttons and one text-entry line. The choice button for Gain allows you to set the gain to the four settings discussed above. The Custom Increment/Decrement choice button allows you to enable or disable an increment/decrement number. If you left-click enable on the choice button, invoking the increment option, for instance, increments the value according to the Custom Increment/Decrement Value. This value is set on the Custom Increment/Decrement Value text-entry line. You simply enter in the number of the desired increment or decrement.
The Pointer Update Mode choice button lets you change the manner in which EDD will update the display according to the changes you have made. If you choose motion, EDD will update the display as you change the value in the slider. If you choose release, EDD updates the display according to the changes only after you have released the mouse button. For instance, in the case of the horizontal and vertical size attributes, as you change the slider's value, the window will grow or shrink as you change the value if the Pointer Update Mode is set to motion. If it is set to release, the window will take on its new size after you have released the mouse button. By default, the Pointer Update Mode is set to motion on every slider.
The slider menu is found on every slider in all operations windows. It is also identical to the menu for the valuator control object. The Valuator Setup window and the slider menu were, in fact, designed for valuators, which is why the window is called what it is.
Most of the options in the Display menu perform basic file operations. Save display, for instance, saves the display you are working on in a file under the name that you give it. Copy display copies the file you are working on into a file that you specify. What other options do, however, is not so obvious. The report display option, for instance, saves the file in an ASCII display file instead of a binary file. Even the obvious operations like load display and save display have some idiosyncrasies that you should know about. We'll start with the obvious file operations--load, save, copy, and quit--then move on to the not-so-obvious operations, activate display and report display. Finally, we will cover the modify display option, or rather, what the options in its submenu do.
When you invoke load display, you will bring up a window like the one in Figure 2-6. In the Directories box you can change the current directory from which to select the file, in the Files box you can choose which file to open in the current directory, and in the Selection box you can specify the file to open by name. In the Filter box you can specify a regular expression with the wildcard character (*), which will cause only files matching the expression to be displayed. For instance, if you want to display only files with the
*.dlthen, after you click the Filter button, only
EDD will load and display the file. If you are working on a display that you have made changes to and that you haven't saved, when you load a file, EDD will beep at you and bring up a dialog box to warn you that if you load the file you will discard all the changes you made to the file you are working on. If you want to save those changes, left-click the cancel button, bring up the display menu, and choose the save display option. If you want to discard the changes, left-click the execute button.
If EDD can't find the file it will display this error message in the display operations area:
Load file access problem. Context: [pathname of entry]Another problem may occur when you are loading a file that uses a template for its color table and its color rules. If EDD can't find the template file, it will load the display, but not all the colors the display is supposed to have. When this occurs EDD will display the following error message from the command line:
External clr map display file access problem [templatefilename] External clr rules display file access problem [templatefilename]To remedy the problem, you must locate the color template file that the display uses and place the directory that it is in, in your EPICS_DISPLAY_PATH variable (see section 1.2., Setting Your Environment Variables, to find out how to set this variable), or put the file in one of the directories that are listed in your EPICS_DISPLAY_PATH variable.
When the copy display option writes the file into another file, it saves the file with the new filename, and the display is re-opened with the new filename, so it basically becomes the new file.
Before you invoke activate display you should have some familiarity with DM (see Chapter 9, DM: Run-time Operation).The report display option saves or "reports" a copy of the current display into an ASCII display list file. The report display option works basically like the save display option: it brings up an operations window with text-entry fields in which you enter the directory and filename to which you want to save the file. The report display option automatically adds the file extension .
The main purpose of ASCII files is upward compatibility between EDD versions. EDD version 1.16 is incompatible with versions 2.0, 2.1, 2.2, 2.3, and 2.4. Versions 2.0 and 2.1 are compatible, however. Version 2.2 is incompatible with all other versions, as are versions 2.3 and 2.4. When versions are incompatible, you cannot load files created with one version using another version. For example, if you try to load a file from version 1.16 into EDD 2.1, you will get the following message:
Binary display file version, 1.16, does not match this program's display list version: 2.1There are several scripts currently available that convert ASCII display files of one version to files compatible with another--they convert all the ASCII display list files in the directory in which the converter is run and place the new, converted files in a temporary directory, or will place the old files in a temporary directory. For example, the script
All conversion scripts should be located in the
EDD/DM User's Manual, 2.4 - 27 MARCH 1997 [Next] [Previous] [Up] [Top] [Contents] [Index]
L O S A L A M O S N A T I O N A L
L A B O R A T O R Y