/*

* Copyright (c) 2006-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:  Thumbnail manager constants

 *

*/

#ifndef THUMBNAILMANAGERCONSTANTS_H

#define THUMBNAILMANAGERCONSTANTS_H

#include <e32base.h>

#include <gdi.h>

#include <etel3rdparty.h>

#include <apmstd.h>

#include "thumbnailmanager.h" // TThumbnailFlags

class CThumbnailServerSession;

// P&S stuff

static _LIT_SECURITY_POLICY_PASS(KAllowAllPolicy);

static _LIT_SECURITY_POLICY_C1(KPowerMgmtPolicy,ECapabilityPowerMgmt);

const TUid KTMPSNotification = { 0x102830AB };

const TUid KTAGDPSNotification = { 0x2001FD51 };

const TUid KMdSPSShutdown = { 0x20022E94 };

const TUid KServerIdle = { 0x102830AB };

const TUid KDaemonUid = { 0x2001FD51 };

const TInt KShutdown = 0x00000001;

const TInt KMdSShutdown = 0x00000002;

//used to signal from server side when it's idle

const TInt KIdle = 0x00000004;

//insert to temp table first wo indexing and move data to main table as batch

const TUint KMaxBatchItems = 18;

const TUint KMaxQueryItems = 1;

// maximum number of active client queue requests

const TUint KMaxClientRequests = 2;

// maximum number of active daemon requests

const TUint KMaxDaemonRequests = 3;

const TUint KClientRequestTimeout = 60000000; //60 sec

const TUint KThumbnailServerMajorVersionNumber = 0;

const TUint KThumbnailServerMinorVersionNumber = 1;

const TUint KThumbnailServerBuildVersionNumber = 1;

const TInt KThumbnailErrThumbnailNotFound = -62000;

//give MDS 1000 msec time to settle before starting generating TNs

const TInt KHarvestingCompleteTimeout = 10000000; //10 sec

const TInt KPSKeyTimeout = 10000000; //10 sec

//Store's auto flush timeout

const TInt KAutoFlushTimeout = 30000000; //30 sec

// video decoder timeout

const TInt KVideoDecoderTimeout = 5000000; // 5 seconds

const TDisplayMode KThumbnailDefaultDisplayMode = EColor64K;

//default displaymode (bpp - bits per pixel) for TNs in DB

//this makes possible to provide all colour depths up to 16M aka 24 -bit full colour

const TDisplayMode KStoreDisplayMode = EColor16M;

//required amount of memory to keep bitmaps on RAM in bits

const TInt KMemoryNeed = 5000000;

_LIT( KThumbnailServerName, "ThumbnailServer" );

_LIT( KThumbnailServerProcess, "*ThumbnailServer*" );

_LIT( KThumbnailServerExe, "thumbnailserver.exe" );

_LIT( KThumbnailServerShutdown, "Thumbnailserver_Shutdown" );

_LIT( KTAGDaemonName, "ThumbAGDaemon" );

_LIT( KTAGDaemonProcess, "*ThumbAGDaemon*" );

_LIT( KTAGDaemonExe, "thumbagdaemon.exe" );

// server message slots, -1 doesn't reserve fixed amount from global but  uses free available amount instead

const TInt KMessageSlots = -1;

const TInt KMinPriority = KMinTInt;

const TInt KMinPlaceholderPriority = (KMinTInt +1000);

const TInt KLowPriority = -1000;

const TInt KNormalPriority = 0;

const TInt KHighPriority = 1000;

const TInt KMaxGeneratePriority = (KMaxTInt -1000);

const TInt KMaxPriority = KMaxTInt; // For scaling tasks

const TInt KImeiBufferSize = CTelephony::KPhoneSerialNumberSize;

const TInt KCheckValue = 123456;

_LIT8( KJpegMime,    "image/jpeg" );            _LIT( KJpegExt, ".jpeg" );

_LIT8( KJpeg2000Mime,    "image/jp2" );            _LIT( KJpeg2000Ext, ".jp2" );

_LIT8( KJpgMime,    "image/jpeg" );            _LIT( KJpgExt, ".jpg" );

_LIT8( KGifMime,     "image/gif" );             _LIT( KGifExt,  ".gif" );

_LIT8( KPngMime,     "image/png" );             _LIT( KPngExt,  ".png" ); 

_LIT8( KSvgMime,     "image/svg+xml" );             _LIT( KSvgExt,  ".svg" ); 

_LIT8( KMpgMime1,    "video/mpeg");             _LIT( KMpgExt1,  ".mpg" );

_LIT8( KMpeg4Mime,   "video/mpeg4" );           _LIT( KMpeg4Ext,".mpeg4" );

_LIT8( KMp4Mime,     "video/mp4" );             _LIT( KMp4Ext,  ".mp4" );

_LIT8( KAviMime,    "video/x-msvideo" );       _LIT( KAviExt,  ".avi" );

_LIT8( KMp3Mime,    "audio/mpeg" );           _LIT( KMp3Ext,  ".mp3" );

_LIT8( KNonEmbeddArtMime,    "audio/mpeg" );           _LIT( KNonEmbeddArtExt,  ".alb" );

_LIT8( KM4aMime,    "audio/mp4" );           _LIT( KM4aExt,  ".m4a" );

_LIT8( KAacMime,     "audio/aac" );             _LIT( KAacExt,  ".aac" );

_LIT8( KWmaMime,     "audio/x-ms-wma" );        _LIT( KWmaExt,  ".wma" );

_LIT8( KBmpMime,     "image/bmp" );             _LIT( KBmpExt,  ".bmp" );

_LIT8( KAudio3gppMime,     "audio/3gpp" ); 

_LIT8( KVideo3gppMime,     "video/3gpp" );  _LIT( K3gpExt,  ".3gp" );

_LIT8( KAudioAmrMime,     "audio/AMR" );     _LIT( KAmrExt,  ".amr" );

_LIT8( KVideoWmvMime, "video/x-ms-wmv" );     _LIT( KWmvExt,    ".wmv" );

_LIT8( KRealAudioMime, "audio/vnd.rn-realaudio" );        _LIT( KRealAudioExt,    ".ra" );

_LIT8( KPmRealAudioPluginMime, "audio/x-pn-realaudio-plugin" ); _LIT( KPmRealAudioPluginExt,    ".rpm" );

_LIT8( KPmRealVideoPluginMime, "video/x-pn-realvideo" ); _LIT( KPmRealVideoPluginExt,    ".rm" );

_LIT8( KPmRealVbVideoPluginMime, "video/x-pn-realvideo" ); _LIT( KPmRealVbVideoPluginExt,    ".rmvb" );

_LIT8( KPmRealAudioMime, "audio/x-pn-realaudio" );        _LIT( KPmRealAudioExt,    ".ra" );

_LIT8( KRealVideoMime, "video/vnd.rn-realvideo" );        _LIT( KRealVideoExt,    ".rv" );

_LIT8( KFlashVideoMime,    "video/x-flv" );       _LIT( KFlashVideoExt,  ".flv" );

_LIT8( KMatroskaVideoMime,    "video/x-matroska" );       _LIT( KMatroskaVideoExt,  ".mkv" );

_LIT( KImageMime, "image/*" );

_LIT( KVideoMime, "video/*" );

_LIT( KAudioMime, "audio/*" );

_LIT( KM4vExt,  ".m4v" );

_LIT( KNonEmbeddedArtExt, ".alb" );

/**

 *  Control flags set by the server for handling specific situations

 *  (for example for distinguishing between preview thumbnails and

 *  final thumbnails).

 *

 *  @since S60 v5.0

 */

enum TThumbnailControlFlags

    {

    /**

     * Default value. No flags set.

     */

    EThumbnailNoControlFlags = 0, 

    /**

     * Set by the server when the request is completed and it is only the

     * first part of a two-phase request

     */

    EThumbnailPreviewThumbnail = 1,

    /**

     * Set by the client to inform server to create only missing persistent sizes thumbnails

     */

    EThumbnailGeneratePersistentSizesOnly = 2 

};

/**

 *  Thumbnail request parameters used for client-server communication.

 *

 *  @since S60 v5.0

 */

struct TThumbnailRequestParams

    {

public:

    /**

     * Bitmap handle for completed requests

     */

    TInt iBitmapHandle;

    /**

     * Flags for new requests.

     */

    CThumbnailManager::TThumbnailFlags iFlags;

    /**

     * Quality-preference value for new requests.

     */

    CThumbnailManager::TThumbnailQualityPreference iQualityPreference;

    /**

     * Priority for new requests.

     */

    TInt iPriority;

    /**

     * Requested thumbnail size new requests.

     */

    TSize iSize;

    /**

     * Requested display mode new requests.

     */

    TDisplayMode iDisplayMode;

    /**

     * Full path to object file for new requests. Should be set even

     * when file handles are used.

     */

    TFileName iFileName;

    /**

     * Full path to object to which the imported thumb is to be linked.

     */

    TFileName iTargetUri;

    /**

     * Thumbnail ID

     */   

    TThumbnailId iThumbnailId;

    /**

     * Relative thumbnail size

     */       

    TThumbnailSize iThumbnailSize;

    /**

     * MIME type

     */       

    TDataType iMimeType;

    /**

     * Image buffer used to create & set the thumbnail

     */       

    TDesC8* iBuffer;

    /**

     * Session specific request ID allocated by the client.

     */

    TThumbnailRequestId iRequestId;

    /**

     * Control flags set by the server for handling specific situations

     * (for example for distinguishing between preview thumbnails and

     * final thumbnails).

     */

    TThumbnailControlFlags iControlFlags;

    /**

     * Thumbnail's modify timestamp

     */

    TInt64 iModified;

    /**

     * Thumbnail's orientation

     */

    TInt iOrientation;

    };

typedef TPckg < TThumbnailRequestParams > TThumbnailRequestParamsPckg;

typedef TPckgBuf < TThumbnailRequestParams > TThumbnailRequestParamsPckgBuf;

/**

 *  Request ID class used on the server side. Consists of a pointer to a

 *  session and a session specific ID.

 *

 *  @since S60 v5.0

 */

struct TThumbnailServerRequestId

    {

    /**

     * Default C++ constructor

     *

     * @since S60 v5.0

     */

    inline TThumbnailServerRequestId(): iSession( NULL ), iRequestId( 0 ){}

    /**

     * C++ constructor

     *

     * @since S60 v5.0

     * @param aSession Pointer to the server-side session object, which

     *                 created the request.

     * @param aRequestId Session specific request ID as allocated by the

     *                   client.

     */

    inline TThumbnailServerRequestId( CThumbnailServerSession* aSession,

        TThumbnailRequestId aRequestId ): iSession( aSession ), iRequestId(

        aRequestId ){}

    /**

     * Compare request IDs. Both session and client-side request ID must

     * match.

     *

     * @param aRequestId Another TThumbnailServerRequestId to compare to

     * @since S60 v5.0

     */

    inline TBool operator == ( const TThumbnailServerRequestId& aRequestId )

        const

        {

        return aRequestId.iSession == iSession && aRequestId.iRequestId ==

            iRequestId;

    } 

public:

    /**

     * Pointer to the server-side session object, which created the request.

     * Not own.

     */

    CThumbnailServerSession* iSession;

    /**

     * Session specific request ID as allocated by the client.

     */

    TThumbnailRequestId iRequestId;

};

/**

 *  Client-server message IDs

 *

 *  @since S60 v5.0

 *  Start from 0 so that TPolicy range matches to function count.

 */

enum TThumbnailServerRequest

    {

    /**

     * Thumbnail request using file path. A TThumbnailRequestParams

     * struct is passed as a parameter.

     * @see TThumbnailRequestParams

     */

    ERequestThumbByPathAsync = 0, 

    /**

     * Thumbnail request using file path. A TThumbnailRequestParams

     * struct is passed as a parameter as well as the file handle using

     * TransferToServer()/AdoptFromClient().

     * @see TThumbnailRequestParams

     */

    ERequestThumbByFileHandleAsync,

    /**

     * Release a bitmap after the client callback has returned. Bitmap

     * handle is passed as a parameter.

     */

    EReleaseBitmap, 

    /**

     * Cancel a thumbnail request. Session specific request ID is passed

     * as a parameter.

     */

    ECancelRequest, 

    /**

     * Change the priority of a thumbnail request. Session specific request

     * ID and new priority value are passed as parameters.

     */

    EChangePriority, 

    /**

     * Create thumbnails for a file. File path is passed as a

     * parameter.

     */

    ECreateThumbnails, 

    /**

     * Delete existing thumbnails for a file. File path is passed as a

     * parameter.

     */

    EDeleteThumbnails, 

    /**

     * Get the required size (in characters) for a buffer that contains the

     * list of supported MIME types. Size in integers is returned in the

     * first parameter.

     */

    EGetMimeTypeBufferSize, 

    /**

     * Get the list of supported MIME types and store them as the first

     * parameter. The first parameter should be allocated by the client

     * to be large enough (using EGetMimeTypeBufferSize).

     */

    EGetMimeTypeList,

    /**

     * Thumbnail request using ID. 

     */    

    ERequestThumbByIdAsync,

    ERequestThumbByBufferAsync,

    /**

     * Request to set thumbnail created from buffered image

     */        

    ERequestSetThumbnailByBuffer,

    /**

     * Delete existing thumbnails. Id as parameter.

     */

    EDeleteThumbnailsById,

    EReserved1,

    /**

     * Update thumbnails by given Id.

    */

    EUpdateThumbnails,

    /**

     * Request to set thumbnail created from given bitmap

     */        

    ERequestSetThumbnailByBitmap,

    /**

     * Do not remove and keep as last item! Holds count of functions supported.

     */        

    EThumbnailServerRequestCount

   };

/**

 *  Thumbnail format in storage

 *

 *  @since S60 v5.0

 */

enum TThumbnailFormat

    {

	/**

	* Symbian internal bitmap format, usually as extranlized BLOB in the db.

	*/

    EThumbnailFormatFbsBitmap,

	/**

	* Stantard JPEG

	*/

    EThumbnailFormatJpeg

    };

struct TThumbnailDatabaseData

    {

public:

    /**

    * Full path to object to which the imported thumb is to be linked.

    */

    TPath iPath;

    /**

    * Thumbnail ID

    */      

    TInt iTnId;

    /**

    * Requested thumbnail size new requests.

    */

    TInt iSize;

    /**

    * type of data

    */ 

    TInt iFormat;

    /**

    * Path for the thumbnails

    */  

    TPath iTnPath;

    /**

    * Data if bitmap

    */  

    CFbsBitmap* iBlob;

    /**

    * Data if jpeg

    */

    TDesC8* iData;

   /**

    * Width of thumbnail

    */  

    TInt iWidth;

    /**

    * Height of thumbnail

    */  

    TInt iHeight;

    /**

    * Original width of thumbnail

    */  

    TInt iOrigWidth;

    /**

    * Original height of thumbnail

    */  

    TInt iOrigHeight;

    /**

    * flags

    */  

    TInt iFlags;

    /**

    * videoposition

    */

    TInt iVideoPosition;

    /**

    * thumb oritentation

    */  

    TInt iOrientation;

    /**

    * Thumb created from associated path

    */  

    TInt iThumbFromPath;

    /**

    * last modified

    */

    TInt64 iModified;

    };

/**

 *  MDS query modes used during thumbnail generation

 *

 *  @since S60 v5.0

 */

enum TMDSQueryType

    {

    /**

     * Query Id by Path

     */

    EId,

    /**

     * Query Path by Id

     */

    EURI

    };