Displays or prints images at the current or specified size and device resolution.
TVSIZE, image [, position]
A 2D array containing the image data.x, y
(optional) The lower-left position of the displayed image.channel
(optional) The memory channel to be written. If not specified, it is assumed to be zero. This parameter is ignored on display systems that have only one memory channel.position
(optional) A number specifying the position of the image. Positions run from the left of the window to the right, and from the top of the window to the bottom.
Specifies that the image intensity values are to be scaled (as with the TVSCL procedure). The value specified is the lower bound of the intensity values. Centimeters
If present and non-zero, specifies that the XSize and YSize keyword parameters are in centimeters. This is the default.Channel
The memory channel to be written. This keyword is identical to the channel input parameter; only one needs to be used.Data
If present and non-zero, specifies the (x, y) position parameters are in data coordinates.Device
If present and non-zero, specifies the (x, y) position parameters are in device coordinates.Inches
If present and non-zero, specifies that the XSize and YSize keyword parameters are in inches. (Default: centimeters)Normal
If present and non-zero, specifies the (x, y) position parameters are in normal coordinates.Order
If specified, overrides the current setting of the !Order system variable for the current image only. If nonzero, Order causes the image to be drawn from the top-down, instead of from the bottom-up (the default).Resize_Device
If present and non-zero, resizes the output device to match the size of the image. This keyword is ignored when the current device is a screen device, such as X or WIN32. See the Discussion section for more information. Top
Specifies that the image intensity values are to be scaled (as with the TVSCL procedure). The value specified is the upper bound of the intensity values.Screen_Dpi
Specifies the resolution of the screen in pixels per inch. Default: 100 dpi.XSize
Specifies the width of the displayed (or printed) image. The default is to display it with the same width it would have if displayed on the screen. YSize
Specifies the height of the displayed (or printed) image. The default is to display it with the same height it would have if displayed on the screen.Z
The z position. The value of z is of use only if the 3D transformation is in effect via the T3d keyword.
It is usually the case that the resolution of an output device, such as a laser printer, does not match the resolution of your computer screen. Because of this difference in resolution, you may notice that printed images look smaller than images that appear on your screen. TVSIZE detects these differences in display resolution and automatically adjusts the size of the image, if necessary.
By default, a screen resolution of 100 dots per inch (dpi) is assumed for your system. (If you wish, you can specify your screen resolution precisely using the Screen_Dpi keyword.) The screen dpi is compared to the value of the system variables !D.X_Px_Cm and !D.Y_Px_Cm. (These system variables hold the (x, y) resolution in number of pixels per centimeter for the currently active output device.) If there is a difference of greater than 20% between the screen resolution and the output device resolution, TVSIZE resizes the image accordingly. If the output device does not have scalable pixels, the CONGRID routine is used to expand the number of pixels to match the given size. If the device supports scalable pixels it simply receives the requested image size.
If you have annotated an image with text or lines or other graphics objects, you may notice that the printed output does not appear the way it appears on your screen. Specifically, the annotations may appear to be moved away from the image. If this is the case, use the Resize_Device keyword. This keyword explicitly resizes the output device to match the image size, resulting in output that closely matches the graphics as they appear on your screen.
TIP: TVSIZE assumes that your screen resolution is 100 dots per inch (dpi). To improve the ability of TVSIZE to estimate the size of the image on the screen and correctly size the image for printing, do the following:
scr_dpi = [!D.X_Px_Cm,!D.Y_Px_Cm]*2.54
TVSIZE, image, x, y, Screen_Dpi=scr_dpi
NOTE: The system variables !D.X_Px_Cm and !D.Y_Px_Cm may not exactly reflect the resolution of the screen. These values are reported to PV-WAVE and cannot be verified.
TVSIZE, image, 0, 0
TVSIZE, image, 0, 0, XSize=5, YSize=7, /Inches
