IColorSpaceMgr.h

//========================================================================================
// 
// $File$
// 
// Owner: fhaberma
// 
// $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 __IColorSpaceMgr__
#define __IColorSpaceMgr__

#include "IPMUnknown.h"
#include "ICMSSettings.h"
#include "ICMSProfile.h"
#include "BravoForwardDecl.h"

class PMString;
class IDocument;
class IColorXFormData;
class ICMSProfile;
class IColorData;

const int32 kGetCSFlagForceCalibrated = (1L<<4); // I.e., ignore doc/obj cms on/off setting
const int32 kGetCSFlagForceUncalibrated = (1L<<5); // I.e., ignore doc/obj cms on/off setting
const int32 kGetCSFlagHasAlpha = (1L<<6);
const int32 kGetCSFlagDocDefaultCalibrated = (1L<<7); // By default doc default is uncalibrated.

// Flags for GetAGMProfileForCategory
const int32 kCSMGetProfileNoSimulation = (1L<<2); // Don't include sim profile for monitor
const int32 kCSMGetProfileTryWeakly = (1L<<3); // If category not set up, don't force it
const int32 kCSMGetProfilePrefsIntent = (1L<<4); // Use rendering intent from prefs

class IColorSpaceMgr : public IPMUnknown
{
public:

 enum gamutAbility { kDoesNotImplement=0, kSimpleYesNo, kDistance};

 virtual AGMColorSpace *GetColorSpace
 (
 uint32 csType, 
 IDocument *doc, 
 void *agmPrivateData=nil, 
 int32 getColorSpaceFlags = 0,
 ICMSSettings::renderingIntent intent = ICMSSettings::kOther,
 bool16 isHSB = kFalse 
 ) = 0; 

 virtual AGMColorSpace *GetColorSpace
 (
 uint32 csType, 
 IPMUnknown* obj, 
 void *agmPrivateData=nil, 
 int32 getColorSpaceFlags = 0,
 ICMSSettings::renderingIntent intent = ICMSSettings::kOther,
 bool16 isHSB = kFalse
 ) = 0; 

 virtual AGMColorSpace *GetColorSpace
 (
 ICMSProfile* cmsProfile, 
 ICMSSettings::renderingIntent intent, 
 int32 getColorSpaceFlags = 0,
 bool16 isHSB = kFalse
 ) = 0; 

 virtual AGMColorSpace *GetColorSpace
 (
 IDocument *doc, 
 ICMSProfile::profileCategory category, 
 ICMSSettings::renderingIntent intent = ICMSSettings::kUseGStateRI,
 int32 getColorSpaceFlags = 0,
 bool16 isHSB = kFalse
 ) = 0; 

 virtual AGMColorSpace *GetColorSpace
 (
 uint32 csType,
 void *iccData,
 int32 iccSize,
 ICMSSettings::renderingIntent intent,
 int32 getColorSpaceFlags = 0,
 bool16 isHSB = kFalse
 ) = 0;

 virtual void ColorSpaceRelease
 (
 AGMColorSpace *cs
 ) = 0;
 
 virtual const void *GetProfileData
 (
 AGMColorSpace *cs, 
 uint32 *profileSize = nil
 ) = 0; 
 
 virtual void ReleaseProfileData
 (
 void *profileData
 ) = 0; 

 virtual bool8 GamutTest
 (
 IColorData* colorIn, 
 IColorData* colorOut, 
 IColorData *colorNearest, 
 IDocument *doc, 
 IColorSpaceMgr::gamutAbility& doesImplement
 ) = 0;

 virtual AGMColorProfile *GetAGMProfileForCategory
 (
 IDocument *doc,
 ICMSProfile::profileCategory category,
 int32 flags = 0,
 ICMSSettings::renderingIntent intent = ICMSSettings::kOther
 ) = 0; 

 virtual void ReleaseAGMProfile(AGMColorProfile *pAGMProfile) = 0; 

 virtual bool16 SetScreenIntentMode(bool16 bUseScreenIntent) = 0;

 virtual bool16 GetScreenIntentMode() = 0;
 
#ifdef DEBUG
 virtual void DumpToDebugWindow() = 0;
 virtual void Test1() = 0;
#endif

};

#endif