com.archimed.dicom.converters

Class NativeFrameConverterOp

java.lang.Object

com.archimed.dicom.converters.BaseFrameConverterOp

com.archimed.dicom.converters.NativeFrameConverterOp

All Implemented Interfaces:

FrameConverterOp

public class NativeFrameConverterOp
extends BaseFrameConverterOp

Frame Converter that converts to one of the native (not encapsulated) formats. Either ILE,ELE or EBE.
Currently supports the following source transfer syntaxes:

• JPEG Baseline (1.2.840.10008.1.2.4.50)
• JPEG14 Selection Value 1 (1.2.840.10008.1.2.4.70)

Constructor Summary

Constructors

Constructor and Description
NativeFrameConverterOp(TransferSyntaxUID targetTransferSyntaxUID) Creates a new NativeFrameConverterOp.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canConvert(DicomObject dcm) check if the transfer syntax in the file meta information of the specified DicomObject is one of the supported source transfer syntaxes.
byte[]	convert(byte[] frame, ImageInfo imageInfo) converts a frame.
long	getConvertedPixelDataLength(DicomObject dcm, long originalPixelDataLength, int originalType) base implementation that returns the pixel data length of the source see FrameConverterOp.getConvertedPixelDataLength(DicomObject, long, int)
int	getConvertedPixelDataType(DicomObject dcm, long originalPixelDataLength, int originalType) always take OW.
TransferSyntaxUID	getConvertedTransferSyntax(DicomObject dcm) returns the new transfer syntax of the image to which this frame conversion operation has been applied Eg: If the operation compresses frames according to a particular codec, then the encapsulated transfer syntax corresponding to this transfer syntax should be returned.
DicomObject	modifyDicomObject(DicomObject dcm) modifies the outgoing dicom stream before frames are appended - new transfer syntax in file meta - force photometric interpretation of RGB for images with 3 samples per pixel.

Methods inherited from class java.lang.Object

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

Constructor Detail

NativeFrameConverterOp

public NativeFrameConverterOp(TransferSyntaxUID targetTransferSyntaxUID)

Creates a new NativeFrameConverterOp. The specified transfer syntax must be one of

• ImplicitVRLittleEndianUID
• ExplicitVRLittleEndianUID
• ExplicitVRBigEndianUID

Parameters:

targetTransferSyntaxUID -

Method Detail

canConvert

public boolean canConvert(DicomObject dcm)

check if the transfer syntax in the file meta information of the specified DicomObject is one of the supported source transfer syntaxes. returns false when the specified DicomObject does not have file meta information.

Parameters:

dcm - the source DicomObject

Returns:

true or false

getConvertedTransferSyntax

public TransferSyntaxUID getConvertedTransferSyntax(DicomObject dcm)
                                             throws DicomException

Description copied from interface: FrameConverterOp

returns the new transfer syntax of the image to which this frame conversion operation has been applied Eg: If the operation compresses frames according to a particular codec, then the encapsulated transfer syntax corresponding to this transfer syntax should be returned.

Parameters:

dcm - the source DicomObject (read up until the pixeldata data element)

Returns:

the transfer syntax of the converted DicomObject

Throws:

DicomException - an exception

getConvertedPixelDataLength

public long getConvertedPixelDataLength(DicomObject dcm,
                               long originalPixelDataLength,
                               int originalType)
                                 throws DicomException

Description copied from class: BaseFrameConverterOp

base implementation that returns the pixel data length of the source see FrameConverterOp.getConvertedPixelDataLength(DicomObject, long, int)

Specified by:

getConvertedPixelDataLength in interface FrameConverterOp

Overrides:

getConvertedPixelDataLength in class BaseFrameConverterOp

Parameters:

dcm - the source DicomObject

originalPixelDataLength - the length of the source pixel data

originalType - the type of the source pixel data

Returns:

the converted pixel data length

Throws:

DicomException

getConvertedPixelDataType

public int getConvertedPixelDataType(DicomObject dcm,
                            long originalPixelDataLength,
                            int originalType)
                              throws DicomException

always take OW. For explicit little endian (and big endian ?) OB is also allowed in case of bitsAllocated <= 8 but OW is always allowed whatsoever.

Specified by:

getConvertedPixelDataType in interface FrameConverterOp

Overrides:

getConvertedPixelDataType in class BaseFrameConverterOp

Parameters:

dcm - the source DicomObject

originalPixelDataLength - the source pixel data length

originalType - the data type of the source pixel data

Returns:

the converted pixel data type

Throws:

DicomException - -

modifyDicomObject

public DicomObject modifyDicomObject(DicomObject dcm)
                              throws DicomException

modifies the outgoing dicom stream before frames are appended - new transfer syntax in file meta - force photometric interpretation of RGB for images with 3 samples per pixel. Sun's baseline jpeg decoder will decode into RGB.

Specified by:

modifyDicomObject in interface FrameConverterOp

Overrides:

modifyDicomObject in class BaseFrameConverterOp

Parameters:

dcm - the source DicomObject

Returns:

the modified DicomObject

Throws:

DicomException - -

convert

public byte[] convert(byte[] frame,
             ImageInfo imageInfo)
               throws DicomException

Description copied from interface: FrameConverterOp

converts a frame. Note: this must be changed to a method capable of handling ByteArray arguments if we need to support images larger than 2^31 bytes.

Parameters:

frame - the source pixel frame

imageInfo - relevant information of the image

Returns:

the converted pixel frame

Throws:

DicomException - an exception