os/graphics/graphicscomposition/surfaceupdate/src/surfaceupdateclient.cpp
author sl
Tue, 10 Jun 2014 14:32:02 +0200
changeset 1 260cb5ec6c19
permissions -rw-r--r--
Update contrib.
sl@0
     1
// Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0
     2
// All rights reserved.
sl@0
     3
// This component and the accompanying materials are made available
sl@0
     4
// under the terms of "Eclipse Public License v1.0"
sl@0
     5
// which accompanies this distribution, and is available
sl@0
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0
     7
//
sl@0
     8
// Initial Contributors:
sl@0
     9
// Nokia Corporation - initial contribution.
sl@0
    10
//
sl@0
    11
// Contributors:
sl@0
    12
//
sl@0
    13
// Description:
sl@0
    14
//
sl@0
    15
sl@0
    16
/**
sl@0
    17
 @file
sl@0
    18
*/
sl@0
    19
sl@0
    20
#include <graphics/surfaceupdateclient.h>
sl@0
    21
#include <e32debug.h>
sl@0
    22
#include "surfaceupdate.h"
sl@0
    23
sl@0
    24
inline void SurfaceUpdateAssert(TInt aCond)	{__ASSERT_ALWAYS(aCond, User::Panic(_L("surfaceupdateclient.cpp; assertion failed"), __LINE__));}
sl@0
    25
sl@0
    26
EXPORT_C RSurfaceUpdateSession::RSurfaceUpdateSession() :
sl@0
    27
	RSessionBase(), 
sl@0
    28
	iStatusAvailable(NULL), iStatusDisplayed(NULL), iStatusDisplayedXTimes(NULL), iTimeStamp(NULL), iCount(0)
sl@0
    29
	{
sl@0
    30
	}
sl@0
    31
sl@0
    32
EXPORT_C TInt RSurfaceUpdateSession::Connect(TInt aMessageSlots)
sl@0
    33
	{
sl@0
    34
	if(Handle())
sl@0
    35
		{
sl@0
    36
		return KErrAlreadyExists; 
sl@0
    37
		}
sl@0
    38
	iStatusAvailable = NULL;
sl@0
    39
	iStatusDisplayed = NULL;
sl@0
    40
	iStatusDisplayedXTimes = NULL;
sl@0
    41
	
sl@0
    42
	//establish connection to the server
sl@0
    43
#ifndef TEST_SURFACE_UPDATE
sl@0
    44
	return CreateSession(KSurfaceUpdateServerName, Version(), aMessageSlots);
sl@0
    45
#else
sl@0
    46
	return CreateSession(KTestSurfaceUpdateServerName, Version(), aMessageSlots);
sl@0
    47
#endif
sl@0
    48
	}
sl@0
    49
sl@0
    50
EXPORT_C void RSurfaceUpdateSession::Close()	
sl@0
    51
	{
sl@0
    52
	if(Handle())
sl@0
    53
		{
sl@0
    54
		RHandleBase::Close();
sl@0
    55
		}
sl@0
    56
	iStatusAvailable = NULL;
sl@0
    57
	iStatusDisplayed = NULL;
sl@0
    58
	iStatusDisplayedXTimes = NULL;
sl@0
    59
	}
sl@0
    60
sl@0
    61
EXPORT_C TInt RSurfaceUpdateSession::SubmitUpdate(TInt aScreen, const TSurfaceId& aSurfaceId, 
sl@0
    62
									TInt aBuffer, const TRegion* aDirtyRegion)
sl@0
    63
	{
sl@0
    64
	SurfaceUpdateAssert(Handle() != KNullHandle);
sl@0
    65
sl@0
    66
#if defined _DEBUG
sl@0
    67
	if (aScreen != KAllScreens)
sl@0
    68
		RDebug::Printf("You should use KAllScreens as the argument for the screen: (other values OK for test)");
sl@0
    69
#endif
sl@0
    70
sl@0
    71
	if(aScreen < 0 || aBuffer < 0 || aSurfaceId.IsNull())
sl@0
    72
		{
sl@0
    73
		IssueRequestComplete(KErrArgument);
sl@0
    74
		return KErrArgument;
sl@0
    75
		}
sl@0
    76
	if(iStatusAvailable)
sl@0
    77
		{
sl@0
    78
		SendReceive(EUpdateServNotifyWhenAvailable, *iStatusAvailable);
sl@0
    79
		iStatusAvailable= NULL;
sl@0
    80
		}
sl@0
    81
	
sl@0
    82
	if(iStatusDisplayed)
sl@0
    83
		{
sl@0
    84
		TIpcArgs args(iTimeStamp);
sl@0
    85
		SendReceive(EUpdateServNotifyWhenDisplayed, args, *iStatusDisplayed);
sl@0
    86
		iStatusDisplayed=NULL;
sl@0
    87
		}
sl@0
    88
		
sl@0
    89
	if(iStatusDisplayedXTimes)
sl@0
    90
		{
sl@0
    91
		if(iCount <= 0)
sl@0
    92
			{
sl@0
    93
			User::RequestComplete(iStatusDisplayedXTimes, KErrArgument);
sl@0
    94
			}
sl@0
    95
		else
sl@0
    96
			{
sl@0
    97
			TIpcArgs args(iCount);
sl@0
    98
			SendReceive(EUpdateServNotifyWhenDisplayedXTimes, 
sl@0
    99
                     args, *iStatusDisplayedXTimes);
sl@0
   100
			}	
sl@0
   101
		iStatusDisplayedXTimes=NULL;
sl@0
   102
		}
sl@0
   103
sl@0
   104
	TPckgC<TSurfaceId> pckgSurfaceId(aSurfaceId);
sl@0
   105
	TIpcArgs theArgs(aScreen, &pckgSurfaceId, aBuffer);
sl@0
   106
sl@0
   107
	if(aDirtyRegion)
sl@0
   108
		{
sl@0
   109
		const TInt regionCount = aDirtyRegion->Count();
sl@0
   110
		if(regionCount > 0)
sl@0
   111
			{
sl@0
   112
			TPtrC8 ptrRect(reinterpret_cast<const TUint8*> (aDirtyRegion->RectangleList()), regionCount * sizeof(TRect));
sl@0
   113
			theArgs.Set(3, &ptrRect);
sl@0
   114
			}
sl@0
   115
		}
sl@0
   116
sl@0
   117
	//final request for composition 
sl@0
   118
	return SendReceive(EUpdateServSubmitUpdate, theArgs);
sl@0
   119
	}
sl@0
   120
sl@0
   121
EXPORT_C void RSurfaceUpdateSession::NotifyWhenAvailable(TRequestStatus& aStatus)
sl@0
   122
	{
sl@0
   123
	SurfaceUpdateAssert(Handle() != KNullHandle);
sl@0
   124
	iStatusAvailable = &aStatus;
sl@0
   125
	}
sl@0
   126
	
sl@0
   127
EXPORT_C void RSurfaceUpdateSession::NotifyWhenDisplayed(TRequestStatus& aStatus, TTimeStamp& aTimeStamp)
sl@0
   128
	{
sl@0
   129
	SurfaceUpdateAssert(Handle() != KNullHandle);
sl@0
   130
	iStatusDisplayed = &aStatus;
sl@0
   131
	iTimeStamp = &aTimeStamp;
sl@0
   132
	}
sl@0
   133
sl@0
   134
EXPORT_C void RSurfaceUpdateSession::NotifyWhenDisplayedXTimes(TInt aCount, TRequestStatus &aStatus)
sl@0
   135
	{
sl@0
   136
	SurfaceUpdateAssert(Handle() != KNullHandle);
sl@0
   137
	iStatusDisplayedXTimes = &aStatus;
sl@0
   138
	//we will check aCount validity at submission time (in SubmitUpdate)
sl@0
   139
	iCount = aCount;
sl@0
   140
	}
sl@0
   141
sl@0
   142
EXPORT_C void RSurfaceUpdateSession::CancelAllUpdateNotifications()
sl@0
   143
	{
sl@0
   144
	SurfaceUpdateAssert(Handle() != KNullHandle);
sl@0
   145
	SendReceive(EUpdateServCancelAllNotifications);
sl@0
   146
	//Signal calling client's TRequestStatus object if server didn't do that (SubmitUpdate is not called)
sl@0
   147
	//if SubmitUpdate is called, server will take care of signaling status object and following line does nothing
sl@0
   148
	IssueRequestComplete(KErrCancel);
sl@0
   149
	}
sl@0
   150
	
sl@0
   151
TVersion RSurfaceUpdateSession::Version() const
sl@0
   152
	{
sl@0
   153
	return (TVersion(KSurfaceUpdateServMajorVersionNumber, KSurfaceUpdateServMinorVersionNumber, KSurfaceUpdateServBuildVersionNumber));
sl@0
   154
	}
sl@0
   155
sl@0
   156
/*
sl@0
   157
 Helper function to complete all outstanding requests. 
sl@0
   158
 
sl@0
   159
 param - aErr Error code for completion.
sl@0
   160
 */
sl@0
   161
void RSurfaceUpdateSession::IssueRequestComplete(TInt aErr)
sl@0
   162
	{
sl@0
   163
	if(iStatusAvailable)
sl@0
   164
		{
sl@0
   165
		User::RequestComplete(iStatusAvailable, aErr);
sl@0
   166
		iStatusAvailable= NULL;
sl@0
   167
		}
sl@0
   168
	
sl@0
   169
	if(iStatusDisplayed)
sl@0
   170
		{
sl@0
   171
		User::RequestComplete(iStatusDisplayed, aErr);
sl@0
   172
		iStatusDisplayed=NULL;
sl@0
   173
		}
sl@0
   174
		
sl@0
   175
	if(iStatusDisplayedXTimes)
sl@0
   176
		{
sl@0
   177
		User::RequestComplete(iStatusDisplayedXTimes, aErr);
sl@0
   178
		iStatusDisplayedXTimes=NULL;
sl@0
   179
		}
sl@0
   180
	}