[Docs] Updated docs to V1.2.2

Author: ChristopherRemde

Geometry_Sequence_Player_Package

@@ -13,6 +13,18 @@ weight: 420
 toc: true
 ---
 
+### Version 1.2.2
+
+This version contains several new features, contributed by [Anwar Lu](https://github.com/MrGcGamer):
+
+- **Converter Tool MacOS support:** The converter tool now supports MacOS as well (texture compression is not yet supported)
+- **Sequence Compression:** Sequences can now be compressed to around half their size!
+
+Fixes:
+
+- [Issue #9](https://github.com/BuildingVolumes/Unity_Geometry_Sequence_Player/issues/11)
+- Several small bug fixes and additions
+
 ### Version 1.2.1
 
 This version contains a small improvement for the rendering bounds of Sequences. The bounds were not correctly calculated in previous version, leading to the sequence not being correctly culled from the camera view.

docs/content/docs/about/changelog.md

@@ -27,10 +27,14 @@ The Unity Asset Store version of the package is licensed under the [Unity Standa
 
 ## Credits
 
-- This website was created with the **[Doks](https://getdoks.org/)** theme made by **[Thulite](https://thulite.io/)**
+- The compression feature and MacOS support for the converter were made by [Anwar Lu](https://www.linkedin.com/in/anwar-lu/) - Thanks!
 
 - The sequences in the showreel, from the landing page and on Github, were created by:
 
   - ["A Windy Day2 by Loic Norgeot](https://sketchfab.com/3d-models/a-windy-day-fb78f4cc938144e6902dd5cff354d525)
 
   - ["Galactic Incident2 by Loic Norgeot](https://sketchfab.com/3d-models/galactic-incident-397b266af9604b9fbf0a4e5446cf864b)
+
+- This website was created with the **[Doks](https://getdoks.org/)** theme made by **[Thulite](https://thulite.io/)**
+
+- The converter tool is made possible by [PyMeshLab](https://github.com/cnr-isti-vclab/PyMeshLab), [DearPyGUI](https://github.com/hoffstadt/DearPyGui), [ASTCEncoder](https://github.com/ARM-software/astc-encoder) and [TexConv](https://github.com/microsoft/DirectXTex/wiki/texconv)

docs/content/docs/about/license-credits.md

@@ -37,6 +37,11 @@ Go to the **Geometry Sequence Stream** component that can be found on the same G
 
 If you have a mesh sequence with textures, you can also control to which texture slot the texture will be applied. By default, textures will always be applied to the Main/Albedo/Diffuse slot, which is defined in the shader as _\_MainTexture_. But you can also apply the texture to any other slot. Either you select one or more predefined slots in the **Apply to texture slots** variable, or you enter the name of the texture slot into the **Custom texture slots** list. This has to be the name of the texture slot as found in the **shader**, not the material! Shader texture slot variables are often prefixed with an _Underscore.
 
+### Mesh normals
+
+By default, mesh normals won't be saved in the sequence, as it increases the sequence size and is not necessary in most cases. Unity will generate
+new normals during playback. However, if you need precise normals (for example for hard-surface meshes), you can also keep the original normals, by activating the "Save Normals" option in the sequence converter before converting your sequence.
+
 ## Pointcloud sequences
 
 Changing the appearance of the pointcloud works very differently compared to meshes, as pointclouds require special shaders for rendering correctly. If you don't assign a custom pointcloud material, there are some predefined settings you can use to easily and quickly the appearance. These settings can be found under the **Geometry Sequence Stream** component and include the **Point Size** as well as the **Point Emission Strength**.
@@ -74,3 +79,11 @@ If you don't set a custom material, a default pointcloud material will be loaded
 `Packages > Geometry Sequence Player > Runtime > Shader > Resources`
 
 You'll see three different sets of shaders, _Legacy_, _Shadergraph_ and _Polyspatial_. Clone one of the shaders appropriate for your chosen render path. Then, create a material that uses your freshly cloned shader and apply it under **Custom Material**. For quick iteration, we recommend to disable the **Instantiate Shader** option. If you're a little bit familiar with Shaderlab/Shadergraph, you should be able to get an idea of how the shaders work, by taking a look at the commented code/graph.
+
+### Pointcloud normals
+
+![Pointcloud normals example](pointcloud_normals.jpg)
+
+In comparison to meshes, pointcloud sequences usually don't contain any normals. If you want your pointcloud sequence to receive lighting and shadows inside Unity, you need to generate normals. The sequence converter comes with a build-in functionality to estimate pointcloud normals and save them in the sequence.
+
+[More info](/Unity_Geometry_Sequence_Player/docs/tutorials/preparing-your-sequences/#using-the-converter/)

docs/content/docs/tutorials/materials/index.md

@@ -81,11 +81,13 @@ And for images:
 3. The converter provides some settings which can be used to modify the sequence:
 ![Converter Select Input](Converter_Options.png)
 
+- **Use compression:** Sequences are compressed to around half their size. Works for meshes and pointclouds
 - **Save normals:** When enabled, the normals of the mesh or pointcloud sequence are exported. Only recommended to enable if you have custom normals
 - **Pointcloud Settings:** Only affects pointclouds
   - **Decimate Pointcloud:** You can downsize your pointcloud sequence with this option. The value determines the percentage of points left after conversion. E.g. setting the value to 30% will decrease the points of the sequence by 70%.
   - **Merge Points by Distance:** Merges points that are close together. The higher the value, the more points will be merged. Useful if the data contains duplicated points
   - **Estimate Normals:** Pointclouds usually don't come with normals. When this option is enabled, the normals will be reasonably estimated.
+    - **Invert Normals:** This settings is only visible when *Estimate Normals* is enabled. Use if the generated normals are not facing the correct direction.
 - **Texture Settings** Only affects mesh sequences with textures
   - **Generate textures for desktop devices (DDS):** This converts the textures into a format for desktop GPUs. Recommended to leave on, even when you only build for mobile devices, otherwise textures won't show up in the Unity editor.
   - **Generate textures for mobile devices (ASTC):** If you plan to distribute your application on mobile devices (Android, IPhone, Meta Quest, Apple Vision Pro) and use textured meshes, you need to also generate .astc textures. You only need to transfer the .astc textures to your device, but not the .dds textures.
@@ -177,6 +179,7 @@ The sequence.json file contains information about your sequence in the following
 //three frames
 
 {
+  "sequenceVersion": "1.2.2", //Should be the same as the package version
   "geometryType": 2, //0 = Pointcloud, 1 = Mesh, 2 = Textured Mesh
   "textureMode": 2, //0 = No Textures, 1 = One texture, 2 = Per Frame textures
   "DDS": true, //Does this sequence have .dds textures?
@@ -185,7 +188,8 @@ The sequence.json file contains information about your sequence in the following
   "hasNormals": false, //Are per-vertex normals used?
   "maxVertexCount": 26545, //The vertice count of the mesh/pointcloud with the highest vertice count in the whole sequence
   "maxIndiceCount": 55423, //The indice count of the mesh/pointcloud with the highest indice count in the whole sequence
-  "maxBounds": [325.8575134277344, 295.0, 2103.5478515625, -18.240554809570312, -238.74757385253906, 0], //Bounds of the mesh in the format: MaxboundX, MaxboundY, MaxboundZ, MinboundX, MinboundY, MinboundZ
+  "boundsCenter": {"x": -0.010323499999999985, "y": -0.043528500000000026, "z": 0.007380500000000012}, 
+  "boundsSize": {"x": 1.472131, "y": 1.386613, "z": 1.468193}, //The meshes/pointclouds center and bounds in world coordinates
   "textureWidth": 512, //The width of the texture(s)
   "textureHeight": 512, //The hight of the texture(s)
   "textureSizeDDS": 2097152, //The size of a single .dds texture in bytes