Lib SDK with LWUIT

LWUIT is a fancy J2ME user interface library from Sun. It is free to use and it gives nice animations for modern phones.

However, it has own specific methods for many UI control features (including canvas), so in principle you need to rewrite application specifically to use the LWUIT. It does not provide automatic "polishing" tools like e.g. J2ME Polish does.

With MGMaps Lib SDK the trick to draw MapComponent on LWUIT Image object, that can be painted on any component.

To paint on LWUIT image we need to retrieve J2ME native Graphics object from the image. For that a wrapper class can be used:

package com.sun.lwuit;

public class ImageWrapper {
  private final Image image;

  //Image is from LWUIT package
  public ImageWrapper(final Image lwuitBuffer) {
    this.image = lwuitBuffer;
  }
  
  public javax.microedition.lcdui.Graphics getGraphics() {
    return (Graphics) image.getGraphics().getGraphics();
  }
}

All it does is exposing J2ME graphics object from LWUIT image.

Sample usage of MapComponent and ImageWrapper:

public class LWUITMapScreen extends Component implements MapListener {
  private MapComponent mapComponent;
  private Image lwuitBuffer;
  private javax.microedition.lcdui.Graphics bufferGraphics;

  public LWUITMapScreen() {
    //create map component
    mapComponent = null; 
    //create buffer image that can be used to paint on LWUIT element
    lwuitBuffer = Image.createImage(100, 100);
    //retrieve J2ME graphics object from buffer image
    bufferGraphics = new ImageWrapper(lwuitBuffer).getGraphics();
  }

  public void paint(final Graphics g) {
    //paint on the graphics object retrieved with wrapper.
    //this is effectively same as painting on LWUIT image
    mapComponent.paint(bufferGraphics);
    //paint the image, now containing map, on Component (that is visible on screen)
    g.drawImage(lwuitBuffer, 0, 0);
  }
}

This is just a sample, how to draw map on a LWUIT image. By using wrappers for different elements (to expose J2ME Graphics from the element), the map can be drawn to any LWUIT element imaginable.