<?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-2C443E6F-BC3D-5252-8098-9F850AA88A35" xml:lang="en"><title>Window
Server Component Overview</title><shortdesc>The Window Server manages the use of the screen and input devices
by applications and controls and co-ordinates access. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<section id="GUID-4BE363E2-E630-462D-A958-721B3636792E"><title>Architecture</title> <p>The
architecture of the Window Server varies depending on whether you are using
the <xref href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita">ScreenPlay (NGA)</xref> or <xref href="GUID-F64E6551-670E-5E12-8103-DE504D3EC94F.dita">non-ScreenPlay</xref> variant.
However, with a few exceptions, the client-side API is the same in both variants.
Both variants use an improved version of the Window Server, sometimes known
as <codeph>WSERV2</codeph>, which was introduced in Symbian^2 (Symbian OS
v9.4). </p> <p>The following diagram provides an overview of the Window Server
architecture in ScreenPlay. </p> <fig id="GUID-80DA5DEB-019E-5CE3-812E-496A1D713FFB">
<title>              The Window Server in ScreenPlay            </title>
<image href="GUID-1635E243-BDC9-55D8-8913-0D2DB622B22C_d0e186764_href.png" placement="inline"/>
</fig> <p>Below we list some of the key features of the Window Server, including
differences between the two architectures. The term <b>surface</b> is used
in ScreenPlay for a hardware-independent memory buffer for holding an image
or part of a scene. The <b>UI surface</b> is a special surface onto which
the Window Server renders all of the UI content. It is created automatically
during system start up. An <b>external surface</b> is any other surface—for
example, a surface that holds a video or to which OpenGL ES content is rendered. </p> <ul>
<li id="GUID-A56D68E9-99E0-528A-9DDD-977BECE50A45"><p>The Window Server has
a render stage framework, which enables the last stage of the Window Server
rendering to be customizable through plug-ins called <b> render stages</b>.
These can be chained to form a rendering pipeline, which takes the drawing
operations that are produced by the Window Server and ultimately passes them
to the UI surface. Render stages can selectively filter, modify, or redirect
the draw operation stream, as required—for example, to perform transition
effects (TFX). </p> </li>
<li id="GUID-A6589F28-B8B5-5FBA-B241-6E526D6A9BF1"><p>In ScreenPlay, composition
takes place in two stages. First, the render stages render the drawing to
the UI surface. Then the composition engine combines the UI surface and any
external surfaces into elements (sometimes called <b>layers</b>) and composes
them to the screen. This enables the composition to be performed in software
or hardware accelerator chips. </p> </li>
<li id="GUID-BA8D10A1-F0CB-56F7-817B-F1425AC1DA56"><p>In the non-ScreenPlay
variant, the concept of surfaces is not used and the Window Server composes
directly onto the <b>frame buffer</b> which is then displayed on the screen. </p> </li>
<li id="GUID-FC88013B-E5A4-5DD6-9906-A526D137CF43"><p>There are differences
in the plug-in framework APIs in the two architectures. In addition, in ScreenPlay,
fading effects are implemented by using render stages, whereas when ScreenPlay
is not enabled they are implemented by using a separate fader plug-in type
(not shown on the diagram). </p> </li>
<li id="GUID-86A8FB36-B9DF-50F2-AE0B-798D717899A6"><p>In ScreenPlay, the Window
Server provides advanced pointer features, such as support for multiple pointers
and proximity and pressure coordinates. The non-ScreenPlay variant does not
provide this support. </p> </li>
<li id="GUID-46123A93-AF91-5FAB-995E-CDEAE9C8B961"><p>ScreenPlay provides
support for externally connected displays, such as TV-out. The non-ScreenPlay
variant considers the size of each display to be fixed. However, for High-Definition
Multimedia Interface (HDMI) and composite video connectors, there are a range
of resolutions that can change dynamically. ScreenPlay provides an optional
feature that supports switching between resolutions at runtime and notifications
to Window Server clients when there are changes to the resolution and connectedness. </p> </li>
</ul> </section>
<section id="GUID-2459A480-EC83-4595-97AA-D090331C9A88"><title>Building the
ScreenPlay and non-ScreenPlay variants</title> <p>To build the ScreenPlay
version of the Window Server components, declare the following macros in the <filepath>Symbian_OS.hrh</filepath> file. </p><codeblock xml:space="preserve">SYMBIAN_BUILD_GCE
SYMBIAN_GRAPHICS_BUILD_OPENWF_WSERV
</codeblock><p>This causes the ScreenPlay versions of the components in the
Graphics package to be built in addition to the non-ScreenPlay components.
Specifically the <codeph>SYMBIAN_BUILD_GCE</codeph> macro causes the ScreenPlay
version of the Window Server to be built. This means that the <filepath>w32_nga.mmp</filepath> and <filepath>wserv_nga.mmp</filepath> files
are built. These define a second macro, <codeph>SYMBIAN_GRAPHICS_GCE</codeph>,
which causes the ScreenPlay Window Server classes to be built. </p> <p>To include the ScreenPlay versions when building
ROM, use the <codeph>SYMBIAN_GRAPHICS_USE_GCE</codeph> flag. </p> </section>
<section id="GUID-BEBE7D33-06C7-4B07-837E-9E67633EEFBF"><title>Selecting the
ScreenPlay variant in the emulator</title><p>To select the ScreenPlay version
of the component in the emulator, add the following line to the <filepath>epoc.ini</filepath> file: </p> <codeblock id="GUID-E0A64D1F-19B8-5002-8031-06E58AAE0055" xml:space="preserve">SYMBIAN_GRAPHICS_USE_GCE ON</codeblock></section>
<section id="GUID-F13720C7-A6E1-4A3F-ACAF-10BEF6D2229F"><title>Executables</title> <p>This
section lists the main Window Server executables. For clarity, these are divided
into three groups. </p> <p><b>Window Server executable and client-side libraries </b> </p> <table id="GUID-E68F0783-FE52-55F3-8140-0FD527E91775">
<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
<thead>
<row>
<entry>Executable</entry>
<entry>LIB</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <filepath>wserv_nga.exe</filepath>  </p> </entry>
<entry><p> </p> </entry>
<entry><p>The ScreenPlay version of the Window Server. </p> </entry>
</row>
<row>
<entry><p> <filepath>wserv_nonnga.exe</filepath>  </p> </entry>
<entry><p> </p> </entry>
<entry><p>The non-ScreenPlay version of the Window Server. </p> </entry>
</row>
<row>
<entry><p> <filepath>ws32_nga.dll</filepath>  </p> </entry>
<entry><p> <filepath>ws32.lib</filepath>  </p> </entry>
<entry><p>The Window Server client-side API library for the ScreenPlay variant.
See <xref href="GUID-DC5E8C7D-D697-53E8-87F4-344301430E61.dita">Window Server Client-Side
Library</xref>. </p> </entry>
</row>
<row>
<entry><p> <filepath>ws32_nonnga.dll</filepath>  </p> </entry>
<entry><p> <filepath>ws32.lib</filepath>  </p> </entry>
<entry><p>The Window Server client-side API library for the non-ScreenPlay
variant. See <xref href="GUID-DC5E8C7D-D697-53E8-87F4-344301430E61.dita">Window
Server Client-Side Library</xref>. </p> </entry>
</row>
<row>
<entry><p> <filepath>wsgraphicdrawer_nga.dll</filepath>  </p> </entry>
<entry><p> <filepath>wsgraphicdrawer.lib </filepath>  </p> </entry>
<entry><p>The server-side base classes for Window Server plug-ins in the ScreenPlay
variant. The plug-ins include graphic drawer plug-ins (which are also known
as Content Rendering Plug-ins or CRPs) and render stage plug-ins. </p> </entry>
</row>
<row>
<entry><p> <filepath>wsgraphicdrawer_nonnga.dll</filepath>  </p> </entry>
<entry><p> <filepath>wsgraphicdrawer.lib </filepath>  </p> </entry>
<entry><p>The server-side base classes for Window Server plug-ins in the non-ScreenPlay
variant. The plug-ins include graphic drawer plug-ins (which are also known
as Content Rendering Plug-ins or CRPs) and render stage and fader plug-ins. </p> </entry>
</row>
<row>
<entry><p> <filepath>remotegc_nga.dll </filepath>  </p> </entry>
<entry><p> <filepath>remotegc.lib </filepath>  </p> </entry>
<entry><p>The client-side API library for remote graphic contexts in ScreenPlay.
Remote graphic contexts store draw operations so that they can be played back
later. It is "remote" because the draw operations are generally played back
in a different location from where they are stored. For example, the draw
operations are frequently stored on the client side and then a transformation
engine uses them on the server side to make an effect. </p> </entry>
</row>
<row>
<entry><p> <filepath>remotegc_nonnga.dll </filepath>  </p> </entry>
<entry><p> <filepath>remotegc.lib </filepath>  </p> </entry>
<entry><p>The client-side API library for remote graphic contexts in the non-ScreenPlay
variant. This has a similar role as in ScreenPlay. </p> </entry>
</row>
<row>
<entry><p> <filepath>profilerkeys.dll </filepath>  </p> </entry>
<entry/>
<entry><p>Window Server profiling hotkeys library in both ScreenPlay and non-ScreenPlay
variants. </p> </entry>
</row>
</tbody>
</tgroup>
</table> <p><b>Logging libraries </b> </p> <table id="GUID-C233B864-B909-5C00-B90A-7C78F3D02AFC">
<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
<thead>
<row>
<entry>Executable</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <filepath>dlog.dll </filepath>  </p> </entry>
<entry><p>On-screen logging library </p> </entry>
</row>
<row>
<entry><p> <filepath>dlogfl.dll </filepath>  </p> </entry>
<entry><p>File logging library </p> </entry>
</row>
<row>
<entry><p> <filepath>dlogrd.dll </filepath>  </p> </entry>
<entry/>
</row>
<row>
<entry><p> <filepath>dlogsr.dll </filepath>  </p> </entry>
<entry><p>Serial logging library </p> </entry>
</row>
</tbody>
</tgroup>
</table> <p><b>Plug-ins </b> </p> <table id="GUID-E71B0099-14D9-5C44-99FA-1DDB535EB7BF">
<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
<thead>
<row>
<entry>Executable</entry>
<entry>Variant</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <filepath>10281922.dll</filepath>  </p> </entry>
<entry><p>Both </p> </entry>
<entry><p>This is a standard reference CRP. This type of plug-in is called
a <i>CWsGraphics</i> ECOM plug-in. Device creators can replace this component. </p> </entry>
</row>
<row>
<entry><p> <filepath>2001b70b.dll</filepath>  </p> </entry>
<entry><p>Non-ScreenPlay </p> </entry>
<entry><p>This is a prototype reference render stage ECOM plug-in for the
non-ScreenPlay variant. This type of plug-in is called a <i>CWsPlugin</i>. </p> <p>Note:
The ScreenPlay render stage ECOM plug-in is delivered in the Window Server
Plugins component. </p> </entry>
</row>
<row>
<entry><p> <filepath>10285c4a.dll </filepath>  </p> </entry>
<entry><p>ScreenPlay </p> </entry>
<entry><p>This is a reference ScreenPlay surface-based CRP. Device creators
can replace this component. </p> </entry>
</row>
<row>
<entry><p> <filepath>samplegraphicsurface.dll </filepath>  </p> </entry>
<entry><p>ScreenPlay </p> </entry>
<entry><p>Sample ScreenPlay CRP (<i>CWsGraphics</i>) that demonstrates placing
a surface. </p> </entry>
</row>
<row>
<entry><p> <filepath>w32stdgraphic.dll </filepath>  </p> </entry>
<entry><p>Both </p> </entry>
<entry><p>Sample CRP (<i>CWsGraphics</i>). </p> </entry>
</row>
</tbody>
</tgroup>
</table> </section>
<section id="GUID-439B39AD-4184-4928-BF35-ABAB94A89400"><title>Typical uses</title> <ul>
<li id="GUID-BF47989B-D205-5ED8-BBCF-44B099E15C97"><p>Application developers
use the <xref href="GUID-DC5E8C7D-D697-53E8-87F4-344301430E61.dita">client-side
library</xref> to control windows in their applications and respond to key
and pointer events. </p> </li>
<li id="GUID-51A64C2E-C689-5765-8455-02C6350E4E88"><p>Testers and application
developers use the <xref href="GUID-6E8807F5-9CC0-5A70-8182-22230D43AA9E.dita">logging
mechanism</xref> to log Window Server events when developing and testing their
code. </p> </li>
<li id="GUID-139581CB-1185-569E-878D-58088230CCE8"><p>Device creators create
Content Rendering Plug-ins (CRPs) for showing customized content on the screen. </p> </li>
<li id="GUID-75EE03DE-0F78-5114-BCB9-8DD648A7C3A3"><p>Device creators who
use ScreenPlay, can create render stage plug-ins. These enable the output
of the Window Server to be combined with auxiliary software subsystems (such
as a transition effect engine) and hardware-accelerated drawing (for example,
using OpenVG). </p> </li>
<li id="GUID-E712A357-5797-5291-829E-C054463FD286"><p>Device creators use
the <xref href="GUID-1D529BDC-6665-58E2-AB3F-7023D8A84F69.dita">wsini.ini file</xref> to
configure the Window Server to suit the specific requirements of the particular
device. </p> </li>
</ul> </section>
</conbody><related-links>
<link href="GUID-0C4B86B5-530A-5839-86C1-46E7ABE281E0.dita"><linktext>Window Server
Component</linktext></link>


</related-links></concept>