summaryrefslogtreecommitdiff
path: root/src/core/SourceInterfaces.vala
blob: 6e0c149aa0635815ca4d3b3ceaaa06c1461cfcf7 (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
/* Copyright 2016 Software Freedom Conservancy Inc.
 *
 * This software is licensed under the GNU Lesser General Public License
 * (version 2.1 or later).  See the COPYING file in this distribution.
 */

// See the note in MediaInterfaces.vala for some thoughts on the theory of expanding Shotwell's
// features via interfaces rather than class hierarchies.

// Indexable DataSources provide raw strings that may be searched against (and, in the future,
// indexed) for free-text search queries.  DataSources implementing Indexable must prepare and
// store (i.e. cache) these strings using prepare_indexable_string(s), as preparing the strings
// for each call is expensive.
//
// When the indexable string has changed, the object should fire an alteration of
// "indexable:keywords".  The prepare methods will not do this.

public interface Indexable : DataSource {
    public abstract unowned string? get_indexable_keywords();
    
    public static string? prepare_indexable_string(string? str) {
        if(is_string_empty(str))
            return null;
        return String.remove_diacritics(str.down());
    }
    
    public static string? prepare_indexable_strings(string[]? strs) {
        if (strs == null || strs.length == 0)
            return null;
        
        StringBuilder builder = new StringBuilder();
        int ctr = 0;
        do {
            if (!is_string_empty(strs[ctr])) {
                builder.append(strs[ctr].down());
                if (ctr < strs.length - 1)
                    builder.append_c(' ');
            }
        } while (++ctr < strs.length);
        
        return !is_string_empty(builder.str) ? builder.str : null;
    }
}

// Positionable DataSources provide a globally locatable point in longitude and latitude degrees

public struct GpsCoords {
    public int has_gps;
    public double latitude;
    public double longitude;
    public bool equals(ref GpsCoords gps) {
        return (has_gps == 0 && gps.has_gps == 0) || (latitude == gps.latitude && longitude == gps.longitude);
    }
}

public interface Positionable : DataSource {
    public abstract GpsCoords get_gps_coords();
    public abstract void set_gps_coords(GpsCoords gps_coords);
}