Welcome to Mobipocket Developer Center

Mobipocket Emulator

Getting Started
Overview How to useCreating Custom skins

Home | Hide TOC |

Add to Favorites

Creating custom skins

It's very easy to create new skins for the Mobipocket Emulator.

You need to do 2 things:

Create a new GIF image for the skin (only GIF imageq are supported. BMP & JPEG are not supported) and copy it under the \skin folder where the Mobipocket Emulator is installed
Create a new XML skin file, with a .skin extension under the \skin folder, specifying the different parameters for the skin (including the filename of the GIF image for the skin)

Mobipocket Emulator Skin Tag Reference

It is a well formed XML.

The root node is <skinlist> and contains different <skin> items. You simply need to add a new <skin> item node inside the root node.

Example :

<skinlist> <skin force="true" > <device name="Nokia Communicator 9210/9290" os="SymbianOs"/> <filename>crystal.gif</filename> <iconlibrary>MobipocketCommonImages.prc</iconlibrary> <font face="Times New Roman" basesize="16" minsize="12" maxsize="26" step="2"/> <screen x="135" y="64" width="640" height="200" xmargin="30" ymargin="5" /> </skin> ...... ...... </skinlist>

Tag Name	Attribute	Description
<skin>		This is the base skin node, which encloses all other tags
	force="true"	This attribute is mandatory. Always add it to any skin entry
<device>		Set general information about the skin
	name="xxx"	The name of the skin. Mandatory and has to be unique among the skin list
	os="yyy"	Set the Operating System name. Used to group skins in the Devices menu item in the Emulator. Mandatory
<iconlibrary>		Set the relative path to the Mobipocket Common Image resource files to be used for a given device type. Use one of the existing resource files (MobipocketCommonImage.prc or mobipocketCommonImage_Palm.prc or MobipocketCommonImage_PocketPC.prc , MobipocketCommonImage_Palm.prc, MobipocketCommonImage_EBM.prc) This value of mandatory.
<font>		Specify font information for the device type
	face	The face name of the font to use. Can be any True Type font name available on the Desktop PC where the Emulator runs.
	basesize	The base (default) font size to display text in the Emulator. Set a size which corresponds to the default size in the real device (in pixels)
	minsize	The min font size the device type uses to display text (in pixels)
	maxsize	The max font size the device type uses to display text (in pixels)
	step	The step to increment to current font size when the user click on the Font button in the Reader to get bigger font
<filename>		The relative path of the GIF filename to use as skin. Mandatory
<screen>		Set Information about the skin screen size with the GIF image (Mandatory)
	x	The x position where the "screen" begins relative to the upper left corner of the skin image (in pixels)
	y	The y position where the "screen" begins relative to the upper left corner of the skin image (in pixels)
	width	The width of the "screen" of the device type in pixels
	height	The height of the "screen" of the device type in pixels
	xmargin	the horizontal margin used in the Reader Emulator (relative to the "screen" coordinate)
	ymargin	the vetical margin used in the Reader Emulator (relative to the "screen" coordinate)
	toolbar="true" or "false"	Displays or hides the Mobipocket Reader toolbar inside the screen area or not. Default is "true". Optional