Skip to content

Commit 3f3696b

Browse files
committed
Update Readme
1 parent 06b7e53 commit 3f3696b

3 files changed

Lines changed: 34 additions & 6 deletions

File tree

README.md

Lines changed: 34 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,17 +5,31 @@ Polyhex Sampler
55

66
Description
77
-----------
8+
A fast and high quality sampling system.
9+
10+
* uniform sampling at more than 1 millions points / second
11+
* adaptive sampling from image or function
12+
13+
This is an implementation of the article "Fast Tile-Based Adaptive Sampling with User-Specified Fourier Spectra" published in ACM SIGGRAPH 2014
14+
See http://liris.cnrs.fr/polyhex
15+
16+
This repository provide:
17+
18+
* source code with tools to generate uniform and adaptive sampling.
19+
* sampler-cli: a command line tool to generate uniform sampling.
20+
* sampler-gui: a Qt interface to explore the capacities of the sampling system (uniform and adaptive sampling).
21+
822

923
Build
1024
-----
1125

1226
To build the sampler, several packages are requires:
1327

1428
* cmake (http://cmake.org) to generate the build project.
15-
* Qt4 (Gui) (http://qt.digia.com)
29+
* Qt4 (Gui) (http://qt.digia.com)
1630
* Boost (and boost-progam-options) for command-line parsing (http://boost.org)
17-
* OpenGL
18-
* SDL and SDL_image
31+
* OpenGL with GLSL (version 330 minimum)
32+
* SDL and SDL_image library
1933

2034

2135
A classical commandline build process looks like
@@ -29,9 +43,8 @@ For best performances, you can compile with optimized flags: `cmake .. -DCMAKE_B
2943

3044
Once built, several executables are available in `build/bin`:
3145

32-
* `sampler-cli`: command line uniform sampling tool
33-
* `sampler-gui`: Qt base sampler (uniform, adaptive, ...) (needs openGL>3.3)
34-
* `sampler-test`: to check integrity of data files
46+
* `sampler-cli: command line uniform sampling tool
47+
* `sampler-gui: Qt base sampler (uniform, adaptive, ...)
3548

3649

3750
Data
@@ -46,7 +59,22 @@ Aternatively, `make GetLUT` (GetLUT target in your IDE) will download the data f
4659
Usage examples
4760
--------------
4861

62+
**sampler-cli**
63+
64+
`./bin/sampler-cli -r data/lut/production_rules.dat -b data/lut/barycenters.dat -d data/lut/offsets_bnot.dat -n 4096 -o sampling.txt`
65+
66+
**sampler-gui**
67+
68+
`./bin/sampler-gui -r data/lut/production_rules.dat -b data/lut/barycenters.dat -d data/lut/offsets_bnot.dat`
69+
70+
> *TIPS:*
71+
72+
> * You can use mouse scroll on almost all button to change their value more easily.
73+
74+
> * Activate `Auto` mode to generate new sampling each time a parameter change.
4975
76+
![sampler-gui-example1](doc/sampler-gui-example_1.png)
77+
![sampler-gui-example2](doc/sampler-gui-example_2.png)
5078

5179
LICENSE
5280
-------

doc/sampler-gui-example_1.png

255 KB
Loading

doc/sampler-gui-example_2.png

665 KB
Loading

0 commit comments

Comments
 (0)