core/com.nokia.carbide.cpp.doc.user/html/reference/MBMEditor.html
author fturovic <frank.turovich@nokia.com>
Wed, 06 Oct 2010 10:31:32 -0500
changeset 2131 ff0156b93599
parent 1510 90c95d26606c
permissions -rw-r--r--
moved inf, mmp, remote conn, and views to project folder
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1510
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     2
<title>MBM Editor</title>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     3
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     4
</head>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     5
   <body>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     6
   <h2>MBM Editor</h2>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     7
	  
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     8
	 <p>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     9
		The <b>MBM Editor</b> allows you to specify the bitmaps that
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 1510
diff changeset
    10
		should be included in a Symbian multi-bitmap (MBM) file. Use of MBM files for general purpose graphics is restricted to using <span class="filename">.bmp</span> files and works for versions 2.x and later releases of the Symbian SDKs. For more
1510
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    11
		information, see <a href="../concepts/MBMDefWizard.html">MBM File</a> and <a href="../tasks/Multi-BitmapFile.html">Creating a MBM File</a>.   </p>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    12
<p>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    13
		The MBM Editor is shown when an MBM file is
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    14
	 opened for editing:</p>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    15
     <p align="center" class="Image"><img src="images/wnd_edit_mbm_contents.png" alt="Edit MBM Contents window" width="900" height="600"></p>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    16
   <p class="figure">Figure 1 - MBM Editor</p>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    17
    <h5>Table 1. MBM Editor &mdash;Items</h5>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    18
    <table width="94%"  border="0" cellpadding="2" cellspacing="0">
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    19
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    20
        <th width="32%" scope="col">Item</th>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    21
        <th width="68%" scope="col">Explanation</th>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    22
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    23
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    24
        <td><b>Target File </b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    25
        <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>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    26
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    27
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    28
        <td><b>Header File </b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    29
        <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>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    30
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    31
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    32
        <td><b>Header Generation</b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    33
        <td><p>Options include:</p>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    34
            <ul>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    35
              <li>No header - If selected, no .mbg header will be generated. </li>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    36
              <li>Header - If selected, a .mbg header will be generated.</li>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    37
          </ul></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    38
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    39
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    40
        <td><b>Up</b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    41
        <td>Select an image in the list and click Up to move the selection one position up in the list.</td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    42
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    43
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    44
        <td><b>Down</b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    45
        <td><p>Select an image in the list and click Down to move the selection one position down in the list. </p></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    46
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    47
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    48
        <td><b>Pair Image and Mask </b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    49
        <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>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    50
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    51
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    52
        <td><b>Split Image and Mask </b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    53
        <td>Select a paired BMP image in the list and click this button to split the image into image and mask entries. </td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    54
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    55
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    56
        <td><b>Swap Image and Mask </b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    57
        <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>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    58
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    59
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    60
        <td><b><a href="add_from_project.htm">Add From Project</a> </b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    61
        <td>Click this button to open an Add Images from Project dialog to reference available images in the project.</td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    62
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    63
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    64
        <td><b><a href="add_from_filesys.htm">Add From Filesystem</a></b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    65
        <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>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    66
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    67
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    68
        <td><b>Remove</b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    69
        <td>Select an image and click Remove to remove image entry from the list. This does not delete file from directory.</td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    70
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    71
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    72
        <td><b>Color depth </b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    73
        <td>Select the bit depth used to encode the image at build time.</td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    74
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    75
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    76
        <td><b>Mask depth </b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    77
        <td><p>Select the bit depth used to encode the mask at build time. Options include:</p>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    78
            <ul>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    79
              <li>n/a - Do not apply mask depth to images </li>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    80
              <li>1 - A 1-bit mask treats pixels as &quot;on/off&quot; bits, where black is opaque and white is transparent. </li>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    81
              <li>8 - An 8-bit mask is treated as alpha values, where black is transparent and white is opaque.</li>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    82
          </ul></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    83
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    84
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    85
        <td><b>Color format </b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    86
        <td>Select Color to encode the image(s) as color or select Grayscale to encode the image(s) as grayscale.</td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    87
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    88
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    89
        <td><b>Set from image </b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    90
        <td>Click this button to auto-detect the image depth, mask depth, and color/grayscale setting from the image contents.</td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    91
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    92
      <tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    93
        <td><b>Preview</b></td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    94
        <td>A preview of the image as it will appear at runtime. </td>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    95
      </tr>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    96
    </table>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    97
    <h5>Related  concepts</h5>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    98
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    99
   <ul>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
   100
     <li><a href="../concepts/MBMDefWizard.html">MBM File</a></li>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
   101
   </ul>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
   102
   <h5>Related tasks</h5>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
   103
   <ul>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
   104
     <li><a href="../tasks/Multi-BitmapFile.html">Creating an MBM File</a></li>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
   105
   </ul>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
   106
   <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>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
   107
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
   108
   </body>
90c95d26606c minor edits and updates to images
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
   109
   </html>
0
fb279309251b DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff changeset
   110