Home  Beta programs 
  Welcome to Mobipocket Developer Center
powered by FreeFind

Mobipocket Emulator

Getting Started
OverviewHow 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

Copyright 2000-2007 Mobipocket.com