Symbian3/PDK/Source/GUID-6A4DCFE7-FA86-5DFF-AF53-46604525889B.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Tue, 30 Mar 2010 11:56:28 +0100
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 14 578be2adaf3e
permissions -rw-r--r--
Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"

<?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-6A4DCFE7-FA86-5DFF-AF53-46604525889B" xml:lang="en"><title>Image
conversion library test suite </title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>This topic describes the image conversion test suite, which consists of
two regression test suites that provide tests for the Image Decoder and Encoder.
It provides an overview about the test suite, its coverage, how to set up
the test environment to execute the test suite, and how to find
further information about the test cases offered by this test suite. </p>
<section><title>Test suite Overview</title> <p>The Multimedia Image Conversion
Library Test Suite consists of two regression test suites that provide tests
for the Image Decoder and Encoder; that is, <xref href="GUID-8F2953B2-E64E-3D8B-B30B-B35B373368D4.dita"><apiname>CImageDecoder</apiname></xref> and <xref href="GUID-737DA130-9A66-39E2-9E68-2E65F37E02C8.dita"><apiname>CImageEncoder</apiname></xref> classes. </p> <p> <b>Note: </b> Any
mention of “<filepath>epoc32</filepath>” is offset by <filepath>%EPOCROOT%</filepath>;
that is, the full path where the EPOC tree is installed. </p> </section>
<section><title>Test Approach</title> <p>This test suite provides a basic
run through of the public functionality of the <xref href="GUID-8F2953B2-E64E-3D8B-B30B-B35B373368D4.dita"><apiname>CImageDecoder</apiname></xref> and <xref href="GUID-737DA130-9A66-39E2-9E68-2E65F37E02C8.dita"><apiname>CImageEncoder</apiname></xref> APIs.
The purpose of the Test Suite is to provide a regression test suite of Published
All APIs for the <xref href="GUID-8F2953B2-E64E-3D8B-B30B-B35B373368D4.dita"><apiname>CImageDecoder</apiname></xref> and <xref href="GUID-737DA130-9A66-39E2-9E68-2E65F37E02C8.dita"><apiname>CImageEncoder</apiname></xref> classes.
Negative testing is performed wherever it is needed, to confirm that correct
errors are returned when incorrect parameters are given. The tests are automated
and does not require user intervention. </p> </section>
<section><title>Coverage omissions</title> <p>None. </p> </section>
<section><title>Test suite details</title> <p><b>Test
script source tree location</b> </p> <p>Descriptions of the test cases i.e.
test scripts can be found at the following location: </p> <ul>
<li id="GUID-88543CFE-D7B8-50B0-A52C-2B5FC347D878"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\T_ImageDecoder\scripts\MM-ICL-DECDE-PublicApi.script
                  </filepath> </p> </li>
<li id="GUID-B855B7B8-4EAC-56BA-8C44-EC61C3D15F27"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\T_ImageEncoder\scripts\MM-ICL-ENCDE-PublicApi.script</filepath> </p> </li>
</ul> <p><b>Test
script EPOC tree location</b> </p> <p>When the tests are built for emulator
or hardware (<filepath>winscw</filepath>/<filepath>armv5</filepath>), the
scripts are exported into the following location in the EPOC tree: </p> <ul>
<li id="GUID-B34C17CA-7E63-5693-A4D4-3C86961843B8"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\MM-ICL-DECDE-PublicApi.script
                  </filepath>  </p> </li>
<li id="GUID-97173A22-9ACE-5223-9F67-7ED6B62BB149"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\MM-ICL-ENCDE-PublicApi.script</filepath> </p> </li>
</ul> <p><b>Test
script build location</b> </p> <p>When the tests are built, the scripts are
built into the following location: </p> <p> <filepath>%EPOCROOT%\epoc32\release\&lt;winscw|armv5&gt;\&lt;udeb|urel&gt;\Z\multimedia.</filepath> </p> <p> <b>Note:</b> When the tests are built to be executed on hardware the files
are built into the <filepath>z</filepath> drive of the ROM. </p> <p><b>Test data source tree location</b> </p> <p>Test data files can be found
in the following location: </p> <ul>
<li id="GUID-016CCEFE-E3A9-5E7B-9252-353C1DB94019"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\MM-ICL-DECDE-PublicApi.ini</filepath> </p> </li>
<li id="GUID-CB732402-0E5A-559C-B00D-74BF8B5C00D3"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\1bit.bmp</filepath> </p> </li>
<li id="GUID-670C0FD9-6ACE-5ED6-B5A6-EB0FBC991605"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\1bit.gif</filepath> </p> </li>
<li id="GUID-03F29330-2E55-519E-8676-6F57B9FF3063"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\1bit.ota</filepath> </p> </li>
<li id="GUID-A1771292-C0E9-59B4-8CE8-465861778227"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\1bit.png</filepath> </p> </li>
<li id="GUID-715B8AE4-F22D-5ED5-9096-DE00AB39DA66"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\1bit.tif</filepath> </p> </li>
<li id="GUID-34DC2A3A-7F40-5CC6-8AD7-A5A0F8B24174"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\1bit.wbmp</filepath> </p> </li>
<li id="GUID-EC54AD95-1A1C-59F1-8DAB-9ECD21AC8E52"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\1bitG3.tif</filepath> </p> </li>
<li id="GUID-1BA9300D-C736-5222-935A-E1A382496679"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\1bitG4.tif</filepath> </p> </li>
<li id="GUID-7F4A8E3C-8839-5291-A98F-B185BA8D2C52"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\24bit.apm</filepath> </p> </li>
<li id="GUID-FED104EF-1D9F-5CB6-86E8-77876BA1D7A6"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\24bit.bmp</filepath> </p> </li>
<li id="GUID-496FBAD9-8520-5F18-B12A-99DD6AC93573"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\24bit.clp</filepath> </p> </li>
<li id="GUID-11112B8D-BF09-5288-BC88-581BB3D91C7F"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\24bit.jpg</filepath> </p> </li>
<li id="GUID-B53D3698-CA59-5CCC-B8DF-E7E8CE6589B1"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\24bit.mng</filepath> </p> </li>
<li id="GUID-25A336A2-78D4-53C4-84DF-5C8133C4D9BC"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\</filepath> </p> </li>
<li id="GUID-28FF6572-FC44-51E0-9011-414C53AE80B8"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\24bit.png</filepath> </p> </li>
<li id="GUID-1AE20C3D-3480-56F9-A4D6-13AC08858035"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\24bit.tif</filepath> </p> </li>
<li id="GUID-02E61716-0233-5BB0-9094-4337F776F0A8"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\24bit.wmf</filepath> </p> </li>
<li id="GUID-615C66CE-503B-54EB-9EA4-15C5FABDD44E"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\2bit.gif</filepath> </p> </li>
<li id="GUID-9BB3EFBA-81BC-5832-96CA-92AF8CEF8751"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\4bit.bmp</filepath> </p> </li>
<li id="GUID-41E248E6-2324-57A1-A7DC-503F6C2DB3F2"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\4bit.gif</filepath> </p> </li>
<li id="GUID-53F81603-ED85-5096-B679-B25B8F1087E5"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\4bit.ico</filepath> </p> </li>
<li id="GUID-AA362036-7CAC-51C1-855D-7919CB48D4EA"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\4bit.png</filepath> </p> </li>
<li id="GUID-CDB668D2-D1EB-572D-A7FB-D7A37ACB1687"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\4bit.tif</filepath> </p> </li>
<li id="GUID-7CED44F7-7F5B-5465-B863-ECAF68C78594"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\6bit.gif</filepath> </p> </li>
<li id="GUID-D083EAC0-8839-5814-9C5B-94EB368401BB"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\8bit.bmp</filepath> </p> </li>
<li id="GUID-E76B07D6-605D-5DD9-BABE-4F2A11AEAD5D"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\8bit.gif</filepath> </p> </li>
<li id="GUID-43879E50-6393-5DB0-9AF9-97DC13843392"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\8bit.ico</filepath> </p> </li>
<li id="GUID-F810B4E5-7882-5DD5-AC72-B92BC91B441E"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\8bit.jpg</filepath> </p> </li>
<li id="GUID-F082B392-B0E6-5B33-8F72-943DC499F3A0"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\8bit.png</filepath> </p> </li>
<li id="GUID-A004BDDB-25E4-5BE8-AB0E-F7C36C7BDD0C"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\8bit.tif</filepath> </p> </li>
<li id="GUID-1ECF3453-2B93-5B3C-B25C-A4CDDFAD5425"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\commented.gif</filepath> </p> </li>
<li id="GUID-DE5029BE-9872-55A8-A7A3-341BAAB9306F"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\commented.jpg</filepath> </p> </li>
<li id="GUID-BFE3890C-FCAF-5088-A7DE-951FCB954370"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\corrupted.bmp</filepath> </p> </li>
<li id="GUID-94CAA9BC-D1CA-51C6-8AC0-6912FEFF636E"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\dec16bit.mbm</filepath> </p> </li>
<li id="GUID-EDD2D9FC-7392-53D1-83D6-8E45EE9C2D46"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\dec1bit.mbm</filepath> </p> </li>
<li id="GUID-D94358B2-4732-53C4-B998-18BC3AF92CC6"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\dec24bit.mbm</filepath> </p> </li>
<li id="GUID-CE3323F1-ED68-5DBD-86BE-307BC871C487"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\dec2bit.mbm</filepath> </p> </li>
<li id="GUID-FDF5DF6F-C628-5146-AD29-0F467284C239"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\dec4bit.mbm</filepath> </p> </li>
<li id="GUID-1F69CC18-063D-546E-A06E-D7A286DC5644"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\dec8bit.mbm</filepath> </p> </li>
<li id="GUID-B2061A7A-44DF-53CD-8CA6-5202846C1FA2"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\partial.bmp</filepath> </p> </li>
<li id="GUID-851C7ACC-39A8-5000-B074-81033FDFF8F7"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imagedecoder\testdata\thumbnail.jpg</filepath> </p> </li>
<li id="GUID-4C145EF7-BDDA-5C44-8231-20DAA6FFE3EB"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imageencoder\testdata\MM-ICL-ENCDE-PublicApi.ini</filepath> </p> </li>
<li id="GUID-447E5357-6758-5059-8C3E-60084C9BE490"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imageencoder\testdata\enc16bit.mbm</filepath> </p> </li>
<li id="GUID-2EBFE651-0B38-5DE9-B7AD-04CBEABA0C9E"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imageencoder\testdata\enc1bit.mbm</filepath> </p> </li>
<li id="GUID-8F4BA5F3-0730-5154-843F-6853CE7611D5"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imageencoder\testdata\enc24bit.mbm</filepath> </p> </li>
<li id="GUID-8B8D5CF3-6E76-5290-A92D-4D9C5A23A4FE"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imageencoder\testdata\enc2bit.mbm</filepath> </p> </li>
<li id="GUID-0955DD73-871D-5139-9863-D0FD92FD7F8B"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imageencoder\testdata\enc4bit.mbm</filepath> </p> </li>
<li id="GUID-662C1D6D-C466-5EA1-A098-6F1568D33DFA"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\icl\t_imageencoder\testdata\enc8bit.mbm</filepath> </p> </li>
<li id="GUID-42815C0F-C12E-57C6-9E0E-E0952E0D06AD"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\testdata</filepath>  </p> </li>
<li id="GUID-36D3E9AC-717E-5A7F-821A-7BB0AAE67F07"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\testdata\t_multimedia.ini</filepath>  </p> </li>
<li id="GUID-04DA793D-38F5-5AD5-A968-D9050A3A76F2"><p> <filepath>…\os\mm\mmapitest\mmsvs\suite\testdata\t_multimedia_location.ini</filepath> </p> </li>
</ul> <p><b>Test
data files EPOC tree location</b> </p> <p>When the tests are built for emulator
or hardware (winscw or armv5), the data files are exported into the following
location in the EPOC tree: </p> <ul>
<li id="GUID-0E1B9A75-194D-516E-8F31-E1A7256D714A"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\MM-ICL-DECDE-PublicApi.ini</filepath> </p> </li>
<li id="GUID-27C60550-6A66-5643-B710-018253DF38DD"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\MM-ICL-ENCDE-PublicApi.ini</filepath> </p> </li>
<li id="GUID-B36D4F6A-6D5F-50AD-A977-50512F43211B"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_multimedia.ini</filepath> </p> </li>
<li id="GUID-65B76407-2A74-578D-95DC-EB77087E66CC"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_multimedia_location.ini</filepath> </p> </li>
<li id="GUID-8B118774-45E4-5CEC-A8F2-CB0C6814D184"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\24bit.apm</filepath> </p> </li>
<li id="GUID-2DF12E9E-9188-5D1E-90B6-5E9DF92C4C1B"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\1bit.bmp</filepath> </p> </li>
<li id="GUID-236C886B-8154-5321-BF3C-54042FED64A6"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\4bit.bmp</filepath> </p> </li>
<li id="GUID-AB5CFEE2-F29B-56CC-BE39-DA69741D62E0"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\8bit.bmp</filepath> </p> </li>
<li id="GUID-D635C5D7-64C8-5BA9-9E91-43BEA5485352"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\24bit.bmp</filepath> </p> </li>
<li id="GUID-73F02DFC-7CFC-5FB5-A476-D8C8B9357F76"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\24bit.clp</filepath> </p> </li>
<li id="GUID-86D83E96-6D96-5BC1-AFE6-6892793F2691"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\1bit.gif</filepath> </p> </li>
<li id="GUID-0023D1BF-852E-5B86-AF38-978C3B514E6C"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\2bit.gif</filepath> </p> </li>
<li id="GUID-EEEFAD72-5460-5B46-8736-8020689B9D98"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\4bit.gif</filepath> </p> </li>
<li id="GUID-196CD65E-3A3D-5107-B8F6-EA2644C4D297"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\6bit.gif</filepath> </p> </li>
<li id="GUID-F1D28852-6FA0-5BB4-847F-F2E65D86C4CE"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\8bit.gif</filepath> </p> </li>
<li id="GUID-2474A386-CEAB-56C5-B574-80988956C280"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\commented.gif</filepath> </p> </li>
<li id="GUID-CDD4F248-DE16-5853-AA64-B0A0A061AF7E"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\4bit.ico</filepath> </p> </li>
<li id="GUID-4521F0AE-AB1C-5106-BD00-C1D380012E73"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\8bit.ico</filepath> </p> </li>
<li id="GUID-DDD98204-8056-51FA-8711-323A403F2988"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\8bit.jpg</filepath> </p> </li>
<li id="GUID-68B6A520-F00C-5662-8018-C258C113E70C"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\24bit.jpg</filepath> </p> </li>
<li id="GUID-84FD0473-4C61-5446-A18E-A55938B897A7"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\thumbnail.jpg</filepath> </p> </li>
<li id="GUID-050712FB-81A4-591B-9F7D-F69D35BF8F06"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\commented.jpg</filepath> </p> </li>
<li id="GUID-097156BF-103F-5250-AEE8-BC9C2113E9DE"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\24bit.mng</filepath> </p> </li>
<li id="GUID-1F9313DF-ED5F-5C3A-9A29-E6AD05107348"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\1bit.ota</filepath> </p> </li>
<li id="GUID-DA1C2815-DE52-58EA-B420-FDB4F9AE0A6B"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\1bit.png</filepath> </p> </li>
<li id="GUID-3DA4CCE2-A8D5-5234-825E-FE556981C4B9"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\4bit.png</filepath> </p> </li>
<li id="GUID-453490D9-F7C9-5E82-9BBD-28B1B01F493D"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\8bit.png</filepath> </p> </li>
<li id="GUID-56F7DDB3-BC97-5BD1-A358-638BB9FF8EC3"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\24bit.png</filepath> </p> </li>
<li id="GUID-729CFFD3-CF1F-5BED-AEC7-686356241E22"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\1bitG3.tif</filepath> </p> </li>
<li id="GUID-8096D412-5651-57D7-87B7-D8E7EDC48245"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\1bit.tif</filepath> </p> </li>
<li id="GUID-8B2DE5DC-DA51-5A76-A79A-9382793CF77B"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\4bit.tif</filepath> </p> </li>
<li id="GUID-191B173D-830B-517F-9541-654931C1580B"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\8bit.tif</filepath> </p> </li>
<li id="GUID-3DC22DAB-623C-58D6-96D7-6EEEF7FE38A9"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\24bit.tif</filepath> </p> </li>
<li id="GUID-35980928-CFB1-5444-856C-F7B1DDF802F1"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\1bit.wbmp</filepath> </p> </li>
<li id="GUID-152E9600-4D41-5A52-A6DF-C958BA029544"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\24bit.wmf</filepath> </p> </li>
<li id="GUID-06BFE69F-4C79-57E4-8CD6-E1A10CBCDA7C"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\corrupted.bmp</filepath> </p> </li>
<li id="GUID-B4B0813B-149D-5A98-9BC2-AFF71E95F134"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imagedecoder\partial.bmp</filepath> </p> </li>
<li id="GUID-F6098E44-D889-5FE6-BD35-B441F4E29CF0"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imageencoder\MM-ICL-ENCDE-PublicApi.ini</filepath> </p> </li>
<li id="GUID-4BD81F84-E95B-56CA-B8FA-95ED0196E754"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imageencoder\1bit.mbm</filepath> </p> </li>
<li id="GUID-2402A580-CBC8-5C1B-9356-2451ED66171B"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imageencoder\2bit.mbm</filepath> </p> </li>
<li id="GUID-CBB102A0-2B6E-573A-BC24-5108ED527928"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imageencoder\4bit.mbm</filepath> </p> </li>
<li id="GUID-17BA4BB5-0A2D-5754-A0E3-95FB801623AC"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imageencoder\8bit.mbm</filepath> </p> </li>
<li id="GUID-7C84A057-4350-52F8-8ADB-64029556C6CB"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imageencoder\16bit.mbm</filepath> </p> </li>
<li id="GUID-C68F18A0-7A11-58D7-8EF3-0E143D970112"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imageencoder\24bit.mbm</filepath> </p> </li>
<li id="GUID-D2AE1BDD-FE63-5219-A673-978037393C7E"><p> <filepath>%EPOCROOT%\epoc32\data\Z\multimedia\t_imageencoder\corrupted.mbm</filepath> </p> </li>
</ul> <p><b>Test
data files build location</b> </p> <p>The build process builds the data <filepath>.ini</filepath> files
to the following location: </p> <p> <filepath>%EPOCROOT%\epoc32\release\&lt;winscw|armv5&gt;\&lt;udeb|urel&gt;\Z\multimedia\
                </filepath>  </p> <p>The test image files in the following
location: </p> <ul>
<li id="GUID-BCD12276-8B8B-5F37-9844-B5F5280302B4"><p> <filepath>%EPOCROOT%\epoc32\release\&lt;winscw|armv5&gt;\&lt;udeb|urel&gt;\Z\multimedia\t_imagedecoder</filepath> </p> </li>
<li id="GUID-086021DC-F4AA-59C9-82A3-8D6ABE7F7476"><p> <filepath>%EPOCROOT%\epoc32\release\&lt;winscw|armv5&gt;\&lt;udeb|urel&gt;\Z\multimedia\t_imageencoder</filepath> </p> </li>
</ul> <p> <b>Note:</b> When the tests are built to be executed on hardware
the files are built into the <filepath>z:</filepath> drive of the ROM. </p> <p><b>Test .driver File</b> </p> <p>The <filepath>comms-infras.driver</filepath> file
is found in the following location: </p> <p> <filepath>…\mmapitest\mmsvs\suite\testsuites\multimedia</filepath>  </p> <p>The <filepath>comms-infras.driver</filepath> file is used by the test driver to construct the test suite tree structure
and export all the appropriate files to the correct location in the <filepath>epoc32</filepath> tree
and on the device. </p> <p>When the tests are built, the <filepath>.driver</filepath> file
can be found in the following location: </p> <p> <filepath>%EPOCROOT%\epoc32\testdriver\testproduct</filepath>  </p> <p id="GUID-4B48F3F9-36EC-5BBF-8A84-9625C1343602"><b>TCS file source location</b> </p> <p>The <filepath>.tcs</filepath> file
can be found at the following location: </p> <p> <filepath>…\os\mm\mmapitest\mmsvs\suite\config\t_multimedia.tcs</filepath>  </p> <p><b> TCS file build location </b> </p> <p>When the tests are built, the <filepath>.tcs</filepath> file
is generated into the following location: </p> <p> <filepath>%EPOCROOT%\epoc32\release\&lt;winscw|armv5&gt;\&lt;udeb|urel&gt;\Z\multimedia</filepath> </p> <p> <b>Note:</b> When the tests are built to be executed on the hardware,
the files are built into the <filepath>z</filepath> drive of the ROM. </p> <p><b>Test global environment file</b> </p> <p>The <filepath>t_multimedia.ini</filepath> file
is the test suite global environment file, which contains the following configurable
parameters in the <filepath>[default_icl]</filepath> section: </p> <ul>
<li id="GUID-4A04FBA8-FC7C-57FD-8A86-C206CA7011B5"><p>The following keys define
the default UIDs of the various image types. </p> <table id="GUID-F46880D5-F9DB-599F-B7D3-FBE5EF159058">
<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
<thead>
<row>
<entry>Image type</entry>
<entry>UID</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <filepath>imagetype_gif</filepath>  </p> </entry>
<entry><p> <codeph>101F45B3</codeph>  </p> </entry>
</row>
<row>
<entry><p> <filepath>imagetype_tiff</filepath>  </p> </entry>
<entry><p> <codeph>101F45C4</codeph>  </p> </entry>
</row>
<row>
<entry><p> <filepath>imagetype_jpg</filepath>  </p> </entry>
<entry><p> <codeph>101F45D8</codeph>  </p> </entry>
</row>
<row>
<entry><p> <filepath>imagetype_bmp</filepath>  </p> </entry>
<entry><p> <codeph>101F45B0</codeph>  </p> </entry>
</row>
<row>
<entry><p> <filepath>imagetype_png</filepath>  </p> </entry>
<entry><p> <codeph>101F45C9</codeph>  </p> </entry>
</row>
<row>
<entry><p> <filepath>imagetype_ota</filepath>  </p> </entry>
<entry><p> <codeph>101F45D2</codeph>  </p> </entry>
</row>
<row>
<entry><p> <filepath>imagetype_mbm</filepath>  </p> </entry>
<entry><p> <codeph>101F45CC</codeph>  </p> </entry>
</row>
<row>
<entry><p> <filepath>imagetype_ico</filepath>  </p> </entry>
<entry><p> <codeph>101F45D5</codeph>  </p> </entry>
</row>
<row>
<entry><p> <filepath>imagetype_wbmp</filepath>  </p> </entry>
<entry><p> <codeph>101F45CF</codeph>  </p> </entry>
</row>
<row>
<entry><p> <filepath>imagetype_mng</filepath>  </p> </entry>
<entry><p> <codeph>101F7C53</codeph>  </p> </entry>
</row>
</tbody>
</tgroup>
</table> </li>
<li id="GUID-93F197C3-25BF-5AC6-8AA5-62195DD1D839"><p>The following keys define
the default MIME type of the various image types. </p> <table id="GUID-C4666D04-F196-550E-8D45-E717A770B9F3">
<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
<thead>
<row>
<entry>Image type</entry>
<entry>MIME type</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <filepath>mime_gif</filepath>  </p> </entry>
<entry><p>image/gif </p> </entry>
</row>
<row>
<entry><p> <filepath>mime_tiff</filepath>  </p> </entry>
<entry><p>image/tiff </p> </entry>
</row>
<row>
<entry><p> <filepath>mime_jpg</filepath>  </p> </entry>
<entry><p>image/jpeg </p> </entry>
</row>
<row>
<entry><p> <filepath>mime_bmp</filepath>  </p> </entry>
<entry><p>image/bmp </p> </entry>
</row>
<row>
<entry><p> <filepath>mime_png</filepath>  </p> </entry>
<entry><p>image/png </p> </entry>
</row>
<row>
<entry><p> <filepath>mime_ico</filepath>  </p> </entry>
<entry><p>image/ico </p> </entry>
</row>
<row>
<entry><p> <filepath>mime_ota</filepath>  </p> </entry>
<entry><p>image/x-ota-bitmap </p> </entry>
</row>
<row>
<entry><p> <filepath>mime_mbm</filepath>  </p> </entry>
<entry><p>image/x-epoc-mbm </p> </entry>
</row>
<row>
<entry><p> <filepath>mime_wbm</filepath>  </p> </entry>
<entry><p>image/vnd.wap.wbmp </p> </entry>
</row>
<row>
<entry><p> <filepath>mime_wmf</filepath>  </p> </entry>
<entry><p>image/x-wmf </p> </entry>
</row>
<row>
<entry><p> <filepath>mime_mng</filepath>  </p> </entry>
<entry><p>image/mng </p> </entry>
</row>
</tbody>
</tgroup>
</table> </li>
</ul> <p>This enables you to modify these parameter values, so that the tests
may be executed with different test data. For example, the UIDs of the various
image types on the device under test may be different from the default values.
If the UID of gif images on the device under test is <codeph>102G48C6</codeph> then <codeph>imagetype_gif</codeph> should
be set to <codeph>imagetype_gif =              102G48C6</codeph>, to enable
all tests, which use gif images to use this UID. </p> </section>
<section><title>Test Environment and Execution</title> <p><b>Support</b> </p> <p>For support issues related to this Test Suite description and issues to running
the tests, test pass rates, and potential defects, contact Symbian or your
SDK provider. In most instances this will be either through the Symbian technical
consulting teams, the SDK provider forums or via the developer area of <xref href="http:\\www.Symbian.org" scope="external">Symbian</xref> website. </p> </section>
</conbody></concept>