| Offset 1, 10 lines modified | Offset 1, 10 lines modified |
| 1 | <FILENAME·filename="index.html"><html><head><title>The·KsirK·Skin·Editor·Handbook</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="description"·content="KsirK·is·a·computerized·version·of·a·well·known·strategy·game.·It·is·fully·skinable.·This·manual·explains·how·to·create·new·skins·from·scratch,·using·a·file·browser,·a·SVG·image·editor·and·KsirK·Skin·Editor."><meta·name="keywords"·content="KDE,·kdegames,·game,·strategy,·Risk,·free,·GPL,·skin,·editor"><link·rel="home"·href="index.html"·title="The·KsirK·Skin·Editor·Handbook"><link·rel="next"·href="introduction.html"·title="Chapter 1. Introduction"><meta·http-equiv="Content-Type"·content="text/html;·charset=utf-8"><meta·name="GENERATOR"·content="KDE·XSL·Stylesheet·V1.14·using·libxslt"></head><body·bgcolor="w·✂ | 1 | <FILENAME·filename="index.html"><html><head><title>The·KsirK·Skin·Editor·Handbook</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-localised.css"><meta·name="generator"·content="DocBook·XSL·Stylesheets·V1.76.1"><meta·name="description"·content="KsirK·is·a·computerized·version·of·a·well·known·strategy·game.·It·is·fully·skinable.·This·manual·explains·how·to·create·new·skins·from·scratch,·using·a·file·browser,·a·SVG·image·editor·and·KsirK·Skin·Editor."><meta·name="keywords"·content="KDE,·kdegames,·game,·strategy,·Risk,·free,·GPL,·skin,·editor"><link·rel="home"·href="index.html"·title="The·KsirK·Skin·Editor·Handbook"><link·rel="next"·href="introduction.html"·title="Chapter 1. Introduction"><meta·http-equiv="Content-Type"·content="text/html;·charset=utf-8"><meta·name="GENERATOR"·content="KDE·XSL·Stylesheet·V1.14·using·libxslt"></head><body·bgcolor="w·✂ |
| 2 | <span·class="application">KsirK</span>·is·a·computerized·version·of·a·well·known·strategy·game.·It·is·fully·skinable.·This·manual·explains·how·to·create·new·skins·from·scratch,·using·a·file·browser,·a·SVG·image·editor·and·<span·class="application">KsirK·Skin·Editor</span>. | 2 | <span·class="application">KsirK</span>·is·a·computerized·version·of·a·well·known·strategy·game.·It·is·fully·skinable.·This·manual·explains·how·to·create·new·skins·from·scratch,·using·a·file·browser,·a·SVG·image·editor·and·<span·class="application">KsirK·Skin·Editor</span>. |
| 3 | </p></div></div></div></div><hr></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl><dt><span·class="chapter"><a·href="introduction.html">1.·Introduction</a></span></dt><dt><span·class="chapter"><a·href="using-kapp.html">2.·Creating·a·<span·class="application">KsirK</span>·skin</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="using-kapp.html#sdf">Structure·of·folders·and·files</a></span></dt><dd><dl><dt><span·class="sect2"><a·href="using-kapp.html#tdd">The·Data·folder</a></span></dt><dt><span·class="sect2"><a·href="using-kapp.html#tid">The·Images·folder</a></span></dt><dt><span·class="sect2"><a·href="using-kapp.html#tsd">The·Sounds·folder</a></span></dt></dl></dd><dt><span·class="sect1"><a·href="using-kse.html">Using·the·<span·class="application">KsirK·Skin·Editor</span></a></span></dt></dl></dd><dt><span·class="chapter"><a·href="commands.html">3.·Command·Reference</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="commands.html#kapp-mainwindow">The·main·<span·class="application">KsirK·Skin··✂ | 3 | </p></div></div></div></div><hr></div><div·class="toc"><p><b>Table·of·Contents</b></p><dl><dt><span·class="chapter"><a·href="introduction.html">1.·Introduction</a></span></dt><dt><span·class="chapter"><a·href="using-kapp.html">2.·Creating·a·<span·class="application">KsirK</span>·skin</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="using-kapp.html#sdf">Structure·of·folders·and·files</a></span></dt><dd><dl><dt><span·class="sect2"><a·href="using-kapp.html#tdd">The·Data·folder</a></span></dt><dt><span·class="sect2"><a·href="using-kapp.html#tid">The·Images·folder</a></span></dt><dt><span·class="sect2"><a·href="using-kapp.html#tsd">The·Sounds·folder</a></span></dt></dl></dd><dt><span·class="sect1"><a·href="using-kse.html">Using·the·<span·class="application">KsirK·Skin·Editor</span></a></span></dt></dl></dd><dt><span·class="chapter"><a·href="commands.html">3.·Command·Reference</a></span></dt><dd><dl><dt><span·class="sect1"><a·href="commands.html#kapp-mainwindow">The·main·<span·class="application">KsirK·Skin··✂ |
| 4 | <span·class="application">KsirK</span>·is·a·computerized·version·of·a·well·known·strategy·game.·It·is·fully·skinable.·This·manual·explains·how·to·create·new·skins·from·scratch,·using·a·file·browser,·a·SVG·image·editor·and·<span·class="application">KsirK·Skin·Editor</span>. | 4 | <span·class="application">KsirK</span>·is·a·computerized·version·of·a·well·known·strategy·game.·It·is·fully·skinable.·This·manual·explains·how·to·create·new·skins·from·scratch,·using·a·file·browser,·a·SVG·image·editor·and·<span·class="application">KsirK·Skin·Editor</span>. |
| 5 | </p><p> | 5 | </p><p> |
| 6 | </p><div·class="screenshot"><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="main-snapshot.png"·alt="Screenshot"><hr></div></div><p> | 6 | </p><div·class="screenshot"><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="main-snapshot.png"·alt="Screenshot"><hr></div></div><p> |
| 7 | </p><p> | 7 | </p><p> |
| 8 | There·is·three·main·steps·to·create·a·new·skin:·creating·the·folders·hierarchy;·creating·the·graphics,·all·pooled·inside·a·SVG·file;·and·then·placing·sprites·and·naming·things·using·<span·class="application">KsirK·Skin·Editor</span>. | 8 | There·is·three·main·steps·to·create·a·new·skin:·creating·the·folders·hierarchy;·creating·the·graphics,·all·pooled·inside·a·SVG·file;·and·then·placing·sprites·and·naming·things·using·<span·class="application">KsirK·Skin·Editor</span>. |
| 9 | </p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="index.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="using-kapp.html">Next</a></td></tr><tr><td·class="prevCell">The·<span·class="application">KsirK·Skin·Editor</span>·Handbook </td><td·class="upCell"> </td><td·class="nextCell"> Creating·a·<span·class="application">KsirK</span>·skin</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="using-kapp.html"><html><head><title>Chapter 2. Creating·a·KsirK·skin</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesh·✂ | 9 | </p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="index.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="using-kapp.html">Next</a></td></tr><tr><td·class="prevCell">The·<span·class="application">KsirK·Skin·Editor</span>·Handbook </td><td·class="upCell"> </td><td·class="nextCell"> Creating·a·<span·class="application">KsirK</span>·skin</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME><FILENAME·filename="using-kapp.html"><html><head><title>Chapter 2. Creating·a·KsirK·skin</title><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-default.css"><link·rel="stylesheet"·type="text/css"·href="help:/common/kde-docs.css"><link·rel="stylesh·✂ |
| 10 | ····<span·class="application">KsirK</span>·is·fully·skinable.·For·who·have·graphic·capabilities,·creating·a·new·skin·is·as·simple·as·copying·an·existing·one,·editing·or·changing·the·graphics·and·updating·the·data·in·a·.desktop·configuration·file,·which·is·done·using·the·<span·class="application">KsirK·Skin·Editor</span>.·A·last·step·is·to·edit·the·file·describing·what·to·install. | 10 | ····<span·class="application">KsirK</span>·is·fully·skinable.·For·who·have·graphic·capabilities,·creating·a·new·skin·is·as·simple·as·copying·an·existing·one,·editing·or·changing·the·graphics·and·updating·the·data·in·a·.desktop·configuration·file,·which·is·done·using·the·<span·class="application">KsirK·Skin·Editor</span>.·A·last·step·is·to·edit·the·file·describing·what·to·install. |
| Offset 16, 57 lines modified | Offset 16, 57 lines modified |
| 16 | ··········</p></li><li·class="listitem"><p>CMakeLists.txt/·:·Describes·what·to·install.</p></li><li·class="listitem"><p>Sounds/·:·sound·files·for·the·skin.</p></li></ul></div><p> | 16 | ··········</p></li><li·class="listitem"><p>CMakeLists.txt/·:·Describes·what·to·install.</p></li><li·class="listitem"><p>Sounds/·:·sound·files·for·the·skin.</p></li></ul></div><p> |
| 17 | ····</p><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="tdd"></a>The·Data·folder</h3></div></div></div><p> | 17 | ····</p><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="tdd"></a>The·Data·folder</h3></div></div></div><p> |
| 18 | ··········This·folder·contains·only·one·file,·world.desktop.·This·file·is·a·description·of·the·content·of·the·skin.·It·is·used·to·describe·the·organization·of·the·world·and·how·to·display·it.·You·don't·have·to·fill·it·manualy·as·it·will·be·handled·by·the·<span·class="application">KsirK·Skin·Editor</span>.·But,·for·the·sake·of·completeness,·we·will·now·describe·its·structure. | 18 | ··········This·folder·contains·only·one·file,·world.desktop.·This·file·is·a·description·of·the·content·of·the·skin.·It·is·used·to·describe·the·organization·of·the·world·and·how·to·display·it.·You·don't·have·to·fill·it·manualy·as·it·will·be·handled·by·the·<span·class="application">KsirK·Skin·Editor</span>.·But,·for·the·sake·of·completeness,·we·will·now·describe·its·structure. |
| 19 | ········</p><p> | 19 | ········</p><p> |
| 20 | ··········An·onu·group·contains·a·number·of·country·entries,·a·number·of·nationality·entries·and·lastly·a·number·of·continent·entries.·Then·various·groups·contain·the·description·of·the·different·sprites,·the·description·of·the·different·countries,·continents,·nationalities·and·goals. | 20 | ··········An·onu·group·contains·a·number·of·country·entries,·a·number·of·nationality·entries·and·lastly·a·number·of·continent·entries.·Then·various·groups·contain·the·description·of·the·different·sprites,·the·description·of·the·different·countries,·continents,·nationalities·and·goals. |
| 21 | ········</p><p> | 21 | ········</p><p> |
| 22 | ··········The·following·sections·describe·the·content·of·each·group. | 22 | ··········The·following·sections·describe·the·content·of·each·group. |
| 23 | ········</p><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148728632"></a>The·onu·group</h4></div></div></div><p> | 23 | ········</p><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148732728"></a>The·onu·group</h4></div></div></div><p> |
| 24 | ············</p><div·class="table"><a·name="idp148729528"></a><p·class="title"><b>Table 2.1. The·onu·group·entries</b></p><div·class="table-contents"><table·summary="The·onu·group·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry·name</th><th>Signification</th></tr></thead><tbody><tr><td>width</td><td>The·width·of·the·skin's·map</td></tr><tr><td>height</td><td>The·height·of·the·skin's·map</td></tr><tr><td>skinpath</td><td>The·path·of·the·skin·relative·to·the·application·data·path·(e.g.·skins/default)</td></tr><tr><td>nb-countries</td><td>The·number·of·countries·(42·in·the·default·skin).·There·should·be·the·same·number·of·country·groups·below</td></tr><tr><td>nb-nationalities</td><td>The·number·of·nationalities·(6·in·the·default·skin).·There·should·be·the·same·number·of·nationality·groups·below</td></tr><tr><td>nb-continents</td><td>The·number·of·continents·(6·in·the·default·skin).·There·should·be·the·same·number·of·continent·groups·below</td></tr><tr><td>pool</td><td>The·path·and·name·of·✂ | 24 | ············</p><div·class="table"><a·name="idp148733624"></a><p·class="title"><b>Table 2.1. The·onu·group·entries</b></p><div·class="table-contents"><table·summary="The·onu·group·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry·name</th><th>Signification</th></tr></thead><tbody><tr><td>width</td><td>The·width·of·the·skin's·map</td></tr><tr><td>height</td><td>The·height·of·the·skin's·map</td></tr><tr><td>skinpath</td><td>The·path·of·the·skin·relative·to·the·application·data·path·(e.g.·skins/default)</td></tr><tr><td>nb-countries</td><td>The·number·of·countries·(42·in·the·default·skin).·There·should·be·the·same·number·of·country·groups·below</td></tr><tr><td>nb-nationalities</td><td>The·number·of·nationalities·(6·in·the·default·skin).·There·should·be·the·same·number·of·nationality·groups·below</td></tr><tr><td>nb-continents</td><td>The·number·of·continents·(6·in·the·default·skin).·There·should·be·the·same·number·of·continent·groups·below</td></tr><tr><td>pool</td><td>The·path·and·name·of·✂ |
| 25 | ··········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148742456"></a>The·sprites·description·groups</h4></div></div></div><p> | 25 | ··········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148746552"></a>The·sprites·description·groups</h4></div></div></div><p> |
| 26 | ············Each·type·of·sprite·(flag,·infantry,·cavalry,·cannon,·firing·cannon·and·exploding·cannon)·is·defined·by·a·group.·Only·some·sprites·have·a·width·entry.·This·entry·is·used·for·relative·positioning·during·animations:·the·cannons,·firing·or·exploding·should·not·"move"·around·the·country's·flag·during·fight. | 26 | ············Each·type·of·sprite·(flag,·infantry,·cavalry,·cannon,·firing·cannon·and·exploding·cannon)·is·defined·by·a·group.·Only·some·sprites·have·a·width·entry.·This·entry·is·used·for·relative·positioning·during·animations:·the·cannons,·firing·or·exploding·should·not·"move"·around·the·country's·flag·during·fight. |
| 27 | ············</p><div·class="table"><a·name="idp148743352"></a><p·class="title"><b>Table 2.2. Sprite·description·group·entries</b></p><div·class="table-contents"><table·summary="Sprite·description·group·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry</th><th>Signification</th></tr></thead><tbody><tr><td>width</td><td>The·reference·width·of·the·flag·sprite·frames</td></tr><tr><td>height</td><td>The·reference·height·of·the·flag·sprite·frames</td></tr><tr><td>frames</td><td>The·number·of·frames·of·the·sprite</td></tr><tr><td>versions</td><td>The·number·of·versions·of·the·flag·sprites</td></tr></tbody></table></div></div><p><br·class="table-break"> | 27 | ············</p><div·class="table"><a·name="idp148747448"></a><p·class="title"><b>Table 2.2. Sprite·description·group·entries</b></p><div·class="table-contents"><table·summary="Sprite·description·group·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry</th><th>Signification</th></tr></thead><tbody><tr><td>width</td><td>The·reference·width·of·the·flag·sprite·frames</td></tr><tr><td>height</td><td>The·reference·height·of·the·flag·sprite·frames</td></tr><tr><td>frames</td><td>The·number·of·frames·of·the·sprite</td></tr><tr><td>versions</td><td>The·number·of·versions·of·the·flag·sprites</td></tr></tbody></table></div></div><p><br·class="table-break"> |
| 28 | ··········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148749240"></a>The·countries·description·groups</h4></div></div></div><p> | 28 | ··········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148753336"></a>The·countries·description·groups</h4></div></div></div><p> |
| 29 | ············Each·country·listed·in·the·onu·group,·countries·entry·has·its·own·group·whose·label·is·the·country·name.·The·table·below·lists·the·entries·of·these·groups. | 29 | ············Each·country·listed·in·the·onu·group,·countries·entry·has·its·own·group·whose·label·is·the·country·name.·The·table·below·lists·the·entries·of·these·groups. |
| 30 | ··········</p><p> | 30 | ··········</p><p> |
| 31 | ············</p><div·class="table"><a·name="idp148750520"></a><p·class="title"><b>Table 2.3. Country·entries</b></p><div·class="table-contents"><table·summary="Country·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry·name</th><th>Signification</th></tr></thead><tbody><tr><td>id</td><td>The·integer·unique·identification·number·of·the·country,·must·start·at·zero·(0)</td></tr><tr><td>name</td><td>The·displayed·name·of·the·country</td></tr><tr><td><sprite>-point</td><td>Each·type·of·sprite·(flag,·infantry,·etc.)·in·the·country·is·displayed·at·a·certain·position·defined·by·this·entry·made·of·two·integers·separated·by·a·comma</td></tr><tr><td>neighbours</td><td>The·list·of·the·ids·of·the·neighbors·of·the·current·country</td></tr></tbody></table></div></div><p><br·class="table-break"> | 31 | ············</p><div·class="table"><a·name="idp148754616"></a><p·class="title"><b>Table 2.3. Country·entries</b></p><div·class="table-contents"><table·summary="Country·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry·name</th><th>Signification</th></tr></thead><tbody><tr><td>id</td><td>The·integer·unique·identification·number·of·the·country,·must·start·at·zero·(0)</td></tr><tr><td>name</td><td>The·displayed·name·of·the·country</td></tr><tr><td><sprite>-point</td><td>Each·type·of·sprite·(flag,·infantry,·etc.)·in·the·country·is·displayed·at·a·certain·position·defined·by·this·entry·made·of·two·integers·separated·by·a·comma</td></tr><tr><td>neighbours</td><td>The·list·of·the·ids·of·the·neighbors·of·the·current·country</td></tr></tbody></table></div></div><p><br·class="table-break"> |
| 32 | ··········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148756408"></a>The·nationalities·description·groups</h4></div></div></div><p> | 32 | ··········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148760504"></a>The·nationalities·description·groups</h4></div></div></div><p> |
| 33 | ············Each·nationality·listed·in·the·onu·group,·nationalities·entry·has·its·own·group·whose·label·is·the·nationality·name.·The·table·below·lists·the·entries·of·these·groups. | 33 | ············Each·nationality·listed·in·the·onu·group,·nationalities·entry·has·its·own·group·whose·label·is·the·nationality·name.·The·table·below·lists·the·entries·of·these·groups. |
| 34 | ··········</p><p> | 34 | ··········</p><p> |
| 35 | ············</p><div·class="table"><a·name="idp148769976"></a><p·class="title"><b>Table 2.4. Nationality·entries</b></p><div·class="table-contents"><table·summary="Nationality·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry·name</th><th>Signification</th></tr></thead><tbody><tr><td>name</td><td>The·name·of·the·nationality·(e.g.·Japan)</td></tr><tr><td>leader</td><td>The·name·that·will·be·proposed·to·the·player·choosing·this·nationality</td></tr><tr><td>flag</td><td>The·name·of·the·country's·flag·sprite·element·in·the·onu·SVG·file</td></tr></tbody></table></div></div><p><br·class="table-break"> | 35 | ············</p><div·class="table"><a·name="idp148774072"></a><p·class="title"><b>Table 2.4. Nationality·entries</b></p><div·class="table-contents"><table·summary="Nationality·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry·name</th><th>Signification</th></tr></thead><tbody><tr><td>name</td><td>The·name·of·the·nationality·(e.g.·Japan)</td></tr><tr><td>leader</td><td>The·name·that·will·be·proposed·to·the·player·choosing·this·nationality</td></tr><tr><td>flag</td><td>The·name·of·the·country's·flag·sprite·element·in·the·onu·SVG·file</td></tr></tbody></table></div></div><p><br·class="table-break"> |
| 36 | ··········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148775096"></a>The·continents·description·groups</h4></div></div></div><p> | 36 | ··········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148779192"></a>The·continents·description·groups</h4></div></div></div><p> |
| 37 | ············Each·continent·listed·in·the·onu·group,·continents·entry·has·its·own·group·whose·label·is·the·continent·name.·The·table·below·lists·the·entries·of·these·groups. | 37 | ············Each·continent·listed·in·the·onu·group,·continents·entry·has·its·own·group·whose·label·is·the·continent·name.·The·table·below·lists·the·entries·of·these·groups. |
| 38 | ··········</p><p> | 38 | ··········</p><p> |
| 39 | ············</p><div·class="table"><a·name="idp148776376"></a><p·class="title"><b>Table 2.5. Continent·entries</b></p><div·class="table-contents"><table·summary="Continent·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry·name</th><th>Signification</th></tr></thead><tbody><tr><td>name</td><td>The·name·of·the·continent·(e.g.·Africa)</td></tr><tr><td>id</td><td>The·integer·unique·identification·number·of·the·continent</td></tr><tr><td>bonus</td><td>The·number·of·armies·obtained·at·the·end·of·the·turn·by·the·player·owning·all·the·countries·of·the·continent</td></tr><tr><td>continent-countries</td><td>The·list·of·the·ids·of·the·countries·inside·the·current·continent</td></tr></tbody></table></div></div><p><br·class="table-break"> | 39 | ············</p><div·class="table"><a·name="idp148780472"></a><p·class="title"><b>Table 2.5. Continent·entries</b></p><div·class="table-contents"><table·summary="Continent·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry·name</th><th>Signification</th></tr></thead><tbody><tr><td>name</td><td>The·name·of·the·continent·(e.g.·Africa)</td></tr><tr><td>id</td><td>The·integer·unique·identification·number·of·the·continent</td></tr><tr><td>bonus</td><td>The·number·of·armies·obtained·at·the·end·of·the·turn·by·the·player·owning·all·the·countries·of·the·continent</td></tr><tr><td>continent-countries</td><td>The·list·of·the·ids·of·the·countries·inside·the·current·continent</td></tr></tbody></table></div></div><p><br·class="table-break"> |
| 40 | ··········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148782264"></a>The·goals·description·groups</h4></div></div></div><p> | 40 | ··········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148786360"></a>The·goals·description·groups</h4></div></div></div><p> |
| 41 | ············Each·goal·listed·in·the·onu·group,·goals·entry·has·its·own·group·whose·label·is·the·goal·name.·The·table·below·lists·the·entries·of·these·groups. | 41 | ············Each·goal·listed·in·the·onu·group,·goals·entry·has·its·own·group·whose·label·is·the·goal·name.·The·table·below·lists·the·entries·of·these·groups. |
| 42 | ··········</p><p> | 42 | ··········</p><p> |
| 43 | ············</p><div·class="table"><a·name="idp148783544"></a><p·class="title"><b>Table 2.6. Goal·entries</b></p><div·class="table-contents"><table·summary="Goal·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry·name</th><th>Signification</th></tr></thead><tbody><tr><td>type</td><td>The·type·of·goal.·Can·be·continents,·countries·or·player</td></tr><tr><td>nbArmiesByCountry</td><td>set·the·minimal·number·of·armies·the·player·will·have·to·put·on·each·country</td></tr><tr><td>nbCountries</td><td>set·the·number·of·countries·the·player·must·possess</td></tr><tr><td>nbCountriesFallback</td><td>For·a·player·goal·type,·if·the·target·player·is·killed·by·another·one,·this·sets·the·number·of·countries·the·player·will·have·to·conquer·instead</td></tr><tr><td>desc</td><td>A·full·text·description·of·the·goal·with·appropriate·placeholders·(needs·more·doc·here)</td></tr><tr><td>continents</td><td>The·list·of·continents·ids·the·player·will·have·to·conquer</td></tr></tbody></table></div></div><p><br·class·✂ | 43 | ············</p><div·class="table"><a·name="idp148787640"></a><p·class="title"><b>Table 2.6. Goal·entries</b></p><div·class="table-contents"><table·summary="Goal·entries"·border="1"><colgroup><col><col></colgroup><thead><tr><th>Entry·name</th><th>Signification</th></tr></thead><tbody><tr><td>type</td><td>The·type·of·goal.·Can·be·continents,·countries·or·player</td></tr><tr><td>nbArmiesByCountry</td><td>set·the·minimal·number·of·armies·the·player·will·have·to·put·on·each·country</td></tr><tr><td>nbCountries</td><td>set·the·number·of·countries·the·player·must·possess</td></tr><tr><td>nbCountriesFallback</td><td>For·a·player·goal·type,·if·the·target·player·is·killed·by·another·one,·this·sets·the·number·of·countries·the·player·will·have·to·conquer·instead</td></tr><tr><td>desc</td><td>A·full·text·description·of·the·goal·with·appropriate·placeholders·(needs·more·doc·here)</td></tr><tr><td>continents</td><td>The·list·of·continents·ids·the·player·will·have·to·conquer</td></tr></tbody></table></div></div><p><br·class·✂ |
| 44 | ··········</p></div></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="tid"></a>The·Images·folder</h3></div></div></div><p> | 44 | ··········</p></div></div><div·class="sect2"><div·class="titlepage"><div><div><h3·class="title"><a·name="tid"></a>The·Images·folder</h3></div></div></div><p> |
| 45 | ········This·folder·contains·the·buttons·specific·to·<span·class="application">KsirK</span>·and·the·pool·SVG·file·that·contains·the·map·and·all·sprites. | 45 | ········This·folder·contains·the·buttons·specific·to·<span·class="application">KsirK</span>·and·the·pool·SVG·file·that·contains·the·map·and·all·sprites. |
| 46 | ······</p><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148792632"></a>The·pool.svg·file</h4></div></div></div><p> | 46 | ······</p><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148796728"></a>The·pool.svg·file</h4></div></div></div><p> |
| 47 | ··········This·SVG·file·contains·the·map·and·all·the·sprites·of·the·game.·Each·element·is·named·such·that·the·game·can·select·and·render·separately·each·of·them. | 47 | ··········This·SVG·file·contains·the·map·and·all·the·sprites·of·the·game.·Each·element·is·named·such·that·the·game·can·select·and·render·separately·each·of·them. |
| 48 | ········</p><p> | 48 | ········</p><p> |
| 49 | ··········In·the·default·skin,·the·sprites·are·flags,·infantry,·cavalry·and·cannon.·Infantry·represents·one·army,·five·for·cavalry·and·ten·for·cannons.·Cannons·are·also·used·to·display·fighting·armies.·That's·why·there·is·three·kinds·of·cannon·sprites:·normal·static·or·moving·cannon,·firing·one·and·exploding·one. | 49 | ··········In·the·default·skin,·the·sprites·are·flags,·infantry,·cavalry·and·cannon.·Infantry·represents·one·army,·five·for·cavalry·and·ten·for·cannons.·Cannons·are·also·used·to·display·fighting·armies.·That's·why·there·is·three·kinds·of·cannon·sprites:·normal·static·or·moving·cannon,·firing·one·and·exploding·one. |
| 50 | ········</p><p> | 50 | ········</p><p> |
| 51 | ··········Each·sprite·image·is·the·concatenation·of·the·various·views·of·the·object·and·for·each·view,·its·frames.·Views·are·organized·vertically·and·frames·horizontally.·Where·to·cut·the·image·in·individual·frames·is·found·by·dividing·the·height·of·the·image·by·the·number·of·views·and·the·width·by·the·number·of·frames.·These·data·are·found·in·the·onu.desktop·file. | 51 | ··········Each·sprite·image·is·the·concatenation·of·the·various·views·of·the·object·and·for·each·view,·its·frames.·Views·are·organized·vertically·and·frames·horizontally.·Where·to·cut·the·image·in·individual·frames·is·found·by·dividing·the·height·of·the·image·by·the·number·of·views·and·the·width·by·the·number·of·frames.·These·data·are·found·in·the·onu.desktop·file. |
| 52 | ··········</p><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="cannon.png"><div·class="caption"><p>An·example·of·a·sprite·image:·cannon.png</p></div><hr></div><p> | 52 | ··········</p><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="cannon.png"><div·class="caption"><p>An·example·of·a·sprite·image:·cannon.png</p></div><hr></div><p> |
| 53 | ········</p><p> | 53 | ········</p><p> |
| 54 | ··········For·armies·sprites,·there·is·three·different·views,·from·top·to·bottom:</p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p>looking·right</p></li><li·class="listitem"><p>looking·left·and</p></li><li·class="listitem"><p>facer</p></li></ul></div><p>·For·flags,·there·is·only·one·view.·All·sprites·backgrounds·should·be·set·to·transparent. | 54 | ··········For·armies·sprites,·there·is·three·different·views,·from·top·to·bottom:</p><div·class="itemizedlist"><ul·class="itemizedlist"·type="disc"><li·class="listitem"><p>looking·right</p></li><li·class="listitem"><p>looking·left·and</p></li><li·class="listitem"><p>facer</p></li></ul></div><p>·For·flags,·there·is·only·one·view.·All·sprites·backgrounds·should·be·set·to·transparent. |
| 55 | ··········</p><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="italy.png"><div·class="caption"><p>An·example·of·a·flag·sprite·image:·italy.png</p></div><hr></div><p> | 55 | ··········</p><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="italy.png"><div·class="caption"><p>An·example·of·a·flag·sprite·image:·italy.png</p></div><hr></div><p> |
| 56 | ········</p><p> | 56 | ········</p><p> |
| 57 | ········</p><div·class="table"><a·name="idp148799416"></a><p·class="title"><b>Table 2.7. The·elements·of·the·pool</b></p><div·class="table-contents"><table·summary="The·elements·of·the·pool"·border="1"><colgroup><col><col><col></colgroup><thead><tr><th>Element·name</th><th>Sample·Image</th><th>Signification</th></tr></thead><tbody><tr><td>map</td><td><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="map.png"><hr></div></td><td>Map·of·the·skins's·world.·Countries·can·have·arbitrary·shapes,·but·should·be·grouped·in·eye-recognizable·continents,·by·location·only·or·by·color</td></tr><tr><td>italy</td><td><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="italy.png"><hr></div></td><td>The·flag·of·the·Italy·nation.·There·is·one·such·entry·for·each·nation</td></tr><tr><td>infantry</td><td><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="infantry.png"><hr></div></td><td>Icon·representing·one·army·✂ | 57 | ········</p><div·class="table"><a·name="idp148807608"></a><p·class="title"><b>Table 2.7. The·elements·of·the·pool</b></p><div·class="table-contents"><table·summary="The·elements·of·the·pool"·border="1"><colgroup><col><col><col></colgroup><thead><tr><th>Element·name</th><th>Sample·Image</th><th>Signification</th></tr></thead><tbody><tr><td>map</td><td><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="map.png"><hr></div></td><td>Map·of·the·skins's·world.·Countries·can·have·arbitrary·shapes,·but·should·be·grouped·in·eye-recognizable·continents,·by·location·only·or·by·color</td></tr><tr><td>italy</td><td><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="italy.png"><hr></div></td><td>The·flag·of·the·Italy·nation.·There·is·one·such·entry·for·each·nation</td></tr><tr><td>infantry</td><td><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="infantry.png"><hr></div></td><td>Icon·representing·one·army·✂ |
| 58 | ········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148834488"></a>The·map-mask.png·file</h4></div></div></div><p> | 58 | ········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148842680"></a>The·map-mask.png·file</h4></div></div></div><p> |
| 59 | ··········This·is·a·png·file·representing·also·the·map·of·the·skins's·world,·but·with·coded·colors·that·allows·one·to·identify·uniquely·each·country.·Countries·must·have·at·least·the·same·shapes·as·the·corresponding·countries·on·the·map.png·file·so·that·users·can·click·anywhere·in·a·viewable·country·and·select·the·good·one.·Countries,·like·little·islands·as·Indonesia·in·the·default·map·can·be·greater·than·the·equivalent·in·the·map.png·file·to·facilitate·the·selection·of·the·country. | 59 | ··········This·is·a·png·file·representing·also·the·map·of·the·skins's·world,·but·with·coded·colors·that·allows·one·to·identify·uniquely·each·country.·Countries·must·have·at·least·the·same·shapes·as·the·corresponding·countries·on·the·map.png·file·so·that·users·can·click·anywhere·in·a·viewable·country·and·select·the·good·one.·Countries,·like·little·islands·as·Indonesia·in·the·default·map·can·be·greater·than·the·equivalent·in·the·map.png·file·to·facilitate·the·selection·of·the·country. |
| 60 | ··········</p><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="map-mask.png"·alt="A·sample·map-mask"><hr></div><p> | 60 | ··········</p><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="map-mask.png"·alt="A·sample·map-mask"><hr></div><p> |
| 61 | ········</p><p> | 61 | ········</p><p> |
| 62 | ··········The·blue·component·(in·RGB·model)·of·a·country's·color·identifies·the·country:·index·0·is·country·0·in·the·onu.xml·file,·index·1·is·country·1,·<abbr·class="abbrev">etc.</abbr>·White·(0xFFFFFF·in·RGB)·identifies·the·absence·of·country·(sees·or,·why·not,·no·man's·lands). | 62 | ··········The·blue·component·(in·RGB·model)·of·a·country's·color·identifies·the·country:·index·0·is·country·0·in·the·onu.xml·file,·index·1·is·country·1,·<abbr·class="abbrev">etc.</abbr>·White·(0xFFFFFF·in·RGB)·identifies·the·absence·of·country·(sees·or,·why·not,·no·man's·lands). |
| 63 | ········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148838200"></a>The·buttons·images</h4></div></div></div><p>The·filenames·are·hard-coded·in·the·code,·so·they·should·not·be·modified.·The·table·below·shows·all·the·buttons·that·should·be·provided.</p><div·class="table"><a·name="idp148839224"></a><p·class="title"><b>Table 2.8. The·buttons·of·the·<acronym·class="acronym">GUI</acronym></b></p><div·class="table-contents"><table·summary="The·buttons·of·the·GUI"·border="1"><colgroup><col><col><col></colgroup><thead><tr><th>Image</th><th>Filename</th><th>Signification</th></tr></thead><tbody><tr><td><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="newNetGame.png"><hr></div></td><td>newNetGame.png</td><td>Tries·to·join·a·network·game</td></tr><tr><td><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="recycling.png"><hr></div></td><td>recycling.png</td><td>After·all·players·have·put·their·a·✂ | 63 | ········</p></div><div·class="sect3"><div·class="titlepage"><div><div><h4·class="title"><a·name="idp148846392"></a>The·buttons·images</h4></div></div></div><p>The·filenames·are·hard-coded·in·the·code,·so·they·should·not·be·modified.·The·table·below·shows·all·the·buttons·that·should·be·provided.</p><div·class="table"><a·name="idp148847416"></a><p·class="title"><b>Table 2.8. The·buttons·of·the·<acronym·class="acronym">GUI</acronym></b></p><div·class="table-contents"><table·summary="The·buttons·of·the·GUI"·border="1"><colgroup><col><col><col></colgroup><thead><tr><th>Image</th><th>Filename</th><th>Signification</th></tr></thead><tbody><tr><td><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="newNetGame.png"><hr></div></td><td>newNetGame.png</td><td>Tries·to·join·a·network·game</td></tr><tr><td><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="recycling.png"><hr></div></td><td>recycling.png</td><td>After·all·players·have·put·their·a·✂ |
| 64 | ······</p><div·class="screenshot"><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="main-snapshot.png"·alt="Screenshot"><hr></div></div><p> | 64 | ······</p><div·class="screenshot"><div·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="mediaobject"><hr><img·src="main-snapshot.png"·alt="Screenshot"><hr></div></div><p> |
| 65 | ····</p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="using-kapp.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="commands.html">Next</a></td></tr><tr><td·class="prevCell">Creating·a·<span·class="application">KsirK</span>·skin </td><td·class="upCell">Creating·a·<span·class="application">KsirK</span>·skin</td><td·class="nextCell"> Command·Reference</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="introduction.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCel·✂ | 65 | ····</p></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="using-kapp.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCell"><a·accesskey="n"·href="commands.html">Next</a></td></tr><tr><td·class="prevCell">Creating·a·<span·class="application">KsirK</span>·skin </td><td·class="upCell">Creating·a·<span·class="application">KsirK</span>·skin</td><td·class="nextCell"> Command·Reference</td></tr></table></div><div·id="footer_text">Would·you·like·to·make·a·comment·or·contribute·an·update·to·this·page?<br>Send·feedback·to·the·<a·href="mailto:kde-doc-english@kde.org"·class="footer_email">KDE·Docs·Team</a></div></div></div></body></html></FILENAME></div></div><div·id="footer"><div·class="navCenter"><table·class="navigation"><tr><td·class="prevCell"><a·accesskey="p"·href="introduction.html">Prev</a></td><td·class="upCell"><a·accesskey="h"·href="index.html">Contents</a></td><td·class="nextCel·✂ |
| 66 | </p><div·class="variablelist"><dl><dt><span·class="term"> | 66 | </p><div·class="variablelist"><dl><dt><span·class="term"> |
| 67 | ········<span·class="inlinemediaobject"><img·src="load.png"·alt="Load"></span> | 67 | ········<span·class="inlinemediaobject"><img·src="load.png"·alt="Load"></span> |
| 68 | ······<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Load</span></span> | 68 | ······<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Load</span></span> |
| 69 | ····</span></dt><dd><p><span·class="action">Causes·the·program·to·load·an·existing·skin.</span></p></dd><dt><span·class="term"> | 69 | ····</span></dt><dd><p><span·class="action">Causes·the·program·to·load·an·existing·skin.</span></p></dd><dt><span·class="term"> |
| 70 | ········<span·class="inlinemediaobject"><img·src="save.png"·alt="Save"></span> | 70 | ········<span·class="inlinemediaobject"><img·src="save.png"·alt="Save"></span> |
| 71 | ······<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Save</span></span> | 71 | ······<span·xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"·class="guiitem"><span·class="guibutton">Save</span></span> |
| 72 | ····</span></dt><dd><p><span·class="action">Saves·the·currently·edited·skin</span></p></dd></dl></div><p> | 72 | ····</span></dt><dd><p><span·class="action">Saves·the·currently·edited·skin</span></p></dd></dl></div><p> |