Options
The Midlets created by CellPix can have a number of parameters changed. These are:
- The target screen size
- The default background color for the images
- The textual messages that appear on the phone
- If the midlet automatically changes from one picture to the next
- The time lapse between each picture change if automatic changing is on
The target screen size and position
A target screen size can be specified or instead the original images used.
- Specifying target screen size is a convenient way of letting CellPix scaled image for you.
If specified, CellPix will scale all images to fit the given size and where needed create new .png thumbnails of the
image for display on the phone.
- If not used (the default) then the original images are used in the midlet and these can be .gif, .jpg or .png.
Mobile phones have different screen sizes however current implementations
of Java don't allow on-the-fly resizing of the images. What happens if a CellPix midlet
encounters a phone with a screen size less or greater than the originally specified, is
that the midlet will be centered on the screen so that either a border appears it
or the image spreads outside the available screen area.
The "Initial position" option in this dialog can be used to set each image's initial
position to be so the top-left or top-right corner of the image is set at the top-left or top-right corner of the
screen. The default is centering on the screen.
The "Always resize to fill screen" option is for phones that may have large screens. When
set on, this option causes the image to be resized proportionally to fit the
screen if both the original image's width and height are less than the
phone's display size. It is only applicable to Midp 2.0 midlets and is ignored in Midlet 1.0
midlets.
The background color 
This color is the background color on the screen that appears when the image is
smaller than the screen size and there is a border around the image.
The textual messages 
CellPix is language independant since no textual messages that appear on the phone
are hard-coded into the midlet. Any of these may be set to whatever text or language
is desired.
Automatic image changing
If the slideshow feature is switched on then the images will change automatically
and will continue to do so unless the user selects the "Index" option.
The time lapse between images 
The time lapse is specified as frames per minute. The default is 12 frames/minute.
This value is only relevant if automatic image changing has been enabled.
The midlet timeout 
If set this option the number of days the midlet will run before it times out.
If not set then there is no timeout.
The midlet icon 
This option allows an image to be specified as the icon for the midlet.
This image will appear next to the midlet name on the phone before the
CellPix midlet begins. The image selected must be a PNG image for a midlet
and the size can not be greater than 32x32.
Setting the sound 
This option creates sets sound files to be used as background sound for a slideshow.
Any Midi sound files used should be single-track midi type 0 files (the MidiSqeezer product available at
www.cellspark.com can be used to create this format).
The volume can be controlled while playing using the arrow (up and down) keys on the phone.
Optionally volume control can be set to be the '2' and '8' keys instead. The '5' key
can be pressed to pause the music and pressed again to restart play. There is
a more detailed explanation of the use of sound.
Setting a PIN code on the images 
This option allowing a code to be set on the image. This code can be any 10
characters (alphanumeric) and will be prompted for by the midlet before access is granted
to the images. The text used in the prompt can be set via the text-options. If the right
code is not given the midlet will exit.
Retrieving images from an HTTP server 
By switching on this option not all images need be in the midlet. This dialog can set:
- The mumber of images to be in the midlet. This must be at least one since the midlet
must display something at startup.
- The URL prefix to which the image name will be appended for HTTP access
When the midlet is asked to display an image which it doesn't have already in the
JAR (or previously retrieved from the server) then an http
request is automatically generated and a download screen appears with progress bar.
Once the image is retrieved in a session it won't be retrieved again. It is recommended that the option
to have images on the server be used only when the original images are being used and not scaled .png images.