Creating Thumbnails and Icons

There are 2 methods within DicomObjects that can be used to create a Thumbnail image (PrinterImage and SubImage). If you want to create an icon for the purpose of inclusion into the embedded icon sequence attribute (&H88,&H200) of an image then use the PrinterImage method. The reason for using PrinterImage is that the resultant image only contains minimalist image information (the &H28 group) and the icon sequence attribute only permits attributes from the &H28 group to be included. SubImage on the other hand adds all attributes from the original image to the resultant image.

To create a thumbnail with the PrinterImage method use the following code:

Dim ModifiedImage as new DicomImage
Set ModifiedImage = MyDicomImage.PrinterImage(Bits, Planes, ShowAnnotations, Zoom, Left, Right, Top, Bottom) 
Bits 
Bit depth of final image (must be 8-16, but always 8 when Planes=3)
Planes 
1 for monochrome and 3 for colour
ShowAnotations
Boolean controls whether DicomLabels are “burnt-in” to the new image
Zoom 
Zoom factor to apply to new image
Left, Right, Top and Bottom 
Edges of the original image to use. So printer Image could be a cropped version of the original.
Note - When using the printerImage function only minimal Dicom data( DicomAttribute data) is copied to the new image - no pre-windowing data values are copied into the new image - ideal for an icon sequence attribute.


The SubImage method provides and easy way of creating a small thumbnail representation of the original Dicom Image. The difference between sub image and printer image is that subimage copies all attributes to the new image. The parameters of SubImage are (XOffset, YOffset, XSize, YSize, Magnification, Frame)

To create a thumbnail with the SubImage method use the following code:

DicomImage.SubImage(XOffset, YOffset, XSize, YSize, Magnification, Frame) 
XOffset , YOffset
Top left corner of the original image to use.
XSize , YSize
Size of the final image.
Magnification 
Magnification to apply before cropping to size given by XSize and YSize.
Frame 
The Frame to copy.


Thumbnails can be added to an Image under the Icon Sequence Attribute (&H88, &H200). See Adding_Sequence_Items using DicomObjects

Follow this link for information on how to retrieve the Image Icon - Query_Image_Icon

Relevance: