Sun Microsystems Computer Accessories manual Main Device Property File, Fonts

Page 33

Main Device Property File

This section describes the device property file that the Default Emulator uses to emulate a device.

The Main Device Property file is named <device_name>.properties and is located in the directory <device_name> where device_name is the name of the device being emulated. For example, the Main Device Property file for a device named DefaultGrayPhone would be at {j2mewtk.dir}\wtklib\devices\DefaultGrayPhone \DefaultGrayPhone.properties. The Main Device Property file contains the information needed to define the device's appearance and behavior, as well as pointers to associated property files.

The Main Device Property file contains definitions for the following items. Each is discussed in detail in the sections below.

■Fonts

■The Device Image

■Screen Properties

■Device Buttons

■Displayed Icons

■Soft Button Label Display

■Color

■Sound Alerts

■Device Software Capabilities

Fonts

There are two types of fonts available for displaying text on the device screen:

■Bitmap fonts configured for the Emulator

■System fonts of the host PC

The device property file can specify the fonts used by the implementation of the MIDP graphics API.

Fonts Used by the MIDP APIs

A font is specified by the MIDP APIs by the property:

font.<face>.<style>.<size> = <font definition>

where

■face: “system”, “monospace”, or “proportional”

■style: “plain”, “bold”, or “italic”

■size: “small”, “medium”, or “large”

Chapter 3 Examining Device Property Files 19

Image 33

Contents Basic Customization Guide Please Contents Examining Device Property Files Default Emulator Device Property Files Vi Wireless Toolkit Basic Customization Guide December Figures Viii Wireless Toolkit Basic Customization Guide December Tables Wireless Toolkit Basic Customization Guide December How This Book Is Organized Who Should Use This BookUsing Operating System Commands Typographic Conventions Shell PromptsRelated Documentation Sun Welcomes Your Comments Accessing Sun Documentation OnlineHow to Customize the Wireless Toolkit Customizing the Wireless ToolkitCustomization Steps Device Property Files and the Default EmulatorCustomizing the Wireless Toolkit Wireless Toolkit Basic Customization Guide December Make a Copy of an Existing Main Device Property File Creating Device Property FilesObtain and Enter Image Files Screen Location Obtain and Enter the Screen PropertiesDisplay Area Total Screen SizeSpecifying Screen Properties Display Area in Full Screen ModeBy measuring the image file, obtain the button properties Obtain and Enter the Button PropertiesHeight Width Obtain and Enter Soft Button Label Areas Soft button label display is defined by a line of the form Defining the Icon Location and States Obtain and Enter Icon PropertiesEnter the following measured values for the icons properties Enter Color Properties Run the Emulator for the New DeviceScreen Background RGB Color Examining Device Property Files Device Property Files Main Device Property File FontsFonts Used by the Midp APIs Default Font System FontsBitmap Fonts Ascii character Distance to character Device Image Font UnderliningImage with Buttons Pressed Image without Buttons PressedImage with Buttons Highlighted and Backlight On ScalingScreen Properties Screen Location Display Area in Full Screen Mode Total Screen SizeDisplay Area Screen Background Color Screen Pixel RatioScreen Border Color Touch ScreenScreen Buffering Device Buttons Keyboard HandlerDefining a Device Button Button.LEFT = 13, 197, 20 Assigning a PC Keyboard Key to a Button Specifying the Characters Generated by a Button Press Assigning a Game Action to a ButtonAbstract Command Types in Order of Precedence Assigning Abstract Commands to ButtonsEmulating Abstract Command Button Assignments Precedence of Assigning Commands to a Button Secondary Button Assignments Abstract Command Menu Defining the Icon Location and States Displayed IconsSoft Button Labels on the Emulated Device Display Soft Button Label DisplaySound Alerts ColorAlert Type Values Device Software CapabilitiesCharacter Encodings LocalesTransparent Images EnableAlphaChannel falseWireless Toolkit Basic Customization Guide December Property Files Default Emulator Device Property FilesDefaultGrayPhone.properties Appendix a Default Emulator Device Property Files Wireless Toolkit Basic Customization Guide December Appendix a Default Emulator Device Property Files Wireless Toolkit Basic Customization Guide December # alert.alerttype.sound soundfile Wireless Toolkit Basic Customization Guide December Icon Image Files Device Image FilesIcon Image Files Adding a ByteCode Obfuscator Support for ByteCode ObfuscatorsExample Appendix B Support for ByteCode Obfuscators Wireless Toolkit Basic Customization Guide December P E N D I X C Wireless Toolkit Basic Customization Guide December Index Keyboard.handler property Device property ﬁles, 1 WMA messages, customizing Wireless Toolkit Basic Customization Guide December