Destructor. Closes any open video clips and frees any resources held by the Video Player.

Adds the specified display to the list of surface rendering targets. This API can be used in conjunction with AddDisplayWindowL calls. The caller is responsible for handling surface events generated for the specific display. A single graphics surface is created and shared between all windows and displays. Surface registration and de-registration is managed by the MMF framework.

Adds a new window for displaying the video picture. Client applications must use this method instead of SetDisplayWindowL() when using CVideoPlayerUtility2 .

This method can only be called after opening the source is complete and the client has received an MvpuoOpenComplete() callback.

A simplified variant of AddDisplayWindowL() . When this variant is used, the video extent and window clipping rectangle default to the whole window.

This method can only be called after opening the source is complete and the client has received an MvpuoOpenComplete() callback.

Retrieves the scale factor currently set for a window. This is the preferred method to use with CVideoPlayerUtility2 .

Creates a new instance of the video player utility. Unlike CVideoPlayerUtility::NewL() , the CVideoPlayerUtility2 factory does not require window handles and other video display information as its arguments. The client can set up rendering later with AddDisplayWindowL() , or optionally use the utility without a window, for example, for metadata query purposes.

Removes the specified display from the list of surface rendering targets.

Removes a window that is currently being used to display the video picture. The window must have previously been added with AddDisplayWindowL() .

This method cannot fail. If the window has not been added with AddDisplayWindowL() , the method call will be ignored.

Retrieves the video rotation set for a window. This is the preferred method to use with CVideoPlayerUtility2 .

Set video automatic scaling. When automatic scaling is active, the video picture is scaled automatically to match the video extent, based on the scaling type. This variant of SetAutoScaleL() will always center the picture in the extent.

This is the preferred method to use with CVideoPlayerUtility2 .

Calling SetAutoScaleL() will override any scaling factors set with SetScaleFactorL() . Calling SetScaleFactorL() will disable automatic scaling.

Set video automatic scaling. When automatic scaling is active, the video picture is scaled automatically to match the video extent, based on the scaling type, and positioned according to the parameters.

This is the preferred method to use with CVideoPlayerUtility2 .

Calling SetAutoScaleL() will override any scaling factors set with SetScaleFactorL() . Calling SetScaleFactorL() will disable automatic scaling.

When enabled sets automatic switching of surface to/from external display when it is connected/disconnected from the device.

Automatic switching is enabled by default, but only if the client thread that created this utility has an Active Scheduler installed and the device supports external display switching.

To use this function the client thread must have an Active Scheduler installed otherwise it will leave with KErrNotReady.

Rotates the video image within the window. This is the preferred method to use with CVideoPlayerUtility2 .

The rotation will replace any rotation set with CVideoPlayerUtility::SetRotationL . Likewise with setting the rotation with CVideoPlayerUtility::SetRotationL after a call to CVideoPlayerUtility2::SetRotationL has been made, then the rotation specified will replace any rotation set with CVideoPlayerUtility2::SetRotationL .

Scales the video image to a specified percentage of its original size within the window. This is the preferred method to use with CVideoPlayerUtility2 . Setting scale factor will set auto scale to EAutoScaleNone for the window.

The scale factor will replace any scale factor set with CVideoPlayerUtility::SetScaleFactorL . Likewise with setting the scale factor with CVideoPlayerUtility::SetScaleFactorL after a call to CVideoPlayerUtility2::SetScaleFactorL has been made, then the scale factor specified will replace any scale factor set with CVideoPlayerUtility2::SetScaleFactorL .

Sets the video extent on the screen, relative to the window. The extent specifies the area of screen in which the video picture is placed, and may be partially or completely outside of the video window. Video picture position within the extent depends on the picture size and content alignment or offset.

This method can only be called after opening the source is complete and the client has received an MvpuoOpenComplete() callback.

Sets the window clipping rectangle, relative to the window. The clipping rectangle specifies the part of the window used to display the video picture and must be fully contained within the window.

This method can only be called after opening the source is complete and the client has received an MvpuoOpenComplete() callback.