<pc-gsplat>
The <pc-gsplat> tag is used to define a gsplat component for rendering 3D Gaussian Splats.
When rendering splat-based scenes, it is recommended to set antialias and high-resolution on your <pc-app> tag to false for best performance.
Usage
- It must be a direct child of a
<pc-entity>.
Attributes
| Attribute | Type | Default | Description |
|---|---|---|---|
asset | String | - | Gaussian splat asset ID (must reference a gsplat type asset) |
cast-shadows | Flag | - | Whether the gsplat component casts shadows |
enabled | Boolean | "true" | Enabled state of the component |
lod-base-distance | Number | "5" | Distance for the first LOD transition (LOD 0 to LOD 1). Splats closer than this use the highest-quality LOD. Minimum 0.1. Only affects assets that contain LOD levels. |
lod-multiplier | Number | "3" | Multiplier between successive LOD distance thresholds, forming a geometric progression. Higher values switch to coarser LODs sooner. Minimum 1.2. Only affects assets that contain LOD levels. |
lod-range-min | Number | "0" | Minimum allowed LOD index (inclusive). The LOD selected by distance is clamped so it never goes finer (lower index) than this value. Raising it avoids downloading the highest-quality (largest) LOD files. Only affects assets that contain LOD levels. |
lod-range-max | Number | "99" | Maximum allowed LOD index (inclusive). The LOD selected by distance is clamped so it never goes coarser (higher index) than this value. The default of 99 effectively means "no cap". Only affects assets that contain LOD levels. |
Example
JavaScript Interface
You can programmatically create and manipulate <pc-gsplat> elements using the GSplatComponentElement API.