IJPEGEncoder.h

//========================================================================================
// 
// $File$
// 
// Owner: jargast
// 
// $Author$
// 
// $DateTime$
// 
// $Revision$
// 
// $Change$
// 
// Copyright 1997-2010 Adobe Systems Incorporated. All rights reserved.
// 
// NOTICE: Adobe permits you to use, modify, and distribute this file in accordance 
// with the terms of the Adobe license agreement accompanying it. If you have received
// this file from a source other than Adobe, then your use, modification, or 
// distribution of it requires the prior written permission of Adobe.
// 
// 
// Defines the JPEG coder interface.
// 
//========================================================================================

#ifndef __IJPEGEncoder__
#define __IJPEGEncoder__

#include "IPMUnknown.h"
#include "JPEGCodecID.h"
#include "IPMStream.h"

typedef enum _JPEGEncoding // Match Photoshop defs: 0, 1, 2, 3
{ // last two options not implemented
 kJPEGBaseline,
 kJPEGSequential,
 kJPEGProgressive,
 kJPEGLossless,
 kJPEGHierarchical
} JPEGEncoding; 

typedef enum
{
 kPoorQuality = -2,
 kFairQuality = 0,
 kGoodQuality = 1,
 kVeryGoodQuality = 3,
 kExcellentQuality = 6,
 kGreatQuality = 8
} JPEGQuality;

typedef enum
{ // Match Photoshop defs
 kFairScan = 1,
 kGoodScan = 2,
 // kVeryGoodScan= 4, // Yes, these are out of order
 kExcellentScan = 3
} JPEGScanTabGroup;

class JPEGWriteOptions {
public:
 JPEGWriteOptions() :
 xResolution(0),
 yResolution(0),
 xSize(0),
 ySize(0),
 colorType(0), 
 imageResources(nil), 
 imageResourcesSize(0UL),
 jpegQuality(kFairQuality),
 encoding(kJPEGBaseline),
 customHuff(kFalse),
 scanTabGroup(kFairScan),
 iccProfileData(nil), 
 iccProfileDataLen(0UL)
 {}

 short xResolution; // These two parameters are ignored if the image is CMYK
 short yResolution; // and the resolution must then be stored in the image resources
 uint16 xSize;
 uint16 ySize;
 short colorType; // 1 = Gray, 3 = RGB, 4 = CMYK
 char* imageResources;
 uint32 imageResourcesSize;
 JPEGQuality jpegQuality;
 JPEGEncoding encoding; // sequential, progressive...
 bool16 customHuff; // whether to use custom Huff tables 
 JPEGScanTabGroup scanTabGroup; // what scan order to use for progressive encoding
 uint8* iccProfileData;
 uint32 iccProfileDataLen;
} ;
 
class IJPEGEncoder : public IPMUnknown
{

public:
 virtual bool16 Open ( const JPEGWriteOptions& jpegWriteOptions, 
 IPMStream* iPMStream ) = 0; 
 
 virtual bool16 WriteRows (char* rowBuffer, uint32 numberOfRows) = 0;
 
 virtual bool16 Close () = 0;
};


#endif