/*
* Copyright (c) 2002-2007 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:  Declares CUPPrintFactory class
*
*/


#ifndef CUPPRINTFACTORY_H
#define CUPPRINTFACTORY_H

#include <e32base.h>
#include <f32file.h>
#include <upnpdevice.h>

#include "cxhtmlfilecomposer.h"
#include "cimageinfo.h"
#include "printcapabilitycodes.h"
#include "tprintcapability.h"
#include "upconsts.h"

/*
* @class 		CUPPrintFactory
* @description	This class maps the printers between protocol client and
*				UPnP printer control point.
*/
NONSHARABLE_CLASS(CUPPrintFactory) : public CBase
	{
		public:
			/*
			* @function 	NewL
			* @description	Constructs the object
			*/
			static CUPPrintFactory* NewL();

			/*
			* @function 	Destructor
			* @description	Destructor
			*/
			~CUPPrintFactory();

			/*
			* @function		CreateXhtmlFileL
			* @description 	Creates XHTML-Print template folder for printing job.
			* @param		aJobURIs			Arrays of images' HTTP addresses to be printed
			* @param		aLayout				Defines the print layout
			* @param		aPaperSize			Paper size
			* @param		aQuality			Print quality
			* @param		aXhtmlPrintFile		Output parameter, which contains the filepath of created template file
			* @param		TInt& 				Returns the number of pages to print
			*/
			void CreateXhtmlFileL(const RArray<CImageInfo>& aJobURIs, const TInt aLayout,
								  const TInt aPaperSize, const TInt aQuality,
								  TDes& aXhtmlPrintFile, TInt& aPageCount);

			/*
			* @function 	DeleteXhtmlFilesL
			* @description	Deletes all XHTML-print files files
			*/
			void DeleteXhtmlFilesL();

			/*
			* @function 	FileCount
			* @description	Returns the number of the files printed at this session.
			*				Number is same as in the latest filename.
			* @return		TInt
			*/
			TInt FileCount();

			/*
			* @function 	GetCapabilityIDs
			* @description	Returns the capability IDs of supported capabilities
			* @param		aCapabilityIDs	Output parameter
			*/
			void GetCapabilityIDs(RArray<TInt>& aCapabilityIDs);

			/*
			* @function 	GetCapability
			* @description	Returns the default value of a capability
			* @param 		aCapabilityID	Id of the capability
			* @param		aCapability		Output parameter
			* @return		System wide error code
			*/
			TInt GetCapability(const TInt aCapabilityID, TPrintCapability& aCapability);

			/*
			* @function 	GetPrintSetting
			* @description	Returns the requested capability value.
			*				If capability id is invalid KErrArgument is returned.
			* @param		TInt	aCapabilityID
			* @param		TInt	aValue
			* @return 		TInt	Error code
			*/
			TInt GetPrintSetting(TInt aCapabilityID, TInt& aCapability);

			/*
			* @function 	SetPrintSetting
			* @description	Changes the value of an existing print setting.
			*				If setting is not supported KErrNotSupported is returned.
			* @param 		TInt aCapabilityId
			* @param		TInt aValue
			* @return		TInt System wide error code
			*/
			TInt SetPrintSetting(TInt aCapabilityID, TInt aValue);

		protected:


		private:
			/*
			* @function 	Constructor
			* @description	C++ constructor
			*/
			CUPPrintFactory();

			/*
			* @function 	ConstructL
			* @description	Construction's second phase
			*/
			void ConstructL();

			/*
			* @function 	InitCapabilities
			* @description	Initializes the supported capabilities array
			*/
			void InitCapabilities();

			/*
			* @function 	GetDefaultSettingsL
			* @description	Reads default printing settings from the file.
			* @param		TInt& returns layout value
			* @param		TInt& returns size value
			* @param		TInt& returns quality value
			*/
			void GetDefaultSettingsL(TInt& aLayout, TInt& aSize, TInt& aQuality);

			/*
			* @function 	SetDefaultSettingsL
			* @description	Sets the currently stored default printing settings in file.
			*/
			void SetDefaultSettingsL();

		private:
			//@var	iFileCount	Counter used in XHTML-print file naming
			TInt iFileCount;

			//@var iCapabilities	Capabilities/ settings supported by XHTML-print file factory
			RArray<TPrintCapability> iCapabilities;

			//@var iFileSession			File session for writing job settings in file.
			RFs iFileSession;
	};

#endif // CUPPRINTFACTORY_H

//  End of File