-
Notifications
You must be signed in to change notification settings - Fork 17
/
README.txt
81 lines (63 loc) · 3.23 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
===================================================================
License
===================================================================
Copyright (c) 2013, Timothy Gerstner, All rights reserved.
This code is part of the prototype C++ implementation of our
paper/ my thesis.
Public repository: https://github.com/timgerst/pix
Project Webpage: http://www.research.rutgers.edu/~timgerst/
This code is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This code is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this code. If not, see <http://www.gnu.org/licenses/>.
====================================================================
Disclaimer
====================================================================
This code is part of a research project. While effort has been made
to keep it clean and readable, it may still contain bugs, misleading
comments, and poorly named variables. This code is released AS IS,
without any warranty or support. For questions related to its
implementation, please see the corresponding thesis and publications.
====================================================================
Required Libraries:
====================================================================
OpenCv 2.3.0: http://opencv.willowgarage.com/wiki/
If Cinder-GUI is used:
Cinder 0.8.4: http://libcinder.org/
If Python-Wrapper is created:
Boost Python http://www.boost.org/
====================================================================
Description
====================================================================
This code is an implementation of the algorithm described in the
"Pixelated Abstraction" Master's Thesis and the related publications:
"Pixelated Image Abstraction" and "Pixelated Image Abstraction with
Integrated User Constraints". The base algorithm is contained in the
pix.h/.cpp files and requires methods/variables in the utility.h,
const.h, and statelist.h/.cpp files to run. The PixUI class found in
pixui.h/.cpp is an interface for the algorithm, but is not required
to run the algorithm itself.
====================================================================
Build
====================================================================
There's Makefile present to create the commandline driver and/or the
Python wrapper.
The commandline driver is only dependent on OpenCV
make cmdlinedriver
To build the Python wrapper, you will have to provide the path where
pyconfig.h resides.
Also you will have to choose the correct Python and Boost Python
library versions (2.x or 3.x)
Examples
--------
Python 2.7 version, Ubuntu system
make pythonwrapper
Python 3.4 version, Ubuntu system
make pythonwrapper PYTHON_INCDIR=/usr/include/python3.4m/ \
PYTHON_LIB=-lpython3.4 BOOST_PYTHON_LIB=-lboost_python-py34