diff --git a/docs/de.po b/docs/de.po index 6ea662495..c2df30f5c 100644 --- a/docs/de.po +++ b/docs/de.po @@ -12383,33 +12383,36 @@ msgstr "Teams.txt" msgid "Contains the Teamsettings for multiplayer scenarios." msgstr "Enthält Teameinstellungen für Mehrspielerszenarien." +#: sdk/folder/index.xml:20(dt) #: sdk/scenario/index.xml:20(dt) -msgid " Title.png" +msgid "Title.png" msgstr "Title.png" #: sdk/scenario/index.xml:22(text) msgid "The title picture of the scenario in png format. Size: 200x150 pixel." msgstr "Das Titelbild des Szenarios im Format PNG. Größe: 200x150 Pixel." +#: sdk/folder/index.xml:24(dt) #: sdk/scenario/index.xml:24(dt) -msgid " Icon.png" -msgstr " Icon.png" +msgid "Icon.png" +msgstr "Icon.png" #: sdk/scenario/index.xml:26(text) msgid "The icon of the scenario in png format. Size: 24x24 pixel." msgstr "Das Icon des Szenarios im Format PNG. Größe 24x24 Pixel." +#: sdk/folder/index.xml:44(dt) #: sdk/scenario/index.xml:28(dt) -msgid " Loader*.png" -msgstr " Loader*.png" +msgid "Loader*.png" +msgstr "Loader*.png" #: sdk/scenario/index.xml:30(text) msgid "Loader screen to be displayed while the scenario is loading. If multiple files are present (Loader1.png, Loader2.png, Loader3.png...), one is selected randomly. You can optionally specify which loader to use in Scenario.txt. Loader image files located in parent scenario folders are also used." msgstr "Eine Grafik, die beim Start der Runde angezeigt wird. Sind mehrere Dateien vorhanden (Loader1.png, Loader2.png, Loader3.png...), wird per Zufall eine ausgewählt, wobei über eine optional im Scenario.txt vorhandene Loader-Spezifikation die Auswahl noch weiter vorgegeben werden kann. Beim veralteten BMP-Format mit 256 Farben müssen die Farben Schwarz bei Palettenindex 16 und Weiß bei Index 31 vorhanden sein, damit Meldungen beim Startvorgang korrekt angezeigt werden können. Auch Loader-Grafiken aus einem übergeordneten Ordner werden geladen." #: sdk/scenario/index.xml:32(dt) -msgid " Sky.png" -msgstr " Sky.png" +msgid "Sky.png" +msgstr "Sky.png" #: sdk/scenario/index.xml:34(text) msgid "The sky background image. Sky graphics should either be tileable or big enough that it won't even tile if the player zooms out very far." @@ -12417,8 +12420,8 @@ msgstr "Das Himmels-Hintergrundbild. Himmelsgrafiken sollten kachelbar sein oder #: sdk/scenario/index.xml:36(dt) #: sdk/folder/index.xml:28(dt) -msgid " Desc*.rtf" -msgstr " Desc*.rtf" +msgid "Desc*.rtf" +msgstr "Desc*.rtf" #: sdk/scenario/index.xml:38(text) #: sdk/folder/index.xml:30(text) @@ -12437,8 +12440,8 @@ msgstr "Diese Datei erstellt man am besten mit dem zu Windows gehörenden WordPa #: sdk/scenario/index.xml:42(dt) #: sdk/folder/index.xml:34(dt) -msgid " Title.txt" -msgstr " Title.txt" +msgid "Title.txt" +msgstr "Title.txt" #: sdk/scenario/index.xml:44(text) #: sdk/folder/index.xml:36(text) @@ -12461,8 +12464,8 @@ msgid "The scenario script." msgstr "Das Szenarioscript." #: sdk/scenario/index.xml:52(dt) -msgid " Map.bmp" -msgstr " Map.bmp" +msgid "Map.bmp" +msgstr "Map.bmp" #: sdk/scenario/index.xml:54(text) msgid "Static landscapes are stretched by factor MapZoom defined in Scenario.txt to the size of the actual landscape in the game. The colors used in Map.bmp correspond to materials and textures as defined in TexMap.txt." @@ -12473,8 +12476,8 @@ msgid "Exact landscapes represent the actual in-game landscape saved to a bitmap msgstr "Exakte Landkarten (ExactLandscape) geben die tatsächliche Spiellandschaft wieder. Die Farbindizes in Landscape.bmp (128-191 und 192-255, jeweils 3 Farben pro Material) repräsentieren direkt die für das Szenario festgelegten Materialien. Die aktuelle Materialanordnung wird in MatMap.txt festgehalten." #: sdk/scenario/index.xml:57(dt) -msgid " Landscape.png" -msgstr " Landscape.png" +msgid "Landscape.png" +msgstr "Landscape.png" #: sdk/scenario/index.xml:59(text) msgid "Full size map for exact landscapes. This is mainly used in savegames to store the exact terrain including transparent materials and their texture. Exact landscapes consume an extreme amount of memory and should not be used for regularly distributed scenarios." @@ -12489,16 +12492,16 @@ msgid "Advanced scenario designers can use this component to define highly compl msgstr "Besonders fortgeschrittene Spieler können über diese Datei komplexe Zufallslandschaften definieren. Dafür sind allerdings mathematisches und logisches Verständnis sowie viel Geduld unumgänglich." #: sdk/scenario/index.xml:65(dt) -msgid " MatMap.txt" -msgstr " MatMap.txt" +msgid "MatMap.txt" +msgstr "MatMap.txt" #: sdk/scenario/index.xml:67(text) msgid "Stores the material table used in this scenario. The materials listed here are used by the exact landscape and have to be available in the loaded Material.ocg group." msgstr "Enthält die Anordnung der in diesem Szenario verwendeten Materialien. Die hier aufgeführten Materialien werden von der exakten Landkarte verwendet und müssen beim Start der Runde in der zu ladenden Datei Material.ocg vorhanden sein." #: sdk/scenario/index.xml:69(dt) -msgid " Objects.txt" -msgstr " Objects.txt" +msgid "Objects.txt" +msgstr "Objects.txt" #: sdk/scenario/index.xml:71(text) msgid "This component is generated by the engine and stores runtime object data of a savegame." @@ -12513,33 +12516,35 @@ msgstr "Material.ocg" msgid "Scenarios can contain local material definition groups. See overloading rules." msgstr "Szenarien können lokale Materialdefinitionen enthalten. Es gelten die Überladungsregeln." +#: sdk/folder/index.xml:52(dt) #: sdk/scenario/index.xml:77(dt) -msgid " Graphics.ocg" -msgstr " Graphics.ocg" +msgid "Graphics.ocg" +msgstr "Graphics.ocg" #: sdk/scenario/index.xml:79(text) msgid "Scenarios can overload individual entries of the global Graphics.ocg group. See overloading rules." msgstr "Szenarien können einzelne Grafiken aus der systemglobalen Graphics.ocg überladen. Es gelten die Überladungsregeln." #: sdk/scenario/index.xml:81(dt) -msgid " *.wav" -msgstr " *.wav" +msgid "*.wav" +msgstr "*.wav" #: sdk/scenario/index.xml:83(text) msgid "Scenarios can contain any number of sound files. These can be played back by script during the game. Scenario local sounds are loaded dynamically on demand which might cause delays with large scenario files." msgstr "Szenarien können beliebig lokale Sounds enthalten. Diese können per Script während des Spiels abgespielt werden. Szenariolokale Sounds werden dynamisch und erst bei Bedarf geladen, was bei großen Szenariodateien zu Verzögerungen führen kann." #: sdk/scenario/index.xml:85(dt) -msgid " *.mid/*.ogg" -msgstr " *.mid/*.ogg" +msgid "*.mid/*.ogg" +msgstr "*.mid/*.ogg" #: sdk/scenario/index.xml:87(text) msgid "If the scenario contains music files, these can be played back during the game in random order. Also see script command Music()." msgstr "Wenn das Szenario lokale Musikdateien enthält, werden diese während der Runde in zufälliger Reihenfolge abgespielt. Siehe auch Script-Funktion Music()." #: sdk/scenario/index.xml:89(dt) -msgid " Music.ocg" -msgstr " Music.ocg" +#: sdk/folder/index.xml:56(dt) +msgid "Music.ocg" +msgstr "Music.ocg" #: sdk/scenario/index.xml:91(text) msgid "Local music files can also be combines in a local music group." @@ -12560,8 +12565,8 @@ msgid "The engine will also search all parent folders (ocf) of the scenario for msgstr "Die Engine durchsucht auch alle übergeordneten Rundenordner (ocf) des Szenarios nach Objektdefinitionen. Dadurch kann ein Rundenordner Objektdefinitionen enthalten, die dann in allen untergeordneten Szenarien verfügbar sind." #: sdk/scenario/index.xml:98(dt) -msgid " Names.txt" -msgstr " Names.txt" +msgid "Names.txt" +msgstr "Names.txt" #: sdk/scenario/index.xml:100(text) msgid "These names are used for clonks created in this scenario." @@ -12570,8 +12575,8 @@ msgstr "Diese Namen werden für während der Runde neu erzeugte Clonks verwendet #: sdk/scenario/index.xml:102(dt) #: sdk/folder/index.xml:64(dt) #: sdk/definition/index.xml:64(dt) -msgid " Info.txt" -msgstr " Info.txt" +msgid "Info.txt" +msgstr "Info.txt" #: sdk/scenario/index.xml:104(text) #: sdk/folder/index.xml:66(text) @@ -12581,8 +12586,8 @@ msgstr "Hier kann der Autor zusätzliche Informationen über den Entwicklungssta #: sdk/scenario/index.xml:106(dt) #: sdk/folder/index.xml:68(dt) #: sdk/definition/index.xml:68(dt) -msgid " Author.txt" -msgstr " Author.txt" +msgid "Author.txt" +msgstr "Author.txt" #: sdk/scenario/index.xml:108(text) #: sdk/folder/index.xml:70(text) @@ -13401,8 +13406,8 @@ msgid "Particle Components (ocd)" msgstr "Partikel-Komponenten (OCD)" #: sdk/particle/index.xml:14(dt) -msgid " Particle.txt" -msgstr " Particle.txt" +msgid "Particle.txt" +msgstr "Particle.txt" #: sdk/particle/index.xml:16(text) msgid "Particle properties." @@ -13410,8 +13415,8 @@ msgstr "Partikeleigenschaften." #: sdk/particle/index.xml:18(dt) #: sdk/definition/index.xml:16(dt) -msgid " Graphics.png" -msgstr " Graphics.png" +msgid "Graphics.png" +msgstr "Graphics.png" #: sdk/particle/index.xml:20(text) msgid "Particle graphics." @@ -14388,8 +14393,8 @@ msgid "Material Definition Components (Material.ocg)" msgstr "Materialdefinitions-Komponenten (Material.ocg)" #: sdk/material/index.xml:12(dt) -msgid " TexMap.txt" -msgstr " TexMap.txt" +msgid "TexMap.txt" +msgstr "TexMap.txt" #: sdk/material/index.xml:14(text) msgid "Lookup table for color indices in static and dynamic landscapes. Colors 0-127 are matched to a material-texture-reference. Colors 128-255 are matched to the same list of references only these are marked 'underground'." @@ -14412,8 +14417,8 @@ msgid "The engine will accept up to 125 material definitions at a time. OCM file msgstr "Die Engine akzeptiert bis zu 125 Materialdefinitionen gleichzeitig. OCM-Dateien sind einfache Textdateien. Die Materialien Vehicle, Tunnel, Water, Snow, Granite, Sand und Earth müssen immer vorhanden sein." #: sdk/material/index.xml:22(dt) -msgid " *.png" -msgstr " *.png" +msgid "*.png" +msgstr "*.png" #: sdk/material/index.xml:24(text) msgid "There can be any number of textures in any material group. Width and height of each bitmap must be powers of 2 (that is 16, 32, 64, 128, 256, etc.)." @@ -14549,25 +14554,17 @@ msgid "Scenario folders can contain any number of scenarios." msgstr "Rundenordner können beliebig viele Szenarien enthalten, die in diesem Ordner ausgewählt werden können." #: sdk/folder/index.xml:16(dt) -msgid " *.ocf" -msgstr " *.ocf" +msgid "*.ocf" +msgstr "*.ocf" #: sdk/folder/index.xml:18(text) msgid "Scenario folders can also contain other scenario folders." msgstr "Rundenordner lassen sich auch schachteln." -#: sdk/folder/index.xml:20(dt) -msgid "Title.png" -msgstr "Title.png" - #: sdk/folder/index.xml:22(text) msgid "The title picture of the scenario folder in png format. Size: 200x150 pixel." msgstr "Das Titelbild des Szenarios im Format PNG. Größe: 200x150 Pixel." -#: sdk/folder/index.xml:24(dt) -msgid "Icon.png" -msgstr "Icon.png" - #: sdk/folder/index.xml:26(text) msgid "The icon of a scenario folder which is to be displayed instead of the book icon. 24x24 pixels, alpha channel is used for transparency." msgstr "Das Icon des Rundenordners, das statt des Buches angezeigt werden kann. 24x24 Pixel, es wird der png-Alphakanal für Transparenz genutzt." @@ -14582,10 +14579,6 @@ msgstr "FolderMap.txt" msgid "Scenario folders can also contain graphical folder maps for the selection of scenarios." msgstr "Rundenordner können Auswahlkarten für die enthaltenen Szenarien anbieten." -#: sdk/folder/index.xml:44(dt) -msgid "Loader*.png" -msgstr "Loader*.png" - #: sdk/folder/index.xml:46(text) msgid "Scenario folders can contain local loader screens. Also see scenarios. The overloading rules apply." msgstr "Rundenordner können lokale Ladebildschirme enthalten. Siehe auch Szenarien. Es gelten die Überladungsregeln." @@ -14594,18 +14587,10 @@ msgstr "Rundenordner können lokale Ladebildschirme enthalten. Siehe auch scenarios. The overloading rules apply." msgstr "Rundenordner können lokale Materialdefinitionen enthalten. Siehe auch Szenarien. Es gelten die Überladungsregeln." -#: sdk/folder/index.xml:52(dt) -msgid "Graphics.ocg" -msgstr "Graphics.ocg" - #: sdk/folder/index.xml:54(text) msgid "Scenario folders can overload individual entries of the global Graphics.ocg group. See overloading rules." msgstr "Rundenordner können einzelne Grafiken aus der systemglobalen Graphics.ocg überladen. Siehe auch Szenarien. Es gelten die Überladungsregeln." -#: sdk/folder/index.xml:56(dt) -msgid "Music.ocg" -msgstr "Music.ocg" - #: sdk/folder/index.xml:58(text) msgid "Scenario folders can contain local music files. Also see scenarios. The overloading rules apply." msgstr "Rundenordner können eigene Musik für alle Szenarien bereitstellen. Siehe auch Szenarien. Es gelten die Überladungsregeln." @@ -14801,8 +14786,8 @@ msgid "The game data of clonk is stored in compressed group files which each con msgstr "Die Spieldaten von Clonk sind in komprimierten Gruppendateien zusammen gefasst, die jeweils einzelne Komponenten oder weitere Gruppendateien enthalten:" #: sdk/files.xml:10(dt) -msgid " Player Files (ocp)" -msgstr " Spielerdateien (ocp)" +msgid "Player Files (ocp)" +msgstr "Spielerdateien (ocp)" #: sdk/files.xml:12(text) msgid "Player files contain personal settings, gained score and information about the crew. It may also contain a portrait file." @@ -14833,8 +14818,8 @@ msgid "Scenarios are grouped in scenario folders." msgstr "Szenarien können in Rundenordnern zusammen gefasst werden." #: sdk/files.xml:26(dt) -msgid " System Data (ocg)" -msgstr " Systemdaten (ocg)" +msgid "System Data (ocg)" +msgstr "Systemdaten (ocg)" #: sdk/files.xml:28(text) msgid "Graphics, sound, and music of the original game are grouped in these folders and should not be modified." @@ -15795,8 +15780,8 @@ msgid "Graphics of the object. Base graphics, animation phases and a picture for msgstr "Grafikelemente des Objekts. Basisgrafik, Animationsphasen sowie ein Bild zur Anzeige in Menüs werden in einer 32-Bit-Bilddatei mit Transparenz (Alpha-Kanal) abgelegt (Format PNG, Farbtiefe 32 Bit RGBA, nicht interlaced)." #: sdk/definition/index.xml:20(dt) -msgid " Overlay.png" -msgstr " Overlay.png" +msgid "Overlay.png" +msgstr "Overlay.png" #: sdk/definition/index.xml:22(text) msgid "The part of the object's graphics which is to be colored in the player color (see ColorByOwner in DefCore.txt) can also be defined using a separate graphics file. In this way you can also use the color blue in the object's graphics for effects other than player color and antialiasing of the player color sections becomes possible. In Overlay.png gray scales should be used instead of blue color." @@ -15811,16 +15796,16 @@ msgid "A 3D model can be used as an object's graphics instead of a bitmap in BMP msgstr "Es kann statt einer Grafik im BMP- oder PNG-Format auch ein 3D-Modell verwendet werden. Dieses muss im OGRE-Format vorliegen. Für die meisten 3D-Programme existieren entsprechende Exporter. Alle Dateien die von dem Mesh benötigt werden (insb. Materialskripte, Texturen und Skelette) müssen ebenfalls im Objekt vorhanden sein." #: sdk/definition/index.xml:28(dt) -msgid " *.skeleton" -msgstr " *.skeleton" +msgid "*.skeleton" +msgstr "*.skeleton" #: sdk/definition/index.xml:30(text) msgid "Skeleton files contain bones and animations for a 3D model. They are usually created by the exporter if bones and/or animations are used for the mesh." msgstr "Skeleton-Dateien enthalten Bones und Animationen für ein 3D-Modell. Sie werden in der Regel vom Exporter generiert wenn Bones und/oder Animationen verwendet werden." #: sdk/definition/index.xml:32(dt) -msgid " Graphics*.png/Overlay*.png" -msgstr " Graphics*.png/Overlay*.png" +msgid "Graphics*.png/Overlay*.png" +msgstr "Graphics*.png/Overlay*.png" #: sdk/definition/index.xml:34(text) msgid "Objects can also contain alternative sets of graphics which can be selected ingame using the script command SetGraphics(). The name corresponds to the file name portion following \"Graphics\". The matching overlay is automatically selected. For more information see SetGraphics()." @@ -15847,32 +15832,32 @@ msgid "Table for activities." msgstr "Tabelle für Objektaktivitäten." #: sdk/definition/index.xml:48(dt) -msgid " Rank.txt/Rank*.txt" -msgstr " Rank.txt/Rank*.txt" +msgid "Rank.txt/Rank*.txt" +msgstr "Rank.txt/Rank*.txt" #: sdk/definition/index.xml:50(text) msgid "For object definitions defining a clonk type you can specify custom rank names for this clonk type here. The rank names will then also replace rank names of existing crew members of this type. The file should contain a simple text list of names of maximum 30 characters each. For an example see the knight in the Knights pack. By using the approriate language codes you can create language dependent sets of rank names." msgstr "Für Objektdefinitionen, die einen Clonktyp definieren, können hier spezifische Rangnamen für diesen Clonktyp angegeben werden. Die Rangnamen werden dann auch innerhalb schon existierender Mannschaftsmitglieder auf die angegebenen geändert. Die Rangnamen sollten in einer einfachen Liste untereinander stehen, und maximal 30 Zeichen Länge besitzen. Für ein Beispiel siehe zum Beispiel den Ritter in Knights.ocd. Durch Einfügen des entsprechenden Sprachcodes ist es möglich, Rangnamen für verschiedene Sprachen zu definieren." #: sdk/definition/index.xml:52(dt) -msgid " Rank.png" -msgstr " Rank.png" +msgid "Rank.png" +msgstr "Rank.png" #: sdk/definition/index.xml:54(text) msgid "You can also define custom rank symbols for clonk types which are then displayed in the game instead of the standard symbols from Graphics.ocg. A rank symbol should always be square and there should be enough many symbols for all ranks. For ranks exceeding the last symbol, the list is repeated from the front and a star is added to the symbol." msgstr "Für Clonktypen können außerdem spezifische Rangsymbole definiert werden, die dann im Spiel anstelle der Standardsymbole benutzt werden. Ein Rangsymbol muss immer so breit wie hoch sein, und es sollten ausreichend Symbole für alle Ränge vorhanden sein. Bei höheren Rängen als der Anzahl vorhandener Rangsymbole wird von vorne begonnen und ein Stern daneben gezeichnet." #: sdk/definition/index.xml:56(dt) -msgid " *.wav/*.ogg" -msgstr " *.wav/*.ogg" +msgid "*.wav/*.ogg" +msgstr "*.wav/*.ogg" #: sdk/definition/index.xml:58(text) msgid "Object local sounds. As these are always loaded and not dynamically unloaded as are scenario sounds you should use these sparingly and with small sound files only." msgstr "Objektlokale Sounds. Da diese statisch geladen und nicht wie szenariolokale Sounds dynamisch entladen werden, sollten objektlokale Sounds möglichst klein sein." #: sdk/definition/index.xml:60(dt) -msgid " *.ocd" -msgstr " *.ocd" +msgid "*.ocd" +msgstr "*.ocd" #: sdk/definition/index.xml:62(text) msgid "The engine will also search all valid ocd subdirectories for additional object definitions. Object definitions should be grouped by category." @@ -17305,12 +17290,6 @@ msgstr "Dieses Kommandozeilen-Programm dient zum Bearbeiten von Gruppendateien. #~ msgid "Blowing clonk" #~ msgstr "Pusteclonk" -#~ msgid "Info.txt" -#~ msgstr "Info.txt" - -#~ msgid "Author.txt" -#~ msgstr "Author.txt" - #~ msgid "What to return (see remarks)." #~ msgstr "Was genau zurückgegeben werden soll (siehe Anmerkung)" diff --git a/docs/doku.css b/docs/doku.css index beeab70c0..29d8aac9b 100644 --- a/docs/doku.css +++ b/docs/doku.css @@ -12,7 +12,7 @@ body { } #iframe { - position: absolute; top: 145px; width: 270px; border: 0; bottom: 0; overflow: auto; + position: absolute; top: 145px; width: 300px; border: 0; bottom: 0; overflow: auto; height: auto; display: block; } @@ -47,7 +47,7 @@ div.fnsyntax { #content { padding: 0 1em; margin: 0 auto; - position: absolute; top: 145px; left: 270px; right: 0; bottom: 0; overflow: auto; + position: absolute; top: 145px; left: 300px; right: 0; bottom: 0; overflow: auto; } div.example { @@ -59,7 +59,7 @@ dd { margin: 0; } -.text img { +.text img, dt img { vertical-align: middle; margin-right: 6px; } @@ -95,12 +95,10 @@ h2 { h3, table caption, dt { text-align: left; font-weight: bold; - font-size:132%; + font-size:110%; margin: 0; - border-bottom:1px solid #eee; - margin-bottom:0.3em; - margin-top:1em; - padding:0.2em 0.1em 0.3em 0; + margin-top:1.5em; + padding:0; } table { diff --git a/docs/sdk/definition/index.xml b/docs/sdk/definition/index.xml index 488f14176..9a492451a 100644 --- a/docs/sdk/definition/index.xml +++ b/docs/sdk/definition/index.xml @@ -9,63 +9,63 @@ Object definitions are used for all game objects in clonk: fire monsters, the wooden hut, and the clonk himself. An object definition is a group file composed from the following components: Object Definition Components (ocd)
-
DefCore.txt
+
DefCore.txt
Object properties.
-
Graphics.png
+
Graphics.png
Graphics of the object. Base graphics, animation phases and a picture for display in menus are stored in a 32 bit picture with transparency channel (PNG format, 32 bit RGBA color, non interlaced).
-
Overlay.png
+
Overlay.png
The part of the object's graphics which is to be colored in the player color (see ColorByOwner in DefCore.txt) can also be defined using a separate graphics file. In this way you can also use the color blue in the object's graphics for effects other than player color and antialiasing of the player color sections becomes possible. In Overlay.png gray scales should be used instead of blue color.
-
Graphics.mesh
+
Graphics.mesh
A 3D model can be used as an object's graphics instead of a bitmap in BMP or PNG format. It needs to be provided in OGRE format. There are exporters for most 3D modeling tools. All files that are required by the mesh (especially material scripts, textures and skeletons) need also to be present in the object.
-
*.skeleton
+
*.skeleton
Skeleton files contain bones and animations for a 3D model. They are usually created by the exporter if bones and/or animations are used for the mesh.
-
Graphics*.png/Overlay*.png
+
Graphics*.png/Overlay*.png
Objects can also contain alternative sets of graphics which can be selected ingame using the script command SetGraphics(). The name corresponds to the file name portion following "Graphics". The matching overlay is automatically selected. For more information see SetGraphics().
-
*.material
+
*.material
OGRE material scripts are simple text files which contain information about the material of a 3D model. Each model is assigned a material which specifies how it is rendered. Normally these scripts are being generated by the exporter, but they can also be hand-edited afterwards (using a text editor) to apply additional effects.
-
Script.c
+
Script.c
The object script. See script documentation and localization.
-
ActMap in the Script.c
+
ActMap in the Script.c
Table for activities.
-
Rank.txt/Rank*.txt
+
Rank.txt/Rank*.txt
For object definitions defining a clonk type you can specify custom rank names for this clonk type here. The rank names will then also replace rank names of existing crew members of this type. The file should contain a simple text list of names of maximum 30 characters each. For an example see the knight in the Knights pack. By using the approriate language codes you can create language dependent sets of rank names.
-
Rank.png
+
Rank.png
You can also define custom rank symbols for clonk types which are then displayed in the game instead of the standard symbols from Graphics.ocg. A rank symbol should always be square and there should be enough many symbols for all ranks. For ranks exceeding the last symbol, the list is repeated from the front and a star is added to the symbol.
-
*.wav/*.ogg
+
*.wav/*.ogg
Object local sounds. As these are always loaded and not dynamically unloaded as are scenario sounds you should use these sparingly and with small sound files only.
-
*.ocd
+
*.ocd
The engine will also search all valid ocd subdirectories for additional object definitions. Object definitions should be grouped by category.
-
Info.txt
+
Info.txt
This component is not processed by the engine. Here the author can store additional information he wants to share with other developers.
-
Author.txt
+
Author.txt
Should contain the name of the author in format "Firstname Lastname (Nick)" and is used to maintain the name of the original author, if the group file is edited by another developer at a later point in time.
diff --git a/docs/sdk/files.xml b/docs/sdk/files.xml index 843a6ae73..f80dd242b 100644 --- a/docs/sdk/files.xml +++ b/docs/sdk/files.xml @@ -7,23 +7,23 @@ Game Data The game data of clonk is stored in compressed group files which each contain one component or further group files.
-
Player Files (ocp)
+
Player Files (ocp)
Player files contain personal settings, gained score and information about the crew. It may also contain a portrait file.
-
Scenarios (ocs)
+
Scenarios (ocs)
Scenario files consist of an information core and additional components, such as a landscape, title image, description texts, sky graphics, a script, local object definitions, etc.
-
Object Definitions (ocd)
+
Object Definitions (ocd)
Object definitions contain an information core, graphic elements, action tables, script, and descriptive text. Also, particles are stored in object definition folders.
-
Scenario Folders (ocf)
+
Scenario Folders (ocf)
Scenarios are grouped in scenario folders.
-
System Data (ocg)
+
System Data (ocg)
Graphics, sound, and music of the original game are grouped in these folders and should not be modified. Using the menu system, group files can be edited and/or converted to normal directories. Group file components can then be edited using common applications for text or graphics editing. Menu system and game engine can both load packed group files or unpacked directories directly. diff --git a/docs/sdk/folder/index.xml b/docs/sdk/folder/index.xml index 204a23e78..0698ee0e2 100644 --- a/docs/sdk/folder/index.xml +++ b/docs/sdk/folder/index.xml @@ -9,11 +9,11 @@ Scenario folders are used to group a number of scenarios. Scenario folders are displayed with a book icon in the startup screen which can then be opened to list contained scenarios. Scenario Components (ocs)
-
*.ocs
+
*.ocs
Scenario folders can contain any number of scenarios.
-
*.ocf
+
*.ocf
Scenario folders can also contain other scenario folders.
@@ -25,19 +25,19 @@
The icon of a scenario folder which is to be displayed instead of the book icon. 24x24 pixels, alpha channel is used for transparency.
-
Desc*.rtf
+
Desc*.rtf
The description text of the scenario in rich text format (rtf). '__' is to be replaced by the two digit language code, e.g. DE for German and US for American English. Multiple descriptions for several languages can be contained in a scenario file of which the game will automatically load the one appropriate for the configured language. The font of the description text is set internally on display. The character size in the file should be 10pt for headings and 8pt for text. Images or other rtf tags are ignored. It is recommended to edit this file using a small scale rtf editor such as WordPad.exe in Windows and not a full-blown word processor such as Word as these will stuff kilobytes of unneeded extra information into the rtf file.
-
Title.txt
+
Title.txt
By default, the title of a scenario is set when renaming the scenario in the menu system and stored in section [Head] of Scenario.txt. The file name of the scenario group file may differ. For language dependent titles you should create a Title.txt component with the appropriate contents: DE:Meine Rundensammlung US:My scenario collection Important: No quotation marks and special characters should be used.
-
FolderMap.txt
+
FolderMap.txt
Scenario folders can also contain graphical folder maps for the selection of scenarios.
@@ -45,7 +45,7 @@ US:My scenario collection Important: No quotation marks and
Scenario folders can contain local loader screens. Also see scenarios. The overloading rules apply.
-
Material.ocg
+
Material.ocg
Scenario folders can contain local material definitions. Also see scenarios. The overloading rules apply.
@@ -57,15 +57,15 @@ US:My scenario collection Important: No quotation marks and
Scenario folders can contain local music files. Also see scenarios. The overloading rules apply.
-
*.ocd
+
*.ocd
Scenario folders can contain object definitions, which will then be available in all scenarios contained in the folder.Also see scenarios. The overloading rules apply.
-
Info.txt
+
Info.txt
Here an author can store additional information about the development of his scenario, his email address, or other information he wants to share with other developers.
-
Author.txt
+
Author.txt
Should contain the name of the author in format "Firstname Lastname (Nick)" and is used to maintain the name of the original author, if the scenario group file is edited by another developer at a later point in time.
diff --git a/docs/sdk/material/index.xml b/docs/sdk/material/index.xml index 97729daf7..022daa04f 100644 --- a/docs/sdk/material/index.xml +++ b/docs/sdk/material/index.xml @@ -9,17 +9,17 @@ Using material definitions you can specify looks and behaviour of the landscape materials. Material Definition Components (Material.ocg)
-
TexMap.txt
+
TexMap.txt
Lookup table for color indices in static and dynamic landscapes. Colors 0-127 are matched to a material-texture-reference. Colors 128-255 are matched to the same list of references only these are marked 'underground'. The engine will draw materials with a higher index above those with a lower index so that, e.g. using the standard table, rough chunks of earth will overlap water which has a smooth border. Mineral resources have an even higher index so that their rough border overlaps the earth and not the other way around. This is also the reason why there might be differing numbers of total pixels of a given material drawn than you might expect just from calculating the square sizes of the unzoomed map materials. If a custom map fails with the message 'texture n undefined' you should define the specified texture in the TexMap. You should always use a paint program capable of editing indexed color palettes without modifying the palette (MS Paint is not suited for this).
-
*.ocm
+
*.ocm
The engine will accept up to 125 material definitions at a time. OCM files a simple text files. The materials Vehicle, Tunnel, Water, Snow, Granite, Sand, and Earth must always be available.
-
*.png
+
*.png
There can be any number of textures in any material group. Width and height of each bitmap must be powers of 2 (that is 16, 32, 64, 128, 256, etc.).
diff --git a/docs/sdk/particle/index.xml b/docs/sdk/particle/index.xml index 53610f804..87bc2b804 100644 --- a/docs/sdk/particle/index.xml +++ b/docs/sdk/particle/index.xml @@ -11,11 +11,11 @@ Particles are not stored in savegames and are designed for temporary visual effects only. Particle Components (ocd)
-
Particle.txt
+
Particle.txt
Particle properties.
-
Graphics.png
+
Graphics.png
Particle graphics. The particle definition can also contain the known components of object definitions for describing the particle (e.g. Title.png, DescDE/US.txt, etc.) diff --git a/docs/sdk/scenario/index.xml b/docs/sdk/scenario/index.xml index da4871fe5..15f72f919 100644 --- a/docs/sdk/scenario/index.xml +++ b/docs/sdk/scenario/index.xml @@ -9,101 +9,101 @@ Scenarios are the playing worlds which the player can select and start from the menu. With their components the scenario designer can adjust freely everything from the landscape, the goals and rules, the available objects and materials to the look in the menu. Scenario Components (ocs)
-
Scenario.txt
+
Scenario.txt
Contains most scenario settings.
-
Teams.txt
+
Teams.txt
Contains the Teamsettings for multiplayer scenarios.
-
Title.png
+
Title.png
The title picture of the scenario in png format. Size: 200x150 pixel.
-
Icon.png
+
Icon.png
The icon of the scenario in png format. Size: 24x24 pixel.
-
Loader*.png
+
Loader*.png
Loader screen to be displayed while the scenario is loading. If multiple files are present (Loader1.png, Loader2.png, Loader3.png...), one is selected randomly. You can optionally specify which loader to use in Scenario.txt. Loader image files located in parent scenario folders are also used.
-
Sky.png
+
Sky.png
The sky background image. Sky graphics should either be tileable or big enough that it won't even tile if the player zooms out very far.
-
Desc*.rtf
+
Desc*.rtf
The description text of the scenario in rich text format (rtf). '__' is to be replaced by the two digit language code, e.g. DE for German and US for American English. Multiple descriptions for several languages can be contained in a scenario file of which the game will automatically load the one appropriate for the configured language. The font of the description text is set internally on display. The character size in the file should be 10pt for headings and 8pt for text. Images or other rtf tags are ignored. It is recommended to edit this file using a small scale rtf editor such as WordPad.exe in Windows and not a full-blown word processor such as Word as these will stuff kilobytes of unneeded extra information into the rtf file.
-
Title.txt
+
Title.txt
By default, the title of a scenario is set when renaming the scenario in the menu system and stored in section [Head] of Scenario.txt. The file name of the scenario group file may differ. For language dependent titles you should create a Title.txt component with the appropriate contents: DE:Angriff der Killerwipfe US:Attack of the Killer Wipfs Important: No quotation marks and special characters should be used.
-
Script.c
+
Script.c
The scenario script.
-
Map.bmp
+
Map.bmp
Static landscapes are stretched by factor MapZoom defined in Scenario.txt to the size of the actual landscape in the game. The colors used in Map.bmp correspond to materials and textures as defined in TexMap.txt. Exact landscapes represent the actual in-game landscape saved to a bitmap file. The bitmap color indices (128-191 and 192-255, 3 colors per material) correspond directly to the material pixels used in the scenario. The current material list is stored in MatMap.txt.
-
Landscape.png
+
Landscape.png
Full size map for exact landscapes. This is mainly used in savegames to store the exact terrain including transparent materials and their texture. Exact landscapes consume an extreme amount of memory and should not be used for regularly distributed scenarios.
-
Landscape.txt
+
Landscape.txt
Advanced scenario designers can use this component to define highly complex, fully random generated dynamic landscapes. This does require certain mathematical skill and some patience, however.
-
MatMap.txt
+
MatMap.txt
Stores the material table used in this scenario. The materials listed here are used by the exact landscape and have to be available in the loaded Material.ocg group.
-
Objects.txt
+
Objects.txt
This component is generated by the engine and stores runtime object data of a savegame.
-
Material.ocg
+
Material.ocg
Scenarios can contain local material definition groups. See overloading rules.
-
Graphics.ocg
+
Graphics.ocg
Scenarios can overload individual entries of the global Graphics.ocg group. See overloading rules.
-
*.wav
+
*.wav
Scenarios can contain any number of sound files. These can be played back by script during the game. Scenario local sounds are loaded dynamically on demand which might cause delays with large scenario files.
-
*.mid/*.ogg
+
*.mid/*.ogg
If the scenario contains music files, these can be played back during the game in random order. Also see script command Music().
-
Music.ocg
+
Music.ocg
Local music files can also be combines in a local music group.
-
*.ocd
+
*.ocd
Scenarios can contain local object definitions which are then available in that scenario only. The engine will also search all parent folders (ocf) of the scenario for additional local object definitions. In this way, a scenario folder can contain object definitions which are then available in all its contents scenarios.
-
Names.txt
+
Names.txt
These names are used for clonks created in this scenario.
-
Info.txt
+
Info.txt
Here an author can store additional information about the development of his scenario, his email address, or other information he wants to share with other developers.
-
Author.txt
+
Author.txt
Should contain the name of the author in format "Firstname Lastname (Nick)" and is used to maintain the name of the original author, if the scenario group file is edited by another developer at a later point in time.