Chunk Serializer - Versionsgeschichte

Manuel: Fehlerhafte Assembly-Zuordnung entfernt

2018-05-11T14:05:32Z

Fehlerhafte Assembly-Zuordnung entfernt

Manuel: Aktuelles Dateiformat, Hinweis auf Überarbeitung entfernt

2018-05-11T14:02:43Z

Aktuelles Dateiformat, Hinweis auf Überarbeitung entfernt

Manuel: Link korrigiert

2016-03-01T17:28:27Z

Link korrigiert

Manuel am 21. Februar 2016 um 09:10 Uhr

2016-02-21T09:10:48Z

Manuel am 27. Januar 2016 um 12:39 Uhr

2016-01-27T12:39:25Z

Manuel am 14. Januar 2016 um 20:23 Uhr

2016-01-14T20:23:07Z

Marcus Aurelius: Aus Technischer Dokumentation Herverschoben. Artikel ist ausbaufähig

2016-01-03T16:08:16Z

Aus Technischer Dokumentation Herverschoben. Artikel ist ausbaufähig

Neue Seite

[[Kategorie:Seitenindex]][[Kategorie:OctoAwesome.Runtime]]
{{Überarbeiten}} [[Kategorie:Überarbeiten]]
'''Der Chunk-Serializer''' schreibt die daten binär mit Hilfe des BinaryWriters in die .chunk-Datei.

= Schreibreihenfolge =
Folgende Informationen werden in dieser Reihenfolge geschrieben:

{| class="wikitable"
| '''Information'''
| '''Datentyp'''
| '''Häufigkeit'''
| '''Beschreibung/Anmerkungen'''
|-
| Typ der Typanzahl
| byte
| Einmal
| Gibt an, ob die Anzahl der Blocktypen als byte (0) oder ushort (1) geschrieben werden.
|-
| Anzahl der Blocktypen
| byte/ushort
| Einmal
| Gibt an, wie viele unterschiedliche Blocktypen in diesem Chunk verwendet werden. Bei weniger als 255 Typen als byte.
|-
| Voller Name der Blocktypen
| string
| pro Blocktyp
| z.B. OctoAwesome.Basics.GrassBlockDefinition
|-
| Typindex des Blocks
| byte/ushort
| pro Block
| Bei weniger als 255 Typen als byte. Typ 0 ist Luft.
|-
| Metadaten
| int
| pro Block
| Nur wenn Blocktyp Metadaten speichert (BlockDefinition.HasMetadata)
|}

[https://github.com/tomwendel/octoawesome/blob/master/OctoAwesome/OctoAwesome.Runtime/ChunkSerializer.cs Zur Implementierung (GitHub)]

← Nächstältere Version		Version vom 11. Mai 2018, 14:05 Uhr
Zeile 1:		Zeile 1:
−	[[Kategorie:Seitenindex~~]][[Kategorie:OctoAwesome.Runtime~~]][[Kategorie:Dokumentation]]	+	[[Kategorie:Seitenindex]][[Kategorie:Dokumentation]]
	Zur Serialisierung einer ganzen Chunk-Column wird ein eigenes, selbst entwickeltes und speziell auf unsere Anforderungen optimiertes Dateiformat verwendet. '''Der Chunk-Serializer''' schreibt die Daten binär mit Hilfe des BinaryWriters in einen Stream; beim lokalen Spiel landen diese als .dat-Datei im Planetenordner. Es wird immer ein 1x1 Chunks großer Teil der Welt in der gesamten Höhe in eine Datei gespeichert. Der Speicherverbrauch einer unkomprimierten ChunkCOlumn beträgt ca. 250KB; mit GZip komprimiert (bei lokalen Psielen und Netzwerk-Spielen der Fall) ca. 1 bis 3 KB.		Zur Serialisierung einer ganzen Chunk-Column wird ein eigenes, selbst entwickeltes und speziell auf unsere Anforderungen optimiertes Dateiformat verwendet. '''Der Chunk-Serializer''' schreibt die Daten binär mit Hilfe des BinaryWriters in einen Stream; beim lokalen Spiel landen diese als .dat-Datei im Planetenordner. Es wird immer ein 1x1 Chunks großer Teil der Welt in der gesamten Höhe in eine Datei gespeichert. Der Speicherverbrauch einer unkomprimierten ChunkCOlumn beträgt ca. 250KB; mit GZip komprimiert (bei lokalen Psielen und Netzwerk-Spielen der Fall) ca. 1 bis 3 KB.

@@ Zeile 1: / Zeile 1: @@
 [[Kategorie:Seitenindex]][[Kategorie:OctoAwesome.Runtime]][[Kategorie:Dokumentation]]
-{{Überarbeiten}}
+Zur Serialisierung einer ganzen Chunk-Column wird ein eigenes, selbst entwickeltes und speziell auf unsere Anforderungen optimiertes Dateiformat verwendet. '''Der Chunk-Serializer''' schreibt die Daten binär mit Hilfe des BinaryWriters in einen Stream; beim lokalen Spiel landen diese als .dat-Datei im Planetenordner. Es wird immer ein 1x1 Chunks großer Teil der Welt in der gesamten Höhe in eine Datei gespeichert. Der Speicherverbrauch einer unkomprimierten ChunkCOlumn beträgt ca. 250KB; mit GZip komprimiert (bei lokalen Psielen und Netzwerk-Spielen der Fall) ca. 1 bis 3 KB.
-== Header ==
+== Header (Phase 0) ==
-Im Header wird dem Programm mitgeteilt, welche Blocktypen auf dem Chunk verwendet werden. Zuerst wird ein Flag als byte geschrieben, was angibt ob mehr (1) oder weniger (0) als 255 Blocktypen verwendet werden. Heute immer 0 (mangels Angebot an Plugins). Danach wird die eigentliche Anzahl der Blocktypen entweder als byte (<255 Blocktypen) oder als ushort (>255 Blocktypen) geschrieben. Anschließend werden die Namen der Blocktypen als string geschrieben (z.B. OctoAwesome.Basics.GrassBlockDefinition).
+Im Header wird ein Flag als byte geschrieben, das angibt ob mehr (1) oder weniger (0) als 255 Blocktypen in der Column verwendet werden. Zur Zeit ist dieses immer 0 (mangels Angebot an Plugins).
-== Daten ==
+== Metadaten (Phase 1) ==
-Jetzt werden die eigentlichen Daten der Blöcke als lineares Array geschrieben: Zuerst der Index der BlockDefinition (Typumstellung genauso bei 255 Blocktypen, siehe oben). Blocktyp 0 ist ein leerer Luftblock. Dann folgt ein int mit beliebigen Metadaten, falls der Blocktyp dies mit BlockDefinition.HasMetadata anfordert.
+Nach dem Header werden Metadaten in den Stream geschrieben. Zuerst ein byte das die Anzahl der Chunks in der Column (also die Höhe) angbit. Anschließend ein boolescher Wert, der angibt, ob der Chunk bereits durch ChunkPopulatoren mit Bäuemen etc. versehen wurde.
 == Links ==
-* [https://github.com/tomwendel/octoawesome/blob/master/OctoAwesome/OctoAwesome.Runtime/ChunkSerializer.cs Die Implementierung auf GitHub]
+* [https://github.com/OctoAwesome/octoawesome/blob/develop/OctoAwesome/OctoAwesome/ChunkColumn.cs#L227 Die Implementierung auf GitHub]
-* [http://doc.octoawesome.net/develop/html/T_OctoAwesome_Runtime_ChunkSerializer.htm Dokumentation]
+* [http://doc.octoawesome.net/api/develop/OctoAwesome.ChunkColumn.html Dokumentation]

@@ Zeile 11: / Zeile 11: @@
 == Links ==
 * [https://github.com/tomwendel/octoawesome/blob/master/OctoAwesome/OctoAwesome.Runtime/ChunkSerializer.cs Die Implementierung auf GitHub]
-* [http://doc.octoawesome.net/html/T_OctoAwesome_Runtime_ChunkSerializer.htm Dokumentation]
+* [http://doc.octoawesome.net/develop/html/T_OctoAwesome_Runtime_ChunkSerializer.htm Dokumentation]
 [[Kategorie:Überarbeiten]]

@@ Zeile 1: / Zeile 1: @@
 [[Kategorie:Seitenindex]][[Kategorie:OctoAwesome.Runtime]][[Kategorie:Dokumentation]]
 Zur Chunk-Serialisierung wird ein eigenes, selbst entwickeltes und speziell auf unsere Anforderungen optimiertes Dateiformat verwendet. '''Der Chunk-Serializer''' schreibt die daten binär mit Hilfe des BinaryWriters in die .chunk-Datei. Wie der Name schon sagt, wird jeweils nur ein Chunk auf einmal serialisiert. Der Speicherverbrauch einer Chunkdatei beträgt ~33KB.
@@ Zeile 11: / Zeile 12: @@
 * [https://github.com/tomwendel/octoawesome/blob/master/OctoAwesome/OctoAwesome.Runtime/ChunkSerializer.cs Die Implementierung auf GitHub]
 * [http://doc.octoawesome.net/html/T_OctoAwesome_Runtime_ChunkSerializer.htm Dokumentation]

← Nächstältere Version		Version vom 27. Januar 2016, 12:39 Uhr
Zeile 9:		Zeile 9:

	== Links ==		== Links ==
−	[https://github.com/tomwendel/octoawesome/blob/master/OctoAwesome/OctoAwesome.Runtime/ChunkSerializer.cs Die Implementierung auf GitHub]	+	* [https://github.com/tomwendel/octoawesome/blob/master/OctoAwesome/OctoAwesome.Runtime/ChunkSerializer.cs Die Implementierung auf GitHub]
		+	* [http://doc.octoawesome.net/html/T_OctoAwesome_Runtime_ChunkSerializer.htm Dokumentation]