BAR -- Displays a grayscale bar on a frame containing an image BAR frame Parameters: frame | frame number (def=current) Keywords: COLor= | graphics color level for labels (def=3) GRA= | graphics frame to display labels (def=current if running McIDAS-X with independent graphics; otherwise def=number specified in 'frame' parameter) LINt= | label interval; value must be greater than zero (def=computed) LSIze= | height of labels, in pixels (def=computed) ORIent=VER | bar is displayed vertically (def) =HOR | bar is displayed horizontally POSition=CUR | draws bar that fills cursor at its current location =line ele short long | user-specified location and size, where: line - starting TV line (def=computed) ele - starting TV element (def=computed) short - length, in pixels, of the bar's short axis (def=computed) long - length, in pixels, of the bar's long axis (def=computed) RANge=min max | range of values to display in the bar (def=computed) SU= | name of the stretch table to apply to the grayscale bar (def=table specified in IMGDISP command) Remarks: The BAR command displays a grayscale bar and labels. The bar is written to the image so enhancements created with commands EU or EB appear on the bar. The labels are written as graphics, so the EG command erases the labels but leaves the bar. The 'frame' parameter specifies the frame to write the bar, and the GRA keyword specifies the frame to write the labels. The POSITION keyword determines the location of the bar. If you do not specify the keyword, the bar is drawn in a vertical orientation along the right side of the frame. If you specify the POS=line ele short long format, 'line' and 'ele' define the TV line and element of the upper-left corner of the bar, and 'short' and 'long' define the dimensions of the bar. If using ORIENT=VER, 'short' is the horizontal length and 'long' is the vertical length. If using ORIENT=HOR, 'short' is the vertical length and 'long' is the horizontal length. If the image was displayed with a stretch table (i.e., IMGDISP with SU keyword), the SU and RANGE keywords are ignored. If the image has an auxiliary block (e.g., NIDS radar images), the RANGE keyword is ignored and the LINT keyword is valid only if the image was displayed with a stretch table. The following three rules determine the units of the labels: 1. If the image was displayed with a stretch table, the label units are the same as the calibration units of the stretch table. 2. If the image has an auxiliary block and was not displayed with a stretch table, the label units are the same as the units in the auxiliary block. 3. If the image was not displayed with a stretch table and does not have an auxiliary block, the units are the same as the calibration units of the stretch table specified in the BAR command's SU keyword. If SU is not specified, the units are brightness values. ----------