Name

lcdui.image — Creates an image.

Synopsis

lcdui.image [ -file filename ] [ -rms recordstore ] [ -resource resourcename ] [ -image image ] [ -data data ]

$imagecmd [cget -optname ] [configure -optname optval ] [thumbnail [thumbwidth [thumbwidth] ] ] [graphics]

Description

The lcdui.image command creates an image, from some data, either by indicating a filename, record store, or a resource name. It returns an object/command that can be utilized to manipulate the image. Mutable images are those loaded from existing data, generally. Immutable images are created as a "blank slate", with white pixels. For an in-depth look at the Java code that this command is based on, see: javax.microedition.lcdui.Image

The options available for the lcdui.image command are described below:

  • -file: Load the image from the given file name.

  • -rms: Load the image from the given record store.

  • -resource: Load the image from the given resource. By "resource", we mean a file included in the .jar.

  • -image: Create a new image from an existing image.

  • -data: Create a new image from binary data.

The subcommands available to an $imagecmd are listed below:

  • thumbnail: Creates a thumbnail from the image.

  • graphics: Unless the image is immutable, creates and returns a new graphics object associated with the image.

Example

FIXME
	  

Produces:

yyy