--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/graphicstest/graphicstestharness/src/graphicsscreencomparison.cpp Tue Feb 02 01:47:50 2010 +0200
@@ -0,0 +1,212 @@
+// Copyright (c) 2007-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:
+//
+
+/**
+ @file
+ @test
+ @internalComponent - Internal Symbian test code
+*/
+
+#include "graphicsscreencomparison.h"
+#include "graphicsimagecomparison.h"
+
+/**
+Creates an instance of the CTGraphicsScreenComparison class. The class is
+destroyed by a call to the class destructor when no longer required.
+
+This function will leave if memory cannot be allocated for the class object or it's
+construction fails. e.g. the CSC renderstage plugin is not accessible
+
+The function will panic if the CWsScreenDevice object has not been constructed
+
+@param aScreenDevice, a reference to a CWsScreenDevice object created for the
+screen for which image comparison is required.
+@pre The CSC renderstage plugin must be accessible.
+@pre The CWsScreenDevice object must have been constructed
+@post The CTGraphicsScreenComparison object has been created
+@return On success, a pointer to the CTGraphicsScreenComparison object, on failure,
+the function will leave or panic.
+*/
+EXPORT_C CTGraphicsScreenComparison* CTGraphicsScreenComparison::NewL(CWsScreenDevice& aScreenDevice)
+ {
+ CTGraphicsScreenComparison* self = new(ELeave) CTGraphicsScreenComparison();
+ CleanupStack::PushL(self);
+ self->ConstructL(aScreenDevice);
+ CleanupStack::Pop(self);
+ return self;
+ }
+
+void CTGraphicsScreenComparison::ConstructL(CWsScreenDevice& aScreenDevice)
+ {
+ iScreenSize = aScreenDevice.SizeInPixels();
+
+ //Create a screen sized bitmap for use in screen comparison
+ iBmp = new (ELeave) CFbsBitmap;
+
+ //push the git
+ User::LeaveIfError(iBmp->Create(aScreenDevice.SizeInPixels(), EColor16MU));
+
+
+ //Access the screen comparison class - render stage must be available
+ iCsc = static_cast<MTestScreenCapture*> (aScreenDevice.GetInterface(MTestScreenCapture::KUidTestScreenCaptureIf));
+ if(!iCsc)
+ {
+ RDebug::Printf("Failed to create CTGraphicsScreenComparison, (CSC render stage may not be specified in wsini.ini?) , aborting");
+ User::Leave(0);
+ }
+
+ //pop the git
+
+ }
+
+/**
+Compares the contents of a rectangular region of the screen with a similarly sized
+rectangular region of a reference bitmap.
+
+@param aCompareSize, a const reference to a TSize object denoting the size of the
+rectangular region for comparison. Negative and zero dimensions of this argument can
+be passed in without returning a KErrArgument error.
+@param aScreenPoint, a const reference to a TPoint object denoting the top left
+point of the screen rectangle for comparison.
+@param aBitmapPoint, a const reference to a TPoint object denoting the top left
+point of the bitmap rectangle for comparison.
+@param aRefBitmap, a const reference to the reference CFbsBitmap for use in comparison
+@param aTestStepName, a desciptor to identify output files in the event of a mismatch.
+Defaults to KNullDesC.
+@pre The aRefBitmap must have been created with mode EColor16MU.
+@pre The rectanglular comparison region must reside wholly inside the screen and
+reference bitmap.
+@pre To enable outputting of screen snapshots in the event of a mismatch, the
+c:\logs\testexecute\screencomparison\ folder must exist.
+@return KErrNone if the pixels contained in the screen and bitmap rectangles are an
+exact match or, otherwise, the count of the first unmatched pixel. Pixels are compared
+from TRUE top-left to bottom-right in the horizontal direction (TRUE to cope with
+negative dimensions of the aCompareSize object) An area of zero size will return
+KErrNone so long as the pre-conditions are satisfied.
+KErrArgument if the pre-conditions are not met.
+@post If an mismatch has occured, a snapshot of the screen is saved in an MBM file in the
+c:\logs\testexecute\screencomparison\ folder
+*/
+EXPORT_C TInt CTGraphicsScreenComparison::CompareScreenImageL(const TSize& aCompareSize,
+ const TPoint& aScreenPoint,
+ const TPoint& aBitmapPoint,
+ const CFbsBitmap& aRefBitmap,
+ const TDesC& aTestStepName)
+ {
+ if(aRefBitmap.DisplayMode() != EColor16MU)
+ {
+ return KErrArgument;
+ }
+
+ TInt err = iCsc->ComposeScreen(*iBmp);
+ if(err != KErrNone)
+ {
+ return err;
+ }
+
+ err = CTGraphicsImageComparison::CompareBitmaps(aCompareSize,
+ aBitmapPoint,
+ aScreenPoint,
+ aRefBitmap,
+ *iBmp);
+ if (err != KErrNone)
+ {
+ TRAP_IGNORE(SaveBitmapL(*iBmp, aTestStepName));
+ }
+ return err;
+ }
+
+/**
+Compares the contents of a rectangular region of the screen with a reference colour.
+
+@param aCompareSize, a const reference to a TSize object denoting the size of the
+rectangular region for comparison. Negative and zero dimensions of this argument can
+be passed in without returning a KErrArgument error.
+@param aScreenPoint, a const reference to a TPoint object denoting the top left
+point of the screen rectangle for comparison.
+@param aColor, the TRgb colour value to compare the region to.
+@param aTestStepName, a desciptor to identify output files in the event of a mismatch.
+Defaults to KNullDesC.
+@pre The rectanglular comparison region must reside wholly inside the screen
+@pre To enable outputting of screen snapshots in the event of a mismatch, the
+c:\logs\testexecute\screencomparison\ folder must exist.
+@return KErrNone if the pixels contained in the screen rectangle matches the reference
+colour or, otherwise, the count of the first unmatched pixel. Pixels are compared
+from TRUE top-left to bottom-right in the horizontal direction (TRUE to cope with
+negative dimensions of the aCompareSize object) An area of zero size will return
+KErrNone so long as the pre-conditions are satisfied.
+KErrArgument if the pre-conditions are not met.
+@post If an mismatch has occured, a snapshot of the screen is saved in an MBM file in the
+c:\logs\testexecute\screencomparison\ folder
+*/
+EXPORT_C TInt CTGraphicsScreenComparison::CompareScreenImageL(const TSize& aCompareSize,
+ const TPoint& aScreenPoint,
+ const TRgb& aColor,
+ const TDesC& aTestStepName)
+ {
+ TInt err = iCsc->ComposeScreen(*iBmp);
+ if(err != KErrNone)
+ {
+ return err;
+ }
+
+ err = CTGraphicsImageComparison::CompareBitmaps(aCompareSize,
+ aScreenPoint,
+ *iBmp,
+ aColor);
+ if (err != KErrNone)
+ {
+ TRAP_IGNORE(SaveBitmapL(*iBmp, aTestStepName));
+ }
+ return err;
+ }
+/**
+Returns a pointer to the underlying MTestScreenCapture class
+@return the MTestScreenCapture* pointer
+*/
+EXPORT_C MTestScreenCapture* CTGraphicsScreenComparison::GetMTestScreenCapture() const
+ {
+ return iCsc;
+ }
+
+/**
+CTGraphicsScreenComparison class destructor. Destroys the instance of the
+CTGraphicsScreenComparison class created by a call to CTGraphicsScreenComparison::NewL()
+*/
+EXPORT_C CTGraphicsScreenComparison::~CTGraphicsScreenComparison()
+ {
+ delete iBmp;
+ iBmp = 0;
+ }
+
+CTGraphicsScreenComparison::CTGraphicsScreenComparison()
+ {
+ }
+
+void CTGraphicsScreenComparison::SaveBitmapL(CFbsBitmap& aBitmap, const TDesC& aTestStepName)
+ {
+ RBuf fileName;
+ fileName.CreateL(KDir.iTypeLength + aTestStepName.Length() + KMbmSuffix.iTypeLength + KFixedNumWidth + 1);
+ fileName.CleanupClosePushL();
+
+ fileName.Insert(0, KDir);
+ fileName.Append(aTestStepName);
+ fileName.Append('_');
+ fileName.AppendNumFixedWidth((++iSavedBitmapCounter), EDecimal, KFixedNumWidth);
+ fileName.Append(KMbmSuffix);
+
+ User::LeaveIfError(aBitmap.Save(fileName));
+ CleanupStack::PopAndDestroy(&fileName);
+ }