Differences

This shows you the differences between two versions of the page.

--- deftypes [2019/03/12 14:46] – [G3D File Format] admin
+++ deftypes [2020/01/09 14:21] – [Notice] admin
@@ Line 136: / Line 136: @@
 ^ Format  ^ Notes  ^
-| BSON      | binary json format |
+| BSON      | binary json format: https://en.wikipedia.org/wiki/BSON [wikipedia] |
-| JSON       | default json format |
+| JSON       | default json format: https://en.wikipedia.org/wiki/JSON [wikipedia] |
+In addition to those formats we provide different storage options:
+^ Option ^ Notes ^
+| None     | The save routine simply stores data plain as BSON or JSON |
+| Zipped  | Store as zipped data stream. You can extend this option by the FastestCompression or MaxCompression option. If none of them is set, the exporter will use default compression. |
+| Beautified | Compatible with JSON format. Defines data will be exported with linebreaks and indents or not. This option has no influence on bson format. |
+| FastestCompression | If the Zipped-Option is set, this option will choose the fastest algorithm for packing the data stream. |
+| MaxCompression | If the Zipped-Option is set, this option will chose the maximum compression algorithm for packing the data stream. |
+Depending on your model data you can configure those options to optimize filesize.
+In most cases a zipped JSON format with MaxCompression provides the best results.
+<code>
+G3D_TEST : TGorillaG3DOptions = [TGorillaG3DOption.Zipped, TGorillaG3DOption.MaxCompression];
+</code>
+===== Notice =====
+Every G3D file starts with some header information, where is defined which format and options are used.
+The header format is described below:
+<file pascal>
+  TGorillaG3DFormat = (BSONFormat, JSONFormat);
+  TGorillaG3DOption  = (
+    None,
+    Zipped,
+    Beautified,
+    FastestCompression,
+    MaxCompression);
+  TGorillaG3DOptions = Set Of TGorillaG3DOption;
+  TGorillaG3DHeader = record
+    /// DEFAULT-VALUE = "Gorilla3D "
+    /// 10 characters identify the exporter tool
+    Exporter : Array[0..9] of Byte;
+    Version : Cardinal;
+    /// Datetime when the file was generated. (8 byte float value)
+    Timestamp : TDateTime;
+    /// The data format the was stored (bson or json).
+    Format  : TGorillaG3DFormat;
+    /// enum with values above
+    Options : TGorillaG3DOptions;
+  end;
+</file>
+Next step: [[transparency|Transparency]]