IDocFontMgr.h

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

#include "IPMUnknown.h"
#include "FontMgrID.h"
#include "IFontMgr.h" // FontNameInfo
#include "IFontFamily.h"

class IFontGroupId;
class PMString;

class IDocFontMgr : public IPMUnknown
{
 public:
 enum { kDefaultIID = IID_IDOCFONTMGR };


 //---------GET FONT FAMILY UID-----------------

 virtual UID GetFontFamilyUID(const IFontGroupId *fontGroupIDPtr, bool16 makeOneIfNecessary = kTrue) = 0;

 virtual UID GetFontGroupUID(IFontFamily * sourceFontFamily, bool16 makeOneIfNecessary = kTrue) = 0;
 
 
 virtual UID GetFontFamilyUID(const IPMFont *font, bool16 makeOneIfNecessary = kTrue) = 0;
 
 virtual UID GetFontFamilyUID(const PMString &displayFamilyName, PMString &fontStyle, bool16 makeOneIfNecessary = kTrue) = 0;

 virtual UID GetFontGroupUIDWithFontFaceMappingInfo(const PMString& groupName,
 IFontFamily::FontFaceMappingInfo& FontFaceMappingInfo) = 0;

 virtual UID GetFontFamilyUIDWithPostscriptName(const PMString& familyName, const FontEntry &fontEntry) = 0;

 virtual IFontFamily* QueryFontGroup(const PMString& groupName, bool16 makeOneIfNecessary = kTrue) = 0;
 
 virtual UID GetDefaultFamilyUID() = 0;


 //---------ADD/REMOVE UID-----------------

 virtual void Append(UID groupUID) = 0;
 virtual void Remove(UID groupUID) = 0; 


 //---------ACCESS ROUTINES-----------------

 virtual int32 GetFontGroupCount() const = 0;
 virtual UID GetNthFontGroupUID( int32 i) const = 0;


 //---------UPDATE-----------------

 virtual void FontSystemChanged(void) = 0;

 typedef enum { 
 kDoNotUpdateDysfunctionalFamilies,
 kUpdateOnlyDysfunctionalFamilies
 } UpdateFlags;
 
 virtual bool16 UpdateCache(IUsedFontList *usedFontList, UpdateFlags updateFlag = kDoNotUpdateDysfunctionalFamilies) = 0;


 //----------DISCOURAGED ROUTINES---------------
 // 
 virtual UID GetFontGroupUID(const PMString& groupName, bool16 makeOneIfNecessary = kTrue) = 0;
 
 virtual UID GetFontGroupUIDWithFontEntry( const IFontMgr::FontNameInfo& fontNames ) = 0;

 /*
 */
 virtual PMString GetTypekitFontID(const PMString& familyName, const PMString& styleName) = 0;
};

#endif
 // __IDocFontMgr__