1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-24D99069-438E-5CC4-90B6-5609A2E50953" xml:lang="en"><title>OpenMAX

    13 IL Component Interface Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>This document introduces you to the Symbian way of using OpenMAX IL Component

    15 Interface. </p>

    16 <section><title>Purpose</title> <p>OpenMAX IL Component interface is an ECom

    17 plug-in. This plug-in is loaded by OpenMAX IL Loader to access OpenMAX IL

    18 Component. </p> <p>The OpenMAX IL Component interface (entry point) is provided

    19 as a static library, and the ECom implementation is defined as a macro to

    20 allow OpenMAX IL Component to be built as an ECom plug-in with very little

    21 overhead. </p> </section>

    22 <section><title>API name library details</title><p>For Symbian OpenMAX IL

    23 Component functionality you must adapt the following static library file. </p> <table id="GUID-1B5B22D0-EE9B-5B88-BB47-FF91127F45CF">

    24 <tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>

    25 <thead>

    26 <row>

    27 <entry>DLL</entry>

    28 <entry>LIB</entry>

    29 <entry>Short Description</entry>

    30 </row>

    31 </thead>

    32 <tbody>

    33 <row>

    34 <entry><p>You must create your own <b>*.dll</b>  </p> </entry>

    35 <entry><p> <b> omxilcomponentif.lib</b>  </p> </entry>

    36 <entry><p>These files are used for implementing OpenMAX IL Component interface. </p> </entry>

    37 </row>

    38 </tbody>

    39 </tgroup>

    40 </table></section>

    41 <section><title>Architectural relationship</title> <p>OpenMAX IL Component

    42 interface is loaded as an ECom plug-in. <xref href="GUID-8ABC275C-E94D-3E37-A493-FCB59F26F574.dita"><apiname>KUidOmxILSymbianComponentIf</apiname></xref> is

    43 an identifier for the OpenMAX IL Component interface. </p> </section>

    44 <section><title>Description</title> <p>The OpenMAX IL Component interface

    45 is implemented by using the <xref href="GUID-A209F5DF-59FC-3386-8544-3A34351BDB30.dita"><apiname>OMX_COMPONENTTYPE</apiname></xref> structure.

    46 The valid handle for the OpenMAX IL Component interface is received by using

    47 the <xref href="GUID-A19E1E17-0DCB-37FA-8AF1-C14B862292DF.dita"><apiname>OMX_HANDLETYPE</apiname></xref> structure. </p> <p>The <xref href="GUID-A209F5DF-59FC-3386-8544-3A34351BDB30.dita"><apiname>OMX_COMPONENTTYPE</apiname></xref> structure

    48 is used to access the functionality of the OpenMAX IL Component interface.

    49 The main features of the <xref href="GUID-A209F5DF-59FC-3386-8544-3A34351BDB30.dita"><apiname>OMX_COMPONENTTYPE</apiname></xref> structure are

    50 to </p> <ul>

    51 <li id="GUID-BAEDDF62-E584-590C-B17E-AF23F2DEBA95"><p>get the version of OpenMAX

    52 IL Component </p> </li>

    53 <li id="GUID-8E506495-800B-51E7-9D93-1FA1E31D0D8D"><p>get the role of OpenMAX

    54 IL Component </p> </li>

    55 <li id="GUID-74ACDA1D-589B-572D-88A9-F96691DCD772"><p>get the name of OpenMAX

    56 IL Component. </p> </li>

    57 </ul> </section>

    58 <section><title>Key OpenMAX IL Component interface classes</title> <p>The

    59 key classes of the OpenMAX IL Component interface are </p> <ul>

    60 <li id="GUID-28BCA546-1665-5854-A975-9D79ECB24D5F"><p> <xref href="GUID-81BE22B8-EA3A-3BA9-A4EB-A7087BB01CCE.dita"><apiname>COmxILComponentIf</apiname></xref>,

    61 which is an interface for implementing OpenMAX IL Component interface </p> </li>

    62 <li id="GUID-55E12AD8-8363-5314-8944-EA2AE7E5A03D"><p> <xref href="GUID-71B50971-A34B-3AA8-8697-84FED029917A.dita"><apiname>COmxILSymbianComponentIf</apiname></xref>,

    63 which is the Symbian implementation of <xref href="GUID-81BE22B8-EA3A-3BA9-A4EB-A7087BB01CCE.dita"><apiname>COmxILComponentIf</apiname></xref>. </p> </li>

    64 </ul> </section>

    65 <section><title>Using the OpenMAX IL Component interface </title> <p>The OpenMAX

    66 IL Component interface is used to implement the Multimedia functionality as

    67 specified in <xref href="http://www.khronos.org/files/openmax_il_spec_1_1_1.pdf" scope="external">OpenMAX IL Specification 1.1.1</xref>. </p> </section>

    68 </conbody><related-links>

    69 <link href="GUID-148B1188-8007-5077-A813-50F728CAC5D5.dita"><linktext>OpenMAX IL

    70 Core Overview</linktext></link>

    71 <link href="GUID-F97ABEDE-C318-5EA2-B8CB-6510725413A0.dita"><linktext> OpenMAX

    72 IL Loader Interface Overview</linktext></link>

    73 <link href="GUID-89CFD892-16B0-5B70-AE46-D4BFB8412BC4.dita"><linktext>OpenMAX IL

    74 Content Pipe Overview </linktext></link>

    75 </related-links></concept>