pt.ua.dicoogle.server.web.dicom

Class Convert2PNG

java.lang.Object

pt.ua.dicoogle.server.web.dicom.Convert2PNG

public class Convert2PNG
extends java.lang.Object

Handles conversion between the images (formats) found inside a DICOM file and the PNG image format, for proper lossless web view.

Field Summary

Fields

Modifier and Type	Field and Description
static int	TRANSFORM_NONE Deprecated.
static int	TRANSFORM_SCALE_BY_HEIGHT Deprecated.
static int	TRANSFORM_SCALE_BY_PERCENT Deprecated.
static int	TRANSFORM_SCALE_BY_WIDTH Deprecated.

Constructor Summary

Constructors

Constructor and Description
Convert2PNG()

Method Summary

Modifier and Type	Method and Description
static java.io.ByteArrayOutputStream	DICOM2PNGStream(java.io.InputStream iStream, int frameIndex) Reads an input DICOM file and returns the desired frame as a PNG-encoded memory stream.
static java.io.ByteArrayOutputStream	DICOM2PNGStream(StorageInputStream dcmStream, int frameIndex) Reads an input DICOM file and returns the desired frame as a PNG-encoded memory stream.
static java.io.ByteArrayOutputStream	DICOM2PNGStream(StorageInputStream dcmStream, int frameIndex, int transformType, int transformParam1, float transformParam2) Deprecated.
static java.io.ByteArrayOutputStream	DICOM2ScaledPNGStream(java.io.InputStream inStream, int frameIndex, int width, int height) Reads an input DICOM file, scales it to fit in the given dimensions and returns the desired frame as a PNG-encoded memory stream.
static java.io.ByteArrayOutputStream	DICOM2ScaledPNGStream(StorageInputStream dcmStream, int frameIndex, int width, int height) Reads an input DICOM file, scales it to fit in the given dimensions and returns the desired frame as a PNG-encoded memory stream.
static int	getNumberOfFrames(StorageInputStream dcmFile) Retrieve the number of frames from an input DICOM file.
static java.awt.image.BufferedImage	scaleImage(java.awt.image.BufferedImage image, int width, int height) Resize a BufferedImage to fit the specified dimensions, while preserving the original image aspect ratio.
static java.awt.image.BufferedImage	scaleImageByHeight(java.awt.image.BufferedImage image, int height) Resize a BufferedImage to the specified height, preserving the original image aspect ratio.
static java.awt.image.BufferedImage	scaleImageByPercent(java.awt.image.BufferedImage image, float percent) Resize a BufferedImage based on the specified percentage, preserving the original image aspect ratio.
static java.awt.image.BufferedImage	scaleImageByWidth(java.awt.image.BufferedImage image, int width) Resize a BufferedImage to the specified width, preserving the original image aspect ratio.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TRANSFORM_NONE

@Deprecated
public static final int TRANSFORM_NONE

Deprecated.

No transform applied.

See Also:

Constant Field Values

TRANSFORM_SCALE_BY_WIDTH

@Deprecated
public static final int TRANSFORM_SCALE_BY_WIDTH

Deprecated.

Scale image based on a width target.

See Also:

Constant Field Values

TRANSFORM_SCALE_BY_HEIGHT

@Deprecated
public static final int TRANSFORM_SCALE_BY_HEIGHT

Deprecated.

Scale image based on a height target.

See Also:

Constant Field Values

TRANSFORM_SCALE_BY_PERCENT

@Deprecated
public static final int TRANSFORM_SCALE_BY_PERCENT

Deprecated.

Scale image based on a percentage value.

See Also:

Constant Field Values

Constructor Detail

Convert2PNG

public Convert2PNG()

Method Detail

DICOM2PNGStream

@Deprecated
public static java.io.ByteArrayOutputStream DICOM2PNGStream(StorageInputStream dcmStream,
                                                                        int frameIndex,
                                                                        int transformType,
                                                                        int transformParam1,
                                                                        float transformParam2)

Deprecated.

Reads an input DICOM file, applies a transformation to it if any, and returns the desired frame as a PNG-encoded memory stream.

Parameters:

dcmStream - The Dicoogle storage input Stream for the DICOM File.

frameIndex - the index of the frame wanted (zero based).

transformType - the transform to execute.

transformParam1 - the param used on width and height based scales.

transformParam2 - the param used on percentage based scales.

Returns:

the frame encoded in a PNG memory stream.

DICOM2PNGStream

public static java.io.ByteArrayOutputStream DICOM2PNGStream(StorageInputStream dcmStream,
                                                            int frameIndex)
                                                     throws java.io.IOException

Reads an input DICOM file and returns the desired frame as a PNG-encoded memory stream.

Parameters:

dcmStream - The Dicoogle storage input Stream for the DICOM File.

frameIndex - the index of the frame wanted (starting with #0).

Returns:

the frame encoded in a PNG memory stream.

Throws:

java.io.IOException - if the I/O operations on the images fail

DICOM2PNGStream

public static java.io.ByteArrayOutputStream DICOM2PNGStream(java.io.InputStream iStream,
                                                            int frameIndex)
                                                     throws java.io.IOException

Reads an input DICOM file and returns the desired frame as a PNG-encoded memory stream.

Parameters:

iStream - an input stream for the DICOM File.

frameIndex - the index of the frame wanted (starting with #0).

Returns:

the frame encoded in a PNG memory stream.

Throws:

java.io.IOException - if the I/O operations on the images fail

DICOM2ScaledPNGStream

public static java.io.ByteArrayOutputStream DICOM2ScaledPNGStream(java.io.InputStream inStream,
                                                                  int frameIndex,
                                                                  int width,
                                                                  int height)
                                                           throws java.io.IOException

Reads an input DICOM file, scales it to fit in the given dimensions and returns the desired frame as a PNG-encoded memory stream.

Parameters:

inStream - The Dicoogle storage input Stream for the DICOM File.

frameIndex - the index of the frame wanted (starting with #0).

width - the maximum width of the resulting image

height - the maximum height of the resulting image

Returns:

the frame encoded in a PNG memory stream.

Throws:

java.io.IOException - if the I/O operations on the images fail

DICOM2ScaledPNGStream

public static java.io.ByteArrayOutputStream DICOM2ScaledPNGStream(StorageInputStream dcmStream,
                                                                  int frameIndex,
                                                                  int width,
                                                                  int height)
                                                           throws java.io.IOException

Reads an input DICOM file, scales it to fit in the given dimensions and returns the desired frame as a PNG-encoded memory stream.

Parameters:

dcmStream - The Dicoogle storage input Stream for the DICOM File.

frameIndex - the index of the frame wanted (starting with #0).

width - the maximum width of the resulting image

height - the maximum height of the resulting image

Returns:

the frame encoded in a PNG memory stream.

Throws:

java.io.IOException - if the I/O operations on the images fail

getNumberOfFrames

public static int getNumberOfFrames(StorageInputStream dcmFile)

Retrieve the number of frames from an input DICOM file.

Parameters:

dcmFile - The Dicoogle storage input Stream for the DICOM File.

Returns:

an integer representing the number of frames in the image, or -1 if the operation fails

scaleImageByWidth

public static java.awt.image.BufferedImage scaleImageByWidth(java.awt.image.BufferedImage image,
                                                             int width)

Resize a BufferedImage to the specified width, preserving the original image aspect ratio.

Parameters:

image - the original image to scale.

width - the target width.

Returns:

a BufferedImage scaled to the target width.

scaleImageByHeight

public static java.awt.image.BufferedImage scaleImageByHeight(java.awt.image.BufferedImage image,
                                                              int height)

Resize a BufferedImage to the specified height, preserving the original image aspect ratio.

Parameters:

image - the original image to scale.

height - the target height.

Returns:

a BufferedImage scaled to the target height.

scaleImageByPercent

public static java.awt.image.BufferedImage scaleImageByPercent(java.awt.image.BufferedImage image,
                                                               float percent)

Resize a BufferedImage based on the specified percentage, preserving the original image aspect ratio.

Parameters:

image - the original image to scale.

percent - the percentage to scale to, 1.0 is original, 0.5 is half, 2.0 is double, etc.

Returns:

a BufferedImage scaled to the target percentage.

scaleImage

public static java.awt.image.BufferedImage scaleImage(java.awt.image.BufferedImage image,
                                                      int width,
                                                      int height)

Resize a BufferedImage to fit the specified dimensions, while preserving the original image aspect ratio. The image scaling procedure will guarantee that at least one of the dimensions will be equal to the maximum target.

Parameters:

image - the original image to scale.

width - the maximum width of the target

height - the maximum height of the target

Returns:

a copy of the image, scaled to fit into the given dimensions

Throws:

java.lang.IllegalArgumentException - on bad width and height dimensions

java.lang.NullPointerException - on null image