add documentation and hook up tray dialog for abld deps tracking query (bug 9227)
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head>
<title>AIF Editor in AIF Definition File</title>
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
</head>
<body>
<h2>AIF Editor</h2>
<p>
The <b>AIF Editor</b> allows you to specify the Symbian OS
resource file and bitmaps that should be included in a Symbian OS application
information (AIF) file. Use of AIF files is restricted to using <span class="filename">.bmp</span> files and works for versions 2.x and later releases of the Symbian OS SDKs. For more information, see <a href="../concepts/AIFDefWizard.html">AIF File</a>.</p>
<p>
The AIF Editor is shown when a new AIF file is created or an existing file is edited in the Resources group of the MMP editor's Sources tab. Refer to <a href="../tasks/AppInfoFile.html">Creating an AIF File</a> for more information.</p>
<p align="center" class="Image"><img src="../tasks/projects/images/AIF_editor2.png" width="700" height="575" /></p>
<h5>Table 1. AIF Editor —Items</h5>
<table width="94%" border="0" cellpadding="2" cellspacing="0">
<tr>
<th width="32%" scope="col">Item</th>
<th width="68%" scope="col">Explanation</th>
</tr>
<tr>
<td><b>Target File </b></td>
<td><p>Specifies the filename of the compiled AIF file, relative to the target path. Click the untitled.aif button to set the target file based on the SDK and project name.</p></td>
</tr>
<tr>
<td><b>Resource File Path </b></td>
<td>Choose a resource file from the current project, browse the file system or enter the path. For relative paths use the Carbide project as the reference point, not the MMP file location. </td>
</tr>
<tr>
<td><b>Up</b></td>
<td>Select an image in the list and click Up to move the selection one position up in the list.</td>
</tr>
<tr>
<td><b>Down</b></td>
<td><p>Select an image in the list and click Down to move the selection one position down in the list. </p></td>
</tr>
<tr>
<td><b>Pair Image and Mask </b></td>
<td>Select two adjacent unpaired BMP image entries in the list and click this button to combine the images together into image/mask pairs.</td>
</tr>
<tr>
<td><b>Split Image and Mask </b></td>
<td>Select a paired BMP image in the list and click this button to split the image into image and mask entries. </td>
</tr>
<tr>
<td><b>Swap Image and Mask </b></td>
<td>Select a paired BMP image in the list and click this button to swap the image and mask files and format information in paired image entries. </td>
</tr>
<tr>
<td><b><a href="add_from_project.htm">Add From Project</a> </b></td>
<td>Click this button to open an Add Images from Project dialog to reference available images in the project.</td>
</tr>
<tr>
<td><b><a href="add_from_filesys.htm">Add From Filesystem</a></b></td>
<td>Click this button to open an Add Images From Filesystem dialog to locate and reference existing images in the filesystem or copy images to the project.</td>
</tr>
<tr>
<td><b>Remove</b></td>
<td>Select an image and click Remove to remove image entry from the list. This does not delete file from directory.</td>
</tr>
<tr>
<td><b>Color depth </b></td>
<td>Select the bit depth used to encode the image at build time.</td>
</tr>
<tr>
<td><b>Mask depth </b></td>
<td><p>Select the bit depth used to encode the mask at build time. Options include:</p>
<ul>
<li>n/a - Do not apply mask depth to images </li>
<li>1 - A 1-bit mask treats pixels as "on/off" bits, where black is opaque and white is transparent. </li>
<li>8 - An 8-bit mask is treated as alpha values, where black is transparent and white is opaque.</li>
</ul></td>
</tr>
<tr>
<td><b>Color format </b></td>
<td>Select Color to encode the image(s) as color or select Grayscale to encode the image(s) as grayscale.</td>
</tr>
<tr>
<td><b>Preview</b></td>
<td>A preview of the image as it will appear at runtime. </td>
</tr>
</table>
<p> </p>
<h5>Related concepts</h5>
<ul>
<li><a href="../concepts/AIFDefWizard.html">AIF File</a></li>
</ul>
<h5>Related tasks</h5>
<ul>
<li><a href="../tasks/AppInfoFile.html">Creating an AIF File</a></li>
</ul>
<div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
</body>
</html>