summaryrefslogtreecommitdiffstats
path: root/src/3rdparty/libdepixelize/kopftracer2011.h
blob: c60d0a61a277b36769051ec5fafbf222e18a3f5f (plain)
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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
/*  This file is part of the libdepixelize project
    Copyright (C) 2013 Vinícius dos Santos Oliveira <vini.ipsmaker@gmail.com>

    GNU Lesser General Public License Usage
    This library is free software; you can redistribute it and/or modify it
    under the terms of the GNU Lesser General Public License as published by the
    Free Software Foundation; either version 2.1 of the License, or (at your
    option) any later version.
    You should have received a copy of the GNU Lesser General Public License
    along with this library.  If not, see <http://www.gnu.org/licenses/>.

    GNU General Public License Usage
    Alternatively, this library may be used under the terms of the GNU General
    Public License as published by the Free Software Foundation, either version
    2 of the License, or (at your option) any later version.
    You should have received a copy of the GNU General Public License along with
    this library.  If not, see <http://www.gnu.org/licenses/>.

    This library 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
    Lesser General Public License for more details.
*/

#ifndef LIBDEPIXELIZE_TRACER_KOPFTRACER2011_H
#define LIBDEPIXELIZE_TRACER_KOPFTRACER2011_H

#include <string>

#include <glibmm.h>
// Contains exception definitions
#include <glibmm/fileutils.h>
#include <gdkmm/pixbuf.h>
#include "splines.h"

namespace Tracer {

class PixelGraph;

class Kopf2011
{
public:
    struct Options
    {
        enum Defaults {
            CURVES_MULTIPLIER        = 1,
            ISLANDS_WEIGHT           = 5,
            SPARSE_PIXELS_MULTIPLIER = 1,
            SPARSE_PIXELS_RADIUS     = 4
        };

        Options() :
            curvesMultiplier(CURVES_MULTIPLIER),
            islandsWeight(ISLANDS_WEIGHT),
            sparsePixelsMultiplier(SPARSE_PIXELS_MULTIPLIER),
            sparsePixelsRadius(SPARSE_PIXELS_RADIUS),
            optimize(true),
            nthreads(1)
        {}

        // Heuristics
        double curvesMultiplier;
        int islandsWeight;
        double sparsePixelsMultiplier;
        unsigned sparsePixelsRadius;

        // Other options
        bool optimize;
        int nthreads;
    };

    /**
     * # Exceptions
     *
     * \p options.optimize and options.nthreads will be ignored
     *
     * Glib::FileError
     * Gdk::PixbufError
     */
    static Splines to_voronoi(const std::string &filename,
                              const Options &options = Options());

    /*
     * \p options.optimize and options.nthreads will be ignored
     */
    static Splines to_voronoi(const Glib::RefPtr<Gdk::Pixbuf const> &buf,
                              const Options &options = Options());

    /**
     * # Exceptions
     *
     * \p options.optimize and options.nthreads will be ignored
     *
     * Glib::FileError
     * Gdk::PixbufError
     */
    static Splines to_grouped_voronoi(const std::string &filename,
                                      const Options &options = Options());

    /*
     * \p options.optimize and options.nthreads will be ignored
     */
    static Splines to_grouped_voronoi(const Glib::RefPtr<Gdk::Pixbuf const> &buf,
                                      const Options &options = Options());

    /**
     * # Exceptions
     *
     * Glib::FileError
     * Gdk::PixbufError
     */
    static Splines to_splines(const std::string &filename,
                              const Options &options = Options());

    static Splines to_splines(const Glib::RefPtr<Gdk::Pixbuf const> &buf,
                              const Options &options = Options());

private:
    typedef Geom::Coord Precision;

    template<class T, bool adjust_splines>
    static SimplifiedVoronoi<T, adjust_splines>
    _voronoi(const Glib::RefPtr<Gdk::Pixbuf const> &buf,
             const Options &options);

    static void _disconnect_neighbors_with_dissimilar_colors(PixelGraph &graph);

    // here, T/template is only used as an easy way to not expose internal
    // symbols
    template<class T>
    static void _remove_crossing_edges_safe(T &container);
    template<class T>
    static void _remove_crossing_edges_unsafe(PixelGraph &graph, T &edges,
                                              const Options &options);
};

} // namespace Tracer

#endif // LIBDEPIXELIZE_TRACER_KOPFTRACER2011_H

/*
  Local Variables:
  mode:c++
  c-file-style:"stroustrup"
  c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
  indent-tabs-mode:nil
  fill-column:99
  End:
*/
// vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=99 :