IMcDisplayMagnification Property

Property Value

Type: Double

Assignment to this property sets both the MagnificationX and MagnificationY properties to the assigned value. When this property is accessed, it returns the arithmetic average of MagnificationX and MagnificationY. When MagnificationX and MagnificationY are the same, the display preserves the aspect ratio of the image. Although this property accepts any positive valued real number within its limits, the viewer can only approximate the magnification desired by duplicating individual image pixels for display so that the size of the displayed image approaches the magification desired. Due to the nature of digital display, individual pixels are always replicated an integral number of times. As an example, assume a magnification of 3.5. most pixels will be replicated three times in both the x and y directions. However, every 3rd pixel, as well as every third row, will be replicated four times. Setting this property will also force the AutoZoomMode property to be set to "mazmNone". This property and the corresponding IMcView.Display property, are the same but send different PropertyChnaged notifications. Assigning to this property will avoid recording the assignment, which may be useful if you are making many intermediate changes. If the client application supports the OnPropertyChanged(ID_McDisplay_Magnification) event, the client application may choose to retrieve the ZoomedImageWidth and ZoomedImageHeight properties and resize itself. Magnification is limited to 128 (each displayed image pixel occupies 128 screen pixels). For "zoom-in" magnifications less than 1, assignments that would require the displayed height or width of the image to be below 1 pixel are silently ignored. If you wish to exceed these limits, assign separately to MagnificationX and MagnificationY, where no limit checking is done.