J2ME Polish
J2ME Polish 2.4 Documentation
Enough Software

Generic/AnyPhone_176x208


Display

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

Platform

PropertyValuePreprocessing Access
VendorGenericpolish.Vendor
PlatformMIDP/2.0, JTWI/1.0polish.JavaPlatform, polish.midp2
ConfigurationCLDC/1.1polish.JavaConfiguration, polish.cldc1.1
Supported APIsbtapi, fileconnection, mmapi, wmapipolish.JavaPackage, polish.api.btapi, polish.api.fileconnection, polish.api.mmapi, polish.api.wmapi
Possibly Supported APIsnokia-ui, samsung, 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
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
jtwiresources/jtwi
btapiresources/btapi
fileconnectionresources/fileconnection
mmapiresources/mmapi
wmapiresources/wmapi
midiresources/midi
amrresources/amr
wavresources/wav
ScreenSize.176x208resources/ScreenSize.176x208

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.bootclasspathcldc-1.1.jar,midp-2.0.jar
polish.build.implicitgroupsmidp2
polish.heapsize1MB
polish.iconheight16
polish.iconsize16x16
polish.iconwidth16
polish.identifierGeneric/AnyPhone_176x208
polish.javaconfigurationCLDC/1.1
polish.javapackagebtapi, fileconnection,mmapi,wmapi
polish.javaplatformMIDP/2.0, JTWI/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.nameAnyPhone_176x208
polish.optionalpackagenokia-ui,samsung, JSR238, JSR234, JSR211, JSR180, JSR179, JSR177, JSR172
polish.screenheight208
polish.screensize176x208
polish.screenwidth176
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.btapi
polish.api.fileconnection
polish.api.fileconnectionapi
polish.api.mmapi
polish.api.wmapi
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.16x16
polish.iconsize:defined
polish.iconwidth:defined
polish.identifier.generic/anyphone_176x208
polish.identifier:defined
polish.isdynamic
polish.isvirtual
polish.javaconfiguration.cldc/1.1
polish.javaconfiguration:defined
polish.javapackage.btapi
polish.javapackage.fileconnection
polish.javapackage.mmapi
polish.javapackage.wmapi
polish.javapackage:defined
polish.javaplatform.jtwi/1.0
polish.javaplatform.midp/2.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.name.anyphone_176x208
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.176x208
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