Skip to content

[VR] Single Pass Instanced/Multiview Support for Gaussian Splatting in URP #173

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 12 commits into
base: main
Choose a base branch
from
Open

[VR] Single Pass Instanced/Multiview Support for Gaussian Splatting in URP #173

Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
25fc55d
Working single pass instanced and multiview rendering in Quest3. Exis…
arghyasur1991 Apr 13, 2025
c306f84
Optimize sorting and rendering splats where only the rendering is now…
arghyasur1991 Apr 13, 2025
5f8bb78
Merge commit '2f371e121db7c56159be634545d5bf9c5b2ce55b' into multiview7
arghyasur1991 Apr 13, 2025
25344b4
Cleanups
arghyasur1991 Apr 13, 2025
102a41a
more cleanups
arghyasur1991 Apr 13, 2025
d045012
Parameter exposed for Sorting Per eye
arghyasur1991 Apr 13, 2025
e586ba9
review comments
arghyasur1991 Apr 13, 2025
815384f
minor cleanup
arghyasur1991 Apr 13, 2025
6bc220f
Fix for non stereo
arghyasur1991 Apr 13, 2025
c5276a9
removing unnecessary UnityObjectToClipPos
arghyasur1991 Apr 13, 2025
e703811
Add workaround and TODO text for stereo rendering via 2 draw calls.
arghyasur1991 Apr 14, 2025
051d245
Editor potential fix
arghyasur1991 Apr 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion package/Editor/GaussianSplatRendererEditor.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ public class GaussianSplatRendererEditor : UnityEditor.Editor
SerializedProperty m_PropSHOrder;
SerializedProperty m_PropSHOnly;
SerializedProperty m_PropSortNthFrame;
SerializedProperty m_PropSortPerEye;
SerializedProperty m_PropRenderMode;
SerializedProperty m_PropPointDisplaySize;
SerializedProperty m_PropCutouts;
Expand Down Expand Up @@ -67,6 +68,7 @@ public void OnEnable()
m_PropSHOrder = serializedObject.FindProperty("m_SHOrder");
m_PropSHOnly = serializedObject.FindProperty("m_SHOnly");
m_PropSortNthFrame = serializedObject.FindProperty("m_SortNthFrame");
m_PropSortPerEye = serializedObject.FindProperty("m_SortPerEye");
m_PropRenderMode = serializedObject.FindProperty("m_RenderMode");
m_PropPointDisplaySize = serializedObject.FindProperty("m_PointDisplaySize");
m_PropCutouts = serializedObject.FindProperty("m_Cutouts");
Expand Down Expand Up @@ -111,7 +113,7 @@ public override void OnInspectorGUI()
EditorGUILayout.PropertyField(m_PropSHOrder);
EditorGUILayout.PropertyField(m_PropSHOnly);
EditorGUILayout.PropertyField(m_PropSortNthFrame);

EditorGUILayout.PropertyField(m_PropSortPerEye);
EditorGUILayout.Space();
GUILayout.Label("Debugging Tweaks", EditorStyles.boldLabel);
EditorGUILayout.PropertyField(m_PropRenderMode);
Expand Down
127 changes: 114 additions & 13 deletions package/Runtime/GaussianSplatRenderer.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,15 @@ class GaussianSplatRenderSystem

CommandBuffer m_CommandBuffer;

// Keep track of the prepared splats for stereo rendering
public class PreparedRenderData
{
public Material matComposite;
public List<(GaussianSplatRenderer gs, Material displayMat, MaterialPropertyBlock mpb, int indexCount, int instanceCount, MeshTopology topology)> renderItems = new();
}

private PreparedRenderData m_LastPreparedData;

public void RegisterSplat(GaussianSplatRenderer r)
{
if (m_Splats.Count == 0)
Expand Down Expand Up @@ -104,24 +113,32 @@ public bool GatherSplatsForCamera(Camera cam)
return true;
}

// New optimized method that prepares everything once for stereo rendering
// This does the sorting and calculates view data, but doesn't actually render
// ReSharper disable once MemberCanBePrivate.Global - used by HDRP/URP features that are not always compiled
public Material SortAndRenderSplats(Camera cam, CommandBuffer cmb)
public PreparedRenderData PrepareSplats(Camera cam, CommandBuffer cmb)
{
if (m_LastPreparedData == null)
m_LastPreparedData = new PreparedRenderData();
else
m_LastPreparedData.renderItems.Clear();

Material matComposite = null;

foreach (var kvp in m_ActiveSplats)
{
var gs = kvp.Item1;
gs.EnsureMaterials();
matComposite = gs.m_MatComposite;
var mpb = kvp.Item2;

// sort
// Sort the splats
var matrix = gs.transform.localToWorldMatrix;
if (gs.m_FrameCounter % gs.m_SortNthFrame == 0)
gs.SortPoints(cmb, cam, matrix);
++gs.m_FrameCounter;

// cache view
// Prepare material and view data
kvp.Item2.Clear();
Material displayMat = gs.m_RenderMode switch
{
Expand All @@ -134,11 +151,10 @@ public Material SortAndRenderSplats(Camera cam, CommandBuffer cmb)
if (displayMat == null)
continue;

gs.SetAssetDataOnMaterial(mpb);
// Set up everything except eye-specific parameters
gs.SetAssetDataOnMaterial(mpb, -1); // -1 for initial setup without eye index
mpb.SetBuffer(GaussianSplatRenderer.Props.SplatChunks, gs.m_GpuChunks);

mpb.SetBuffer(GaussianSplatRenderer.Props.SplatViewData, gs.m_GpuView);

mpb.SetBuffer(GaussianSplatRenderer.Props.OrderBuffer, gs.m_GpuSortKeys);
mpb.SetFloat(GaussianSplatRenderer.Props.SplatScale, gs.m_SplatScale);
mpb.SetFloat(GaussianSplatRenderer.Props.SplatOpacityScale, gs.m_OpacityScale);
Expand All @@ -148,11 +164,12 @@ public Material SortAndRenderSplats(Camera cam, CommandBuffer cmb)
mpb.SetInteger(GaussianSplatRenderer.Props.DisplayIndex, gs.m_RenderMode == GaussianSplatRenderer.RenderMode.DebugPointIndices ? 1 : 0);
mpb.SetInteger(GaussianSplatRenderer.Props.DisplayChunks, gs.m_RenderMode == GaussianSplatRenderer.RenderMode.DebugChunkBounds ? 1 : 0);

// Calculate view data once for stereo (will calculate for both eyes)
cmb.BeginSample(s_ProfCalcView);
gs.CalcViewData(cmb, cam);
cmb.EndSample(s_ProfCalcView);

// draw
// Set up draw parameters
int indexCount = 6;
int instanceCount = gs.splatCount;
MeshTopology topology = MeshTopology.Triangles;
Expand All @@ -161,11 +178,45 @@ public Material SortAndRenderSplats(Camera cam, CommandBuffer cmb)
if (gs.m_RenderMode == GaussianSplatRenderer.RenderMode.DebugChunkBounds)
instanceCount = gs.m_GpuChunksValid ? gs.m_GpuChunks.count : 0;

// Store the prepared data for rendering later
m_LastPreparedData.renderItems.Add((gs, displayMat, mpb, indexCount, instanceCount, topology));
}

m_LastPreparedData.matComposite = matComposite;
return m_LastPreparedData;
}

// New optimized method that just draws the prepared splats for a specific eye
// ReSharper disable once MemberCanBePrivate.Global - used by HDRP/URP features that are not always compiled
public void RenderPreparedSplats(CommandBuffer cmb, int eyeIndex)
{
if (m_LastPreparedData == null || m_LastPreparedData.renderItems.Count == 0)
return;

foreach (var (gs, displayMat, mpb, indexCount, instanceCount, topology) in m_LastPreparedData.renderItems)
{
// Set the eye index for this specific render
mpb.SetInteger(GaussianSplatRenderer.Props.EyeIndex, eyeIndex);
mpb.SetInteger(GaussianSplatRenderer.Props.IsStereo, 1);

// Draw
cmb.BeginSample(s_ProfDraw);
cmb.DrawProcedural(gs.m_GpuIndexBuffer, matrix, displayMat, 0, topology, indexCount, instanceCount, mpb);
cmb.DrawProcedural(gs.m_GpuIndexBuffer, gs.transform.localToWorldMatrix, displayMat, 0, topology, indexCount, instanceCount, mpb);
cmb.EndSample(s_ProfDraw);
}
return matComposite;
}

// ReSharper disable once MemberCanBePrivate.Global - used by HDRP/URP features that are not always compiled
public Material SortAndRenderSplats(Camera cam, CommandBuffer cmb, int eyeIndex = -1)
{
// Prepare the splats (sort and calculate view data)
var renderData = PrepareSplats(cam, cmb);

// Render the prepared splats
RenderPreparedSplats(cmb, eyeIndex);

// Return the composite material
return renderData.matComposite;
}

// ReSharper disable once MemberCanBePrivate.Global - used by HDRP/URP features that are not always compiled
Expand Down Expand Up @@ -209,6 +260,17 @@ void OnPreCullCamera(Camera cam)
m_CommandBuffer.EndSample(s_ProfCompose);
m_CommandBuffer.ReleaseTemporaryRT(GaussianSplatRenderer.Props.GaussianSplatRT);
}

// Checks if any active splats require per-eye sorting
public bool RequiresPerEyeSorting()
{
foreach (var item in m_ActiveSplats)
{
if (item.Item1.m_SortPerEye)
return true;
}
return false;
}
}

[ExecuteInEditMode]
Expand Down Expand Up @@ -237,6 +299,8 @@ public enum RenderMode
public bool m_SHOnly;
[Range(1,30)] [Tooltip("Sort splats only every N frames")]
public int m_SortNthFrame = 1;
[Tooltip("When in VR, sort splats separately for each eye. This increases accuracy but reduces performance.")]
public bool m_SortPerEye = false;

public RenderMode m_RenderMode = RenderMode.Splats;
[Range(1.0f,15.0f)] public float m_PointDisplaySize = 3.0f;
Expand Down Expand Up @@ -297,6 +361,8 @@ internal static class Props
public static readonly int SplatBitsValid = Shader.PropertyToID("_SplatBitsValid");
public static readonly int SplatFormat = Shader.PropertyToID("_SplatFormat");
public static readonly int SplatChunks = Shader.PropertyToID("_SplatChunks");
public static readonly int EyeIndex = Shader.PropertyToID("_EyeIndex");
public static readonly int IsStereo = Shader.PropertyToID("_IsStereo");
public static readonly int SplatChunkCount = Shader.PropertyToID("_SplatChunkCount");
public static readonly int SplatViewData = Shader.PropertyToID("_SplatViewData");
public static readonly int OrderBuffer = Shader.PropertyToID("_OrderBuffer");
Expand Down Expand Up @@ -328,6 +394,8 @@ internal static class Props
public static readonly int SelectionMode = Shader.PropertyToID("_SelectionMode");
public static readonly int SplatPosMouseDown = Shader.PropertyToID("_SplatPosMouseDown");
public static readonly int SplatOtherMouseDown = Shader.PropertyToID("_SplatOtherMouseDown");
public static readonly int ViewProjMatrixLeft = Shader.PropertyToID("_ViewProjMatrixLeft");
public static readonly int ViewProjMatrixRight = Shader.PropertyToID("_ViewProjMatrixRight");
}

[field: NonSerialized] public bool editModified { get; private set; }
Expand Down Expand Up @@ -404,7 +472,8 @@ void CreateResourcesForAsset()
m_GpuChunksValid = false;
}

m_GpuView = new GraphicsBuffer(GraphicsBuffer.Target.Structured, m_Asset.splatCount, kGpuViewDataSize);
// Double the size to hold both left and right eye data for stereo rendering
m_GpuView = new GraphicsBuffer(GraphicsBuffer.Target.Structured, m_Asset.splatCount * 2, kGpuViewDataSize);
m_GpuIndexBuffer = new GraphicsBuffer(GraphicsBuffer.Target.Index, 36, 2);
// cube indices, most often we use only the first quad
m_GpuIndexBuffer.SetData(new ushort[]
Expand Down Expand Up @@ -509,14 +578,23 @@ void SetAssetDataOnCS(CommandBuffer cmb, KernelIndices kernel)
cmb.SetComputeBufferParam(cs, kernelIndex, Props.SplatCutouts, m_GpuEditCutouts);
}

internal void SetAssetDataOnMaterial(MaterialPropertyBlock mat)
internal void SetAssetDataOnMaterial(MaterialPropertyBlock mat, int eyeIndex)
{
mat.SetBuffer(Props.SplatPos, m_GpuPosData);
mat.SetBuffer(Props.SplatOther, m_GpuOtherData);
mat.SetBuffer(Props.SplatSH, m_GpuSHData);
mat.SetTexture(Props.SplatColor, m_GpuColorData);
mat.SetBuffer(Props.SplatSelectedBits, m_GpuEditSelected ?? m_GpuPosData);
mat.SetBuffer(Props.SplatDeletedBits, m_GpuEditDeleted ?? m_GpuPosData);
if (eyeIndex != -1)
{
mat.SetInteger(Props.EyeIndex, eyeIndex);
mat.SetInteger(Props.IsStereo, 1);
}
else
{
mat.SetInteger(Props.IsStereo, 0);
}
mat.SetInt(Props.SplatBitsValid, m_GpuEditSelected != null && m_GpuEditDeleted != null ? 1 : 0);
uint format = (uint)m_Asset.posFormat | ((uint)m_Asset.scaleFormat << 8) | ((uint)m_Asset.shFormat << 16);
mat.SetInteger(Props.SplatFormat, (int)format);
Expand Down Expand Up @@ -597,6 +675,28 @@ internal void CalcViewData(CommandBuffer cmb, Camera cam)
cmb.SetComputeMatrixParam(m_CSSplatUtilities, Props.MatrixMV, matView * matO2W);
cmb.SetComputeMatrixParam(m_CSSplatUtilities, Props.MatrixObjectToWorld, matO2W);
cmb.SetComputeMatrixParam(m_CSSplatUtilities, Props.MatrixWorldToObject, matW2O);
bool isStereo = XRSettings.enabled && cam.stereoEnabled &&
(XRSettings.stereoRenderingMode == XRSettings.StereoRenderingMode.SinglePassInstanced ||
XRSettings.stereoRenderingMode == XRSettings.StereoRenderingMode.SinglePassMultiview);

if (isStereo)
{
// Get correct stereo matrices for each eye
Matrix4x4 stereoViewLeft = cam.GetStereoViewMatrix(Camera.StereoscopicEye.Left);
Matrix4x4 stereoProjLeft = GL.GetGPUProjectionMatrix(cam.GetStereoProjectionMatrix(Camera.StereoscopicEye.Left), true);
Matrix4x4 matVPLeft = stereoProjLeft * stereoViewLeft;
cmb.SetComputeMatrixParam(m_CSSplatUtilities, Props.ViewProjMatrixLeft, matVPLeft);

Matrix4x4 stereoViewRight = cam.GetStereoViewMatrix(Camera.StereoscopicEye.Right);
Matrix4x4 stereoProjRight = GL.GetGPUProjectionMatrix(cam.GetStereoProjectionMatrix(Camera.StereoscopicEye.Right), true);
Matrix4x4 matVPRight = stereoProjRight * stereoViewRight;
cmb.SetComputeMatrixParam(m_CSSplatUtilities, Props.ViewProjMatrixRight, matVPRight);
cmb.SetComputeIntParam(m_CSSplatUtilities, Props.IsStereo, 1);
}
else
{
cmb.SetComputeIntParam(m_CSSplatUtilities, Props.IsStereo, 0);
}

cmb.SetComputeVectorParam(m_CSSplatUtilities, Props.VecScreenParams, screenPar);
cmb.SetComputeVectorParam(m_CSSplatUtilities, Props.VecWorldSpaceCameraPos, camPos);
Expand All @@ -606,7 +706,7 @@ internal void CalcViewData(CommandBuffer cmb, Camera cam)
cmb.SetComputeIntParam(m_CSSplatUtilities, Props.SHOnly, m_SHOnly ? 1 : 0);

m_CSSplatUtilities.GetKernelThreadGroupSizes((int)KernelIndices.CalcViewData, out uint gsX, out _, out _);
cmb.DispatchCompute(m_CSSplatUtilities, (int)KernelIndices.CalcViewData, (m_GpuView.count + (int)gsX - 1)/(int)gsX, 1, 1);
cmb.DispatchCompute(m_CSSplatUtilities, (int)KernelIndices.CalcViewData, (m_SplatCount + (int)gsX - 1)/(int)gsX, 1, 1);
}

internal void SortPoints(CommandBuffer cmd, Camera cam, Matrix4x4 matrix)
Expand Down Expand Up @@ -997,7 +1097,8 @@ public void EditSetSplatCount(int newSplatCount)
ClearGraphicsBuffer(newEditSelectedMouseDown);
ClearGraphicsBuffer(newEditDeleted);

var newGpuView = new GraphicsBuffer(GraphicsBuffer.Target.Structured, newSplatCount, kGpuViewDataSize);
// Double the size to hold both left and right eye data
var newGpuView = new GraphicsBuffer(GraphicsBuffer.Target.Structured, newSplatCount * 2, kGpuViewDataSize);
InitSortBuffers(newSplatCount);

// copy existing data over into new buffers
Expand Down
Loading