---
title: GaussianSplatResource
framework: realitykit
role: symbol
role_heading: Class
path: realitykit/gaussiansplatresource
---

# GaussianSplatResource

A component that renders 3D Gaussian splat data.

## Declaration

```swift
final class GaussianSplatResource
```

## Overview

Overview Use GaussianSplatComponent to display volumetric imagery captured from real environments, coalesced into 3D Gaussian splats (3DGS). Gaussian splatting is a rendering technique that represents a scene as a collection of 3D Gaussian primitives, each with a position, scale, rotation, opacity, and color defined by spherical harmonic coefficients. The result is a high-fidelity reproduction of a captured scene that people can view from novel angles. Unlike mesh-based rendering with ModelComponent, a GaussianSplatComponent doesn’t use developer-visible shaders. Instead, the framework renders each splat as an ellipsoid during the transparency render pass, blending splats back-to-front according to the resource’s sorting mode. important: Scene lighting doesn’t affect a Gaussian splat asset. The color of the rendered output reflects the lighting conditions present during the original capture. Providing Splat Data You supply splat data to the component through a GaussianSplatResource. Initially, the only supported resource type is a GaussianSplatResource.BufferResource. A buffer resource describes per-splat properties stored in one or more LowLevelBuffer instances. Each property is described using a GaussianSplatResource.BufferDescriptor that specifies the low level buffer, data format, byte offset, and stride. A single splat requires the following properties:  |  |   |  |   |  |   |  |   |  |   |  |  Using half instead of float is also supported. You can lay out these properties as interleaved data in a single buffer (array of structs) or use separate buffers for each property (struct of arrays). The framework doesn’t load files directly, so you parse your source format — PLY, USD, or any other container — and populate the buffers yourself. Creating a Splat Entity The following example reads splat data from a PLY file, populates a buffer resource, and adds the component to the scene: // Parse your splat source data. let bunny: PlyData = readDataFromPLY("bunny.ply")

// Allocate a LowLevelBuffer with your interleaved splat data. let floatSize = MemoryLayout<Float>.size let stride = 15 * floatSize

var buffer = try LowLevelBuffer(descriptor: .init(capacity: ((bunny.data.length + 15) & ~0xF), sizeMultiple: 16)) buffer.withUnsafeMutableBytes { ptr in     ptr.copyBytes(from: bunny.bytes, count: bunny.data.length) }

// Describe each property's location within the buffer. let position = GaussianSplatResource.BufferDescriptor(     buffer: buffer, format: .float3, stride: stride, offset: 0) let scale = GaussianSplatResource.BufferDescriptor(     buffer: buffer, format: .float3, stride: stride, offset: floatSize * 3) let rotation = GaussianSplatResource.BufferDescriptor(     buffer: buffer, format: .float4, stride: stride, offset: floatSize * 6) let opacity = GaussianSplatResource.BufferDescriptor(     buffer: buffer, format: .float, stride: stride, offset: floatSize * 10) let sh = GaussianSplatResource.BufferDescriptor(     buffer: buffer, format: .float3, stride: stride, offset: floatSize * 11)

// Create the buffer resource and wrap it in a GaussianSplatResource. let bufferResource = try GaussianSplatResource.BufferResource(     count: bunny.count,     position: position,     scale: scale,     rotation: rotation,     opacity: opacity,     sphericalHarmonics: (sh, .zero) ) let resource = GaussianSplatResource(bufferResource)

// Attach the component to an entity. let splatEntity = Entity() let component = GaussianSplatComponent(resource) splatEntity.components.set(component) Grounding Shadows If the entity also contains a GroundingShadowComponent, the framework generates an approximate grounding shadow using a spherical proxy mesh. This provides visual grounding in the scene but is only an approximate shape, based on the bounds of the point cloud data. Performance Considerations Rendering cost correlates with splat count and overdraw. The framework enforces an internal limit on the total number of splats, and the BufferResource initializer will throw, if exceeded. To address this, you can: Reduce splat count through pruning during the training pipeline. Minimize overdraw by culling low-opacity splats before providing data to the component.

## Topics

### Structures

- [GaussianSplatResource.BufferDescriptor](realitykit/gaussiansplatresource/bufferdescriptor.md)
- [GaussianSplatResource.BufferResource](realitykit/gaussiansplatresource/bufferresource-swift.struct.md)

### Initializers

- [init(_:)](realitykit/gaussiansplatresource/init(_:).md)

### Instance Properties

- [bufferResource](realitykit/gaussiansplatresource/bufferresource-swift.property.md)
- [colorSpace](realitykit/gaussiansplatresource/colorspace.md)
- [opacityActivation](realitykit/gaussiansplatresource/opacityactivation.md)
- [projectionMode](realitykit/gaussiansplatresource/projectionmode-swift.property.md)
- [scaleActivation](realitykit/gaussiansplatresource/scaleactivation.md)
- [sortingMode](realitykit/gaussiansplatresource/sortingmode-swift.property.md)

### Enumerations

- [GaussianSplatResource.ActivationFunction](realitykit/gaussiansplatresource/activationfunction.md)
- [GaussianSplatResource.ProjectionMode](realitykit/gaussiansplatresource/projectionmode-swift.enum.md)
- [GaussianSplatResource.SortingMode](realitykit/gaussiansplatresource/sortingmode-swift.enum.md)
- [GaussianSplatResource.SphericalHarmonicDegree](realitykit/gaussiansplatresource/sphericalharmonicdegree.md)