dtdisplay on-line help

Edit Image View Properties

In the Edit menu, choose Image View Props... to display a dialog box with the current image view properties. The view properties include Integration box size, Saturated pixel cutoff, Saturated pixel color, White pixel in image, Black pixel in image, Image border fraction, Orientation, Preserve aspect ratio, Pixel aspect ratio, and Auto rescale. The values set in this dialog do not take effect until either the OK or Apply button is selected. Also, if no image is currently displayed, then settings made in this dialog box have no effect. Selecting Help activates the HTML viewer for on-line help.

The dialog box has two halves -- a left one and a right one. To view the full dialog box, select the small arrow button below and to the right of the Image border fraction. To return to view to the left half, select the arrow button again.

Image view properties dialog.

Static image properties
Image size
The number of pixels in the fast and slow directions in the image.
Min, max
These are the minimum and maximum pixel values in the the image exluding a border of 10% around all 4 sides.
Average, sd
These are the pixel value average and standard deviation calculated from the image excluding a border of 10% around all 4 sides.
Rot start
This is the relative rotation angle start from the image header
Rot end
This is the relative rotation angle end from the image header
Exposure time
This is the image exposure time in seconds from the image header
Adjustable image properties
Integration box size
Enter the integrate box size in pixels in the FAST and SLOW image directions separated by a comma (,). When a pixel is selected in the image display area, then the pixels in an area Ix by Iy are integrated. First an average and standard deviation is computed, then after excluding pixels with a value 3sigma above that average a new average and standard deviation is computed. Then all the pixels in the area are summed and the average pixel value times the number of pixels is subtracted. This gives a rough estimate of the integrated intensity of a picked Bragg reflection. If the non-uniformity information is available, then the area is corrected for non-uniformity first. If the Integrate box size is less than 2 x 2, then a default value of 24 x 24 is used. No effort is made to exclude neighboring spots from the integrate box when the calculations are made. Resource file default: *cUIimageviewprops*tfBoxSize.value: 25, 25
Saturated pixel cutoff
Enter the minimum value of a saturated pixel. All pixel values that are greater than or equal to this value will be displayed in the selected Saturated pixel color. Resource file default: *cUIimageviewprops*tfSatValue.value: 65535.0
Saturated Pixel Color
Select the color used to display saturated pixels from the combo box. A limited number of colors is available. Resource file default: *cUIimageviewprops*omColor*labelString: Red
White pixel in image (Minimum scale value)
Pixel values below this threshold are all set to white. This value may also be changed through the color scale below the image.
Black pixel in image (Maximum scale value)
Pixel values above this threshold are all set to black. This value may also be changed through the color scale below the image.
NOTE on color scale mapping:
If the White pixel value is more than the Black pixel value, then the color scaling is reversed. Thus, if these values are 10 and 5000, then the color mapping runs from white (low) to black (high). If these values are 5000 and 10, then the color mapping runs from white (high) to black (low) which reverses the color mapping. The starting values for the white and black thresholds are set automatically whenever a image is read in with the Open command in the File menu. The average and standard deviation of all pixels except a border of 10% along the four edges is calculated. The white threshold is set to the average - 1.5 * standard deviation. The black threshold is set to the average + 5.0 * standard deviation.
Image border fraction
If this is less than 1, a border is reserved on the right and bottom sides of the image display area for drawing line profiles. A value of 0.9 results in the image area occupying 90% of the drawing area with the line profiles occupying strips of 10% on the right and bottom sides. Resource file default: *cUIimageviewprops*tfBorder.value: 0.9
Orientation
A combo box is used to select one of eight possible orientations for the image display. The choices show how the image FAST and SLOW pixel directions should be mapped to the X Window coordinate system X and Y. X runs across the display while Y runs down the display. Do not confuse the X Window display XY coordinates with the laboratory XY coordinates. The selected orientation is applied only after selecting the OK or Apply button. Resource file default: *cUIimageviewprops*omOrient*labelString: +X +Y
Preserve aspect ratio
Select whether the Pixel Aspect Ratio will be preserved when displaying images. This is useful when you want to preserve the image aspect ratio when you resize the image display area.
Pixel aspect ratio
Enter the pixel size aspect ratio. The ratio is the size of the pixel in the FAST direction divided by the size of the pixel in the SLOW direction: FAST / SLOW. For example, if the detector pixels are 1.28 mm by 2.00 mm, then enter 0.64 for the aspect ratio.
Auto rescale
Set this to Yes, if you want the View menu Refresh button to automatically adjust the contrast of the displayed portion of the image. Set this to No, if you do not want the contrast automatically adjusted when the Refresh button is activated.
Reserved
This is reserved for future use and has no effect now.