Symbian3/PDK/Source/GUID-19C3DA8C-0128-5172-B859-4FD6F6197451.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Fri, 16 Jul 2010 17:23:46 +0100
changeset 12 80ef3a206772
parent 9 59758314f811
child 14 578be2adaf3e
permissions -rw-r--r--
Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.

<?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_d0e280231_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>