1 /*

     2 * Copyright (c) 2006-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 the License "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:    Thumbnail generation for IPTV, using S60 Thumbnail Engine or*

    15 */

    16 

    17 

    18 

    19 

    20 #ifndef CIPTVTHUMBNAILGENERATOR_H

    21 #define CIPTVTHUMBNAILGENERATOR_H

    22 

    23 #include <e32base.h>

    24 

    25 class MIptvThumbnailObserver;

    26 

    27 /**

    28 *  Thumbnail generation for IPTV

    29 *

    30 *  @lib    IptvUtil

    31 *  @since  S60 v3.1

    32 */

    33 class CIptvThumbnailGenerator : public CActive

    34     {

    35 public:

    36     /**

    37     *  Two-phased constructor

    38     *  

    39     *  @param  aObserver  Observer to receive thumbnail generation notifications

    40     *  @param  aPriority  Priority to be given to actual thumbnail generation, as

    41     *                     defined by CActive::TPriority

    42     */

    43     IMPORT_C static CIptvThumbnailGenerator* NewL( MIptvThumbnailObserver& aObserver, TInt aPriority );

    44 

    45     /**

    46     *  Two-phased constructor

    47     *  

    48     *  @param  aObserver  Observer to receive thumbnail generation notifications

    49     *  @param  aPriority  Priority to be given to actual thumbnail generation, as

    50     *                     defined by CActive::TPriority

    51     */

    52     IMPORT_C static CIptvThumbnailGenerator* NewLC( MIptvThumbnailObserver& aObserver, TInt aPriority );

    53 

    54     /**

    55     *  Requests thumbnail generation

    56     *  

    57     *  Thumbnail generation completation and failures are notified by the registered observer

    58     *  

    59     *  @param  aClipFilename  Filename for source .3gp/.mp4 video clip

    60     *  @param  aThumbnailFilename Filename for .jpg thumbnail to be generated

    61     *  @param  aResolution Size for generated thumbnail

    62     */

    63     virtual void GenerateThumbnailL( const TDesC& aClipFilename, const TDesC& aThumbnailFilename, const TSize aResolution ) = 0;

    64 

    65     /**

    66     *  Cancels ongoing thumbnail generation

    67     */

    68     virtual void CancelThumbnail() = 0;

    69 

    70 protected:

    71     /**

    72     *  C++ constructor

    73     */

    74     CIptvThumbnailGenerator( TInt aPriority );

    75 

    76     };

    77 

    78 #endif // CIPTVTHUMBNAILGENERATOR_H