Sun Microsystems Computer Accessories

iv Wireless Toolkit Basic Customization Guide • December 2003

3. Examining Device Property Files 17

Device Property Files 18

Main Device Property File 19

Fonts 19

Fonts Used by the MIDP APIs 19

Default Font 20

System Fonts 20

Bitmap Fonts 20

Font Underlining 22

The Device Image 22

Image without Buttons Pressed 23

Image with Buttons Pressed 23

Image with Buttons Highlighted and Backlight On 23

Scaling 23

Screen Properties 24

Screen Location 25

Total Screen Size 26

Display Area 26

Display Area in Full Screen Mode 26

Screen Pixel Ratio 27

Screen Background Color 27

Screen Border Color 28

Touch Screen 28

Screen Buffering 28

Device Buttons 29

Keyboard Handler 29

Defining a Device Button 29

Assigning a PC Keyboard Key to a Button 31

Assigning a Game Action to a Button 32

Specifying the Characters Generated by a Button Press 32

Contents

Main Please Contents Page Page Page Figures Page Page Page Preface Who Should Use This Book How This Book Is Organized Using Operating System Commands Typographic Conventions Shell Prompts Related Documentation AaBbCc123 Accessing Sun Documentation Online Sun Welcomes Your Comments Customizing the Wireless Toolkit How to Customize the Wireless Toolkit Customization Steps Note Device Property Files and the Default Emulator Page Page Creating Device Property Files Make a Copy of an Existing Main Device Property File Note Obtain and Enter Image Files Obtain and Enter the Screen Properties Note Screen Location Total Screen Size Display Area Display Area in Full Screen Mode (screenPaintableRegion.x,screenPaintableRegion.y). Obtain and Enter the Button Properties 2. Enter the following measured values for the button properties in NewPhone.properties: Obtain and Enter Soft Button Label Areas Note Page Obtain and Enter Icon Properties Note Defining the Icon Location and States Page Enter Color Properties Screen Background RGB Color Run the Emulator for the New Device Examining Device Property Files Note Device Property Files Main Device Property File Fonts Fonts Used by the MIDP APIs Default Font System Fonts Bitmap Fonts Page Note Font Underlining The Device Image Image without Buttons Pressed Image with Buttons Pressed Image with Buttons Highlighted and Backlight On Scaling Screen Properties Screen Location Total Screen Size Display Area Note Display Area in Full Screen Mode Screen Pixel Ratio Note Screen Background Color Screen Border Color Touch Screen Note Screen Buffering Device Buttons Keyboard Handler Defining a Device Button Page Assigning a PC Keyboard Key to a Button Note Assigning a Game Action to a Button Specifying the Characters Generated by a Button Press Assigning Abstract Commands to Buttons Note Emulating Abstract Command Button Assignments Note Precedence of Assigning Commands to a Button Assigning an Abstract Command Type to a Button Secondary Button Assignments Restricting the List of Command Types for a Soft Button The Abstract Command Menu Customizing Menu Title and Soft Button Note Displayed Icons Defining the Icon Location and States Soft Button Label Display Color Sound Alerts Device Software Capabilities Locales Character Encodings Note Transparent Images Page Default Emulator Device Property Files Property Files The following property files are used. DefaultGrayPhone.properties Page Page Page Page Page Page Page Page Support for ByteCode Obfuscators Adding a ByteCode Obfuscator Example Page Page Connecting to the Wireless Toolkits WMA Emulation Environment Page Index A B C D G I K M N