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.