MediaDesigner Component Design Tutorial
48
pages
English
Documents
Le téléchargement nécessite un accès à la bibliothèque YouScribe Tout savoir sur nos offres
48
pages
English
Documents
Le téléchargement nécessite un accès à la bibliothèque YouScribe Tout savoir sur nos offres
Incoras Solutions
MediaDesigner Component Design Tutorial
Document Reference: UG 103
Revision: 1.0.1
Publication Date: April 2009
Incoras Solutions
© Copyright 2009 Incoras Solutions Ltd. All rights reserved. Copyright
This document may not be adapted or reproduced in any material form, either the Notice
whole or any part, except with the prior written permission of Incoras Solutions Ltd.
This document is intended only to assist the reader in the use of the product(s) it
relates to. Incoras Solutions Ltd shall not be liable for any loss or damage arising
from the use of any information in this document, or for any error or omission in
such information, or for any incorrect use of the product(s).
Words and logos marked with ® or ™ are registered trademarks or trademarks Trademarks
owned by Incoras Solutions Ltd except as otherwise stated below Other brands
and names mentioned herein may be the trademarks of their respective owners.
OpenMAX is a trademark of the Khronos Group
Eclipse is a trademark of the Eclipse Foundation
Java is a trademark of Sun Microsystems, Inc
Windows is a trademark of Microsoft Corporation
Fedora is a trademark of Red Hat, Inc
Ubuntu is a trademark of Canonical Ltd
www.incoras.com Web Address
MediaDesigner Component Design Tutorial 2 Incoras Solutions
Contents
1. Introduction ........................................................................................ 4
2. ...
Voir
MediaDesigner Component Design Tutorial
Document Reference: UG 103
Revision: 1.0.1
Publication Date: April 2009
Incoras Solutions
© Copyright 2009 Incoras Solutions Ltd. All rights reserved. Copyright
This document may not be adapted or reproduced in any material form, either the Notice
whole or any part, except with the prior written permission of Incoras Solutions Ltd.
This document is intended only to assist the reader in the use of the product(s) it
relates to. Incoras Solutions Ltd shall not be liable for any loss or damage arising
from the use of any information in this document, or for any error or omission in
such information, or for any incorrect use of the product(s).
Words and logos marked with ® or ™ are registered trademarks or trademarks Trademarks
owned by Incoras Solutions Ltd except as otherwise stated below Other brands
and names mentioned herein may be the trademarks of their respective owners.
OpenMAX is a trademark of the Khronos Group
Eclipse is a trademark of the Eclipse Foundation
Java is a trademark of Sun Microsystems, Inc
Windows is a trademark of Microsoft Corporation
Fedora is a trademark of Red Hat, Inc
Ubuntu is a trademark of Canonical Ltd
www.incoras.com Web Address
MediaDesigner Component Design Tutorial 2 Incoras Solutions
Contents
1. Introduction ........................................................................................ 4
2. ...
Incoras Solutions
MediaDesigner Component Design Tutorial
Document Reference: UG 103
Revision: 1.0.1
Publication Date: April 2009
Incoras Solutions
© Copyright 2009 Incoras Solutions Ltd. All rights reserved. Copyright
This document may not be adapted or reproduced in any material form, either the Notice
whole or any part, except with the prior written permission of Incoras Solutions Ltd.
This document is intended only to assist the reader in the use of the product(s) it
relates to. Incoras Solutions Ltd shall not be liable for any loss or damage arising
from the use of any information in this document, or for any error or omission in
such information, or for any incorrect use of the product(s).
Words and logos marked with ® or ™ are registered trademarks or trademarks Trademarks
owned by Incoras Solutions Ltd except as otherwise stated below Other brands
and names mentioned herein may be the trademarks of their respective owners.
OpenMAX is a trademark of the Khronos Group
Eclipse is a trademark of the Eclipse Foundation
Java is a trademark of Sun Microsystems, Inc
Windows is a trademark of Microsoft Corporation
Fedora is a trademark of Red Hat, Inc
Ubuntu is a trademark of Canonical Ltd
www.incoras.com Web Address
MediaDesigner Component Design Tutorial 2 Incoras Solutions
Contents
1. Introduction ........................................................................................ 4
2. Pre-requisites ...................... 4
3. Tutorial ............................... 4
3.1 Setting up preferences .......................................................................... 4
3.2 Creating a new project .......... 5
3.3 Creaw component definition ..................................................... 7
3.4 Creating a custom parameter definition file ........... 12
3.5 Defining custom parameters ................................................................ 16
3.6 Adding custom parameters to the component ....... 21
3.7 Creating a default characteristic setting ................................................ 24
3.8 Generating the component shell .......................... 27
3.9 Installing the component shell on the target ......... 31
3.10 Testing the component shell ................................................................ 32
3.11 Designing a graph with the volume component ..... 41
3.12 Running the graph .............................................................................. 44
3.13 Mapping the core algorithm . 47
MediaDesigner Component Design Tutorial 3 Incoras Solutions
1. Introduction
In this tutorial we will use MediaDesigner to design a new OpenMAX IL component,
generate the code for the component and test it on the target system.
The tutorial is intended for use with the Bellagio Platform as supported by the
evaluation version of MediaDesigner.
2. Pre-requisites
MediaDesigner has been successfully installed on a PC-Windows or PC-Linux
machine and appropriate license has been obtained.
The user has updated MediaDesigner with the latest update packages.
The user has followed the „Getting Started„ help in MediaDesigner and is
familiar with the basic concepts.
In particular the user has followed MediaDesigner Help>Running the Sample
Graph: to create a suitable MediaDesigner to MDServer connection with the
connection manager.
The target machine (where OpenMAX IL will run) has all the appropriate
Bellagio and Incoras deb or rpm packages correctly installed.
The target machine has GNU build tools automake, autoconf and
configure tools installed
Ffmpeg libraries have been correctly installed on the target machine
3. Tutorial
3.1 Setting up preferences
As a first step we will set up some basic preferences in MediaDesigner.
From the menu select and set up the preferences as
shown below and press Apply
MediaDesigner Component Design Tutorial 4 Incoras Solutions
In this case and throughout this tutorial we will use the vendor name „acme‟ and
Author name „user1‟
The user is encouraged to use appropriate names for their organisation and for
themselves.
3.2 Creating a new project
We will now create a new project area to hold our component design
From the menu select
The following dialog will appear
MediaDesigner Component Design Tutorial 5 Incoras Solutions
Select General Project and press Next>
MediaDesigner Component Design Tutorial 6 Incoras Solutions
Enter a name for the project. In this case we will name the project „Sandbox‟ and
create this in the default location.
Note: A workspace can have multiple projects. A project may contain any amount of
subdirectories. The project may contain multiple component descriptors, graph
descriptors, parameter definitions, test scenario descriptors and so on.
Note: By default a newly created project will contribute to the OpenMAX library.
This can be turned on/off at any time by right clicking in the project in the navigator
pane and checking/un-checking the option.
In this tutorial we will store all our design and test files in the one „Sandbox‟ project
and we will leave the project set to contribute to the OpenMAX library.
3.3 Creating a new component definition
Our next step is to create a new component descriptor in MediaDesigner.
Note: A component descriptor is an XML file that describes the component and its
interfaces.
From the menu select
MediaDesigner Component Design Tutorial 7 Incoras Solutions
The following dialog appears:-
We give the component description file the name omx_acme_volume.xml and
save the file in the Sandbox project. Press Next> and the following dialog appears:-
MediaDesigner Component Design Tutorial 8 Incoras Solutions
We will now modify the component identifier name and tell MediaDesigner to base
the component on an existing class definition.
Note: A component identifier is the unique name given to an OpenMAX component.
This name is used at run-time when an OpenMAX IL client wishes to find the
component handle. See OpenMAX IL Specification for further details.
Note: Class definitions in MediaDesigner provide a convenient way to logically group
component types in the component library. The list of available classes from the
drop down menu is derived from the class definitions for standard components in
the OpenMAX IL specification. By choosing a class definition, the component
creation wizard will populate the component descriptor with the port definitions
expected for that class.
MediaDesigner Component Design Tutorial 9 Incoras Solutions
Modify the Identifier name to OMX.acme.volume. Give the component a short
name „ volume’
Select the Class radio button to tell the component creation wizard to base our
description on an audio_processor class.
Add a brief description and press the Finish button.
We have now completed the creation of the component description and the
following component editor view will appear:
MediaDesigner Component Design Tutorial 10
