https://www.ccc-mannheim.de/mediawiki/index.php?action=history&feed=atom&title=FullCircle%2FDatenformat 2026-04-17T23:56:31Z Versionsgeschichte dieser Seite in C3MAWiki MediaWiki 1.45.3 https://www.ccc-mannheim.de/mediawiki/index.php?title=FullCircle/Datenformat&diff=179&oldid=prev 2012-10-03T10:52:39Z

<p>Dome verschob Seite <a href="/wiki/Datenformat" class="mw-redirect" title="Datenformat">Datenformat</a> nach <a href="/wiki/FullCircle/Datenformat" title="FullCircle/Datenformat">FullCircle/Datenformat</a></p> <p><b>Neue Seite</b></p><div>[[Kategorie:FullCircle]]<br /> {{aktives Projekt|Kontakt=Gonium|öffentlich=ja}}<br /> <br /> Das Datenformat sollte eine Abfolge von Frames sowie einige Metadaten beinhalten. Es sollte zudem plattform- und programmiersprachenunabhängig sein. Die &#039;libfullcircle&#039; definiert das Datenformat. Als Serialisierung wird [http://code.google.com/p/protobuf/ Protocol Buffers] zum Einsatz kommen - das hebt dafür locker und ist recht einfach zu benutzen. Die Frameabfolge (Sequence) soll in einer einzigen Datei gespeichert werden, damit man flexibel damit arbyten kann.<br /> <br /> ===Brainstorming===<br /> * Metadaten pro Datei<br /> ** Framerate zum Abspielen (Frames/s)<br /> ** Dimensionen der Frames (X/Y)<br /> ** Generator (Name des generierenden Plugins inklusive Versionsnummer) -&gt; Debugging!<br /> <br /> * Abfolge von Frames: Sequence<br /> ** FrameID<br /> ** Matrix von Farbwerten<br /> ** Ein Farbwert wird als RGB gespeichert, je 8 Bit pro Kanal<br /> <br /> Ein Frame mit 16:9 Pixeln kommt also auf 16*9*3 = 432 Byte. Mit 10 Frames pro Sekunde macht das 4320 Bytes pro Sekunde, bei 2 Minuten Visualisierungen also 120*4320=507 KB. Das erscheint handhabbar, wenn man ein recht kompaktes Format wählt. Das generiert Protocol Buffers aber automatisch ziemlich effizient.<br /> <br /> Ein Frame fängt oben links mit dem Pixel (0,0) an und hört unten rechts mit dem Pixel (x_dim, y_dim) auf.<br /> <br /> <br /> === Definition des Datenformats ===<br /> <br /> Das Datenformat ist in /libfullcircle/sequence.proto definiert. Die Datei im Git hat Recht(TM), hier nur eine Kopie des Zwischenstands (V0.1.0) zur Veranschaulichung:<br /> <br /> package fullcircle;<br /> message BinarySequenceMetadata {<br /> required uint32 frames_per_second = 1;<br /> required uint32 x_dim = 2;<br /> required uint32 y_dim = 3;<br /> required string generator_name = 4;<br /> required string generator_version = 5;<br /> }<br /> message RGB_Value {<br /> required uint32 red = 1;<br /> required uint32 green = 2;<br /> required uint32 blue = 3;<br /> required uint32 x = 4;<br /> required uint32 y = 5;<br /> }<br /> message BinaryFrame {<br /> repeated RGB_Value pixel = 1;<br /> }<br /> message BinarySequence {<br /> required BinarySequenceMetadata metadata = 1;<br /> repeated BinaryFrame frame = 2;<br /> }<br /> <br /> Das ist eine Protobuf-Definition - die Bibliothek macht daraus Bindings zu C++, Java und Python. Weitere Bibliotheken für Ruby etc. können das auch. Alle Implementationen komprimieren die Daten und speichern Typinformationen mit ab - eine korrupte Datei wird so sofort erkannt.<br /> <br /> === Known Bugs ===<br /> <br /> keine.</div>

Dome