mcViewZoomMappingMode Enumeration |
|
Values for the eMapMode argument of the IMcView.MapImageToZoomed
and IMcDisplay.MapImageToZoomed methods.
Namespace: MediaCy.IQL.Display.Viewer
Assembly: MediaCy.IQL.Display.Viewer (in MediaCy.IQL.Display.Viewer.dll) Version: 10.0.6912.0
SyntaxVB
Public Enumeration mcViewZoomMappingMode
Members| Member name | Value | Description | |
|---|---|---|---|
| mvzmmPixelNormal | 0 | The origin is the center of each pixel.Formula used is -- IntegerResult = floor((FloatingCoord + 0.5) * ZoomFactor), where floor() is a C++ library function that retrieves the integer portion of the number via truncation. Use this method for general purpose mapping. | |
| mvzmmPixelUpperLeft | 1 | The coordinate returned ALWAYS refers to the upperleft tile of the group of "paint surface" tiles representing a single image pixel. Formula used: IntegerResult = floor(FloatingCoord * ZoomFactor). | |
| mvzmmPixelCenter | 2 | The coordinate returned ALWAYS refers to the centertile of the group of "paint surface" tiles representing a single image pixel. Formula used: IntegerResult = floor((floor(FloatingCoord) + 0.5) * ZoomFactor). (The formula ignores the fraction part of the floating point coordinate.) | |
| mvzmmPixelLowerRight | 3 | The coordinate returned ALWAYS refers to the lowerright tile of the group of "paint surface" tiles representing a single image pixel. Formula used: IntegerResult = floor(floor(FloatingCoord+1.0) * ZoomFactor)-1. | |
| mvzmmSetWheelMagnificationLimits | 100 | A special value indicating that thesupplied image point X,Y pair is to be interpreted as a low,high limit for the magnification that is allowed when the mouse-wheel is scrolled. | |
| mvzmmSetNoImagePanScrollSize | 101 | A special value indicating that thesupplied image point X,Y pair is to be interpreted as the maximum limit for the pan scroll when there is no ImageToDisplay. This pair of values is equivalent to the ImageToDisplay.Width and ImageToDisplay.Height. | |
| mvzmmSetMinZoomedSize | 102 | A special value indicating that thesupplied image point X,Y pair is to be interpreted as a minimum limit for ZoomedImageWidth,ZoomedImageHeight. When either of these values are positive and non-zero, then assignments to Magnification (but not MagnificationX or MagnificationY) will automatically adjust the magnification value and X-Y aspect ratio to keep the zoomed image size above the specified minimum dimensions. At the time this special value is invoked, the X,Y magnification is forced to a 1-1 aspect ratio, and whenever both axes are above the minimums, the magnification aspect ratio will be kept 1-1. |
RemarksSelects one of the Zoom Mapping Modes, which are used to convert Image Pixel
Coordinates (real numbers) into client coordinates (integers).
These values determine the location of the origin of each pixel (0.0, 0.0). These values
are used by the IMcView and IMcDisplay MapImageToZoomed methods (which take VARIANT
arguments); they are not available for the IMcBasicView.MapImageToZoomed method, which
lacks the eMapMode argument.
The most obvious example of its use is alignment of overlay pixels with a zoomed image.
For the IMcView.MapImageToZoomed method only, some special values of eMapMode signal that
the FloatImageCoords argument is being used to set some X,Y parameters for the view.
See Also