1 /*

     2 * Copyright (c) 2004-2006 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:  Remote video handling class.

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef MVTENGDRAW_H

    21 #define MVTENGDRAW_H

    22 

    23 // INCLUDE

    24 

    25 #include <e32base.h>

    26 

    27 // FORWARD

    28 

    29 class MDisplaySink;

    30 class MDisplaySinkObserver;

    31 class TVtEngRenderConfig;

    32 

    33 /**

    34 *  Drawer API.

    35 *

    36 *  @lib videoteleng.lib

    37 *  @since Series 60 3.2

    38 */

    39 NONSHARABLE_CLASS( MVtEngDraw )

    40     {

    41     public:

    42 

    43        /**

    44         * Base construction for derived classes.

    45         */

    46         virtual void BaseConstructL() = 0;

    47 

    48         /**

    49         * Instantiates display sink.

    50         */

    51         virtual MDisplaySink* CreateSinkL() = 0;

    52 

    53         /**

    54         * Refresh view.

    55         */

    56         virtual void BaseRefreshL() = 0;

    57 

    58         /**

    59         * Updates the target bitmaps and/or displaymode

    60         * and/or the sizes of bitmaps

    61         */

    62         virtual void BaseRefreshBitmapsL() = 0;

    63 

    64         /**

    65         * DoCancel method for inherited classes.

    66         */

    67         virtual void BaseDoCancel() = 0;

    68 

    69         /**

    70         * Configuration verifying routine for derived classes. If

    71         * new configuration is not supported, then may this method

    72         * leaves with appropriate error code.

    73         */

    74         virtual void BaseVerifyConfigL() = 0;

    75 

    76         /**

    77         * Called when DSA calls Restart() to start drawing again.

    78         */

    79         virtual void BaseRestartL() = 0;

    80 

    81         /**

    82         * Called when DSA calls AbortNow() to stop drawing.

    83         */

    84         virtual void BaseAbortNow() = 0;

    85 

    86         /**

    87         * Starts rendering.

    88         */

    89         virtual void BaseStartDrawL() = 0;

    90 

    91         /**

    92         * Stops rendering.

    93         */

    94         virtual void BaseStopDraw() = 0;

    95 

    96         /**

    97         * Sets configuration.

    98         */

    99         virtual void BaseSetConfigL( const TVtEngRenderConfig& aConfig ) = 0;

   100 

   101         /**

   102         * Called when UI foreground status changes.

   103         */

   104         virtual void BaseSetUIForegroundL( TBool aForeground ) = 0;

   105 

   106         /**

   107         * Called when incoming video frame size changes.

   108         */

   109         virtual void BaseVideoFrameSizeChangedL( const TSize& aTo ) = 0;

   110         

   111         /**

   112         * Request update last remote video frame through MVtEngFrameObserver::vtSetFrame.

   113         */

   114         virtual void BaseRequestLastFrame() = 0;        

   115 

   116     protected:

   117 

   118         /**

   119         * Returns current configuration settings.

   120         */

   121         virtual TVtEngRenderConfig& Config() = 0;

   122 

   123     };

   124 

   125 /**

   126 * Remote drawer factory.

   127 *

   128 *  @lib videoteleng.lib

   129 *  @since Series 60 3.2

   130 */

   131 class VtEngDrawFactory

   132     {

   133     public:

   134         /**

   135         * Factory method for creating drawer

   136         * @param aObserver a callback interface

   137         */

   138         static MVtEngDraw* CreateDrawerL( MDisplaySinkObserver* aObserver, TBool );

   139     };

   140 

   141 #endif // MVTENGDRAW_H