[Next] [Previous] [Up] [Top] [Contents] [Index] |
Chapter 9 DM: Run-time Operation
You may, however, want to place the path to a version of DM in your UNIX start-up files. You will find the latest version of DM in the
%set path = (/usr/epics/epics/extensions/bin/sun4 $path)Whatever the case, if you are uncertain about different versions of DM and how to set your paths to the correct version, ask your system administrator for assistance.
The EPICS_DISPLAY_PATH variable specifies where DM searches for the start-up display and related display files, and imported images. The start-up display is the display that you specify on the command line when you start DM. There are two types of related displays: color template files and displays whose files are invoked by a related display callup object. Chapter 3, Working With Templates And Color Rules, explains color templates, what they are, how to use them, and what they are useful for, so they will not be discussed at length here. It will suffice to say that a display references a color template file in the 'external color palette display name' in its Display Attribute window.
Displays can be referenced by their path names, so they do not need to be in your EPICS display path. Still, life is made easier if files can be referenced by their simple pathnames. In the EPICS_DISPLAY_PATH variable you can specify a list of directories that EDD will search for files when they cannot be found in the current directory. Usually, you will only want to specify relative UNIX pathnames and/or use the directory abbreviations understood by the UNIX shells, such as the '.' for the current directory, the '~' for a home directory, or '. .' for the directory containing the current directory. Remember that you usually will be running DM from an EPICS application directory and that display files are often placed in a display file directory,
%setenv EPICS_DISPLAY_PATH ".:./dl:..:"The directory list is enclosed in quotes and the directories are separated by a colon. This environment variable causes DM to search in the current directory ('.'), the display list directory in the current directory ('./dl'), and the directory that contains the current directory ('..').
You may want to set your PSPRINTER environment variable if you are going to print displays. The PSPRINTER variable specifies the name of the PostScript printer in your system. DM can print displays only on PostScript printers. As of version 2.3, you can also choose your printer by choosing the Select Printer option under the Options submenu of the DM window. The DM window is the window that appears whenever DM is run.
In versions of DM prior to 2.2, when a user entered a new value in a text-entry object, the value was sent when the object was no longer selected. When the value was sent, but for some reason the value of the channel was not changed, the object displayed was the value as entered, not the current value of the channel. As of version 2.2, the default behavior of the text-entry object has changed. Now, the user must press Enter or Return in order to send the value to the channel. When the object is no longer highlighted, the displayed value reflects the current value of the channel, which may be the value last entered or another value if the value could not be changed or Return/Enter was not pressed.
By setting the default
Dm.teTimeout: 1.0where 1.0 can be any non-zero value.
The second X default you can change is
Dm.teUpdate: TrueIf this default is set to
In addition, as of version 2.4, DM can size displays proportionally, taking into account the ratio between the pixel size of the display and the resolution of the monitor, instead of just the display's pixel size. In addition, as of version 2.4, DM can resize the objects within a display when the display is resized. To add these capabilities, set
Under the Options menu is the Select Printer option with which you can bring up the dialog box shown below. In this box, you can select the printer to which an image dump of the current display will be sent when a user selects Print from the display manager menu or left-clicks on a print display button. However, if
Select Printer Dialog Box.
It is often desirable to use an object in a display to connect to a different channel each time the display is opened. To use an object or all the objects in a display to connect to a variety of channels, instead of reconfiguring the display by going into each object's property sheet and changing the name of the channel, a display can be configured to have macro substitution string in place of a channel name or part of a channel name. You can then replace the macro with an actual name or name component when you open the display. Actually, the macro replacement string will replace every instance of the substitution variable, not just in channel names--in the titles of menus, in the text string of a text object, etc.
When you start DM with a display that uses macros, you can replace the macro on the command line. Before version 2.4, a display could only have up to eight macro replacement strings. As of version 2.4, the number of macros aren't limited, though each must be unique.
As an example of macro replacement, if a display called
dm process2.dl chan1=analog_out,chan2=binary_in,chan3=steppermotor3You can see from this command line that when you replace more than one macro, you must separate them by commas, but you must not use any spaces between the commas and the replacement string that follows it. There is no space separating the comma from
As of 2.3, you can open more displays by using the Open Display option in the File menu. Remember that macros cannot be expanded for a display when you open displays this way, only from the command line. If you need to open another display and expand the macros in it, you will have to do it from the command line, starting another DM process. The recommended method, however, is to use related display callup objects to open other displays as these objects can be configured to expand macros in a display when the display is chosen from their menus. Note that related display objects are configured in EDD to open the specified displays with the specified macro expansions. You cannot choose just any display, but only the ones in the object's menu.
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