Skip to content

Commit 74b5688

Browse files
authored
Update README.md
1 parent 9f4780d commit 74b5688

1 file changed

Lines changed: 9 additions & 11 deletions

File tree

README.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
![kubi_logo](./img/kubi_logo.png)
1+
<img width="117" alt="kubi logo" src="./img/kubi_logo.png">
22

33
**kubi** is a fast and flexible cubemap generator based on [libvips](https://libvips.github.io/libvips/)
44

@@ -17,27 +17,25 @@ pip install git+https://github.com/indus/kubi.git
1717
When used with a glob pattern for multiple input files, **kubi** generates an [index file](https://libvips.github.io/libvips/API/current/libvips-resample.html#vips-mapim) once and reuses it while processing all found images. This can lead to a [significant speedup](#multiple-input-files).
1818

1919
## Usage
20-
### all options
20+
* ### all options
2121
``` shell
2222
kubi -h
2323
```
2424

25-
### basic usage
25+
* ### basic usage
2626
``` shell
2727
kubi [-s <size>] [-l {row,column,crossL,crossR,crossH}] srcfile [dstfile]
2828
```
2929

30-
#### Layouts
31-
32-
| none | row | column |
30+
| **none** | **row** | **column** |
3331
| :---: | :---: | :---: |
3432
| ![none](./img/kubi_layouts_none.png "none") | ![row](./img/kubi_layouts_row.png "row") | ![column](./img/kubi_layouts_column.png "column") |
3533

3634
| ![crossL](./img/kubi_layouts_crossL.png "crossL") | ![crossR](./img/kubi_layouts_crossR.png "crossR") | ![crossH](./img/kubi_layouts_crossH.png "crossH") |
3735
| :---: | :---: | :---: |
38-
| crossL | crossR | crossH |
36+
| **crossL** | **crossR** | **crossH** |
3937

40-
### tiled cubemaps
38+
* ### tiled cubemaps
4139
``` shell
4240
kubi -s 2048 -co tile_size=512 -co depth=onetile -co overlap=0 -co layout=google -co suffix=.jpg[Q=75] -n l r u d f b srcfile dstfile.dz
4341
```
@@ -97,7 +95,7 @@ If only a few cubemaps are needed, performance is probably of minor concern. But
9795
| 10 | 9.9s | 1.0s |
9896
| 20 | 18.5s | 0.9s |
9997

100-
# Transforms
98+
## Transforms
10199
In addition to regular cubemaps, two optimized mappings can be generated:
102100
- **Equi-Angular Cubemap (EAC)**
103101
C.Brown (2017): [Bringing pixels front and center in VR video](https://blog.google/products/google-ar-vr/bringing-pixels-front-and-center-vr-video/)
@@ -106,7 +104,7 @@ M.Zucker & Y.Higashi (2018): [Cube-to-sphere Projections for Procedural Texturin
106104

107105
Both transforms significantly reduce the distortion of the cubemap and thus optimize the pixel yield. However, support in other tools and libraries is rather scarce.
108106

109-
| deviation | ltr: regular cubemap, EAC, OTC |
107+
| error | ltr: regular cubemap, EAC, OTC |
110108
| :---: | :---: |
111109
| area | ![error_area](./img/error_area.png "error_area")
112-
| distance | ![error_distance](./img/error_distance.png "error_distance")
110+
| distance | ![error_distance](./img/error_distance.png "error_distance")

0 commit comments

Comments
 (0)