core/com.nokia.carbide.cpp.doc.user/html/reference/view_mifdef_editor.htm
changeset 0 fb279309251b
child 949 57698352558c
child 1207 e265bbe56eb0
equal deleted inserted replaced
-1:000000000000 0:fb279309251b
       
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
       
     2 "http://www.w3.org/TR/html4/loose.dtd">
       
     3 <html><head>
       
     4 <title>MIF Editor</title>
       
     5 <link rel="StyleSheet" href="../../book.css" type="text/css"/>
       
     6 </head>
       
     7    <body>
       
     8 
       
     9 <h2>MBM/MIF Editor</h2>
       
    10 	  
       
    11 	 <p>The MIF Editor allows you to create or edit the <span class="code">.mif</span> files list of scalable icons (<span class="code">.svg</span>)
       
    12      included in  a S60 v3.0 and later GUI projects as well as standard <span class="code">.bmp</span> files. A .mif file is a MSX Interchange Format (MIF) file that should be built by the project. MIF files replace the functionality of AIF (and MBM) files.</p>
       
    13 	 <p class="note"><b>NOTE</b> This editor is only supported by the S60 3.0  and later SDKs.</p>
       
    14 	 <p class="note"><b>NOTE</b> For resources that are included after creating a project, you should ensure that the output location is set correctly by viewing the file properties. The output location is set to &quot;{EPOCROOT}\epoc32\include&quot; by default, so if an alternate location is required you can set this in the file properties.</p>
       
    15 	 <p>The MIF Editor appears when a MIF  file is
       
    16 	   opened for editing. To open the editor double-click on a .mif file in the Symbian Project Navigator view (figure 1), or select a scalable icon makefile (for example, Icons_scalable_dc.mk), right-click and select the Add MBM/MIF Entry command.</p>
       
    17 	 <p>&nbsp;</p>
       
    18 	 <p align="center" class="Image"><img src="../tasks/projects/images/mif_file_symprojnav.png" width="299" height="292"></p>
       
    19 		<p class="figure">Figure 1 - MIF File in Symbian Project Navigator</p>
       
    20 		<p>&nbsp;</p>
       
    21 		<p><img src="../tasks/projects/images/MBM_MIF_editor.png" width="900" height="600"> </p>
       
    22 		<p class="figure">Figure 2 - MBM/MIF Editor</p>
       
    23 		<h5>Table 1. MBM/MIF Editor &mdash;Items</h5>
       
    24 		<table width="94%"  border="0" cellpadding="2" cellspacing="0">
       
    25           <tr>
       
    26             <th width="32%" scope="col">Item</th>
       
    27             <th width="68%" scope="col">Explanation</th>
       
    28           </tr>
       
    29           <tr>
       
    30             <td><b>Target File </b></td>
       
    31             <td><p>Specifies the EPOCROOT relative path for the compiled images. Click the Default button to set the target file based on the SDK and project name. </p></td>
       
    32           </tr>
       
    33           <tr>
       
    34             <td><b>Header File </b></td>
       
    35             <td>Shows the generated header file. Select the Header option in the Header Generation group to create a default .mbg file. The path cannot be edited in this field. </td>
       
    36           </tr>
       
    37           <tr>
       
    38             <td><b>Header Generation</b></td>
       
    39             <td><p>Options include:</p>
       
    40                 <ul>
       
    41                   <li>No header - If selected, no .mbg header will be generated. </li>
       
    42                   <li>Header - If selected, a .mbg header will be generated.</li>
       
    43               </ul></td>
       
    44           </tr>
       
    45           <tr>
       
    46             <td><b>Up</b></td>
       
    47             <td>Select an image in the list and click Up to move the selection one position up in the list.</td>
       
    48           </tr>
       
    49           <tr>
       
    50             <td><b>Down</b></td>
       
    51             <td><p>Select an image in the list and click Down to move the selection one position down in the list. </p></td>
       
    52           </tr>
       
    53           <tr>
       
    54             <td><b>Pair Image and Mask </b></td>
       
    55             <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>
       
    56           </tr>
       
    57           <tr>
       
    58             <td><b>Split Image and Mask </b></td>
       
    59             <td>Select a paired BMP image in the list and click this button to split the image into image and mask entries. </td>
       
    60           </tr>
       
    61           <tr>
       
    62             <td><b>Swap Image and Mask </b></td>
       
    63             <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>
       
    64           </tr>
       
    65           <tr>
       
    66             <td><b>Add From Project </b></td>
       
    67             <td>Click this button to open an Add Images from Project dialog to reference available images in the project.</td>
       
    68           </tr>
       
    69           <tr>
       
    70             <td><b>Add From Filesystem </b></td>
       
    71             <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>
       
    72           </tr>
       
    73           <tr>
       
    74             <td><b>Remove</b></td>
       
    75             <td>Select an image and click Remove to remove image entry from the list. This does not delete file from directory.</td>
       
    76           </tr>
       
    77           <tr>
       
    78             <td><b>Color depth </b></td>
       
    79             <td>Select the bit depth used to encode the image at build time.</td>
       
    80           </tr>
       
    81           <tr>
       
    82             <td><b>Mask depth </b></td>
       
    83             <td><p>Select the bit depth used to encode the mask at build time. Options include:</p>
       
    84                 <ul>
       
    85                   <li>n/a - Do not apply mask depth to images </li>
       
    86                   <li>1 - A 1-bit mask treats pixels as &quot;on/off&quot; bits, where black is opaque and white is transparent. </li>
       
    87                   <li>8 - An 8-bit mask is treated as alpha values, where black is transparent and white is opaque.</li>
       
    88               </ul></td>
       
    89           </tr>
       
    90           <tr>
       
    91             <td><b>Color format </b></td>
       
    92             <td>Select Color to encode the image(s) as color or select Grayscale to encode the image(s) as grayscale.</td>
       
    93           </tr>
       
    94           <tr>
       
    95             <td><b>Set from image </b></td>
       
    96             <td>Click this button to auto-detect the image depth, mask depth, and color/grayscale setting from the image contents.</td>
       
    97           </tr>
       
    98           <tr>
       
    99             <td><b>Preview</b></td>
       
   100             <td>A preview of the image as it will appear at runtime. </td>
       
   101           </tr>
       
   102         </table>
       
   103 		<p>&nbsp;</p>
       
   104    <div id="footer">Copyright &copy; 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>
       
   105 
       
   106    </body>
       
   107 </html>
       
   108