<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

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

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-6D8A1FC7-095B-587E-8274-23C132978C53" xml:lang="en"><title>Enabling

the Graphics Architecture Variants</title><shortdesc>There are two variants of the graphics architecture. These are

referred to as the ScreenPlay and the Non-ScreenPlay variants, respectively.

This topic describes how to build and enable these two variants.  </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<section id="GUID-FF8E36E5-83D3-42AE-9CE7-97166E1B9BB9"><title>Enabling the

ScreenPlay variant</title><p>To enable ScreenPlay using OpenWF Composition

(OpenWF-C), declare the following variant macros in the <filepath>Symbian_OS.hrh</filepath> file: </p><codeblock xml:space="preserve">SYMBIAN_BUILD_GCE

SYMBIAN_GRAPHICS_BUILD_OPENWF_WSERV</codeblock><p>To select the ScreenPlay

variant in the emulator, add the following line to the <filepath>epoc.ini</filepath> file: </p><codeblock id="GUID-1B30B0A9-4DC8-5377-B269-6F0E153B7FB4" xml:space="preserve">SYMBIAN_GRAPHICS_USE_GCE ON</codeblock><p>The

Symbian OpenWF-C implementation provides support for the emulator only.</p></section>

<section id="GUID-90D11BF6-3D26-4F73-B130-6711EADE35D7"><title>Enabling the

non-ScreenPlay variant</title> <p>By default, the non-ScreenPlay versions

of the components are built in addition to the ScreenPlay ones and are included

in the ROM. For some of the components that are present in both variants (such

as Window Server, BitGDI and Screen Driver), different binaries are produced

for the two variants. </p> <p>Selecting the correct components is relatively

straightforward when running and testing on hardware, because the choice is

made at ROM build time. However, it is more complicated on the emulator, because

the choice is made at runtime. Screen Driver is particularly significant in

this respect because it is an adaptation component that can be modified by

device creators. </p> <p>If you extend the interface of the Screen Driver

DLL (that is, you change the <filepath>.def</filepath> file or introduce new

exports compared to the reference component), and want to build for the emulator,

you need to regenerate the switch code as well. Although this is relatively

easy, it can be confusing. The steps are as follows: </p> <ol id="GUID-76039660-7048-58B1-9EF2-96021A311823">

<li id="GUID-EE40F32B-BE13-55BE-AE69-40D28D191A51"><p>Update the exports. </p> </li>

<li id="GUID-880C0C95-93A6-54A6-B280-875E3C03F7FA"><p>Make the following files

writable: </p> <ul>

<li id="GUID-C06C5DEF-1D66-5122-AE34-14CF3F9AD74A"><p>The header (<filepath>.h</filepath>)

file in the <filepath>Graphics\screendriver\scdv_switch</filepath> directory. </p> </li>

<li id="GUID-376268D3-FA57-544F-88CC-F369319CCBF1"><p>The <filepath>scdvswitchu.def</filepath> file

in the corresponding <filepath>..\bwins</filepath> directory. </p> </li>

</ul> </li>

<li id="GUID-0863DFA5-223A-56AA-9D28-6CDA9E7B6160"><p>Run the <filepath>generate_stubs.pl</filepath> Perl

script to update these files. </p> </li>

<li id="GUID-F93CC2A8-C72B-554E-ADA4-34B8098789B8"><p>Rebuild the component. </p> </li>

</ol>  </section>

</conbody><related-links>

<link href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita"><linktext>The ScreenPlay

Graphics Architecture</linktext></link>

<link href="GUID-EF62BF88-3687-505D-8BD7-EEDF36246E56.dita"><linktext>Graphics

Hardware Acceleration</linktext></link>

<link href="GUID-F64E6551-670E-5E12-8103-DE504D3EC94F.dita"><linktext>The Non-ScreenPlay

Graphics Architecture</linktext></link>

<link href="GUID-946E64D6-3E5D-5264-AD5D-29D3AD296543.dita"><linktext>Selection

of Adaptations</linktext></link>