From 64dca21f2800d38612e00c8dd39badc84d4b38ef Mon Sep 17 00:00:00 2001
From: Daumantas Kavolis <12998363+dkavolis@users.noreply.github.com>
Date: Fri, 21 Feb 2020 13:03:13 +0000
Subject: [PATCH] simplify voxel mesh by using a single mesh and customizable
voxel builders
---
.../FARPartGeometry/DebugVisualVoxel.cs | 125 ----------
.../DebugVisualVoxelMeshController.cs | 154 ------------
.../DebugVisualVoxelSubmesh.cs | 127 ----------
.../FARPartGeometry/DebugVoxel.cs | 109 +++++++++
.../FARPartGeometry/DebugVoxelMesh.cs | 227 ++++++++++++++++++
.../FARPartGeometry/IDebugVoxelMeshBuilder.cs | 46 ++++
.../FARPartGeometry/VehicleVoxel.cs | 37 +--
.../FARPartGeometry/VoxelChunk.cs | 26 +-
.../FARSettingsScenarioModule.cs | 21 +-
.../FerramAerospaceResearch.csproj | 6 +-
.../Plugins/FerramAerospaceResearch.dll | Bin 352256 -> 354304 bytes
.../Plugins/ferramGraph.dll | Bin 16384 -> 16384 bytes
README.md | 1 +
bin/Debug/FerramAerospaceResearch.dll | Bin 383488 -> 385536 bytes
bin/Debug/ferramGraph.dll | Bin 17408 -> 17408 bytes
15 files changed, 433 insertions(+), 446 deletions(-)
delete mode 100644 FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxel.cs
delete mode 100644 FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxelMeshController.cs
delete mode 100644 FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxelSubmesh.cs
create mode 100644 FerramAerospaceResearch/FARPartGeometry/DebugVoxel.cs
create mode 100644 FerramAerospaceResearch/FARPartGeometry/DebugVoxelMesh.cs
create mode 100644 FerramAerospaceResearch/FARPartGeometry/IDebugVoxelMeshBuilder.cs
diff --git a/FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxel.cs b/FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxel.cs
deleted file mode 100644
index 2ecb834a2..000000000
--- a/FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxel.cs
+++ /dev/null
@@ -1,125 +0,0 @@
-/*
-Ferram Aerospace Research v0.15.11.4 "Mach"
-=========================
-Aerodynamics model for Kerbal Space Program
-
-Copyright 2019, Michael Ferrara, aka Ferram4
-
- This file is part of Ferram Aerospace Research.
-
- Ferram Aerospace Research is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
-
- Ferram Aerospace Research is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with Ferram Aerospace Research. If not, see .
-
- Serious thanks: a.g., for tons of bugfixes and code-refactorings
- stupid_chris, for the RealChuteLite implementation
- Taverius, for correcting a ton of incorrect values
- Tetryds, for finding lots of bugs and issues and not letting me get away with them, and work on example crafts
- sarbian, for refactoring code for working with MechJeb, and the Module Manager updates
- ialdabaoth (who is awesome), who originally created Module Manager
- Regex, for adding RPM support
- DaMichel, for some ferramGraph updates and some control surface-related features
- Duxwing, for copy editing the readme
-
- CompatibilityChecker by Majiir, BSD 2-clause http://opensource.org/licenses/BSD-2-Clause
-
- Part.cfg changes powered by sarbian & ialdabaoth's ModuleManager plugin; used with permission
- http://forum.kerbalspaceprogram.com/threads/55219
-
- ModularFLightIntegrator by Sarbian, Starwaster and Ferram4, MIT: http://opensource.org/licenses/MIT
- http://forum.kerbalspaceprogram.com/threads/118088
-
- Toolbar integration powered by blizzy78's Toolbar plugin; used with permission
- http://forum.kerbalspaceprogram.com/threads/60863
- */
-
-using System.Collections.Generic;
-using UnityEngine;
-
-namespace FerramAerospaceResearch.FARPartGeometry
-{
- internal class DebugVisualVoxel
- {
- public const float globalScale = 0.9f;
- private float scale;
-
- public DebugVisualVoxel(Vector3 pos, double elementScale)
- {
- Scale = (float)elementScale;
- Position = pos;
- }
-
- public float Scale
- {
- get { return scale; }
- set
- {
- scale = value;
- Extent = value * globalScale;
- }
- }
-
- public float Extent { get; private set; }
-
- public Vector3 Position { get; }
-
- public Vector3 BottomLeft
- {
- get { return new Vector3(Position.x - Extent, Position.y - Extent, Position.z); }
- }
-
- public Vector3 BottomRight
- {
- get { return new Vector3(Position.x + Extent, Position.y - Extent, Position.z); }
- }
-
- public Vector3 TopRight
- {
- get { return new Vector3(Position.x + Extent, Position.y + Extent, Position.z); }
- }
-
- public Vector3 TopLeft
- {
- get { return new Vector3(Position.x - Extent, Position.y + Extent, Position.z); }
- }
-
- public void AddToMesh(List vertices, List uvs, List triangles, int indexOffset = 0)
- {
- // using offset for when KSP updates to Unity 2017.4+ -> 1 mesh can contain more than 65k vertices
- int counter = vertices.Count - indexOffset;
-
- // update extent in case globalScale changed
- Extent = Scale * globalScale;
-
- vertices.Add(BottomLeft);
- uvs.Add(new Vector2(0, 0));
-
- vertices.Add(TopLeft);
- uvs.Add(new Vector2(0, 1));
-
- vertices.Add(TopRight);
- uvs.Add(new Vector2(1, 1));
-
- vertices.Add(BottomRight);
- uvs.Add(new Vector2(1, 0));
-
- // left-handed triangles
- triangles.Add(counter);
- triangles.Add(counter + 1);
- triangles.Add(counter + 2);
-
- triangles.Add(counter);
- triangles.Add(counter + 2);
- triangles.Add(counter + 3);
- }
- }
-}
diff --git a/FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxelMeshController.cs b/FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxelMeshController.cs
deleted file mode 100644
index 732ceb0c2..000000000
--- a/FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxelMeshController.cs
+++ /dev/null
@@ -1,154 +0,0 @@
-/*
-Ferram Aerospace Research v0.15.11.4 "Mach"
-=========================
-Copyright 2019, Daumantas Kavolis, aka dkavolis
-
- This file is part of Ferram Aerospace Research.
-
- Ferram Aerospace Research is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
-
- Ferram Aerospace Research is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with Ferram Aerospace Research. If not, see .
-
- Serious thanks: a.g., for tons of bugfixes and code-refactorings
- stupid_chris, for the RealChuteLite implementation
- Taverius, for correcting a ton of incorrect values
- Tetryds, for finding lots of bugs and issues and not letting me get away with them, and work on example crafts
- sarbian, for refactoring code for working with MechJeb, and the Module Manager updates
- ialdabaoth (who is awesome), who originally created Module Manager
- Regex, for adding RPM support
- DaMichel, for some ferramGraph updates and some control surface-related features
- Duxwing, for copy editing the readme
-
- CompatibilityChecker by Majiir, BSD 2-clause http: //opensource.org/licenses/BSD-2-Clause
-
- Part.cfg changes powered by sarbian & ialdabaoth's ModuleManager plugin; used with permission
- http: //forum.kerbalspaceprogram.com/threads/55219
-
- ModularFLightIntegrator by Sarbian, Starwaster and Ferram4, MIT: http: //opensource.org/licenses/MIT
- http: //forum.kerbalspaceprogram.com/threads/118088
-
- Toolbar integration powered by blizzy78's Toolbar plugin; used with permission
- http: //forum.kerbalspaceprogram.com/threads/60863
- */
-
-using System;
-using System.Collections.Generic;
-using FerramAerospaceResearch.FARThreading;
-using FerramAerospaceResearch.FARUtils;
-using UnityEngine;
-using Object = UnityEngine.Object;
-
-namespace FerramAerospaceResearch.FARPartGeometry
-{
- public class DebugVisualVoxelMeshController : IDisposable
- {
- // limit of vertices in each mesh imposed by Unity
- public const int MaxVerticesPerSubmesh = 65000;
- public const int MaxVoxelsPerSubmesh = MaxVerticesPerSubmesh / 4;
- private readonly List submeshes = new List();
- private bool active;
-
- public DebugVisualVoxelMeshController(Transform parent = null)
- {
- Parent = parent;
- }
-
- public bool Active
- {
- // ReSharper disable once UnusedMember.Global
- get { return active; }
- set
- {
- if (active == value)
- return;
- active = value;
- QueueMainThreadTask(UpdateActive);
- }
- }
-
- internal List DebugVoxels { get; } = new List();
-
- public Transform Parent { get; }
-
- public void Dispose()
- {
- QueueMainThreadTask(DisposeSafe);
- }
-
- private void UpdateActive()
- {
- foreach (DebugVisualVoxelSubmesh submesh in submeshes)
- if (submesh != null)
- submesh.Active = active;
- }
-
- public void Rebuild()
- {
- FARLogger.Info("Rebuilding visual voxel mesh...");
- Clear();
- int meshes = DebugVoxels.Count / MaxVoxelsPerSubmesh + 1;
- FARLogger.Info("Voxel mesh contains " + DebugVoxels.Count + " voxels in " + meshes + " submeshes");
- SetupSubmeshes(meshes);
- for (int i = 0; i < meshes; i++)
- {
- for (int j = i * MaxVoxelsPerSubmesh;
- j < Math.Min((i + 1) * MaxVoxelsPerSubmesh, DebugVoxels.Count);
- j++)
- DebugVoxels[j].AddToMesh(submeshes[i].Vertices, submeshes[i].Uvs, submeshes[i].Triangles);
- submeshes[i].Rebuild();
- }
-
- FARLogger.Info("Finished rebuilding visual voxel mesh.");
- }
-
- public void RebuildSafe()
- {
- QueueMainThreadTask(Rebuild);
- }
-
- public void Clear(bool clearVoxels = false)
- {
- foreach (DebugVisualVoxelSubmesh submesh in submeshes)
- submesh.Clear();
- if (clearVoxels)
- DebugVoxels.Clear();
- }
-
- private void SetupSubmeshes(int meshes)
- {
- for (int i = submeshes.Count; i < meshes; i++)
- submeshes.Add(DebugVisualVoxelSubmesh.Create(Parent, active));
- }
-
- private void DisposeSafe()
- {
- foreach (DebugVisualVoxelSubmesh submesh in submeshes)
- Object.Destroy(submesh);
- }
-
- private static void QueueMainThreadTask(Action action)
- {
- if (VoxelizationThreadpool.Instance.inMainThread)
- {
- FARLogger.Debug("In main thread, not queueing " + action.Method.Name);
- action();
- }
- else
- {
- ThreadSafeDebugLogger.Instance.RegisterDebugMessage("Running " +
- action.Method.Name +
- " in main thread");
- VoxelizationThreadpool.Instance.RunOnMainThread(action);
- }
- }
- }
-}
diff --git a/FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxelSubmesh.cs b/FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxelSubmesh.cs
deleted file mode 100644
index 74eee12e8..000000000
--- a/FerramAerospaceResearch/FARPartGeometry/DebugVisualVoxelSubmesh.cs
+++ /dev/null
@@ -1,127 +0,0 @@
-/*
-Ferram Aerospace Research v0.15.11.4 "Mach"
-=========================
-Copyright 2019, Daumantas Kavolis, aka dkavolis
-
- This file is part of Ferram Aerospace Research.
-
- Ferram Aerospace Research is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
-
- Ferram Aerospace Research is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with Ferram Aerospace Research. If not, see .
-
- Serious thanks: a.g., for tons of bugfixes and code-refactorings
- stupid_chris, for the RealChuteLite implementation
- Taverius, for correcting a ton of incorrect values
- Tetryds, for finding lots of bugs and issues and not letting me get away with them, and work on example crafts
- sarbian, for refactoring code for working with MechJeb, and the Module Manager updates
- ialdabaoth (who is awesome), who originally created Module Manager
- Regex, for adding RPM support
- DaMichel, for some ferramGraph updates and some control surface-related features
- Duxwing, for copy editing the readme
-
- CompatibilityChecker by Majiir, BSD 2-clause http: //opensource.org/licenses/BSD-2-Clause
-
- Part.cfg changes powered by sarbian & ialdabaoth's ModuleManager plugin; used with permission
- http: //forum.kerbalspaceprogram.com/threads/55219
-
- ModularFLightIntegrator by Sarbian, Starwaster and Ferram4, MIT: http: //opensource.org/licenses/MIT
- http: //forum.kerbalspaceprogram.com/threads/118088
-
- Toolbar integration powered by blizzy78's Toolbar plugin; used with permission
- http: //forum.kerbalspaceprogram.com/threads/60863
- */
-
-using System.Collections.Generic;
-using FerramAerospaceResearch.FARUtils;
-using UnityEngine;
-using UnityEngine.Rendering;
-
-namespace FerramAerospaceResearch.FARPartGeometry
-{
- [RequireComponent(typeof(MeshFilter)), RequireComponent(typeof(MeshRenderer))]
- public sealed class DebugVisualVoxelSubmesh : MonoBehaviour
- {
- private MeshFilter meshFilter;
-
- public bool Active
- {
- // ReSharper disable once UnusedMember.Global
- get { return gameObject.activeSelf; }
- set { gameObject.SetActive(value); }
- }
-
- public Mesh Mesh { get; private set; }
-
- public MeshRenderer MeshRenderer { get; private set; }
-
- public List Vertices { get; } = new List();
-
- public List Uvs { get; } = new List();
-
- public List Triangles { get; } = new List();
-
- public static DebugVisualVoxelSubmesh Create(Transform parent = null, bool active = true)
- {
- var go = new GameObject();
- if (parent != null)
- go.transform.SetParent(parent);
- var component = go.AddComponent();
- go.SetActive(active);
- return component;
- }
-
- private void Awake()
- {
- FARLogger.Debug("Setting up debug voxel submesh");
- Mesh = new Mesh();
- meshFilter = GetComponent();
- MeshRenderer = GetComponent();
-
- meshFilter.mesh = Mesh;
- MeshRenderer.material = FARAssets.ShaderCache.DebugVoxels.Material;
- MeshRenderer.material.mainTexture = FARAssets.TextureCache.VoxelTexture;
- SetupMeshRenderer();
- }
-
- private void SetupMeshRenderer()
- {
- MeshRenderer.lightProbeUsage = LightProbeUsage.Off;
- MeshRenderer.reflectionProbeUsage = ReflectionProbeUsage.Off;
- MeshRenderer.shadowCastingMode = ShadowCastingMode.Off;
- MeshRenderer.receiveShadows = false;
- MeshRenderer.motionVectorGenerationMode = MotionVectorGenerationMode.ForceNoMotion;
- }
-
- public void Rebuild()
- {
- Mesh.SetVertices(Vertices);
- Mesh.SetUVs(0, Uvs);
- Mesh.SetTriangles(Triangles, 0);
- }
-
- public void Clear()
- {
- Mesh.Clear();
- Uvs.Clear();
- Vertices.Clear();
- Triangles.Clear();
- }
-
- private void OnDestroy()
- {
- Clear();
-
- // have to clean up renderer material
- Destroy(MeshRenderer.material);
- }
- }
-}
diff --git a/FerramAerospaceResearch/FARPartGeometry/DebugVoxel.cs b/FerramAerospaceResearch/FARPartGeometry/DebugVoxel.cs
new file mode 100644
index 000000000..21a0bab21
--- /dev/null
+++ b/FerramAerospaceResearch/FARPartGeometry/DebugVoxel.cs
@@ -0,0 +1,109 @@
+using System.Collections.Generic;
+using UnityEngine;
+
+namespace FerramAerospaceResearch.FARPartGeometry
+{
+ public struct DebugVoxel
+ {
+ public float Scale;
+ public Vector3 Position;
+
+ public DebugVoxel(Vector3 pos, float elementScale)
+ {
+ Scale = elementScale;
+ Position = pos;
+ }
+
+ public Vector3 BottomLeft
+ {
+ get { return new Vector3(Position.x - Scale, Position.y - Scale, Position.z); }
+ }
+
+ public Vector3 BottomRight
+ {
+ get { return new Vector3(Position.x + Scale, Position.y - Scale, Position.z); }
+ }
+
+ public Vector3 TopRight
+ {
+ get { return new Vector3(Position.x + Scale, Position.y + Scale, Position.z); }
+ }
+
+ public Vector3 TopLeft
+ {
+ get { return new Vector3(Position.x - Scale, Position.y + Scale, Position.z); }
+ }
+
+ public struct Builder : IDebugVoxelMeshBuilder
+ {
+ ///
+ public int VerticesPerVoxel
+ {
+ get { return 4; }
+ }
+
+ ///
+ public int UVChannels
+ {
+ get { return 1; }
+ }
+
+ ///
+ public MeshTopology Topology
+ {
+ // using triangles since they have better performance than quads
+ get { return MeshTopology.Triangles; }
+ }
+
+ ///
+ public int PrimitivesPerVoxel
+ {
+ get { return 2; }
+ }
+
+ ///
+ public Material MeshMaterial
+ {
+ get
+ {
+ Material mat = FARAssets.ShaderCache.DebugVoxels.Material;
+ mat.mainTexture = FARAssets.TextureCache.VoxelTexture;
+ return mat;
+ }
+ }
+
+ ///
+ public void Build(
+ DebugVoxel voxel,
+ List vertices,
+ List> uvs,
+ List indices,
+ int offset
+ )
+ {
+ int counter = vertices.Count - offset;
+
+ vertices.Add(voxel.BottomLeft);
+ uvs[0].Add(new Vector2(0, 0));
+
+ vertices.Add(voxel.TopLeft);
+ uvs[0].Add(new Vector2(0, 1));
+
+ vertices.Add(voxel.TopRight);
+ uvs[0].Add(new Vector2(1, 1));
+
+ vertices.Add(voxel.BottomRight);
+ uvs[0].Add(new Vector2(1, 0));
+
+ // left-handed triangles
+ indices.Add(counter);
+ indices.Add(counter + 1);
+ indices.Add(counter + 2);
+
+ indices.Add(counter);
+ indices.Add(counter + 2);
+ indices.Add(counter + 3);
+ }
+ }
+ }
+}
diff --git a/FerramAerospaceResearch/FARPartGeometry/DebugVoxelMesh.cs b/FerramAerospaceResearch/FARPartGeometry/DebugVoxelMesh.cs
new file mode 100644
index 000000000..b4b1a6bc9
--- /dev/null
+++ b/FerramAerospaceResearch/FARPartGeometry/DebugVoxelMesh.cs
@@ -0,0 +1,227 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using FerramAerospaceResearch.FARUtils;
+using UnityEngine;
+using UnityEngine.Rendering;
+
+namespace FerramAerospaceResearch.FARPartGeometry
+{
+ [RequireComponent(typeof(MeshRenderer)), RequireComponent(typeof(MeshFilter))]
+ public class DebugVoxelMesh : MonoBehaviour
+ {
+ // limit of vertices in each mesh imposed by Unity if using 16 bit indices
+ public const int MaxVerticesPerSubmesh = 65535;
+
+ private int currentSubmesh;
+ private int currentOffset;
+ private int indicesPerSubmesh;
+ private int verticesPerSubmesh;
+ private int nextVertexCount;
+ private int verticesPerVoxel;
+ public Mesh Mesh { get; private set; }
+ public MeshRenderer Renderer { get; private set; }
+ public MeshFilter Filter { get; private set; }
+ public List Vertices { get; } = new List();
+ public List> Uvs { get; } = new List>();
+ public List> Indices { get; } = new List>();
+
+ public bool Use32BitIndices
+ {
+ get { return Mesh.indexFormat == IndexFormat.UInt32; }
+ set { Mesh.indexFormat = value ? IndexFormat.UInt32 : IndexFormat.UInt16; }
+ }
+
+ public static DebugVoxelMesh Create(Transform parent = null)
+ {
+ var go = new GameObject("DebugVoxelMesh", typeof(DebugVoxelMesh));
+ DebugVoxelMesh mesh = go.GetComponent();
+
+ if (parent != null)
+ go.transform.SetParent(parent);
+
+ go.SetActive(true);
+ return mesh;
+ }
+
+ private void Awake()
+ {
+ FARLogger.Debug("Setting up debug voxel mesh");
+ Mesh = new Mesh();
+ Use32BitIndices = FARSettingsScenarioModule.VoxelSettings.use32BitIndices;
+ Filter = GetComponent();
+ Renderer = GetComponent();
+
+ Filter.mesh = Mesh;
+
+ // voxel mesh should not be affected by lights
+ Renderer.lightProbeUsage = LightProbeUsage.Off;
+ Renderer.reflectionProbeUsage = ReflectionProbeUsage.Off;
+ Renderer.shadowCastingMode = ShadowCastingMode.Off;
+ Renderer.receiveShadows = false;
+ Renderer.motionVectorGenerationMode = MotionVectorGenerationMode.ForceNoMotion;
+ }
+
+ public void Rebuild(Builder builder, Voxels voxels, int count)
+ where Builder : IDebugVoxelMeshBuilder where Voxels : IEnumerator
+ {
+ Clear(builder, count);
+ while (voxels.MoveNext())
+ Add(builder, voxels.Current);
+ Apply(builder);
+ }
+
+ private static void SetupNestedList(List> list, int meshes, int countPerSubmesh)
+ {
+ if (list.Capacity < meshes)
+ list.Capacity = meshes;
+
+ for (int i = list.Count; i < meshes; i++)
+ list.Add(new List());
+
+ for (int i = 0; i < meshes; i++)
+ {
+ if (list[i].Capacity < countPerSubmesh)
+ list[i].Capacity = countPerSubmesh;
+ }
+ }
+
+ public void Clear(bool clearMesh = true)
+ {
+ if (clearMesh)
+ Mesh.Clear();
+ Use32BitIndices = FARSettingsScenarioModule.VoxelSettings.use32BitIndices;
+ Uvs.Clear();
+ Vertices.Clear();
+ foreach (List sublist in Indices)
+ sublist.Clear();
+
+ currentSubmesh = 0;
+ nextVertexCount = 0;
+ currentOffset = 0;
+ }
+
+ public void Clear(Builder builder, int count, bool clearMesh = true)
+ where Builder : IDebugVoxelMeshBuilder
+ {
+ Clear(clearMesh);
+ Reserve(builder, count);
+ }
+
+ public void Reserve(Builder builder, int count) where Builder : IDebugVoxelMeshBuilder
+ {
+ int meshes;
+ int voxelsPerSubmesh;
+ if (Use32BitIndices)
+ {
+ voxelsPerSubmesh = count;
+ meshes = 1;
+ }
+ else
+ {
+ voxelsPerSubmesh = MaxVerticesPerSubmesh / builder.VerticesPerVoxel;
+ meshes = count / voxelsPerSubmesh + 1;
+ }
+
+ indicesPerSubmesh = voxelsPerSubmesh * builder.PrimitivesPerVoxel * IndicesPerPrimitive(builder.Topology);
+ verticesPerSubmesh = voxelsPerSubmesh * builder.VerticesPerVoxel;
+ nextVertexCount = verticesPerSubmesh;
+ verticesPerVoxel = builder.VerticesPerVoxel;
+
+ int nVertices = count * builder.VerticesPerVoxel;
+ if (Vertices.Capacity < nVertices)
+ Vertices.Capacity = nVertices;
+
+ SetupNestedList(Indices, meshes, indicesPerSubmesh);
+ SetupNestedList(Uvs, builder.UVChannels, nVertices);
+
+ FARLogger.InfoFormat("Reserved {0} voxels in {1} submeshes", count.ToString(), meshes.ToString());
+ }
+
+ public void Add(Builder builder, T voxel) where Builder : IDebugVoxelMeshBuilder
+ {
+ builder.Build(voxel, Vertices, Uvs, Indices[currentSubmesh], currentOffset);
+
+ // check if submesh is filled, 32 bit indices can store 4B vertices so there should be no need to check
+ if (Use32BitIndices || Vertices.Count < nextVertexCount)
+ return;
+
+ currentOffset = Vertices.Count;
+ currentSubmesh++;
+ nextVertexCount = Vertices.Count + verticesPerSubmesh;
+
+ // make sure the next list for indices is valid and reserve memory to for performance
+ if (Indices.Count > currentSubmesh)
+ return;
+ Indices.Add(new List());
+ Indices.Capacity = indicesPerSubmesh;
+ }
+
+ public void Apply(Builder builder) where Builder : IDebugVoxelMeshBuilder
+ {
+ Mesh.Clear();
+ FARLogger.InfoFormat("Built voxel mesh with {0} voxels in {1} submeshes",
+ (Vertices.Count / verticesPerVoxel).ToString(),
+ Indices.Count.ToString());
+
+ Mesh.SetVertices(Vertices);
+ for (int i = 0; i < Uvs.Count; i++)
+ {
+ if (Uvs[i].Count == 0)
+ continue;
+ Mesh.SetUVs(i, Uvs[i]);
+ }
+
+ //TODO: replace with Mesh.SetIndices(List, ...) when using Unity 2019.3+
+
+ if (Use32BitIndices)
+ {
+ // only 1 submesh
+ Renderer.material = builder.MeshMaterial;
+ Mesh.SetIndices(Indices[0].ToArray(), builder.Topology, 0);
+ }
+ else
+ {
+ // ignore empty index lists
+ int count = Indices.Sum(list => list.Count == 0 ? 0 : 1);
+ Mesh.subMeshCount = count;
+ var materials = new Material[count];
+
+ int offset = 0;
+ int j = 0;
+ foreach (List t in Indices)
+ {
+ if (t.Count == 0)
+ continue;
+ Mesh.SetIndices(t.ToArray(), builder.Topology, j, false, offset);
+ offset += verticesPerSubmesh;
+ materials[j] = builder.MeshMaterial;
+ j++;
+ }
+
+ Renderer.materials = materials;
+ }
+ }
+
+ private void OnDestroy()
+ {
+ Mesh.Clear();
+ Mesh = null;
+ Filter = null;
+ Renderer = null;
+ }
+
+ public static int IndicesPerPrimitive(MeshTopology topology)
+ {
+ return topology switch
+ {
+ MeshTopology.Triangles => 3,
+ MeshTopology.Quads => 4,
+ MeshTopology.Lines => 2,
+ MeshTopology.LineStrip => 10, // variable number so use some value, list will still grow as needed
+ MeshTopology.Points => 1,
+ _ => throw new ArgumentOutOfRangeException(nameof(topology), topology, null)
+ };
+ }
+ }
+}
diff --git a/FerramAerospaceResearch/FARPartGeometry/IDebugVoxelMeshBuilder.cs b/FerramAerospaceResearch/FARPartGeometry/IDebugVoxelMeshBuilder.cs
new file mode 100644
index 000000000..d3528fc8a
--- /dev/null
+++ b/FerramAerospaceResearch/FARPartGeometry/IDebugVoxelMeshBuilder.cs
@@ -0,0 +1,46 @@
+using System.Collections.Generic;
+using UnityEngine;
+
+namespace FerramAerospaceResearch.FARPartGeometry
+{
+ public interface IDebugVoxelMeshBuilder
+ {
+ ///
+ /// Number of vertices per voxel used for reserving memory
+ ///
+ int VerticesPerVoxel { get; }
+
+ ///
+ /// Number of UV channels
+ ///
+ int UVChannels { get; }
+
+ ///
+ /// Type of mesh that will be built by this
+ ///
+ MeshTopology Topology { get; }
+
+ ///
+ /// Number of geometric primitives (line, triangle etc.) per voxel
+ ///
+ int PrimitivesPerVoxel { get; }
+
+ ///
+ /// Material that will be used to render the resulting mesh
+ ///
+ Material MeshMaterial { get; }
+ }
+
+ public interface IDebugVoxelMeshBuilder : IDebugVoxelMeshBuilder
+ {
+ ///
+ /// Build a single voxel by appending the corresponding lists
+ ///
+ /// Voxel to build mesh for
+ /// List of mesh vertices
+ /// Nested list of mesh uvs, should have a list for each UV channel
+ /// List of indices
+ /// Offset to remove from indices before adding them to the list, for use with Unity submeshes
+ void Build(T voxel, List vertices, List> uvs, List indices, int offset);
+ }
+}
diff --git a/FerramAerospaceResearch/FARPartGeometry/VehicleVoxel.cs b/FerramAerospaceResearch/FARPartGeometry/VehicleVoxel.cs
index e17527369..25814fd35 100644
--- a/FerramAerospaceResearch/FARPartGeometry/VehicleVoxel.cs
+++ b/FerramAerospaceResearch/FARPartGeometry/VehicleVoxel.cs
@@ -68,7 +68,7 @@ public class VehicleVoxel
private static double maxLocation = 255;
private static byte maxLocationByte = 255;
private static bool useHigherResVoxels;
- private readonly DebugVisualVoxelMeshController voxelMesh;
+ private DebugVoxelMesh voxelMesh;
private readonly object _locker = new object();
private double invElementSize;
@@ -80,7 +80,11 @@ public class VehicleVoxel
private VehicleVoxel()
{
- voxelMesh = new DebugVisualVoxelMeshController {Active = false};
+ VoxelizationThreadpool.Instance.RunOnMainThread(() =>
+ {
+ voxelMesh = DebugVoxelMesh.Create();
+ voxelMesh.gameObject.SetActive(false);
+ });
}
public double ElementSize { get; private set; }
@@ -1345,34 +1349,35 @@ private static double TanPrincipalAxisAngle(double Ixx, double Iyy, double Ixy)
public void ClearVisualVoxels()
{
- FARLogger.Debug("Clearing visual voxels");
- voxelMesh.Active = false;
- for (int i = 0; i < xLength; i++)
+ if (voxelMesh == null)
+ return;
+ VoxelizationThreadpool.Instance.RunOnMainThread(() =>
{
- for (int j = 0; j < yLength; j++)
- {
- for (int k = 0; k < zLength; k++)
- voxelChunks[i, j, k]?.ClearVisualVoxels();
- }
- }
-
- voxelMesh.Clear(true);
+ FARLogger.Debug("Clearing visual voxels");
+ voxelMesh.gameObject.SetActive(false);
+ voxelMesh.Clear();
+ });
}
public void VisualizeVoxel(Matrix4x4 vesselLocalToWorldMatrix)
{
FARLogger.Debug("Creating visual voxels");
+ var builder = new DebugVoxel.Builder();
+ voxelMesh.Clear(builder, xLength * yLength * zLength * 128, false);
for (int i = 0; i < xLength; i++)
{
for (int j = 0; j < yLength; j++)
{
for (int k = 0; k < zLength; k++)
- voxelChunks[i, j, k]?.VisualizeVoxels(vesselLocalToWorldMatrix, voxelMesh);
+ voxelChunks[i, j, k]?.VisualizeVoxels(vesselLocalToWorldMatrix, voxelMesh, builder);
}
}
- voxelMesh.RebuildSafe();
- voxelMesh.Active = true;
+ VoxelizationThreadpool.Instance.RunOnMainThread(() =>
+ {
+ voxelMesh.Apply(builder);
+ voxelMesh.gameObject.SetActive(true);
+ });
}
//Only use to change size, not part
diff --git a/FerramAerospaceResearch/FARPartGeometry/VoxelChunk.cs b/FerramAerospaceResearch/FARPartGeometry/VoxelChunk.cs
index bb59ef1f3..f8047debb 100644
--- a/FerramAerospaceResearch/FARPartGeometry/VoxelChunk.cs
+++ b/FerramAerospaceResearch/FARPartGeometry/VoxelChunk.cs
@@ -50,7 +50,6 @@ namespace FerramAerospaceResearch.FARPartGeometry
internal class VoxelChunk
{
private readonly PartSizePair[] voxelPoints;
- private DebugVisualVoxel[,,] visualVoxels;
private HashSet overridingParts;
private double _size;
@@ -265,10 +264,9 @@ public PartSizePair GetVoxelPartSizePairGlobalIndex(int i, int j, int k)
return voxelPoints[index];
}
- public void VisualizeVoxels(Matrix4x4 vesselLocalToWorldMatrix, DebugVisualVoxelMeshController voxelMesh)
+ public void VisualizeVoxels(Matrix4x4 vesselLocalToWorldMatrix, DebugVoxelMesh voxelMesh, T builder)
+ where T : IDebugVoxelMeshBuilder
{
- ClearVisualVoxels();
- visualVoxels = new DebugVisualVoxel[8, 8, 8];
for (int i = 0; i < 8; i++)
for (int j = 0; j < 8; j++)
for (int k = 0; k < 8; k++)
@@ -282,24 +280,12 @@ public void VisualizeVoxels(Matrix4x4 vesselLocalToWorldMatrix, DebugVisualVoxel
elementSize *= _size * 0.5f;
var vx =
- new DebugVisualVoxel(vesselLocalToWorldMatrix.MultiplyPoint3x4(lowerCorner +
- new Vector3d(i, j, k) *
- _size),
- elementSize);
- voxelMesh.DebugVoxels.Add(vx);
- visualVoxels[i, j, k] = vx;
+ new DebugVoxel(vesselLocalToWorldMatrix.MultiplyPoint3x4(lowerCorner +
+ new Vector3d(i, j, k) * _size),
+ (float)elementSize);
+ voxelMesh.Add(builder, vx);
}
}
-
- public void ClearVisualVoxels()
- {
- if (visualVoxels == null)
- return;
- for (int i = 0; i < 8; i++)
- for (int j = 0; j < 8; j++)
- for (int k = 0; k < 8; k++)
- visualVoxels[i, j, k] = null;
- }
}
public enum VoxelOrientationPlane
diff --git a/FerramAerospaceResearch/FARSettingsScenarioModule.cs b/FerramAerospaceResearch/FARSettingsScenarioModule.cs
index 0e942df1a..c16adf36a 100644
--- a/FerramAerospaceResearch/FARSettingsScenarioModule.cs
+++ b/FerramAerospaceResearch/FARSettingsScenarioModule.cs
@@ -128,6 +128,7 @@ public override void OnSave(ConfigNode node)
node.AddValue("numVoxelsDebrisVessel", voxelSettings.numVoxelsDebrisVessel);
node.AddValue("minPhysTicksPerUpdate", voxelSettings.minPhysTicksPerUpdate);
node.AddValue("useHigherResVoxelPoints", voxelSettings.useHigherResVoxelPoints);
+ node.AddValue("use32BitIndices", voxelSettings.use32BitIndices);
node.AddValue("index", settings.index);
FlightGUI.SaveActiveData();
@@ -164,6 +165,8 @@ public override void OnLoad(ConfigNode node)
voxelSettings.minPhysTicksPerUpdate = int.Parse(node.GetValue("minPhysTicksPerUpdate"));
if (node.HasValue("useHigherResVoxelPoints"))
voxelSettings.useHigherResVoxelPoints = bool.Parse(node.GetValue("useHigherResVoxelPoints"));
+ if (node.HasValue("use32BitIndices"))
+ voxelSettings.use32BitIndices = bool.Parse(node.GetValue("use32BitIndices"));
if (index == -1)
{
@@ -306,6 +309,14 @@ public void DisplaySelection()
: "Low Res SubVoxels");
GUILayout.EndHorizontal();
+ GUILayout.BeginHorizontal();
+ GUILayout.Label("Mesh: use 32 bit indices: ");
+ voxelSettings.use32BitIndices = GUILayout.Toggle(voxelSettings.use32BitIndices,
+ voxelSettings.use32BitIndices
+ ? "32 bit indices"
+ : "16 bit indices");
+ GUILayout.EndHorizontal();
+
GUILayout.EndVertical();
}
}
@@ -348,17 +359,25 @@ public class FARVoxelSettings
public int numVoxelsDebrisVessel;
public int minPhysTicksPerUpdate;
public bool useHigherResVoxelPoints;
+ public bool use32BitIndices;
public FARVoxelSettings() : this(250000, 20000, 80, true)
{
}
- public FARVoxelSettings(int vesselCount, int debrisCount, int minPhysTicks, bool higherResVoxPoints)
+ public FARVoxelSettings(
+ int vesselCount,
+ int debrisCount,
+ int minPhysTicks,
+ bool higherResVoxPoints,
+ bool use32BitIndices = false
+ )
{
numVoxelsControllableVessel = vesselCount;
numVoxelsDebrisVessel = debrisCount;
minPhysTicksPerUpdate = minPhysTicks;
useHigherResVoxelPoints = higherResVoxPoints;
+ this.use32BitIndices = use32BitIndices;
}
}
}
diff --git a/FerramAerospaceResearch/FerramAerospaceResearch.csproj b/FerramAerospaceResearch/FerramAerospaceResearch.csproj
index c7826dd6c..ea6d2fd8b 100644
--- a/FerramAerospaceResearch/FerramAerospaceResearch.csproj
+++ b/FerramAerospaceResearch/FerramAerospaceResearch.csproj
@@ -109,6 +109,8 @@
+
+
@@ -116,6 +118,7 @@
+
@@ -155,9 +158,6 @@
-
-
-
diff --git a/GameData/FerramAerospaceResearch/Plugins/FerramAerospaceResearch.dll b/GameData/FerramAerospaceResearch/Plugins/FerramAerospaceResearch.dll
index bd97b7ef753de1f52223d3b074be820e2d416f61..8abc2cac4c4d4d2ce30670056d8bbef40f4aed37 100644
GIT binary patch
literal 354304
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