Symbian3/PDK/Source/GUID-82B0B4B9-6BC2-5BEF-B3B0-D57AC57F8D8A.dita
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 9 59758314f811
--- a/Symbian3/PDK/Source/GUID-82B0B4B9-6BC2-5BEF-B3B0-D57AC57F8D8A.dita	Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-82B0B4B9-6BC2-5BEF-B3B0-D57AC57F8D8A.dita	Tue Mar 30 11:56:28 2010 +0100
@@ -1,74 +1,76 @@
-<?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-82B0B4B9-6BC2-5BEF-B3B0-D57AC57F8D8A" xml:lang="en"><title>Graphics
-Resource Component Overview</title><shortdesc>The Graphics Resource component is not available on all systems.
-When present, together with the Graphics Resource Adaptation component, it
-provides an abstraction layer for the memory management of graphics data,
-both pixel data and non-pixel data (such as OpenVG command lists). The Graphics
-Resource component is the generic part, which provides the client API, whereas
-the Graphics Resource Adaptation component provides the adaptation part, which
-device creators can adapt to suit their graphics acceleration hardware if
-any is available. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
-<p><b>Target audience</b>: Device creators.</p>
-<note type="note">The Graphics Resource component is deprecated in Symbian^3
-and will be removed in Symbian^4.</note>
-<p>The <xref href="GUID-F2AF891D-A514-5743-B6F0-9271CE2A1775.dita">CBR package
-name</xref> for the Graphics Resource component is <filepath>graphics_graphicsresource</filepath>. </p>
-<section><title>Key classes</title> <p>The following diagram shows the relationships
-between the key classes. </p> <fig id="GUID-053684EB-72B6-5D02-863D-6F24391A61B1">
-<title>              Key Graphics Resource component classes            </title>
-<image href="GUID-D20A513B-C612-5859-A551-28E1AA7FA332_d0e247380_href.png" placement="inline"/>
-</fig> <table id="GUID-DBC2BBC9-E6B0-5DC0-B6B7-1D4186F901D2">
-<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
-<thead>
-<row>
-<entry>Class</entry>
-<entry>Description</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry><p> <xref href="GUID-EDC0E03F-37F6-3BEC-8FF3-D03C3CDB949C.dita"><apiname>RSgImage</apiname></xref>  </p> </entry>
-<entry><p>A handle to a reference-counted, two-dimensional pixel array that
-can be used as a source or target for different rendering pipelines. Attributes
-that are set at creation time define parameters such as the size, screen and
-usage. These cannot be changed after creation. </p> <p>An image can be shared
-between processes by passing its unique identifier. Alternatively it can be
-created as process-specific and not shareable, which may have performance
-advantages. </p> </entry>
-</row>
-<row>
-<entry><p> <xref href="GUID-FCF750E4-526C-3789-89D8-DEF02BB7A5A7.dita"><apiname>RSgImageCollection</apiname></xref>  </p> </entry>
-<entry><p>A handle to a reference-counted collection of images with the same
-attributes which is allocated in such a way that it can be used with the <xref href="GUID-0DC3E5AA-1706-5255-ACD6-E7AB732E1095.dita">graphics composition components</xref>.
-Clients can access each of the images in the collection individually through <xref href="GUID-EDC0E03F-37F6-3BEC-8FF3-D03C3CDB949C.dita"><apiname>RSgImage</apiname></xref> handles.
-Interoperability with the <xref href="GUID-0DC3E5AA-1706-5255-ACD6-E7AB732E1095.dita">graphics
-composition components</xref> is achieved by passing the surface identifier
-returned by <codeph>RSgImageCollection::SurfaceId()</codeph> in calls to the
-Composition Interface API or the Surface Update API. </p> </entry>
-</row>
-<row>
-<entry><p> <xref href="GUID-6F23F34A-A0BE-349C-ADE7-61A5AEF48018.dita"><apiname>RSgDrawable</apiname></xref>  </p> </entry>
-<entry><p>A handle to a reference-counted graphics resource that can be drawn
-in different rendering pipelines—for example, DirectGDI or OpenVG. Instances
-of <xref href="GUID-6F23F34A-A0BE-349C-ADE7-61A5AEF48018.dita"><apiname>RSgDrawable</apiname></xref> allow access to drawable resources created
-using other APIs without knowing the concrete type of the resource. </p> </entry>
-</row>
-</tbody>
-</tgroup>
-</table> </section>
-</conbody><related-links>
-<link href="GUID-26E51AB0-C0FC-55EA-B747-C834E2D4FD27.dita"><linktext>Graphics
-Resource Services Collection</linktext></link>
-<link href="GUID-E2A886E1-39FD-517F-870E-3B1BCD49E8CD.dita"><linktext>Off-Screen
-Rendering with DirectGDI Tutorial</linktext></link>
+<?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-82B0B4B9-6BC2-5BEF-B3B0-D57AC57F8D8A" xml:lang="en"><title>Graphics
+Resource Component Overview</title><shortdesc>The Graphics Resource component is not available on all systems.
+When present, together with the Graphics Resource Adaptation component, it
+provides an abstraction layer for the memory management of graphics data,
+both pixel data and non-pixel data (such as OpenVG command lists). The Graphics
+Resource component is the generic part, which provides the client API, whereas
+the Graphics Resource Adaptation component provides the adaptation part, which
+device creators can adapt to suit their graphics acceleration hardware if
+any is available. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p><b>Target audience</b>: Device creators.</p>
+<note type="note">The Graphics Resource component is deprecated in Symbian^3
+and will be removed in Symbian^4 (S^4). However, a new Graphics Resource Interface
+component is planned for S^4. This new component will provide a similar but
+reduced API that is optimized for sharing images across processes.</note>
+<p>The <xref href="GUID-F2AF891D-A514-5743-B6F0-9271CE2A1775.dita">CBR package
+name</xref> for the Graphics Resource component is <filepath>graphics_graphicsresource</filepath>. </p>
+<section id="GUID-7DA9610F-B761-4328-8FA9-53A18E281538"><title>Key classes</title> <p>The following diagram shows the relationships
+between the key classes. </p> <fig id="GUID-053684EB-72B6-5D02-863D-6F24391A61B1">
+<title>              Key Graphics Resource component classes            </title>
+<image href="GUID-D20A513B-C612-5859-A551-28E1AA7FA332_d0e275330_href.png" placement="inline"/>
+</fig> <table id="GUID-DBC2BBC9-E6B0-5DC0-B6B7-1D4186F901D2">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<thead>
+<row>
+<entry>Class</entry>
+<entry>Description</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p> <xref href="GUID-EDC0E03F-37F6-3BEC-8FF3-D03C3CDB949C.dita"><apiname>RSgImage</apiname></xref>  </p> </entry>
+<entry><p>A handle to a reference-counted, two-dimensional pixel array that
+can be used as a source or target for different rendering pipelines. Attributes
+that are set at creation time define parameters such as the size, screen and
+usage. These cannot be changed after creation. </p> <p>An image can be shared
+between processes by passing its unique identifier. Alternatively it can be
+created as process-specific and not shareable, which may have performance
+advantages. </p> </entry>
+</row>
+<row>
+<entry><p> <xref href="GUID-FCF750E4-526C-3789-89D8-DEF02BB7A5A7.dita"><apiname>RSgImageCollection</apiname></xref>  </p> </entry>
+<entry><p>A handle to a reference-counted collection of images with the same
+attributes which is allocated in such a way that it can be used with the <xref href="GUID-0DC3E5AA-1706-5255-ACD6-E7AB732E1095.dita">graphics composition components</xref>.
+Clients can access each of the images in the collection individually through <xref href="GUID-EDC0E03F-37F6-3BEC-8FF3-D03C3CDB949C.dita"><apiname>RSgImage</apiname></xref> handles.
+Interoperability with the <xref href="GUID-0DC3E5AA-1706-5255-ACD6-E7AB732E1095.dita">graphics
+composition components</xref> is achieved by passing the surface identifier
+returned by <codeph>RSgImageCollection::SurfaceId()</codeph> in calls to the
+Composition Interface API or the Surface Update API. </p> </entry>
+</row>
+<row>
+<entry><p> <xref href="GUID-6F23F34A-A0BE-349C-ADE7-61A5AEF48018.dita"><apiname>RSgDrawable</apiname></xref>  </p> </entry>
+<entry><p>A handle to a reference-counted graphics resource that can be drawn
+in different rendering pipelines—for example, DirectGDI or OpenVG. Instances
+of <xref href="GUID-6F23F34A-A0BE-349C-ADE7-61A5AEF48018.dita"><apiname>RSgDrawable</apiname></xref> allow access to drawable resources created
+using other APIs without knowing the concrete type of the resource. </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table> </section>
+</conbody><related-links>
+<link href="GUID-26E51AB0-C0FC-55EA-B747-C834E2D4FD27.dita"><linktext>Graphics
+Resource Services Collection</linktext></link>
+<link href="GUID-E2A886E1-39FD-517F-870E-3B1BCD49E8CD.dita"><linktext>Off-Screen
+Rendering with DirectGDI Tutorial</linktext></link>
 </related-links></concept>
\ No newline at end of file