Zaurus Theme howto for Sharp ROM 3.10

[ :: home :: back :: ]

The themes are broken down into three config files. I'll use the standard ZBlue that comes with 3.10 as an example.

/home/QtPalmtop/etc/zthemes/ZBlue.theme

[Theme]

Style = ZBlue                                        <-Tells the theme what style to use.
Decoration = ZBlue                                   <-Tells the theme what Decoration to use.
Color = ZBlue                                        <-Tells what colors to use.
WallFile = wallpaper/default                         <-You can set the wallpaper here. Overrides whatever
                                                       is in Launcher.conf.
Name[en] = ZBlue                                     <-The name of the theme.
Name[ja] = ザウルスブルー                     <-Name in Japanese ;)

/home/QtPalmtop/etc/zdecorations/ZBlue.decoration

[Decoration]
Decoration = ZDecoration                             <-The type of decoration.
Dpi = -1                                             <-See footnote* for multik's description of this.
Name[en] = ZBlue                                     <-The name of this decoration.
Name[ja] = ザウルスブルー                     <-The name in Japanese ;)

OkImage = zstyle/blue/ok.png                         <-OK button.
CloseImage = zstyle/blue/close.png                   <-Cancel or close.
HelpImage = zstyle/blue/question.png                 <-Help button.
OkImageActive = zstyle/blue/okb.png                  <-OK button depressed.
CloseImageActive = zstyle/blue/closeb.png            <-Cancel or close depressed.
HelpImageActive = zstyle/blue/questionb.png          <-Help depressed.
TitleImage = zstyle/blue/title.png                   <-Title bar when window is in focus.
TitleImageDeactive = zstyle/blue/titlebar_gray.png   <-Title bar when focus is lost.

Now this is where it gets fun . . .
/home/QtPalmtop/etc/zstyles/ZBlue.style

[Style]                                              
Style = ZStyle                                       <-What type of style.
Dpi = -1                                             <-See footnote* for multik's description of this.
Name[en] = ZBlue                                     <-Name of this style.
Name[ja] = ザウルスブルー                     <-Japanese name.

ButtonShift = 0                                      <-Haven't played with this yet.
                                                       I would imagine this turns 
                                                       button depressing on and off.

vsbarupbtn = zstyle/blue/upbutton.png                <-Button to scroll up.
vsbardownbtn = zstyle/blue/downbutton.png            <-Button to scroll down.
vsbartop = zstyle/blue/bartop.png                    <-Top piece of scrollbar.
vsbarbtm = zstyle/blue/barbottom.png                 <-Bottom piece of vertical scrollbar.
vsbarcont = zstyle/blue/barmiddle.png                <-Middle of scrollbar(tiled).
vsbarbgtop = zstyle/blue/barbacktop.png              <-Graphic behind top piece of scrollbar.
vsbarbgbtm = zstyle/blue/barbackbottom.png           <-Graphic behind bottom piece of scrollbar.
vsbarbgcnt = zstyle/blue/barbackmiddle.png           <-Graphic behind middle piece of vertical scrollbar(tiled).

vsbarupbtnb = zstyle/blue/upbuttonb.png              <-Scrollbar up button depressed.
vsbardownbtnb = zstyle/blue/downbuttonb.png          <-Scorllbar down button depressed.
vsbartopb = zstyle/blue/bartopb.png                  <-Scrollbar top depressed.
vsbarbtmb = zstyle/blue/barbottomb.png               <-Scrollbar bottom depressed.
vsbarcontb = zstyle/blue/barmiddleb.png              <-Scrollbar middle depressed.

hsbarupbtn = zstyle/blue/upbutton-yoko.png           <-Button to scroll left.
hsbardownbtn = zstyle/blue/downbutton-yoko.png       <-Button to scroll right.
hsbartop = zstyle/blue/bartop-yoko.png               <-Left piece of scrollbar.
hsbarbtm = zstyle/blue/barbottom-yoko.png            <-Right piece of scrollbar.
hsbarcont = zstyle/blue/barmiddle-yoko.png           <-Middle piece of horizontal scrollbar(tiled).
hsbarbgtop = zstyle/blue/barbacktop-yoko.png         <-Graphic behind left piece of scrollbar.
hsbarbgbtm = zstyle/blue/barbackbottom-yoko.png      <-Graphic behind right piece of scrollbar.
hsbarbgcnt = zstyle/blue/barbackmiddle-yoko.png      <-Graphic behind middle piece of horizontal scrollbar(tiled.

hsbarupbtnb = zstyle/blue/upbuttonb-yoko.png         <-Button to scroll left depressed.
hsbardownbtnb = zstyle/blue/downbuttonb-yoko.png     <-Button to scroll right depressed.
hsbartopb = zstyle/blue/bartopb-yoko.png             <-Left piece of horizontal scrollbar depressed.
hsbarbtmb = zstyle/blue/barbottomb-yoko.png          <-Right piece of horizontal scrollbar depressed.
hsbarcontb = zstyle/blue/barmiddleb-yoko.png         <-Middle piece of horizontal scrollbar depressed(tiled).

btnlt = zstyle/blue/block1.png                       <-Big button (left top)
btnlb = zstyle/blue/block3.png                       <-Big button (left bottom)
btnrt = zstyle/blue/block2.png                       <-Big button (right top)
btnrb = zstyle/blue/block4.png                       <-Big button (right bottom)
btntop = zstyle/blue/block5.png                      <-Big button (top, tiles horizontally)
btnbtm = zstyle/blue/block7.png                      <-Big button (bottom, tiles horizontally)
btnleft = zstyle/blue/block6.png                     <-Big button (left, tiles vertically)
btnright = zstyle/blue/block8.png                    <-Big button (right, tiles vertically)
	
btnblt = zstyle/blue/block1b.png                     <-Big button (left top) depressed.
btnblb = zstyle/blue/block3b.png                     <-Big button (left bottom) depressed.
btnbrt = zstyle/blue/block2b.png                     <-Big button (right top) depressed.
btnbrb = zstyle/blue/block4b.png                     <-Big button (right bottom) depressed.
btnbtop = zstyle/blue/block5b.png                    <-Big button (top, tiles horizontally) depressed.
btnbbtm = zstyle/blue/block7b.png                    <-Big button (bottom, tiles horizontally) depressed.
btnbleft = zstyle/blue/block6b.png                   <-Big button (left, tiles vertically) depressed.
btnbright = zstyle/blue/block8b.png                  <-Big button (right, tiles vertically) depressed.

mbtnlt = zstyle/blue/minibutton1.png                 <-Small button (left top)
mbtnlb = zstyle/blue/minibutton3.png                 <-Small button (left bottom)
mbtnrt = zstyle/blue/minibutton2.png                 <-Small button (right top)
mbtnrb = zstyle/blue/minibutton4.png                 <-Small button (right bottom)
mbtntop = zstyle/blue/minibutton5.png                <-Small button (top, tiles horizontally)
mbtnbtm = zstyle/blue/minibutton7.png                <-Small button (bottom, tiles horizontally)
mbtnleft = zstyle/blue/minibutton6.png               <-Small button (left, tiles vertically)
mbtnright = zstyle/blue/minibutton8.png              <-Small button (right, tiles vertically)

mbtnblt = zstyle/blue/minibutton1b.png               <-Small button (left top) depressed.
mbtnblb = zstyle/blue/minibutton3b.png               <-Small button (left bottom) depressed.
mbtnbrt = zstyle/blue/minibutton2b.png               <-Small button (right top) depressed.
mbtnbrb = zstyle/blue/minibutton4b.png               <-Small button (right bottom) depressed.
mbtnbtop = zstyle/blue/minibutton5b.png              <-Small button (top, tiles horizontally) depressed.
mbtnbbtm = zstyle/blue/minibutton7b.png              <-Small button (bottom, tiles horizontally) depressed.
mbtnbleft = zstyle/blue/minibutton6b.png             <-Small button (left, tiles vertically) depressed.
mbtnbright = zstyle/blue/minibutton8b.png            <-Small button (right, tiles vertically) depressed.

sliderup = zstyle/blue/slider-up.png                 <-Slider up.
sliderdown = zstyle/blue/slider-down.png             <-Slider down.
sliderleft = zstyle/blue/slider-left.png             <-Slider left.
sliderright = zstyle/blue/slider-right.png           <-Slider right.
sliderlr = zstyle/blue/slider-both_h.png             <-Horizontal slider. (Thanks Joel!)
sliderud = zstyle/blue/slider-both_v.png             <-Vertical slider. (Thanks Joel!)

checkon = zstyle/blue/checkbox.png                   <-Checkbox checked.
checkoff = zstyle/blue/graybox.png                   <-Check box unchecked.
checkno = zstyle/blue/checknochange.png              <-Checkbox disabled.

radioon = zstyle/blue/Blue1.png                      <-Radio button on.
radiooff = zstyle/blue/gray1.png                     <-Radio button off.

arrowup =                                            <-Not sure what these arrows are for.
arrowdown =                                          <-Anyone else?
arrowleft =
arrowright =

fillbtnColor = #C8D2DC                               <-Big button fill color.
fillbtnbColor = #8C96A5                              <-Big button fill color depressed.
fillmBtnColor = #C3D2E1                              <-Small button fill color.
fillmBtnbColor = #8C98A5                             <-Small button fill color depressed.
#fillbtnColor144 = #BBCBEB                           <-Anyone know what these 144's do?
#fillbtnbColor144 = #768195
#fillmBtnColor144 = #ABC0E8
#fillmBtnbColor144 = #6C7993
vsliderbg = #DFE0D0                                  <-Vertical slider background color.
hsliderbg = #DFE0D0                                  <-Horizontal slider background color. 

Thanks to Axis for the .scheme stuff.
/home/QtPalmtop/etc/color/ZBlue.scheme

[Colors]
Name[en] = ZBlue                                     <-Name of color scheme in English
Name[ja] = (ザウルスブルー )                  <-Name of color scheme in Japanese


Background = #C0DCF8                                 <-Color of the borders
Button = #C0DCF8                                     <-Background color of buttons
Highlight = #1054E0                                  <-Color of highlight around text
HighlightedText = #FFFFFF                            <-Color of actual highlighted text and titlebar text.
Text = #FFFFFF                                       <-Sets the text color for the icon descriptions and stuff.

And of course the png's.

The ZBlue theme keeps them all in this directory:
/home/QtPalmtop/pics/zstyle/blue

DPI according to multik:
I do not know, how it work on S5500, but i know, how it work on C700 ;-)
If you leave dpi at -1, all pictures like "title bar background" will be stretched to actual screen size. If you set to some value, it will be scaled to "properly size". Look at me: I have C700 with screen resolution 144 dpi. If i set dpi in theme file to 72, all images will show with scale factor 2x (i.e. if picture has width 100px - on screen it will have 200px width). If i set 288, scale factor will be 0.5x.
Why developers make this feature - i do not know ;-) But, perhaps for future support to devices that have screen with different screen dimencions and resolutions.

Any and all feedback is welcome. cnaude[at]sdf.lonestar.org