graphicsdeviceinterface/directgdiadaptation/hwsrc/clippingregionmanager.h
author William Roberts <williamr@symbian.org>
Thu, 03 Jun 2010 17:39:46 +0100
branchNewGraphicsArchitecture
changeset 87 0709f76d91e5
parent 0 5d03bc08d59c
permissions -rw-r--r--
Add MMP files to build libOpenVG_sw.lib which uses LINKAS to redirect to libOpenVG.dll (and the same for libEGL_sw.lib and libOpenVGU_sw.lib). Only the libEGL_sw.lib redirection isn't activated - this can't happen until there is a merged libEGL.dll which supports the OpenWF synchronisation and also implements the graphical support functions. The overall aim is to eliminate the *_sw.dll implementations, at least as a compile-time way of choosing a software-only implementation.The correct way to choose is to put the right set of libraries into a ROM with suitable renaming, and in the emulator to use the "switching DLL" technique to pick the right set. As the Symbian Foundation doesn't have any alternative implementations, we don't need the switching DLLs and we can build directly to the correct name.

// 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:
//


#ifndef CLIPPINGREGIONMANAGER_H_
#define CLIPPINGREGIONMANAGER_H_

#include <VG/openvg.h>
#include <e32std.h>

/** 
Defines a rectangle of VGint coordinates for use when passing clipping rectangles to OpenVG.
*/
struct TVgClippingRect
	{
	VGint iX;
	VGint iY;
	VGint iWidth;
	VGint iHeight;
	};

/**
Helper for managing clipping (OpenVG: scissoring) regions within CVGEngine.

OpenVG supports only a fixed number of clipping rects (actual number is defined by 
the OpenVG implementation, though guaranteed to be at least 32), whereas 
Symbian OS stipulates no upper bound on the number of clipping rects in the
clipping region.   

This class keeps the entire clipping region in OpenVG coordinates, and may
be used to iterate over the clipping region, passing a set number of
clipping rectangles to OpenVG on each iteration.

A typical use case would be as follows:
@code
	for (iRegionManager.Begin(); iRegionManager.ApplyClipRegion(); iRegionManager.Next())
		vgDrawImage(openVgImage);
@endcode

@internalComponent
*/
NONSHARABLE_CLASS(RClippingRegionManager)
	{
	public:
		RClippingRegionManager ();
		void  Close ();
		void  Reset ();
		void  Initialize (TUint aItemsPerStep, TSize aVgEngineTargetSize);
		TInt  SetClippingRegion(const TRegion& aRegion);
		const RRegion& ClippingRegion () const;
		void  ClipTo(const TRect& aClipRect);
		void  Begin();
		TBool Next();
		TBool ApplyClipRegion();
		TBool Intersects(const TRect& aClipRect) const;
		
	private:
		void ResetIterator ();
		TUint RemainingItems() const;
		TUint ItemsInThisIteration() const;
		TInt  Append(const TPoint& aVgPosition, VGint width, VGint height);
		const TPoint ConvertToVgCoords(const TRect& aRect) const;
		TInt ConvertClippingRegion(const TRegion& aRegion);
		
	private:
		RArray<TVgClippingRect> iClippingRects; 	/**< Array of clipping rectangles stored in OpenVG coordinates.*/
		RRegion iClippingRegion;					/**< The full clipping region.*/
		TSize iVgEngineTargetSize;
		TUint iItemsPerStep;
		TUint iCurrentRect;
		TUint iBegun;
	};

#endif