<?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-19C3DA8C-0128-5172-B859-4FD6F6197451" xml:lang="en"><title>Common

Graphics Headers Component Overview</title><shortdesc>The Common Graphics Headers component contains classes that are

used by a number of ScreenPlay components and their clients. The classes are

divided between those that relate to surfaces and those that relate to display

configuration. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<section><title>Surface-related classes </title> <table id="GUID-971F0DC3-7E54-5FA6-9BB7-F1F8C9909C17">

<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>

<thead>

<row>

<entry>Class</entry>

<entry>Description</entry>

</row>

</thead>

<tbody>

<row>

<entry><xref href="GUID-11F60AEB-003B-3E8D-BDB9-D97F698627DF.dita"><apiname>TSurfaceId</apiname></xref> </entry>

<entry>Encapsulates the surface ID, which is a 128-bit number that is used

to identify a surface within ScreenPlay. See <xref href="GUID-0DC3E5AA-1706-5255-ACD6-E7AB732E1095.dita">Graphics

Composition Collection Overview</xref> for more information.  </entry>

</row>

<row>

<entry><xref href="GUID-15530F8C-A1B8-3A72-A203-D9DF4E07B9B1.dita"><apiname>TSurfaceTypes</apiname></xref> </entry>

<entry>Encapsulates the rendered surface type. See <xref href="GUID-ADA8CECB-0E70-5B9C-8F36-0714AAF0CD13.dita">Graphics

Surfaces</xref> for more information.  </entry>

</row>

</tbody>

</tgroup>

</table> </section>

<section><title>Display configuration-related classes</title> <table id="GUID-F08C4F5B-B568-58DF-9688-86E86D69EDE0">

<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>

<thead>

<row>

<entry>Class</entry>

<entry>Description</entry>

</row>

</thead>

<tbody>

<row>

<entry><xref href="GUID-8391795F-3766-3F31-BDFA-832AE8B4DFD4.dita"><apiname>MDisplayControlBase</apiname></xref> </entry>

<entry>Provides common functionality for the display control interfaces in

the composition engine, <xref href="GUID-2B6D3A9D-1481-5587-A954-48CE7EC311EE.dita">render

stages</xref> and <xref href="GUID-B1CB6374-2C2B-5D6C-9A7C-6E49D8F235B8.dita">Window

Server client-side API</xref>. </entry>

</row>

<row>

<entry><xref href="GUID-162264AE-D822-3850-842D-D2D3FAB2BBB8.dita"><apiname>TDisplayConfigurationBase</apiname></xref> </entry>

<entry>The base class for the display configuration hierarchy (shown in the

figure below). Defines common facilities for all configurations.  </entry>

</row>

<row>

<entry><xref href="GUID-656B1F2B-0053-3B3E-8F95-8EEF0A2E0712.dita"><apiname>TDisplayConfiguration1</apiname></xref> </entry>

<entry>The first collection of display configuration settings. </entry>

</row>

<row>

<entry><xref href="GUID-7ED11E23-6E13-36D4-BB10-8AE9E745C560.dita"><apiname>TDisplayConfiguration</apiname></xref> </entry>

<entry>The display configuration class for general use. This may be extended

by adding a chain of classes between this and <xref href="GUID-656B1F2B-0053-3B3E-8F95-8EEF0A2E0712.dita"><apiname>TDisplayConfiguration1</apiname></xref>.

If you do this, you must update the <xref href="GUID-C199771D-46DE-30C1-ABDD-14BAB4FF74A7.dita"><apiname>TDisplayConfigurationTop</apiname></xref> typedef.

 </entry>

</row>

</tbody>

</tgroup>

</table> <p>The following diagram provides an overview of the <codeph>TDisplayConfiguration</codeph> hierarchy. </p> <fig id="GUID-6C3EB1E5-4608-5D6C-9DF1-77502B3645E8">

<title> The display configuration hierarchy            </title>

<image href="GUID-3ABE5DA5-F6FD-5439-ADED-CBF0B2554D94_d0e277136_href.png" placement="inline"/>

</fig> </section>

</conbody><related-links>

<link href="GUID-0EBE5733-A267-5F4A-85AD-87C3ECF80731.dita"><linktext>Dynamic Resolution

Switching</linktext></link>

<link href="GUID-859CAA08-59C9-5FD3-98DE-6BDD0D6ED50B.dita"><linktext>Graphics

Composition</linktext></link>

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

of Adaptations</linktext></link>

</related-links></concept>