J2ME Polish
J2ME Polish 2.4 Documentation
Enough Software

Generic/AnyMsaBasicPhone_352x416


Display

PropertyValuePreprocessing Access
Screen-Size (width x height)352x416polish.ScreenSize, polish.ScreenWidth, polish.ScreenHeight
Supports Pointer/Touch Eventsyespolish.hasPointerEvents

Platform

PropertyValuePreprocessing Access
VendorGenericpolish.Vendor
PlatformMIDP/2.0, MSA/1.0polish.JavaPlatform, polish.midp2
ConfigurationCLDC/1.1polish.JavaConfiguration, polish.cldc1.1
Supported APIsbtapi, fileconnection, mmapi, wmapi, mmapi, wmapi, fileconnection, pdaapi, btapi, mmapi, 3dapi, wmapi, wmapi2.0, svg, pdaapi, btapi, mmapi, 3dapi, wmapi, wmapi2.0, svgpolish.JavaPackage, polish.api.btapi, polish.api.fileconnection, polish.api.mmapi, polish.api.wmapi, polish.api.mmapi, polish.api.wmapi, polish.api.fileconnection, polish.api.pdaapi, polish.api.btapi, polish.api.mmapi, polish.api.3dapi, polish.api.wmapi, polish.api.wmapi2.0, polish.api.svg, polish.api.pdaapi, polish.api.btapi, polish.api.mmapi, polish.api.3dapi, polish.api.wmapi, polish.api.wmapi2.0, polish.api.svg
Possibly Supported APIsnokia-ui, samsung, i18n, advancedmultimedia, contenthandler, sip, locationapi, security, webservice, i18n, advancedmultimedia, contenthandler, sip, locationapi, security, webservicepolish.OptionalPackage, polish.optional-api.nokia-ui, polish.optional-api.samsung, polish.optional-api.i18n, polish.optional-api.advancedmultimedia, polish.optional-api.contenthandler, polish.optional-api.sip, polish.optional-api.locationapi, polish.optional-api.security, polish.optional-api.webservice, polish.optional-api.i18n, polish.optional-api.advancedmultimedia, polish.optional-api.contenthandler, polish.optional-api.sip, polish.optional-api.locationapi, polish.optional-api.security, polish.optional-api.webservice
Meets the Recommended Capablities for the J2ME Polish GUIyes  --

Memory

PropertyValuePreprocessing Variable
Heap-Size1MBpolish.HeapSize

Multimedia

PropertyValuePreprocessing Access
Supported Audio Formatsmidi, amr, wavpolish.SoundFormat, polish.audio.midi, polish.audio.amr, polish.audio.wav

Known Issues

Issue 1AreaDescription
SoftKeyMappedToFireuiThe softkeys are associated with the Canvas.FIRE game action.
Solution
Be careful when processing FIRE game events.
Preprocessing Symbol
polish.Bugs.SoftKeyMappedToFire
 
Issue 2AreaDescription
noSoftKeyReleasedEventsuiNo keyReleased(int) event is triggered when a softkey has been released. Only the keyPressed(int) event is forwarded.
Solution
Use the J2ME Polish UI or only react to keyPressed(int) events for softkey values.
Preprocessing Symbol
polish.Bugs.noSoftKeyReleasedEvents
 
Issue 3AreaDescription
displaySetCurrentFlickersuiEach time when a new screen is shown a white flash is seen. Also when an existing canvas is shown, apparently an internal buffer is shown first before paint() of that canvas is called.
Solution
Use the J2ME Polish GUI (in fullscreen mode) or use a single canvas.
Preprocessing Symbol
polish.Bugs.displaySetCurrentFlickers
 
Issue 4AreaDescription
needsBottomOrientiationForStringDrawinguiGraphics.drawString(str,x,y,orientation) does not position the string correctly if orientation includes Graphics.TOP.
Solution
Always use Graphics.BOTTOM and calculate the y-position accordingly.
Preprocessing Symbol
polish.Bugs.needsBottomOrientiationForStringDrawing
 
Issue 5AreaDescription
BacklightRequiresLightOffuiBefore turning on the backlight it needs to be switched off.
Solution
Switch off the backlight shortly before turning it on again.
Preprocessing Symbol
polish.Bugs.BacklightRequiresLightOff
 
Issue 6AreaDescription
keyRepeatOverloadUIWhen pressing more than 3 keys simultanously, the currently shown canvas receives a never ending stream of keyRepeat events, even though no physical keys are pressed.
Solution
To workaround this set a new native displayable (which might result in flickering) or use J2ME Polish.
Preprocessing Symbol
polish.Bugs.keyRepeatOverload
 
Issue 7AreaDescription
SnapshotRequiresScreenChangeUIWhen starting a capture://video player, no preview window is shown when no new canvas is being used.
Solution
Show another physical screen and then return to the snapshot screen or use the J2ME Polish SnapshotScreen.
Preprocessing Symbol
polish.Bugs.SnapshotRequiresScreenChange
 

Groups

Groups can be used to assemble the resources (like images or sound-files) for an application.
Have a look at the documentation for more info.

GroupResource Folder
midp2resources/midp2
msaresources/msa
btapiresources/btapi
fileconnectionresources/fileconnection
mmapiresources/mmapi
wmapiresources/wmapi
mmapiresources/mmapi
wmapiresources/wmapi
fileconnectionresources/fileconnection
pdaapiresources/pdaapi
btapiresources/btapi
mmapiresources/mmapi
3dapiresources/3dapi
wmapiresources/wmapi
wmapi2.0resources/wmapi2.0
svgresources/svg
pdaapiresources/pdaapi
btapiresources/btapi
mmapiresources/mmapi
3dapiresources/3dapi
wmapiresources/wmapi
wmapi2.0resources/wmapi2.0
svgresources/svg
midiresources/midi
amrresources/amr
wavresources/wav
ScreenSize.352x416resources/ScreenSize.352x416

Preprocessing Capabilities

Capabilities can be used with the "//#=" preprocessing directive and can be compared with the "//#if" directive. For each defined capability a preprocessing symbol with the same name will be defined.
Have a look at the preprocessing documentation for more information.

Examples:

//#if polish.Vendor == Generic
	// this is a Generic device
//#endif
//#ifdef polish.ScreenWidth:defined
	//#= int screenWidth = ${ polish.ScreenWidth };
//#else
	int screenWidth = UNKNOWN_WIDTH;
//#endif

CapabilityValue
polish.bugsSoftKeyMappedToFire,noSoftKeyReleasedEvents,displaySetCurrentFlickers,needsBottomOrientiationForStringDrawing,BacklightRequiresLightOff, keyRepeatOverload, SnapshotRequiresScreenChange
polish.build.bootclasspathmidp-2.0.jar,cldc-1.1.jar
polish.build.implicitgroupsmidp2
polish.heapsize1MB
polish.iconheight44
polish.iconsize44x44
polish.iconwidth44
polish.identifierGeneric/AnyMsaBasicPhone_352x416
polish.javaconfigurationCLDC/1.1
polish.javapackagebtapi, fileconnection,mmapi,wmapi,mmapi,wmapi,fileconnection,pdaapi, btapi, mmapi, 3dapi, wmapi2.0, svg,pdaapi, btapi, mmapi, 3dapi, wmapi2.0, svg
polish.javaplatformMIDP/2.0, MSA/1.0
polish.key.leftsoftkeys-6,-21,21,57345,-1,-202
polish.key.maybesupportsasciikeymaptrue
polish.key.rightsoftkeys-7,-22,22,57346,-4,-203
polish.menubar.optionspositionleft
polish.nameAnyMsaBasicPhone_352x416
polish.optionalpackagenokia-ui,samsung, JSR238, JSR234, JSR211, JSR180, JSR179, JSR177, JSR172,JSR238, JSR234, JSR211, JSR180, JSR179, JSR177, JSR172
polish.screenheight416
polish.screensize352x416
polish.screenwidth352
polish.soundformatmidi, amr, wav
polish.supportfloatingpointtrue
polish.vendorGeneric

Preprocessing Symbols

Symbols can be evaluated with the "//#ifdef" and related preprocessing directives.
Have a look at the preprocessing documentation for more information.

Example:

//#if polish.api.mmapi || polish.midp2
	// this device supports the Mobile Media API
//#endif

Symbol
polish.api.3dapi
polish.api.btapi
polish.api.fileconnection
polish.api.fileconnectionapi
polish.api.m3g
polish.api.mmapi
polish.api.pdaapi
polish.api.pim
polish.api.pimapi
polish.api.svg
polish.api.wmapi
polish.api.wmapi2.0
polish.audio.amr
polish.audio.midi
polish.audio.wav
polish.bugs.backlightrequireslightoff
polish.bugs.displaysetcurrentflickers
polish.bugs.keyrepeatoverload
polish.bugs.needsbottomorientiationforstringdrawing
polish.bugs.nosoftkeyreleasedevents
polish.bugs.snapshotrequiresscreenchange
polish.bugs.softkeymappedtofire
polish.bugs:defined
polish.build.bootclasspath.cldc-1.1.jar
polish.build.bootclasspath.midp-2.0.jar
polish.build.bootclasspath:defined
polish.build.implicitgroups.midp2
polish.build.implicitgroups:defined
polish.cldc
polish.cldc1.1
polish.cldc11
polish.hascommandkeyevents
polish.hasfloatingpoint
polish.hasoptionalapis
polish.haspointerevents
polish.heapsize.1mb
polish.heapsize:defined
polish.iconheight:defined
polish.iconsize.44x44
polish.iconsize:defined
polish.iconwidth:defined
polish.identifier.generic/anymsabasicphone_352x416
polish.identifier:defined
polish.isdynamic
polish.isvirtual
polish.javaconfiguration.cldc/1.1
polish.javaconfiguration:defined
polish.javapackage.3dapi
polish.javapackage.btapi
polish.javapackage.fileconnection
polish.javapackage.mmapi
polish.javapackage.pdaapi
polish.javapackage.svg
polish.javapackage.wmapi
polish.javapackage.wmapi2.0
polish.javapackage:defined
polish.javaplatform.midp/2.0
polish.javaplatform.msa/1.0
polish.javaplatform:defined
polish.jtwi
polish.key.leftsoftkeys.-1
polish.key.leftsoftkeys.-202
polish.key.leftsoftkeys.-21
polish.key.leftsoftkeys.-6
polish.key.leftsoftkeys.21
polish.key.leftsoftkeys.57345
polish.key.leftsoftkeys:defined
polish.key.maybesupportsasciikeymap
polish.key.maybesupportsasciikeymap.true
polish.key.maybesupportsasciikeymap:defined
polish.key.rightsoftkeys.-203
polish.key.rightsoftkeys.-22
polish.key.rightsoftkeys.-4
polish.key.rightsoftkeys.-7
polish.key.rightsoftkeys.22
polish.key.rightsoftkeys.57346
polish.key.rightsoftkeys:defined
polish.menubar.optionsposition.left
polish.menubar.optionsposition:defined
polish.midp
polish.midp2
polish.msa
polish.name.anymsabasicphone_352x416
polish.name:defined
polish.optional-api.advancedmultimedia
polish.optional-api.contenthandler
polish.optional-api.i18n
polish.optional-api.locationapi
polish.optional-api.nokia-ui
polish.optional-api.samsung
polish.optional-api.security
polish.optional-api.sip
polish.optional-api.webservice
polish.optionalpackage.jsr172
polish.optionalpackage.jsr177
polish.optionalpackage.jsr179
polish.optionalpackage.jsr180
polish.optionalpackage.jsr211
polish.optionalpackage.jsr234
polish.optionalpackage.jsr238
polish.optionalpackage.nokia-ui
polish.optionalpackage.samsung
polish.optionalpackage:defined
polish.screenheight:defined
polish.screensize.352x416
polish.screensize:defined
polish.screenwidth:defined
polish.soundformat.amr
polish.soundformat.midi
polish.soundformat.wav
polish.soundformat:defined
polish.supportfloatingpoint
polish.supportfloatingpoint.true
polish.supportfloatingpoint:defined
polish.supportspolishgui
polish.vendor.generic
polish.vendor:defined
back to top