Changes

Jump to navigation Jump to search
m
no edit summary
Line 1: Line 1:  
==WiiRadio Skinning reference v1.0 (WIP – Please Add any useful information to this document)==
 
==WiiRadio Skinning reference v1.0 (WIP – Please Add any useful information to this document)==
<br>
+
<br/>
 
With version 0.5+ you can create custom skins for WiiRadio.
 
With version 0.5+ you can create custom skins for WiiRadio.
<br><br>
+
<br/><br/>
 
All skins should be placed in their own folder under the following directory sd:/apps/radiow/skins. E.G.  sd:/apps/radiow/skins/myskin.  All the necessary images, fonts and the skin.txt file should be place in your skin folder.
 
All skins should be placed in their own folder under the following directory sd:/apps/radiow/skins. E.G.  sd:/apps/radiow/skins/myskin.  All the necessary images, fonts and the skin.txt file should be place in your skin folder.
<br><br>
+
<br/><br/>
    
==The skin.txt File==
 
==The skin.txt File==
<br>
+
<br/>
 
The skin.txt file is the core to your skin.  This file tells WiiRadio what images and fonts to use and where to position the buttons on screen.  The skin.txt file is similar to an ini file.  Here's an example of positioning the “playlist” button and setting the over and out images.
 
The skin.txt file is the core to your skin.  This file tells WiiRadio what images and fonts to use and where to position the buttons on screen.  The skin.txt file is similar to an ini file.  Here's an example of positioning the “playlist” button and setting the over and out images.
<br><br>
+
<br/><br/>
 
pls_x=10
 
pls_x=10
<br><br>
+
<br/><br/>
 
Set the playlist button to onscreen X 10 pixels.
 
Set the playlist button to onscreen X 10 pixels.
<br><br>
+
<br/><br/>
 
pls_y=24
 
pls_y=24
<br><br>
+
<br/><br/>
 
Set the playlist button to onscreen Y 24 pixels.
 
Set the playlist button to onscreen Y 24 pixels.
<br><br>
+
<br/><br/>
 
pls_text=Playlists
 
pls_text=Playlists
<br><br>
+
<br/><br/>
 
Set the text shown in the button
 
Set the text shown in the button
<br><br>
+
<br/><br/>
 
pls_text_color=#eeeeee
 
pls_text_color=#eeeeee
<br><br>
+
<br/><br/>
 
Set the text color for the button when the mouse is not over it.
 
Set the text color for the button when the mouse is not over it.
<br><br>
+
<br/><br/>
 
pls_text_color_over=#14abd0
 
pls_text_color_over=#14abd0
<br><br>
+
<br/><br/>
 
Set the text color for the button when the mouse is over it.
 
Set the text color for the button when the mouse is over it.
<br><br>
+
<br/><br/>
 
pls_text_size=2
 
pls_text_size=2
<br><br>
+
<br/><br/>
 
Set the size of the text in the button.  This is not a pixel value but corresponds to the either the small font, medium or large font sizes you've specified.  E.G. 2 would be the small font, 1 would be medium and 0 would set the font to large.
 
Set the size of the text in the button.  This is not a pixel value but corresponds to the either the small font, medium or large font sizes you've specified.  E.G. 2 would be the small font, 1 would be medium and 0 would set the font to large.
<br><br>
+
<br/><br/>
 
pls_pad_y=10
 
pls_pad_y=10
<br><br>
+
<br/><br/>
 
This tells WiiRadio to Pad the text 10 pixels from the top of the button, useful for vertical positioning of text.
 
This tells WiiRadio to Pad the text 10 pixels from the top of the button, useful for vertical positioning of text.
<br><br>
+
<br/><br/>
 
pls_pad_x=0
 
pls_pad_x=0
<br><br>
+
<br/><br/>
 
This tells WiiRadio to Pad the text 10 pixels from the left of the button, useful for horizontal positioning of text.
 
This tells WiiRadio to Pad the text 10 pixels from the left of the button, useful for horizontal positioning of text.
<br><br>
+
<br/><br/>
 
pls_out=playlists_out.png
 
pls_out=playlists_out.png
<br><br>
+
<br/><br/>
 
Tells WiiRadio what image to use for the buttons out state (mouse not over the button).  The image must be in your skin folder.
 
Tells WiiRadio what image to use for the buttons out state (mouse not over the button).  The image must be in your skin folder.
<br><br>
+
<br/><br/>
 
pls_over=playlists_over.png
 
pls_over=playlists_over.png
<br><br>
+
<br/><br/>
 
Tells WiiRadio what image to use for the buttons over state (mouse over the button).  The image must be in your skin folder.
 
Tells WiiRadio what image to use for the buttons over state (mouse over the button).  The image must be in your skin folder.
<br><br>
+
<br/><br/>
 
==Buttons==
 
==Buttons==
<br><br>
+
<br/><br/>
 
Do I have to display every button ?
 
Do I have to display every button ?
<br><br>
+
<br/><br/>
 
There are two types of buttons optional and required.  Optional buttons are not required and required are required :)  Here a list of the two.
 
There are two types of buttons optional and required.  Optional buttons are not required and required are required :)  Here a list of the two.
<br><br>
+
<br/><br/>
 
==Buttons- Optional==
 
==Buttons- Optional==
<br><br>
+
<br/><br/>
Search button – pop's open the search screen.<br>
+
Search button – pop's open the search screen.<br/>
Stop button – Stops the stream from playing.<br>
+
Stop button – Stops the stream from playing.<br/>
Add to playlist button – Adds the currently playing stream to the playlists.<br>
+
Add to playlist button – Adds the currently playing stream to the playlists.<br/>
Exit button – Quits back to loader.<br>
+
Exit button – Quits back to loader.<br/>
<br><br>
+
<br/><br/>
 
==Buttons- Required==
 
==Buttons- Required==
<br><br>
+
<br/><br/>
Next – Next for playlists/genres or browser.<br>
+
Next – Next for playlists/genres or browser.<br/>
Back – Back for playlists/genres or browser.<br>
+
Back – Back for playlists/genres or browser.<br/>
Logo – WiiRadio's logo, also used for displaying the options screen when clicked.<br>
+
Logo – WiiRadio's logo, also used for displaying the options screen when clicked.<br/>
Genres – Shows a list of genres<br>
+
Genres – Shows a list of genres<br/>
Playing Area – Show the title of the playing track<br>
+
Playing Area – Show the title of the playing track<br/>
Playlists Buttons– The buttons used for showing playlists<br>
+
Playlists Buttons– The buttons used for showing playlists<br/>
Delete Buttons – The buttons used to delete playlists<br>
+
Delete Buttons – The buttons used to delete playlists<br/>
Listing Buttons – The button used for listings – playlist, genre and browser ( These buttons also have extra properties that need to be set)<br>
+
Listing Buttons – The button used for listings – playlist, genre and browser ( These buttons also have extra properties that need to be set)<br/>
<br><br>
+
<br/><br/>
    
==Other GUI Items (MOST REQUIRED)==
 
==Other GUI Items (MOST REQUIRED)==
<br><br>
+
<br/><br/>
Background Image – What's displayed as the background.<br>
+
Background Image – What's displayed as the background.<br/>
Fonts – Used to specify the fontset and sizes for the skin.<br>
+
Fonts – Used to specify the fontset and sizes for the skin.<br/>
Visuals – Used to show a visual on the main GUI.  This component is optional.<br>
+
Visuals – Used to show a visual on the main GUI.  This component is optional.<br/>
Cusror – Set the cursor image and hotspot properties.<br>
+
Cusror – Set the cursor image and hotspot properties.<br/>
Volume and Mute – Images that are used for the volume and mute.<br>
+
Volume and Mute – Images that are used for the volume and mute.<br/>
Dialog – Used for the stream information dialog.<br>
+
Dialog – Used for the stream information dialog.<br/>
Info – Used for the connecting, searching and buffering states<br>
+
Info – Used for the connecting, searching and buffering states<br/>
<br><br>
+
<br/><br/>
 
==A Full example of a skin.txt==
 
==A Full example of a skin.txt==
<br><br>
+
<br/><br/>
// -- general images (required)<br>
+
// -- general images (required)<br/>
bgimg=bg.png<br>
+
bgimg=bg.png<br/>
mute=mute.png<br>
+
mute=mute.png<br/>
volume_over=volume_ol.png<br>
+
volume_over=volume_ol.png<br/>
volume_bg=volume_bg.png<br>
+
volume_bg=volume_bg.png<br/>
<br><br>
+
<br/><br/>
// -- cusror (required)<br>
+
// -- cusror (required)<br/>
cursor_y_off=0<br>
+
cursor_y_off=0<br/>
cursor_x_off=10<br>
+
cursor_x_off=10<br/>
cursor=cursor.png<br>
+
cursor=cursor.png<br/>
<br><br>
+
<br/><br/>
// -- fonts (required)<br>
+
// -- fonts (required)<br/>
fontset=FrancophilSans.ttf<br>
+
fontset=FrancophilSans.ttf<br/>
fontsize_small=14<br>
+
fontsize_small=14<br/>
fontsize_medium=22<br>
+
fontsize_medium=22<br/>
fontsize_large=26<br>
+
fontsize_large=26<br/>
<br><br>
+
<br/><br/>
// -- vars for positioning the lists (required)<br>
+
// -- vars for positioning the lists (required)<br/>
listing_limit_text=380<br>
+
listing_limit_text=380<br/>
listing_start_x=205<br>
+
listing_start_x=205<br/>
listing_start_y=122<br>
+
listing_start_y=122<br/>
listing_pad_y=0<br>
+
listing_pad_y=0<br/>
listing_pad_text_y=2<br>
+
listing_pad_text_y=2<br/>
listing_pad_text_x=5<br>
+
listing_pad_text_x=5<br/>
listing_font_size=2<br>
+
listing_font_size=2<br/>
listing_font_color=#14abd0<br>
+
listing_font_color=#14abd0<br/>
listing_font_color_over=#eeeeee<br>
+
listing_font_color_over=#eeeeee<br/>
listing_number_of=10<br>
+
listing_number_of=10<br/>
list_out=listing_out.png<br>
+
list_out=listing_out.png<br/>
list_over=listing_over.png<br>
+
list_over=listing_over.png<br/>
<br><br>
+
<br/><br/>
// -- delete button properties (required)<br>
+
// -- delete button properties (required)<br/>
delete_start_x=610<br>
+
delete_start_x=610<br/>
delete_pad_y=2<br>
+
delete_pad_y=2<br/>
delete_out=delete_out.png<br>
+
delete_out=delete_out.png<br/>
delete_over=delete_over.png<br>
+
delete_over=delete_over.png<br/>
<br><br>
+
<br/><br/>
// -- for displaying visuals on the main gui (optional)<br>
+
// -- for displaying visuals on the main gui (optional)<br/>
show_vis=1<br>
+
show_vis=1<br/>
vis_x=15<br>
+
vis_x=15<br/>
vis_y=110<br>
+
vis_y=110<br/>
vis_h=160<br>
+
vis_h=160<br/>
vis_w=190<br>
+
vis_w=190<br/>
vis_color_bar=#14abd0<br>
+
vis_color_bar=#14abd0<br/>
vis_color_peak=#039ac0<br>
+
vis_color_peak=#039ac0<br/>
// - black = transparent<br>
+
// - black = transparent<br/>
vis_bgcolor=#000000<br>
+
vis_bgcolor=#000000<br/>
<br><br>
+
<br/><br/>
// -- playlists buttons (required)<br>
+
// -- playlists buttons (required)<br/>
pls_x=10<br>
+
pls_x=10<br/>
pls_y=24<br>
+
pls_y=24<br/>
pls_text=Playlists<br>
+
pls_text=Playlists<br/>
pls_text_color=#eeeeee<br>
+
pls_text_color=#eeeeee<br/>
pls_text_color_over=#14abd0<br>
+
pls_text_color_over=#14abd0<br/>
pls_text_size=2<br>
+
pls_text_size=2<br/>
pls_pad_y=10<br>
+
pls_pad_y=10<br/>
pls_pad_x=0<br>
+
pls_pad_x=0<br/>
pls_out=playlists_out.png<br>
+
pls_out=playlists_out.png<br/>
pls_over=playlists_over.png<br>
+
pls_over=playlists_over.png<br/>
<br><br>
+
<br/><br/>
// -- playing area (required)<br>
+
// -- playing area (required)<br/>
playing_x=15<br>
+
playing_x=15<br/>
playing_y=280<br>
+
playing_y=280<br/>
playing_text_color=#707070<br>
+
playing_text_color=#707070<br/>
playing_text_color_over=#14abd0<br>
+
playing_text_color_over=#14abd0<br/>
playing_text_size=2<br>
+
playing_text_size=2<br/>
playing_pad_text_y=0<br>
+
playing_pad_text_y=0<br/>
playing_pad_text_x=0<br>
+
playing_pad_text_x=0<br/>
playing_limit_text=180<br>
+
playing_limit_text=180<br/>
playing_out=playing.png<br>
+
playing_out=playing.png<br/>
playing_over=playing.png<br>
+
playing_over=playing.png<br/>
<br><br>
+
<br/><br/>
// -- info dialog ... (dialog showing stream inf.) (required)<br>
+
// -- info dialog ... (dialog showing stream inf.) (required)<br/>
dialog_text_color=#eeeeee<br>
+
dialog_text_color=#eeeeee<br/>
dialog=dialog.png<br>
+
dialog=dialog.png<br/>
<br><br>
+
<br/><br/>
// -- status text (i.e. buffering, connecting)<br>
+
// -- status text (i.e. buffering, connecting)<br/>
// -- offset of text from the background image (image is centered DEFAULT)<br>
+
// -- offset of text from the background image (image is centered DEFAULT)<br/>
info_txt_x=20<br>
+
info_txt_x=20<br/>
info_txt_y=12<br>
+
info_txt_y=12<br/>
info_txt_size=1<br>
+
info_txt_size=1<br/>
info=info.png<br>
+
info=info.png<br/>
<br><br>
+
<br/><br/>
// -- cancel button (required)<br>
+
// -- cancel button (required)<br/>
info_cancel_x=165<br>
+
info_cancel_x=165<br/>
info_cancel_y=9<br>
+
info_cancel_y=9<br/>
info_cancel_text_size=1<br>
+
info_cancel_text_size=1<br/>
info_cancel_text_pad_y=10<br>
+
info_cancel_text_pad_y=10<br/>
info_cancel_out=cancel_out.png<br>
+
info_cancel_out=cancel_out.png<br/>
info_cancel_over=cancel_out.png<br>
+
info_cancel_over=cancel_out.png<br/>
<br><br>
+
<br/><br/>
// -- button exit (optional)<br>
+
// -- button exit (optional)<br/>
exit_x=170<br>
+
exit_x=170<br/>
exit_y=24<br>
+
exit_y=24<br/>
exit_text=Exit<br>
+
exit_text=Exit<br/>
exit_text_color=#eeeeee<br>
+
exit_text_color=#eeeeee<br/>
exit_text_color_over=#14abd0<br>
+
exit_text_color_over=#14abd0<br/>
exit_text_size=2<br>
+
exit_text_size=2<br/>
exit_pad_y=10<br>
+
exit_pad_y=10<br/>
exit_pad_x=0<br>
+
exit_pad_x=0<br/>
exit_over=playlists_over.png<br>
+
exit_over=playlists_over.png<br/>
exit_out=playlists_out.png<br>
+
exit_out=playlists_out.png<br/>
<br><br>
+
<br/><br/>
// -- button search (optional)<br>
+
// -- button search (optional)<br/>
search_x=170<br>
+
search_x=170<br/>
search_y=24<br>
+
search_y=24<br/>
search_text=Search<br>
+
search_text=Search<br/>
search_text_color=#eeeeee<br>
+
search_text_color=#eeeeee<br/>
search_text_color_over=#14abd0<br>
+
search_text_color_over=#14abd0<br/>
search_text_size=2<br>
+
search_text_size=2<br/>
search_pad_y=10<br>
+
search_pad_y=10<br/>
search_pad_x=0<br>
+
search_pad_x=0<br/>
search_over=playlists_over.png<br>
+
search_over=playlists_over.png<br/>
search_out=playlists_out.png<br>
+
search_out=playlists_out.png<br/>
<br><br>
+
<br/><br/>
// -- genres (required)<br>
+
// -- genres (required)<br/>
genres_x=90<br>
+
genres_x=90<br/>
genres_y=24<br>
+
genres_y=24<br/>
genres_text=Genres<br>
+
genres_text=Genres<br/>
genres_text_color=#eeeeee<br>
+
genres_text_color=#eeeeee<br/>
genres_text_color_over=#14abd0<br>
+
genres_text_color_over=#14abd0<br/>
genres_text_size=2<br>
+
genres_text_size=2<br/>
genres_pad_y=10<br>
+
genres_pad_y=10<br/>
genres_pad_x=0<br>
+
genres_pad_x=0<br/>
genres_out=playlists_out.png<br>
+
genres_out=playlists_out.png<br/>
genres_over=playlists_over.png<br>
+
genres_over=playlists_over.png<br/>
<br><br>
+
<br/><br/>
// -- stop button (optional)<br>
+
// -- stop button (optional)<br/>
stop_x=30<br>
+
stop_x=30<br/>
stop_y=390<br>
+
stop_y=390<br/>
stop_text=<br>
+
stop_text=<br/>
stop_text_color=#eeeeee<br>
+
stop_text_color=#eeeeee<br/>
stop_text_color_over=#14abd0<br>
+
stop_text_color_over=#14abd0<br/>
stop_text_size=2<br>
+
stop_text_size=2<br/>
stop_pad_y=10<br>
+
stop_pad_y=10<br/>
stop_pad_x=0<br>
+
stop_pad_x=0<br/>
stop_out=stop_inactive.png<br>
+
stop_out=stop_inactive.png<br/>
stop_over=stop_active.png<br>
+
stop_over=stop_active.png<br/>
<br><br>
+
<br/><br/>
// -- back button (required)<br>
+
// -- back button (required)<br/>
back_x=377<br>
+
back_x=377<br/>
back_y=105<br>
+
back_y=105<br/>
back_out=left_out.png<br>
+
back_out=left_out.png<br/>
back_over=left_over.png<br>
+
back_over=left_over.png<br/>
<br><br>
+
<br/><br/>
// -- logo (required)<br>
+
// -- logo (required)<br/>
logo_x=410<br>
+
logo_x=410<br/>
logo_y=48<br>
+
logo_y=48<br/>
logo_out=logo_out.png<br>
+
logo_out=logo_out.png<br/>
logo_over=logo_over.png<br>
+
logo_over=logo_over.png<br/>
<br><br>
+
<br/><br/>
// -- next button (required)<br>
+
// -- next button (required)<br/>
next_x=377<br>
+
next_x=377<br/>
next_y=355<br>
+
next_y=355<br/>
next_out=right_out.png<br>
+
next_out=right_out.png<br/>
next_over=right_over.png<br>
+
next_over=right_over.png<br/>
<br><br>
+
<br/><br/>
3,893

edits

Navigation menu