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