Exporting Composer content

From the BlackBerry Composer, you can export content to the following formats:
  • .svg
  • .pmb
  • .pme
  • .png
  • .gif
  • animated .gif

The BlackBerry Composer exports fonts that are not BlackBerry device system fonts as images.

Export to an SVG file

When you export your content to .svg format, you can compile the content to make it available for play on the BlackBerry Browser, or you can add it to your theme in Theme Builder and user it as a Home screen background.
  1. From the File menu, click Export > SVG.
  2. On the File tab, specify the file title and properties.

    Field

    Description

    Title

    Specify a title for the animation.

    Description

    Specify a description for the animation.

    Allow Zoom and Pan

    Enable zooming and panning.

    Export All Layers

    Export all layers of the animation. If this option is not selected, only visible layers are exported.

    Export SVG Tiny 1.1

    Select the Export SVG Tiny 1.1 check box to export the SVG in the Tiny 1.1 format to embed SVG within java applications. To export the SVG for use in themes, clear the Export SVG Tiny 1.1 check box.

    Dimensions in %

    Specify the dimensions for the animation as a percentage. Ensure that you use this option for web-based content.

  3. On the Image tab, specify whether you want to export your images in .gif or .png format.

    Image type

    Option

    Description

    PNG

    Filter

    • None compresses the image without a filter. This option is recommended for indexed-color and bitmap-mode images.
    • Sub optimizes the compression of images with even horizontal patterns or blends.
    • Up optimizes the compression of images with even vertical patterns.
    • Average optimizes the compression of low-level noise by averaging the color values of adjacent pixels.
    • Path optimizes the compression of low-level noise by reassigning adjacent color values.
    • All applies the filter—Sub, Up, Average, or Path—that is best-suited for the image. Select All if you are unsure of which filter to use.
     

    Compression

    Specify a method to reduce the file size.

    GIF and PNG

    Interlace

    When you select this check box, images first appear blurry and become sharper as they are downloaded. When Interlace is cleared, images appear gradually, top to bottom, as they are downloaded.

    With still .gif images, interlacing enables users with slow connections to click past an image they are not interested in viewing without having to download the whole image. Interlacing is not recommended for animated .gifs.

     

    Always Export images

    Select the Always Export images check box to always export the images to disk. To only update images when they are changed or for new images, clear the Always Export images check box.

     

    Use Images On Disk

    Select the Use Images On Disk check box to use the original images on disk instead of exporting out new ones.

  4. On the Content Directory tab, click the Open icon and select where to export your images and sounds.
  5. In the Color Reduction section, adjust the color settings of your exported file.

    Field

    Description

    Color Mode

    Select the mode to use.

    Palette

    This drop-down list is available when you select Palette from the Color Mode drop-down list. Determine which set of 256 (or fewer) colors is used in the exported animation:

    • Adaptive automatically selects a set of colors that best approximate the original.
    • Web-safe uses a standard set of 216 colors. Web-safe colors are recommended for BlackBerry devices.

    Dithering

    Dithering might improve image quality. Selecting this option increases your file size.

    From the Dithering drop-down list, select the type of error diffusion to use.

    Dithering Noise

    From the Dithering Noise drop-down list, select a value.

  6. To name and save the current export settings for later use or to load a previously saved group of settings, select the Save current settings when closing check box.
  7. Click OK.

Export to a PMB file

You can export your content to .pmb format. When you export to .pmb format, any external resources, such as images or sound files, are bundled together into a single file. You can view .pmb content on your BlackBerry device.
  1. On the File menu, click Export > PMB.
  2. Specify the name and location for the .pmb file.
  3. Click Save. The BlackBerry Composer transcodes and bundles your file and any external resources into a .pmb file.

Export to a PME file

You can export your project to .pme format so that you can view your content on your BlackBerry device.
  1. On the File menu, click Export > PME. The Save As dialog box appears.
  2. Specify the name and location for the .pme file.
  3. Click Save. The BlackBerry Composer transcodes your file into a .pme file.

Note: Your image and sound files are saved relative to the location of the .pme file.

Export to a GIF or PNG file

You can export your content to .gif and .png formats, which are useful file formats for incorporating into a mobile media file or for viewing your content on third-party handhelds or Internet browsers.
  1. Perform one of the following actions:
    • On the File menu, click Export > GIF.
    • On the File menu, click Export > PNG.
  2. In the Information section, change the following settings:

    Field

    Description

    Show Preview

    Select this option to display a preview pane on the right side of the dialog box. You can preview changes before you update the image.

    Update

    View information on the file properties after making changes to other properties on the dialog box.

    If you select Show Preview, you can view your changes when you click the Update button.

    Live Update

    Select this check box to update the information automatically.

    Note: If your computer has a slow processor, you might experience slower processing when using Live Update.

  3. In the Generic Options section, select any of the following check boxes.

    Option

    Description

    Override Background Color

    Select this check box to use a different background color than that set in the BlackBerry Composer. Click the color swatch and click a color.

    Use Temporary Image Cache

    Select this check box for smaller content files to improve performance when previewing different export settings or re-exporting a BlackBerry Composer file that has not been changed.

    Interlace

    When you select this check box, images first appear blurry and become sharper as they are downloaded. When Interlace is not selected, images appear gradually, top to bottom, as they download.

    With still GIF images, interlacing allows users with slow modem connections to click past an image they are not interested in viewing without having to download the whole thing. Do not use Interlacing for animated GIFs.

    Note: With larger images, the cache can consume a lot of memory and, depending on how much RAM is available, might need to be turned off.

  4. Depending on the type of export, select the applicable options.

    Field

    Description

    Filter

    • None compresses the image without a filter. This option is recommended for indexed-color and Bitmap-mode images.
    • Sub optimizes the compression of images with even horizontal patterns or blends.
    • Up optimizes the compression of images with even vertical patterns.
    • Average optimizes the compression of low-level noise by averaging the color values of adjacent pixels.
    • Path optimizes the compression of low-level noise by reassigning adjacent color values.
    • All applies the filter—Sub, Up, Average, or Path—best-suited for the image. Select All if you are unsure of which filter to use.

    Compression

    Specifies a method to reduce file size.

  5. In the Color Reduction section, set any of the following color reduction options.

    Option

    Description

    Color Mode

    Select the mode to use.

    Palette

    This drop-down list is available when you select Palette from the Color Mode drop-down list. Determine which set of 256 (or fewer) colors is used in the exported animation:

    • Adaptive automatically selects a set of colors that best approximate the original.
    • Web-safe uses a standard set of 216 colors. Web-safe colors are recommended for BlackBerry devices.

    Dithering

    Dithering might improve image quality. Selecting this option increases your file size.

    Dithering Noise

    From the Dithering Noise drop-down list, select a value.

  6. To name and save the current export settings for later use or to load a previously saved group of setting, select the Save current settings when closing check box.
  7. Click OK.

Export to an animated GIF file

You can export your content to the animated .gif format, which provides similar benefits to the .gif format.
  1. On the File menu, click Export > Animated GIF.
  2. In the Information section, change the following settings:

    Field

    Description

    Show Preview

    Select this option to display a preview pane on the right side of the dialog box. You can preview changes before you update the image.

    Update

    View information on the file properties after making changes to other properties on the dialog box.

    If you select Show Preview, you can view your changes when you click the Update button.

    Live Update

    Select this check box to update the information automatically.

    Note: If your computer has a slow processor, you might experience slower processing when using Live Update.

  3. In the Generic Options section, select any of the following check boxes.

    Option

    Description

    Override Background Color

    Select this check box to use a different background color than that set in the BlackBerry Composer. Click the color swatch and click a color.

    Use Temporary Image Cache

    Select this check box for smaller content files to improve performance when previewing different export settings or re-exporting a BlackBerry Composer file that has not been changed.

    Note: With larger images, the cache can consume a lot of memory and, depending on how much RAM is available, might need to be turned off.

  4. Depending on the type of export, select the applicable options.

    Field

    Description

    Interlace

    When you select this check box, images first appear blurry and become sharper as they are downloaded. When Interlace is not selected, images appear gradually, top to bottom, as they download.

    With still GIF images, interlacing allows users with slow modem connections to click past an image they are not interested in viewing without having to download the whole thing. Do not use Interlacing for animated GIFs.

    Loop

    Sets the number of times for the .gif animation to repeat.

    Override Doc. Speed

    Sets the speed for the .gif animation.

  5. In the Color Reduction section, set any of the following color reduction options.

    Option

    Description

    Palette

    Specifies which set of 256 (or fewer) colors is used in the exported animation.

    • Adaptive automatically selects a set of colors that best approximate the original.
    • Web-safe uses a standard set of 216 colors. Web-safe colors are recommended for BlackBerry devices.

    Colors

    Sets the number of colors used in the exported content. Depending on the types of objects used, setting this field to a value below 256 can seriously degrade image quality. However, reducing the number of colors can significantly reduce your file size.

    Color Reduction

    Specifies how the BlackBerry Composer reduces the number of colors for export. Experiment with both methods to determine which method produces the best image.

    Dithering

    Dithering might improve image quality. Selecting this option increases your file size.

  6. To name and save the current export settings for later use or to load a previously saved group of setting, select the Save current settings when closing check box.
  7. Click OK.