VDisplayScale
Name
VDisplayScale - displays a multi-resolution scale in the dialog window.
Synopsis
VDisplayScale(value,label)
float value;
char *label;
Description
VDisplayScale displays a multi-resolution scale in the dialog window.
VDisplayScale checks if the dialog window is in front of the image window; if
it is, VDisplayScale displays the scale at the lowest resolution (default)
with the specified related values like min, max, width, and the x, y location.
This value is set by calling VSetScaleInformation. If the dialog window is not
in front of the image window, VDisplayScale stores the scale in a pixmap.
Return Value
0 - work successfully.
1 - memory allocation error.
217 - cannot display the scale when panel is on in the panel area.
243 - scale is out of the dialog window boundary.
244 - scale does not exist.
246 - scale width is greater than the available width of the dialog window.
247 - scale width is too small to satisfy the minimum requirement.
249 - scale is already on.
258 - pixmap is NULL and image window is in front of the dialog window.
Parameters
value - the default value to be shown on the scale; it must be between the
min and max values of the scale.
label - the name of the multi-resolution scale.
Side Effects
None.
Entry Conditions
VSetScaleInformation should be called first. If value is out of range or
label is NULL or VCreateColormap not called earlier, VDisplayScale prints an
error message to the standard error stream, produces a core dump file and
exits from the current process.
Related Functions
VSelectScaleValue,
VEraseScale,
VGetScaleInformation,
VSetScaleInformation,
VGetScaleLayoutInformation,
VCheckScaleEvents.