mmlibs/mmfw/tsrc/mmvalidationsuite/mmvalidationsuiteagents/src/videoplayagent.cpp
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Wed, 09 Jun 2010 11:20:54 +0300
branchRCL_3
changeset 23 545d349d14da
parent 0 40261b775718
permissions -rw-r--r--
Revision: 201021 Kit: 2010123

// Copyright (c) 2005-2009 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:
// Part of the MVS Agents for TechView
//

#ifdef SYMBIAN_BUILD_GCE
#include <videoplayer2.h>
#include <surfaceeventhandler.h>
#endif

#include "videoplayagent.h"

/**
Constructs and initialises a new instance of the MVS video play agent

This function leaves if the video play agent object cannot be created.

@param  aObserver
        A client class to receive notifications from the video player.

@return A pointer to the new video play agent object.
*/
EXPORT_C CMVSVideoPlayAgent* CMVSVideoPlayAgent::NewL(MMVSClientObserver& aObserver)
	{
	CMVSVideoPlayAgent* self = new(ELeave) CMVSVideoPlayAgent(aObserver);
	CleanupStack::PushL(self);
	self->ConstructL();
	CleanupStack::Pop(self);
	return self;
	}

void CMVSVideoPlayAgent::ConstructL()
	{
	User::LeaveIfError(iFileLogger.Connect());
    iFileLogger.CreateLog(_L("LogMVSappUi"),_L("LogFile.txt"),EFileLoggingModeAppend);
    }


/**
Destructor. Closes any open video clips and frees any resources held by the Video Player.
*/
EXPORT_C CMVSVideoPlayAgent::~CMVSVideoPlayAgent()
	{
#ifdef SYMBIAN_BUILD_GCE
    delete iVideoPlayer2;
    iVideoPlayer2 = NULL;
#endif  // SYMBIAN_BUILD_GCE
    
	delete iVideoPlayer;
	iVideoPlayer = NULL;

    if(iFileLogger.Handle())
     	{
     	iFileLogger.CloseLog();
	 	iFileLogger.Close();
     	}
     	
    iFileName.Close();
    }


CMVSVideoPlayAgent::CMVSVideoPlayAgent(MMVSClientObserver& aObserver)
    : iObserver(aObserver),
      iControllerUid(KNullUid)
	{
	}

/**
Check if CVideoPlayerUtility2 is used for current video playback.

@return ETrue if CVideoPlayerUtility2 is used for video playback.  EFalse if 
        CVideoPlayerUtility is used.
*/
EXPORT_C TBool CMVSVideoPlayAgent::SupportVideoPlayerUtility2() const
    {
    if (iCurrentVideoPlayer == NULL)
        {            
        return EFalse;
        }
    
    if (iCurrentVideoPlayer == iVideoPlayer)
        {
        return EFalse;        
        }
        
    return ETrue;
    }

/**
Set the auto scale on the current video player for the specified window.

@see CVideoPlayerUtility
*/
#ifdef SYMBIAN_BUILD_GCE
EXPORT_C void CMVSVideoPlayAgent::SetAutoScaleL(RWindow& aWindow, TAutoScaleType aScaleType, TInt aHorizPos, TInt aVertPos)
	{
	iVideoPlayer2->SetAutoScaleL(aWindow, aScaleType, aHorizPos, aVertPos);
#else
EXPORT_C void CMVSVideoPlayAgent::SetAutoScaleL(RWindow& aWindow, TAutoScaleType aScaleType, TInt aHorizPos, TInt aVertPos)
	{
	User::Leave(KErrNotSupported);
#endif
	}

/**
Set the auto scale on the current video player.

@see CVideoPlayerUtility
*/
EXPORT_C void CMVSVideoPlayAgent::SetAutoScaleL(TAutoScaleType aScaleType, TInt aHorizPos, TInt aVertPos)
	{
#ifdef SYMBIAN_BUILD_GCE
	iCurrentVideoPlayer->SetAutoScaleL(aScaleType, aHorizPos, aVertPos);
#else
	// Remove warnings
	aScaleType = aScaleType;
	aHorizPos = aHorizPos;
	aVertPos = aVertPos;
	User::Leave(KErrNotSupported);
#endif
	}

/**
Video output settings, pre initialisation of all the required settings to play a 
video clip

This function leaves if the video player utility object cannot be created.

@param  aObserver
        A client class to receive notifications from the video player.
@param  aPriority
        This client's relative priority. This is a value between EMdaPriorityMin and
        EMdaPriorityMax and represents a relative priority. A higher value indicates
        a more important request.
@param  aPref
        The required behaviour if a higher priority client takes over the sound output device.
        One of the values defined by TMdaPriorityPreference.
@param  aWs
        The window server session id.
@param  aScreenDevice
        The software device screen.
@param  aWindow
        The display window.
@param  aScreenRect
        The dimensions of the display window.
@param  aClipRect
        The area of the video clip to display in the window.
*/     
EXPORT_C void CMVSVideoPlayAgent::SetVideoOutputL(RWsSession& aWs,
                                                  CWsScreenDevice& aScreenDevice,
                                                  RWindow& aWindow,
                                                  TRect& aScreenRect,
                                                  TRect& aClipRect)
	{
	iFileLogger.Write(_L("SettingVideoOutput"));

#ifdef SYMBIAN_BUILD_GCE
    // if CVideoPlayerUtility2 is available, instantiate both CVideoPlayerUtility2 &
    // CVideoPlayerUtility, as it is not clear whether the controller used for a 
    // particular media file also supports the CVideoPlayerUtility2 API until OpenFileL
    // is called.  
	if (iVideoPlayer2)
	    {
        delete iVideoPlayer2;
        iVideoPlayer2 = NULL;
	    }
	    
    iVideoPlayer2 = CVideoPlayerUtility2::NewL(*this, 
                                               EMdaPriorityNormal, 
    	                                       EMdaPriorityPreferenceNone);
#endif  // SYMBIAN_BUILD_GCE

	if (iVideoPlayer)
	    {
        delete iVideoPlayer;
        iVideoPlayer = NULL;
	    }	
    iVideoPlayer = CVideoPlayerUtility::NewL(*this, 
                                             EMdaPriorityNormal, 
    	                                     EMdaPriorityPreferenceNone, 
    	                                     aWs, 
    	                                     aScreenDevice,
    	                                     aWindow,
    	                                     aScreenRect,
    	                                     aClipRect);
	}

/**
Adds a new window for displaying the video picture.  This is only applicable if 
CVideoPlayerUtility2 is used.

This function leaves if the video player utility object failed to add display window or
if this function is called when CVideoPlayerUtility2 is not being used.

@param  aObserver
        A client class to receive notifications from the video player.
@param  aPriority
        This client's relative priority. This is a value between EMdaPriorityMin and
        EMdaPriorityMax and represents a relative priority. A higher value indicates
        a more important request.
@param  aPref
        The required behaviour if a higher priority client takes over the sound output device.
        One of the values defined by TMdaPriorityPreference.
@param  aWs
        The window server session id.
@param  aScreenDevice
        The software device screen.
@param  aWindow
        The display window.
@param  aScreenRect
        The dimensions of the display window.
@param  aClipRect
        The area of the video clip to display in the window.
@leave  KErrNotSupported if CVideoPlayerUtility2 is not the current video utility in use
@see    CVideoPlayerUtility2::AddDisplayWindowL       
*/     
#ifdef SYMBIAN_BUILD_GCE
EXPORT_C void CMVSVideoPlayAgent::AddDisplayWindowL(RWsSession& aWs,
                                                    CWsScreenDevice& aScreenDevice,
                                                    RWindow& aWindow,
                                                    const TRect& aScreenRect,
                                                    const TRect& aClipRect)
#else
EXPORT_C void CMVSVideoPlayAgent::AddDisplayWindowL(RWsSession& /* aWs */,
                                                    CWsScreenDevice& /* aScreenDevice */,
                                                    RWindow& /* aWindow */,
                                                    const TRect& /* aScreenRect */,
                                                    const TRect& /* aClipRect */)
#endif  // SYMBIAN_BUILD_GCE
    {
#ifdef SYMBIAN_BUILD_GCE
    if (SupportVideoPlayerUtility2())
        {
        iVideoPlayer2->AddDisplayWindowL(aWs, 
                                         aScreenDevice, 
                                         aWindow, 
                                         aScreenRect,
                                         aClipRect);
        iWindow = &aWindow;

#ifdef SYMBIAN_MULTIMEDIA_SUBTITLE_SUPPORT
        if (iEnableSubtitlesOnAdd)
        	{
        	iVideoPlayer2->EnableSubtitlesL();
        	iEnableSubtitlesOnAdd = EFalse;
        	}
#endif //SYMBIAN_MULTIMEDIA_SUBTITLE_SUPPORT
        
        return;
        }
#endif  // SYMBIAN_BUILD_GCE        
    User::Leave(KErrNotSupported);
    }

#ifdef SYMBIAN_BUILD_GCE
EXPORT_C void CMVSVideoPlayAgent::AddDisplayWindowL(RWsSession& aWs,
                                                    CWsScreenDevice& aScreenDevice,
                                                    RWindow& aWindow)
#else
EXPORT_C void CMVSVideoPlayAgent::AddDisplayWindowL(RWsSession& /* aWs */,
                                                    CWsScreenDevice& /* aScreenDevice */,
                                                    RWindow& /* aWindow */)
#endif  // SYMBIAN_BUILD_GCE
    {
#ifdef SYMBIAN_BUILD_GCE
    if (SupportVideoPlayerUtility2())
        {
        iVideoPlayer2->AddDisplayWindowL(aWs, 
                                         aScreenDevice, 
                                         aWindow);
        iWindow = &aWindow;
        
#ifdef SYMBIAN_MULTIMEDIA_SUBTITLE_SUPPORT
        if (iEnableSubtitlesOnAdd)
        	{
        	iVideoPlayer2->EnableSubtitlesL();
        	iEnableSubtitlesOnAdd = EFalse;
        	}
#endif //SYMBIAN_MULTIMEDIA_SUBTITLE_SUPPORT
        return;
        }
#endif  // SYMBIAN_BUILD_GCE        
    User::Leave(KErrNotSupported);
    }

EXPORT_C void CMVSVideoPlayAgent::AddDisplayL(RWsSession& aWs, TInt aDisplay, MMMFSurfaceEventHandler& aEventHandler)
	{
	if (!SupportVideoPlayerUtility2())
		{
		User::Leave(KErrNotSupported);
		}
	
	iVideoPlayer2->AddDisplayL(aWs, aDisplay, aEventHandler);
	}

/**
Removes a window that is currently being used to display the video picture.

This function should only be called if CVideoPlayerUtility2 is currently being used for display 
of video.

@param  aWindow
        The window to be removed
@leave  KErrNotSupported if CVideoPlayerUtility2 is not the current video player utility.
@see    CVideoPlayerUtility2::RemoveDisplayWindow
*/                                    
EXPORT_C void CMVSVideoPlayAgent::RemoveDisplayWindowL(RWindow& aWindow)
    {
#ifdef SYMBIAN_BUILD_GCE
    if (SupportVideoPlayerUtility2())
        {
        iVideoPlayer2->RemoveDisplayWindow(aWindow);
        iWindow = NULL;        
        return;
        }
#endif  // SYMBIAN_BUILD_GCE
	// Remove compiler warning
	aWindow = aWindow;        
    User::Leave(KErrNotSupported);
    }

EXPORT_C void CMVSVideoPlayAgent::RemoveDisplay(TInt aDisplay)
	{
	if (!SupportVideoPlayerUtility2())
		{
		User::Leave(KErrNotSupported);
		}

	iVideoPlayer2->RemoveDisplay(aDisplay);
	}

/**
Opens a video clip from a file.

This function opens a video clip from a file,this function searches through a list of all available
plugins and attempts to use each one until successful or the end of the list is reached.

Once the opening of the video clip is complete, successfully or otherwise, the callback function 
CMVSVideoPlayAgent::MvpuoOpenComplete() is called.

This function leaves if errors are encountered opening the specified video clip file, or in initialising a 
specified/unspecified controller plugin.

This function can leave with one of the specified error codes. 

@param  aFileName
        The full path name of the file containing the video data.
*/
EXPORT_C void CMVSVideoPlayAgent::OpenFileL(const TDesC& aFileName)
	{
    OpenFileL(aFileName, KNullUid);                
    }

EXPORT_C void CMVSVideoPlayAgent::OpenFileL(const TDesC& aFileName, TUid aControllerUid)
	{
	iFileLogger.Write(_L("Opening a File For CMVSVideoPlayAgent "));
	
	// remembers the file name & the controller Uid used for opening file
	iFileName.Close();
	iFileName.CreateL(aFileName);
	iControllerUid = aControllerUid;

    __ASSERT_DEBUG(iVideoPlayer, User::Leave(KErrNotReady));
    iVideoPlayer->Close();	
    
#ifdef SYMBIAN_BUILD_GCE
    __ASSERT_DEBUG(iVideoPlayer2, User::Leave(KErrNotReady));
    iVideoPlayer2->Close();

    // First attempt is always to open a file with CVideoPlayerUtility2 if GCE 
    // is enabled
    iVideoPlayer2->OpenFileL(aFileName, aControllerUid);
    iCurrentVideoPlayer = iVideoPlayer2;
#else
    iVideoPlayer->OpenFileL(aFileName, aControllerUid);
    iCurrentVideoPlayer = iVideoPlayer;
#endif  // SYMBIAN_BUILD_GCE	

	// Now that we have selected the video player, we can issue the request for notification.
	if (iRequestNotify)
		{
		RegisterForNotification();
		}
	} 

EXPORT_C void CMVSVideoPlayAgent::OpenFileL(TMMSource& /*aSource*/)
	{
	}

EXPORT_C void CMVSVideoPlayAgent::OpenDesL(const TDesC8& /*aDescriptor*/)
	{
	}
		 
void CMVSVideoPlayAgent::MvpuoOpenComplete(TInt aError)
	{
	iFileLogger.Write(_L("CMVSVideoPlayAgent:MvpuoOpenComplete"));
	if(aError == KErrNone)
    	{
    	iState = EVideoOpening;
    	iFileLogger.Write(_L("MvpuoOpenComplete:VideoOpening"));
    	iObserver.UpdateStateChange(iState, KErrNone);

        iCurrentVideoPlayer->Prepare();            
    	}
#ifdef SYMBIAN_BUILD_GCE    	
    else if (iCurrentVideoPlayer == iVideoPlayer2 && aError == KErrNotSupported)
        {	
        // if the controller cannot support GS, try use CVideoPlayerUtility instead
        TRAPD(err, iVideoPlayer->OpenFileL(iFileName, iControllerUid));
        
        if (err != KErrNone)
        	{
        	iState = ENotReady; //init failed so from opening to NotReady
	     	iFileLogger.Write(_L("MvpuoOpenComplete:From Opening to  NotReady"));
	     	iObserver.UpdateStateChange(iState, err);
        	}
        
        iCurrentVideoPlayer = iVideoPlayer;
        
        // We are switching to a different controller.  Cancel the notification request on one
        // controller and reissue it on the other.
		if (iRequestNotify)
			{
			iVideoPlayer2->CancelRegisterAudioResourceNotification(KMMFEventCategoryAudioResourceAvailable);
			RegisterForNotification();
			}
        }
#endif  // SYMBIAN_BUILD_GCE    	        
    else            
		{
     	iState = ENotReady; //init failed so from opening to NotReady
     	iFileLogger.Write(_L("MvpuoOpenComplete:From Opening to  NotReady"));
     	iObserver.UpdateStateChange(iState, aError);
		}
	}

void CMVSVideoPlayAgent::MvpuoPrepareComplete(TInt aError)
	{
	iFileLogger.Write(_L("CMVSVideoPlayAgent:MvpuoPrepareComplete"));
	if(aError == KErrNone)
    	{
    	iState = EVideoOpened;
        iFileLogger.Write(_L("MvpuoPrepareComplete:Video Opened"));
    	}
    else
		{
     	iState = ENotReady; //prepare failed so from preparing to NotReady
     	iFileLogger.Write(_L("MvpuoPrepareComplete failed : from preparing to NotReady")) ;
		}
	iObserver.UpdateStateChange(iState, aError);
	}

void CMVSVideoPlayAgent::MvpuoPlayComplete(TInt aError)
	{
	if(aError == KErrNone)
    	{
    	iState = EVideoOpened;
    	iFileLogger.Write(_L("MvpuoPlayComplete:Video Opened"));
    	}
    else
		{
     	iState = ENotReady; //playcomplete failed so from playcomplete to NotReady
     	iFileLogger.Write(_L("MvpuoPlayComplete failed : from playcomplete to NotReady")) ;
		}
	iObserver.UpdateStateChange(iState, aError);
	}

void CMVSVideoPlayAgent::MvpuoFrameReady(class CFbsBitmap&, TInt)
	{
	}

void CMVSVideoPlayAgent::MvpuoEvent(const TMMFEvent& /*aEvent*/)
	{	
	}	
	
void CMVSVideoPlayAgent::MarncResourceAvailable(TUid aNotificationEventId, const TDesC8& aNotificationData)
	{
	if(aNotificationEventId == KMMFEventCategoryAudioResourceAvailable)
		{
		iObserver.MvsResourceNotification(aNotificationData);
		}
	}
	
EXPORT_C void CMVSVideoPlayAgent::Prepare()
	{	
    iCurrentVideoPlayer->Prepare();	
	}


/**
Closes the video clip.
Updates the state to ENotReady after closing
*/
EXPORT_C void CMVSVideoPlayAgent::Close()
	{
	iFileLogger.Write(_L("CMVSVideoPlayAgent Closed"));
	
#ifdef SYMBIAN_BUILD_GCE
    if (SupportVideoPlayerUtility2())
        {            	
        // Can't leave at this point, this will just remove the leave scan warning
        TRAP_IGNORE(RemoveDisplayWindowL(*iWindow));
        iVideoPlayer2->Close();
        }
#endif  // SYMBIAN_BUILD_GCE
    iVideoPlayer->Close();
    
	iObserver.UpdateStateChange(ENotReady, KErrNone);
    iCurrentVideoPlayer = NULL;	
	}


/**
Begins playback of the initialised video sample at the current volume and priority levels.

When playing of the video sample is complete, successfully or otherwise, the callback function
CMVSVideoPlayAgent::MvpuoPlayComplete() is called.Updates the current state to EVideoPlaying,
and once playing is over it updates the state to EVideoOpen.
*/
EXPORT_C void CMVSVideoPlayAgent::Play()
	{
    iCurrentVideoPlayer->Play();

	iState = EVideoPlaying;
	iObserver.UpdateStateChange(iState, KErrNone);
	}


/**
Begins playback of the initialised video sample at the specified start and end points.

When playing of the video sample is complete, successfully or otherwise, the callback function
CMVSVideoPlayAgent::MvpuoPlayComplete() is called.Updates the current state to EVideoPlaying,
and once playing is over it updates the state to EVideoOpen.

@param  aStartTime
        The point at which to start playback.
@param  aEndTime
        The point at which to terminate playback.
*/
EXPORT_C void CMVSVideoPlayAgent::Play(const TTimeIntervalMicroSeconds& aStartPoint, 
                                       const TTimeIntervalMicroSeconds& aEndPoint)
	{
    iCurrentVideoPlayer->Play(aStartPoint, aEndPoint);

	iState = EVideoPlaying;
	iObserver.UpdateStateChange(iState, KErrNone);
	}


/**
Stops playback of the video sample as soon as is possible. 

If the video sample is playing, playback is stopped as soon as possible and the callback function 
CMVSVideoPlayAgent::MvpuoPlayComplete() is called.

If playback is already complete, this function has no effect. In addition, under these circumstances 
the callback function CMVSVideoPlayAgent::MvpuoPlayComplete() is not called either.

The position is reset to the beginning of the file.

@return An error code indicating if the function call was successful. KErrNone on success, otherwise
        another of the system-wide error codes.
Also Updates the state to EVideoStopped
*/
EXPORT_C TInt CMVSVideoPlayAgent::Stop()
	{
	TInt err = KErrNotReady;
    if (iCurrentVideoPlayer)
		{
		err = iCurrentVideoPlayer->Stop();
		}

	if (err == KErrNone)
		{
		iState = EVideoStopped;
		iFileLogger.Write(_L("CMVSVideoPlayAgent Stopped"));
		}
	else
		{
		iState = ENotReady;
		}
    iObserver.UpdateStateChange(iState, err);
    
    return err;
	}


/**
Video playback is paused. The current position is maintained and playback can be
resumed by calling Play.
*/
EXPORT_C void CMVSVideoPlayAgent::PauseL()
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));		
	
    TRAPD(err, iCurrentVideoPlayer->PauseL());
	if(err == KErrNone)
		{
		iState = EVideoPaused;
		iFileLogger.Write(_L("CMVSVideoPlayAgent Paused "));
		}
	else
		{
		iState = ENotReady;
		iFileLogger.Write(_L("CMVSVideoPlayAgent Not Ready"));	
		}	
	iObserver.UpdateStateChange(iState, err);
	}
	

/**
Sends custom command to the plugin controller.
Passes handle and size of the drawable window.

Sets the display window. This is used to provide the video controller with an area of
the display to render the current video frame.

@param  aWs
        The window server session ID.
@param  aScreenDevice
        The software device screen.
@param  aWindowRect
        The window to display.
@param  aScreenRect
        The dimensions of the display window.
@param  aClipRect
        The area of the video clip to display in the window.
*/	
EXPORT_C void CMVSVideoPlayAgent::SetDisplayWindowL(RWsSession &aWs, CWsScreenDevice &aScreenDevice, RWindow &aWindow, const TRect &aWindowRect, const TRect &aClipRect)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));		
	
	iFileLogger.Write(_L("SettingDisplayWindow"));	
    iCurrentVideoPlayer->SetDisplayWindowL(aWs, aScreenDevice, aWindow, aWindowRect, aClipRect);
	}
	

/**
Sets the video frame rate.

@param  aFramesPerSecond
        The number of frames per second to request.
*/
EXPORT_C void CMVSVideoPlayAgent::SetVideoFrameRateL(TReal32 aFramesPerSecond)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));		
	
	iFileLogger.Write(_L("SettingVedioFrameRate "));
    iCurrentVideoPlayer->SetVideoFrameRateL(aFramesPerSecond);
	}


/**
Sets the playback volume for the audio track of the video clip.

The volume can be changed before or during playback and is effective immediately. The volume can
be set to any value between zero (mute) and the maximum permissible volume
(determined using MaxVolume()).

To determine if the current video clip contains an audio track, use AudioEnabledL().


@param  aVolume
        The volume, between 0 and MaxVolume().
*/
EXPORT_C void CMVSVideoPlayAgent::SetVolumeL(TInt aVolume)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));			
	
	iFileLogger.Write(_L("Setting CMVSVideoPlayAgent's Volume "));
	iCurrentVideoPlayer->SetVolumeL(aVolume);
	}
	

/**
Sets the current playback balance for the audio track of the video clip.

The balance can be any value between KMMFBalanceMaxLeft and KMMFBalanceMaxRight,
the default value being KMMFBalanceCenter.

@param  aBalance
        The balance value to set.
*/
EXPORT_C void CMVSVideoPlayAgent::SetBalanceL(TInt aBalance)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));				
	
	iFileLogger.Write(_L("Setting CMVSVideoPlayAgent's Balance"));
	iCurrentVideoPlayer->SetBalanceL(aBalance);
	}
	

/**
Sets the playback priority. 

This is used to arbitrate between multiple objects simultaneously trying to accesses
the sound hardware.

@param  aPriority
        The priority level to apply, EMdaPriorityMin client can be interrupted by any other 
        client, EMdaPriorityNormal client can only be interrupted by a client with a higher 
        priority or EMdaPriorityMax client cannot be interrupted by other clients.
@param  aPref
        The time and quality preferences to apply, enumerated in TMdaPriorityPreference.
*/
EXPORT_C void CMVSVideoPlayAgent::SetPriorityL(TInt aPriority, TMdaPriorityPreference aPref)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));				
	
	iFileLogger.Write(_L("Setting Priority of CMVSVideoPlayAgent"));
	iCurrentVideoPlayer->SetPriorityL(aPriority, aPref);
	}
	

/**
Sets the position within the video clip from where to start playback.

@param  aPosition
        Position from start of clip in microseconds.
*/
EXPORT_C void CMVSVideoPlayAgent::SetPositionL(const TTimeIntervalMicroSeconds &aPosition)
    {
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));					

    iFileLogger.Write(_L("Setting Position of CMVSVideoPlayAgent"));
    iCurrentVideoPlayer->SetPositionL(aPosition);
    }
	

/**
Rotates the video image on the screen.

@param  aRotation
        The desired rotation to apply in 90 degree increments.
*/
EXPORT_C void CMVSVideoPlayAgent::SetRotationL(TVideoRotation aRotation)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));					
		
	iFileLogger.Write(_L("Setting Rotations of CMVSVideoPlayAgent"));
    iCurrentVideoPlayer->SetRotationL(aRotation);
	}
	


/**
Scales the video image to a specified percentage of its original size.

@param  aWidthPercentage
        The percentage (100 = original size) to be used to scale the width of the video image
@param  aHeightPercentage
        The percentage (100 = original size) to be used to scale the height of the video image. 
        If this is not equal to aWidthPercentage then the image may be distorted.
@param  aAntiAliasFiltering
        A boolean specifying if anti-aliasing should be used. True if anti-aliasing filtering 
        should be used.  If the plugin does not	support this kind of processing, 
        this value will be ignored.
*/
EXPORT_C void CMVSVideoPlayAgent::SetScaleFactorL(TReal32 aWidthPercentage, TReal32 aHeightPercentage, TBool aAntiAliasFiltering)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));					
		
	iFileLogger.Write(_L("Setting ScaleFactor of CMVSVideoPlayAgent"));
	iCurrentVideoPlayer->SetScaleFactorL(aWidthPercentage, aHeightPercentage, aAntiAliasFiltering);
	}


/**
Selects a region of the video image to be displayed.

@param  aCropRegion
        The dimensions of the crop region, relative to the video image.
@see   GetCropRegionL
*/
EXPORT_C void CMVSVideoPlayAgent::SetCropRegionL(const TRect& aCropRegion)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));					
	
	iFileLogger.Write(_L("Setting CorpRegion of CMVSVideoPlayAgent"));
    iCurrentVideoPlayer->SetCropRegionL(aCropRegion);
	}

/**
Selects the video extent on the screen, relative to the window.

@param  aVideoExtent
        The new video extent, relative to the window
@leave  KErrNotSupport if CVideoPlayerUtility is used for video playback
*/
#ifdef SYMBIAN_BUILD_GCE
EXPORT_C void CMVSVideoPlayAgent::SetVideoExtentL(const TRect& aVideoExtent)
#else
EXPORT_C void CMVSVideoPlayAgent::SetVideoExtentL(const TRect& /* aVideoExtent */)
#endif  // SYMBIAN_BUILD_GCE
	{
	iFileLogger.Write(_L("Setting VideoExtent of CMVSVideoPlayAgent"));
	
#ifdef SYMBIAN_BUILD_GCE	
	if(SupportVideoPlayerUtility2())
		{
		if (iWindow)
		    {		        
		    iVideoPlayer2->SetVideoExtentL(*iWindow, aVideoExtent);
		    }            		    
        else 
            {
		    iFileLogger.Write(_L("WARNING - Display Window has not been set.  Caller should save these values to be set again later."));
            }
		return;
		}
#endif  // SYMBIAN_BUILD_GCE		

	User::Leave(KErrNotSupported);
	}

/**
Selects the window clipping rectangle, relative to the window

@param  aWindowClipRect
        The new window clipping rectangle, relative to the window
@leave  KErrNotSupport if CVideoPlayerUtility is used for video playback
*/
#ifdef SYMBIAN_BUILD_GCE
EXPORT_C void CMVSVideoPlayAgent::SetWindowClipRectL(const TRect& aWindowClipRect)
#else
EXPORT_C void CMVSVideoPlayAgent::SetWindowClipRectL(const TRect& /* aWindowClipRect */)
#endif  // SYMBIAN_BUILD_GCE
	{
    iFileLogger.Write(_L("Setting WindowClippingRect of CMVSVideoPlayAgent"));
	
#ifdef SYMBIAN_BUILD_GCE
    if (SupportVideoPlayerUtility2())
        {            	
        if (iWindow)
            {                
            iVideoPlayer2->SetWindowClipRectL(*iWindow, aWindowClipRect);	
            }
        else 
            {
		    iFileLogger.Write(_L("WARNING - Display Window has not been set.  Caller should save these values to be set again later."));
            }
        return;
        }
#endif  // SYMBIAN_BUILD_GCE        														

    User::Leave(KErrNotSupported);
	}


/**
Gets the current frame. The current frame is requested, and will be sent to
the client asynchrynously.

@param  aDisplayMode
        The display mode for the retrieved frame.
*/
EXPORT_C void CMVSVideoPlayAgent::GetFrameL(TDisplayMode aDisplayMode)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));						
	iCurrentVideoPlayer->GetFrameL(aDisplayMode);
	}


/**
Gets the current frame. The current frame is requested, and will be sent to
the client asynchrynously.

@param  aDisplayMode
        The display mode for the retrieved frame.
@param  aIntent
        The DRM Intent to pass to the controller.
*/
EXPORT_C void CMVSVideoPlayAgent::GetFrameL(TDisplayMode aDisplayMode, ContentAccess::TIntent aIntent)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));							
	iCurrentVideoPlayer->GetFrameL(aDisplayMode, aIntent);
	}


/**
Returns the video frame rate in frames/second.

@return The video frame rate (frames/second).
*/
EXPORT_C TReal32 CMVSVideoPlayAgent::VideoFrameRateL()
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));							
	
	iFileLogger.Write(_L("Getting VideoFrameRate for CMVSVideoPlayAgent"));
	return iCurrentVideoPlayer->VideoFrameRateL();
	}


/**
Gets the video frame size.

@param  aSize
        The video frame size
*/
EXPORT_C void CMVSVideoPlayAgent::VideoFrameSizeL(TSize &aSize) 
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));								
	
	iFileLogger.Write(_L("Getting VideoFrameFrameSize for CMVSVideoPlayAgent"));	
	iCurrentVideoPlayer->VideoFrameSizeL(aSize);
	}


/**
Returns the video format's MIME type.

@return The video clip's MIME type.
*/
EXPORT_C const TDesC8& CMVSVideoPlayAgent::VideoFormatMimeType() 
	{
    if (iCurrentVideoPlayer)
        {
	    return iCurrentVideoPlayer->VideoFormatMimeType();            
        }
    else 
        {            
        return KNullDesC8;								
        }
	}


/**
Returns the video bit rate.

@return The video bit rate in bits/second.
*/
EXPORT_C TInt CMVSVideoPlayAgent::VideoBitRateL() 
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));									
	
	iFileLogger.Write(_L("Getting VideoBitRate for CMVSVideoPlayAgent"));
	return iCurrentVideoPlayer->VideoBitRateL();
	}


/**
Returns the audio bit rate in bits/second.

@return The audio bit rate (bits/second).
*/
EXPORT_C TInt CMVSVideoPlayAgent::AudioBitRateL()
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));									
		
	iFileLogger.Write(_L("Getting AudioBitRate for CMVSVideoPlayAgent"));	
	return iCurrentVideoPlayer->AudioBitRateL();
	}


/**
Returns the codec used for the audio component of the video clip.

@return The four character code representing the audio codec.
*/
EXPORT_C TFourCC CMVSVideoPlayAgent::AudioTypeL()
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));										
	
	iFileLogger.Write(_L("Getting AudioType for CMVSVideoPlayAgent"));
	return iCurrentVideoPlayer->AudioTypeL();
	}


/**
Returns whether the current clip has an audio stream.

@return Boolean indication the presence of an audio stream. ETrue if an audio track is present,
        otherwise EFalse.
*/
EXPORT_C TBool CMVSVideoPlayAgent::AudioEnabledL() 
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));
	
	iFileLogger.Write(_L("CMVSVideoPlayAgent's Audio Enabled"));
	return iCurrentVideoPlayer->AudioEnabledL();
	}


/**
Returns the current playback position.

@return The current position from the start of the clip in microseconds.
*/
EXPORT_C TTimeIntervalMicroSeconds CMVSVideoPlayAgent::PositionL() 
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));
	return iCurrentVideoPlayer->PositionL();
	}


/**
Returns the duration of video clip in mircoseconds.

@return The duration of clip in microseconds.
*/
EXPORT_C TTimeIntervalMicroSeconds CMVSVideoPlayAgent::DurationL() 
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));	
	return iCurrentVideoPlayer->DurationL();
	}


/**
Returns the current playback volume for the audio track of the video clip.

@return A value between 0 (mute) and the maximum volume returned by MaxVolume().
*/
EXPORT_C TInt CMVSVideoPlayAgent::Volume() 
	{
	return iCurrentVideoPlayer->Volume();
	}


/**
Get the current playback priority. This is used to arbitrate between simultaneous accesses of
the sound hardware.

@param  aPriority
        On return, contains the priority level, EMdaPriorityMin client can be interrupted by any
        other client, EMdaPriorityNormal client can only be interrupted by a client with a higher 
        priority or EMdaPriorityMax client cannot be interrupted by other clients.
@param  aPref
        On return, contains the time and quality preferences, enumerated in TMdaPriorityPreference.
*/
EXPORT_C void CMVSVideoPlayAgent::PriorityL(TInt &aPriority, TMdaPriorityPreference &aPref) 
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));		
	iCurrentVideoPlayer->PriorityL(aPriority, aPref);
	}


/**
Returns the current balance setting for the audio track of the video clip.

@return A balance value between KMMFBalanceMaxLeft and KMMFBalanceMaxRight.
*/
EXPORT_C TInt CMVSVideoPlayAgent::Balance() 
	{
	return iCurrentVideoPlayer->Balance();	
	}

	
/**
Query the rotation that is currently applied to the video image.

@return The applied rotation

@see   SetRotationL
*/
EXPORT_C TVideoRotation CMVSVideoPlayAgent::RotationL() 
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));		
	return iCurrentVideoPlayer->RotationL();
	}


/**
Gets the scale factor currently applied to the video image.

@param  aWidthPercentage
        On function return, contains the current scaling percentage applied to the width of the
        video image (100 = original size).
@param  aHeightPercentage
        On function return, contains the current scaling percentage applied to the height of the
        of the video image (100 = original size).
@param  aAntiAliasFiltering
        The boolean specifying if anit-aliasing is being used.
@see    SetScaleFactorL
*/
EXPORT_C void CMVSVideoPlayAgent::GetScaleFactorL(TReal32 &aWidthPercentage, TReal32 &aHeightPercentage, TBool &aAntiAliasFiltering) 
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));		
	iCurrentVideoPlayer->GetScaleFactorL(aWidthPercentage, 
	                                     aHeightPercentage, 
	                                     aAntiAliasFiltering);
	}


/**
Gets the crop region currently applied to the image.

@param  aCropRegion
        The dimensions of the crop region, relative to the video image. If no
        crop region has been applied, the full dimensions of the video image will
        be returned.

@see   SetCropRegionL
*/
EXPORT_C void CMVSVideoPlayAgent::GetCropRegionL(TRect &aCropRegion) 
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));		
	iCurrentVideoPlayer->GetCropRegionL(aCropRegion);
	}


/**
Returns the number of meta data entries associated with this clip.

@return The number of meta data entries.
*/
EXPORT_C TInt CMVSVideoPlayAgent::NumberOfMetaDataEntriesL()
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));		
    return iCurrentVideoPlayer->NumberOfMetaDataEntriesL();
	}


/**
Returns an array containing the MetaDataEntry for the given audio clip

@param  aMetaData
        The meta data Array

@leave	Leaves with KErrNotFound if the meta data entry does not exist or
		KErrNotSupported if the controller does not support meta data 
		information for this format. Other errors indicate more general system
		failure.
*/
EXPORT_C void  CMVSVideoPlayAgent::GetMetaDataArrayL(RPointerArray<CMMFMetaDataEntry>& aMetaData)
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));		
	
	//Reset the meta array
    aMetaData.Reset();        
    TInt entries = NumberOfMetaDataEntriesL();
       
    CMMFMetaDataEntry* entry = NULL;        
  	for(TInt index= 0; index < entries; ++index)
		{
        entry = iCurrentVideoPlayer->MetaDataEntryL(index);
		aMetaData.Append(entry);        
        }
	}

/**
Returns the controller implementation information associated with the current controller.

@return The controller implementation structure
*/	
EXPORT_C const CMMFControllerImplementationInformation& CMVSVideoPlayAgent::ControllerImplementationInformationL()
	{
    __ASSERT_DEBUG(iCurrentVideoPlayer, User::Leave(KErrNotReady));		
    	
	iFileLogger.Write(_L("Getting the ControllerImplementationInformation of CMVSVideoPlayAgent")) ;
    return iCurrentVideoPlayer->ControllerImplementationInformationL();
	}


/**
Returns the current state of the CMVSAudioPlayAgent.

@return The current state, iState.
*/
EXPORT_C TMVSState CMVSVideoPlayAgent::GetState()
	{
	return iState;
	}

/**
Sets the specified output screen to render the video.

@return KErrNone,on success else any of the system wide error code.
*/
EXPORT_C TInt CMVSVideoPlayAgent::SetScreenNumber(TInt aScreenNumber)
	{
	TInt err = KErrNone;
	
    if (!iCurrentVideoPlayer)
        {
        err = iVideoPlayer->SetInitScreenNumber(aScreenNumber);
        }
    else
    	{
    	err = iCurrentVideoPlayer->SetInitScreenNumber(aScreenNumber);
    	}
    
    if (err == KErrNone)
		{
	    iScreenNumber = aScreenNumber;
		}
		
    return err;
	}

/**
Registers for audio resource notification.

@return KErrNone,on success else any of the system wide error code.
*/
EXPORT_C TInt CMVSVideoPlayAgent::RegisterForNotification()
	{
	if (!iCurrentVideoPlayer)
	    {
        // Set the request notify flag.  When we select which video player we are using we
	    // will issue the request for notification.
	    iRequestNotify = ETrue;
        return KErrNone;			        
	    }
	
    return iCurrentVideoPlayer->RegisterAudioResourceNotification(*this, KMMFEventCategoryAudioResourceAvailable);
	}

/**
Cancels any existing registeration to audio resource notification.

@return KErrNone,on success else any of the system wide error code.
*/	
EXPORT_C TInt CMVSVideoPlayAgent::CancelNotification()
	{
	if (!iCurrentVideoPlayer)
	    {
	    iRequestNotify = EFalse;
        return KErrNone;
	    }
	
    return iCurrentVideoPlayer->CancelRegisterAudioResourceNotification(KMMFEventCategoryAudioResourceAvailable);
	}
	
EXPORT_C TInt CMVSVideoPlayAgent::WillResumePlay()
	{
	if (!iCurrentVideoPlayer)
	    {
        return KErrNotReady;			        
	    }
    return iCurrentVideoPlayer->WillResumePlay();
	}

/**
Returns an integer representing the maximum volume that the audio track can support.

This is the maximum value that can be passed to SetVolumeL(). This value is platform 
independent, but is always greater than or equal to one.

@return The maximum playback volume.
*/
EXPORT_C TInt CMVSVideoPlayAgent::MaxVolume() 
    {
	if (!iCurrentVideoPlayer)
	    {
        return iVideoPlayer->MaxVolume();
	    }
	
    return iCurrentVideoPlayer->MaxVolume();
    }
    
#ifdef SYMBIAN_MULTIMEDIA_SUBTITLE_SUPPORT
EXPORT_C void CMVSVideoPlayAgent::EnableSubtitlesL()
	{
	__ASSERT_DEBUG(iVideoPlayer2, User::Leave(KErrNotReady));
	
	if (iWindow)
		{
		iVideoPlayer2->EnableSubtitlesL();
		}
	else
		{
		iEnableSubtitlesOnAdd = ETrue;
		}
	}

EXPORT_C void CMVSVideoPlayAgent::DisableSubtitlesL()
	{
	__ASSERT_DEBUG(iVideoPlayer2, User::Leave(KErrNotReady));
	iVideoPlayer2->DisableSubtitles();
	iEnableSubtitlesOnAdd = EFalse;
	}

EXPORT_C TBool CMVSVideoPlayAgent::SubtitlesAvailable()
	{
	if (iVideoPlayer2)
		{
		return iVideoPlayer2->SubtitlesAvailable();
		}
	
	return EFalse;
	}

EXPORT_C void CMVSVideoPlayAgent::RenderSubtitle(const TRect& aRect)
	{
	if (iVideoPlayer2)
		{
		iVideoPlayer2->RedrawSubtitle(*iWindow, aRect);
		}
	}

#endif //SYMBIAN_MULTIMEDIA_SUBTITLE_SUPPORT