DicomObjects.NET.8.48 Documentation
DicomObjects Namespace / DicomImage Class / MagnificationMode Property

In This Topic
    MagnificationMode Property
    In This Topic
    Controls how pixels are interpolated when the image is magnified
    Public Property MagnificationMode As FilterMode
    Dim instance As DicomImage
    Dim value As FilterMode
    instance.MagnificationMode = value
    value = instance.MagnificationMode
    public FilterMode MagnificationMode {get; set;}
    public read-write property MagnificationMode: FilterMode; 
    public function get,set MagnificationMode : FilterMode
    public: __property FilterMode get_MagnificationMode();
    public: __property void set_MagnificationMode( 
       FilterMode value
    property FilterMode MagnificationMode {
       FilterMode get();
       void set (    FilterMode value);
    This property controls how DicomObjects handles magnification of images, either for display or other uses such as PrinterImage. The FilterMode enumerations (used for MagnificationMode and MinificationMode) are:
    • Default: For MagnificationMode, this acts identically to Replicate. This behaviour is the default, and is designed to minimise regulatory issues by doing the minimum necessary to display all pixel data, without adding extra "image processing".
    • Replicate: If zooming up is necessary, then pixels are simply replicated, giving a possibly "blocky" but honest representation of the pixel data. For minification, rows and columns are simply omitted as necessary.
    • BSpline: This smoothing procedure interpolates using a Cubic B-Spline, which has the advantage of guaranteeing continuity in both the first and second differentials of the image, in both directions. No other parameters are used in this smoothing method, which produces good visual results, though some users find them a little too "smoothed".
    • CubicSpline: This is similar to the B-Spline described above, but uses an additional parameter (CubicSplineAlpha) to control the degree of smoothing or edge enhancement. The default value is "�0.75", and normal values range from "�0.5" to "�1.25", though higher negative values may be used to produce deliberate edge enhancement, though generally, UnsharpLength and UnsharpEnhancement should be used for this purpose, as they are independent of the smoothing method.
    • MovingAverage: This mode is most applicable when zoom is less than 1, and calculates pixels values as a weighted average of the surrounding values. The number of values used for this calculation depends on the value of FilterLength. If FilterLength is 0 (the default), then a suitable value is determined internally, based on the zoom (approximately 2/ActualZoom), but if FilterLength is non-zero then 2*FilterLength values are used.
    • GDI (Graphical Device Intergace): This mode uses the interinsic capabilities of modern display hardware and software to leave the interpolation of the image to such systems. In practice, it is generally similar on most systems to a DicomObjects.Enums.FilterMode.BSpline, and should, particularly for large format display be the most efficient. However, experience shows that some graphic cards perform quite badly in this mode, especially in 64 bit mode, so practical testing is advised.

    Target Platforms: .NET CLR 4.8 or higher

    See Also