Recent changes to Skinning

WikiPage Skinning modified by boblemar

boblemar — Fri, 12 Oct 2012 21:01:55 -0000

--- v8
+++ v9
@@ -32,6 +32,8 @@
 > * musicformat.background_addons.properties
 > * musicformat.background.png
 > * musicformat.dune_folder.txt
+
+If some files are ommitted, the one from the default skin is used.
 
 The files follow the naming pattern :
 > {level}.{file_type}
@@ -71,6 +73,7 @@
 > objectname_propertykey=value
 
 The object names to use are :
+
 level|object name|description
 -----|-----------|-----------
 musiclibrary|title|title of the library
@@ -80,6 +83,7 @@
 musicformat|cover_image|the cover image of the record
 
 The property keys are :
+
 key|description
 ---|-----------
 box|the position and size of the object in the format : left,top,width,height

WikiPage Skin modified by boblemar

boblemar — Fri, 12 Oct 2012 21:00:16 -0000

--- v7
+++ v8
@@ -72,9 +72,22 @@
 
 The object names to use are :
 level|object name|description
-----|-----------|-----------
+-----|-----------|-----------
 musiclibrary|title|title of the library
 artist|title|name of the artist
 musicformat|title_artist|artist name
 musicformat|title_record|record name
 musicformat|cover_image|the cover image of the record
+
+The property keys are :
+key|description
+---|-----------
+box|the position and size of the object in the format : left,top,width,height
+font|font to use to draw the text (in java format)
+halign|horizontal alignment. Can be : center, left, right
+valign|vertical alignment. Can be : middle, top, bottom
+fitmode|fit text or image to box ? Can be : fit_to_box or none
+fontcolor|color of the text (in html hexadecimal format like FFFFFF for white)
+bordercolor|color of the border (in html hexadecimal format like FFFFFF for white)
+borderwidth|width of the border if any (0=no border)
+

WikiPage Skin modified by boblemar

boblemar — Fri, 12 Oct 2012 20:50:59 -0000

--- v6
+++ v7
@@ -22,10 +22,13 @@
 > * musiclibrary.background_addons.properties
 > * musiclibrary.background.png
 > * musiclibrary.dune_folder.txt
+> * musiclibrary.icon.png
 > * artist.background_addons.properties
 > * artist.background.png
 > * artist.dune_folder.txt
+> * artist.icon.png
 > * record.dune_folder.txt
+> * record.icon.png
 > * musicformat.background_addons.properties
 > * musicformat.background.png
 > * musicformat.dune_folder.txt
@@ -43,6 +46,7 @@
 > * background.png : the background image (size: 1920x1080)
 > * background_addons.properties : description of some objects to draw on the background (titles, images)
 > * dune_folder.txt : a template of the dunefolder to use.
+> * icon.png : the icon.
 
 dune_folder templates
 =====================
@@ -50,7 +54,7 @@
 These tokens depends on the target level.
 
 token|description
------------------
+-----|-----------
 {BACKGROUND_PATH}|the path of the generated background image
 {ICON_PATH}|the path of the icon
 {SYSTEM_FILES_FILTER}|the system files filter
@@ -59,4 +63,18 @@
 In the corresponding template, there is a section used to build these virtual items.
 This section is contained inside the {ITEM_TEMPLATE[]} pattern.
 
+background_addons files
+=======================
+Background addons files are used to paint some objects (text / images) over the background image.
 
+The background_addons files contain the properties of the objects in the following format :
+> objectname_propertykey=value
+
+The object names to use are :
+level|object name|description
+----|-----------|-----------
+musiclibrary|title|title of the library
+artist|title|name of the artist
+musicformat|title_artist|artist name
+musicformat|title_record|record name
+musicformat|cover_image|the cover image of the record

WikiPage Skin modified by boblemar

boblemar — Fri, 12 Oct 2012 20:39:05 -0000

--- v5
+++ v6
@@ -50,8 +50,13 @@
 These tokens depends on the target level.
 
 token|description
+-----------------
 {BACKGROUND_PATH}|the path of the generated background image
 {ICON_PATH}|the path of the icon
 {SYSTEM_FILES_FILTER}|the system files filter
 
+In the musicformat dune_folder.txt file, discodune generates virtual items for each track.
+In the corresponding template, there is a section used to build these virtual items.
+This section is contained inside the {ITEM_TEMPLATE[]} pattern.
 
+

WikiPage Skin modified by boblemar

boblemar — Fri, 12 Oct 2012 20:33:42 -0000

--- v4
+++ v5
@@ -1,3 +1,6 @@
+Introduction
+============
+
 Since version 2.1.1, Discodune supports skinning.
 
 A built-in skin, called 'default', is packaged into discodune.jar.
@@ -40,3 +43,15 @@
 > * background.png : the background image (size: 1920x1080)
 > * background_addons.properties : description of some objects to draw on the background (titles, images)
 > * dune_folder.txt : a template of the dunefolder to use.
+
+dune_folder templates
+=====================
+Dune folder templates files use the same format as the Dune dune_folder.txt files, but contain tokens that are replaced by discodune on runtime.
+These tokens depends on the target level.
+
+token|description
+{BACKGROUND_PATH}|the path of the generated background image
+{ICON_PATH}|the path of the icon
+{SYSTEM_FILES_FILTER}|the system files filter
+
+

WikiPage Skin modified by boblemar

boblemar — Fri, 12 Oct 2012 20:23:43 -0000

--- v3
+++ v4
@@ -4,25 +4,39 @@
 
 Other skins must be stored in the 'skins' subfolder of the folder containing discodune.jar.
 Discodune folder should look like :
-> discodune.jar
-> discodune.MusicFolderCoverGetter.properties
-> discodune.MusicFormats.properties
-> discodune.properties
-> skins
-> > skin1
-> > skin2
-> > ...
+> * discodune.jar
+> * discodune.MusicFolderCoverGetter.properties
+> * discodune.MusicFormats.properties
+> * discodune.properties
+> * skins
+> > * skin1
+> > * skin2
+> > * ...
 
 A skin is a folder. The name of the skin is the name of this folder.
 
 A skin folder may contain the following files :
-- musiclibrary.background_addons.properties
-- musiclibrary.background.png
-- musiclibrary.dune_folder.txt
-- artist.background_addons.properties
-- artist.background.png
-- artist.dune_folder.txt
-- record.dune_folder.txt
-- musicformat.background_addons.properties
-- musicformat.background.png
-- musicformat.dune_folder.txt
+> * musiclibrary.background_addons.properties
+> * musiclibrary.background.png
+> * musiclibrary.dune_folder.txt
+> * artist.background_addons.properties
+> * artist.background.png
+> * artist.dune_folder.txt
+> * record.dune_folder.txt
+> * musicformat.background_addons.properties
+> * musicformat.background.png
+> * musicformat.dune_folder.txt
+
+The files follow the naming pattern :
+> {level}.{file_type}
+
+where level is one of discodune levels :
+> * musiclibrary
+> * artist
+> * record
+> * musicformat
+
+and file_type represents the function of the file :
+> * background.png : the background image (size: 1920x1080)
+> * background_addons.properties : description of some objects to draw on the background (titles, images)
+> * dune_folder.txt : a template of the dunefolder to use.

WikiPage Skin modified by boblemar

boblemar — Fri, 12 Oct 2012 20:16:03 -0000

--- v2
+++ v3
@@ -3,3 +3,26 @@
 A built-in skin, called 'default', is packaged into discodune.jar.
 
 Other skins must be stored in the 'skins' subfolder of the folder containing discodune.jar.
+Discodune folder should look like :
+> discodune.jar
+> discodune.MusicFolderCoverGetter.properties
+> discodune.MusicFormats.properties
+> discodune.properties
+> skins
+> > skin1
+> > skin2
+> > ...
+
+A skin is a folder. The name of the skin is the name of this folder.
+
+A skin folder may contain the following files :
+- musiclibrary.background_addons.properties
+- musiclibrary.background.png
+- musiclibrary.dune_folder.txt
+- artist.background_addons.properties
+- artist.background.png
+- artist.dune_folder.txt
+- record.dune_folder.txt
+- musicformat.background_addons.properties
+- musicformat.background.png
+- musicformat.dune_folder.txt

WikiPage Skin modified by boblemar

boblemar — Fri, 12 Oct 2012 20:08:16 -0000

--- v1
+++ v2
@@ -0,0 +1,5 @@
+Since version 2.1.1, Discodune supports skinning.
+
+A built-in skin, called 'default', is packaged into discodune.jar.
+
+Other skins must be stored in the 'skins' subfolder of the folder containing discodune.jar.

WikiPage Skin modified by boblemar

boblemar — Fri, 12 Oct 2012 20:02:42 -0000