IMcDisplayMapZoomedToImage Method
|
|
Converts zoomed coordinates into image coordinates.
Namespace:
MediaCy.IQL.Display.Viewer
Assembly:
MediaCy.IQL.Display.Viewer (in MediaCy.IQL.Display.Viewer.dll) Version: 10.0.6912.0
SyntaxSub MapZoomedToImage (
ByRef pvarLongZoomedCoords As Object,
<OutAttribute> ByRef pvarFloatImageCoords As Object,
Optional bClientRelative As Boolean = true
)
Parameters
- pvarLongZoomedCoords
- Type: SystemObject
VARIANT* : A SafeArray of integer zoomed coordinates. - pvarFloatImageCoords
- Type: SystemObject
VARIANT* : A SafeArray of resulting floating point image coordinates. - bClientRelative (Optional)
- Type: SystemBoolean
BOOL : Optional, indicates whether the conversion
should account for Pan and Scroll (the default). When TRUE, the zoomed
coordinate (0,0) is the upper left corner pixel of the client window
managed by the viewer. When FALSE, the zoomed coordinate (0,0)
represents the actual upper left pixel of the image.
RemarksImage coordinates are real numbers and provide sub-pixel accuracy.
Zoomed coordinates are integers and represent the actual pixel within the
display, or client window, of the image. Zoomed coordinate 0:0 represents
the upper left corner of the display window.
When the Magnification is 1.0, MapZoomedToImage() simply converts the integer into a real number.
Refer to MapImageToZoomed for complete details.
Note |
---|
When this method is called from within the AboutToPaint or the PostPaint
methods of the _IMcViewEvents or _IMcBasicViewEvents event interfaces, then
"zoomed coordinates" are interpreted as logical coordinates for the device
context being drawn into (the lHDC argument in the notification calls). At
all other times, "zoomed coordinates" are client coordinates (i.e., logical
coordinates when the mapping mode is set to MM_TEXT). |
See Also