1 /*

     2 * Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description: 

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

    16 *

    17 */

    18 

    19 

    20 #ifndef OPENFONTLINKEDTYPEFACEEXTENSION_H

    21 #define OPENFONTLINKEDTYPEFACEEXTENSION_H

    22 

    23 /**

    24 Interface for handling, creating and modifying linked typefaces.

    25 

    26 The creation method sends an object containing the entire linked typeface specification.

    27 In return, a pointer to an object conforming to COpenFontFile is returned.

    28 This can subsequently be handed as though it were a normal COpenFontFile.

    29 

    30 @publishedPartner

    31 @prototype

    32 */

    33 class MOpenFontLinkedTypefaceExtension

    34 	{

    35 public:

    36 	/**

    37 	Create a linked typeface from the specification. A path and filename is provided to the rasterizer.

    38 	For example "c:\linkedfonts\MyLinkedTypeface" the rasterizer should append the file extension

    39 	e.g. ".ltf" to aFileName.

    40 

    41 	@param aLinkedTypefaceSpec The specification for the linked typeface

    42 	@param aFileName The path and filename where the rasterizer will save the linked typeface

    43 	@return	KErrNone if successful, otherwise one of the system wide error codes.

    44 	*/

    45 	virtual void CreateLinkedTypefaceL(const COpenFontLinkedTypefaceSpecification& aLinkedTypefaceSpec, TFileName& aFilename) = 0;

    46 

    47 	/**

    48 	Get the specification of a linked typeface from  the rasterizer.

    49 

    50 	The primary purpose of this function is to allow client side code to retrieve the existing

    51 	defintion of a linked typeface, prior to making changes to it and resubmitting the revised

    52 	definition to the rasterizer using UpdatelinkedTypeface().

    53 

    54 	@param	aOpenFontLinkedFont	A pointer to the existing COpenFontFile object for which the specification is required

    55 	@param	aLinkedTypefaceSpec	On return will point to the specification of the existing linked typeface. Ownership

    56 	 							of that specification object is transferred to the caller.

    57 	@return	KErrNone if everything succeeded; otherwise an appropriate standard error code

    58 

    59 	@see	MOpenFontLinkedTypefaceExtension::UpdatelinkedTypeface().

    60 	*/

    61 	virtual void GetLinkedTypefaceSpecificationL(const TFileName& aFilename, COpenFontLinkedTypefaceSpecification& aLinkedTypefaceSpec) = 0;

    62 

    63 	/**

    64 	To allow future extensions while maintaining BC.

    65 	*/

    66 	virtual void LinkedTypefaceRequestExtendedInterface(TUid aUid, TAny*& aParam) = 0;

    67 

    68 private:

    69 	//Reserved functions for future functionality.

    70 	IMPORT_C virtual void Reserved1() = 0;

    71 	IMPORT_C virtual void Reserved2() = 0; 

    72 	IMPORT_C virtual void Reserved3() = 0; 

    73 	IMPORT_C virtual void Reserved4() = 0; 

    74 	IMPORT_C virtual void Reserved5() = 0; 

    75 	IMPORT_C virtual void Reserved6() = 0;

    76 	IMPORT_C virtual void Reserved7() = 0;

    77 	IMPORT_C virtual void Reserved8() = 0;

    78 	};

    79 

    80 #endif /*OPENFONTLINKEDTYPEFACEEXTENSION_H*/