/*
* Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: 
* Interface for handling, creating and modifying linked typefaces.
*
*/


#ifndef OPENFONTLINKEDTYPEFACEEXTENSION_H
#define OPENFONTLINKEDTYPEFACEEXTENSION_H

/**
Interface for handling, creating and modifying linked typefaces.

The creation method sends an object containing the entire linked typeface specification.
In return, a pointer to an object conforming to COpenFontFile is returned.
This can subsequently be handed as though it were a normal COpenFontFile.

@publishedPartner
@prototype
*/
class MOpenFontLinkedTypefaceExtension
	{
public:
	/**
	Create a linked typeface from the specification. A path and filename is provided to the rasterizer.
	For example "c:\linkedfonts\MyLinkedTypeface" the rasterizer should append the file extension
	e.g. ".ltf" to aFileName.

	@param aLinkedTypefaceSpec The specification for the linked typeface
	@param aFileName The path and filename where the rasterizer will save the linked typeface
	@return	KErrNone if successful, otherwise one of the system wide error codes.
	*/
	virtual void CreateLinkedTypefaceL(const COpenFontLinkedTypefaceSpecification& aLinkedTypefaceSpec, TFileName& aFilename) = 0;

	/**
	Get the specification of a linked typeface from  the rasterizer.

	The primary purpose of this function is to allow client side code to retrieve the existing
	defintion of a linked typeface, prior to making changes to it and resubmitting the revised
	definition to the rasterizer using UpdatelinkedTypeface().

	@param	aOpenFontLinkedFont	A pointer to the existing COpenFontFile object for which the specification is required
	@param	aLinkedTypefaceSpec	On return will point to the specification of the existing linked typeface. Ownership
	 							of that specification object is transferred to the caller.
	@return	KErrNone if everything succeeded; otherwise an appropriate standard error code

	@see	MOpenFontLinkedTypefaceExtension::UpdatelinkedTypeface().
	*/
	virtual void GetLinkedTypefaceSpecificationL(const TFileName& aFilename, COpenFontLinkedTypefaceSpecification& aLinkedTypefaceSpec) = 0;

	/**
	To allow future extensions while maintaining BC.
	*/
	virtual void LinkedTypefaceRequestExtendedInterface(TUid aUid, TAny*& aParam) = 0;

private:
	//Reserved functions for future functionality.
	IMPORT_C virtual void Reserved1() = 0;
	IMPORT_C virtual void Reserved2() = 0; 
	IMPORT_C virtual void Reserved3() = 0; 
	IMPORT_C virtual void Reserved4() = 0; 
	IMPORT_C virtual void Reserved5() = 0; 
	IMPORT_C virtual void Reserved6() = 0;
	IMPORT_C virtual void Reserved7() = 0;
	IMPORT_C virtual void Reserved8() = 0;
	};

#endif /*OPENFONTLINKEDTYPEFACEEXTENSION_H*/