OFFIS DCMTK: dcmjpeg/include/djcodece.h Source File

00001 /*
00002  *
00003  *  Copyright (C) 1997-2003, OFFIS
00004  *
00005  *  This software and supporting documentation were developed by
00006  *
00007  *    Kuratorium OFFIS e.V.
00008  *    Healthcare Information and Communication Systems
00009  *    Escherweg 2
00010  *    D-26121 Oldenburg, Germany
00011  *
00012  *  THIS SOFTWARE IS MADE AVAILABLE,  AS IS,  AND OFFIS MAKES NO  WARRANTY
00013  *  REGARDING  THE  SOFTWARE,  ITS  PERFORMANCE,  ITS  MERCHANTABILITY  OR
00014  *  FITNESS FOR ANY PARTICULAR USE, FREEDOM FROM ANY COMPUTER DISEASES  OR
00015  *  ITS CONFORMITY TO ANY SPECIFICATION. THE ENTIRE RISK AS TO QUALITY AND
00016  *  PERFORMANCE OF THE SOFTWARE IS WITH THE USER.
00017  *
00018  *  Module:  dcmjpeg
00019  *
00020  *  Author:  Marco Eichelberg, Norbert Olges
00021  *
00022  *  Purpose: abstract codec class for JPEG encoders.
00023  *
00024  *  Last Update:      $Author: meichel $
00025  *  Update Date:      $Date: 2003/07/04 13:26:22 $
00026  *  Source File:      $Source: /share/dicom/cvs-depot/dcmtk/dcmjpeg/include/djcodece.h,v $
00027  *  CVS/RCS Revision: $Revision: 1.3 $
00028  *  Status:           $State: Exp $
00029  *
00030  *  CVS/RCS Log at end of file
00031  *
00032  */
00033 
00034 #ifndef DJCODEC_H
00035 #define DJCODEC_H
00036 
00037 #include "osconfig.h"
00038 #include "oftypes.h"
00039 #include "dccodec.h"    /* for class DcmCodec */
00040 #include "djutils.h"    /* for enums */
00041 #include "oflist.h"
00042 #include "ofstring.h"   /* for class OFString */
00043 
00044 class DataInterface;
00045 class DJEncoder;
00046 class DcmDataset;
00047 class DJCodecParameter;
00048 class DJDecoder;
00049 class DcmItem;
00050 class DcmPixelItem;
00051 class DicomImage;
00052 class DcmTagKey;
00053 
00054 
00062 class DJCodecEncoder : public DcmCodec
00063 {
00064 public:  
00065  
00067   DJCodecEncoder();
00068 
00070   virtual ~DJCodecEncoder();
00071 
00082   virtual OFCondition decode(
00083     const DcmRepresentationParameter * fromRepParam,
00084     DcmPixelSequence * pixSeq,
00085     DcmPolymorphOBOW& uncompressedPixelData,
00086     const DcmCodecParameter * cp,
00087     const DcmStack& objStack) const;
00088 
00103   virtual OFCondition encode(
00104     const Uint16 * pixelData,
00105     const Uint32 length,
00106     const DcmRepresentationParameter * toRepParam,
00107     DcmPixelSequence * & pixSeq,
00108     const DcmCodecParameter *cp,
00109     DcmStack & objStack) const;
00110 
00125   virtual OFCondition encode(
00126     const E_TransferSyntax fromRepType,
00127     const DcmRepresentationParameter * fromRepParam,
00128     DcmPixelSequence * fromPixSeq,
00129     const DcmRepresentationParameter * toRepParam,
00130     DcmPixelSequence * & toPixSeq,
00131     const DcmCodecParameter * cp,
00132     DcmStack & objStack) const;
00133 
00141   virtual OFBool canChangeCoding(
00142     const E_TransferSyntax oldRepType,
00143     const E_TransferSyntax newRepType) const;
00144 
00149   virtual E_TransferSyntax supportedTransferSyntax() const = 0;
00150 
00151 protected:
00152 
00157   static void appendCompressionRatio(OFString& arg, double ratio);
00158 
00159 private: 
00160 
00177   virtual OFCondition encodeColorImage(
00178         OFBool YBRmode,
00179         DcmItem *dataset,
00180         const DcmRepresentationParameter * toRepParam,
00181         DcmPixelSequence * & pixSeq,
00182         const DJCodecParameter *cp,
00183         double& compressionRatio) const;
00184 
00198   virtual OFCondition encodeMonochromeImage(
00199         DcmItem *dataset,
00200         const DcmRepresentationParameter * toRepParam,
00201         DcmPixelSequence * & pixSeq,
00202         const DJCodecParameter *cp,
00203         double& compressionRatio) const;
00204 
00212   virtual OFCondition updateLossyCompressionRatio(DcmItem *dataset, double ratio) const;
00213 
00224   virtual OFCondition updateDerivationDescription(
00225       DcmItem *dataset,
00226       const DcmRepresentationParameter * toRepParam,
00227       const DJCodecParameter *cp,
00228       Uint8 bitsPerSample,
00229       double ratio) const;
00230 
00236   virtual OFCondition adjustOverlays(DcmItem *dataset, DicomImage& image) const;
00237 
00242   virtual OFBool isLosslessProcess() const = 0;
00243   
00254   virtual void createDerivationDescription(
00255     const DcmRepresentationParameter * toRepParam,
00256     const DJCodecParameter *cp,
00257     Uint8 bitsPerSample,
00258     double ratio,
00259     OFString& derivationDescription) const = 0;
00260 
00268   virtual DJEncoder *createEncoderInstance(
00269     const DcmRepresentationParameter * toRepParam,
00270     const DJCodecParameter *cp,
00271     Uint8 bitsPerSample) const = 0;
00272 
00281   static OFCondition correctVOIWindows(DcmItem *dataset, double voiOffset, double voiFactor);
00282 
00283 };
00284 
00285 #endif
00286 
00287 /*
00288  * CVS/RCS Log
00289  * $Log: djcodece.h,v $
00290  * Revision 1.3  2003/07/04 13:26:22  meichel
00291  * Replaced forward declarations for OFString with explicit includes,
00292  *   needed when compiling with HAVE_STD_STRING
00293  *
00294  * Revision 1.2  2002/05/24 14:58:04  meichel
00295  * Moved helper methods that are useful for different compression techniques
00296  *   from module dcmjpeg to module dcmdata
00297  *
00298  * Revision 1.1  2001/11/13 15:56:16  meichel
00299  * Initial release of module dcmjpeg
00300  *
00301  *
00302  */