[Windows Mobile Software Development] Ameet:
Now that the all new Manilla 2D is in place and still evolving. Themes and skins are flowing in which is a very very good and sporting spirit

This thread is a Reference for explaining each value and coding of the

HTCHomeSettings.xml

file which manages the whole Manilla 2D eye candy show into it :)

To start with, this is a default (.xml) file without any modifications: Default XML

Everyone who knows about xml coding can help by posting the explainations. This thread can serve everyone as a how-to for skinning

Code

:

<HTCHome version="3.00.0" device="ELFIN" portrait="0,0,240,268" landscape="0,0,320,268">
<ImageList path="\Windows">

Explaination:

Version = theme skin "Version"

Device = theme for which "Device"

Portrait = size of the "Portrait" screen

Landscape = size of the "Landscape" screen

ImageList Path = path where the below mentioned images are called from for the skins

---------------------------------------------------------------------------------------------------------

Code

:

<Property name="IDHMWG_CLOCKBTN_1STDIGIT_POS" id="3" value="[COLOR=red]31[/COLOR], [COLOR=blue]46[/COLOR]" />
<Property name="IDHMWG_CLOCKBTN_2NDDIGIT_POS" id="4" value="[COLOR=red]68[/COLOR], [COLOR=blue]46[/COLOR]" />
<Property name="IDHMWG_CLOCKBTN_SEPARATOR_POS" id="5" value="[COLOR=red]21[/COLOR], [COLOR=blue]31[/COLOR]" />
<Property name="IDHMWG_CLOCKBTN_3RDDIGIT_POS" id="6" value="[COLOR=red]126[/COLOR], [COLOR=blue]46[/COLOR]" />
<Property name="IDHMWG_CLOCKBTN_4THDIGIT_POS" id="7" value="[COLOR=red]165[/COLOR], [COLOR=blue]46[/COLOR]" />

Explaination:

This is for the digital clock. The Red changes left <--> right. Blue changes up <--> dn

Thanks to Showaco: Also, properties ending with POS (instead of RECT) having 4 numbers, first set of two is Portrait and second set of two is Landscape. "(P)Left, Top, (L)Left, Top"

---------------------------------------------------------------------------------------------------------

Code

:

<Property name="IDHMWG_CLOCKBTN_BGIMG" id="0" [COLOR=teal]value[/COLOR]="40" />
<Property name="IDTABWG_TABBG_IMAGE" id="4" [COLOR=teal]value[/COLOR]="2" />

Explaination:

value in IDs with "BGIMG" or "IMAGE" specifies the Index of image mentioned in the ImageList

---------------------------------------------------------------------------------------------------------

Code

:

<Property name="IDTABWG_TABBG_ICON_WIDTH" id="3" value="[COLOR=red]48[/COLOR], [COLOR=blue]55[/COLOR]" />

Explaination:

To increase the width of the tab icons to use bigger tabs images, change the value

The Red changes width. Blue changes height

---------------------------------------------------------------------------------------------------------

Code

:

<HomeWidget enable="1" tab_bg_icon="7,8" tab_icon="69,70" big_icon="29,30" />
<PeopleWidget enable="1" tab_bg_icon="19,20" tab_icon="168,169" big_icon="59,60" />

Explaination:

In the Widget list, the values of icons refer to the Index of images in ImageList

Changing the ImagePath works but you have to edit the image path/call out further down in the .xml as well. Only changing on top creates kind off a mess - Thanks to tyguy

Top entry from:

<HTCHome version="3.00.0" device="OPAL" portrait="0,0,240,268" landscape="0,0,320,268">
<ImageList path="\Windows">

To (just an example)

<HTCHome version="3.00.0" device="OPAL" portrait="0,0,240,268" landscape="0,0,320,268">
<ImageList path="[B][COLOR=royalblue]\ManilaThemes\Original[/COLOR][/B]">

& All other "\Windows" calls as in

<MyFavesWidget>
<Property name="IDTMOWG_BTN_RECT" id="0" value="60,68,180,183" />
<Property name="IDTMOWG_ICON_RECT" id="1" [COLOR=black]value="[B]\Windows[/B]\hh_myfaves[/COLOR]_button.png" />

To

<MyFavesWidget>
<Property name="IDTMOWG_BTN_RECT" id="0" value="60,68,180,183" />
<Property name="IDTMOWG_ICON_RECT" id="1" value="[B][COLOR=royalblue]\ManilaThemes\Original[/COLOR][/B]\hh_myfaves_button.png" />

---------------------------------------------------------------------------------------------------------

Code

:

<Property name="IDLAUNCHERWG_COLUMN" id="3" value="[COLOR=red]4[/COLOR]" />

Explaination: Thanks to imfloflo

To change no of columns in Launcher Widget to 4

---------------------------------------------------------------------------------------------------------

Code

:

<Property name="IDHMWG_CALENDARBTN1_RECT" id="40" value="[COLOR=red]12,177,228,207[/COLOR]" />

Explaination: Thanks to Showaco

The four numbers are "Left, Top, Width, Height". If a property ending in RECT has eight numbers, then first set of four is for Portrait and second set is for Landscape orientations. "(P)Left, Top, Width, Height, (L)Left, Top, Width, Height"

Explaination: Thanks to btprice2001

Certain RECT settings use "Left, Top, Width, Height" while others use "X1, Y1, X2, Y2"

e.g.

(IDHMWG_CLOCKBTN_RECT) under the HomeWidget uses "X1, Y1, X2, Y2"

(IDWEWG_LOCATIONTXT_RECT) under the WeatherWidget uses "Left, Top, Width, Height"

---------------------------------------------------------------------------------------------------------

Weather panel coding

Explaination: Thanks to Showaco

http://xdaforums.com/showpost.php?p=2840521&postcount=132

Note

: This thread is not related to Manilla 2D issues or problems but just a reference to coding in the .xml file