diff -r 000000000000 -r fb279309251b core/com.nokia.carbide.cpp.doc.user/html/reference/view_mifdef_editor.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/view_mifdef_editor.htm Fri Apr 03 23:33:03 2009 +0100 @@ -0,0 +1,108 @@ + + +MIF Editor + + + + +

MBM/MIF Editor

+ +

The MIF Editor allows you to create or edit the .mif files list of scalable icons (.svg) + included in a S60 v3.0 and later GUI projects as well as standard .bmp 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.

+

NOTE This editor is only supported by the S60 3.0 and later SDKs.

+

NOTE 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 "{EPOCROOT}\epoc32\include" by default, so if an alternate location is required you can set this in the file properties.

+

The MIF Editor appears when a MIF file is + 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.

+

 

+

+

Figure 1 - MIF File in Symbian Project Navigator

+

 

+

+

Figure 2 - MBM/MIF Editor

+
Table 1. MBM/MIF Editor —Items
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ItemExplanation
Target File

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.

Header File 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.
Header Generation

Options include:

+
    +
  • No header - If selected, no .mbg header will be generated.
    • +
  • Header - If selected, a .mbg header will be generated.
    • +
UpSelect an image in the list and click Up to move the selection one position up in the list.
Down

Select an image in the list and click Down to move the selection one position down in the list.

Pair Image and Mask Select two adjacent unpaired BMP image entries in the list and click this button to combine the images together into image/mask pairs.
Split Image and Mask Select a paired BMP image in the list and click this button to split the image into image and mask entries.
Swap Image and Mask 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.
Add From Project Click this button to open an Add Images from Project dialog to reference available images in the project.
Add From Filesystem 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.
RemoveSelect an image and click Remove to remove image entry from the list. This does not delete file from directory.
Color depth Select the bit depth used to encode the image at build time.
Mask depth

Select the bit depth used to encode the mask at build time. Options include:

+
    +
  • n/a - Do not apply mask depth to images
    • +
  • 1 - A 1-bit mask treats pixels as "on/off" bits, where black is opaque and white is transparent.
    • +
  • 8 - An 8-bit mask is treated as alpha values, where black is transparent and white is opaque.
    • +
Color format Select Color to encode the image(s) as color or select Grayscale to encode the image(s) as grayscale.
Set from image Click this button to auto-detect the image depth, mask depth, and color/grayscale setting from the image contents.
PreviewA preview of the image as it will appear at runtime.
+

 

+ + + + + \ No newline at end of file