SubImage(Point,Size,Single,Int32) Method

In This Topic

Syntax
Remarks
Requirements
- See Also

Creates a copy of part or all of the image with controlled size

Syntax

public DicomImage SubImage( 
   System.Drawing.Point Offset,
   System.Drawing.Size Size,
   System.float Magnification,
   System.int Frame
)

public function SubImage( 
    Offset: System.Drawing.Point;
    Size: System.Drawing.Size;
    Magnification: System.Single;
    Frame: System.Integer
): DicomImage;

public function SubImage( 
   Offset : System.Drawing.Point,
   Size : System.Drawing.Size,
   Magnification : System.float,
   Frame : System.int
) : DicomImage;

public: DicomImage* SubImage( 
   System.Drawing.Point Offset,
   System.Drawing.Size Size,
   System.float Magnification,
   System.int Frame
)

public:
DicomImage^ SubImage( 
   System.Drawing.Point Offset,
   System.Drawing.Size Size,
   System.float Magnification,
   System.int Frame
)

'Declaration
 
Public Overloads Function SubImage( _
   ByVal Offset As System.Drawing.Point, _
   ByVal Size As System.Drawing.Size, _
   ByVal Magnification As System.Single, _
   ByVal Frame As System.Integer _
) As DicomImage

'Usage
 
Dim instance As DicomImage
Dim Offset As System.Drawing.Point
Dim Size As System.Drawing.Size
Dim Magnification As System.Single
Dim Frame As System.Integer
Dim value As DicomImage
 
value = instance.SubImage(Offset, Size, Magnification, Frame)

Parameters

Offset: The left top corner point of the sub Image
Size: The total size of the original image to capture
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

Return Value

A new DicomImage

Remarks

Makes a derived image (of same basic DICOM type as the original) scaled and cropped as required. Unlike PrinterImage, the pixel data is not modified or scaled, and XSize and YSize refer to the final image size, not the input (useful for making fixed size thumbnails etc.) If the original image is flipped and/or rotated, then the SubImage will be similarly modified, and the coordinates used for the offsets and sizes apply in the rotated/flipped coordinate space. This makes it simple to select sub-images using a GUI, as the coordinates used for SubImage are compatible with those used for an "ImageTied" DicomLabel.

Requirements

Target Platforms: .NET CLR 4.8 or higher

Reference

DicomImage Class
DicomImage Members
Overload List

Send Feedback