@playcanvas/splat-transform 0.8.1 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -3
- package/dist/index.mjs +278 -9
- package/dist/index.mjs.map +1 -1
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -3,13 +3,16 @@
|
|
|
3
3
|
[](https://www.npmjs.com/package/@playcanvas/splat-transform)
|
|
4
4
|
[](https://npmtrends.com/@playcanvas/splat-transform)
|
|
5
5
|
[](https://github.com/playcanvas/splat-transform/blob/main/LICENSE)
|
|
6
|
+
[](https://discord.gg/RSaMRzg)
|
|
7
|
+
[](https://www.reddit.com/r/PlayCanvas)
|
|
8
|
+
[](https://x.com/intent/follow?screen_name=playcanvas)
|
|
6
9
|
|
|
7
10
|
| [User Guide](https://developer.playcanvas.com/user-manual/gaussian-splatting/editing/splat-transform/) | [Blog](https://blog.playcanvas.com/) | [Forum](https://forum.playcanvas.com/) | [Discord](https://discord.gg/RSaMRzg) |
|
|
8
11
|
|
|
9
12
|
SplatTransform is an open source CLI tool for converting and editing Gaussian splats. It can:
|
|
10
13
|
|
|
11
14
|
📥 Read PLY, Compressed PLY, SPLAT, KSPLAT formats
|
|
12
|
-
📤 Write PLY, Compressed PLY, CSV, and
|
|
15
|
+
📤 Write PLY, Compressed PLY, CSV, SOG and HTML viewer formats
|
|
13
16
|
🔗 Merge multiple splats
|
|
14
17
|
🔄 Apply transformations to input splats
|
|
15
18
|
🎛️ Filter out Gaussians or spherical harmonic bands
|
|
@@ -33,7 +36,7 @@ npm install -g @playcanvas/splat-transform
|
|
|
33
36
|
## Usage
|
|
34
37
|
|
|
35
38
|
```bash
|
|
36
|
-
splat-transform [GLOBAL] <input.{ply|compressed.ply|splat|ksplat}> [ACTIONS] ... <output.{ply|compressed.ply|sog|meta.json|csv}> [ACTIONS]
|
|
39
|
+
splat-transform [GLOBAL] <input.{ply|compressed.ply|splat|ksplat}> [ACTIONS] ... <output.{ply|compressed.ply|sog|meta.json|csv|html}> [ACTIONS]
|
|
37
40
|
```
|
|
38
41
|
|
|
39
42
|
**Key points:**
|
|
@@ -54,6 +57,7 @@ splat-transform [GLOBAL] <input.{ply|compressed.ply|splat|ksplat}> [ACTIONS] .
|
|
|
54
57
|
- `.sog` - SOG bundled format
|
|
55
58
|
- `meta.json` - SOG unbundled format (JSON + WebP images)
|
|
56
59
|
- `.csv` - Comma-separated values
|
|
60
|
+
- `.html` - Standalone HTML viewer app
|
|
57
61
|
|
|
58
62
|
## Actions
|
|
59
63
|
|
|
@@ -77,6 +81,8 @@ Actions can be repeated and applied in any order:
|
|
|
77
81
|
-v, --version Show version and exit
|
|
78
82
|
-g, --no-gpu Disable gpu when compressing spherical harmonics.
|
|
79
83
|
-i, --iterations <number> Specify the number of iterations when compressing spherical harmonics. More iterations generally lead to better results. Default is 10.
|
|
84
|
+
-p, --cameraPos Specify the viewer starting position. Default is 2,2,-2.
|
|
85
|
+
-e, --cameraTarget Specify the viewer starting target. Default is 0,0,0.
|
|
80
86
|
```
|
|
81
87
|
|
|
82
88
|
## Examples
|
|
@@ -105,6 +111,9 @@ splat-transform input.ply output.sog
|
|
|
105
111
|
|
|
106
112
|
# Convert to SOG unbundled format
|
|
107
113
|
splat-transform input.ply output/meta.json
|
|
114
|
+
|
|
115
|
+
# Convert to HTML viewer with target and camera location
|
|
116
|
+
splat-transform -a 0,0,0 -e 0,0,10 input.ply output.html
|
|
108
117
|
```
|
|
109
118
|
|
|
110
119
|
### Transformations
|
|
@@ -140,7 +149,7 @@ splat-transform input.ply --filterBands 2 output.ply
|
|
|
140
149
|
splat-transform -w cloudA.ply -r 0,90,0 cloudB.ply -s 2 merged.compressed.ply
|
|
141
150
|
|
|
142
151
|
# Apply final transformations to combined result
|
|
143
|
-
splat-transform input1.ply input2.ply output.ply -
|
|
152
|
+
splat-transform input1.ply input2.ply output.ply -p 0,0,10 -e 0.5
|
|
144
153
|
```
|
|
145
154
|
|
|
146
155
|
## Getting Help
|