add docs and comments in xml files for building styles

This commit is contained in:
doitux
2009-04-04 00:35:18 +00:00
parent 82fe9869e6
commit b611eca1a0
7 changed files with 1289 additions and 1119 deletions
+22
View File
@@ -0,0 +1,22 @@
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Copyright information for PokerTH default card deck style
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Maintainer: PokerTH development team
EMail: webmaster@pokerth.net
The maintainer of this PokerTH card deck style assures that all distributed gfx files are builded by himself
or adaptation of gfx files which are released under a free licence. By building this style the maintainer
doesnt violate any third party rights.
Below you will find a list of all adaptation source gfx files which was used when building this style.
-----------------------------------------------------------------------------------------------------------------
| Source of gfx file | Licence |
|----------------------------------------------------------------------------------------------------------------
| 0.png - 52.png | http://commons.wikimedia.org/wiki/Poker_(cards_deck) |
| | |
| | |
| | |
| | |
-----------------------------------------------------------------------------------------------------------------
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="UTF-8" ?>
<PokerTH>
<TableStyle>
<StyleDescription value="danuxi table design (1024x600 fixed)" />
<StyleMaintainerEMail value="webmaster@pokerth.net" />
<IfFixedWindowSize value="1" />
<StyleDescription value="danuxi table design (1024x600 fixed)" /> <!-- This string will be shown in settings/game table style list -->
<StyleMaintainerEMail value="webmaster@pokerth.net" /> <!-- This string will be shown in error message if there is a problem with the style -->
<IfFixedWindowSize value="1" /> <!-- value [1,0] 1 = fixed window size, 0 = resizeable window -->
<FixedWindowWidth value="1024" />
<FixedWindowHeight value="600" />
<MinimumWindowWidth value="1024" />
Binary file not shown.

Before

Width:  |  Height:  |  Size: 499 KiB

After

Width:  |  Height:  |  Size: 494 KiB

+22
View File
@@ -0,0 +1,22 @@
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Copyright information for PokerTH default game table style
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Maintainer: PokerTH development team
EMail: webmaster@pokerth.net
The maintainer of this PokerTH game table style assures that all distributed gfx files are builded by himself
or adaptation of gfx files which are released under a free licence. By building this style the maintainer
doesnt violate any third party rights.
Below you will find a list of all adaptation source gfx files which was used when building this style.
-----------------------------------------------------------------------------------------------------------------
| Source of gfx file | Licence |
|----------------------------------------------------------------------------------------------------------------
| | |
| | |
| | |
| | |
| | |
-----------------------------------------------------------------------------------------------------------------
@@ -1,16 +1,20 @@
<?xml version="1.0" encoding="UTF-8" ?>
<PokerTH>
<TableStyle>
<StyleDescription value="PokerTH default table style" />
<StyleMaintainerEMail value="webmaster@pokerth.net" />
<IfFixedWindowSize value="0" />
<FixedWindowWidth value="1024" />
<FixedWindowHeight value="600" />
<MinimumWindowWidth value="1024" />
<MinimumWindowHeight value="600" />
<MaximumWindowWidth value="1980" />
<MaximumWindowHeight value="1200" />
<Preview value="preview.png" />
<StyleDescription value="PokerTH default table style" /><!-- This string will be shown in settings/game table style list -->
<StyleMaintainerEMail value="webmaster@pokerth.net" /> <!-- This string will be shown in error message if there is a problem with the style -->
<Preview value="preview.png" /> <!-- This preview picture will be shown in settings/game table style if this style is selected. The value should contain a filename of the preview picture which have to be stored in the same folder as this xml file. -->
<!-- Windows Settings -->
<IfFixedWindowSize value="0" /><!-- value [1,0] 1 = fixed window size, 0 = resizeable window -->
<FixedWindowWidth value="1024" /> <!-- value [min 1024] This will set the fixed window width if IfFixedWindowsSize=1 -->
<FixedWindowHeight value="600" /> <!-- value [min 600] This will set the fixed window height if IfFixedWindowsSize=1 -->
<MinimumWindowWidth value="1024" /> <!-- value [min 1024] This will set the minimum window width if IfFixedWindowsSize=0 -->
<MinimumWindowHeight value="600" /> <!-- value [min 600] This will set the minimum window height if IfFixedWindowsSize=0 -->
<MaximumWindowWidth value="1980" /> <!-- value [min 1024] This will set the maximum window width if IfFixedWindowsSize=0 -->
<MaximumWindowHeight value="1200" /> <!-- value [min 600] This will set the maximum window height if IfFixedWindowsSize=0 -->
<!-- Table Pictures - values should contain filenames of pictures which have to be stored in the same folder as this xml file. if you wanna have an item to be not shown please write "NULL" instead of the picture file name -->
<ActionAllIn value="action_allin.png" />
<ActionRaise value="action_raise.png" />
<ActionBet value="action_bet.png" />
@@ -53,6 +57,8 @@
<Table value="table.png" />
<ToolBoxBackground value="toolboxbg.png" />
<HandRanking value="handranking.png" />
<!-- Table Colors - values should be set in hexcode RGB style without "#" -->
<FKeyIndicatorColor value="FFFFFF" />
<ChanceLabelPossibleColor value="9CD500" />
<ChanceLabelImpossibleColor value="55632F" />
@@ -104,6 +110,8 @@
<BetSpeedSliderGrooveBorderColor value="286400" />
<BetSpeedSliderHandleBgColor value="99D500" />
<BetSpeedSliderHandleBorderColor value="286400" />
<!-- Table Font Sizes - values should be set in px -->
<ChatLogTextSize value="11" />
</TableStyle>
</PokerTH>
+93
View File
@@ -0,0 +1,93 @@
++++++++++++++++++++++++++++++++++++++++
How to skinning PokerTH GUI
++++++++++++++++++++++++++++++++++++++++
+++++++++++++++++++++++
1. Game Table Styles
+++++++++++++++++++++++
1.1 Start building a game table
--------------------------------
The best way to start building a custom PokerTH game table is to take a look into defaulttablestyle.xml.
You will find this file in the source code or into your >= 0.6.5 installation path of PokerTH in subfolder data/gfx/gui/table/default/.
The defaulttablestyle.xml is the control center of your style. The file also contains comments which describe the use of the controls.
Maybe you like to play around with the default table to see how the controls will work. Therefore you should copy the whole
data/gfx/gui/table/default/ directory to another place. For better overview in "game table styles" list in settings please at first change
<StyleDescription value="PokerTH default table style" /> to <StyleDescription value="my custom style" />. Maybe you also like to rename the
defaulttablestyle.xml to mycustomstyle.xml or something similar and directory name "default" to "mycustomtable" or something similar.
Now you can start tweaking color values or change/edit gfx files.
1.2 Test your style
--------------------------------
To test your style just load it into PokerTH with "Settings" -> "Style" -> "Game Table Styles" --> "Add ...".
When you have selected your file the value of "StyleDescription" is shown in the list. Select this entry in the list and click "Activate".
Closing the Settings dialog will refresh the style of the game table.
If you do changes in your mycustomstyle.xml there is no need to re-add it into settings or restart PokerTH. The simplest way is just
to open settings dialog and close it immediately. This will refresh the game table style and show your changes.
1.3 Distribute your style
-------------------------------
When your style is ready to distribute you should complete the style information StyleDescription, StyleMaintainerEMail and Preview.
The best way for Preview will be a screenshot of the style running in PokerTH.
Next step is editing the copyright.txt. Here you need to change "Maintainer" to your name and "EMail" to your valid mail address.
Please read the copyright declaration carefully. If you edited a free licenced gfx file you need to add the source address of the file
and corresponding licence information.
If you style is ready to be shipped please pack the whole directory into a zip archive and send it to anybody you like. If you like your
style to be added into skin gallery on http://www.pokerth.net please send the archive to webmaster@pokerth.net. We cannot promise that
every style will be added, but if everything works fine and the legal issues are also clear there should be no problem.
+++++++++++++++++++++++++
2. Card Deck Styles
+++++++++++++++++++++++++
2.1 Start building a card deck
--------------------------------
Setup a card deck is not so complex like the game table. The xml file is only used for StyleDescription, StyleMaintainerEMail and Preview.
Going throught the data/gfx/cards/default/defaultdeckstyle.xml you will find the needed infos to set this values.
Maybe you like to play around with the default card deck. Therefore you should copy the whole data/gfx/cards/default/ directory to another place.
For better overview in "card deck styles" list in settings please at first change <StyleDescription value="PokerTH default card deck" />
to <StyleDescription value="my custom card deck" />. Maybe you also like to rename the defaultdeckstyle.xml to mycustomcardstyle.xml
and directory name "default" to "mycustomdeck" or something similar.
Now you can start change/edit gfx files.
If you take a look into all files from 0.png to 51.png you will see which card value belongs to which number.
It is VERY IMPORTANT to let the filenames untouched. PokerTH will always take 0.png for "diamond 2", 51.png for "club ace" and
24.png for "heart king" for example. Also a flipside image called "flipside.png" have to be into the card deck directory.
The SIZE for all cards should be 48x76 pixel. If the size of an imgage will not fit 48x76 pixel PokerTH will scale it automatically.
But picture scaling will cause some speed losses when drawing animations and something like this.
2.2 Test your deck
--------------------------------
To test your deck just load it into PokerTH with "Settings" -> "Style" -> "Card Deck Styles" --> "Add ...".
When you have selected your file the value of "StyleDescription" is shown in the list. Select this entry in the list and click "Activate".
Closing the Settings dialog will refresh the style of the card deck.
If you do changes in your mycustomcardstyle.xml there is no need to re-add it into settings or restart PokerTH. The simplest way is just
to open settings dialog and close it immediately. This will refresh the card deck style and show your changes.
2.3 Distribute your deck
-------------------------------
When your card deck style is ready to distribute you should complete the style information StyleDescription, StyleMaintainerEMail and Preview.
Next step is editing the copyright.txt. Here you need to change "Maintainer" to your name and "EMail" to your valid mail address.
Please read the copyright declaration carefully. If you edited a free licenced gfx file you need to add the source address of the file
and corresponding licence information.
If you style is ready to be shipped please pack the whole directory into a zip archive and send it to anybody you like. If you like your
style to be added into skin gallery on http://www.pokerth.net please send the archive to webmaster@pokerth.net. We cannot promise that
every style will be added, but if everything works fine and the legal issues are also clear there should be no problem.
2009 by Felix Hammer
+1131 -1106
View File
File diff suppressed because it is too large Load Diff