/*
* Copyright (c) 2005-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: 
*     Class CPbk2ImageManager implementation classes.
*
*/


#ifndef CPBK2IMAGEMANAGERIMPL_H
#define CPBK2IMAGEMANAGERIMPL_H

//  INCLUDES
#include "CPbk2ImageManager.h"
#include "VPbkFieldType.hrh" // TVPbkFieldStorageType

// CONSTANTS
// Size of thumbnail images stored to contacts
#define KPbk2PersonalImageSize TSize(80,96)

//  FORWARD DECLARATIONS
class MPbk2ImageGetObserver;
class MPbk2ImageSetObserver;
class CVPbkContactManager;
class MVPbkBaseContactField;


// CLASS DECLARATION
/**
 * Abstract thumbnail reader interface.
 */
class MPbk2ImageReader : 
        public MPbk2ImageOperation
    {
    public:  // Interface
        /**
         * Starts reading a thumbnail from the contact specified at creation
         * time.
         * @param aParameters Optional parameters for the thumbnail.
         * 
         * @see TPbkImageLoadParameters
         */
        virtual void StartReadL
            (const TPbk2ImageManagerParams* aParameters = NULL) =0;

        /**
         * Cancels reading operation.
         */
        virtual void CancelRead() =0;
    };


/**
 * Abstract thumbnail image writer interface.
 */
class MPbk2ImageWriter : 
        public MPbk2ImageOperation
    {
    public:  // Interface
        /**
         * Starts writing a bitmap to the contact.
         *
         * @param aBitmap   bitmap to save to contact.
         */
        virtual void StartWriteL(const CFbsBitmap& aBitmap) =0;

        /**
         * Starts writing an image buffer to the contact.
         *
         * @param aBuffer   image buffer to save to contact.
         */
        virtual void StartWriteL(const TDesC8& aBuffer) =0;

        /**
         * Starts writing a file image to the contact.
         *
         * @param aFileName   file image to save to contact.
         */
        virtual void StartWriteL(const TDesC& aFileName) = 0;

        /**
         * Cancels writing operation.
         */
        virtual void CancelWrite() =0;
    };


/**
 * Factory class for creating concrete MPbk2ImageReader and 
 * MPbk2ImageWriter instances.
 */
class Pbk2ImageOperationFactory
    {
    public:
        /**
         * Creates a concrete image reader object based on the type of 
         * the thumbnail field in the contact.
         *
         * @param aContactManager Contact manager
         * @param aContact  contact to get thumbnail from.
         * @param aObserver observer to notify about progress of the operation.
         * @param aFieldType  Phonebook field type of fetched image.
         * Default field type is EPbkFieldIdThumbnailImage.
         * @return  thumbnail reader object or NULL if aContact contains no
         *          thumbnail.
         */
        static MPbk2ImageReader* CreateReaderLC
            (CVPbkContactManager& aContactManager,
            const MVPbkBaseContact& aContact,
            MPbk2ImageGetObserver& aObserver,
            const MVPbkFieldType& aFieldType);

        /**
         * Creates a concrete writer object based on the type of the thumbnail
         * field in the contact or in global field typing. 
         *
         * @param aContactManager Contact manager
         * @param aContact      contact to write thumbnail to.
         * @param aObserver     observer to notify about progress of the 
         *                      operation.
         * @param aFieldType  Phonebook field type of fetched image.
         * Default field type is EPbkFieldIdThumbnailImage.         
         * @return  thumbnail writer object.
         */
        static MPbk2ImageWriter* CreateWriterLC
            (CVPbkContactManager& aContactManager,
            MVPbkStoreContact& aContact, 
            MPbk2ImageSetObserver& aObserver,
            const MVPbkFieldType& aFieldType);

        /**
         * Returns true if aStorageType is supported for thumbnail field.
         *
         * @param aField    Contact field 
         * @return ETrue if field is supported, other EFalse
         */
        static TBool SupportedStorageType(const MVPbkBaseContactField* aField);

    private:
        /// Namespace class, constructor not implemented.
        Pbk2ImageOperationFactory();
    };

#endif // CPBK2IMAGEMANAGERIMPL_H

// End of File
