gui skinning howto updated

data/gfx/cards/default/defaultdeckstyle.xml

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <PokerTH>
   <CardDeck>
-     <StyleDescription value="PokerTH default card deck" />
+	<StyleDescription value="PokerTH default card deck" /> <!-- This string will be shown in settings/game table style list -->
-     <StyleMaintainerEMail value="webmaster@pokerth.net" />
+	<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" />
+	<Preview value="preview.png" /> <!-- This preview picture will be shown in settings/card deck 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. -->
   </CardDeck>
 </PokerTH>

data/gfx/cards/default4c/default4cdeckstyle.xml

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <PokerTH>
   <CardDeck>
-     <StyleDescription value="PokerTH default card deck (4 color)" />
+	<StyleDescription value="PokerTH default card deck (4 color)" /> <!-- This string will be shown in settings/game table style list -->
-     <StyleMaintainerEMail value="webmaster@pokerth.net" />
+	<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" />
+	<Preview value="preview.png" /> <!-- This preview picture will be shown in settings/card deck 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. -->
   </CardDeck>
 </PokerTH>

data/gfx/gui/table/danuxi1/danuxi1tablestyle.xml

@@ -3,6 +3,7 @@
   <TableStyle>
      <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 -->
+     <Preview value="preview.png" />
      <IfFixedWindowSize value="1" /> <!-- value [1,0] 1 = fixed window size, 0 = resizeable window -->
      <FixedWindowWidth value="1024" />
      <FixedWindowHeight value="600" />
@@ -10,7 +11,6 @@
      <MinimumWindowHeight value="600" />
      <MaximumWindowWidth value="1980" />
      <MaximumWindowHeight value="1200" />
-     <Preview value="preview.png" />
      <ActionAllIn value="action_allin.png" />
      <ActionRaise value="action_raise.png" />
      <ActionBet value="action_bet.png" />

data/gfx/gui/table/default/copyright.txt

@@ -1,22 +0,0 @@
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
- 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						|
-|----------------------------------------------------------------------------------------------------------------
-|							|							|
-|							|							|
-|							|							|
-|							|							|
-|							|							|
------------------------------------------------------------------------------------------------------------------

data/gfx/gui/table/default/defaulttablestyle.xml

@@ -15,49 +15,49 @@
      <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" />
+     <ActionAllIn value="action_allin.png" /> <!-- optimal size width:height in px [100:40] -->
-     <ActionRaise value="action_raise.png" />
+     <ActionRaise value="action_raise.png" /> <!-- optimal size width:height in px [100:40] -->
-     <ActionBet value="action_bet.png" />
+     <ActionBet value="action_bet.png" /> <!-- optimal size width:height in px [100:40] -->
-     <ActionCall value="action_call.png" />
+     <ActionCall value="action_call.png" /> <!-- optimal size width:height in px [100:40] -->
-     <ActionCheck value="action_check.png" />
+     <ActionCheck value="action_check.png" /> <!-- optimal size width:height in px [100:40] -->
-     <ActionFold value="action_fold.png" />
+     <ActionFold value="action_fold.png" /> <!-- optimal size width:height in px [100:40] -->
-     <ActionWinner value="action_winner.png" />
+     <ActionWinner value="action_winner.png" /> <!-- optimal size width:height in px [100:40] -->
-     <BigBlindPuck value="bigblindPuck.png" />
+     <BigBlindPuck value="bigblindPuck.png" /> <!-- optimal size width:height in px [40:42] -->
-     <SmallBlindPuck value="smallblindPuck.png" />
+     <SmallBlindPuck value="smallblindPuck.png" />  <!-- optimal size width:height in px [40:42] -->
-     <DealerPuck value="dealerPuck.png" />
+     <DealerPuck value="dealerPuck.png" />  <!-- optimal size width:height in px [40:42] -->
-     <DefaultAvatar value="genereticAvatar.png" />
+     <DefaultAvatar value="genereticAvatar.png" />  <!-- optimal size width:height in px [50:50] -->
-     <CardHolderFlop value="cardholder_flop.png" />
+     <CardHolderFlop value="cardholder_flop.png" /> <!-- optimal size width:height in px [54:82] -->
-     <CardHolderTurn value="cardholder_turn.png" />
+     <CardHolderTurn value="cardholder_turn.png" /> <!-- optimal size width:height in px [54:82] -->
-     <CardHolderRiver value="cardholder_river.png" />
+     <CardHolderRiver value="cardholder_river.png" /> <!-- optimal size width:height in px [54:82] -->
-     <FoldButtonDefault value="playeraction_red.png" />
+     <FoldButtonDefault value="playeraction_red.png" /> <!-- optimal size width:height in px [160:35] -->
-     <FoldButtonHover value="playeraction_red_hover.png" />
+     <FoldButtonHover value="playeraction_red_hover.png" /> <!-- optimal size width:height in px [160:35] -->
-     <FoldButtonChecked value="playeraction_red_checked.png" />
+     <FoldButtonChecked value="playeraction_red_checked.png" /> <!-- optimal size width:height in px [160:35] -->
-     <FoldButtonCheckedHover value="playeraction_red_checked_hover.png" />
+     <FoldButtonCheckedHover value="playeraction_red_checked_hover.png" /> <!-- optimal size width:height in px [160:35] -->
-     <CheckCallButtonDefault value="playeraction_blue.png" />
+     <CheckCallButtonDefault value="playeraction_blue.png" /> <!-- optimal size width:height in px [160:35] -->
-     <CheckCallButtonHover value="playeraction_blue_hover.png" />
+     <CheckCallButtonHover value="playeraction_blue_hover.png" /> <!-- optimal size width:height in px [160:35] -->
-     <CheckCallButtonChecked value="playeraction_blue_checked.png" />
+     <CheckCallButtonChecked value="playeraction_blue_checked.png" /> <!-- optimal size width:height in px [160:35] -->
-     <CheckCallButtonCheckedHover value="playeraction_blue_checked_hover.png" />
+     <CheckCallButtonCheckedHover value="playeraction_blue_checked_hover.png" /> <!-- optimal size width:height in px [160:35] -->
-     <BetRaiseButtonDefault value="playeraction_green.png" />
+     <BetRaiseButtonDefault value="playeraction_green.png" /> <!-- optimal size width:height in px [160:35] -->
-     <BetRaiseButtonHover value="playeraction_green_hover.png" />
+     <BetRaiseButtonHover value="playeraction_green_hover.png" /> <!-- optimal size width:height in px [160:35] -->
-     <BetRaiseButtonChecked value="playeraction_green_checked.png" />
+     <BetRaiseButtonChecked value="playeraction_green_checked.png" /> <!-- optimal size width:height in px [160:35] -->
-     <BetRaiseButtonCheckedHover value="playeraction_green_checked_hover.png" />
+     <BetRaiseButtonCheckedHover value="playeraction_green_checked_hover.png" /> <!-- optimal size width:height in px [160:35] -->
-     <AllInButtonDefault value="playeraction_orange.png" />
+     <AllInButtonDefault value="playeraction_orange.png" /> <!-- optimal size width:height in px [160:35] -->
-     <AllInButtonHover value="playeraction_orange_hover.png" />
+     <AllInButtonHover value="playeraction_orange_hover.png" /> <!-- optimal size width:height in px [160:35] -->
-     <AllInButtonChecked value="playeraction_orange_checked.png" />
+     <AllInButtonChecked value="playeraction_orange_checked.png" /> <!-- optimal size width:height in px [160:35] -->
-     <AllInButtonCheckedHover value="playeraction_orange_checked_hover.png" />
+     <AllInButtonCheckedHover value="playeraction_orange_checked_hover.png" /> <!-- optimal size width:height in px [160:35] -->
-     <RadioButtonPressed value="radiobutton_pressed.png" />
+     <RadioButtonPressed value="radiobutton_pressed.png" /> <!-- optimal size width:height in px [13:13] -->
-     <RadioButtonChecked value="radiobutton_checked.png" />
+     <RadioButtonChecked value="radiobutton_checked.png" /> <!-- optimal size width:height in px [13:13] -->
-     <RadioButtonCheckedHover value="radiobutton_checked_hover.png" />
+     <RadioButtonCheckedHover value="radiobutton_checked_hover.png" /> <!-- optimal size width:height in px [13:13] -->
-     <RadioButtonUnchecked value="radiobutton_unchecked.png" />
+     <RadioButtonUnchecked value="radiobutton_unchecked.png" /> <!-- optimal size width:height in px [13:13] -->
-     <RadioButtonUncheckedHover value="radiobutton_unchecked_hover.png" />
+     <RadioButtonUncheckedHover value="radiobutton_unchecked_hover.png" /> <!-- optimal size width:height in px [13:13] -->
-     <PlayerTopSeatInactive value="playerSeatInactive.png" />
+     <PlayerTopSeatInactive value="playerSeatInactive.png" />  <!-- optimal size width:height in px [190:142] -->
-     <PlayerTopSeatActive value="playerSeatActive.png" />
+     <PlayerTopSeatActive value="playerSeatActive.png" />  <!-- optimal size width:height in px [190:142] -->
-     <PlayerBottomSeatInactive value="playerSeatInactive.png" />
+     <PlayerBottomSeatInactive value="playerSeatInactive.png" />  <!-- optimal size width:height in px [190:142] -->
-     <PlayerBottomSeatActive value="playerSeatActive.png" />
+     <PlayerBottomSeatActive value="playerSeatActive.png" />  <!-- optimal size width:height in px [190:142] -->
-     <Table value="table.png" />
+     <Table value="table.png" /> <!-- minimal size width:height in px [1024:600] -->
-     <ToolBoxBackground value="toolboxbg.png" />
+     <ToolBoxBackground value="toolboxbg.png" />  <!-- minimal size width:height in px [260:188] -->
-     <HandRanking value="handranking.png" />
+     <HandRanking value="handranking.png" />  <!-- minimal size width:height in px [240:153] -->
-     
+
       <!-- Table Colors - values should be set in hexcode RGB style without "#" -->
      <FKeyIndicatorColor value="FFFFFF" />
      <ChanceLabelPossibleColor value="9CD500" />

docs/gui_skinnig_howto.txt

@@ -16,7 +16,8 @@ Maybe you would like to play around with the default table to see how the contro
 data/gfx/gui/table/default/ directory to another place. In order to avoid confusing styles, please first change the description
 <StyleDescription value="PokerTH default table style" /> to (e.g.) <StyleDescription value="my custom style" />. It is recommended to also
 rename the defaulttablestyle.xml to mycustomstyle.xml or something similar, and the directory name "default" to e.g. "mycustomtable".
-Now you can start playing around with color values or change/edit graphics files.
+Now you can start playing around with color values or change/edit gfx files.
+For best table drawing performance you should draw your gfx files with optimal size, mentioned in the corresponding comment in xml file.
 
 
 1.2 Testing your style
@@ -29,17 +30,6 @@ If you change your mycustomstyle.xml there is no need to re-add it in the settin
 just to open settings dialog and close it immediately. This will refresh the game table style and show your changes.
 
 
-1.3 Distributing your style
--------------------------------
-TODO: Edit this.
-
-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.
-
-If you style is ready to be shipped please pack the whole directory into a zip archive. If you like your style to be added into
-skin gallery on http://www.pokerth.net please send a link to the address where you have hosted your 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
 +++++++++++++++++++++++++
@@ -53,7 +43,7 @@ Maybe you would like to play around with the default card deck. To do this, you
 directory to another place. In order to avoid confusing "card deck styles" please first change the description
 <StyleDescription value="PokerTH default card deck" /> to e.g. <StyleDescription value="my custom card deck" />.
 It is also recommended to rename the defaultdeckstyle.xml to e.g. mycustomcardstyle.xml and the directory name "default" to "mycustomdeck"
-or something similar. Now you can start changing/editing graphics files.
+or something similar. Now you can start changing/editing 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 leave the filenames untouched. PokerTH will always take 0.png for "diamond 2", 51.png for "club ace" and 
@@ -73,20 +63,22 @@ If you do changes in your mycustomcardstyle.xml there is no need to re-add it in
 to open settings dialog and close it immediately. This will refresh the card deck style and show your changes.
 
 
-2.3 Distribute your deck
++++++++++++++++++++++++++
--------------------------------
+3. Distributing Styles
-TODO: Edit this.
++++++++++++++++++++++++++
 
-When your card deck style is ready to distribute you should complete the style information StyleDescription, StyleMaintainerEMail and Preview. 
+When your game table or card deck style is finished you should complete the style information StyleDescription, StyleMaintainerEMail and Preview.
+The best way for game table preview will be a screenshot of the game table style running in PokerTH. For card deck style may be you like to build 
+a picture like data/gfx/cards/default/preview.png
 
-Next step is editing the copyright.txt. Here you need to change "Maintainer" to your name and "EMail" to your valid mail address. 
+If you style is ready to be shipped please pack the whole directory into a zip archive. If you like your style to be added into
-Please read the copyright declaration carefully. If you edited a free licenced gfx file you need to add the source address of the file 
+skin gallery on http://www.pokerth.net please send a link to the address where you are hosting your archive to webmaster@pokerth.net
-and corresponding licence information.
+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.
+Please read PokerTH GUI skinning legal notices (http://www.pokerth.net/content/view/55) carefully if you like to have a link to your style
+archive from http://www.pokerth.net.
 
-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. 
 
+And now ... have a lot of fun when building a lot of stylish PokerTH skins ;-)
 
 
 2009 by Felix Hammer