@@ -5,17 +5,31 @@ Polyhex Sampler
55
66Description
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
923Build
1024-----
1125
1226To 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
2135A classical commandline build process looks like
@@ -29,9 +43,8 @@ For best performances, you can compile with optimized flags: `cmake .. -DCMAKE_B
2943
3044Once 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
3750Data
@@ -46,7 +59,22 @@ Aternatively, `make GetLUT` (GetLUT target in your IDE) will download the data f
4659Usage 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
5179LICENSE
5280-------
0 commit comments