IAsciiEncodingUtils.h

//========================================================================================
// 
// $File$
// 
// Owner: Chris Jones
// 
// $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.
// 
//========================================================================================

#ifndef __IEncodingUtils__
#define __IEncodingUtils__

#include "IPMUnknown.h"

#include "UtilitiesID.h"

class IPMStream;


class IAsciiEncodingUtils : public IPMUnknown
{
public:
 enum { kDefaultIID = IID_IASCIIENCODINGUTILS };

 // Type of encoding
 typedef enum
 {
 // encoding type.
 kHexEncoding = 0x01,
 kAscii85Encoding = 0x02,
 kAscii64Encoding = 0x04
 
 // future, compression types.
 // todo
 } EncodingOptions;

 virtual void Encode( int32 nOptions, unsigned char* pSrc, int32 nSrcBytes, PMString& strDst ) = 0;

 virtual void Encode( int32 nOptions, IPMStream* sStream, PMString& strDst ) = 0;

 virtual void Encode( int32 nOptions, IPMStream* sStream, IPMStream* dStream ) = 0;

 virtual unsigned char* Decode( int32 nOptions, const PMString& strSrc, int32& nDstBytes ) = 0;

 virtual void Decode( int32 nOptions, const PMString& strSrc, IPMStream* dStream ) = 0;

 virtual void Decode( int32 nOptions, IPMStream* sStream, IPMStream* dStream ) = 0;



 virtual void Encode( int32 nOptions, IPMStream* sStream, std::string& destString ) = 0;

 virtual unsigned char* Decode( int32 nOptions, const std::string& strSrc, int32& nDstBytes ) = 0;

 virtual void Decode( int32 nOptions, const std::string& sourceString, IPMStream* dStream ) = 0;

};


#endif