Sun Microsystems Computer Accessories Using Operating System Commands

xii Wireless Toolkit Basic Customization Guide • December 2003

screen properties, button properties, soft button labelareas, and icon properties.

The tutorial also explains how to set color properties and how to run the emulator

for the new device.

Chapter 3 describes in depth the components of a device definition and explains

how to create a device definition.

Appendix A lists the property files for the default emulator, describes the

properties for it, and lists the image and icon files for the default emulator.

Appendix B explains how to add a bytecode obfuscator to the Wireless Toolkit

using the framework provided by the toolkit.

Appendix C describes the extension API provided with the Wireless Toolkitthat

you can use to connect to the WirelessToolkit’s WMA emulation environment.

Using Operating System Commands

This document may not contain information on basic UNIX®or Microsoft

Windowscommands and procedures such as opening a terminal window,

changing directories, and setting environment variables. See the software

documentation that you received with your system for this information.

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