DicomObjects.NET.8.48 Documentation
DicomObjects Namespace / DicomImage3D Class / SubImage Method / SubImage(Point,Size,Single,Int32,ScaleMode) Method

The left top corner point of the sub Image

The zooming factor which determines the output size

The frame number to use. This is 1-index, i.e. first frame is 1 not 0

The scaling mode to use







In This Topic
    SubImage(Point,Size,Single,Int32,ScaleMode) Method
    In This Topic
    Creates a copy of part or all of the image with controlled size
    Syntax
    'Declaration
     
    
    Public Overloads Overrides Function SubImage( _
       ByVal offset As System.Drawing.Point, _
       ByVal imgSize As System.Drawing.Size, _
       ByVal Magnification As System.Single, _
       ByVal frame As System.Integer, _
       ByVal Scaling As ScaleMode _
    ) As DicomImage
    'Usage
     
    
    Dim instance As DicomImage3D
    Dim offset As System.Drawing.Point
    Dim imgSize As System.Drawing.Size
    Dim Magnification As System.Single
    Dim frame As System.Integer
    Dim Scaling As ScaleMode
    Dim value As DicomImage
     
    value = instance.SubImage(offset, imgSize, Magnification, frame, Scaling)
    public override DicomImage SubImage( 
       System.Drawing.Point offset,
       System.Drawing.Size imgSize,
       System.float Magnification,
       System.int frame,
       ScaleMode Scaling
    )
    public function SubImage( 
        offset: System.Drawing.Point;
        imgSize: System.Drawing.Size;
        Magnification: System.Single;
        frame: System.Integer;
        Scaling: ScaleMode
    ): DicomImage; override; 
    public override function SubImage( 
       offset : System.Drawing.Point,
       imgSize : System.Drawing.Size,
       Magnification : System.float,
       frame : System.int,
       Scaling : ScaleMode
    ) : DicomImage;
    public: DicomImage* SubImage( 
       System.Drawing.Point offset,
       System.Drawing.Size imgSize,
       System.float Magnification,
       System.int frame,
       ScaleMode Scaling
    ) override 
    public:
    DicomImage^ SubImage( 
       System.Drawing.Point offset,
       System.Drawing.Size imgSize,
       System.float Magnification,
       System.int frame,
       ScaleMode Scaling
    ) override 

    Parameters

    offset

    The left top corner point of the sub Image

    imgSize
    Magnification

    The zooming factor which determines the output size

    frame

    The frame number to use. This is 1-index, i.e. first frame is 1 not 0

    Scaling

    The scaling mode to use

    Return Value

    Remarks

    Makes a derived image (of same basic DICOM type as the original) scaled and cropped as required. Size refers to the final image size, whether or not it is transformed as below.

    The coordinate system used depends on the value of scaling. If ScaleMode.Image then the original image is used without rotation etc, but if ScaleMode.Output then the image is conceptually flipped, rotated etc. before applying the bounds.

    This overload is now recommended in place of the earlier version without the scaling mode which is retained for backwards compatibility only.

    Requirements

    Target Platforms: .NET CLR 4.8 or higher

    See Also