--- a/Symbian3/PDK/Source/GUID-D0C84E1D-A625-4F79-8515-399B8153727B.dita Fri Jul 02 12:51:36 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-D0C84E1D-A625-4F79-8515-399B8153727B.dita Fri Jul 16 17:23:46 2010 +0100
@@ -1,158 +1,142 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--Arbortext, Inc., 1988-2008, v.4002-->
-<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
- "concept.dtd">
-<concept id="GUID-D0C84E1D-A625-4F79-8515-399B8153727B" xml:lang="en">
-<title>What's New in Graphics in Symbian^3</title>
-<shortdesc>This section describes the changes introduced in the Graphics
-package in Symbian^3.</shortdesc>
-<prolog>
-<metadata><keywords></keywords></metadata>
-</prolog>
-<conbody>
-<section id="GUID-B341632C-47E7-4A0E-B3E5-2B69FD0AB09D"><title>ScreenPlay</title
-><p>ScreenPlay is a new graphics architecture which enables device
-creators to take advantage of improved software performance, hardware
-acceleration and third party graphics engines. For more information,
-see:</p><ul>
-<li><xref href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita">The
-ScreenPlay Graphics Architecture</xref></li>
-<li><xref href="GUID-F64E6551-670E-5E12-8103-DE504D3EC94F.dita">The
-NonScreenPlay Graphics Architecture</xref></li>
-<li><xref href="GUID-6D8A1FC7-095B-587E-8274-23C132978C53.dita">Enabling
-the Graphics Architecture Variants</xref></li>
-<li><xref href="GUID-859CAA08-59C9-5FD3-98DE-6BDD0D6ED50B.dita">Graphics
-Composition</xref></li>
-<li><xref href="GUID-EF62BF88-3687-505D-8BD7-EEDF36246E56.dita">Graphics
-Hardware Acceleration</xref></li>
-<li><xref href="GUID-0EBE5733-A267-5F4A-85AD-87C3ECF80731.dita">Dynamic
-Resolution Switching</xref></li>
-<li><xref href="GUID-19C3DA8C-0128-5172-B859-4FD6F6197451.dita">Common
-Graphics Headers Component Overview</xref></li>
-<li><xref href="GUID-9C269F45-F160-5A4B-ABF8-896D2A538E3B.dita">Advanced
-Pointer Overview</xref></li>
-<li><xref href="GUID-495EA1C8-E95F-54AE-B4D1-0F463003C2D7.dita">External
-Surfaces Overview</xref></li>
-<li><xref href="GUID-2E8929E6-9555-51D2-B41D-6F1D05A4DB87.dita">Render
-Stages Overview</xref></li>
-<li><xref href="GUID-8659E1EC-7744-5F93-AC56-C3000A2232CB.dita">MiniGUI
-Environment</xref></li>
-</ul> </section>
-<section id="GUID-934FEF09-12B2-418D-B6B4-1CCD41FFD27A"><title>Khronos
-APIs</title><p>For information about the supported Khronos APIs, see:</p
-><ul>
-<li><xref href="GUID-50254C2F-57B6-58C4-911F-294EF2B79C04.dita">Khronos
-API Support</xref></li>
-<li><xref href="GUID-1B1C6D35-FFDF-55B3-BCE2-DD0295858E49.dita">OpenVG
-Collection</xref></li>
-<li><xref href="GUID-AB93B01C-B6C2-5B24-ADEF-95706584D625.dita">OpenGLES
-Collection</xref></li>
-<li><xref href="GUID-8C6D4350-A38D-57A1-8C8D-C777EA7E8A3E.dita">EGL
-Collection</xref></li>
-<li><xref href="GUID-8FE41C9A-8171-58A2-A808-17B81E79B11F.dita">OpenWF
-Composition</xref></li>
-</ul></section>
-<section id="GUID-92E3FEE6-30D9-4C1B-8084-3CE3FA1DFE9B"><title>Other
-new features</title><ul>
-<li><xref href="GUID-D76C7759-739D-5C98-B718-7297687FE630.dita">Extended
-Bitmaps</xref></li>
-<li><xref href="GUID-8DF46A11-874A-52E5-9298-C083EA633BA0.dita">Implementing
-Dynamic DSA Allocation</xref></li>
-<li><xref href="GUID-3E7A9A92-F217-4BD1-82CE-227931CFB8ED.dita">Multiple
-P<?Pub Caret?>ointer Support in the Emulator</xref></li>
-</ul></section>
-<section id="GUID-B7EEA185-4445-4875-A9B6-18EF2264FD9C"><title>Interface
-breaks and deprecated functionality</title><p>The following functionality
-is deprecated in Symbian^3:</p><ul>
-<li><p>DirectGDI is deprecated. See <xref
-href="GUID-A2E07A3C-B3A8-50B9-BD60-F1F01795FA24.dita">DirectGDI Component</xref
-> for more information.</p></li>
-<li><p>The Graphics Resource components are deprecated and will be
-removed in Symbian^4. See <xref
-href="GUID-26E51AB0-C0FC-55EA-B747-C834E2D4FD27.dita">Graphics Resource
-Services Collection</xref> for more information.</p></li>
-<li><p>Creating transparent windows using a mask and <xref
-href="GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79.dita"><apiname>RWindow</apiname
-></xref> is deprecated. See <xref
-href="GUID-02BD38E7-A579-5BD5-9444-4E7C14C7809A.dita">Transparent
-Windows</xref> for more information.</p></li>
-<li><p>Backed-up windows are deprecated. See <xref
-href="GUID-08A6A034-5609-58B0-8EA7-943B2A937B40.dita">Displayable
-Windows</xref> for more information. </p></li>
-</ul></section>
-<section id="GUID-9B1C753E-E502-4578-A5A7-0C8CD2739C5C"><title>Guide
-documentation changes</title><p>The following documentation has been
-added to the Graphics Reference:</p><ul>
-<li><xref href="GUID-F2AF891D-A514-5743-B6F0-9271CE2A1775.dita">Graphics
-Components and Their CBR Package Names</xref></li>
-<li><xref href="GUID-610C1484-112E-5442-95DC-89CF890A8310.dita">Pixel
-Formats</xref></li>
-</ul><p>The following documentation has been added to the Windowing
-collection:</p><ul>
-<li><xref href="GUID-2C443E6F-BC3D-5252-8098-9F850AA88A35.dita">Window
-Server Component Overview</xref></li>
-<li><xref href="GUID-B1CB6374-2C2B-5D6C-9A7C-6E49D8F235B8.dita">Display
-Control and Mapping in the Window Server Client</xref></li>
-<li><xref href="GUID-02BD38E7-A579-5BD5-9444-4E7C14C7809A.dita">Transparent
-Windows</xref></li>
-<li><xref href="GUID-8DB1C618-597C-560C-95A2-C0AB2CEBB027.dita">Redraw
-Drawing</xref></li>
-<li><xref href="GUID-A12A66ED-2C8F-5CE6-8F3E-332B045A35B4.dita">Advanced
-Pointers</xref></li>
-<li><xref href="GUID-1C025957-258C-54C0-94A5-AD60C14E6D76.dita">External
-Surfaces</xref></li>
-<li><xref href="GUID-3A2785D4-6185-50C3-8D7E-5D94CD2B7C98.dita">Render-Stages</xref
-></li>
-<li><xref href="GUID-EB7F7772-1C0D-54C7-9856-AD552DF1F102.dita">Window
-Server Plug-in Framework Overview</xref></li>
-<li><xref href="GUID-8659E1EC-7744-5F93-AC56-C3000A2232CB.dita">MiniGUI
-Environment</xref></li>
-<li><xref href="GUID-E29CAFA8-523D-57D2-AC1B-D6D01741550B.dita">Window
-Server Internals Concepts</xref></li>
-<li><xref href="GUID-85E1E45B-DD05-5B7D-84E7-9911E0A3E3CC.dita">The
-wsini.ini File</xref></li>
-<li><xref href="GUID-E7F6DD98-9080-50E9-B071-56247EBBF570.dita">Window
-Server Plug-ins Component</xref></li>
-</ul><p>The following documentation has been added to the Font and
-Bitmap Server collection:</p><ul>
-<li><p><xref href="GUID-E6E6A439-B3CC-5FEA-9148-2DB5F37003F2.dita"
->Creating an Extended Bitmap Rasterizer</xref></p></li>
-</ul><p>The following documentation has been added to the OpenGLES
-collection:</p><ul>
-<li><p><xref href="GUID-AB93B01C-B6C2-5B24-ADEF-95706584D625.dita"
->OpenGLES Collection</xref></p></li>
-</ul><p>The following documentation has been added to the OpenVG collection:</p
-><ul>
-<li><p><xref href="GUID-1B1C6D35-FFDF-55B3-BCE2-DD0295858E49.dita"
->OpenVG Collection</xref></p></li>
-</ul><p>The following documentation has been added to the EGL collection:</p
-><ul>
-<li><p><xref href="GUID-8C6D4350-A38D-57A1-8C8D-C777EA7E8A3E.dita"
->EGL Collection</xref></p></li>
-</ul><p>The following documentation has been added to the Graphics
-Utilities collection:</p><ul>
-<li><xref href="GUID-19C3DA8C-0128-5172-B859-4FD6F6197451.dita">Common
-Graphics Headers Component Overview</xref></li>
-<li><xref href="GUID-946E64D6-3E5D-5264-AD5D-29D3AD296543.dita">Selection
-of Adaptations</xref></li>
-</ul><p>The following documentation has been added to the Graphics
-Composition collection:</p><ul>
-<li><p><xref href="GUID-63CB6C7E-44EC-5D0B-A37D-FE78F7D76592.dita"
->Graphics Composition Collection</xref></p></li>
-</ul><p>The following documentation has been added to the Graphics
-Hardware Drivers collection:</p><ul>
-<li><p><xref href="GUID-4797000B-B61D-5EF8-8C38-3159433C9C7B.dita"
->Graphics Hardware Drivers Collection</xref></p></li>
-</ul><p>The following documentation has been updated:</p><ul>
-<li><xref href="GUID-484B51EC-2209-5492-8E9C-9D792AB0DF35.dita">Graphics
-and Drawing</xref></li>
-<li><xref href="GUID-71DADA82-3ABC-52D2-8360-33FAEB2E5DE9.dita">The
-Font and Bitmap Server Overview</xref></li>
-</ul></section>
-</conbody>
-<related-links>
-<link href="GUID-975CBC70-81E6-5FA2-80CE-88DD2ABE9595.dita"><linktext
->Graphics Guide</linktext></link>
-</related-links>
-</concept>
-<?Pub *0000007793?>
+<?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-D0C84E1D-A625-4F79-8515-399B8153727B" xml:lang="en"><title>What's New in Graphics in Symbian^3</title><shortdesc>This section describes the changes introduced in the Graphics
+package in Symbian^3.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-B341632C-47E7-4A0E-B3E5-2B69FD0AB09D"><title>ScreenPlay</title><p>ScreenPlay is a new graphics architecture which enables device
+creators to take advantage of improved software performance, hardware
+acceleration and third party graphics engines. For more information,
+see:</p><ul>
+<li><xref href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita">The ScreenPlay
+Graphics Architecture</xref></li>
+<li><xref href="GUID-F64E6551-670E-5E12-8103-DE504D3EC94F.dita">The NonScreenPlay
+Graphics Architecture</xref></li>
+<li><xref href="GUID-6D8A1FC7-095B-587E-8274-23C132978C53.dita">Enabling the Graphics
+Architecture Variants</xref></li>
+<li><xref href="GUID-859CAA08-59C9-5FD3-98DE-6BDD0D6ED50B.dita">Graphics
+Composition</xref></li>
+<li><xref href="GUID-EF62BF88-3687-505D-8BD7-EEDF36246E56.dita">Graphics
+Hardware Acceleration</xref></li>
+<li><xref href="GUID-0EBE5733-A267-5F4A-85AD-87C3ECF80731.dita">Dynamic
+Resolution Switching</xref></li>
+
+<li><xref href="GUID-19C3DA8C-0128-5172-B859-4FD6F6197451.dita">Common Graphics Headers
+Component Overview</xref></li>
+<li><xref href="GUID-9C269F45-F160-5A4B-ABF8-896D2A538E3B.dita">Advanced
+Pointer Overview</xref></li>
+<li><xref href="GUID-495EA1C8-E95F-54AE-B4D1-0F463003C2D7.dita">External
+Surfaces Overview</xref></li>
+<li><xref href="GUID-2E8929E6-9555-51D2-B41D-6F1D05A4DB87.dita">Render Stages Overview</xref></li>
+<li><xref href="GUID-8659E1EC-7744-5F93-AC56-C3000A2232CB.dita">MiniGUI Environment</xref></li>
+</ul> </section>
+<section id="GUID-934FEF09-12B2-418D-B6B4-1CCD41FFD27A"><title>Khronos
+APIs</title><p>For information about the supported Khronos APIs, see:</p><ul>
+<li><xref href="GUID-50254C2F-57B6-58C4-911F-294EF2B79C04.dita">Khronos
+API Support</xref></li>
+<li><xref href="GUID-1B1C6D35-FFDF-55B3-BCE2-DD0295858E49.dita">OpenVG
+Collection</xref></li>
+<li><xref href="GUID-AB93B01C-B6C2-5B24-ADEF-95706584D625.dita">OpenGLES
+Collection</xref></li>
+<li><xref href="GUID-8C6D4350-A38D-57A1-8C8D-C777EA7E8A3E.dita">EGL Collection</xref></li>
+<li><xref href="GUID-8FE41C9A-8171-58A2-A808-17B81E79B11F.dita">OpenWF Composition</xref></li>
+</ul></section>
+<section id="GUID-92E3FEE6-30D9-4C1B-8084-3CE3FA1DFE9B"><title>Other new features</title><ul>
+<li><xref href="GUID-D76C7759-739D-5C98-B718-7297687FE630.dita">Extended
+Bitmaps</xref></li>
+<li><xref href="GUID-8DF46A11-874A-52E5-9298-C083EA633BA0.dita">Implementing
+Dynamic DSA Allocation</xref></li>
+<li><xref href="GUID-3E7A9A92-F217-4BD1-82CE-227931CFB8ED.dita">Multiple
+Pointer Support in the Emulator</xref></li>
+</ul></section>
+<section id="GUID-B7EEA185-4445-4875-A9B6-18EF2264FD9C"><title>Interface
+breaks and deprecated functionality</title><p>On ScreenPlay, support
+for direct screen access (DSA) is maintained for backward compatibility
+reasons, although Symbian recommends the use of external surfaces
+in preference to DSA. However, whereas on some earlier
+devices, applications might work without fully conforming to the rules
+of DSA, these rules are now necessarily enforced. See <xref href="GUID-3F0FCBB5-98D2-4355-96E3-2DA938DE1C16.dita">DSA Migration Guide</xref> for information about the guidelines applications must follow in
+order to be able to run correctly on a ScreenPlay device.</p><p>The following functionality is deprecated in Symbian^3:</p><ul>
+<li><p>DirectGDI is deprecated.
+See <xref href="GUID-A2E07A3C-B3A8-50B9-BD60-F1F01795FA24.dita">DirectGDI
+Component</xref> for more information.</p></li>
+<li><p>The Graphics Resource components
+are deprecated and will be removed in Symbian^4. See <xref href="GUID-26E51AB0-C0FC-55EA-B747-C834E2D4FD27.dita">Graphics Resource
+Services Collection</xref> for more information.</p></li>
+<li><p>Creating transparent windows using a mask and <xref href="GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79.dita"><apiname>RWindow</apiname></xref> is deprecated. See <xref href="GUID-02BD38E7-A579-5BD5-9444-4E7C14C7809A.dita">Transparent Windows</xref> for more information.</p></li>
+<li><p>Backed-up windows are deprecated. See <xref href="GUID-08A6A034-5609-58B0-8EA7-943B2A937B40.dita">Displayable Windows</xref> for more information. </p></li>
+</ul></section>
+<section id="GUID-9B1C753E-E502-4578-A5A7-0C8CD2739C5C"><title>Guide
+documentation changes</title><p>The following documentation has been added to the Graphics Reference:</p><ul>
+<li><xref href="GUID-F2AF891D-A514-5743-B6F0-9271CE2A1775.dita">Graphics
+Components and Their CBR Package Names</xref></li>
+<li><xref href="GUID-610C1484-112E-5442-95DC-89CF890A8310.dita">Pixel Formats</xref></li>
+</ul><p>The following documentation has been added to the Windowing
+collection:</p><ul>
+<li><xref href="GUID-2C443E6F-BC3D-5252-8098-9F850AA88A35.dita">Window
+Server Component Overview</xref></li>
+<li><xref href="GUID-B1CB6374-2C2B-5D6C-9A7C-6E49D8F235B8.dita">Display
+Control and Mapping in the Window Server Client</xref></li>
+<li><xref href="GUID-02BD38E7-A579-5BD5-9444-4E7C14C7809A.dita">Transparent
+Windows</xref></li>
+<li><xref href="GUID-8DB1C618-597C-560C-95A2-C0AB2CEBB027.dita">Redraw
+Drawing</xref></li>
+<li><xref href="GUID-A12A66ED-2C8F-5CE6-8F3E-332B045A35B4.dita">Advanced
+Pointers</xref></li>
+<li><xref href="GUID-1C025957-258C-54C0-94A5-AD60C14E6D76.dita">External
+Surfaces</xref></li>
+<li><xref href="GUID-3A2785D4-6185-50C3-8D7E-5D94CD2B7C98.dita">Render-Stages</xref></li>
+<li><xref href="GUID-EB7F7772-1C0D-54C7-9856-AD552DF1F102.dita">Window Server Plug-in
+Framework Overview</xref></li>
+<li><xref href="GUID-8659E1EC-7744-5F93-AC56-C3000A2232CB.dita">MiniGUI Environment</xref></li>
+<li><xref href="GUID-E29CAFA8-523D-57D2-AC1B-D6D01741550B.dita">Window
+Server Internals Concepts</xref></li>
+<li><xref href="GUID-85E1E45B-DD05-5B7D-84E7-9911E0A3E3CC.dita">The wsini.ini
+File</xref></li>
+<li><xref href="GUID-E7F6DD98-9080-50E9-B071-56247EBBF570.dita">Window Server Plug-ins
+Component</xref></li>
+</ul><p>The following documentation
+has been added to the Font and Bitmap Server collection:</p><ul>
+<li><p><xref href="GUID-E6E6A439-B3CC-5FEA-9148-2DB5F37003F2.dita">Creating
+an Extended Bitmap Rasterizer</xref></p></li>
+</ul><p>The following documentation has been added to the OpenGLES
+collection:</p><ul>
+<li><p><xref href="GUID-AB93B01C-B6C2-5B24-ADEF-95706584D625.dita">OpenGLES
+Collection</xref></p></li>
+</ul><p>The following documentation has been added to the OpenVG collection:</p><ul>
+<li><p><xref href="GUID-1B1C6D35-FFDF-55B3-BCE2-DD0295858E49.dita">OpenVG
+Collection</xref></p></li>
+</ul><p>The following documentation has been added to the EGL collection:</p><ul>
+<li><p><xref href="GUID-8C6D4350-A38D-57A1-8C8D-C777EA7E8A3E.dita">EGL
+Collection</xref></p></li>
+</ul><p>The following documentation
+has been added to the Graphics Utilities collection:</p><ul>
+<li><xref href="GUID-19C3DA8C-0128-5172-B859-4FD6F6197451.dita">Common
+Graphics Headers Component Overview</xref></li>
+<li><xref href="GUID-946E64D6-3E5D-5264-AD5D-29D3AD296543.dita">Selection
+of Adaptations</xref></li>
+</ul><p>The following documentation
+has been added to the Graphics Composition collection:</p><ul>
+<li><p><xref href="GUID-63CB6C7E-44EC-5D0B-A37D-FE78F7D76592.dita">Graphics
+Composition Collection</xref></p></li>
+</ul><p>The following documentation
+has been added to the Graphics Hardware Drivers collection:</p><ul>
+<li><p><xref href="GUID-4797000B-B61D-5EF8-8C38-3159433C9C7B.dita">Graphics
+Hardware Drivers Collection</xref></p></li>
+</ul><p>The following documentation has been updated:</p><ul>
+<li><xref href="GUID-484B51EC-2209-5492-8E9C-9D792AB0DF35.dita">Graphics
+and Drawing</xref></li>
+<li><xref href="GUID-71DADA82-3ABC-52D2-8360-33FAEB2E5DE9.dita">The Font
+and Bitmap Server Overview</xref></li>
+</ul></section>
+</conbody><related-links>
+<link href="GUID-975CBC70-81E6-5FA2-80CE-88DD2ABE9595.dita"><linktext>Graphics
+Guide</linktext></link>
+</related-links></concept>
\ No newline at end of file