Skip to content

Commit d0ff71d

Browse files
gotoeasygotoeasy
committed
v3.5.0
1 parent 636710d commit d0ff71d

File tree

1 file changed

+38
-37
lines changed

1 file changed

+38
-37
lines changed

‎README.md

Lines changed: 38 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ A cross-platform command-line tool for 3D Gaussian Splatting, focusing on format
1818
## Features
1919
- [x] Conversion between file formats, supporting `.ply`, `.splat`, `.spx`, and `.spz` formats for 3DGS.
2020
- [x] Viewing file header information for `.ply`, `.spx`, and `.spz` files, or simple information of `.splat`.
21-
- [x] Supports data transformation in RST (Rotation, Scale, Translation) order.
21+
- [x] Supports data transformation (Rotation, Scale, Translation).
2222
- [x] Supports merging multiple model files into one.
2323

2424

@@ -38,46 +38,47 @@ Usage:
3838
gsbox [options]
3939

4040
Options:
41-
p2s, ply2splat convert ply to splat
42-
p2x, ply2spx convert ply to spx
43-
p2z, ply2spz convert ply to spz
44-
p2p, ply2ply convert ply to ply
45-
s2p, splat2ply convert splat to ply
46-
s2x, splat2spx convert splat to spx
47-
s2z, splat2spz convert splat to spz
48-
s2s, splat2splat convert splat to splat
49-
x2p, spx2ply convert spx to ply
50-
x2s, spx2splat convert spx to splat
51-
x2z, spx2spz convert spx to spz
52-
x2x, spx2spx convert spx to spx
53-
z2p, spz2ply convert spz to ply
54-
z2s, spz2splat convert spz to splat
55-
z2x, spz2spx convert spz to spx
56-
z2z, spz2spz convert spz to spz
57-
join join the input model files into a single output file
58-
info <file> display the model file information
59-
-i, --input <file> specify the input file
60-
-o, --output <file> specify the output file
61-
-c, --comment <text> specify the comment for ply/spx output
62-
-bs, --block-size <num> specify the block size for spx output (default 20480)
63-
-sh, --shDegree <num> specify the SH degree for ply/spx/spz output
64-
-f1, --flag1 <num> specify the header flag1 for spx output
65-
-f2, --flag2 <num> specify the header flag2 for spx output
66-
-f3, --flag3 <num> specify the header flag3 for spx output
67-
-rx, --rotateX <num> specify the rotation angle in degrees about the x-axis for transform
68-
-ry, --rotateY <num> specify the rotation angle in degrees about the y-axis for transform
69-
-rz, --rotateZ <num> specify the rotation angle in degrees about the z-axis for transform
70-
-s, --scale <num> specify a uniform scaling factor(0.01~100.0) for transform
71-
-tx, --translateX <num> specify the translation value about the x-axis for transform
72-
-ty, --translateY <num> specify the translation value about the y-axis for transform
73-
-tz, --translateZ <num> specify the translation value about the z-axis for transform
74-
-v, --version display version information
75-
-h, --help display help information
41+
p2s, ply2splat convert ply to splat
42+
p2x, ply2spx convert ply to spx
43+
p2z, ply2spz convert ply to spz
44+
p2p, ply2ply convert ply to ply
45+
s2p, splat2ply convert splat to ply
46+
s2x, splat2spx convert splat to spx
47+
s2z, splat2spz convert splat to spz
48+
s2s, splat2splat convert splat to splat
49+
x2p, spx2ply convert spx to ply
50+
x2s, spx2splat convert spx to splat
51+
x2z, spx2spz convert spx to spz
52+
x2x, spx2spx convert spx to spx
53+
z2p, spz2ply convert spz to ply
54+
z2s, spz2splat convert spz to splat
55+
z2x, spz2spx convert spz to spx
56+
z2z, spz2spz convert spz to spz
57+
join join the input model files into a single output file
58+
info <file> display the model file information
59+
-i, --input <file> specify the input file
60+
-o, --output <file> specify the output file
61+
-c, --comment <text> specify the comment for ply/spx output
62+
-bs, --block-size <num> specify the block size for spx output (default 20480)
63+
-sh, --shDegree <num> specify the SH degree for ply/spx/spz output
64+
-f1, --flag1 <num> specify the header flag1 for spx output
65+
-f2, --flag2 <num> specify the header flag2 for spx output
66+
-f3, --flag3 <num> specify the header flag3 for spx output
67+
-rx, --rotateX <num> specify the rotation angle in degrees about the x-axis for transform
68+
-ry, --rotateY <num> specify the rotation angle in degrees about the y-axis for transform
69+
-rz, --rotateZ <num> specify the rotation angle in degrees about the z-axis for transform
70+
-s, --scale <num> specify a uniform scaling factor(0.01~100.0) for transform
71+
-tx, --translateX <num> specify the translation value about the x-axis for transform
72+
-ty, --translateY <num> specify the translation value about the y-axis for transform
73+
-tz, --translateZ <num> specify the translation value about the z-axis for transform
74+
-to, --transform-order <RST> specify the transform order (RST/RTS/SRT/STR/TRS/TSR), default is RST
75+
-v, --version display version information
76+
-h, --help display help information
7677

7778
Examples:
7879
gsbox ply2splat -i /path/to/input.ply -o /path/to/output.splat
7980
gsbox s2x -i /path/to/input.splat -o /path/to/output.spx -c "your comment" -bs 10240
80-
gsbox x2z -i /path/to/input.spx -o /path/to/output.spz -sh 0 -rz 90 -s 0.9 -tx 0.1
81+
gsbox x2z -i /path/to/input.spx -o /path/to/output.spz -sh 0 -rz 90 -s 0.9 -tx 0.1 -to TRS
8182
gsbox z2p -i /path/to/input.spz -o /path/to/output.ply -c "your comment"
8283
gsbox join -i a.ply -i b.splat -i c.spx -i d.spz -o output.spx
8384
gsbox info -i /path/to/file.spx

0 commit comments

Comments
 (0)